据 AlphaMoat 统计,截至 2026-09,Paperless 累计下载 4,220 次、获 2 个星标,在全部 5,078 个 AI 技能中排名第 2,363 位,在「办公效率」分类(435 个)中排名第 200 位。

累计安装

148

累计下载

4,220

星标

全站排名

#2,363

全站前 47% · 「办公效率」前 46%

平台	累计安装	累计下载	星标	评论
ClawHub ↗	130	4,220	2	-
SkillHub ↗	148	4,019	2	—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

该工具可读取 OCR 内容、添加文档并更新标题、标签、往来方或类型等信息。远程服务器应使用 HTTPS，避免明文传输令牌或文档；使用权限最小且可撤销的 API token，并避免把 token 留在 shell 历史、共享配置或日志中。宜在隔离环境安装固定版本的 CLI。需要 ppls 及已配置的 Paperless 主机和 token。

资料发布于 2026-10-29

可以用来做什么

按名称、日期、标签或往来方筛选文档
查看文档详情或下载原始文件
上传文档并整理标签、往来方和类型等元数据

什么时候用

服务器连接使用 HTTPS 且 token 已安全保存时
查询或下载的文件确实属于获准访问范围时
在上传或修改元数据前已确认目标文档和内容时

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

说明如何按标签搜索 Paperless 文档并安全下载指定文件；不要连接服务器、读取文档或上传/修改内容。

月度数据趋势

累计下载4,220

星标2

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。

月份	累计下载	环比	星标
2026-09	4,220	—	2
2026-08	4,034	+5.6%	2
2026-07	3,820	+10.4%	2
2026-06	3,461	+5.4%	1
2026-05	3,283	—	1
2026-03	2,774	—	1

SKILL.md 原文

以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。

2.9 KB · ClawHub v1.1.0

---
name: paperless
description: Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
emoji: 📄
metadata: {"clawdbot":{"requires":{"bins":["ppls"],"env":["PPLS_HOSTNAME","PPLS_TOKEN"]},"install":[{"id":"node","kind":"node","package":"@nickchristensen/ppls","bins":["ppls"],"label":"Install ppls CLI (npm/bun)"}]}}
---

# Paperless-NGX CLI

Search and manage documents in Paperless-NGX using `ppls`.

展开全部(共 115 行)


## Setup

```bash
npm install -g @nickchristensen/ppls
ppls config set hostname http://your-paperless-host
ppls config set token your-api-token
```

## Searching Documents

```bash
# By name
ppls documents list --name-contains "invoice" --json

# By date range
ppls documents list --created-after 2024-01-01 --created-before 2024-12-31 --json

# By tag (OR — any of these tags)
ppls documents list --tag 5 --tag 12 --json

# By tag (AND — must have all)
ppls documents list --tag-all 5,12 --json

# Exclude tags
ppls documents list --tag-not 3 --json

# By correspondent
ppls documents list --correspondent 7 --json

# By document type
ppls documents list --document-type 2 --json

# Documents missing metadata
ppls documents list --no-correspondent --json
ppls documents list --no-tag --json

# Recently added/modified
ppls documents list --added-after 2024-06-01 --json
ppls documents list --modified-after 2024-06-01 --json

# Combine filters
ppls documents list --correspondent 7 --created-after 2024-01-01 --tag 5 --json
```

## Viewing & Downloading

```bash
# Get full document details (includes OCR content)
ppls documents show 1234 --json

# Download single document
ppls documents download 1234 --output ~/Downloads/doc.pdf

# Download multiple documents
ppls documents download 1234 5678 --output-dir ~/Downloads

# Download original (pre-processed) version
ppls documents download 1234 --original
```

## Uploading Documents

```bash
# Simple upload (Paperless auto-processes)
ppls documents add scan.pdf

# With metadata
ppls documents add receipt.pdf \
  --title "Store Receipt" \
  --correspondent 5 \
  --document-type 2 \
  --tag 10
```

## Managing Metadata

```bash
# List tags/correspondents/document-types
ppls tags list --json
ppls correspondents list --json
ppls document-types list --json

# Create new
ppls tags add "Tax 2024" --color "#ff0000"
ppls correspondents add "New Vendor"
ppls document-types add "Contract"

# Update document metadata
ppls documents update 1234 --title "New Title" --correspondent 5 --tag 10
```

## Tips

- **Always use `--json`** for AI/automation — it's the most parseable format
- **Date formats:** `YYYY-MM-DD` or full ISO 8601
- **IDs are numeric** — use `list --json` commands to find them
- **Filters are repeatable:** `--tag 1 --tag 2` or `--tag 1,2` both work
- **Pagination:** Use `--page` and `--page-size` for large result sets

## Links

- [ppls on GitHub](https://github.com/NickChristensen/ppls)
- [Paperless-NGX Docs](https://docs.paperless-ngx.com/)