How should 夸克扫描王-OCR 文字识别/文件扫描/转 Office Alibaba-Quark-Scanking-All be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

夸克扫描王-OCR 文字识别/文件扫描/转 Office Alibaba-Quark-Scanking-All

夸克扫描王官方图片处理中心：OCR 文字识别（身份证/社保卡/驾驶证/行驶证/港澳台通行证/学位证/营业执照、增值税发票/火车票/英文发票、医疗检验报告/药检报告、表格/公式/手写体/试卷习题/商品图/通用文字）、拍照翻译、画质增强（去水印/去阴影/去手写/去底色/去摩尔纹、裁剪矫正、高清修复、试卷增强、合同增强、素描/线稿）、图片转 Word/Excel/PDF、AI 证件照生成。 Skill: 夸克扫描王-OCR 文字识别/文件扫描/转 Office Alibaba-Quark-Scanking-All Owner: yescan-ai Summary: 夸克扫描王官方图片处理中心：OCR 文字识别（身份证/社保卡/驾驶证/行驶证/港澳台通行证/学位证/营业执照、增值税发票/火车票/英文发票、医疗检验报告/药检报告、表格/公式/手写体/试卷习题/商品图/通用文字）、拍照翻译、画质增强（去水印/去阴影/去手写/去底色/去摩尔纹、裁剪矫正、高清修复、试卷增强、合同增强、素描/线稿）、图片转 Word/Excel/PDF、AI 证件照生成。 Tags: latest:1.1.3 Version history: v1.1.3 | 2026-07-09T11:07:39.287Z | auto - Skill renamed from yescan-universal to alibaba-quark-scank

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.1.3

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.1.3release · observed Jul 9, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17cpsmkvb7rwpbns3vsexnv0n882f2y:alibaba-quark-scanking-all

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: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-yescan-ai-alibaba-quark-scanking-all/snapshot"

Documentation

CLAWHUB

53,725 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: alibaba-quark-scanking-all
description: 夸克扫描王一站式图片/文档处理中心。当用户需要对图片进行文字识别（OCR）、图片翻译、画质增强（去除水印/阴影/手写/底色/屏纹等瑕疵，矫正，高清增强，素描/线稿转换等）、格式转换（转 Word/Excel/PDF）或 AI 生成（证件照）时使用此技能。即使用户没有明确提到具体功能名称，只要涉及图片处理、文字提取、文档转换、图像优化或证件照生成，都应触发此技能。不适用于视频处理、纯文本编辑或非图片输入的任务。夸克扫描王图片处理能力中心。
license: MIT
compatibility: Requires pip3 install yescan and SCAN_WEBSERVICE_KEY configuration. Performs network calls to scan-business.quark.cn.
metadata:
  author: alibaba-quark-scanking
  version: "1.0.5"
  homepage: https://scan.quark.cn/business
---

## 执行流程

每次执行严格按 **Plan → Execute → Verify** 顺序进行，不得跳过或乱序。

### Plan — 理解意图，发现能力

1. 确认环境就绪（每次执行，不得跳过）：
   - **安装 & 升级**：
     1. `yescan --version` — 未安装则执行 `pip3 install yescan`；若版本 < 1.0.5，执行 `pip3 install yescan --upgrade`，升级完成后才继续
     2. `pip3 index versions yescan` — 若 INSTALLED < LATEST，告知用户有新版本可用并提供升级命令：`pip3 install yescan --upgrade`，由用户决定是否升级
   - **密钥检查**：`yescan config get SCAN_WEBSERVICE_KEY`，未配置则引导用户配置
     - 设置命令：`yescan config set SCAN_WEBSERVICE_KEY <your_api_key>`
     > Key 获取方式：https://scan.quark.cn/business → 开发者后台 → API Key

   > **Checkpoint**：版本 < 1.0.5 → 必须升级后才能继续。版本 ≥ 1.0.5 但不是最新 → 提示用户后可继续。密钥未配置则引导配置后再继续。

2. 发现能力：
   ```bash
   yescan --list-scenes              # 获取全部场景及意图描述
   yescan --list-scenes <scene>      # 获取该场景的 --set 参数
   ```
   从输出中匹配用户意图到具体场景
