DocRaptor 托管文档生成

解决什么问题

把 HTML 渲染成 PDF 或 Excel 并不难，难的是稳定地生成、托管并拿到可下载地址。手动跑脚本会遇到认证管理、执行追踪、状态变更安全边界等问题。

oo-docraptor 的做法是把 DocRaptor 接到 OOMOL 连接器上：你只需准备内容，凭据由服务端注入，不需要在本地保存 token。

核心能力

这个技能目前暴露一个动作：

• create_hosted_document：从原始 HTML 或公开 URL 创建托管的 PDF / Excel 文档，并返回下载地址。

执行时的关键步骤：

1. 先看契约：运行前读取权威的输入/输出 schema，不要凭感觉拼 payload。
2. 再构造 JSON：--data 支持 JSON 字符串或 @path/to/file.json；如果不需要参数就省略，等价于发送 {}。
3. 读响应：返回结构是 { "data": ..., "meta": { "executionId": "..." } }，执行 id 在 meta.executionId 里，便于追踪。

适用边界与注意点

• 这是一个会改变 DocRaptor 状态的动作：运行前必须和用户确认 payload 与实际效果。
• 如果动作涉及删除或移除类操作，属于破坏性操作，必须先确认目标并获得明确批准。
• 该技能依赖 oo CLI 已安装、已登录，且 DocRaptor 已连接；不要主动触发登录或打开连接页面，只有在命令确实报认证/连接错误时再走首次配置。
• 如果返回 HTTP 402 / OOMOL_INSUFFICIENT_CREDIT，说明额度已停，需要充值后再试。

适用场景：需要把报表页面、发票 HTML 或公开链接批量转成 PDF / Excel 并拿到托管下载链接的自动化流程。