Design & media

image_to_word

Name: image_to_word
Author: scnet-sugon

Try it

图片转Word 服务，支持将图片异步转换为可编辑的 Word 文件。

What it does

本技能封装了 Scnet 图片转Word 服务，支持将图片异步转换为可编辑的 Word 文件，并通过轮询获取转换结果。

The skill document

Sugon-Scnet 图片转Word 服务技能

本技能封装了 Scnet 图片转Word 服务，支持将图片异步转换为可编辑的 Word 文件，并通过轮询获取转换结果。

功能特性

图片转 Word：将图片中的文档内容还原为 .docx。
异步任务 + 自动轮询：提交任务后自动轮询状态，直到任务完成或超时。

前置配置

⚠️ 重要：使用前需要申请 Scnet API Token

申请 API Token

访问 Scnet 官网注册/登录
在控制台申请 API 密钥（格式：sc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
复制密钥备用

配置 Token

手动配置（推荐）

在技能目录下创建 config/.env 文件，内容如下：

# =====  Sugon-Scnet 文档格式转化 API 配置 =====
# 申请地址：https://www.scnet.cn
SCNET_API_KEY=your_scnet_api_key_here

# API 基础地址（一般无需修改）
SCNET_API_BASE=https://api.scnet.cn/api/llm/v1

# 轮询配置（可选）
SCNET_POLL_INTERVAL=5
SCNET_MAX_POLL_TIME=600

添加：SCNET_API_KEY=你的密钥
设置文件权限为 600（仅所有者可读写）

⚠️ 安全警告：切勿将 API Key 直接粘贴到聊天对话中，否则可能被记录或泄露。

Token 更新

Token 过期后调用会返回 401 或 403 错误。更新方法：重新申请 Token 并替换 config/.env 中的 SCNET_API_KEY。

依赖安装

本技能需要 Python 3.6+ 和 requests 库。请运行以下命令：

   pip install requests

使用方法

参数说明

参数名	类型	必填	描述
ocrType	string	是	转换类型。必须为 IMAGE_TO_WORD（图片转 Word）
filePath	string	是	待转换文件的本地绝对路径。图片格式。

命令行调用示例

   python .claude/skills/image_to_word/scripts/main.py IMAGE_TO_WORD /path/to/image.png

在 AI 对话中使用

用户可以说：

“帮我把这张图片转换成 Word，图片路径 /Users/name/Downloads/slide.png”

AI 会根据 description 中的关键词自动触发本技能。

AI 调用建议

为避免触发 API 速率限制，请串行调用本技能，等待前一个任务完成后再发起下一个请求。
如果使用 OpenClaw 的 exec 工具，建议设置足够的 timeout，因为转换任务需要异步轮询。

配置选项

编辑 config/.env 文件：

变量名	默认值	说明
SCNET_API_KEY	必需	Scnet API 密钥
SCNET_API_BASE	https://api.scnet.cn/api/llm/v1	API 基础地址（一般无需修改）
SCNET_POLL_INTERVAL	5	轮询状态间隔（秒）
SCNET_MAX_POLL_TIME	600	最大轮询等待时间（秒）

输出

标准输出：转换成功时返回结果文件下载地址 JSON。
结果位于 data[0].output.results 中，为临时 MinIO 下载链接。
错误信息：如果发生错误，会输出以 错误: 开头的友好提示。

注意事项

输入文件必须与 ocrType 匹配：PDF_TO_WORD 输入 PDF，IMAGE_TO_WORD / IMAGE_TO_PPT 输入图片。
下载地址为临时授权链接，请及时下载使用。
转换任务为异步处理，脚本会自动轮询直到完成或超时。

故障排除

问题	解决方案
配置文件不存在	创建 config/.env 并填入 Token（参考前置配置）
API Key 无效/过期	重新申请 Token 并更新 `.env` 文件
文件不存在	检查提供的文件路径是否正确
网络连接失败	检查网络连接或防火墙设置
不支持的文件类型	确保文件扩展名为允许的类型（参考 API 文档）
401/403/Unauthorized	Token 无效或过期，重新申请并配置
任务长时间 running	可能是文件较大或服务繁忙，可增大 SCNET_MAX_POLL_TIME
任务失败	查看返回的 error_code 和 error_message

Related skills

diagram-generator

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Join meeting

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Memory

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván559 installs18 stars

Productivity

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

AdMapix

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

SEO (Site Audit + Content Writer + Competitor Analysis)

Site audit, content writing, and competitor analysis for organic search rankings.

by Iván574 installs31 stars

More from scnet-sugon

Browse all skills

scnet-ocr

Extract text from images and PDFs across 80+ document types via the SCNET API.

by scnet-sugon27 installs

支持识别企业财务报销场景的19 种常见票据，包括：增值税发票,增值税卷票,出租车发票,火车票,航空运输电子客票行程单,机动车销售统一发票,定额发票,过路过桥费发票,医疗发票,税收完税证明,船票,非税票据,通用机打发票,汽车票,值税通行费发票,网约车行程单,银联POS签购单,医疗住院发票,医疗费用结算单识别。仅在用户明确要求识别某张本地票据图片时触发，调用前必须确认用户同意上传该文件到 Scnet 远程 OCR 服务。

by scnet-sugon34 installs

social_security_card_ocr

仅在用户明确提及“社保卡”、“社会保障卡”、“医保卡”、“社保卡识别”等特定词汇时触发，用于识别社会保障卡上的姓名、社保号码、身份证号等核心信息。严禁用于通用 OCR 或其他非社保卡类证件识别。

by scnet-sugon18 installs

personal_card_ocr

将图片中的文字、身份证、银行卡、社保卡、户口本、出生医学证明、往来港澳通行证、往来台湾通行证、台湾居民来往大陆通行证、港澳居民来往内地通行证、中国香港身份证、外国人永久居留身份证、结婚证、不动产权证书、机动车行驶证正页、机动车行驶证副页、机动车驾驶证正页、机动车驾驶证副页、中国护照、学历证书、学历证书电子注册备案表、学位证书等信息识别并提取出来。本技能仅在用户明确要求对图片进行 OCR 识别，并同意将图片上传到第三方 OCR 服务（Scnet）处理时触发。只处理用户主动提供的本地图片路径，不会主动扫描或枚举文件系统。

by scnet-sugon22 installs

birth_medical_cert_ocr

仅在用户明确提及“出生医学证明”、“出生证明”、“医学出生证明”、“新生儿证明”等特定词汇时触发，用于识别出生医学证明上的核心信息（新生儿姓名、出生日期、父母信息、证件号码等）。严禁用于通用 OCR 或其他非出生医学证明类证件识别。

by scnet-sugon19 installs

bank_check_ocr

仅在用户明确提及“银行支票”、“支票号码”、“支票金额”、“支票识别”等特定词汇时触发，用于识别银行支票上的关键信息（号码、日期、大小写金额、签章等）。不适用于通用 OCR 或非支票类图像识别。

by scnet-sugon8 installs