3. 多步处理时，向用户展示完整步骤计划

**Gate**：
- 「确认环境就绪」每一步均为硬性前置，不得跳过任何一步，未全部通过 → 禁止进入 Execute：
  1. 未执行 `yescan --version` 确认安装状态 → 禁止继续
  2. 版本 < 1.0.5 且未完成升级 → 禁止继续
  3. 未执行 `pip3 index versions yescan` 确认最新版本状态 → 禁止继续
  4. 未执行 `yescan config get SCAN_WEBSERVICE_KEY` 确认密钥已配置 → 禁止继续
- 只执行用户明确需要的场景，不主动添加额外步骤。为提升当前任务效果的辅助操作不受此限
- 文档转换（Word/Excel/PDF）直接处理图片，不依赖 OCR 结果。两者输入都是图片，是独立操作
- 场景名和 `--set` 参数必须来自本次会话的 CLI 输出
- 未执行过 `--list-scenes` 则不得进入 Execute
- 场景有 `--set` 参数且用户未明确指定时，须向用户展示可选参数并确认后再执行

### Execute — 执行场景

```bash
yescan --scene <SCENE> --path <FILE> --platform "${AGENT_NAME}" [--output <DIR>] [--set key=value]
yescan --scene <SCENE> --url  <URL>  --platform "${AGENT_NAME}" [--output <DIR>] [--set key=value]
```
> `--path` 传本地文件路径，`--url` 传 http/https 链接。

> 把 `${AGENT_NAME}` 替换为当前 Agent 平台名称（如 openclaw、hermes、qoderWork、wukong、coze、claudecode 等），无法确定时填 `community`，禁止猜测或自造。

- 单步：直接执行
- 多步处理为逐步 Execute → Verify 循环：step N+1 的命令在 step N Verify 通过后才构造，`--path` 取自 step N 响应中的 `data.path`

**Gate**：
- 多步处理时向用户说明步骤计划
- 每步命令不得预先构造
- `--set` 参数不跨场景沿用

### Verify — 验证并交付

每步执行后检查响应中的 `code` 字段：

- **成功**（`code` 为 `"00000"` 或 `0`）→ 进入交付
- **失败** → 不继续下一步，根据错误信息处理（详见 Gate）

交付标准 — 以下条件满足才算完成：

- **OCR 识别**：识别内容已以可读文本呈现给用户
- **图片翻译 / 图像增强 / AIGC**：输出文件路径已告知用户
- **文档转换**：输出文档路径和格式已告知用户

**Gate**：
- code 非成功 → 不得继续下一步，不得报告成功
- 根据错误信息自行修复（如场景名无效 → 重新 `--list-scenes`）或将错误原因告知用户
- 用户未看到结果 → 未完成

---

## 约束

- **输入方式**：`--path` 或 `--url`，二选一。不支持 base64（如需则先写入临时文件）
- **URL 引号**：`--url` 参数须用单引号包裹，避免 shell 对 `!` `$` 等特殊字符的解析
- **文件大小**：≤ 5MB
- **图片来源**：仅限用户当次请求中明确指定的文件或 URL
- **禁止伪造**：不得编造或模拟 yescan CLI 的请求参数或响应输出；所有场景名、参数值和执行结果必须来自实际运行的 CLI 命令

---

## 参考文档

