核心用法
Skywork Document 是一个企业级文档生成 Skill，通过调用 Skywork Office Doc API 实现多格式专业文档输出。
三种创作模式：
1. 从零创作：基于AI生成报告、提案、论文、博客、小说、简历等任何类型文档
2. 基于参考文件改写：上传PDF/Word/Excel等文件，进行摘要、改写、扩写、翻译
3. 智能增强创作：自动联网搜索最新信息，整合到文档中
标准工作流：
- Step 0: 意图识别 → 判断是否需要参考文件、确定语言/格式/内容要求
- Step 1: 文件解析（如有）→ 调用
parse_file.py 逐文件处理，获取 file_id - Step 2: 文档创建 → 调用
create_doc.py，传入标题、内容提示、语言、格式及参考文件ID - Step 3: 结果交付 → 返回
file_url（云端下载链接）和 file_path（本地路径）
输出格式：docx（默认）、pdf、html、md；支持多语言：中文简体/繁体、英语、日语、韩语、法语、德语、西班牙语等
---
显著优点
| 维度 | 优势 |
|------|------|
格式专业 | 输出符合商业标准的docx/pdf，排版美观，非简单文本堆砌 |
| **智能搜索** | 内置自动搜索，无需用户预查资料，AI自主获取最新信息 |
| **参考文件支持** | 可基于上传材料深度改写，保持原文核心信息同时优化表达 |
| **长文生成** | 支持5-10分钟长时生成复杂文档，SSE实时进度反馈 |
| **多场景覆盖** | 从学术论文到社交媒体帖子，从合同到小说，全场景适用 |
| **零配置启动** | 一键认证后即用，无需复杂环境搭建 |
---
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| **数据上云风险** ⭐ | 参考文件必须上传至Skywork云端解析，敏感文档存在数据主权隐患 |
| **来源不可验证** | T3级别信任度，无GitHub公开仓库，无法审计代码历史 |
| **会员门槛** | 需升级Skywork会员才能使用，存在"Insufficient benefit"限制 |
| **生成耗时** | 复杂文档需5-10分钟，不适合即时性需求 |
| **网络依赖** | 全程依赖Skywork API，无法离线使用 |
| **Token明文存储** | 认证凭证默认以明文JSON存于 `~/.skywork_token`，需手动加固权限 |
| **浏览器自动打开** | 认证流程自动调用系统浏览器，某些安全环境可能触发告警 |
---
适合人群
- 商务人士：快速生成提案、合同、会议纪要、商业计划书
- 研究人员：基于论文/数据生成综述报告、研究摘要
- 内容创作者：批量生产博客、社交媒体文案、营销材料
- 学生群体：改写笔记、生成论文框架、制作简历
- 非敏感数据处理者：不涉及机密、隐私、商业机密的常规文档工作
不适合：处理机密合同、含PII的个人数据、需完全离线环境的敏感场景
---
常规风险
| 风险等级 | 风险项 | 具体表现 |
|---------|--------|---------|
| 🔴 高 | 凭证泄露 | `SKYBOT_TOKEN` 环境变量读取，明文本地存储 |
| 🟠 中 | 数据外联 | 文档内容上传至 `api-tools.skywork.ai`，离开本地环境 |
| 中 | 云端依赖 | 服务可用性、数据保留政策完全依赖Skywork |
| 🟡 低 | 来源不明 | 无法验证开发者身份，供应链安全风险 |
| 🟡 低 | 自动行为 | 认证时自动打开浏览器，可能被安全软件拦截 |
合规状态：GDPR/CCPA通过，敏感数据加密传输，权限最小化原则满足
---
使用建议
1. 敏感文档先脱敏：上传前移除机密信息、个人身份信息
2. 隔离环境运行：在独立终端设置 SKYBOT_TOKEN，避免全局环境变量
3. 加固Token文件：手动执行 chmod 600 ~/.skywork_token
4. 定期轮换凭证：监控Skywork账户访问日志，发现异常立即重置
5. 明确告知用户：团队协作时提前说明数据将上传至云端