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 接入指南，了解命令结构和脚本化调用方式。
• 查看能力支持，按类别了解可用的文档能力。