Skill

掃描全能王 Skill 是面向智能體的文件處理能力包。安裝後，Agent 可以根據使用者的自然語言需求，選擇並組合掃描與圖像優化、文字識別、格式轉換、PDF 處理和雲端儲存與文件管理等能力。

Skill 不會替換你正在使用的 Agent。它主要為 Agent 補充三類資訊：什麼時候調用掃描全能王、應該選擇什麼命令，以及執行過程中需要遵守哪些文件與安全規則。

適合什麼場景

• 希望使用者直接描述目標，由 Agent 自動規劃文件處理步驟。
• 需要把多項能力串成一個任務，例如“增強掃描件、識別發票、匯總為 Excel 並儲存到雲端”。
• 使用支援 Skill 的 Agent 使用者端或開發平台。
• 希望獲得比單條命令更完整的意圖判斷、參數選擇和異常處理指引。

如果你只需要給 Agent 增加標準工具連接，可以使用 MCP；如果你希望在腳本或終端中直接執行命令，可以使用 CLI。

快速接入

交給 Agent 安裝

複製下面的 Prompt，發送給當前 Agent：

請幫我接入掃描全能王 Skill。下載並解壓最新安裝包：https://data.camscanner.com/camscanner-cli/releases/latest/camscanner-skill-latest.zip。請先檢查當前 Agent 是否支援 Skill 以及對應的安裝目錄，閱讀包內說明後完成安裝；保留現有設定，不要覆蓋其他 Skill。完成後驗證 Skill 是否可用，並告訴我修改了哪些文件、是否需要重啓。

Agent 應先確認當前使用者端是否支援 Skill、定位正確的安裝目錄，再執行複製和安裝操作。這樣可以避免誤覆蓋已有 Skill 或把文件放到不會被使用者端加載的位置。

手動安裝

1. 下載並解壓

下載最新 Skill 安裝包。

解壓後應能看到以下結構：

camscanner/
├── SKILL.md
├── references/
└── scripts/

請保留整個目錄結構。SKILL.md 是入口說明，references/ 包含各類能力的詳細用法，scripts/ 用於安裝和升級 CLI。

2. 放入 Skill 目錄

將解壓後的完整目錄放入當前 Agent 使用者端的 Skill 安裝目錄。不同使用者端的目錄位置和導入方式可能不同，請以該使用者端的官方說明為準。

安裝前建議：

1. 確認目標目錄確實由當前使用者端加載。
2. 如果已經安裝舊版本，先備份原目錄。
3. 不要刪除或覆蓋同級的其他 Skill。

3. 安裝配套 CLI

在 Skill 目錄中執行對應平台的安裝腳本：

macOS / Linux

bash scripts/setup.sh

Windows

powershell -ExecutionPolicy Bypass -File scripts/setup.ps1

安裝腳本會識別操作系統和 CPU 架構，下載對應的 camscanner-cli 可執行文件並校驗安裝包。當前安裝包覆蓋 macOS、Linux 和 Windows 的 x64/arm64 環境。

macOS 或 Linux 預設安裝到 ~/.local/bin。如果該目錄不在 PATH 中，請按照安裝腳本的提示加入當前 Shell 設定，然後重新打開終端或重新整理環境變量。

4. 登入掃描全能王

先檢查登入狀態：

camscanner-cli auth status

如果尚未登入或登入已過期，執行：

camscanner-cli auth login

該命令會打開瀏覽器完成授權，並在授權完成前保持運行。請勿將登入命令放到後台執行。登入後再次運行 camscanner-cli auth status 確認狀態。

5. 重新加載 Agent

部分使用者端會自動發現新增 Skill，部分使用者端需要重新整理 Skill 列表或重啓。重新加載後，即可透過自然語言發起文件任務。

驗證接入

先驗證 CLI 是否可用：

camscanner-cli --version
camscanner-cli auth status

然後向 Agent 發起一個明確、低風險的測試任務，例如：

請使用掃描全能王識別這張測試圖片中的文字，只返回識別結果，不儲存到雲端。

接入成功時，Agent 應能夠：

