---

slug: plug-ai-content-creation-workstation
displayName: "AI内容创作工作站"
version: 1.1.0
summary: "选题到爆款全链路,4技能协同覆盖选题/标题/预测/短剧制作"
license: Proprietary
description: |- 功能涵盖: plug, content, creation, wor。Use when 需要生成营销文案、写作内容、标题优化、内容创作时使用。不适用于纯技术文档撰写。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。提供结构化输出和错误处理机制。
  一站式AI内容创作解决方案，覆盖选题发现、标题优化、爆款预测到短剧制作的完整流程。4个高分技能协同工作，让内容创作效率提升10倍。
  目标用户: 自媒体创作者、内容运营团队、MCN机构、短剧制作人
  定价方案: 月付￥299/月 | 年付￥2999/年 | 买断￥4999
  包含技能: topic-hunter, title-hook-factory, viral-prophet, drama-hit-producer
tools:
  - read
  - exec
  - write
  - glob
  - grep
tags:
  - 内容创作
  - 选题推荐
  - 标题生成
  - 爆款预测
  - 短剧制作
  - 多平台分发
  - AI工具链
  - 自媒体

---

## 排错指南
### 问题1: 选题捕手返回的选题时效性差
**现象**: 选题与当前热点不符，评分偏低
**原因**: 热搜API不可用，已降级为LLM知识库生成
**解决**:
1. 检查 `HOT_SEARCH_API_KEY` 环境变量是否配置
2. 确认热搜API服务是否在线（可手动调用测试）
3. 配置国内热搜API（微博热搜/百度热搜/新榜API）替代
4. 降级模式下选题基于近期趋势推测，建议结合实际热搜验证
### 问题2: 标题钩子工厂生成的标题字数超标
**现象**: 小红书标题超过20字限制
**原因**: LLM生成时未严格遵守平台字数限制
**解决**:
1. 检查word_limit字段是否正确返回平台限制值
2. 标题已自动截断至平台最大字数，但可能丢失部分信息
3. 建议在topic描述中加入字数提示，如"20字以内"
4. 手动微调截断后的标题，保留核心关键词
### 问题3: 爆款预言机评分与实际表现差异大
**现象**: 预测高分内容表现一般，低分内容反而爆款
**原因**: 预测基于历史爆款规律和LLM分析，无法保证100%准确
**解决**:
1. 预测结果仅供参考，不作为发布决策的唯一依据
2. 评分>80的内容爆款概率较高，评分<60建议优化
3. 结合账号权重、发布时机、平台算法等多因素综合判断
4. 不同LLM模型评分可能差异较大，建议使用同一模型保持一致性
### 问题4: 短剧生产管道在第10步角色画面生成失败
**现象**: 管道执行到"角色画面生成"步骤时报错
**原因**: 图像生成API（InstantID/FLUX/Kling）不可用或配额耗尽
**解决**:
1. 检查 IMAGE_API_KEY 环境变量是否配置
2. 确认图像生成API配额是否充足
3. 尝试切换style_track：real_person→anime（使用FLUX引擎，成本更低）
4. 尝试切换scene_id：scene_7(Kling)→scene_6(FLUX标准画质)
5. 查看drama_assets/{project_id}/episodes/{chapter}.json确认失败步骤的错误信息
### 问题5: 四层TTS全部降级到L4 Edge-TTS
**现象**: tts_engine_used为edge_tts，tts_fallback_chain显示L1-L3全部失败
**原因**: CosyVoice2 API Key未配置或网络不通；本地GPU环境不可用
**解决**:
1. L4 Edge-TTS为免费方案，可正常使用但配音质量略低
2. 如需高质量配音，配置 TTS_API_KEY 启用L1 CosyVoice2
3. 如有GPU环境，部署L2 Fish-Speech或L3 GPT-SoVITS本地引擎
4. 检查网络连接，确认CosyVoice2云端API可达
## 能力限制说明
### 内容创作类限制
- **平台覆盖**: 选题捕手和标题工厂仅支持国内4平台（小红书/抖音/微博/知乎），不支持B站/快手/头条号/海外平台
- **语言限制**: 仅支持中文内容创作，不支持英文/其他语种标题生成和内容预测
- **内容长度**: 爆款预言机要求内容50-10000字，过短无法有效预测，过长自动截断
- **竞争度精度**: 竞争度基于平台搜索结果数估算，可能不完全反映实际竞争程度
- **评分主观性**: 选题5维评分和标题4维打分基于LLM判断，不同模型评分可能差异较大
### 短剧制作类限制
- **单次管道超时**: 25步管道执行超时上限60分钟，复杂章节可能超时
- **同一book_id不可并行生成**: 生成锁机制限制同一book_id同时只能有一个生成任务
- **真人剧成本较高**: real_person风格使用InstantID，成本约45元/分钟；动漫FLUX仅约14元/分钟
- **竖屏固定输出**: 本Plug输出为竖屏短剧(9:16)，不支持横屏电影级长片制作
- **本地GPU TTS需GPU环境**: L2 Fish-Speech和L3 GPT-SoVITS需本地GPU，无GPU只能用L1(需Key)或L4(免费)
### 不适用场景
- 海外平台内容创作（Twitter/Reddit/YouTube/Instagram/TikTok国际版）
- B2B行业选题（侧重消费品/生活方式类）
- 学术论文标题和新闻采编选题（需专业判断非爆款导向）
- 实时直播短剧演出（本Plug为离线AI生成）
- 横屏院线级长片制作
- 纯文字小说续写创作（本Plug短剧功能为视频生成非文字创作）
- 实时性要求<100ms的场景
- 需要完全离线运行的场景
## 热门问题
### Q1: Plug中的技能可以单独使用吗？
A: 可以，Plug中的每个技能都是独立的，可以单独调用。组合使用时效果更佳，选题→标题→预测形成数据驱动的创作决策链。
### Q2: 选题捕手的热搜API不可用会影响什么？
A: 热搜API不可用时降级为LLM基于知识库生成选题，选题的时效性会降低（可能不是最新热点），但选题分析和评分功能不受影响。建议配置国内热搜API提升时效性。
### Q3: 短剧爆款生产线的成本如何控制？
A: 动漫风格FLUX标准画质(scene_6)成本最低约14元/分钟，真人剧(scene_8)约45元/分钟。TTS使用L4 Edge-TTS免费方案可省去TTS API费用。建议预算有限时选择anime+FLUX+Edge-TTS组合。
### Q4: 爆款预言机的预测准确率如何？
A: 预测基于历史爆款规律和LLM分析，评分>80的内容爆款概率较高。准确率受平台算法变化、发布时机、账号权重等多因素影响，预测结果仅供参考，不保证100%准确。
### Q5: 支持自定义工作流程吗？
A: 支持。可在Agent对话中指定执行特定技能或自定义技能执行顺序。例如只执行选题→标题两步，跳过预测和短剧制作。
## 安全
### API Key零暴露原则
- 所有API Key（LLM_API_KEY/HOT_SEARCH_API_KEY/TTS_API_KEY/IMAGE_API_KEY/VIDEO_API_KEY）必须通过Agent环境变量注入
- 严禁在SKILL.md、配置文件或代码中硬编码API Key
- 本SKILL.md中不包含任何真实或示例API Key，所有引用均使用 `$env:LLM_API_KEY` 占位
- exec工具记录日志时，自动过滤包含"key"/"token"/"secret"字段的值
### 内容安全
- 选题捕手聚合的热点话题自动过滤敏感/违规内容，不推荐涉政/涉黄/涉暴等违规选题
- 标题钩子工厂自动过滤标题党/虚假宣传/绝对化用语（最/领先/唯一）等违规表述
- 爆款预言机预测结果用于内容优化参考，不用于恶意操控平台算法或刷量
- 短剧生产线包含内容审核步骤（第20步敏感词检测），确保输出内容合规
- 选题标题为热点话题摘要，用户创作的内容需自行确认不侵犯他人版权
### 国内适配性
- LLM API支持国内模型：通义千问/文心一言/智谱GLM/DeepSeek/Kimi
- 热搜API支持国内平台：微博热搜/百度热搜/头条热榜/新榜API
- TTS引擎支持国内服务：CosyVoice2(阿里)/Edge-TTS(微软免费)
- 图像/视频生成支持国内服务：可灵AI(快手)/即梦AI(字节)/腾讯智影
- OAuth Provider支持国内方案：微信/支付宝/飞书/钉钉（替代Google/GitHub）
## 创新亮点
### 效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|:---------|:---------|:---------|:---------|:---------|
| 选题搜集 | 1小时/次 | 5分钟/次 | 55分钟/次 | 15% |
| 标题生成 | 30分钟/次 | 2分钟/次 | 28分钟/次 | 20% |
| 爆款预测 | 2小时/次 | 10分钟/次 | 150分钟/次 | 25% |
| 短剧制作 | 8小时/次 | 1小时/次 | 7小时/次 | 30% |
| 内容发布 | 1小时/次 | 15分钟/次 | 45分钟/次 | 10% |
### 差异化对比
| 对比维度 | 本Plug | 手动操作 | Python脚本 | 专业软件 |
|:---------|:---------|:---------|:---------|:---------|
| 一站式解决方案 | 是 | 否 | 否 | 否 |
| 平台适应性 | 多平台 | 单平台 | 单平台 | 单平台 |
| 速度 | 高效 | 低效 | 较高效 | 较高效 |
| 灵活性 | 高 | 低 | 中 | 中 |
| 成本 | 低 | 高 | 中 | 高 |
### 核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|:-----|:-----|:-----|:-----|:-----|
| 内容选题困难 | 缺乏有效选题，创作方向不明确 | 影响内容质量和用户满意度 | 选题捕手提供热点聚合和差异化建议 | 选题成功率提升20% |
| 标题吸引力不足 | 标题无法吸引读者点击 | 影响点击率和阅读量 | 标题钩子工厂生成多平台适配的标题 | 标题点击率提升15% |
| 内容爆款潜力低 | 内容无法成为爆款，难以获得高流量 | 影响内容传播和品牌影响力 | 爆款预言机提供潜力评分和优化建议 | 爆款内容比例提升25% |
## 代码示例
### 基础用法
```bash
skill install plug-ai-content-creation-workstation
skill execute plug-ai-content-creation-workstation --input "示例输入"
```
### 高级用法
```python
import requests
api_url = "http://localhost:8080/api/skills/plug-ai-content-creation-workstation"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.post(api_url, json={
    "input": "示例输入数据",
    "options": {"mode": "advanced"}
})
result = response.json()
print(result)
```
### 命令行批处理
```bash
for file in *.csv; do
  skill execute plug-ai-content-creation-workstation --input "$file" --output "result_$file"
done
```
# AI内容创作工作站
> 选题到爆款全链路，4个AI技能组成的内容创作流水线：选题捕手聚合热点、标题钩子工厂生成标题、爆款预言机预测潜力、短剧爆款生产线自动出片
## 能力矩阵
本Plug将内容创作拆解为4个可独立调用又可串联执行的阶段，每个阶段由一个专业技能负责，形成从灵感发现到成片发布的完整工作流。
### 包含技能
| 技能 | slug | 领域 | 核心能力 | 质量分 |
|:-----|:-----|:-----|:-----|:-----|
| 选题捕手 | `topic-hunter` | Automation | 4大平台热点聚合 + 5维趋势评分 + 差异化选题建议 | 4.7/5.0 |
| 标题钩子工厂 | `title-hook-factory` | Automation | 6大钩子公式 + 3-5个标题候选 + 4维量化打分 + 多平台字数控制 | 4.9/5.0 |
| 爆款预言机 | `viral-prophet` | Automation | 6维潜力评分 + 5大爆款要素分析 + 竞品对比 + 优化建议 | 4.9/5.0 |
| 短剧爆款生产线 | `drama-hit-producer` | Automation | 25步全自动管道 + 双轨风格 + 四层TTS + 质量闭环 | 4.8/5.0 |
### 技能间协同关系
```
topic-hunter (选题) ──输出选题──> title-hook-factory (标题)
                                        │
                                        ├──输出标题+内容──> viral-prophet (预测)
                                        │                        │
                                        │                   预测通过
                                        │                        │
                    drama-hit-producer (短剧制作) <──小说章节────┘
```
- **topic-hunter** 为创作起点，输出高潜选题和差异化切入角度
- **title-hook-factory** 接收选题，生成多平台适配的爆款标题和钩子段落
- **viral-prophet** 对标题+内容进行发布前预测，评分通过后进入发布或制作环节
- **drama-hit-producer** 接收小说章节，25步管道自动生成竖屏短剧并多平台发布
## 使用时机
| 触发场景 | 触发关键词/意图 | 调用技能 |
|:---------|:----------------|:---------|
| 不知道写什么内容 | "选题"、"热点"、"写什么"、"话题推荐" | topic-hunter |
| 需要生成吸引人的标题 | "标题"、"钩子"、"爆款标题"、"取标题" | title-hook-factory |
| 发布前评估内容潜力 | "爆款预测"、"内容评分"、"能不能火"、"潜力" | viral-prophet |
| 小说转短剧 | "短剧"、"小说转视频"、"竖屏短剧"、"FLUX"、"InstantID" | drama-hit-producer |
| 全链路创作 | "内容创作"、"从选题到发布"、"创作流程" | 4技能串联执行 |
## 应用场景
### 场景1 自媒体日更选题与标题生成
自媒体创作者每日需要产出3-5条内容，面临"不知道写什么"和"标题不够吸引人"两大痛点。
- **Step 1**: 调用 topic-hunter，传入 platforms=["xiaohongshu","douyin"] + category="科技"，获取10个高潜选题 + 5维评分 + 蓝海机会点
- **Step 2**: 选择评分最高的选题，调用 title-hook-factory，传入 topic + platform="xiaohongshu"，获取5个标题候选 + 4维打分 + 钩子段落
- **Step 3**: 撰写正文后调用 viral-prophet，传入 content + platform，获取6维潜力评分和优化建议，评分>80直接发布
### 场景2 MCN机构批量短剧生产
MCN机构需要将签约小说IP快速转化为竖屏短剧，在抖音/快手/B站多平台分发。
- **Step 1**: 调用 drama-hit-producer，传入 book_id + chapter_number + style_track="anime" + platforms=["douyin","kuaishou","bilibili"]
- **Step 2**: 25步管道自动执行：章节获取→事件图谱→角色工坊→TTS匹配→剧本转换→导演规划→分镜生成→配音→画面生成→视频合成→字幕→质量监督→多平台发布
- **Step 3**: 质量评分为C/D级时自动重做（最大2次），重做后仍不达标触发人工裁决
### 场景3 内容运营团队选题决策
内容运营团队需要数据支撑选题决策，避免拍脑袋。
- **Step 1**: 调用 topic-hunter，传入 platforms=["weibo","zhihu"] + keyword="AI编程" + time_range="30d"，获取趋势上升的选题 + 增长率 + 入场时机建议
- **Step 2**: 对已有内容草稿调用 viral-prophet 进行竞品对比，传入 content + competitor_contents，获取优势/差距分析和差异化建议
## 操作流程
### 快速开始
1. 确认Agent已加载本Plug的SKILL.md及4个成员技能的SKILL.md
2. 在Agent环境变量中配置 `LLM_API_KEY`（必需）和 `HOT_SEARCH_API_KEY`（可选）
3. 确认Agent支持 exec 工具（命令行执行能力）
4. 在Agent对话中描述需求，Plug将根据触发条件自动选择对应技能
### 全链路工作流
#
### Step 1: 选题阶段（topic-hunter）
- **输入**: platforms（目标平台数组）+ category（内容分类）+ user_interests（可选）
- **处理**: 聚合小红书/抖音/微博/知乎4大平台热点，5维趋势评分（热度30%+增长趋势25%+竞争度20%+变现潜力15%+可持续性10%）
- **输出**: 按评分排序的选题列表，每个选题含差异化切入角度建议和蓝海标记
- **降级**: 热搜API不可用时降级为LLM基于知识库生成选题
#
### Step 2: 标题阶段（title-hook-factory）
- **输入**: topic（选题）+ platform（目标平台）+ hook_type（钩子公式，默认auto）
- **处理**: 基于6大钩子公式（痛点共鸣/好奇悬念/数字权威/对比反差/情感共鸣/紧迫感稀缺）生成3-5个标题候选，4维打分（钩子匹配度30%+情感强度25%+关键词覆盖25%+吸引力20%）
- **输出**: 标题候选列表 + best_title + 钩子段落（50-200字开篇）
- **字数控制**: 小红书20字内/抖音15字内/公众号30字内/微博30字内
#
### Step 3: 预测阶段（viral-prophet）
- **输入**: content（内容全文）+ platform + competitor_contents（可选）
- **处理**: 6维潜力评分（钩子吸引力20%+情绪强度20%+价值密度20%+结构清晰度15%+节奏控制15%+CTA转化10%）+ 5大爆款要素分析 + 竞品对比
- **输出**: 爆款概率分级 + 优化建议（按优先级排序）+ 发布时机建议
- **分级**: 高(>80)/中高(70-79)/中(60-69)/低(<60)
#
### Step 4: 短剧制作阶段（drama-hit-producer，可选）
- **输入**: book_id + chapter_number + style_track（real_person/anime）+ platforms
- **处理**: 25步管道全自动执行，双轨风格切换（真人剧InstantID/动漫FLUX/Kling），四层TTS降级链（CosyVoice2→Fish-Speech→GPT-SoVITS→Edge-TTS）
- **输出**: 竖屏短剧视频URL + 质量评级 + 多平台发布结果
- **质量闭环**: A/B/C/D四级评分 + R1-R4红线检查，C/D级自动重做
### 单技能调用
每个技能均可独立调用，无需执行全链路。调用时在Agent对话中直接描述对应需求即可触发。
## 输入参数
```json
{
  "plug": "plug-ai-content-creation-workstation",
  "action": "execute_workflow | execute_single",
  "input": {
    "workflow": "full | topic_only | title_only | predict_only | drama_only",
    "topic_input": {
      "platforms": ["xiaohongshu", "douyin", "weibo", "zhihu"],
      "category": "科技",
      "user_interests": ["AI", "编程"],
      "time_range": "7d"
    },
    "title_input": {
      "topic": "AI编程工具推荐",
      "platform": "xiaohongshu",
      "hook_type": "auto",
      "count": 5
    },
    "predict_input": {
      "content": "待预测内容全文",
      "platform": "xiaohongshu",
      "competitor_contents": ["竞品内容1"]
    },
    "drama_input": {
      "book_id": "book_001",
      "chapter_number": 1,
      "style_track": "anime",
      "platforms": ["douyin"]
    }
  },
  "options": {
    "format": "json",
    "verbose": true
  }
```
### 风险防范措施
| 风险类型 | 风险描述 | 防范措施 | 应急方案 |
| --- | --- | --- | --- |
| 数据泄露 | 用户数据可能泄露 | 数据加密，限制访问权限 | 立即隔离泄露数据，通知用户 |
| 系统故障 | 系统可能发生故障，导致服务中断 | 定期维护，备份系统 | 立即修复故障，恢复服务 |
| API滥用 | API可能被恶意滥用 | 限制API调用频率，监控异常行为 | 立即封禁恶意用户，调整API策略 |
| 网络攻击 | 系统可能遭受网络攻击 | 防火墙，入侵检测系统 | 立即响应攻击，加强安全防护 |
| 版权问题 | 生成的内容可能侵犯版权 | 检查内容版权，避免侵权行为 | 立即删除侵权内容，追究责任 |
### 安全优选实践
1. 定期更新系统，修复漏洞。
2. 对敏感数据进行加密存储和传输。
3. 限制用户访问权限，防止未授权访问。
4. 监控系统日志，及时发现异常行为。
5. 建立应急预案，应对突发事件。
## 边界条件与错误处理
### 错误场景与处理方式
| 错误场景 | 原因分析 | 处理方式 | 预防措施 |
| --- | --- | --- | --- |
| 热搜API不可用 | 网络问题或API服务故障 | 使用备用API或降级方案 | 定期检查API服务状态，配置备用API |
| 图像生成API失败 | API配额耗尽或服务故障 | 切换API或等待配额恢复 | 监控API使用情况，合理分配配额 |
| TTS引擎降级 | CosyVoice2 API Key未配置或网络不通 | 使用Edge-TTS或本地引擎 | 配置TTS API Key，检查网络连接 |
| 短剧制作超时 | 管道执行复杂，耗时过长 | 增加系统资源，优化代码 | 优化代码，减少管道执行时间 |
| 端口冲突 | 系统端口配置错误 | 修改端口配置，确保端口可用 | 检查端口配置，避免冲突 |
### 使用限制
1. 选题捕手仅支持国内4平台，不支持B站/快手/头条号/海外平台。
2. 爆款预言机要求内容长度50-10000字。
3. 短剧制作不支持横屏电影级长片制作。
4. 纯文字小说续写创作不在该技能领域内。
5. 实时性要求<100ms的场景不适用。
## 参数说明与代码示例
### 输入参数说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| --- | --- | --- | --- | --- |
| topic | string | 是 |  | 需要创作的主题或选题 |
| platform | string | 是 | 小红书 | 目标平台，支持小红书、抖音、微博、知乎等 |
| word_limit | int | 否 | 20 | 标题字数限制，用于标题生成 |
| content_length | int | 否 | 10000 | 内容长度限制，用于内容预测 |
| style_track | string | 否 | real_person | 角色画面风格，支持real_person和anime |
| scene_id | string | 否 | scene_7 | 场景ID，用于角色画面生成 |
| tts_engine_used | string | 否 | edge_tts | TTS引擎选择，支持edge_tts、L1、L2、L3等 |
| tts_fallback_chain | string | 否 | L1-L3 | TTS降级链，用于TTS引擎失败时 |
### 代码示例
## 前置条件
### 运行环境
- 操作系统：Windows 10/11, macOS, Linux
- Python版本：3.6及以上
- Node.js版本：12及以上
### 依赖项表格
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:-------|:---------|
| requests | Python库 | 是 | pip install requests |
| flask | Python库 | 是 | pip install flask |
| Pillow | Python库 | 是 | pip install Pillow |
| gunicorn | Python库 | 是 | pip install gunicorn |
| ujson | Python库 | 是 | pip install ujson |
| redis/sqlalchemy/mysql/tensorflow/keras | Python库 | 否 | 按需安装 |
## 常见问题解答 (FAQ)
### Q1: 如何配置API Key？
A: 在Agent环境变量中配置相应的API Key，例如 `LLM_API_KEY`、`HOT_SEARCH_API_KEY`、`TTS_API_KEY`、`IMAGE_API_KEY` 和 `VIDEO_API_KEY`。
### Q2: 如何使用短剧制作功能？
A: 调用 `drama-hit-producer` 技能，传入 `book_id`、`chapter_number`、`style_track`（选择 `real_person` 或 `anime`）和 `platforms`（目标平台数组）。
### Q3: 如何自定义工作流程？
A: 在Agent对话中指定执行特定技能或自定义技能执行顺序。例如，只执行选题和标题生成，可以使用 `execute_workflow` 并指定 `workflow` 参数为 `topic_only | title_only`。
### Q4: 如何处理API配额限制？
A: 如果API配额耗尽，可以尝试切换到备用API或等待配额恢复。在配置文件中设置备用API的参数，并在API调用失败时自动切换。
### Q5: 如何处理内容违规问题？
A: 短剧生产线包含内容审核步骤，自动过滤敏感词和违规内容。如果生成的内容被标记为违规，可以手动检查并修改内容，或者联系客服寻求帮助。
## 首次设置
1. **配置API密钥**: 在环境变量中设置对应的API Key
2. **初始化连接**: 使用提供的凭证建立API连接
3. **调用接口**: 传入必要参数执行API调用
1. **准备文件**: 确认文件路径正确且格式受支持
2. **执行处理**: 调用对应的处理函数
3. **查看结果**: 检查输出文件或返回数据
1. **检查环境**: 确认运行时和依赖已安装
2. **执行命令**: 使用正确的参数格式执行
3. **查看输出**: 检查命令输出和退出码
### 前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪
## 异常恢复流程
针对AI内容创作工作站使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---------|---------|---------|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
### AI内容创作工作站通用排查步骤
1. **检查输入参数**: 确认所有必填参数已提供且格式正确
2. **查看日志输出**: 定位具体错误行和异常类型
3. **验证环境配置**: 确认依赖库版本和运行环境满足要求
4. **逐步调试**: 缩小问题范围,隔离故障模块
## 使用指引
1. **配置API密钥**: 在环境变量中设置对应的API Key
2. **初始化连接**: 使用提供的凭证建立API连接
3. **调用接口**: 传入必要参数执行API调用
1. **准备文件**: 确认文件路径正确且格式受支持
2. **执行处理**: 调用对应的处理函数
3. **查看结果**: 检查输出文件或返回数据
1. **检查环境**: 确认运行时和依赖已安装
2. **执行命令**: 使用正确的参数格式执行
3. **查看输出**: 检查命令输出和退出码

