（4256期）paperless-ngx-tools – 智能文档管理 · OCR全文检索

智能文档管理 · OCR全文检索 通过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版本绑定，升级服务端可能破坏功能 原始说明 Manage documents in Paperless-ngx - search, upload, tag, and retrieve.