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 预期

一个简单排查顺序

  1. 先确认当前调用是 AI service、custom service,还是 service
  2. 再确认当前阶段是 guest 调用还是用户态调用
  3. 再看 town_iduser_token、service id、action id、model id 是否一致