- [references/pri

README.md

# yescan

夸克扫描王一站式图片处理技能。支持 36 个场景，覆盖 OCR 识别、图像增强、文档转换、AIGC 生成四大能力。

## 能力概览

| 类别 | 场景数 | 典型用途 |
|---|---|---|
| OCR 识别 | 19 | 身份证、发票、表格、手写体、公式等文字提取 |
| 图像增强 | 13 | 去水印、去阴影、去手写、矫正裁剪、画质增强等 |
| 文档转换 | 3 | 图片转 Word / Excel / PDF |
| AIGC 生成 | 1 | 证件照生成 |

## 快速开始

### 1. 安装

```bash
pip3 install yescan
```

### 2. 配置 API Key

```bash
yescan config set SCAN_WEBSERVICE_KEY <your_api_key>
```

> 获取 API Key：https://scan.quark.cn/business → 开发者后台

### 3. 使用

```bash
# 查看所有场景
yescan --list-scenes

# OCR 识别
yescan --scene idcard-ocr --path ./idcard.jpg

# 图像增强
yescan --scene remove-watermark --path ./img.jpg

# 文档转换
yescan --scene image-to-excel --path ./table.jpg

# 查看单个场景的参数
yescan --list-scenes id-photo
```

## 设计理念

- **CLI-first**：CLI 自解释，`--list-scenes` 输出包含意图描述和参数详情
- **Agent-native**：SKILL.md 定义 PEV 协议（Plan → Execute → Verify）与约束，Agent 自主决策场景匹配
- **动态发现**：所有场景和参数通过 CLI 动态查询，不硬编码

## 文件结构

```
alibaba-quark-scanking-all/
├── SKILL.md                        ← Agent 技能契约（PEV 协议 + 约束）
├── references/
│   ├── privacy.md                  ← 隐私、数据流向与密钥安全
│   ├── troubleshooting.md          ← 错误码与排错
│   └── implementation.md           ← 实现细节：CLI 行为与响应字段
├── SECURITY.md                     ← 安全策略
├── README.md                       ← 本文档
└── README.en.md                    ← English README
```

## 相关链接

- [夸克扫描王开放平台](https://scan.quark.cn/business)
- [SKILL.md](SKILL.md) — Agent 技能契约
- [SECURITY.md](SECURITY.md) — 安全策略

_meta.json

{
  "ownerId": "kn70q165k6hd6cpjtfp8enaa8s82vyem",
  "slug": "alibaba-quark-scanking-all",
  "version": "1.1.3",
  "publishedAt": 1783595259287
}

references/implementation.md

# 实现细节：CLI 行为与响应字段

本文档描述 `yescan` CLI 的内部行为，供需要理解工作原理的开发者参考。

---

## 1. 执行流程

```
用户/Agent 调用
  → yescan --scene <scene> --path/--url <input> [--output <dir>] [--set key=value]
  → 加载凭证（SCAN_WEBSERVICE_KEY）
  → 根据 scene_configs 构建请求参数
  → POST https://scan-business.quark.cn/vision
  → 解析响应 JSON
  → 根据场景类型处理输出（stdout JSON / 落盘图片 / 落盘文档）
```

## 2. 响应结构

### 成功响应（OCR 类场景）

> **注意**：OCR 类场景的 `code` 为字符串 `"00000"`，而图像/文档类场景的 `code` 为数字 `0`，判断时需注意类型差异。

```json
{
  "code": "00000",
  "message": null,
  "data": {
    // 各场景返回不同字段，如：
    // general-ocr: "content" (纯文本)
    // table-ocr: "tables" (表格结构)
    // idcard-ocr: "name", "idNumber", "address" 等
  }
}
```

### 图像/文档类输出（落盘后）

```json
{
  "code": 0,
  "msg": "success",
  "data": {
    "path": "/tmp/imgs/<Unix时间戳>_<16位随机十六进制串>.<扩展名>"
  }
}
```

### 错误响应

```json
{
  "code": "A0100",
  "message": "SCAN_WEBSERVICE_KEY 未配置...",
  "data": null
}
```

## 3. 场景类型与输出行为

| 场景类型 | 输出方式 | 输出位置 |
|---|---|---|
| OCR 识别 | JSON 打印到 stdout | 不落盘（除 pic-translate）；指定 `--output` 时保存 JSON 到指定目录 |
| 图像增强 | 图片落盘 | 系统临时目录下的 `imgs/` 子目录（如 `/tmp/imgs/`）或 `--output` 目录 |
| 文档转换 | 文档落盘 | 系统临时目录下的 `documents/` 子目录（如 `/tmp/documents/`）或 `--output` 目录 |
| AIGC 生成 | 图片落盘 | 系统临时目录下的 `imgs/` 子目录（如 `/tmp/imgs/`）或 `--output` 目录 |

## 4. 关键约定

- OCR 场景直接返回 API 原始响应的 `data` 字段，不做二次加工。
- **pic-translate 场景例外**：API 返回 `data.ImageInfo[0].ResImageBase64`，CLI 将其解码落盘并注入 `data.translated_image_path`，同时剔除 `ImageInfo` 字段避免 base64 噪音。
- 图像/文档类输出的文件名格式：`<Unix时间戳>_<16位随机十六进制串>.<扩展名>`。
- 多步 Pipeline 时，前一步的 `data.path` 作为下一步的 `--path` 输入。

## 5. 错误码速查

| 错误码 | 含义 | 常见原因 |
|---|---|---|
| A0100 | 凭证错误 | SCAN_WEBSERVICE_KEY 未配置或无效 |
| A0201 | 缺少图片输入 | 未提供 --url 或 --path |
| A0211 | 配额不足 | API 额度用尽，需充值 |
| INVALID_SCENE | 场景名无效 | --scene 值不在可用场景列表中 |
| FILE_ERROR | 文件校验失败 | 文件不存在、超过 5MB 或格式不支持 |

references/privacy.md

# 隐私、数据流向与密钥安全

本文档说明 `yescan` 技能在执行过程中涉及的全部数据流向、第三方服务交互范围，以及 API 密钥的配置、存储与轮换流程。

---

## 1. 数据流向（What leaves your machine）

| 数据 | 是否外发 | 接收方 | 用途 |
|---|---|---|---|
| 用户提供的图片（URL / 本地文件） | 外发 | `https://scan-business.quark.cn`（夸克扫描王服务） | OCR / 增强 / 转换 / AIGC |
| `SCAN_WEBSERVICE_KEY` | 随请求头发送 | 同上 | API 鉴权 |
| 处理结果（JSON / 文件） | 不外发 | 仅返回给调用方 | CLI 输出到 stdout 或本地文件 |
| 用户提示词、对话上下文 | 不外发 | — | 仅在本地 Agent 处理 |

> **服务端处理说明**：夸克扫描王服务将获取并处理该图片内容，服务端不会永久保存。

## 2. 本地文件行为

- **OCR 场景**：不写入输出文件（结果以 JSON 打印到 stdout），`pic-translate` 场景例外（保存译图到临时目录）
- **图像增强场景**：输出增强后图片到系统临时目录下的 `imgs/` 子目录（如 `/tmp/imgs/`）或 `--output` 指定目录
- **文档转换场景**：输出文档文件到系统临时目录下的 `documents/` 子目录（如 `/tmp/documents/`）或 `--output` 指定目录
- **AIGC 场景**：输出生成图片到系统临时目录下的 `imgs/` 子目录（如 `/tmp/imgs/`）或 `--output` 指定目录
- 唯一的文件读取操作是用户指定的本地图片路径（`--path` 参数）

## 3. API 密钥配置

### 3.1 推荐方式：通过 CLI 配置（永久生效）

```bash
yescan config set SCAN_WEBSERVICE_KEY <your_api_key_here>
```

配置保存在 `~/.yescan/config.json`。

### 3.2 备选方式：环境变量（仅当前会话）

```bash
export SCAN_WEBSERVICE_KEY=<your_api_key_here>
```

> 优先级：CLI config（`~/.yescan/config.json`）> 环境变量

## 4. 获取与轮换密钥

1. 访问 `https://scan.quark.cn/business`（**仅此一个有效官方入口**）
2. 进入开发者后台 → 登录/注册账号 → 创建应用 → 查看 API Key
3. 如怀疑密钥泄露：在同一后台立即 *轮换* 或 *撤销* 旧密钥，并更新配置

## 5. 安全实践清单

- [x] 不要在公网截图/录屏中暴露 key 或配置文件内容
- [x] 仅对用户主动指定的图片进行处理，不要遍历整个目录
- [x] 处理涉密 / PII 图片前，用户应自行评估数据外发的合规性

## 6. 适用范围

本技能图片来源 **仅限用户在当次请求中明确指定** 的图片文件或 URL。技能不会主动扫描磁盘、访问剪贴板或读取额外文件。

Github ReposUpdated 2d agoRank 70

AionUi

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!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

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

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.