支持通过我们程序注入第三方 ACP 鉴权

[YoungSx]

2026-09-08 复核：保持开放。 范围尚待明确；已有安全保存凭据的基础，端到端注入与终端登录不能据此视为完成。

最新开发计划与关单条件 · SDK 能力说明 PR #183

[YoungSx]

2026-09-08 复核与开发计划：先固定注入契约，保持开放

复核基线：main c1f47febb730dc5651e7ebe69a42618929e9477d。本 issue 原本只有标题，尚未约定 Agent、凭据类型、传输或目标平台，因此没有足够依据宣布“已完成”。本轮已向需求方询问是 API Key/Token 注入、终端交互登录，还是两者；在答案明确前，以下为可执行的分支计划，不把它当作已确认产品范围。

现有能力与确定缺口

• 已有 AuthenticationConfig.Token/ApiKey，配置编辑器、CLI --token-stdin / --api-key-stdin、ConfigurationManager 和安全存储。凭据保存/清除由配置 owner 统一负责，不应重建一套 secret store。
• 已有 StdioEnvironment → TransportFactory → DesktopStdioTransportFactory → 子进程环境的链；该字典明确是 YAML 明文的非敏感运行配置，不能把 key/token 放进去冒充安全注入。
• TransportFactory.CreateTransport(ServerConfiguration) 当前传递命令、参数、URL、代理、超时和非敏感环境，未把 Authentication 接入传输/进程。AuthenticationConfig 本身也没有凭据目标 header/env 的语义映射。因此“可以保存 key”不等于“Agent 已收到并能认证”。
• ACP authenticate 的 methodId 流程已存在，fix(acp): 选择认证方法时不判别 AuthMethod.type，可能把 terminal 方法传给 authenticate（规范禁止） #147 负责鉴权方法白名单与终端认证；它和传输授权/Agent 启动凭据是不同契约，不能互相代替。

开发顺序

1. PR A / P2：固定并实现凭据绑定契约。 列出首批真实 Agent/版本，逐个确认支持的凭据来源（指定 env/header/Agent 自己的配置）与目标平台。Profile 只保存非敏感绑定描述，secret 留在现有安全存储；唯一 resolver 在创建连接/进程前取得本次凭据快照并决定注入目标，区分未提供、已设置和清除。不得猜测所有 Agent 都使用同一环境变量或 Authorization header。
2. PR B / P2：按已确认目标接入。 本地 stdio 把 secret 仅注入本次子进程，不修改全局环境、不写入命令行/明文 YAML；远端 HTTP/WS 只按明确 endpoint 和认证机制附加凭据，验证重定向/重连不会带到其他 endpoint。WASM 对自定义 WebSocket header 和本地进程的限制必须由平台能力表达，不能承诺与桌面完全相同。保存失败、凭据不可用、连接失败时给可操作提示，并保留正确的原有配置。
3. PR C / P2：产品入口与真实 Agent 验收。 复用现有配置/凭据状态 owner，展示配置是否已提供及连接验证结果，不回显 secret。覆盖更改、清除、重启、profile 切换、重连和安全存储不可用；UI 由 ViewModel 驱动，平台调用集中到服务。
4. 若范围包含终端交互登录：依赖 fix(acp): 选择认证方法时不判别 AuthMethod.type，可能把 terminal 方法传给 authenticate（规范禁止） #147 第二阶段。 用真实交互终端执行 Agent 宣告的 terminal 认证，取消/失败回收进程，按退出码和重连后的权威结果呈现状态。不要在本单重复实现第二套终端认证。

验收与关单条件

• 首批 Agent、凭据种类、注入目标及平台清单明确；不存在只写“第三方”却没有可验证对象的范围。
• 使用 canary secret 验证只有指定子进程或 endpoint 收到，其他 profile、全局环境、YAML、日志、诊断包、同步和模型消息均不包含它。
• 保存/清除/重启/重连的全链验证；清除后旧凭据不会继续使用，安全存储失败不会静默退回明文。
• 至少一个真实受支持 Agent 从“未认证”走到“正常 initialize/session/prompt”，记录产物来源、对端版本与脱敏报文；受限平台有明确行为证据。
• 受影响 Domain/Application/Infrastructure/Presentation/CLI 测试、SDK 消费兼容及目标平台构建/GUI 验收通过。

本轮仅核对上述代码链，未执行真实凭据注入或终端登录，因此保持开放。建议在 #147/#148 的 P1 正确性修复后，按确认的范围执行本单；#154 的 URL 登录流程如适用，复用其安全外部导航能力。