[ranxianglei]

Refs #4593 (documentation facet only — the issue stays open for the design discussion on byte-faithful routing / ZCode-side fix).

What

The ZCode "Known limitations" block was self-contradictory for zai-series coding-plan accounts whose model endpoint is zcode.z.ai:

• it scoped the billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661 anti-fraud wall to "login traffic", while the field evidence ([feature] compress: Add preserveRecentTurns (per-turn retention) and protectUserMessages (hard protection for user messa | [feature] compress: 增加 preserveRecentTurns（按轮保留）与 protectUserMessages（user 消息硬保护） #4592 + billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661) shows the 405/3012 trips the model endpoint /api/v1/zcode-plan/anthropic/v1/messages;
• it blanket-recommended "use the GUI cert-MITM setup for compression on these accounts" ([Bug] zcode 原生模式：coding-plan 账号模型创建失败 "Client signing handshake requires HTTPS."（zcode 3.14 客户端签名与 http 改写不兼容） #1621 paragraph) and "keep the mitm://zcode.z.ai: {passthrough:true} route" (billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661 paragraph) — mutually exclusive for zai-series, i.e. kernel → 405/3012 vs passthrough → no compression.

Change (docs only, en + zh mirror)

Clarify that #661 rejects kernel-rebuilt bodies on the zcode.z.ai model endpoint, and split the two coding-plan families by endpoint:

• bigmodel-series (open.bigmodel.cn, outside the billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661 scope): cert-MITM + kernel compresses normally;
• zai-series (zcode.z.ai, inside the billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661 scope): any kernel pass over model traffic 405s even with zero folds folded, so the MITM setup must keep the passthrough route → working-but-uncompressed; no config today both compresses and avoids the 405 for zai-series model traffic.

Behavior

None. Two .md files only (CLIENTS.md, CLIENTS.zh-CN.md). No code, config schema, wire, persistence, or version change.

[github-actions]

📦 Built Package Artifact

Branch: 2026-10-25_zcode-zai-clients-docs (0fde4dd)

Latest build — install this exact version

npm install -g billion-context@0.0.6174-pr.4610.c8638ff

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Recent builds (commit → version)

commit	version	build
0fde4dd	billion-context@0.0.6174-pr.4610.c8638ff	build
77d039d	billion-context@0.0.6089-pr.4610.66aed80	build
556fe64	billion-context@0.0.5991-pr.4610.e239905	build
62e24ad	billion-context@0.0.5869-pr.4610.796d31f	build
8ce6c85	billion-context@0.0.5802-pr.4610.84087ac	build
fc72d81	billion-context@0.0.5643-pr.4610.d0ad59e	build
0b63525	billion-context@0.0.5572-pr.4610.0d21267	build
3ed43e0	billion-context@0.0.5570-pr.4610.a7aaf8e	build

Download artifact

1. Download the artifact from the Actions run
2. Extract the tarball and install:

tar xzf billion-context-pr4610.tgz
npm install -g package

---

Install instructions are refreshed on each push.

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

自动修复判定(attempt 1/2):继承 master 常红,不在本分支修——等 #4606 合入后 rebase。

八问:

1. 是什么问题:本 PR 的 CI unused-exports 静态门禁报 INTERNAL_ONLY src/agent/client-build-note.ts: ClientBuildCheck(run 40119715478 / job 120948389385);其余 12 个静态门禁全绿,test 分片因前置门失败未调度(skipped)。
2. 什么原因导致的:不是本 PR 引入的。master head 146b34f27(合并 [PR] merge: tier-5 train — dsh prepare/streaming domain (7 PRs: bili_final terminal marker, auto-fold storm gate, wire-only guard) #4590 tier-5 train)起,src/agent/client-build-note.ts:32 导出的 ClientBuildCheck 全仓只在本文件内使用(本地已核实 origin/master:仅 32/45/81/93/115 五行),master 自身在该门禁上 born-red;前置门跑在 merge commit 上,所有在途 PR 都继承这条红。本 PR diff 只有 CLIENTS.md(+25/-16)与 CLIENTS.zh-CN.md(+1/-1),不碰任何 TS,不可能影响导出图。证据链:master head run 40111170499(job 120923016330)与本 PR run 报错行逐字节一致(CI Control Center: Centralized CI Failure Handling & Status Sync (Comment all CI issues here; do not open new issues) | CI 总控: CI 失败集中处理与状态同步(所有 CI 问题在此评论, 勿开新 issue) #4599 已有记录);根因与一行修法已立 fix(ci): master unused-exports is red — ClientBuildCheck is exported but only used inside its own file #4602。
3. 影响范围与严重程度:当前所有并入 master 的 PR 都继承这条红(红信号失去区分度);纯静态门禁,零运行时行为影响。
4. 怎么修复的:本轮不在本分支动手——规范修复载体是 [PR] fix(ci): clear the two master-red gates in one branch — unused-exports (#4602) + the #3890 LIVE_FILES tripwire (#4604) #4606(一条分支同时含「去 ClientBuildCheck export」fix(ci): master unused-exports is red — ClientBuildCheck is exported but only used inside its own file #4602 + 「tests/issue3890-parent-gone-confirm-drain.test.ts 补 LIVE_FILES 登记」fix(ci): every test shard is red — tests/issue3890-parent-gone-confirm-drain.test.ts spawns processes but is missing from LIVE_FILES #4604 两条 master 常红;二者互为前提,只合其一另一条仍红、拿不到全绿)。把这一行改动复制进本 docs 分支属于超范围捆绑,且修完 test 分片还会撞第二条 master 红,CI 仍不绿。[PR] fix(ci): clear the two master-red gates in one branch — unused-exports (#4602) + the #3890 LIVE_FILES tripwire (#4604) #4606 合入后 rebase 本分支重触发即可。
5. 是否有回归问题:无——本分支零改动。
6. 是否破坏缓存:不涉及。
7. 是否改了设计方向:不涉及。
8. 是否引入了新的配置:不涉及。

结论:本轮判定+停手,未向分支 push 任何提交;已在 #4599 留一行继承记录;待 #4606 合入后自动 rebase/重触发。

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重: 不重复 —— 本 PR 是 #4593(zcode 风控死路)文档面的唯一实现(#4593 线程已记录该 PR);近期无其他 PR 触碰 CLIENTS.md 的 ZCode Known limitations 段。
标签: zcode / scope/docs / p3(已有 pr)—— 纯文档澄清,zcode 车道,无运行时影响,故 p3。

结构化八问

1. 是什么问题:CLIENTS.md 的 ZCode「已知局限」段自相矛盾 —— 把 billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661 反欺诈墙的作用域写成了「登录流量」,且同段既推荐「用 GUI 证书 MITM 获得压缩」又推荐「保留 passthrough 路由」,对 zai 系账号二者互斥。
2. 什么原因导致的:文档落后于现场证据 —— billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661/zcode risk control issue | zcode风控问题 #4593 的日志已钉死触发点是 zcode.z.ai 的模型端点(/api/v1/zcode-plan/anthropic/v1/messages),且一次 fold 都没发生时(nudge idle、usage 0%,纯 round-trip 重序列化)就 405/3012;旧文字仍按「login traffic」表述,并保留了一刀切的 MITM 压缩推荐。
3. 影响范围与严重程度:仅文档面。受影响的是照旧文档操作的 zai 系用户 —— 会照「用 cert-MITM 获得压缩」去配,然后撞上必然的 405;无运行时/数据影响,p3。
4. 怎么修复的:重写该段 —— 把 billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661 作用域纠正为模型端点;按端点拆分两个 coding-plan 系列(bigmodel 系 open.bigmodel.cn 可正常压缩 / zai 系 zcode.z.ai 任何 kernel 处理都 405,必须 passthrough、可用但不压缩,当前不存在两全配置);删掉与 passthrough 互斥的一刀切 MITM 推荐。
5. 是否有回归问题:无。diff 只碰两个 .md;逐句核对了段落其余部分(v3.14+ 签名墙、route:"all"/"plans" 降级边界、pre-3.14 不受影响、attach 模式 inert、BILI_NATIVE_ZCODE=0 退出开关)在 en/zh 两侧均原样保留。唯一措辞漂移:zh「把这些账号逐条跳过」→「把改写整体跳过」,是与既有英文 "skips the rewrite entirely" 对齐,下一句仍澄清 route:"all" 下只有这些账号被跳过,无语义回归。
6. 是否破坏缓存:不涉及(无代码)。
7. 是否改了设计方向:不涉及。
8. 是否引入了新的配置:不涉及。

事实核对(独立重查,非复读 issue 结论)

• 对照 billion-context ACP kernel 改写 body 导致 ZCode (zcode.z.ai) 405/3012 #661 原文:405/3012 现场确为 POST https://zcode.z.ai/api/v1/zcode-plan/anthropic/v1/messages,且「即使 injectTool/injectNudge=false,processTurn round-trip 重建即触发」——新文字「even a round-trip that folds nothing」准确。
• 对照 zcode risk control issue | zcode风控问题 #4593 线程:零 fold 405 的现场证据(body 480.6KiB→501.8KiB 纯重序列化)与文档自相矛盾判定均在案,新文字恰好消除该矛盾。
• en/zh 镜像一致:两侧同步改写,无单边遗漏。

顺手修掉的小问题(已在 PR 分支补 commit)

引用号写错:正文与 PR 描述里的 (#4592) 指向 GitHub 上不相干的 compress 功能请求(preserveRecentTurns)—— 那是 eework 内部编号,GitHub 侧对应的是 #4593。已改:两个 .md 各一处 + PR 描述 Refs 行,commit 0b6352520(新 head),已推送。

CI

head 上仅 unused-exports 红 —— 与 master head 报错行逐字节相同(INTERNAL_ONLY src/agent/client-build-note.ts: ClientBuildCheck),是已立案的继承性 master 红(#4602,修复在 #4603,#4599 总控有记录),与本 PR 无关(docs-only diff 不可能影响导出图);其余门禁全绿或按门控 skip。

结论:可合。 内容核实通过、镜像一致、无行为变更;唯一的红是继承性 master 红,master 转绿后(或直接合入,文档不影响任何测试)即可合并。

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

自动修复判定(attempt 2/2,末轮):同一继承红,本分支不动手——自动修复通道到此结束。

新 head 0b63525 是纯 review-fix 提交(引用改 #4593、两文档文件各 1 行),不碰任何代码;base 仍是 146b34f27,根因未变。

八问(简版,完整证据链见 attempt 1 评论):

1. 是什么问题:run 40121188430 / job 120952860885 的 unused-exports 报 INTERNAL_ONLY src/agent/client-build-note.ts: ClientBuildCheck,与 attempt 1 及 master head run 40111170499 逐字节一致;其余静态门禁全绿。
2. 什么原因导致的:未变——master 146b34f27 起该类型导出但仅文件内使用,master 自身 born-red;本 PR 纯文档,与该门禁无关。
3. 影响范围与严重程度:同前——所有并入 master 的在途 PR 继承此红;纯静态门禁,零运行时影响。
4. 怎么修复的:不在本分支修(复制一行改动属超范围捆绑,且修完 test 分片还会撞 master 的第二条常红,CI 仍不绿)。规范载体仍是 [PR] fix(ci): clear the two master-red gates in one branch — unused-exports (#4602) + the #3890 LIVE_FILES tripwire (#4604) #4606,等人工合并。新观察(供 owner 决策,超出本 lane 范围):[PR] fix(ci): clear the two master-red gates in one branch — unused-exports (#4602) + the #3890 LIVE_FILES tripwire (#4604) #4606 的 head 6d6ebb7 自身 CI 也有 10 个 test 分片红(抽样一个分片 2384 pass / 20 fail,为具体断言失败而非 flake 形状)——即修复载体目前尚未全绿,合并前需要先处理这些失败。
5. 是否有回归问题:无——本分支零改动。
6. 是否破坏缓存:不涉及。
7. 是否改了设计方向:不涉及。
8. 是否引入了新的配置:不涉及。

结论:2/2 自动修复轮次用尽,未向分支 push 任何提交。解锁路径:#4606 转绿并合入后,本分支 rebase 重触发即可全绿;在此之前本 PR 的 unused-exports 会持续继承红。