From aad5a0bcefa187b6b54bce01deeb399cd86fb4c9 Mon Sep 17 00:00:00 2001 From: Linghong Date: Fri, 2 Oct 2026 13:29:08 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E5=85=AC=E5=BC=80=E6=A8=A1?= =?UTF-8?q?=E5=9E=8B=E7=9B=AE=E5=BD=95=E6=B5=8B=E8=AF=95=E9=81=97=E6=BC=8F?= =?UTF-8?q?=E5=8D=8F=E8=AE=AE=E5=AD=97=E6=AE=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 补齐公开模型目录完整 JSON 断言中的 protocol 字段。 同步后端契约文档中的回归验证说明。 验证模型目录定向测试、编码检查、文档索引和 Rust 格式检查通过。 --- docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md | 1 + server-rs/crates/api-server/src/llm/mod.rs | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md b/docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md index 94f2a7a51..766820acc 100644 --- a/docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md +++ b/docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md @@ -537,6 +537,7 @@ Responses 的终态载荷既是工具调用的恢复源，也是正文的恢复 - `read_agc_model_catalog` / `save_agc_model_catalog` 只接受已登记的 runtime service identity，保存使用 revision 乐观锁；缺行时读取返回 `AGC_MODEL_CATALOG_NOT_INITIALIZED`，不返回任何内置目录。 - 目录初始值来自上游同步：api-server（API/All 角色）启动时若目录缺失、结构与当前定义不符或校验不通过，就用分组定价列表 `GET {Router 控制面}/api/pricing?group=taonier`（公开只读、不带凭据）的 `data[].model_name` 生成目录（`id` 为模型名 slug，`alias`/`modelId` 为上游原名），失败只记录 error、不写替代目录，由下一次启动重试；未初始化期间 AGC 目录与对话接口、后台目录接口都失败关闭（`503`）。 - 后台 owner 通过 `GET/PUT /admin/api/agc-models` 管理稳定标识、必填别名、实际模型名、启用状态、默认项，以及**执行器 `agentMode` 与线协议 `protocol` 两个正交维度**：`agentMode` 只取 `codex` / `cc`，`protocol` 只取 `openai_responses` / `openai_chat` / `anthropic`，合法组合封闭（codex ⇒ responses/chat，cc ⇒ anthropic），非法组合在保存与加载两侧都失败关闭；存量目录缺 `protocol` 时按执行器推导。客户端 `GET /api/llm/models` 返回启用项的稳定标识、别名、`agentMode`、解析后的 `protocol` 和目录 `revision`（供条件刷新，不暴露实际模型名）。 +- 公开目录回归测试 `llm::model_catalog_tests::public_catalog_exposes_stable_id_and_upstream_alias` 对完整模型 JSON 做相等断言，包含默认 Codex 模型的 `protocol: "openai_responses"`；调整返回字段时同步更新该断言，并保留禁用项过滤和内部字段不下发的验证。 - Responses / Chat 请求按目录解析模型；未知或停用项拒绝。AGC 的 `platform-default` 请求标识使用目录默认项。详细契约见 `technical/【技术方案】AGC后台模型别名与对话选择-2026-09-05.md`。 ### `error_report` diff --git a/server-rs/crates/api-server/src/llm/mod.rs b/server-rs/crates/api-server/src/llm/mod.rs index b97a8da5d..e43cf2e8f 100644 --- a/server-rs/crates/api-server/src/llm/mod.rs +++ b/server-rs/crates/api-server/src/llm/mod.rs @@ -48,7 +48,7 @@ mod model_catalog_tests { // 客户端拿到稳定标识 + 别名（别名就是上游原始模型名），实际模型名不下发。 assert_eq!( payload["models"], - json!([{"id": "gpt-5-6-sol", "displayName": "gpt-5.6-sol", "agentMode": "codex"}]) + json!([{"id": "gpt-5-6-sol", "displayName": "gpt-5.6-sol", "agentMode": "codex", "protocol": "openai_responses"}]) ); assert_eq!(payload["defaultModelId"], "gpt-5-6-sol"); assert_eq!(payload["revision"], json!(7));