{"id":"bc7df7cc-8a63-4f34-879c-9c0e204b157c","entityType":"agent","slug":"clawhub-yescan-ai-alibaba-quark-transoffice","name":"夸克扫描王 - 转Office Alibaba-Quark-Transoffice","canonicalUrl":"https://www.xpersona.co/agent/clawhub-yescan-ai-alibaba-quark-transoffice","canonicalPath":"/agent/clawhub-yescan-ai-alibaba-quark-transoffice","generatedAt":"2026-10-13T19:00:01.815Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-12T00:17:29.787Z","emptyReason":null},"description":"由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档 Skill: 夸克扫描王 - 转Office Alibaba-Quark-Transoffice Owner: yescan-ai Summary: 由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档 Tags: latest:1.1.19 Version history: v1.1.19 | 2026-07-10T08:46:25.109Z | user - 移除了示例元数据和 skill-card 文件，简化项目结构 - 微调了技能描述，去除冗余表述 -","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 969 downloads reported by the source. Last updated 10/12/2026.","installCommand":"clawhub skill install s17cpsmkvb7rwpbns3vsexnv0n882f2y:alibaba-quark-transoffice","sourceUrl":"https://clawhub.ai/yescan-ai/alibaba-quark-transoffice","homepage":"https://clawhub.ai/yescan-ai/skills/alibaba-quark-transoffice","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/yescan-ai/alibaba-quark-transoffice","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/yescan-ai/skills/alibaba-quark-transoffice","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .doc"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:17:29.787Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:17:29.787Z","emptyReason":null},"stars":null,"forks":null,"downloads":969,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.1.19","tractionLabel":"969 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T00:17:29.772Z","emptyReason":null},"lastUpdatedAt":"2026-10-12T00:17:29.787Z","lastCrawledAt":"2026-10-12T00:17:29.772Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-13T00:17:29.772Z","lastVerifiedAt":null,"highlights":[{"version":"1.1.19","createdAt":"2026-07-10T08:46:25.109Z","changelog":"- 移除了示例元数据和 skill-card 文件，简化项目结构 - 微调了技能描述，去除冗余表述 - 修正了环境变量 CLI 配置的 skill 路径，明确为 alibaba-quark-transoffice - 其余技能功能和使用流程未变","fileCount":12,"zipByteSize":17303},{"version":"1.1.18","createdAt":"2026-07-08T15:10:58.391Z","changelog":"- 技能名由 \"yescan-transoffice-universal\" 更名为 \"alibaba-quark-transoffice\"。 - 优化了技能描述与适用范围，明确仅适用于图片转 Office 文档（Word/Excel）或 PDF，不支持纯文本提取、图像增强等需求。 - 删除了 skill-card.md，增加了 _meta.json 文件。 - 规范化使用指引与场景说明，无功能和接口变化。 - 指南结构、执行命令和功能保持一致，仅文档内容更新与更名。","fileCount":12,"zipByteSize":17688},{"version":"1.1.17","createdAt":"2026-07-08T15:05:14.364Z","changelog":"- Skill display name changed from \"yescan-transoffice-universal\" to \"alibaba-quark-transoffice\" - Description updated for improved clarity and scope; references Office/PDF conversion triggers more broadly - Documentation now emphasizes using the skill when any image-to-editable-document scenario is detected, even if user does not mention file conversion explicitly - Internal documentation file `skill-card.md` removed; skill metadata `_meta.json` added","fileCount":12,"zipByteSize":17772}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17cpsmkvb7rwpbns3vsexnv0n882f2y:alibaba-quark-transoffice","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-13T19:00:01.815Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-transoffice/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-12T00:17:29.787Z","emptyReason":null},"readme":"Skill: 夸克扫描王 - 转Office Alibaba-Quark-Transoffice\n\nOwner: yescan-ai\n\nSummary: 由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档\n\nTags: latest:1.1.19\n\nVersion history:\n\nv1.1.19 | 2026-07-10T08:46:25.109Z | user\n\n- 移除了示例元数据和 skill-card 文件，简化项目结构  \n- 微调了技能描述，去除冗余表述  \n- 修正了环境变量 CLI 配置的 skill 路径，明确为 alibaba-quark-transoffice  \n- 其余技能功能和使用流程未变\n\nv1.1.18 | 2026-07-08T15:10:58.391Z | user\n\n- 技能名由 \"yescan-transoffice-universal\" 更名为 \"alibaba-quark-transoffice\"。\n- 优化了技能描述与适用范围，明确仅适用于图片转 Office 文档（Word/Excel）或 PDF，不支持纯文本提取、图像增强等需求。\n- 删除了 skill-card.md，增加了 _meta.json 文件。\n- 规范化使用指引与场景说明，无功能和接口变化。\n- 指南结构、执行命令和功能保持一致，仅文档内容更新与更名。\n\nv1.1.17 | 2026-07-08T15:05:14.364Z | user\n\n- Skill display name changed from \"yescan-transoffice-universal\" to \"alibaba-quark-transoffice\"\n- Description updated for improved clarity and scope; references Office/PDF conversion triggers more broadly\n- Documentation now emphasizes using the skill when any image-to-editable-document scenario is detected, even if user does not mention file conversion explicitly\n- Internal documentation file `skill-card.md` removed; skill metadata `_meta.json` added\n\nArchive index:\n\nArchive v1.1.19: 12 files, 17303 bytes\n\nFiles: scripts/common/__init__.py (1402b), scripts/common/constants.py (663b), scripts/common/file_saver.py (9484b), scripts/common/ocr_client.py (7194b), scripts/common/result_handlers.py (2943b), scripts/common/runner.py (3449b), scripts/common/scene_configs.py (1262b), scripts/common/validators.py (1943b), scripts/scan.py (334b), skill-card.md (2338b), SKILL.md (7444b), _meta.json (145b)\n\nFile v1.1.19:SKILL.md\n\n---\nname: alibaba-quark-transoffice\ndescription: 由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档\nmetadata: {\"openclaw\":{\"emoji\":\"🔍︎\",\"requires\":{\"bins\":[\"python3\"],\"env\":[\"SCAN_WEBSERVICE_KEY\"]},\"primaryEnv\":\"SCAN_WEBSERVICE_KEY\"},\"homepage\":\"https://scan.quark.cn/business\"}\n---\n\n# 🧭 使用前必读（30 秒）\n\n> [!WARNING] **⚠️ 隐私与数据流向重要提示**\n> - **第三方服务交互**：本技能会将您提供的**图片发送至夸克扫描王官方服务器 (`scan-business.quark.cn`)** 进行识别。\n> - **服务端处理**：夸克扫描王服务将获取并处理该图片内容，服务端不会永久保存\n> - **本地文件存储**：识别返回的文件会保存至系统临时目录（如 `/tmp`），这些文件将持续存在直到您手动清理\n> - **API 密钥安全**：`SCAN_WEBSERVICE_KEY` 应妥善保管，若泄露请及时在官方平台轮换或撤销\n> - **图片来源**：仅限用户明确指定的图片文件\n\n**推荐方式：CLI 配置（永久生效）**\n\n配置 `SCAN_WEBSERVICE_KEY` 环境变量到 OpenClaw：\n```bash\nopenclaw config set skills.entries.alibaba-quark-transoffice.env.SCAN_WEBSERVICE_KEY \"your_scan_webservice_key_here\"\n```\n> ⚠️ 配置后需要**重启或开启新会话**才能生效（技能列表在 session 启动时加载）。\n\n**如何获取密钥？夸克扫描王官方入口在此**\n> 请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key。  \n> ⚠️ **注意**：若你点击链接后跳转到其他域名，说明该链接已失效 —— 请直接在浏览器地址栏手动输入 `https://scan.quark.cn/business`（这是当前唯一有效的官方入口）。\n\n---\n\n# Constraints\n- **单一意图原则：每次请求只执行一个意图类型，命中即执行**\n- **严禁自行构造任何命令参数，严禁伪造、拼接内部配置**\n- **严禁幻觉，禁止伪造请求和响应，不得沿用上一次的场景、参数进行假设**\n- **必须严格按照本指南指定的固定格式执行，不允许自行修改命令**\n\n#  技能执行指南(强制执行)\n\n第一步：**环境变量检查**\n- 若 `SCAN_WEBSERVICE_KEY` 未配置，立即返回：\n```json\n{\n  \"code\": \"A0100\",\n  \"message\": \"SCAN_WEBSERVICE_KEY 未配置，请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key\",\n  \"data\": null\n}\n```\n\n第二步：**输入处理**\n\n识别用户传入的图片类型，只能是以下三种之一：\n\n- 图片URL: url\n- 本地文件路径: path\n- 图片BASE64: base64\n\n未提供任何有效图片时，直接返回：\n```json\n{\n  \"code\": \"A0201\",\n  \"message\": \"缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。\",\n  \"data\": null\n}\n```\n\n第三步：**意图匹配&场景确定**\n- 按照下面列出的意图*从上到下顺序匹配。命中第一个即停止*\n- 命中后，*只确定当前意图对应的scene标识*\n\n第四步：**构建执行命令(固定格式，严禁修改)**：\n\n根据图片类型，严格使用下面对应格式：\n```bash\n# URL类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --url \"${IMAGE_URL}\"\n\n# 本地文件类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --path \"${IMAGE_FILE_PATH}\"\n\n# BASE64类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --base64 \"${IMAGE_BASE64}\"\n```\n- 把`${IMAGE_URL}`/`${IMAGE_FILE_PATH}`/`${IMAGE_BASE64}`替换为真实值\n- 把`${SCENE_VALUE}`替换为当前意图对应的scene值\n- 直接执行命令，不增删任何参数，不修改JSON，不加引号，不换行\n\n第五步：**结果透出**：\n- 执行完成后，*原样返回执行结果*，不修改，不翻译，不美化，不总结\n- 成功 失败均直接透出，不重试\n\n\n## 场景与意图列表(按匹配优先级排序)\n\n1. 图片转 Excel\n- 触发意图：当用户请求将包含表格、数据、报表的图片、截图或扫描件转换为Excel (.xlsx/.xls) 文件，触发此意图。\n- 场景scene标识：image-to-excel\n- 参考示例指令：\n  - \"帮我把这张财务报表截图转换成 Excel 文件。\"\n  - \"这里有张手写的库存记录照片，麻烦转成 Excel 给我。\"\n  - \"把这张包含销售数据的图片转成可编辑的 Excel。\"\n  - \"提取图片中的表格内容，保存为 .xlsx。\"\n\n2. 图片转 Word\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为Word 文档 触发此意图\n- 场景scene标识：image-to-word\n- 参考示例指令：\n  - \"把这张会议记录的拍照图片转成 Word 文档。\"\n  - \"请将这张包含长篇文章的截图转换为 .docx 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n\n3. 图片转 Pdf\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为 PDF 文档 触发此意图\n- 场景scene标识：image-to-pdf\n- 参考示例指令：\n  - \"把这张手写的课堂笔记图片转成 PDF 文档。\"\n  - \"请将这张包含详细参数的设备铭牌照片转换为 .pdf 格式。\"\n  - \"帮我把这张合同照片处理一下，转成清晰的 PDF 存档。\"\n  - \"将这张包含复杂流程的白板草图转换为 PDF，保持版面整洁。\"\n\n**客户端脚本增强字段**：当 `scan.py` 调用夸克 API 成功（`code == \"00000\"`）且响应 `data` 中包含 `\"FileBase64\"` 时，`scan.py` 会**主动调用 `file_saver.py` 将其解码并保存为本地文件**，并在最终返回的 JSON 响应中，于 `data` 对象内**追加 `\"path\": \"/tmp/xx.docx\"` 字段**。该行为由 `scan.py` 脚本实现，与模型无关，也不依赖 OpenClaw 平台自动介入。\n\n## ⛔ 不适用场景（When Not to Use）\n\n> 本技能**不支持**以下场景，请勿尝试：\n\n| 不支持的场景 | 原因 | 建议替代方案 |\n|------------|------|------------|\n| **视频处理** | 仅支持单张静态图片 | 先提取视频帧，再逐帧处理 |\n| **批量处理** | 每次调用仅限单张图片 | 如需批量，请循环调用或联系管理员 |\n| **实时摄像头流** | 非实时流处理架构 | 使用专用视频处理服务 |\n| **超大图片（>5MB）** | API 限制 | 先压缩或裁剪后再处理 |\n| **非图片格式** | 仅支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp | 先转换为支持的图片格式 |\n\n---\n\n## ⚠️ 重要注意事项\n\n1. **禁止修改固定格式**,只能替换场景标识和图片占位符\n2. **严禁自行构造 --scene 参数值，必须使用本文档指定的场景名**\n3. **图片大小限制：本地文件不超过5MB，支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp/webp 格式**\n\n---\n\n## 🔗 相关资源\n- [夸克扫描王开放平台](https://scan.quark.cn/business)\n\n## 📁 文件结构\n- `SKILL.md` —  本文档（意图分析 + 通用规范）\n- `scripts/scan.py` —  主执行脚本 (Python 3.9+)\n- `scripts/common/*.py` —  基础类库\n\nFile v1.1.19:_meta.json\n\n{\n  \"ownerId\": \"kn7765a4naksvzk0fmvenc4gjd88gjtb\",\n  \"slug\": \"alibaba-quark-transoffice\",\n  \"version\": \"1.1.19\",\n  \"publishedAt\": 1783673185109\n}\n\nFile v1.1.19:skill-card.md\n\n## Description:\n\nConverts user-supplied images, screenshots, and scans into editable Word, Excel, or PDF files using Quark Scan.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yescan-ai](https://clawhub.ai/user/yescan-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users, developers, and operators use this skill to convert a single image, screenshot, or scan into an editable Office document or PDF while preserving layout where possible.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Selected images, scans, or screenshots are uploaded to Quark's third-party service for conversion.\n\nMitigation: Use the skill only for documents you are comfortable sending to that service, and avoid sensitive documents unless the service terms and data handling meet your requirements.\n\nRisk: The SCAN_WEBSERVICE_KEY credential is required and could be exposed through misconfiguration or shared environments.\n\nMitigation: Store the key in the configured environment variable only, avoid pasting it into prompts or logs, and rotate it promptly if exposure is suspected.\n\nRisk: Generated Word, Excel, or PDF files are saved under the system temporary directory and can persist after the session.\n\nMitigation: Inspect and remove generated files from the temp directory after use, especially on shared machines.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/yescan-ai/skills/alibaba-quark-transoffice)\n- [ClawHub Publisher Profile](https://clawhub.ai/user/yescan-ai)\n- [Quark Scan Open Platform](https://scan.quark.cn/business)\n\n## Skill Output:\n\n**Output Type(s):** [text, json, shell commands, configuration, files, guidance]\n\n**Output Format:** [JSON response with a local file path when conversion succeeds]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires SCAN_WEBSERVICE_KEY; accepts one image URL, local path, or base64 input; generated files are saved under the system temporary directory.]\n\n## Skill Version(s):\n\n1.1.19 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.1.18: 12 files, 17688 bytes\n\nFiles: _meta.json (145b), scripts/common/__init__.py (1402b), scripts/common/constants.py (663b), scripts/common/file_saver.py (9484b), scripts/common/ocr_client.py (7188b), scripts/common/result_handlers.py (2943b), scripts/common/runner.py (3438b), scripts/common/scene_configs.py (3237b), scripts/common/validators.py (1943b), scripts/scan.py (334b), skill-card.md (2297b), SKILL.md (7559b)\n\nFile v1.1.18:SKILL.md\n\n---\nname: alibaba-quark-transoffice\ndescription: 由夸克扫描王提供的文件格式转换工具,支持图片转Word / Excel / PDF，精准还原内容排版。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档。本技能由夸克扫描王提供技术支持。\nmetadata: {\"openclaw\":{\"emoji\":\"🔍︎\",\"requires\":{\"bins\":[\"python3\"],\"env\":[\"SCAN_WEBSERVICE_KEY\"]},\"primaryEnv\":\"SCAN_WEBSERVICE_KEY\"},\"homepage\":\"https://scan.quark.cn/business\"}\n---\n\n# 🧭 使用前必读（30 秒）\n\n> [!WARNING] **⚠️ 隐私与数据流向重要提示**\n> - **第三方服务交互**：本技能会将您提供的**图片发送至夸克扫描王官方服务器 (`scan-business.quark.cn`)** 进行识别。\n> - **服务端处理**：夸克扫描王服务将获取并处理该图片内容，服务端不会永久保存\n> - **本地文件存储**：识别返回的文件会保存至系统临时目录（如 `/tmp`），这些文件将持续存在直到您手动清理\n> - **API 密钥安全**：`SCAN_WEBSERVICE_KEY` 应妥善保管，若泄露请及时在官方平台轮换或撤销\n> - **图片来源**：仅限用户明确指定的图片文件\n\n**推荐方式：CLI 配置（永久生效）**\n\n配置 `SCAN_WEBSERVICE_KEY` 环境变量到 OpenClaw：\n```bash\nopenclaw config set skills.entries.yescan-transoffice-universal.env.SCAN_WEBSERVICE_KEY \"your_scan_webservice_key_here\"\n```\n> ⚠️ 配置后需要**重启或开启新会话**才能生效（技能列表在 session 启动时加载）。\n\n**如何获取密钥？夸克扫描王官方入口在此**\n> 请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key。  \n> ⚠️ **注意**：若你点击链接后跳转到其他域名，说明该链接已失效 —— 请直接在浏览器地址栏手动输入 `https://scan.quark.cn/business`（这是当前唯一有效的官方入口）。\n\n---\n\n# Constraints\n- **单一意图原则：每次请求只执行一个意图类型，命中即执行**\n- **严禁自行构造任何命令参数，严禁伪造、拼接内部配置**\n- **严禁幻觉，禁止伪造请求和响应，不得沿用上一次的场景、参数进行假设**\n- **必须严格按照本指南指定的固定格式执行，不允许自行修改命令**\n\n#  技能执行指南(强制执行)\n\n第一步：**环境变量检查**\n- 若 `SCAN_WEBSERVICE_KEY` 未配置，立即返回：\n```json\n{\n  \"code\": \"A0100\",\n  \"message\": \"SCAN_WEBSERVICE_KEY 未配置，请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key\",\n  \"data\": null\n}\n```\n\n第二步：**输入处理**\n\n识别用户传入的图片类型，只能是以下三种之一：\n\n- 图片URL: url\n- 本地文件路径: path\n- 图片BASE64: base64\n\n未提供任何有效图片时，直接返回：\n```json\n{\n  \"code\": \"A0201\",\n  \"message\": \"缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。\",\n  \"data\": null\n}\n```\n\n第三步：**意图匹配&场景确定**\n- 按照下面列出的意图*从上到下顺序匹配。命中第一个即停止*\n- 命中后，*只确定当前意图对应的scene标识*\n\n第四步：**构建执行命令(固定格式，严禁修改)**：\n\n根据图片类型，严格使用下面对应格式：\n```bash\n# URL类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --url \"${IMAGE_URL}\"\n\n# 本地文件类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --path \"${IMAGE_FILE_PATH}\"\n\n# BASE64类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --base64 \"${IMAGE_BASE64}\"\n```\n- 把`${IMAGE_URL}`/`${IMAGE_FILE_PATH}`/`${IMAGE_BASE64}`替换为真实值\n- 把`${SCENE_VALUE}`替换为当前意图对应的scene值\n- 直接执行命令，不增删任何参数，不修改JSON，不加引号，不换行\n\n第五步：**结果透出**：\n- 执行完成后，*原样返回执行结果*，不修改，不翻译，不美化，不总结\n- 成功 失败均直接透出，不重试\n\n\n## 场景与意图列表(按匹配优先级排序)\n\n1. 图片转 Excel\n- 触发意图：当用户请求将包含表格、数据、报表的图片、截图或扫描件转换为Excel (.xlsx/.xls) 文件，触发此意图。\n- 场景scene标识：image-to-excel\n- 参考示例指令：\n  - \"帮我把这张财务报表截图转换成 Excel 文件。\"\n  - \"这里有张手写的库存记录照片，麻烦转成 Excel 给我。\"\n  - \"把这张包含销售数据的图片转成可编辑的 Excel。\"\n  - \"提取图片中的表格内容，保存为 .xlsx。\"\n\n2. 图片转 Word\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为Word 文档 触发此意图\n- 场景scene标识：image-to-word\n- 参考示例指令：\n  - \"把这张会议记录的拍照图片转成 Word 文档。\"\n  - \"请将这张包含长篇文章的截图转换为 .docx 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n\n3. 图片转 Pdf\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为 PDF 文档 触发此意图\n- 场景scene标识：image-to-pdf\n- 参考示例指令：\n  - \"把这张手写的课堂笔记图片转成 PDF 文档。\"\n  - \"请将这张包含详细参数的设备铭牌照片转换为 .pdf 格式。\"\n  - \"帮我把这张合同照片处理一下，转成清晰的 PDF 存档。\"\n  - \"将这张包含复杂流程的白板草图转换为 PDF，保持版面整洁。\"\n\n**客户端脚本增强字段**：当 `scan.py` 调用夸克 API 成功（`code == \"00000\"`）且响应 `data` 中包含 `\"FileBase64\"` 时，`scan.py` 会**主动调用 `file_saver.py` 将其解码并保存为本地文件**，并在最终返回的 JSON 响应中，于 `data` 对象内**追加 `\"path\": \"/tmp/xx.docx\"` 字段**。该行为由 `scan.py` 脚本实现，与模型无关，也不依赖 OpenClaw 平台自动介入。\n\n## ⛔ 不适用场景（When Not to Use）\n\n> 本技能**不支持**以下场景，请勿尝试：\n\n| 不支持的场景 | 原因 | 建议替代方案 |\n|------------|------|------------|\n| **视频处理** | 仅支持单张静态图片 | 先提取视频帧，再逐帧处理 |\n| **批量处理** | 每次调用仅限单张图片 | 如需批量，请循环调用或联系管理员 |\n| **实时摄像头流** | 非实时流处理架构 | 使用专用视频处理服务 |\n| **超大图片（>5MB）** | API 限制 | 先压缩或裁剪后再处理 |\n| **非图片格式** | 仅支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp | 先转换为支持的图片格式 |\n\n---\n\n## ⚠️ 重要注意事项\n\n1. **禁止修改固定格式**,只能替换场景标识和图片占位符\n2. **严禁自行构造 --scene 参数值，必须使用本文档指定的场景名**\n3. **图片大小限制：本地文件不超过5MB，支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp/webp 格式**\n\n---\n\n## 🔗 相关资源\n- [夸克扫描王开放平台](https://scan.quark.cn/business)\n\n## 📁 文件结构\n- `SKILL.md` —  本文档（意图分析 + 通用规范）\n- `scripts/scan.py` —  主执行脚本 (Python 3.9+)\n- `scripts/common/*.py` —  基础类库\n\nFile v1.1.18:_meta.json\n\n{\n  \"ownerId\": \"kn7765a4naksvzk0fmvenc4gjd88gjtb\",\n  \"slug\": \"alibaba-quark-transoffice\",\n  \"version\": \"1.1.18\",\n  \"publishedAt\": 1783523458391\n}\n\nFile v1.1.18:skill-card.md\n\n## Description: <br>\nConverts user-provided images, screenshots, and scans into editable Word or Excel files or PDF documents using Quark Scan. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[yescan-ai](https://clawhub.ai/user/yescan-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to convert a single selected image, screenshot, or scan into Word, Excel, or PDF while preserving layout. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Selected images or scans and use of SCAN_WEBSERVICE_KEY are sent to scan-business.quark.cn for processing. <br>\nMitigation: Use the skill only when third-party processing is acceptable, avoid sensitive identity, medical, legal, or confidential business documents, and rotate the API key if exposure is suspected. <br>\nRisk: The bundled script exposes OCR and image-processing scenes beyond the advertised image-to-Office conversion scope. <br>\nMitigation: Limit agent use to the documented image-to-word, image-to-excel, and image-to-pdf scenes. <br>\nRisk: Converted output files are written to the system temporary directory and may persist after the session. <br>\nMitigation: Review and remove temporary output files after use. <br>\n\n\n## Reference(s): <br>\n- [Quark Scan Business Platform](https://scan.quark.cn/business) <br>\n- [ClawHub skill page](https://clawhub.ai/yescan-ai/skills/alibaba-quark-transoffice) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [JSON, Files, Shell commands, Configuration instructions] <br>\n**Output Format:** [JSON response with a local file path for generated .docx, .xlsx, or .pdf files when conversion succeeds] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires SCAN_WEBSERVICE_KEY and accepts exactly one image URL, local image path, or base64 image per invocation.] <br>\n\n## Skill Version(s): <br>\n1.1.18 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.1.17: 12 files, 17772 bytes\n\nFiles: _meta.json (145b), scripts/common/__init__.py (1402b), scripts/common/constants.py (663b), scripts/common/file_saver.py (9484b), scripts/common/ocr_client.py (7188b), scripts/common/result_handlers.py (2943b), scripts/common/runner.py (3438b), scripts/common/scene_configs.py (3237b), scripts/common/validators.py (1943b), scripts/scan.py (334b), skill-card.md (2551b), SKILL.md (7559b)\n\nFile v1.1.17:SKILL.md\n\n---\nname: alibaba-quark-transoffice\ndescription: 由夸克扫描王提供的文件格式转换工具,支持图片转Word / Excel / PDF，精准还原内容排版。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档。本技能由夸克扫描王提供技术支持。\nmetadata: {\"openclaw\":{\"emoji\":\"🔍︎\",\"requires\":{\"bins\":[\"python3\"],\"env\":[\"SCAN_WEBSERVICE_KEY\"]},\"primaryEnv\":\"SCAN_WEBSERVICE_KEY\"},\"homepage\":\"https://scan.quark.cn/business\"}\n---\n\n# 🧭 使用前必读（30 秒）\n\n> [!WARNING] **⚠️ 隐私与数据流向重要提示**\n> - **第三方服务交互**：本技能会将您提供的**图片发送至夸克扫描王官方服务器 (`scan-business.quark.cn`)** 进行识别。\n> - **服务端处理**：夸克扫描王服务将获取并处理该图片内容，服务端不会永久保存\n> - **本地文件存储**：识别返回的文件会保存至系统临时目录（如 `/tmp`），这些文件将持续存在直到您手动清理\n> - **API 密钥安全**：`SCAN_WEBSERVICE_KEY` 应妥善保管，若泄露请及时在官方平台轮换或撤销\n> - **图片来源**：仅限用户明确指定的图片文件\n\n**推荐方式：CLI 配置（永久生效）**\n\n配置 `SCAN_WEBSERVICE_KEY` 环境变量到 OpenClaw：\n```bash\nopenclaw config set skills.entries.yescan-transoffice-universal.env.SCAN_WEBSERVICE_KEY \"your_scan_webservice_key_here\"\n```\n> ⚠️ 配置后需要**重启或开启新会话**才能生效（技能列表在 session 启动时加载）。\n\n**如何获取密钥？夸克扫描王官方入口在此**\n> 请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key。  \n> ⚠️ **注意**：若你点击链接后跳转到其他域名，说明该链接已失效 —— 请直接在浏览器地址栏手动输入 `https://scan.quark.cn/business`（这是当前唯一有效的官方入口）。\n\n---\n\n# Constraints\n- **单一意图原则：每次请求只执行一个意图类型，命中即执行**\n- **严禁自行构造任何命令参数，严禁伪造、拼接内部配置**\n- **严禁幻觉，禁止伪造请求和响应，不得沿用上一次的场景、参数进行假设**\n- **必须严格按照本指南指定的固定格式执行，不允许自行修改命令**\n\n#  技能执行指南(强制执行)\n\n第一步：**环境变量检查**\n- 若 `SCAN_WEBSERVICE_KEY` 未配置，立即返回：\n```json\n{\n  \"code\": \"A0100\",\n  \"message\": \"SCAN_WEBSERVICE_KEY 未配置，请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key\",\n  \"data\": null\n}\n```\n\n第二步：**输入处理**\n\n识别用户传入的图片类型，只能是以下三种之一：\n\n- 图片URL: url\n- 本地文件路径: path\n- 图片BASE64: base64\n\n未提供任何有效图片时，直接返回：\n```json\n{\n  \"code\": \"A0201\",\n  \"message\": \"缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。\",\n  \"data\": null\n}\n```\n\n第三步：**意图匹配&场景确定**\n- 按照下面列出的意图*从上到下顺序匹配。命中第一个即停止*\n- 命中后，*只确定当前意图对应的scene标识*\n\n第四步：**构建执行命令(固定格式，严禁修改)**：\n\n根据图片类型，严格使用下面对应格式：\n```bash\n# URL类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --url \"${IMAGE_URL}\"\n\n# 本地文件类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --path \"${IMAGE_FILE_PATH}\"\n\n# BASE64类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --base64 \"${IMAGE_BASE64}\"\n```\n- 把`${IMAGE_URL}`/`${IMAGE_FILE_PATH}`/`${IMAGE_BASE64}`替换为真实值\n- 把`${SCENE_VALUE}`替换为当前意图对应的scene值\n- 直接执行命令，不增删任何参数，不修改JSON，不加引号，不换行\n\n第五步：**结果透出**：\n- 执行完成后，*原样返回执行结果*，不修改，不翻译，不美化，不总结\n- 成功 失败均直接透出，不重试\n\n\n## 场景与意图列表(按匹配优先级排序)\n\n1. 图片转 Excel\n- 触发意图：当用户请求将包含表格、数据、报表的图片、截图或扫描件转换为Excel (.xlsx/.xls) 文件，触发此意图。\n- 场景scene标识：image-to-excel\n- 参考示例指令：\n  - \"帮我把这张财务报表截图转换成 Excel 文件。\"\n  - \"这里有张手写的库存记录照片，麻烦转成 Excel 给我。\"\n  - \"把这张包含销售数据的图片转成可编辑的 Excel。\"\n  - \"提取图片中的表格内容，保存为 .xlsx。\"\n\n2. 图片转 Word\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为Word 文档 触发此意图\n- 场景scene标识：image-to-word\n- 参考示例指令：\n  - \"把这张会议记录的拍照图片转成 Word 文档。\"\n  - \"请将这张包含长篇文章的截图转换为 .docx 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n\n3. 图片转 Pdf\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为 PDF 文档 触发此意图\n- 场景scene标识：image-to-pdf\n- 参考示例指令：\n  - \"把这张手写的课堂笔记图片转成 PDF 文档。\"\n  - \"请将这张包含详细参数的设备铭牌照片转换为 .pdf 格式。\"\n  - \"帮我把这张合同照片处理一下，转成清晰的 PDF 存档。\"\n  - \"将这张包含复杂流程的白板草图转换为 PDF，保持版面整洁。\"\n\n**客户端脚本增强字段**：当 `scan.py` 调用夸克 API 成功（`code == \"00000\"`）且响应 `data` 中包含 `\"FileBase64\"` 时，`scan.py` 会**主动调用 `file_saver.py` 将其解码并保存为本地文件**，并在最终返回的 JSON 响应中，于 `data` 对象内**追加 `\"path\": \"/tmp/xx.docx\"` 字段**。该行为由 `scan.py` 脚本实现，与模型无关，也不依赖 OpenClaw 平台自动介入。\n\n## ⛔ 不适用场景（When Not to Use）\n\n> 本技能**不支持**以下场景，请勿尝试：\n\n| 不支持的场景 | 原因 | 建议替代方案 |\n|------------|------|------------|\n| **视频处理** | 仅支持单张静态图片 | 先提取视频帧，再逐帧处理 |\n| **批量处理** | 每次调用仅限单张图片 | 如需批量，请循环调用或联系管理员 |\n| **实时摄像头流** | 非实时流处理架构 | 使用专用视频处理服务 |\n| **超大图片（>5MB）** | API 限制 | 先压缩或裁剪后再处理 |\n| **非图片格式** | 仅支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp | 先转换为支持的图片格式 |\n\n---\n\n## ⚠️ 重要注意事项\n\n1. **禁止修改固定格式**,只能替换场景标识和图片占位符\n2. **严禁自行构造 --scene 参数值，必须使用本文档指定的场景名**\n3. **图片大小限制：本地文件不超过5MB，支持 jpg/jpeg/png/gif/bmp/webp/tiff/wbmp/webp 格式**\n\n---\n\n## 🔗 相关资源\n- [夸克扫描王开放平台](https://scan.quark.cn/business)\n\n## 📁 文件结构\n- `SKILL.md` —  本文档（意图分析 + 通用规范）\n- `scripts/scan.py` —  主执行脚本 (Python 3.9+)\n- `scripts/common/*.py` —  基础类库\n\nFile v1.1.17:_meta.json\n\n{\n  \"ownerId\": \"kn7765a4naksvzk0fmvenc4gjd88gjtb\",\n  \"slug\": \"alibaba-quark-transoffice\",\n  \"version\": \"1.1.17\",\n  \"publishedAt\": 1783523114364\n}\n\nFile v1.1.17:skill-card.md\n\n## Description: <br>\nConverts user-provided images, screenshots, or scans into editable Word or Excel documents, or into PDF files, using Quark Scan's document conversion service. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[yescan-ai](https://clawhub.ai/user/yescan-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill when they need to convert a single user-specified image, screenshot, or scan into a Word, Excel, or PDF file while preserving the original layout where possible. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: User-specified images are sent to Quark's scan-business.quark.cn service for processing. <br>\nMitigation: Use the skill only for images the user intentionally provides and only when third-party processing is acceptable. <br>\nRisk: Generated files are saved under /tmp and may remain there until cleaned up. <br>\nMitigation: Review and remove generated files after use when they contain sensitive or regulated content. <br>\nRisk: Security evidence reports that the code exposes broader OCR and image-processing modes than the advertised conversion modes. <br>\nMitigation: Install only if the publisher is trusted, or require a conversion-only scene allowlist before deployment. <br>\nRisk: SCAN_WEBSERVICE_KEY grants access to the external conversion service if exposed. <br>\nMitigation: Store the key in the agent environment, restrict access to it, and rotate or revoke it if disclosure is suspected. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/yescan-ai/skills/alibaba-quark-transoffice) <br>\n- [Quark Scan business portal](https://scan.quark.cn/business) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, JSON, Shell commands, Files] <br>\n**Output Format:** [JSON response with status fields and, on successful conversion, a local file path to the generated document.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires python3 and SCAN_WEBSERVICE_KEY; supports one image input at a time from URL, local path, or base64 data.] <br>\n\n## Skill Version(s): <br>\n1.1.17 (source: server-resolved release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>","readmeExcerpt":"Skill: 夸克扫描王 - 转Office Alibaba-Quark-Transoffice Owner: yescan-ai Summary: 由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档 Tags: latest:1.1.19 Version history: v1.1.19 | 2026-07-10T08:46:25.109Z | user - 移除了示例元数据和 skill-card 文件，简化项目结构 - 微调了技能描述，去除冗余表述 -","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"openclaw config set skills.entries.alibaba-quark-transoffice.env.SCAN_WEBSERVICE_KEY \"your_scan_webservice_key_here\""},{"language":"json","snippet":"{\n  \"code\": \"A0100\",\n  \"message\": \"SCAN_WEBSERVICE_KEY 未配置，请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key\",\n  \"data\": null\n}"},{"language":"json","snippet":"{\n  \"code\": \"A0201\",\n  \"message\": \"缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。\",\n  \"data\": null\n}"},{"language":"bash","snippet":"# URL类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --url \"${IMAGE_URL}\"\n\n# 本地文件类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --path \"${IMAGE_FILE_PATH}\"\n\n# BASE64类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --base64 \"${IMAGE_BASE64}\""},{"language":"bash","snippet":"openclaw config set skills.entries.yescan-transoffice-universal.env.SCAN_WEBSERVICE_KEY \"your_scan_webservice_key_here\""},{"language":"json","snippet":"{\n  \"code\": \"A0100\",\n  \"message\": \"SCAN_WEBSERVICE_KEY 未配置，请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key\",\n  \"data\": null\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: alibaba-quark-transoffice\ndescription: 由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档\nmetadata: {\"openclaw\":{\"emoji\":\"🔍︎\",\"requires\":{\"bins\":[\"python3\"],\"env\":[\"SCAN_WEBSERVICE_KEY\"]},\"primaryEnv\":\"SCAN_WEBSERVICE_KEY\"},\"homepage\":\"https://scan.quark.cn/business\"}\n---\n\n# 🧭 使用前必读（30 秒）\n\n> [!WARNING] **⚠️ 隐私与数据流向重要提示**\n> - **第三方服务交互**：本技能会将您提供的**图片发送至夸克扫描王官方服务器 (`scan-business.quark.cn`)** 进行识别。\n> - **服务端处理**：夸克扫描王服务将获取并处理该图片内容，服务端不会永久保存\n> - **本地文件存储**：识别返回的文件会保存至系统临时目录（如 `/tmp`），这些文件将持续存在直到您手动清理\n> - **API 密钥安全**：`SCAN_WEBSERVICE_KEY` 应妥善保管，若泄露请及时在官方平台轮换或撤销\n> - **图片来源**：仅限用户明确指定的图片文件\n\n**推荐方式：CLI 配置（永久生效）**\n\n配置 `SCAN_WEBSERVICE_KEY` 环境变量到 OpenClaw：\n```bash\nopenclaw config set skills.entries.alibaba-quark-transoffice.env.SCAN_WEBSERVICE_KEY \"your_scan_webservice_key_here\"\n```\n> ⚠️ 配置后需要**重启或开启新会话**才能生效（技能列表在 session 启动时加载）。\n\n**如何获取密钥？夸克扫描王官方入口在此**\n> 请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key。  \n> ⚠️ **注意**：若你点击链接后跳转到其他域名，说明该链接已失效 —— 请直接在浏览器地址栏手动输入 `https://scan.quark.cn/business`（这是当前唯一有效的官方入口）。\n\n---\n\n# Constraints\n- **单一意图原则：每次请求只执行一个意图类型，命中即执行**\n- **严禁自行构造任何命令参数，严禁伪造、拼接内部配置**\n- **严禁幻觉，禁止伪造请求和响应，不得沿用上一次的场景、参数进行假设**\n- **必须严格按照本指南指定的固定格式执行，不允许自行修改命令**\n\n#  技能执行指南(强制执行)\n\n第一步：**环境变量检查**\n- 若 `SCAN_WEBSERVICE_KEY` 未配置，立即返回：\n```json\n{\n  \"code\": \"A0100\",\n  \"message\": \"SCAN_WEBSERVICE_KEY 未配置，请访问 https://scan.quark.cn/business → 开发者后台 → 登录/注册账号 → 查看API Key\",\n  \"data\": null\n}\n```\n\n第二步：**输入处理**\n\n识别用户传入的图片类型，只能是以下三种之一：\n\n- 图片URL: url\n- 本地文件路径: path\n- 图片BASE64: base64\n\n未提供任何有效图片时，直接返回：\n```json\n{\n  \"code\": \"A0201\",\n  \"message\": \"缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。\",\n  \"data\": null\n}\n```\n\n第三步：**意图匹配&场景确定**\n- 按照下面列出的意图*从上到下顺序匹配。命中第一个即停止*\n- 命中后，*只确定当前意图对应的scene标识*\n\n第四步：**构建执行命令(固定格式，严禁修改)**：\n\n根据图片类型，严格使用下面对应格式：\n```bash\n# URL类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --url \"${IMAGE_URL}\"\n\n# 本地文件类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --path \"${IMAGE_FILE_PATH}\"\n\n# BASE64类型\npython3 scripts/scan.py --scene \"${SCENE_VALUE}\" --base64 \"${IMAGE_BASE64}\"\n```\n- 把`${IMAGE_URL}`/`${IMAGE_FILE_PATH}`/`${IMAGE_BASE64}`替换为真实值\n- 把`${SCENE_VALUE}`替换为当前意图对应的scene值\n- 直接执行命令，不增删任何参数，不修改JSON，不加引号，不换行\n\n第五步：**结果透出**：\n- 执行完成后，*原样返回执行结果*，不修改，不翻译，不美化，不总结\n- 成功 失败均直接透出，不重试\n\n\n## 场景与意图列表(按匹配优先级排序)\n\n1. 图片转 Excel\n- 触发意图：当用户请求将包含表格、数据、报表的图片、截图或扫描件转换为Excel (.xlsx/.xls) 文件，触发此意图。\n- 场景scene标识：image-to-excel\n- 参考示例指令：\n  - \"帮我把这张财务报表截图转换成 Excel 文件。\"\n  - \"这里有张手写的库存记录照片，麻烦转成 Excel 给我。\"\n  - \"把这张包含销售数据的图片转成可编辑的 Excel。\"\n  - \"提取图片中的表格内容，保存为 .xlsx。\"\n\n2. 图片转 Word\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为Word 文档 触发此意图\n- 场景scene标识：image-to-word\n- 参考示例指令：\n  - \"把这张会议记录的拍照图片转成 Word 文档。\"\n  - \"请将这张包含长篇文章的截图转换为 .docx 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n  - \"将这张产品说明书的截图转为 Word 格式。\"\n\n3. 图片转 Pdf\n- 触发意图：当用户请求将图片、截图、照片或扫描件转换为 PDF 文档 触发此意图\n- 场景scene标识：image-to-pdf\n- 参考示例指令：\n  - \"把这张手写的课堂笔记图片转成 PDF 文档。\"\n  - \"请将这张包含详细参数的设备铭牌照片转"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7765a4naksvzk0fmvenc4gjd88gjtb\",\n  \"slug\": \"alibaba-quark-transoffice\",\n  \"version\": \"1.1.19\",\n  \"publishedAt\": 1783673185109\n}"},{"path":"skill-card.md","content":"## Description:\n\nConverts user-supplied images, screenshots, and scans into editable Word, Excel, or PDF files using Quark Scan.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yescan-ai](https://clawhub.ai/user/yescan-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users, developers, and operators use this skill to convert a single image, screenshot, or scan into an editable Office document or PDF while preserving layout where possible.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Selected images, scans, or screenshots are uploaded to Quark's third-party service for conversion.\n\nMitigation: Use the skill only for documents you are comfortable sending to that service, and avoid sensitive documents unless the service terms and data handling meet your requirements.\n\nRisk: The SCAN_WEBSERVICE_KEY credential is required and could be exposed through misconfiguration or shared environments.\n\nMitigation: Store the key in the configured environment variable only, avoid pasting it into prompts or logs, and rotate it promptly if exposure is suspected.\n\nRisk: Generated Word, Excel, or PDF files are saved under the system temporary directory and can persist after the session.\n\nMitigation: Inspect and remove generated files from the temp directory after use, especially on shared machines.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/yescan-ai/skills/alibaba-quark-transoffice)\n- [ClawHub Publisher Profile](https://clawhub.ai/user/yescan-ai)\n- [Quark Scan Open Platform](https://scan.quark.cn/business)\n\n## Skill Output:\n\n**Output Type(s):** [text, json, shell commands, configuration, files, guidance]\n\n**Output Format:** [JSON response with a local file path when conversion succeeds]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires SCAN_WEBSERVICE_KEY; accepts one image URL, local path, or base64 input; generated files are saved under the system temporary directory.]\n\n## Skill Version(s):\n\n1.1.19 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档 Skill: 夸克扫描王 - 转Office Alibaba-Quark-Transoffice Owner: yescan-ai Summary: 由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档 Tags: latest:1.1.19 Version history: v1.1.19 | 2026-07-10T08:46:25.109Z | user - 移除了示例元数据和 skill-card 文件，简化项目结构 - 微调了技能描述，去除冗余表述 -","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":871,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-12T00:17:29.787Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-12T00:17:29.787Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-13T19:00:01.815Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}