feat: 新增 qoder 客户端支持（bili qoder）

[ranxianglei]

来源: #640 分析 codebuddy 客户端支持时发现（owner 在 #640 要求立项）

背景

qoder（Qoder CLI，npm 包 @qoder-ai/qodercli 国际版 / @qodercn-ai/qoderclicn 国内版，bin qoder / qodercli，Apache-2.0，阿里出品）是 gemini-cli 的 fork（bundle 里保留 GEMINI_* env 别名和 gemini-cli 的 zod 配置 schema）。和 codebuddy 一样是 Node CLI，但模型端点 scheme 硬编码 https，没有可用的 HTTP base URL 覆盖 env，所以 codebuddy 的 /bili/ rewrite 路线走不通，需要 cert-MITM（dsh/claude 式）。

推荐方案：cert-MITM，proxy mode

• qoder 尊重 HTTPS_PROXY（内置 undici 带 ProxyAgent，网络管理器 getProxy() 读标准 proxy env）和 NODE_EXTRA_CA_CERTS（无自定义 https.Agent，TLS 走 undici 默认）
• launcher 注入：HTTPS_PROXY=http://127.0.0.1:PORT + NODE_EXTRA_CA_CERTS=<bili CA> + BILLION_CONTEXT_PROXY
• 默认 MITM 白名单模型 host（下表）；代理看到 POST /model/v1/chat/completions → OpenAI adapter → 压缩
• 认证 token（Bearer，私有 SSO/PAT 签发）对代理不透明，原样转发
• 压缩走 proxy mode（wire 注入）。qoder 不是 ACP-native agent（bundle 里有 ACP 协议 schema，见开放问题 feat: persistent + namespaced sessions, multi-tenant session isolation, stream robustness #5，可作未来 plugin mode 方向）

调研确认的配置事实（v1.1.47，从 npm 包 bundle 核实，国际/国内两版）

模型流量

• wire 是 OpenAI chat completions：POST https://<host>/model/v1/chat/completions，body = 标准 OpenAI chat + qoder 扩展（顶层 metadata/patches/custom_model，message 级 reasoning_content/reasoning_item）；SSE + [DONE]，另有配额标记 [EXCEED_QUOTA]/[NOTIFICATIONS]
• 模型 host 优先级：QODER_MODEL_SERVER_HOST（未文档化 env，剥 scheme 和尾部斜杠）> 静态 map {prod: api2-v2.qoder.sh, daily: daily-api2-v2.qoder.sh, test: test-api2-v2.qoder.sh}（国际/国内 bundle 相同）
• 区域推理 host：api1.qoder.sh(US) / api2.qoder.sh(SG) / api3.qoder.sh(JP)；国内版全部走 gateway.qoder.com.cn；center 面 center.qoder.sh / gateway.qoder.com.cn（控制面，不需要 MITM）
• scheme 硬编码 https → /bili/ rewrite 不可行，cert-MITM 是唯一路线
• transport：QODER_MODEL_TRANSPORT（http|grpc|legacy|http3|sse|off），协议 map {"custom-openai", "custom-openai-responses", "custom-anthropic"}；默认由服务端 feature gate 决定，fallback legacy（remoteChatAsk 生命周期，wire 待真机验证）。注意：配置了 proxy 时 grpc 会自动降级为 http（bundle 里有 p7c() 检查）——http 是 proxy 友好路径

认证（私有，已确认）

• 浏览器 SSO 登录（后台每 30 分钟自动刷新 token）或 PAT（QODER_PERSONAL_ACCESS_TOKEN，qoder.com/account/integrations 创建）；token = security_oauth_token ?? access_token，Authorization: Bearer 发送
• 与 codebuddy 同类私有认证；不影响 bili（代理不解析 token，原样转发）

配置

• 配置根：QODER_CONFIG_DIR / QODERCN_CONFIG_DIR（完整路径）> QODER_CLI_HOME/QODERCN_CLI_HOME+目录名 > ~/.qoder（国际）/ ~/.qoder-cn（国内）；QODER_CONFIG_DIR_NAME/QODERCN_CONFIG_DIR_NAME 控制目录名；项目资源在 <cwd>/.qoder
• settings.json 在 <configDir>/settings.json，gemini-cli 风格 zod schema（mcpServers 等）
• 站点：QODERCLI_SITE=cn → QODERCN_ 前缀；国内包 site 内置
• 启动 env：QODER_MODEL（-m）、QODER_MCP_CONFIG（--mcp-config，文件或 inline JSON）、QODER_WORKING_DIR、QODER_SESSION_ID、QODER_SESSION_NAME、QODER_PERMISSION_MODE
• --list-models 列模型（服务端驱动的 catalog，本地配置里没有模型清单）

