当用户需要对图片、截图进行画质优化、瑕疵去除或视觉增强时，使用此技能——包括画质增强、证件照优化、考试试卷增强、合同增强等场景。智能去除手写笔迹、水印、阴影、摩尔纹、底色等干扰元素。支持图像裁剪与矫正、素描效果转换、线稿提取等，输出优化后的高清图片。本技能由夸克扫描王提供支持。即使用户没有明确提到“增强”或“处理”，只要用户的需求涉及提升图片清晰度、清理干扰元素或优化图像质量，也应触发此技能。不适用于文字提取/识别、文档转换 (Word/Excel/PDF)、AI 图像生成、证件照制作
SaferSkills independently audited yescan-scan-qoder (Agent Skill) and scored it 45/100 (orange). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 1 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 1 flagged
A base64 string of 128+ characters appears in a documentation file. Encoded prompt injection hides the hostile instruction in base64 — invisible to keyword filters — and relies on the agent's ability to decode it at runtime. There is no normal authoring reason to embed a multi-hundred-byte base64 blob in skill docs.
*.sig, SIGNATURES) outside the documentation.Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
隐私与数据流向提示 - 第三方服务交互：本技能会将您提供的图片发送至夸克扫描王官方服务器 (`scan-business.quark.cn`) 进行识别。 - 服务端处理：夸克扫描王服务将获取并处理该图片内容，服务端不会永久保存 - 本地文件存储：识别返回的图片会保存至系统临时目录（如/tmp/imgs），这些文件将持续存在直到您手动清理 - API 密钥安全：SCAN_WEBSERVICE_KEY应妥善保管，若泄露请及时在官方平台轮换或撤销
推荐方式：配置文件（永久生效）
将真实 SCAN_WEBSERVICE_KEY 写入 ~/.yescan_env，请根据系统选择对应命令进行设置：
Linux
echo 'SCAN_WEBSERVICE_KEY=<your_api_key_here>' > ~/.yescan_envmacOS
echo 'SCAN_WEBSERVICE_KEY=<your_api_key_here>' > ~/.yescan_envWindows（PowerShell）
'SCAN_WEBSERVICE_KEY=<your_api_key_here>' | Out-File -FilePath $HOME\.yescan_env -Encoding utf8技能每次执行会自动读取 ~/.yescan_env，无需重启会话。
如何获取密钥？夸克扫描王官方入口在此
请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看 API Key。 ⚠️ 注意：若你点击链接后跳转到其他域名，说明该链接已失效 —— 请直接在浏览器地址栏手动输入 https://scan.quark.cn/business（这是当前唯一有效的官方入口）。第一步：输入验证
校验用户传入的图片类型，只能是以下三种之一：
🚫 HARD GATE - 输入检查点：必须验证到有效图片输入才能继续。未提供任何有效图片时，直接返回：
{
"code": "A0201",
"message": "缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。",
"data": null
}第二步：意图匹配&场景确定
🚫 HARD GATE - 场景检查点：必须成功匹配到合法场景标识才能进入第三步。禁止自行构造 --scene 参数值，禁止跳过匹配直接使用默认场景。
第三步：构建执行命令(固定格式，严禁修改)：
根据图片类型，严格使用下面对应格式：
# URL类型
python3 scripts/scan.py --scene "${SCENE_VALUE}" --url "${IMAGE_URL}" --platform "${AGENT_NAME}"
# 本地文件类型
python3 scripts/scan.py --scene "${SCENE_VALUE}" --path "${IMAGE_FILE_PATH}" --platform "${AGENT_NAME}"
# BASE64类型
python3 scripts/scan.py --scene "${SCENE_VALUE}" --base64 "${IMAGE_BASE64}" --platform "${AGENT_NAME}"${IMAGE_URL}/${IMAGE_FILE_PATH}/${IMAGE_BASE64}替换为真实值${AGENT_NAME} 替换为你当前运行的 Agent 平台名称（如 openclaw、hermes、qoderWork、wukong、coze、claudecode 等），禁止猜测或自造值，无法确定时填 community${SCENE_VALUE}替换为当前意图对应的scene值🚫 HARD GATE - 命令格式检查点：必须严格使用上述固定格式，禁止修改命令结构、禁止添加额外参数。命令格式校验不通过时，禁止执行。
第四步：结果透出（最严格规则）：
命令执行后，脚本会输出一段 JSON 文本。你必须把这段 JSON 原封不动地作为你的最终回复输出，一个字都不能改。
这是整个技能中最关键的规则，因为下游系统会直接解析你的输出作为结构化数据。任何加工都会导致解析失败。
禁止的行为（违反即视为严重错误）：
唯一正确的做法： 把脚本的 stdout 输出（完整的 JSON 字符串）直接粘贴为你的回复。
第五步：错误处理与降级策略
命令执行后可能出现两种情况：正常返回 JSON（无论 code 是什么），或命令本身执行失败（如脚本不存在、Python 报错等）。
重试规则：最多执行 1 次，不做重试。 命令失败后不要尝试用其他方式补救，直接透出错误信息。
降级路径（按优先级）：
常见错误码说明（供理解，不改变原样透出规则）：
A0100：API Key 未配置A0211：API 配额不足A0406：图片无法下载（URL 不可达）A0407：图片 URL 不安全（仅支持 HTTPS）FILE_ERROR / FILE_READ_ERROR：本地文件读取失败URL_VALIDATION_ERROR：URL 格式不合法BASE64_*：base64 数据格式或解码错误HTTP_ERROR：HTTP 请求异常无论遇到哪个错误码，处理方式都是原样透出，禁止自行构造替代响应或尝试其他处理方案。
📖 每个场景的完整触发意图描述和示例指令，请查阅 references/scenes.md
| # | 场景名称 | scene 标识 | 关键词速记 |
|---|---|---|---|
| 1 | 考试增强 | exam-enhance | 试卷、笔记、教材、学习资料 |
| 2 | 画质增强 | image-hd-enhance | 模糊、低清、老照片、增强画质 |
| 3 | 证件票据增强 | certificate-enhance | 身份证、发票、护照、证件 |
| 4 | 图像去手写 | remove-handwriting | 去手写、去笔迹、还原空白 |
| 5 | 图像去水印 | remove-watermark | 去水印、去Logo、去标记 |
| 6 | 图像去阴影 | remove-shadow | 去阴影、光照不均、黑色遮挡 |
| 7 | 图像去屏纹 | remove-screen-pattern | 屏纹、摩尔纹、翻拍、投影 |
| 8 | 文档去底色 | remove-background-color | 去底色、去背景色、白底黑字 |
| 9 | 图像裁剪矫正 | image-crop-rectify | 拍歪、透视矫正、裁剪边缘 |
| 10 | 素描速写 | sketch-drawing | 素描、速写、铅笔风格 |
| 11 | 提取线稿 | extract-lineart | 线稿、轮廓线、黑白线条 |
| 12 | 扫描合同 | scan-contract | 合同、协议、合同归档 |
| 13 | 扫描文件（兜底） | scan-document | 用户未指定具体场景、仅要求通用扫描或文档优化 |
匹配规则： 从上到下依次匹配，命中第一个即停止。当用户的请求无法明确对应上述 1-12 中任一具体场景时（例如仅说"优化一下"、"扫描这张图"而没有明确指出是增强画质、去水印、去阴影等具体操作），必须使用第 13 项 scan-document 作为兜底场景。严禁在意图模糊时，将"优化"、"处理"等笼统词汇强行解释为某个具体场景。
客户端脚本增强字段：当 scan.py 调用夸克 API 成功（code == "00000"）且响应 data 中包含 "ImageBase64" 时，scan.py 会主动调用 `file_saver.py` 将其解码并保存为本地图片文件，并在最终返回的 JSON 响应中，将 data 替换为仅包含 path 字段的对象 {"path": "/tmp/xxx.png"}。该行为由 scan.py 脚本实现，与模型无关，也不依赖 OpenClaw 平台自动介入。
📖 完整的不适用场景表、注意事项和资源链接，请查阅 references/limitations.md
SKILL.md — 本文档（意图分析 + 通用规范）references/scenes.md — 场景详细描述与触发意图references/limitations.md — 本文档（不适用场景与限制）scripts/scan.py — 主执行脚本 (Python 3.9+)scripts/common/*.py — 基础类库~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.