← 返回 Skills 市场
多种格式文档转换/图片OCR
作者
daizhenping012
· GitHub ↗
· v1.0.2
· MIT-0
314
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install docs-converter
功能描述
调用文档转换全能王(https://www.wdangz.com)API进行文档格式转换。支持PDF/Word/Excel/PPT/图片等格式互转，OCR识别，PDF合并拆分加密等。转换完成后自动下载到原文件目录。
使用说明 (SKILL.md)
📄 文档转换全能王
调用 文档转换全能王 API 实现专业文档格式转换。
⚠️ 重要安全须知
使用此工具前，请务必了解以下风险：
| 风险类型 | 说明 |
|---|---|
| 📤 数据上传 | 文件将上传到 https://www.wdangz.com 进行转换 |
| 🔒 隐私风险 | 请勿上传包含敏感信息、机密数据或受监管文档 |
| 💼 商业机密 | 涉及商业秘密的文档请使用本地转换工具 |
| 🏥 个人隐私 | 包含个人身份信息(PII)的文档请谨慎处理 |
建议在以下情况下使用：
- ✅ 公开文档、普通办公文档
- ✅ 已脱敏的处理后文档
- ✅ 非敏感的格式转换需求
不建议用于：
- ❌ 财务报表、合同文件
- ❌ 身份证件、银行卡照片
- ❌ 公司内部机密文档
- ❌ 包含个人隐私的文件
✨ 支持的转换
| 转换类型 | 示例 |
|---|---|
| Word → PDF | "docx转PDF" |
| Excel → PDF | "xlsx转PDF" |
| PPT → PDF | "ppt转PDF" |
| PDF → Word | "PDF转Word" |
| PDF → Excel | "PDF转Excel" |
| PDF → 图片 | "PDF转图片" |
| 图片 → Word (OCR) | "图片转Word" |
| 图片 → Excel (OCR) | "图片转Excel" |
| PDF合并 | "合并PDF" |
| PDF拆分 | "拆分PDF" |
| PDF水印 | "添加水印" |
| PDF加密/解密 | "加密PDF" / "解密PDF" |
🚀 使用方式
直接告诉我：
- 文件路径 - 例如
E:\doc\report.docx - 目标格式 - 例如 "转成PDF"、"转为Word"
示例：
- "把 E:\doc\报告.docx 转换成 PDF"
- "将 report.pdf 转成 Word"
- "帮我把这个Excel转成PDF"
- "PDF文件添加水印"
📥 输出
转换后的文件自动保存到 原文件同一目录。
⚙️ 配置 API Key（必需）
首次使用必须配置 API Key！
获取 API Key 步骤
- 访问 文档转换全能王 注册账号
- 在官网菜单中找到 「API服务」 菜单并点击进入
- 按照页面提示开通 API 服务
- 获取 API Key 后设置环境变量
配置方式：环境变量（唯一支持方式）
Windows:
# 临时设置（当前终端会话）
$env:WDANGZ_API_KEY = "你的API密钥"
# 永久设置（用户级别）
[Environment]::SetEnvironmentVariable("WDANGZ_API_KEY", "你的API密钥", "User")
Linux/Mac:
# 临时设置
export WDANGZ_API_KEY="你的API密钥"
# 永久设置（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export WDANGZ_API_KEY="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
📋 技术细节
| 项目 | 说明 |
|---|---|
| API端点 | https://www.wdangz.com/api/v1/convert |
| 文件限制 | 单文件最大 50MB |
| 支持格式 | doc, docx, xls, xlsx, ppt, pptx, pdf, jpg, png, bmp, gif, webp |
| 依赖 | Python 3.x + requests 库 |
💡 Tip: 只需用自然语言描述你要做什么，我会自动识别转换类型！
安全使用建议
该技能会把你指定的本地文件上传到第三方服务 (https://www.wdangz.com)。在安装或使用前请注意：
- 切勿上传含有个人身份信息、财务数据、机密合同、私钥、凭证等敏感内容；技能本身也有类似警告。
- 仔细确认 WDANGZ 提供方的隐私条款和数据保留策略（上传的文档是否会被存储或用于训练等）。
- 平台元数据中出现不一致：摘要处显示“无需环境变量”，但 manifest 和 SKILL.md 要求 WDANGZ_API_KEY；在设置前请以 SKILL.md/manifest 为准并确认来源可靠。
- 确保运行环境已安装 Python requests 库，或在受控环境（脱敏副本）先行测试。
- 如果你需要处理敏感或受监管的文档，优先使用本地离线工具或在组织批准的环境中进行。
功能分析
Type: OpenClaw Skill
Name: docs-converter
Version: 1.0.2
The skill provides document conversion services by uploading files to the third-party API 'wdangz.com'. It is highly transparent about its data-handling practices, featuring prominent security warnings in SKILL.md and manifest.json regarding the risks of uploading sensitive data. The implementation in scripts/convert.py includes proactive defensive measures, such as a security check function that blocks or warns against uploading files containing sensitive keywords (e.g., 'password', 'secret', 'contract') or credential-related extensions (e.g., .env, .key, .pem).
能力评估
Purpose & Capability
技能名称、描述、SKILL.md、manifest.json 和脚本都表明它将把本地文件上传到 wdangz.com 的 API 进行文档/图片转换并下载结果；请求 API Key (WDANGZ_API_KEY) 与此用途相符。
Instruction Scope
运行指令和脚本只执行与转换相关的操作：检查文件大小/扩展名/敏感关键词、读取本地文件并通过 HTTPS 上传，轮询状态并下载结果。SKILL.md 明确警告不得上传敏感文档。没有指示读取与任务无关的系统文件或额外凭证。
Install Mechanism
没有安装规范（instruction-only + 附带脚本），不从不明 URL 下载或写入可执行内容。脚本依赖 requests，但没有自动安装步骤；这是低到中等风险（需用户确保运行环境有 Python requests）。
Credentials
技能需要一个单一 API 密钥 WDANGZ_API_KEY —— 与功能直接相关，属于合理请求。注意到顶端汇总信息（registry metadata）一处显示“Required env vars: none”，但 manifest.json 和 SKILL.md 都声明 WDANGZ_API_KEY 为必需，出现元数据不一致，建议确认平台登记信息与实际一致。
Persistence & Privilege
没有设置 always:true，也不请求修改其它技能或保存跨技能的凭证。代理可自主调用（默认），但这与技能功能一致且权限范围有限。
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install docs-converter - 安装完成后，直接呼叫该 Skill 的名称或使用
/docs-converter触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.2
Version 1.0.2
- 移除了 config.txt 配置文件，配置 API Key 现仅支持环境变量方式。
- SKILL.md 增加了对 API Key 设置方式的详细说明，并注明环境变量是唯一支持方式。
- 技能元数据中，新增了 API 端点、必填环境变量说明与简洁的安全警告。
- 不再推荐/支持通过配置文件存放 API Key，提高安全性。
v1.0.1
- 增加 manifest.json 文件，为技能提供必需的元数据支持。
- SKILL.md 增强：显著加入“重要安全须知”板块，提醒用户数据上传及隐私风险，明确不适用的文件类型。
- 完善 API Key 配置说明，推荐优先使用环境变量方式以提升安全性。
- 新增技术细节说明，包括API端点、支持格式与文件大小限制。
- 文档结构更清晰，分区标识和风险/推荐事项更加醒目易读。
v1.0.0
- Initial release of wdangz-doc-converter skill.
- Enables professional document format conversion using 文档转换全能王 API.
- Supports a wide range of document conversions (Word, Excel, PPT, PDF, images), including OCR, PDF merging, splitting, encryption, watermarking, etc.
- Conversion results are automatically saved to the original file directory.
- Requires users to configure an API Key before use.
元数据
常见问题
多种格式文档转换/图片OCR 是什么？
调用文档转换全能王(https://www.wdangz.com)API进行文档格式转换。支持PDF/Word/Excel/PPT/图片等格式互转，OCR识别，PDF合并拆分加密等。转换完成后自动下载到原文件目录。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 314 次。
如何安装 多种格式文档转换/图片OCR？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install docs-converter」即可一键安装，无需额外配置。
多种格式文档转换/图片OCR 是免费的吗？
是的，多种格式文档转换/图片OCR 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
多种格式文档转换/图片OCR 支持哪些平台？
多种格式文档转换/图片OCR 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 多种格式文档转换/图片OCR？
由 daizhenping012（@daizhenping012）开发并维护，当前版本 v1.0.2。
推荐 Skills