核心用法
Paperless-ngx 技能通过 REST API 与自托管的 Paperless-ngx 实例交互，提供完整的文档生命周期管理能力：
检索功能：支持全文搜索（基于 OCR 提取的文本内容）、多维度筛选（标签/文档类型/发件人/日期）及组合查询，可快速定位历史文档。
文档操作：获取元数据与原始内容、下载 PDF 原件或归档版本、批量导出支持 --content 参数提取 OCR 全文。
上传与分类：支持单文件/批量上传，自动解析日期发件人，可强制指定标题、标签、类型等元数据实现自动化归档。
元数据管理：维护标签体系、文档类型、发件人字典，支持运行时创建新分类。
显著优点
- 完全私有化：数据驻留于自托管服务器，无第三方云服务依赖，符合 GDPR/企业合规要求
- OCR 深度集成：自动提取扫描件/图片文本，支持 100+ 语言，搜索精准度远超文件名检索
- 开放生态：基于开源 Paperless-ngx，社区活跃，支持自定义消费码、邮件自动导入等扩展
- API 完整暴露：100% 功能覆盖，可实现端到端自动化（发票识别→标签分类→归档→审计追踪）
潜在局限
- 基础设施依赖：需自行部署维护 Paperless-ngx 实例（Docker 或裸机），初始配置门槛较高
- 无云原生方案：不支持直接连接 Notion/Dropbox/Google Drive 等公有云服务
- 令牌管理：长期使用需轮换 API Token，多用户场景下权限粒度依赖 Paperless 自身 RBAC
适合人群
- 注重数据主权的小型企业/自由职业者
- 需要批量处理纸质文档数字化（发票/合同/病历）的财务/行政人员
- 已部署 Homelab/NAS 环境的极客用户
- 需满足审计要求的医疗/法律/金融行业从业者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 网络暴露 | 若 Paperless 实例公网可访问，API Token 泄露导致数据暴露 | 使用 VPN/内网访问，或配置反向代理 + TLS |
| Token 硬编码 | 配置文件中的 `PAPERLESS_TOKEN` 可能被误提交至版本控制 | 使用环境变量注入，禁止写入代码仓库 |
| SSRF 风险 | `PAPERLESS_URL` 指向内网服务时，可能成为跳板攻击载体 | 限制 URL 白名单，禁止指向私有 IP 段 |
| 数据一致性 | 并发上传/修改可能导致元数据冲突 | 依赖 Paperless 乐观锁机制，批量操作加幂等控制 |