预算对齐

• QODER_AUTOCOMPACT_WINDOW / QODERCN_AUTOCOMPACT_WINDOW：cap 有效上下文窗口（min(modelWindow, env)），正好对应 REQ: codex 压缩预算协调 + 匿名代理模式拦截伪造（根本解决方案） #321 的 claude 预算对齐模式（env 注入面）
• 模型窗口服务端驱动（catalog max_input_tokens，缺省 128k）；另有 QODER_AUTOCOMPACT_PCT_OVERRIDE

MCP

• QODER_MCP_CONFIG = --mcp-config（文件或 inline JSON），语义与 claude 一致 → MCP 注入可接（首版可选）

接入点清单

1. src/client-config.ts：QoderConfig、resolveQoderHome(env)（QODER_CONFIG_DIR ?? QODERCN_CONFIG_DIR ?? ~/.qoder）、readQoderConfig()——只读发现 settings.json（model 选择）；无本地 models.json（服务端驱动）
2. src/launcher.ts：LAUNCH_CLIENTS 加 "qoder"；discoverRoutes qoder 分支——无 /bili/ rewrite（scheme 硬编码 https），改为返回默认 MITM 域名：api2-v2.qoder.sh、api1.qoder.sh、api2.qoder.sh、api3.qoder.sh、gateway.qoder.com.cn（daily/test 变体不默认加）；buildQoderEnv()（HTTPS_PROXY + NODE_EXTRA_CA_CERTS + BILLION_CONTEXT_PROXY，无 base URL rewrite）；resolveQoderBudgetEnv()（QODER_AUTOCOMPACT_WINDOW，国内站点用 QODERCN_ 前缀）；resolveClientCommand（qoder → qodercli）
3. src/discover.ts：extractHttpsHosts qoder 分支（默认模型 host）；configFilePaths 加 <configDir>/settings.json
4. src/cli.ts：HELP 加一行
5. 测试仿 launcher.test.ts / dsh 模式
6. README client 章节和 AGENTS.md 模块表同步更新

开放问题

1. legacy transport wire：默认 transport 由服务端 feature gate 决定，fallback legacy（remoteChatAsk 生命周期）——其 wire 是否也是 OpenAI 兼容 SSE 待真机验证。建议首版 launcher 注入 QODER_MODEL_TRANSPORT=http 强制走 OpenAI wire 路径，真机验证后再决定是否去掉
2. qoder body 扩展字段（metadata/patches/custom_model）：需验证 bili 的 OpenAI adapter 对未知顶层字段的透传行为
3. 模型窗口：服务端驱动 catalog，bili 的 models.dev registry 大概率没有 qoder 模型名——首版依赖 QODER_AUTOCOMPACT_WINDOW 或 bili configured limit 兜底
4. 国内站点检测：launcher 如何判定 QODER_ vs QODERCN_ 前缀（QODERCLI_SITE env？安装的 binary 是哪个包？），需要定一个规则
5. ACP mode（QODER_ACP_LOGIN_METHOD_ID 等）：bundle 里有 ACP 协议 schema（sampling/createMessage），未来可做 plugin mode（agent 侧压缩），首版不做

首个验证场景

国际版 + PAT 登录（QODER_PERSONAL_ACCESS_TOKEN），跑 bili qoder，确认：模型流量经代理 TLS 终止、/model/v1/chat/completions 走 OpenAI 压缩管线、QODER_AUTOCOMPACT_WINDOW 对齐日志出现、压缩循环正常触发。

[ranxianglei]

接单

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 收到，开工。方案按 OP 定的走：cert-MITM + proxy mode（HTTPS_PROXY + NODE_EXTRA_CA_CERTS + BILLION_CONTEXT_PROXY 注入，无 /bili/ rewrite，默认 MITM 白名单五个模型 host，QODER_MODEL_TRANSPORT=http 强制 OpenAI wire，预算对齐走 QODER_AUTOCOMPACT_WINDOW）。

实现中，完成后回 PR 链接 + pre-flight 结果。国内站点前缀检测（开放问题 #4）我会定一个规则并在回复里说明。

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 收到，正在实现中。代码改动已完成（client-config / launcher / discover / cli / README / AGENTS.md + 测试），typecheck 已过，定向测试 122/123 通过（唯一失败是沙箱环境既有问题：/usr/bin/codex 存在导致 resolveClientCommand: codex/claude resolve to themselves 在 master 上同样失败，已用 git stash 验证）。正在跑全量测试 + build，完成后提交 PR 并回复链接。

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 已完成，PR: #654

