Dots AI 纳入每日模型清单同步

老板要求:「把 https://dots.ai/platform/docs 加入每日定时任务的同步任务来」。

这条源和另两家不同:dots 文档页是 **SPA**,正文(模型定价表、上下文窗口、「免费体验」说明)
**不在 HTML 里**,而是随前端 JS chunk 发布(实测在 assets/ApiDocsPage-*.js,chunk 名带 hash、
发版就变)→ 抓取走两步发现:文档页 → 主包 index-*.js → ApiDocsPage-*.js → 取该 chunk。

同步三项:
- 模型清单:取自定价表行 {model:"…",input:"$…",output:"$…"}(按出现次数全收,加模型不用改代码);
- 免费状态:取「免费体验」横幅 —— **它是"当前免费试用"**(原文:恢复收费前会提前告知),
  横幅在=free:true、横幅没了=按报价收费 → 落盘改 false(试用结束会在每日报告里现形);
- 上下文窗口:正文「…上限为 524,288 Token」。
- **不写定价**:文档报价是 USD/M,网关 pricing 是 ¥/M → 换算要汇率、不能猜,只列在报告里给人看。

健壮性:这条链路最脆(SPA + hash chunk),故**失败不致命** —— main() 单独兜住,失败置空、
跳过 Dots 比对并在报告里写「⚠ 文档抓取失败」,另两家照常;解析不出模型则抛错交给这层兜。

顺带修:_set_free() 幂等 —— 同一条同步说明不重复追加(原先重复应用同一 plan 会把注释滚成
「原注释;说明;说明」;不同日期的说明仍各记一条=变更历史)。

验证:
- 干跑(真实配置):三家「无漂移 ✓」,Dots 段带报价行,plan_is_empty → 「无需落盘」;
  实测 --apply 也是「无需落盘:网关已与文档一致 ✓」;
- 造副本模拟漂移(free=false/context=131072):两处漂移都报出 + 两条落盘动作 → --apply 写盘成功、
  回读校验过、复跑无漂移(幂等);
- 新增测试「Dots 抓取口径 + 漂移识别 + 落盘幂等」→ 208 → 209 全过。

cron 任务 d83693fc-… 同步更新:名称改为「模型清单每日同步(OpenCode Go + Agnes + Dots → ai 网关)」,
提示词加第三家来源 + 「Dots 抓取失败不致命、照实带出来」,并要求带出 Dots 报价行、
「受保护不删」段与视频默认模型标记。
This commit is contained in:
api-gateway committed 2026-09-29 10:00:30 +08:00
1 parent ef6beead10
commit 05d6d078cc
3 files changed
+280 -11

No files matched your search

+38
View File
@@ -1,5 +1,43 @@
# CHANGELOG
## 2026-09-29 · Dots AI 纳入每日模型清单同步
老板要求:「把 https://dots.ai/platform/docs 加入每日定时任务的同步任务来」。
**这条源和另两家不一样**:dots 的文档页是 **SPA** —— 正文(模型定价表、上下文窗口、
「免费体验」说明)**不在 HTML 里**,而是随前端 JS chunk 发布的(实测正文在
`assets/ApiDocsPage-*.js`,chunk 名带内容 hash、每次发版都变)。所以抓取走**两步发现**:
`GET /platform/docs` → 找主包 `assets/index-*.js` → 在主包里找 `ApiDocsPage-*.js` → 取该 chunk。
**同步三项**:
- **模型清单**:取自定价表行 `{model:"dots3-note-prev",input:"$0.14",output:"$0.28"}`
(按出现次数全收,以后加模型不用改代码);
- **免费状态**:取文档「免费体验」横幅 —— 注意**它是"当前免费试用"**(原文:当前免费体验,
暂不收费,恢复收费前会提前告知)。横幅在 = `free: true`;横幅没了 = 按报价收费 → 落盘改成 false,
**试用结束会在每日报告里现形**;
- **上下文窗口**:正文「…的上下文窗口上限为 524,288 Token(512K)」。
- **不写定价**:文档报价是 **USD/M**,而网关 `pricing.per_model` 是 **¥/M**(Agnes 那套口径)——
换算要汇率、不能猜,所以只把报价列在报告里("仅展示、不写入 pricing")。
**健壮性选择**:这条链路最脆(SPA + hash 命名的 chunk),因此**抓取失败不致命** ——
`main()` 里单独兜住,失败时置空、跳过 Dots 比对,并在报告里明写「⚠ 文档抓取失败」,
另两家(OpenCode / Agnes)照常同步;解析不出任何模型则抛错交给这层兜。
**顺带修**:`_set_free()` 改成幂等 —— 同一条同步说明不重复追加(原先重复应用同一份 plan 会把
注释滚成「原注释;说明;说明」;不同日期的说明仍各记一条 = 变更历史)。
**验证**:
- 干跑(真实配置):三家都「无漂移 ✓」,Dots 段带出报价行;`plan_is_empty` → 「无需落盘」;
- 造副本模拟漂移(free=false、context=131072):两处漂移都报出来 + 落盘计划两条 →
`--apply` 写盘成功、回读校验过、复跑「无漂移」(幂等);
- 测试新增「Dots 抓取口径 + 漂移识别 + 落盘幂等」一条 → **209 全过**。
**cron 任务同步更新**:`d83693fc-…`(每天 08:00 Asia/Shanghai)名称改为
「模型清单每日同步(OpenCode Go + Agnes + Dots → ai 网关)」,提示词加第三家来源 +
说明「Dots 抓取失败不致命、照实带出来」,并要求把 Dots 段的报价行、「受保护不删」段、
视频默认模型标记一并带出。
## 2026-09-28 · 接入 Dots AI(小红书)+ 新增 `api-key` 鉴权样式
老板要求:「查看 https://dots.ai/platform/docs 文档,帮我在 ai 网关上配置 dots.ai 的供应商」