🧭 使用前必读（30 秒）

[!WARNING] ⚠️ 隐私与数据流向重要提示

• 第三方服务交互：本技能会将您提供的图片 发送至夸克官方服务器 (scan-business.quark.cn) 进行识别。
• 数据可见性：夸克服务将获取并处理该图片内容，不会永久保存

推荐方式：环境变量（免权限、即时生效、webchat 友好）
在终端中运行（本次会话立即可用）：

export SCAN_WEBSERVICE_KEY="your_scan_webservice_key_here"

如何获取密钥？官方入口在此

请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key。
⚠️ 注意：若你点击链接后跳转到其他域名，说明该链接已失效 —— 请直接在浏览器地址栏手动输入 https://scan.quark.cn/business（这是当前唯一有效的官方入口）。

强制执行规则

所有调用必须严格遵循以下规则

• 所有意图的调用命令必须且只能取自其对应 references/scenarios/XX-xxx.md 文件中的命令。
• SKILL.md 中的意图描述仅为语义说明，不参与参数匹配，不可用于构造调用命令。
• 每次请求视为完全独立会话：不得参考历史对话中的意图、参数或上下文。
• 单一意图原则：仅根据用户本次指令提取关键词匹配一个意图，命中即执行，不尝试其他意图。
• 禁止惯性沿用：不得沿用上一次的场景、参数或假设。
• 接口返回即结束：无论成功或失败，直接透传 API 响应，不重试、不解析、不切换。
• 禁止伪造请求和响应：必须使用对应 references/scenarios/XX-xxx.md 中定义的真实调用命令，不得使用示例 JSON 作为响应。
• 等待新指令：任务完成后静默等待用户发起下一次请求。

输入验证与前置检查

在执行任何意图前，自动按顺序检查以下条件：

1. 环境变量检查：

   • 若 SCAN_WEBSERVICE_KEY 未配置，立即返回：

     {
       "code": "A0100",
       "message": "SCAN_WEBSERVICE_KEY 未配置，请设置环境变量后重试。",
       "data": null
     }
     

2. 图片输入有效性检查：

   • 若用户指令中未提供有效图片输入方式（即无 --url、--path 或 --base64 参数），立即返回：

     {
       "code": "A0201",
       "message": "缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。",
       "data": null
     }
     

3. API 响应透传：

   • 若 API 返回非 "00000" 状态码（如 A0211 配额不足、B0001 图片无效等），直接透传原始响应，不做任何修改或重试。

通用调用规范（强制遵循）

所有场景必须遵循以下规范。

脚本位置

scripts/scan.py 

输入方式（三选一）

通用参数

