v0.1.198 release blockers found in final pre-release review | v0.1.198 发版前终审发现的阻塞项清单 #3516

来源: #3511 (#3511) 分析 v0.1.197..master 发版窗口终审时发现

查重: 无(open/closed issue 与在途 PR 均检索过,无同签名条目)

v0.1.197→master(~120 个 PR,CORE 矩阵绿但 windows-node-24/e2e/registry 车道缺席)终审发现以下问题。同一「v0.1.198 不能安全发布」症状家族,按机制拆成子缺陷清单管理。除特别标注外,当前默认配置下多数条目休眠;P0 与 P1-3 是真实生效路径上的缺陷。

发布阻塞(必须修完 + 发版头 full 矩阵绿才能切 v0.1.198)

— P0 jimp 把 zod 静态带进 dist(可用性级):#3425 图片缩放换 jimp@1.6.1(devDependencies,tsup 内联),jimp 内部依赖 zod → 本地构建实测 dist/index.js 16 处、dist/agent/pi-native.js 16 处静态 from"zod"(opencode-native.js 0 处合规)。违反 AGENTS.md KDD#1(dist/index.js 零外部依赖)。后果:不带依赖树的安装(dsh profile 副本等主流插件路径)+ pi 插件启动即 ERR_MODULE_NOT_FOUND,流量静默直连上游不压缩。修:jimp 改运行时动态导入(失败降级跳过缩放)+ CI 静态断言禁止 dist/index.js 与 dist/agent/pi-native.js 出现静态 zod 导入。

• P1-3 guardrail 旋钮生产全死(修复中:fix(#3516): keep jimp out of dist (P0 release blocker) + wire pi/omp guardrail knobs #3524):src/agent/pi.ts:754 调用 wireToolGuardrails(pi) 无参;src/knobs.ts:237/244/251 三个旋钮函数零生产调用方;guardrails 未注册进 KNOWN_TOP_LEVEL_KEYS(src/config.ts:1974)。后果:owner 已批的本期默认(bash 60s 超时注入、50KB cap、重复熔断)里超时注入从未生效,且文档承诺的 guardrails.*/BILI_GUARDRAIL_* 关闭开关全部无效。修:调用点接 knobs 解析 + 注册 key。

增量/线程车道开灰度前必修(当前 rollout 0% 休眠)

• P1-4a src/incremental-lane.ts:146 PASSTHROUGH_HEADERS 缺 x-api-key(Bearer-only 上游会 401)。一行。
• P1-4c omp 增量门不对称:ompIncrementalBeforeSend 只查 state.origin+prompt_cache_key,无 dsh 同类路径的 toolsReady 门。
• P1-4d src/server/threads-lane.ts:375 reforge 摘要副调用裸 fetch,绕过 proxyDispatcher(compress-loop/degenerate-retry/preflight 均走 dispatcher)。
• P1-4b(kernel,human-gated)kernel/src/wire/anthropic.ts 块 switch 仅 text/tool_use/tool_result/thinking/image/redacted_thinking,无 default——未知块(document/audio/web_search_tool_result…)canonical 转换时静默丢弃。需 kernel-change 声明 + owner 批准。

存储(需完整影响分析后排期)

• P1-5 src/storage/ingest.ts:289 planner 只按 state.blocks 建行:[Bug][proxy] unframed host-side history deletion leaves zombie fold blocks rendering carriers forever — one carrier flaps in/out every turn (persistent prefix-cache churn) #2695 僵尸回收后 blockContents 孤儿条目不落 unified 表 → full 模式重启丢原文面;shadow 模式 digest 校验漂移循环。与 [Bug][proxy] unframed host-side history deletion leaves zombie fold blocks rendering carriers forever — one carrier flaps in/out every turn (persistent prefix-cache churn) #2695/影子存储(默认开启)每次落盘把整个会话重新序列化+哈希,大会话明显变卡;jsonWriter=off 时连防抖合并都没了 #3133 交互,需定向复现确认边界。

安全层级(人工评审)

• P1-6 security.adminRelay 开启后 dsh-web 浏览器可经 /__bili.* 免认证触达本机代理管理面(信任转移)。保持默认关;开启前需人工安全评审。

P2 小缺陷(顺手修或排期)

• src/persist.ts:1884 foldResidentTail 缺 !this.enabled 守卫(兄弟函数 dropResidentBlockContents/Metadata 均有;saveContentStore 在 !enabled 时 no-op 返回 true,writeNow 仍走到折叠点)。一行。
• kernel/src/report.ts:443-455 acp_status ⚠ 投影错误裸 catch,一律标 "refs unresolvable",吞掉 zone/split 诊断。(kernel)
• src/launcher.ts:3573 启动 marker 年龄判定无负龄防护(未来时间戳恒真 → CI flake 机制成立)。
• kernel/src/recommend.ts projectUnit O(n·m) 每轮重算(性能,非正确性)。

流程项

• P1-1:发版头必须手动跑 full 矩阵(ci:full,含 windows-node-24/e2e/registry)全绿再切版;master 头 494571f 目前只有 CORE 绿。
• P1-2:强合绕过了 kernel 版本纪律(5 个合并触及 kernel/src 无版本 bump:42e5b538/8f7ae10d/e7e7c39b/b726fb44/bce26b64;pi-subagents c241593 同样)。存量不回滚,后续恢复纪律。