通过REST API连接Paperless-ngx文档管理系统，实现PDF的全文检索、智能上传归档、标签分类与批量下载，打造个人无纸化办公中枢。
说明：
## 核心功能
Paperless-ngx技能提供了一套完整的文档管理命令行接口，基于Node.js脚本封装Paperless-ngx REST API，支持：
**文档检索**：全文搜索、多维度过滤（标签/类型/发件人/日期）、结果JSON输出便于二次处理
**上传归档**：支持元数据预标注（标题、标签、类型、发件人、创建日期），实现上传即分类
**下载管理**：可获取处理后的归档版本或原始文件，支持指定输出路径
**元数据维护**：标签、文档类型、发件人的增删改查
## 显著优点
– **OCR深度集成**：自动提取PDF文本内容，支持全文检索和`–content`参数获取识别文本
– **批量操作友好**：JSON输出天然适配`jq`处理，便于脚本化工作流
– **配置灵活**：支持环境变量和JSON配置文件双模式，`apiKey`简写提升安全性
– **开源生态**：背靠Paperless-ngx成熟项目，社区活跃，文档完善
## 潜在局限
– **前置依赖重**：必须自建Paperless-ngx实例，涉及Docker部署、数据库配置等运维成本
– **仅限PDF**：核心功能围绕PDF优化，其他格式支持有限
– **无内置同步**：双向同步需自行脚本实现，非开箱即用
– **中文OCR质量**：依赖Paperless-ngx底层Tesseract配置，中文识别需额外调优
## 适合人群
– 已部署或计划部署Paperless-ngx的技术用户
– 需要批量处理文档元数据的效率工作者
– 追求本地优先、隐私可控的文档管理方案用户
– 熟悉命令行和JSON数据处理的开发者
## 常规风险提示
– **令牌泄露**：PAPERLESS_TOKEN具备完整API权限，明文存储于配置文件存在泄露风险
– **实例暴露**：若Paperless-ngx部署于公网且无HTTPS，传输过程可被中间人截获
– **误操作覆盖**：批量上传/修改元数据无二次确认机制，脚本错误可能导致数据混乱
– **版本兼容性**：技能脚本与Paperless-ngx API版本绑定，升级服务端可能破坏功能
会员专属
