核心用法
Skywork Document 是一款面向复杂文档生成场景的自动化技能，通过调用 Skywork Office Doc API 实现从内容创作到格式输出的完整流水线。其工作流程分为三大阶段：
Step 0: 意图识别（关键前置步骤）
- 判断用户是否提供参考文件（PDF、Excel、Word 等），如有则需先解析获取 file_id
- 识别目标语言（默认 English）、输出格式（docx/pdf/html/md，默认 docx）
- 将用户需求综合为精准的
--content提示词，作为重写查询传递给 API
Step 1: 参考文件解析（可选）
- 使用
parse_file.py逐个解析文件，输出包含 file_id 的 JSON - 多文件场景需并行调用，收集所有 PARSED_FILE 结果
Step 2: 文档生成
- 调用
create_doc.py，传入 title/content/language/format 及可选 files 参数 - API 内置网络搜索能力，无需预搜索即可获取实时资料
- 通过 SSE 长连接实时接收进度，脚本自动等待 3-10 分钟直至完成
Step 3: 结果交付
- 必须同时返回
file_url（云端下载链接，可点击分享）和file_path（本地自动保存路径）
显著优点
1. 多格式原生输出：直接生成 docx、pdf、html、markdown，无需二次转换
2. 智能材料处理：支持基于上传文件的改写、摘要、扩展、翻译等衍生创作
3. 实时搜索集成：API 自动按需联网，降低用户前置信息收集成本
4. 长任务友好：SSE 进度推送 + 自动超时管理，适配 5-10 分钟的生成耗时
5. 企业级认证链：支持环境变量、缓存令牌、浏览器登录三重认证机制
潜在局限
- 会员门槛：检测到 benefit 不足时需引导用户升级 Skywork 会员
- 格式限制：明确排除纯文本短答案、代码文件、临时笔记等轻量场景
- 路径敏感：文件路径含空格需加引号，JSON 参数需双引号包裹
- 单文件解析：多参考文件需循环调用解析脚本，增加调用复杂度
适合人群
- 需要批量生成商业报告、研究论文、合同提案、简历求职信的专业人士
- 希望基于现有材料（如会议录音转文字、数据表格）快速产出结构化文档的用户
- 对文档格式有明确要求（必须 Word/PDF）且内容长度超出简单问答的场景
常规风险
- 令牌失效：需前置执行
skywork_auth.py，浏览器登录场景需主动暴露[LOGIN_URL]给用户 - 生成失败：长耗时任务可能因网络或服务器原因中断，需设置充分超时
- 本地路径为空：下载失败时 file_path 可能为空，需降级为仅提供 file_url
- 内容准确性：依赖 API 的搜索与生成能力，关键商业文档建议人工复核