文档收口：写入 Rust 编译告警门禁口径与 AGC 检查命令

- dev 运维文档新增「Rust 编译告警门禁」整段：口径、落法（workspace lints + 成员继承 + 独立 crate 自持）、依据（--deny=warnings、不改 RUSTFLAGS、CI 缓存不受影响）、覆盖范围、检查命令与实测基线（server-rs workspace 1 → 0、AGC 壳 613 条批次清理中、desktop-shell/三 bridge/4 个 exclude crate 均 0）。 - dev 运维文档在编译警告清理段尾补门禁口径：能直接修的一律修掉、与口径冲突优先改口径、不能修的登记关闭条件。 - dev 运维文档 AuthBridge 条目改为已决策：2026-10-06 不支持用户 Codex OAuth 登录态、统一走中转站，按决策表第一行删除链路，warning 随之归零。 - dev 运维文档 ts-rs 条目补「待上游」关闭条件；Vite chunk 条目补门禁范围与关闭条件。 - dev 运维文档 cfg(not(test)) 拆分边界补「拆分不作为消警手段」；allow 表述收紧为登记后最窄范围使用。 - dev 运维文档 AGC 检查命令（bin 与 --tests）补编辑器 feature，基线句由「复核通过」改为当次快照。 - shared-memory/development-workflow 验证路由补 Rust warning 门禁与「拆分不作为消警手段」。 - shared-memory/pitfalls 顶部新增条目：AGC 壳新工作树缺 gitignored 随包/源码侧产物时 build.rs 报「未声明文件」的真实成因与最小处理。 - AGC 主方案 OAuth 契约冲突节改为已决策（决策内容、日期、执行动作、保留项、关闭条件），SDK 串行工具节的 OAuth 状态同步。
2026-10-06 16:36:49 +08:00
parent c1ad1a19f8
commit e0ea9d2c7f
4 changed files with 75 additions and 17 deletions
@@ -81,7 +81,7 @@ UI 编辑器的“分析参考图”步骤、Rust 命令 `suggest_ui_design_sema

 ## OAuth 认证路线的契约冲突与待决边界

-**状态（2026-09-23）：明确暂缓，待决定 AGC 是否支持使用用户 Codex OAuth 登录态。** AuthBridge 认证桥尚未接通正式入口；既不能认定为现役已支持能力，也不能仅因生产无构造点而宣布整条链退役。
+**状态（2026-10-06）：已决策——AGC 不支持用户 Codex OAuth 登录态，认证统一走我们的中转站（平台代理 / 显式自定义 Key）。** 因此 AuthBridge 认证桥按「不支持」路线整体退役：删除 reader / variant、OAuth 专属目录分支、轮换链及专属测试，并撤销本方案中相关承诺；平台代理路由、共享模型目录与隔离运行环境保留。

 ### 冲突事实与证据

@@ -90,18 +90,20 @@ UI 编辑器的“分析参考图”步骤、Rust 命令 `suggest_ui_design_sema
 - **时间顺序**：正式凭据 fallback 被限定测试的记录见 `2e15289264`（2026-09-02）；9 月 21 日提交新增下游 OAuth 处理，却仍保留该测试限定入口。因此不能简单把 OAuth 承诺当作早于现役路线的过期说明。
 - **验证边界**：OAuth 目录测试使用真实 Codex 配合模拟认证和本地服务，轮换测试验证私有缓存及身份隔离；这些不能证明正式客户端已接通真实用户 OAuth 登录。每回合模型目录捕获也服务现役平台代理，不能随 OAuth 专属链整体删除。

-### 暂缓期间的处理
+### 执行动作（2026-10-06 起）

