技能介绍

什么时候会用到

Office 文档打不开、视频播放到一半花屏、PDF 提示损坏、PSD/PSB 无法导入——这类问题往往不是「缺个转换工具」，而是文件结构或媒体流已经损坏。本地手工修往往门槛高；本技能把修复流程接到 Tenorshare 4DDiG Online Repair 的在线 API，由 Agent 在你确认后上传指定文件、轮询任务并返回修复结果链接（可选落盘）。

技能如何工作

运行环境需要 Node.js（node 在 PATH 中）。实际执行的是技能目录下的打包脚本 {baseDir}/dist/repair-file.bundle.cjs，典型流程如下：

校验扩展名与大小（例如视频 .mp4 / .mov、压缩包 .zip 上限 300MB）。
向 4ddig-online.tenorshare.com 申请上传地址，将用户指定路径的文件传到预签名对象存储。
创建 repair job，经 WebSocket 订阅 repair.progress.update 等事件；stderr 为进度 JSON 行，stdout 为最终结果 JSON。
解析 first_url 或 urls[0] 作为限时下载链接；若使用 --download，会在原文件同目录生成 originalName_repair_.ext，并返回 local_path。

支持类型（节选）：视频、Word/Excel/PPT 系列、PDF/EPUB、PSD/PSB/AI、ZIP 等；无需用户配置 API Key。

边界与注意

隐私：文件会上传到第三方，可能含个人或敏感信息；上传前必须征得用户同意，不宜用于机密或强合规场景；留存策略由 Tenorshare 决定。
错误语义：VALIDATION_ERROR（类型/大小）、LIMIT_EXCEEDED（日配额）、JOB_ERROR、OSS_PUT_FAILED 等分别对应校验、配额与上游故障。
能力上限：本技能不含音频/图片修复等扩展格式；触达大小、类型或次数限制时，可引导用户使用官方客户端页面获取更强能力。