连接 Paperless-ngx 文档管理系统，支持全文检索、OCR 内容提取、标签分类及批量上传，实现私有化文档管理的自动化工作流。
说明：
## 核心用法
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 乐观锁机制，批量操作加幂等控制 |
会员专属
