扫描组织者

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

类别

medical、financial、insurance、tax、legal、personal、household、other

命令

从 scan-organizer 项目目录运行。

输出格式

所有命令都会将 JSON 输出到 stdout。进度消息发送至 stderr。

建筑

提取 — Doling 解析 PDF 结构和本机文本 OCR — 包含稀疏文本的页面被渲染为 PNG 并发送到视觉模型 分类 — 合并文本发送到语言模型进行分类 组织 — PDF 移动到 <scans_dir>/<category>/、.md + .meta.json 编写的 sidecar

温馨提示

首先运行 status 查看收件箱中有多少未处理的扫描 在移动文件之前使用 --dry-run 预览分类 清单跟踪所有移动以进行审核 如果分类错误,请使用 reclass 撤消并重新处理

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@FDU-INS · Apache-2.0
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Scan Organizer

Processes scanned PDFs — extracts text (Docling + vision OCR), classifies by category using an LLM, and organizes into subfolders with markdown and metadata sidecars. Works with any OpenAI-compatible API (Ollama, OpenAI, OpenRouter, etc.).

## Categories

`medical`, `financial`, `insurance`, `tax`, `legal`, `personal`, `household`, `other`

## Commands

Run from the scan-organizer project directory.

### Process new scans
```bash
uv run scan-organizer process
```

### Dry run (classify without moving)
```bash
uv run scan-organizer process --dry-run
```

### Process a single file
```bash
uv run scan-organizer process --file /path/to/scan.pdf
```

### Force re-process all (including already processed)
```bash
uv run scan-organizer process --force
```

### Check inbox status
```bash
uv run scan-organizer status
```

### Undo a processed file (move back to inbox)
```bash
uv run scan-organizer undo <filename>
```

### Reclassify a file
```bash
uv run scan-organizer reclass <filename>
```

## Output Format

All commands output JSON to stdout. Progress messages go to stderr.

### Process output
```json
{"processed": 3, "skipped": 7, "errors": 0, "results": [{"file": "...", "category": "medical", "title": "...", "destination": "..."}]}
```

### Status output
```json
{"inbox_count": 10, "unprocessed": 3, "already_processed": 7, "categories": {"medical": 2, "financial": 3}}
```

## Architecture

1. **Extract** — Docling parses PDF structure and native text
2. **OCR** — Pages with sparse text are rendered to PNG and sent to a vision model
3. **Classify** — Merged text sent to a language model for categorization
4. **Organize** — PDF moved to `<scans_dir>/<category>/`, `.md` + `.meta.json` sidecars written

## File Organization

```
<scans_dir>/
  medical/
    2025-12-20_lab-results_0003.pdf
    2025-12-20_lab-results_0003.md
    2025-12-20_lab-results_0003.meta.json
  financial/
    ...
  .manifest.json    <- tracks all moves for undo
```

## Tips

- Run `status` first to see how many unprocessed scans are in the inbox
- Use `--dry-run` to preview classifications before moving files
- The manifest tracks all moves for auditability
- If a classification is wrong, use `reclass` to undo and re-process

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。