按 issue 推荐方案实现（cert-MITM + proxy mode，wire 注入）：

实现

• src/client-config.ts：QoderConfig / qoderIsCnSite() / resolveQoderHome()（QODER_CONFIG_DIR/QODERCN_CONFIG_DIR > *_CLI_HOME+dir name > ~/.qoder/~/.qoder-cn）/ readQoderConfig()（只读 settings.json 的 model + QODER_MODEL_SERVER_HOST 去 scheme/尾斜杠）/ QODER_DEFAULT_MODEL_HOSTS（prod + 区域 US/SG/JP + 国内网关，daily/test 不含）。
• src/launcher.ts：bili qoder——buildQoderEnv()（HTTPS_PROXY + NODE_EXTRA_CA_CERTS + BILLION_CONTEXT_PROXY，继承的代理变量全剥离，hermes 同款契约）；discoverRoutes qoder 分支：默认模型 host 进 MITM 白名单，QODER_MODEL_SERVER_HOST 整体替换默认表（qoder 自身解析顺序 env > 静态表）；QODER_MODEL_TRANSPORT=http 强制注入（开放问题 1：默认 transport 是服务端 feature gate，legacy fallback wire 未真机验证，先钉死 OpenAI wire）；REQ: codex 压缩预算协调 + 匿名代理模式拦截伪造（根本解决方案） #321 预算对齐 resolveQoderBudgetEnv() → QODER_AUTOCOMPACT_WINDOW / QODERCN_AUTOCOMPACT_WINDOW（cap 语义，注入恒安全；用户自设 / 解析不到窗口 → 不注入）；resolveClientCommand 按 qoder → qodercli 找；BILI_LAUNCHER_DIRECT 对 qoder 无效时给警告。
• src/discover.ts：qoder host 进 MITM 域名自动发现 + settings.json mtime 监听。
• src/cli.ts / README / AGENTS.md 同步。
• 新增 13 个测试（站点判定、home 解析、配置发现、路由发现、env 构建、预算对齐、命令解析、runLaunch 全链路集成）。

开放问题 4（CN 站点前缀规则）——我定的规则（qoderIsCnSite，代码注释 + docstring 里写明了）：

1. QODERCLI_SITE=cn → CN 包
2. 设了 CN 前缀配置 env（QODERCN_CONFIG_DIR / QODERCN_CLI_HOME）→ CN 包
3. 磁盘上只有 ~/.qoder-cn 没有 ~/.qoder → CN 包（CN 包默认目录 vs 国际版默认目录）
4. 其余 → 国际版

已知退化边界：两个包都装时 CN 启动会被判成国际版（后果仅是预算不注入 / transport env 用错前缀，不会破坏启动），QODERCLI_SITE=cn 可强制覆盖。

v1 限制（代码注释 + PR 里都注明）

1. QODER_MODEL_TRANSPORT=http 强制——legacy fallback wire 未真机验证，验证后可去掉（开放问题 1）。
2. 双包安装的 CN 判定退化（见上）。
3. 不做 MCP 注入（纯 proxy mode；QODER_MCP_CONFIG 兼容性未验证，留后续）。
4. 模型窗口服务端驱动，qoder 模型名大概率不在 bili limits / models.dev 里——预算对齐是 best-effort，用户自己的 QODER_AUTOCOMPACT_WINDOW 仍是兜底（开放问题 3）。

Pre-flight：typecheck ✓；test 1246/1247（唯一失败 resolveClientCommand: codex/claude resolve to themselves 是环境性既有问题：沙箱装了 /usr/bin/codex，已用 git stash 验证 master 上同样失败，CI 上通过）；build ✓，构建产物 --help 冒烟通过（qoder 行正常渲染）。

建议真机验证（issue 首场景）：国际版 + PAT 登录跑 bili qoder，确认模型流量 TLS 终结走代理、/model/v1/chat/completions 过 OpenAI 压缩管线、出现 bili: qoder budget aligned — QODER_AUTOCOMPACT_WINDOW=... 日志、压缩循环正常触发。

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 顺带发现一个既有小问题（未在本 PR 修，避免混入无关改动）：bili --help 里 hermes/dsh 两行仍写着 (/bili/ rewrite)，但 #535 之后它们实际走 proxy-env（dsh 仅 loopback 例外保留 overlay rewrite）。纯文案失实，建议下次顺手改 src/cli.ts HELP 模板。