1. 識別這是 OCR 任務，並選擇掃描全能王 Skill。
2. 在執行前確認輸入文件和預期輸出。
3. 調用對應命令，而不是只給出操作建議。
4. 清楚說明結果儲存位置或直接返回識別內容。

支援的能力

類別	典型任務
掃描與圖像優化	亮度增強、銳化、黑白與灰度處理、去陰影、去網紋與摩爾紋、手寫擦除、高畫質化和老照片修復
文字識別與結構化提取	單圖文字識別、數學公式提取，以及發票和票據的結構化識別
文件格式轉換	圖片轉 Word、Excel、Markdown 或 PDF，PDF 轉 Word、Excel、TXT、Markdown 或 JPG 圖片，TXT 轉 Word
多頁與批次處理	將最多 100 張圖片按順序合併為 PDF、Word、Excel、TXT 或 Markdown
翻譯與內容編輯	保留版式翻譯，以及基於版面分析的文字替換和區域刪除、移動
水印與真實性檢測	為圖片和 PDF 添加或去除水印，檢測圖片篡改與 AI 生成風險
雲端儲存與文件管理	儲存處理結果，組合搜尋、下載和移動雲文件，並查看資料夾目錄

本站的能力範圍以 Skill 與 MCP 的交集為準。Skill 實際可用的參數和限制，以當前安裝包中的 SKILL.md 與 references/ 為準。

使用示例

安裝完成後，可以直接向 Agent 描述目標：

把這三張掃描件按檔名順序合併成 PDF，同時儲存到本地和我的掃描全能王雲空間。

將這份合約 PDF 轉換為可編輯的 Word，輸出檔名為“採購合約-可編輯版.docx”。

識別這張發票並返回結構化資料，不要儲存到雲端。

搜尋我雲空間中最近的“項目合約”，先把候選文件列出來，等我確認後再下載。

描述任務時，建議同時說明輸入文件、目標格式、儲存位置和是否允許上傳到雲端。資訊越明確，Agent 越容易選擇正確的能力組合。

更新 Skill

已安裝使用者可以在 Skill 目錄中運行升級腳本。腳本會同步更新 CLI 與 Skill 文件；沒有新版本時會直接退出。

macOS / Linux

bash scripts/upgrade.sh

Windows / 通用 Node.js

node scripts/upgrade.cjs

升級失敗時，腳本會嘗試回滾。也可以手動執行：

bash scripts/upgrade.sh --rollback

常見問題

Agent 沒有識別到 Skill

確認完整目錄已經放入使用者端實際加載的 Skill 目錄，並檢查入口檔名是否仍為 SKILL.md。重新整理 Skill 列表或重啓使用者端後再次嘗試。

camscanner-cli: command not found

macOS 或 Linux 請確認 ~/.local/bin 已加入 PATH。Windows 請檢查 %LOCALAPPDATA%\camscanner-cli\camscanner-cli.exe 是否存在，並重新打開終端使環境變量生效。

登入後仍顯示未認證

再次運行 camscanner-cli auth status。如果登入已過期，執行 camscanner-cli auth login 重新完成瀏覽器授權。

Agent 選擇了錯誤的處理方式

在任務中明確輸入類型、數量、目標格式和儲存位置。例如，用“把 3 張 JPG 合併成 1 個 PDF”代替“幫我處理這些文件”。

安全與限制

• 輸入文件會上傳到掃描全能王服務端進行處理；使用 -s 時，結果會儲存到登入賬號的雲空間。
• 登入憑據由 CLI 管理。不要要求 Agent 輸出、複製或記錄明文 Token。
• 上傳文件當前不應超過 40 MB；圖片支援 JPG、JPEG、PNG，文件支援 PDF、TXT 和 Markdown。
• 帶密碼保護的 PDF 暫不支援處理。
• CLI 的 -o 可能覆蓋同名文件。讓 Agent 寫入前檢查目標路徑，或使用新的檔名。
• 多文件任務應先確認檔案清單和頁序，不要依賴順序不確定的通配符。

下一步

• 查看 MCP 接入指南，透過標準協議連接 Agent 或 IDE。
• 查看 CLI 接入指南，瞭解命令結構和腳本化調用方式。
• 查看能力支援，按類別瞭解可用的文件能力。