Paperless文档管理

技能简介

该技能通过ppls命令行工具连接Paperless-NGX文档管理系统，支持搜索、上传、下载文档及维护标签、联系人、文档类型等元数据。

业务背景

企业日常运营中产生大量纸质及电子文档，传统管理方式检索困难、版本混乱。该技能让业务人员通过自然语言指令快速定位所需文件，自动完成分类归档与元数据维护，减少人工整理时间，确保文档资产安全可控、随时可查。

落地案例：财务部门每月需整理数百张发票并关联供应商信息。员工使用ppls上传PDF发票时自动附加

能做什么

• 按名称、日期、标签、联系人、文档类型等多维度搜索文档
• 下载单份或多份PDF，可选择原始版本或OCR处理后的版本
• 上传新文档并附加标题、标签、联系人等元数据
• 创建和管理标签、联系人、文档类型分类体系
• 更新现有文档的元数据信息

使用说明

安装步骤

1. 安装Node.js环境（如未安装）
2. 执行全局安装：npm install -g @nickchristensen/ppls
3. 配置服务地址：ppls config set hostname http://your-paperless-host
4. 配置访问令牌：ppls config set token your-api-token

常用操作示例

搜索2024年发票类文档：ppls documents list --name-contains "invoice" --created-after 2024-01-01 --json

下载指定文档：ppls documents download 1234 --output ~/Downloads/doc.pdf

带元数据上传：ppls documents add receipt.pdf --title "Store Receipt" --correspondent 5 --tag 10

创建新标签：ppls tags add "Tax 2024" --color "#ff0000"

输入与输出

见下方输入与输出表格。

风险提示

• API令牌需妥善保管，避免泄露导致未授权访问
• 批量下载大量文档时注意存储空间与网络带宽
• 修改元数据前建议先备份，防止误操作覆盖正确信息
• 依赖外部Paperless-NGX服务可用性，服务中断时功能受限

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nickchristensen/paperless/SKILL.md
来源类型：GitHub仓库