示例（以图像裁剪矫正为例）：
--service-option 'scan'
--input-configs '{"function_option": "no_genre"}'
--output-configs '{"need_return_image": "True"}'
--data-type "image"
完整参数值必须查阅对应场景文件（如 `references/scenarios/27-image-crop-rectify.md）

返回格式（所有场景统一）

{
  "code": "String",      // 状态码，"00000" 表示成功
  "message": "String",  // 错误描述或成功提示
  "data": "Object"      // API 原始返回数据，结构随场景变化
}

客户端脚本增强字段：当 scan.py 调用夸克 API 成功（code == "00000"）且响应 data 中包含 "ImageBase64" 时，scan.py 会主动调用 file_saver.py 将其解码并保存为本地图片文件，并在最终返回的 JSON 响应中，于 data 对象内追加 "path": "/tmp/xxx.png" 字段。该行为由 scan.py 脚本实现，与模型无关，也不依赖 OpenClaw 平台自动介入。

意图匹配规则&执行

逻辑序号 1 - 考试增强（API 场景 19）

• 当用户存在将手写笔记、试卷、教材等学习资料的照片转化为高清、去噪、背景纯净的电子文档，并期望自动提取其中的文字内容以实现资料数字化管理、清晰分享或后续编辑的意图。
• 示例指令：
  • “把这张拍糊了的试卷变清晰，并把上面的题都提取出来。”
  • “帮我清理一下这张手写笔记的背景噪音，转成干净的电子版。”
  • “这张教材照片光线太暗且有阴影，请增强画质并提取文字。”
• ⚠️ 获取执行策略&执行

逻辑序号 2 - 画质增强（API 场景 20）

• 当用户存在将模糊、昏暗、老旧或低质量的照片及文字资料进行画质增强，使其内容更清晰、对比度更鲜明、细节更可见，以改善视觉效果和可读性的意图。
• 示例指令：
  • “这张老照片太模糊了，帮我把画质变清晰一点。”
  • “图片光线太暗看不清字，请增强亮度和对比度。”
  • “修复这张低分辨率的图片，让细节更清楚。”
• ⚠️ 获取执行策略&执行

逻辑序号 3 - 证件票据增强（API 场景 21）

• 当用户存在将模糊、光线不佳或细节不清的证件及票据照片进行画质优化，使其文字与关键信息变得清晰可辨，以便于日常查看、核对或工作处理的意图。
• 示例指令：
  • “这张身份证照片有点模糊，请优化一下让字迹更清晰。”
  • “帮我把这张发票上的金额和日期部分增强清楚。”
  • “护照照片反光严重，请处理一下让我能看清上面的信息。”
• ⚠️ 获取执行策略&执行

逻辑序号 4 - 图像去手写（API 场景 22）

• 当用户存在将已填写的手写笔迹、划痕等内容从印刷文档图像中自动清除，并完整保留原始印刷文字与格式，以还原出干净空白文档用于重新编辑或重复使用的意图。
• 示例指令：
  • “把这张做过的试卷上的手写答案去掉，还原成空白卷子。”
  • “清除文档上的手写批注，只保留打印的文字。”
  • “帮我去掉书上的笔记痕迹，我要一张干净的页面。”
• ⚠️ 获取执行策略&执行

逻辑序号 5 - 图像去水印（API 场景 23）

• 当用户存在将图片的水印（如文字、Logo、标记等）在不损伤背景和整体构图的前提下精准去除，以获得干净、清晰、可直接使用或分享的无水印图像的意图。
• 示例指令：
  • “帮我把图片右下角的网站水印去掉。”
  • “去除这张图中间的大 Logo，不要破坏背景。”
  • “把照片上的时间戳水印擦除干净。”
• ⚠️ 获取执行策略&执行

逻辑序号 6 - 图像去阴影（API 场景 24）

• 用户存在将文档或图像中因拍摄角度、光线等原因产生的阴影去除，以获得清晰、干净、均匀亮度的高清扫描效果，便于阅读、存档或后续处理的意图。
• 示例指令：
  • “这张纸拍出来有大片阴影，请帮我去除阴影变平整。”
  • “去掉文档照片左侧因手机遮挡产生的黑色阴影。”
  • “消除拍摄时的光照不均，让整张图亮度均匀。”
• ⚠️ 获取执行策略&执行

逻辑序号 7 - 图像去屏纹（API 场景 25）

• 当用户存在将拍摄屏幕（如手机、电脑显示器）时产生的摩尔纹（屏纹）、反光、低对比度等问题进行智能修复，以获得清晰、无干扰、文字可读性高的高清文档图像的意图。
• 示例指令：
  • “这张对着电脑屏幕拍的照片有很多波纹，请帮我消除屏纹。”
  • “去掉翻拍屏幕产生的摩尔纹和反光，让文字变清晰。”
  • “修复这张手机截屏图中的彩色条纹干扰。”
  • “将这张投影仪上图的优化下，让文字更清晰。”
• ⚠️ 获取执行策略&执行

逻辑序号 8 - 文档去底色（API 场景 26）

• 当用户希望将带有彩色背景、水印、阴影或复杂排版的文档截图/照片（如红底古文、扫描件、手机拍屏等），通过AI智能处理一键转换为纯白背景 + 黑色文字的清晰可读版本，去除视觉干扰、还原标准印刷体效果，便于阅读、打印、存档或OCR识别的意图。
• 示例指令：
  • “把这张红头文件的红色背景去掉，变成白底黑字。”
  • “这张截图背景是灰色的，请一键去底色变成纯白背景。”
  • “去掉图片背景色”
• ⚠️ 获取执行策略&执行

逻辑序号 9 - 图像裁剪矫正（API 场景 27）

• 当用户存在对图像进行自动矫正（如透视校正、水平对齐）并智能裁剪多余边缘，以获得规整、清晰、便于阅读或存档的标准矩形文档图像的意图。
• 示例指令：
  • “这张照片拍歪了，帮我把文档扶正并裁掉多余的桌子背景。”
  • “自动矫正透视变形，把这张倾斜的合同变成标准的矩形。”
  • “裁剪掉图片四周的杂乱边缘，只保留中间的文档内容。”
• ⚠️ 获取执行策略&执行

逻辑序号 10 - 素描速写（API 场景 28）

• 当用户希望将普通照片转换为素描或速写风格图像，以增强视觉表现力、突出线条与明暗关系，并追求个性化艺术效果的意图。

• 示例指令：

  • “把这张人物照片转换成铅笔素描风格。”
  • “生成一张这张风景照的速写效果图片。”
  • “将我的自拍变成手绘素描的样子。”

• ⚠️ 获取执行策略&执行

逻辑序号 11 - 提取线稿（API 场景 29）

• 用户需要从图片中提取线稿，将图像转换为简洁的线条形式图，用于艺术创作或提升工作效率
• 示例指令：
  • “从这张动漫图片中提取纯线稿，去掉颜色。”
  • “把这张实物照片转换成黑白线条图。”
  • “提取图片中的轮廓线条，我要用来上色练习。”
• ⚠️ 获取执行策略&执行

逻辑序号 12 - 扫描文件（API 场景 30）

• 当用户指令中不包含上述任何具体场景，仅表达优化意图时，将调用扫描文件场景（API 场景 30）
• 示例指令：
  • “优化一下这张文档图片，让它看起来更专业。”
• ⚠️ 获取执行策略&执行

⛔ 不适用场景（When Not to Use）

本技能不支持以下场景，请勿尝试：

💡 示例参考

每个意图场景的完整调用示例已在对应场景文件中提供，请直接查阅：

• 各场景调用命令 + 响应结构 + 完整示例：/references/scenarios/XX-xxx.md
• 通用参数规范：见上文「通用调用规范」章节

⚠️ 重要注意事项

1. JSON 格式: --input-configs 和 --output-configs 必须是 JSON 字符串
   • ✅ 正确：--input-configs '{"function_option": "..."}'
   • ❌ 错误：--input-configs {"function_option": "..."}
2. 安全与配额: 严禁泄露 API Key，注意 A0211 配额限制
3. 图片大小: 本地文件最大 5MB，支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp/webp 格式

🔗 相关资源

• 夸克扫描王开放平台
• API 通用规范（可选参考）
• 场景文件目录