## 功能介绍
- **自动化执行**: 选题到爆款全链路,4技能协同覆盖选题/标题/预测/短剧制作
- **文件处理**: 支持多种文件格式的读取、解析和写入操作
- **API集成**: 通过标准化接口调用外部服务并处理响应
- **命令执行**: 在安全沙箱中执行系统命令并收集结果
- **信息检索**: 快速搜索和过滤目标数据

## 异常响应
针对AI内容创作工作站使用中可能遇到的常见问题,提供以下排查方案:

| 错误类型 | 原因分析 | 解决方案 |
|---------|---------|---------|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |

## 异常恢复指南
针对AI内容创作工作站使用中可能遇到的常见问题,提供以下排查方案:

| 错误类型 | 原因分析 | 解决方案 |
|---------|---------|---------|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |

## 使用向导
1. **配置API密钥**: 在环境变量中设置对应的API Key
2. **初始化连接**: 使用提供的凭证建立API连接
3. **调用接口**: 传入必要参数执行API调用
1. **准备文件**: 确认文件路径正确且格式受支持
2. **执行处理**: 调用对应的处理函数
3. **查看结果**: 检查输出文件或返回数据
1. **检查环境**: 确认运行时和依赖已安装
2. **执行命令**: 使用正确的参数格式执行
3. **查看输出**: 检查命令输出和退出码

## 异常恢复指南
针对AI内容创作工作站使用中可能遇到的常见问题,提供以下排查方案:

| 错误类型 | 原因分析 | 解决方案 |
|---------|---------|---------|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |

### AI内容创作工作站通用排查步骤

1. **检查输入参数**: 确认所有必填参数已提供且格式正确
2. **查看日志输出**: 定位具体错误行和异常类型
3. **验证环境配置**: 确认依赖库版本和运行环境满足要求
4. **逐步调试**: 缩小问题范围,隔离故障模块

## 使用向导
1. **配置API密钥**: 在环境变量中设置对应的API Key
2. **初始化连接**: 使用提供的凭证建立API连接
3. **调用接口**: 传入必要参数执行API调用
1. **准备文件**: 确认文件路径正确且格式受支持
2. **执行处理**: 调用对应的处理函数
3. **查看结果**: 检查输出文件或返回数据
1. **检查环境**: 确认运行时和依赖已安装
2. **执行命令**: 使用正确的参数格式执行
3. **查看输出**: 检查命令输出和退出码

### 前置条件

- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