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
  • 请求后: 记录状态码和响应
  • 错误时: 记录错误码和重试次数