diff --git a/docs/NEXT_IMPORTER_RUNTIME_PRIORITY.md b/docs/NEXT_IMPORTER_RUNTIME_PRIORITY.md index e8f3791..38a29fb 100644 --- a/docs/NEXT_IMPORTER_RUNTIME_PRIORITY.md +++ b/docs/NEXT_IMPORTER_RUNTIME_PRIORITY.md @@ -70,6 +70,8 @@ | P2-2 | 联通云 AICP / AI 应用开发平台 | 已新增 `cucloud_pricing`,但当前只覆盖 AISP Token Plan 3 模型 blended price 与区域矩阵 | 目录入口与部分结构化价格已打通,但 payg per-model 公开价表仍缺 | 后续若官方公开 payg 模型销售价,再扩 `import_cucloud_pricing.go`(当前边界详见 `docs/references/cucloud-token-plan-vs-aisp.md`) | | P2-3 | 豆包与 Seed 开放平台 | 已有多源/订阅链路,但仍缺细颗粒度价格标注 | 当前矩阵里仍保留缺口 | 区分“已有多源模型采集”与“官方价格页结构化价格”能力 | | P2-4 | 天翼云息壤 / CloudBase AI+ / TI 平台大模型广场 | manual_review | 平台入口存在,但尚无真实 importer | 先回查官方页面结构,再决定 catalog importer 还是 pricing importer | +| P2-5 | OpenCode Zen(候选) | 官网初核已完成;OpenCode 本体是开源代理,真正对应价格面的平台是 OpenCode Zen | 对“精选多模型网关 / AI gateway”类型平台有代表性,可补充 payg 聚合平台样本 | 后续以 `opencode.ai/zen` 与 docs/zen 为准,判断是否只适合 `catalog verification`,或可进一步做真实 pricing importer | +| P2-6 | OpenCode Go(候选) | 官网初核已完成;这是独立于 Zen 的订阅服务,文档公开首月 5 美元、后续每月 10 美元,并给出额度限制 | 对 `subscription_plan` 维度有代表性,可补一类“多模型访问订阅”样本;按当前证据已足够进入 subscription 候选基线 | 后续以 `opencode.ai/docs/go` 为准,优先决定是先手工 seed,还是直接做真实 importer / manual-seed importer 闭环 | ### P3:全球参考集从目录核验升级为真实价格 importer diff --git a/docs/PLAN_CATALOG_INVENTORY.md b/docs/PLAN_CATALOG_INVENTORY.md index c17644f..2d7825e 100644 --- a/docs/PLAN_CATALOG_INVENTORY.md +++ b/docs/PLAN_CATALOG_INVENTORY.md @@ -84,6 +84,75 @@ 对应 seed:`seeds/plan_catalog_inventory_seed_cn_relays_top20plus.json` +### 候选补录(未进入正式目录基线) + +以下平台已被识别为值得跟踪的中转/聚合候选,但当前还**未**进入正式 `plan_catalog_inventory` 基线,原因是尚未完成官方公开 pricing surface 核验: + +1. OpenCode Zen(已完成官网初核) +2. OpenCode Go(已完成官网初核) + +当前判断: + +- 需要区分 **OpenCode** 与 **OpenCode Zen**:前者是开源 AI 编程代理产品,本身不是我们要采集的价格平台;后者才是 OpenCode 官方提供的模型访问网关 +- 官网与文档已明确:Zen 是“由 OpenCode 提供的精选模型列表 / AI 网关”,支持通过 `https://opencode.ai/zen/v1/responses` 访问多种模型,并要求登录后添加账单信息、获取 API Key +- 官方公开语义更接近“按请求付费 + 账户充值 + 月度消费限额”,而不是传统包月套餐表;营销页可见 `充值 $20 (即用即付)`、`支持设置月度消费限额`,文档页可见“你按请求付费,也可以向账户充值” +- 因此它**可以算中转/聚合平台**,但当前更像 payg AI gateway,而不是已证实的 `subscription_plan` 型套餐平台 +- OpenCode Go 则是另一条独立付费路径:官方文档明确写明“首月 5 美元,之后每月 10 美元”,并列出可访问模型与 5 小时 / 每周 / 每月额度限制 +- 因此 **OpenCode Go** 更接近 `subscription_plan` 语义,而 **OpenCode Zen** 更接近 payg gateway;两者不应混成一个候选项 +- 以当前项目口径判断,**OpenCode Go 已经足够进入 `subscription_plan` 候选基线**:因为官方公开页已给出稳定的订阅价格、账单周期、可访问模型范围与额度限制;但它还**不等于**已经具备真实 importer 闭环 +- 下一步若要正式纳入目录基线,应拆成两条: + - **OpenCode Zen**:优先判断其公开价格是否足够支撑 `catalog verification` 或真实 pricing importer + - **OpenCode Go**:可进入 `subscription_plan` 候选基线;下一步再决定是先手工 seed,还是直接做真实 importer / manual-seed importer 闭环 + +### OpenCode Go 最小落地方案(当前建议) + +按当前证据,最小风险闭环建议不是直接写新 importer,而是先走 **`subscription_plan_manual_seed.json` + `import_manual_subscription_seed.go`**: + +1. **先补 1 条目录基线** + - 在 `plan_catalog_inventory` seed 中新增 `OpenCode Go` + - 建议语义: + - `operatorType`: `relay` + - `platformType`: `relay_platform` + - `planFamily`: `coding_plan` + - `billingCycle`: `monthly` + - `currency`: `USD` + - `sourceURL`: `https://opencode.ai/docs/go` + - `planStatus`: `confirmed` + - 原因:它是多模型访问订阅,不是单一官方模型厂商套餐 + +2. **先补 1 条 subscription seed,而不是伪造多 tier** + - 当前公开价只有一档主订阅:`首月 5 美元,之后每月 10 美元` + - 在现有 schema 下,建议先落 **标准价主记录 1 条**: + - `planCode`: `opencode-go-monthly` + - `planName`: `OpenCode Go` + - `tier`: `Standard` + - `billingCycle`: `monthly` + - `currency`: `USD` + - `listPrice`: `10` + - `priceUnit`: `USD/month` + - `planScope`: `OpenCode Go multi-model coding subscription` + - `首月 5 美元` 作为促销说明写进 `notes`,不要把首月促销和长期标准价拆成两条并列套餐,避免污染长期价格真相 + +3. **额度字段先保守表达** + - 可见限制: + - `5 小时限制 — 12 美元使用额度` + - `每周限制 — 30 美元使用额度` + - `每月限制 — 60 美元使用额度` + - 由于当前 `subscription_plan` 只有单组 `quota_value/quota_unit`,不能无损表达三层额度 + - 最小落地建议: + - `quotaValue`: `60` + - `quotaUnit`: `usd_usage/month_cap` + - 其余 5 小时 / 每周限制写入 `notes` + +4. **modelScope 可以直接公开落入 seed** + - 因官网已公开模型清单,可把当前列表写入 `modelScope` + - 例如:`GLM-5`, `GLM-5.1`, `Kimi K2.5`, `Kimi K2.6`, `MiMo-V2.5`, `MiMo-V2.5-Pro`, `MiniMax M2.5`, `Qwen3.5 Plus`, `Qwen3.6 Plus`, `MiniMax M2.7`, `DeepSeek V4 Pro`, `DeepSeek V4 Flash` + +5. **验证顺序** + - `go test -tags=llm_script scripts/import_manual_subscription_seed.go scripts/import_manual_subscription_seed_test.go scripts/subscription_import_common.go` + - `go run -tags=llm_script scripts/import_manual_subscription_seed.go -seed seeds/subscription_plan_manual_seed.json -dry-run` + - 验证 dry-run 输出中出现 `OpenCode Go:1` 与 `coding_plan:1` + ## 全球官方 / 中转参考集 本轮通过 web 搜索补录并进入目录基线的平台包括: