[coulsontl]

新增 ModelScope（魔搭）渠道，含每日签到与魔粒余额读数；另修一处会让统计静默归零的流式 usage 缺陷。

渠道本体

两个站点各一家 provider：modelscope（国内版，modelscope.cn）与 modelscope-intl（国际版，www.modelscope.ai）。无状态 OpenAI 兼容转发，骨架与 Loomy / AutoClaw / OfficeAce 同构。

• 一枚 ms- 令牌两用：Authorization: Bearer 调推理、Cookie: m_session_id=<令牌> 读网页站（身份 / 魔粒 / 签到）。所以只有一个凭证字段。
• 令牌不透明（不是 JWT，解不出身份）⇒ 添加账号时出网探活换取上游稳定身份（HavanaId）做账号 id，否则同一账号换一次令牌就会变成两条记录。
• 两个站点是两套账号体系（国内令牌打国际站网页接口得 401 access forbidden）⇒ 地区做成 provider 身份而不是账号上的字段。拆家还顺带解决一个具体故障：模型目录只有一份时，两站各自 36 条、内容不同的清单会互相覆盖。
• 模型目录 GET {推理域}/models（实测 36 条，是账号可用集而非全站模型；只有 id 字段，没有能力位，因此不编静态兜底表、也不按 id 猜思考位）。

每日签到

上游没有独立签到接口：调一次 GET {网页站}/api/v1/users/login/info 本身就触发当日魔粒签到（幂等，重复调不会重复发）。依据是 CPA 的 modelscope-ratelimit 插件源码（cmd/plugin/main.go 的午夜签到段），本实现照同一条链路、把触发时机交给本项目的自动签到框架（CHECKIN_PROVIDERS 第 14、15 家，PROVIDERS_VERSION 相应 +1）。

余额读数

query_usage 采集魔粒钱包（可用 / 冻结 / 总计）与今日已用调用数（currentUsagePerDay）。后者是附加读数，取不到时只降级、不把整条查询变失败（主问题是「我还有多少魔粒」）。

错误分类

上游把「账号条件不满足」与「速率窗口撞上」都用 429/403 表达，只能靠文案区分，而两者处置完全不同：

• 魔粒耗尽（429 insufficient balance）与未验证邮箱（403 + 特征串）→ 冷却到下一个北京零点（充值 / 完成验证后次日自动回来），不是分钟级重试；
• 其余 429 → 分钟级速率窗口；
• 裸 401/403 → 令牌失效（本家无续期，如实报「请重新粘贴」）。

判据来自 CPA 插件 internal/ratelimit/apply.go（线上实测得来），逐条 curl 复核过。

⚠️ 一处会静默毁账的流式缺陷（本 PR 一并修复）

魔搭的流式响应是非标准形态：每一个 chunk 都带一个 usage 对象，值全是 0；真值只在末尾那个 choices: [] 的 usage-only 块里 —— 而那一块只在请求显式带上 stream_options.include_usage: true 时才发。实测对照（同一模型同一提问）：

不带 include_usage：最后一帧是 {"choices":[{"finish_reason":"stop"}], "usage":{0,0,0}}
带   include_usage：{"choices":[], "usage":{"prompt_tokens":62,"completion_tokens":32,"total_tokens":94}}

本网关恒以流式请求上游，客户端要非流式时再由聚合器把流折成完整响应 ⇒ 不注入这个开关时，非流式请求的 usage 恒为 0：请求日志、报表与前端 token 显示一起归零，而内容完全正常（这个故障只在统计上可见，排查时极难联想到「上游少发了一帧」）。处置与 CodeArts 的既有做法一致：build_chat_request 里总是请求 usage（保留客户端已设的其余 stream_options 键）。

优化：限额文案带上恢复时刻

全部候选账号都被限流时，错误文案从

…（所有候选账号对模型 X 均已限额或禁用）

改为

…（所有候选账号对模型 X 均已限额或禁用，最早 2026/10/17 00:00:00 恢复）

客户端（会读这条文案的）才能做合法的退避等待，而不是立刻重试再撞一次同样的墙。取最早而不是最晚（账号是逐个恢复的，取最晚会让它多睡一段本不必睡的时间）；只改文案、不动选路逻辑，取不到时逐字退回原句。

验证

• cargo test 616 passed / 0 failed（新增 27 个测试守着分类顺序、include_usage 注入、区域互查、身份解析、恢复时刻取值等）
• 前端 tsc --noEmit && vite build 通过；i18n scan.mjs --check 通过（五语言词典齐全）
• 端到端实测（隔离实例 + 真实账号）：添加账号（探活换身份 + 顺带签到）✓ / 魔粒余额读数 ✓ / 签到回上游昵称 ✓ / 模型目录 36 条 ✓ / 跨站令牌正确拒绝并点明站点 ✓ / 仓库导入导出身份合并 ✓
• 魔粒耗尽与速率窗口的分类、以及「最早恢复时刻」文案，都用真实上游 429 报文验证过

附注

顺带给 OrcaTerm 的 6 条中文文案补上英文译文 —— 上游新增这些文案时没跑 i18n 扫描，scan.mjs 时被扫出空值（en 空值数 5→11，填完回 5）。

---

🤖 本条回复由 AI Agent 生成
Generated by an AI agent.