Packages 包@downcity/cityCity
组合方式与常见错误
City 在真实产品里的常见组合,以及 token、model、service 相关错误的排查思路。
最常见的三种组合
纯 AI 产品
@downcity/city@downcity/city导出的 City 能力
AI 产品 + 最小账号体系
@downcity/city@downcity/city导出的 City 能力@downcity/services
AI 产品 + usage / 支付
@downcity/city@downcity/city导出的 City 能力@downcity/services
401 / 403 最常见原因
user_token没传- token 已过期
- token 对应的
town_id不匹配 - town 已暂停
404 最常见原因
- 目标 service 没挂进 City
- Action 路径写错
- 以为 service 已启用,但实际上没
base.use(service())
422 最常见原因
- 调 AI service 时传了不存在的 model
- 当前 model 没有对应 modality 的 action
- custom service 的输入结构不符合 action 预期
一个简单排查顺序
- 先确认当前调用是 AI service、custom service,还是 service
- 再确认当前阶段是 guest 调用还是用户态调用
- 再看
town_id、user_token、service id、action id、model id 是否一致