knowhow.md
1.14 KB
内容发布技能知识库
核心能力
1. 数据解析
- 读取 JSON 格式的剧本数据
- 提取 title, genre, scenes, metadata
- 字段验证和错误检查
2. 字段映射
- Genre → Category 映射表 (20类)
- scenes 序列化为 JSON 字符串
- metadata.tags 和 metadata.author 提取
3. API 调用
- HTTP POST 请求
- JSON Payload 构建
- Authorization Header
4. 错误处理策略
| 状态码 | 处理方式 |
|---|---|
| 400 | 记录错误,返回失败 |
| 401 | 刷新 Token,重试 |
| 413 | 压缩 content,重试 |
| 429 | 指数退避 (1s→2s→4s) |
| 500 | 指数退避,最大3次 |
5. 重试机制
- 最大重试: 3次
- 退避策略: 指数退避
- 超时: 连接10s,读取30s
- 熔断: 连续3次失败标记失败
最佳实践
数据验证
- 必填字段: title, genre, scenes
- genre 必须在映射表中
- scenes 长度 ≤ 100KB
API 请求
- Content-Type: application/json
- status 固定为 "ready"
- 保持 JSON 紧凑(无多余空格)
日志记录
- 请求前: 记录目标 URL
- 请求后: 记录状态码和响应
- 错误时: 记录错误码和重试次数