下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-wch5evxf--ofd365-file-convert.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-wch5evxf/ofd365-file-convert。通过 OFD365 云端文件转换 API（API Key 接口）将文件转换为 OFD、PDF、图片等格式。当用户要求把本地文件或 URL 文件转换成 OFD、PDF、Word、Excel、PPT、图片等格式（如 OFD 转 PDF、PDF 转 OFD、Word 转 PDF、OFD/PDF 转图片、图片转 OFD/PDF）时使用。
转换经 https://ofd365.com/ 的 API Key 接口在云端完成，用户需自备 dj_live_ 开头的 OFD365 API Key。
阅读全文 （展开查看完整说明）
概述
OFD365 文件格式转换（API Key 接口）
Overview
本技能让 AI 通过 OFD365 开放平台的「API Key 接口」完成文件格式转换（OFD/PDF/Office/图片等）。只调用一个云端接口：
POST https://ofd365.com/admin-api/convert/common
Header: X-Api-Key: dj_live_xxxxxxxx
Content-Type: application/json文件会先上传到 OFD365 云端处理，转换完成后把结果文件下载回本地。本技能只使用 API Key 接口，不使用网页端登录接口，也不读写任何前端/项目内部代码。
触发场景
当用户表达以下任一意图时使用本技能：
- OFD 转 PDF / PDF 转 OFD / OFD 转图片 / PDF 转图片
- Word/Excel/PPT/txt 转 OFD 或 PDF
- 图片（jpg/png/bmp/tif/gif 等）转 OFD 或 PDF
- 把某个文件"转成 OFD/PDF/图片格式"，且来源是本地文件或可下载 URL
不适用：本地离线格式转换、PDF 合并拆分等其他非 OFD365 转换需求。
前提条件（首次使用前完成）
- 获取 API Key：先询问用户是否已有 OFD365 开放平台的 API Key（
dj_live_开头）。若用户没有 Key，引导其打开 https://ofd365.com/api-keys 自助申请（路径：注册/登录 → 开放平台 → API Key 管理 → 创建 Key），拿到dj_live_开头的 Key 后再继续，本次停止。不要代填、不要猜测、不要写入任何交付物。 - 上传告知：每次转换前告知用户「文件将上传到 ofd365.com 云端处理」。若文件敏感且用户不同意上传，则停止，不做转换。
- 配置密钥到本机：
python scripts/ofd365_convert.py key set dj_live_你的Key- 校验已配置（只显示掩码）：
python scripts/ofd365_convert.py key show转换工作流（每次转换执行）
- 确认输入：本地文件路径，或远程文件 URL（用
--url）。 - 确认目标格式
--to（如 ofd / pdf / jpg）。用户未指定时推荐默认值：OFD→PDF 最常见，可主动建议或直接询问。 - 执行转换命令（见下方速查表）。
- 成功后告知用户输出文件路径与大小；询问是否继续转换其他文件。
命令速查
脚本 scripts/ofd365_convert.py 仅依赖 Python 标准库（Python 3.8+），跨平台。路径含中文或空格时务必加引号，Windows Git Bash 下用 Windows 风格路径。
| 需求 | 命令 |
|---|---|
| 本地 OFD 转 PDF | python scripts/ofd365_convert.py convert 发票.ofd --to pdf |
| 本地 PDF 转 OFD | python scripts/ofd365_convert.py convert 合同.pdf --to ofd |
| 本地 Word 转 PDF | python scripts/ofd365_convert.py convert 说明.docx --to pdf |
| 输出到指定目录 | 追加 -o "C:/Users/xxx/桌面/out" |
| 远程 URL 文件转换 | python scripts/ofd365_convert.py convert --url https://example.com/a.ofd --to pdf |
| 临时指定 Key（覆盖） | 追加 --api-key dj_live_xxx |
| 只看请求不真正转换 | 追加 --dry-run |
| 结构化输出 | 追加 --json |
| 超时（秒，默认 180） | 追加 --timeout 300 |
默认输出：本地文件转换后写到原文件同目录，自动取名 原名.目标格式（重名自动避开）。
密钥管理
- 密钥默认保存在
~/.ofd365/apikey（Windows 为C:Users你的用户名.ofd365apikey）。 - 读取优先级：
--api-key> 环境变量OFD365_API_KEY> 本地密钥文件。 - Key 属于用户，禁止写进日志、对话文档或任何交付文件；
key show只显示掩码。 - 没有 Key：引导用户访问 https://ofd365.com/api-keys 自助申请，获得
dj_live_开头的 Key 后再key set。 - 换 Key：重新执行
key set；删除：key clear。
支持格式
源文件格式（file_type）：pdf、ofd、doc、docx、xls、xlsx、ppt、pptx、txt、jpg、jpeg、png、bmp、tif、tiff、gif
常用目标格式（convert_type）：ofd、pdf、jpg（实际可用组合以该 Key 在 OFD365 平台开通的权限为准，部分组合可能需额外开通）。
注意：脚本按扩展名自动识别源类型；超大文件上传前先与用户确认（Base64 传输体积约放大 33%）。
错误处理
| 现象 | 处理方式 |
|---|---|
| 未配置 Key / 返回 401 | 先引导用户到 https://ofd365.com/api-keys 申请或核对 Key，再执行 key set（确认 dj_live_ 前缀完整） |
| 返回 403 | 该 Key 无权限或未开通该转换组合 → 告知用户联系 OFD365 平台开通 |
| 返回 400 | 参数或格式不支持 → 检查 --to 与源文件类型是否在支持列表 |
| 返回 500 / 网络超时 | 等待后重试一次；可提高 --timeout；检查网络连通性 |
业务失败 code=2010010000 msg=验证不通过,SYS_ID不能为空 | 当前 Key 在 OFD365 控制台未绑定任何「业务系统」。该字段不是请求参数而是账户层绑定，需登录 https://ofd365.com → 开放平台/API Key 管理 创建业务系统并把 Key 关联到该系统，再重新 key set（已绑定仍报错：联系 OFD365 客服核查 Key 状态） |
| 成功响应但无下载地址 | 可能命中异步返回，重试一次；仍失败则把接口返回原文提供给用户排查 |
| 输出文件下载失败 | 检查输出目录可写性；URL 方式下载失败可改用 --url 重新转换 |
禁止本地兜底：转换一律走 OFD365 API，不允许改用本地库（pypdf、LibreOffice 等）降级，否则 OFD 等格式保真度不一致。
合规说明
- 外呼端点：
POST https://ofd365.com/admin-api/convert/common（第三方云文件转换服务）。 - API Key 由用户自备；技能不内置、不索取任何平台密钥。
- 详细接口规范见
references/api.md（仅在排查参数/调试时按需读取）。
