高清文档扫描

技能文档

---
name: gaoqing-wendang-saomiao
description: 高清文档扫描与图片增强工具，自动裁剪矫正、去除阴影杂质，将图片变为高清扫描件。支持画质增强、证件照优化、试卷增强、合同扫描等场景。智能去除手写笔迹、水印、阴影、摩尔纹、底色等干扰元素。支持图像裁剪矫正、素描效果转换、线稿提取。当用户需要优化图片质量、扫描文档、增强清晰度或去除干扰元素时触发。触发词：扫描、文档扫描、图片增强、去水印、去阴影、去手写、画质提升、证件增强、试卷增强、合同扫描。
title: 高清文档扫描
category: 办公效率
---

# 高清文档扫描

将图片自动裁剪矫正、去除干扰元素，输出高清扫描件。

## 使用前必读

> **隐私与数据提示**
> - 本技能会将图片发送至第三方服务进行处理
> - 服务端不会永久保存图片内容
> - 处理后的图片保存在系统临时目录
> - 执行前需确认用户已知悉并同意处理

## 约束规则

- **单一意图原则**：每次请求只执行一个意图类型，命中即执行
- **严禁自行构造参数**：严禁伪造、拼接内部配置
- **严禁幻觉**：禁止伪造请求和响应
- **严格按格式执行**：必须按照指定格式执行命令
- **独立意图识别**：严禁参考对话历史，必须针对当前指令独立分析

## 执行流程

### 第一步：输入验证

校验用户传入的图片类型：
- 图片URL: url
- 本地文件路径: path
- 图片BASE64: base64

**未提供有效图片时返回：**
```json
{
  "code": "A0201",
  "message": "缺少图片输入，请提供图片链接、文件路径或 BASE64 数据。",
  "data": null
}
```

### 第二步：意图匹配与场景确定

按以下优先级从上到下匹配，命中第一个即停止：

| # | 场景名称 | 场景标识 | 关键词速记 |
|---|---------|-----------|-----------|
| 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` | 未指定具体场景、通用扫描 |

**匹配规则**：当用户请求无法明确对应具体场景时，使用 `scan-document` 作为兜底。

### 第三步：构建执行命令

```bash
# 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}"
```

### 第四步：结果透出

命令执行后返回 JSON 文本，**必须原封不动输出**，不做任何加工。

### 第五步：错误处理

**重试规则：最多执行 1 次，不做重试。**

**降级路径：**
1. 脚本正常返回 JSON → 原样透出
2. 脚本执行报错 → 将错误信息告知用户
3. 脚本不存在或环境异常 → 告知用户检查 Python 3 和 requests 库

**常见错误码：**
- `A0100`：API Key 未配置
- `A0211`：API 配额不足
- `A0406`：图片无法下载
- `FILE_ERROR`：本地文件读取失败
- `HTTP_ERROR`：HTTP 请求异常

## 不适用场景

- 文字提取/识别（请使用 OCR 工具）
- 文档格式转换（Word/Excel/PDF）
- AI 图像生成
- 证件照制作

## 文件结构

- `SKILL.md` — 本文档
- `references/scenes.md` — 场景详细描述
- `references/limitations.md` — 不适用场景与限制
- `scripts/scan.py` — 主执行脚本

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。