-保留认证桥相关 warning、现有实现及待决记录，不新增 `allow`，不为清零把整条业务链继续移入 `cfg(test)`，不擅自接通用户登录态读取，也不把现状记录为“已支持 OAuth”。该待决项与其它已完成的 warning 清理独立，不阻止其它改动提交。
+- 决策：**不支持用户 Codex OAuth 登录态，统一走我们的中转站**（决策日期 2026-10-06）。
+- 执行：删除 AuthBridge reader / variant、OAuth 专属目录分支、轮换链及专属测试，并同步撤销相关文档承诺；每回合模型目录捕获等同时服务现役平台代理的部分保留，不能随 OAuth 专属链整条删除。
+- 保留：中转站（平台代理 / 显式自定义 Key）路由、共享模型目录、隔离运行环境不随之改动。
+- 不再保留认证桥相关 warning 与实现：链路删除后 3 条 AuthBridge warning 随之归零，门禁清单里唯一的实现层例外关闭（见[本地开发验证与生产运维](../【开发运维】本地开发验证与生产运维-2026-05-15.md#rust-编译告警门禁)）。

-### 下一决策点与关闭条件
+### 关闭条件与保留项

-| 决策 | 关闭条件 |
+| 已选路线（2026-10-06） | 关闭条件 |
 | --- | --- |
-| 不支持用户 Codex OAuth 登录态 | 同步撤销相关文档承诺，删除 AuthBridge reader / variant、OAuth 专属目录分支、轮换链及专属测试；保留现役平台 / 自定义 Key 路由、共享模型目录和隔离运行环境，完成定向验证。 |
-| 支持用户 Codex OAuth 登录态 | 先明确入口、授权与凭据隔离合同，再接通正式构造路径；验证真实登录、模型目录来源、轮换续传、身份切换与错误恢复，不能仅凭模拟测试或取消编译告警关闭。 |
+| 不支持用户 Codex OAuth 登录态，统一走中转站 | 删除 AuthBridge reader / variant、OAuth 专属目录分支、轮换链及专属测试，撤销相关文档承诺，并完成带编辑器 feature 的 AGC 壳定向验证；保留中转站（平台代理 / 自定义 Key）路由、共享模型目录和隔离运行环境。落地后本节的 3 条 AuthBridge warning 归零，该待决项关闭。 |

-当前尚未选择上述任一路线。本节是该冲突的维护位置，不依赖临时编译警告清单；决定后在此更新为最终合同，决策历史由 Git 保留。记录冲突本身不构成功能接入或退役决定。
+本节是该决策的维护位置，不依赖临时编译警告清单。后续若要重启用户 Codex OAuth 登录态，必须先把「支持」路线重新立项：明确入口、授权与凭据隔离合同，并验证真实登录、模型目录来源、轮换续传、身份切换与错误恢复，不能仅凭模拟测试或取消编译告警恢复该链路。决策历史由 Git 保留。

 ## 2026-09-23 Direct 宿主继续请求输入修复

@@ -253,7 +255,7 @@ UI 编辑器的“分析参考图”步骤、Rust 命令 `suggest_ui_design_sema

 ### SDK 串行工具的等价接入

-> OAuth 状态（2026-09-23）：下列 OAuth 目录与凭据轮换要求已有下游实现和测试，但正式凭据入口尚未接通 AuthBridge。是否支持用户 Codex OAuth 登录态仍待决，详见本方案的[契约冲突与待决边界](#oauth-认证路线的契约冲突与待决边界)。平台代理使用的共享模型目录能力继续有效。
+> OAuth 状态（2026-10-06）：**已决策不支持用户 Codex OAuth 登录态，认证统一走我们的中转站**。下列 OAuth 目录与凭据轮换要求按该决策退役（删除 AuthBridge reader / variant、OAuth 专属目录分支、轮换链及专属测试），详见本方案的[契约冲突与待决边界](#oauth-认证路线的契约冲突与待决边界)。平台代理使用的共享模型目录能力继续有效。

 - DirectProject 对外保留完整补丁和计划能力，由宿主 MCP 提供 `agc_apply_patch` 与 `agc_update_plan`。精确关闭 SDK 的旧计划工具注册；缺少合法回包通道的原生问答工具不再声明可用，需要用户信息时使用现有聊天。
 - 通过同一可信捆绑 Codex 和身份/路由隔离的 HOME 取得完整模型目录，只置空 `apply_patch_tool_type` 以移除 SDK 全局串行补丁处理器。不得修改模型名称或其它 metadata，不为未知模型伪造显式条目；匹配和 fallback 仍由 SDK 执行。