據 AlphaMoat 統計,截至 2026-09,Paperless 累計下載 4,220 次、獲 2 個星標,在全部 5,078 個 AI 技能中排名第 2,363 位,在「辦公效率」分類(435 個)中排名第 200 位。

累計安裝

148

累計下載

4220

星標

全站排名

#2,363

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

平台	累計安裝	累計下載	星標	評論
ClawHub ↗	130	4220	2	-
SkillHub ↗	148	4019	2	—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

該工具可讀取 OCR 內容、新增文件並更新標題、標籤、往來方或型別等資訊。遠端伺服器應使用 HTTPS，避免明文傳輸令牌或文件；使用許可權最小且可撤銷的 API token，並避免把 token 留在 shell 歷史、共享配置或日誌中。宜在隔離環境安裝固定版本的 CLI。需要 ppls 及已配置的 Paperless 主機和 token。

資料釋出於 2026-10-29

可以用來做什麼

按名稱、日期、標籤或往來方篩選文件
檢視文件詳情或下載原始檔案
上傳文件並整理標籤、往來方和型別等後設資料

什麼時候用

伺服器連線使用 HTTPS 且 token 已安全儲存時
查詢或下載的檔案確實屬於獲准訪問範圍時
在上傳或修改後設資料前已確認目標文件和內容時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

說明如何按標籤搜尋 Paperless 文件並安全下載指定檔案；不要連線伺服器、讀取文件或上傳/修改內容。

月度資料趨勢

累計下載4220

星標2

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份	累計下載	環比	星標
2026-09	4220	—	2
2026-08	4034	+5.6%	2
2026-07	3820	+10.4%	2
2026-06	3461	+5.4%	1
2026-05	3283	—	1
2026-03	2774	—	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/)