Skip to content

Commit a953542

Browse files
committed
fix(choro): T1 不再按一种安装布局写死路径,起不来时也说得出原因
issue #578:DSH NEXT 上跑 --t1 会在 0.7 秒内返回 headless 退出码 1:(无输出), 两个独立的定位缺陷叠在一起,而失败信息一个字都没说。 - resolveCliJs 改成按优先级探测:DSH_CLI_JS → 新布局 lib/desktop-cli.js → 旧布局 dsh/node_modules/... → node_modules/...,逐个 existsSync 试; 全不中时返旧路径并标 verified:false,reason 里列出全部候选。 - locateDshExe 按名字白名单 + 标准安装位逐个试,认 DSH NEXT.exe; 刻意不认「同目录任意 exe」——装两套宿主时会挑错那个。 - consumeHeadlessStream 收 stderr 尾巴(4 KiB)拼进失败 reason, 环境级判据同时看 stdout 与 stderr;(无输出) 的根因就是 stderr 被扔掉。 - --dsh-exe 用 try/finally 还原 process.env,不再把旧值留给同进程后续定位。 - 新增 --dsh-cli,走环境变量接线,不造平行的传参链。 顺带纠正 CHANGELOG 里一条错误断言:不能 existsSync 校验只对 CLI 子进程成立, 探测发生在插件进程(Electron 给 fs 打了 asar 补丁),实测 statSync/readFileSync 均可用。 三种定位全部做成可注入参数,test/wiki-t1.test.js 从 0 例定位覆盖补到 7 例。 本机装的是旧布局,新布局分支只有假目录树覆盖,没在真 DSH NEXT 上跑过。
1 parent e1c4061 commit a953542

6 files changed

Lines changed: 401 additions & 48 deletions

File tree

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,18 @@
44

55
## 🆕 新增
66

7+
- **T1 不再按一种安装布局写死路径:DSH NEXT 上能跑起来了,起不来时也说得出原因**(issue #578)。报告者在 DSH NEXT 2.0.22-next 上跑 `--t1 --apply`,0.7 秒返回 `{"failed":[{"slug":"packages-host","reason":"headless 退出码 1:(无输出)"}]}`——两个独立的定位缺陷叠在一起,而失败信息一个字都没说。
8+
9+
- **cli.js 位置改成按优先级探测(`src/wiki/t1.js` 的 `resolveCliJs`)**:旧实现硬编码 `<exe>/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-desktop-host/lib/cli.js`,而 DSH NEXT 的 asar 顶层没有 `dsh/` 这层,可用 CLI 是 `app.asar/lib/desktop-cli.js`。现在候选顺序是 `DSH_CLI_JS` 环境变量 → 新布局 `lib/desktop-cli.js` → 旧布局 `dsh/node_modules/...` → `node_modules/...`,逐个 `existsSync` 试。**新布局排前面**:老机器升级后可能两种目录并存,让旧路径赢等于「升级了但还按旧位置找」。
10+
- **顺带纠正一条写进 CHANGELOG 的错误断言**(旧版本 M2 那条):原文说「cli.js 在 app.asar 内部,**不能 existsSync 校验**(CLI 是普通 node,没有 asar 支持)」。前半句对的是**CLI 子进程**,而探测发生在**插件进程**里——Electron 主进程与 `ELECTRON_RUN_AS_NODE` 子进程都给 fs 打了 asar 补丁。本机实测:`existsSync` / `statSync` / `readFileSync` 对 asar 内路径全部正常工作(`readFileSync(app.asar)` 整个包才会 ENOENT,那是虚拟目录不是文件)。所以探测是可靠的,**探测不到时(裸 node 等)退回旧布局老路径并标 `verified:false`**,失败信息里如实说「这次没探测」。
11+
- **exe 定位放宽(`locateDshExe`)**:旧实现只认 `basename === "deepseek harness.exe"` 或 `%ProgramFiles%\DeepSeek Harness\DeepSeek Harness.exe`,DSH NEXT 的 exe 叫 `DSH NEXT.exe` 且常装在别处,两个条件同时不满足 → 直接 environment 失败。现在按名字白名单(`deepseek harness.exe` / `dsh next.exe` / `dsh.exe`)+ `[ProgramFiles, ProgramFiles(x86)] × ["DeepSeek Harness", "DSH NEXT"]` 逐个试。**刻意不认「同目录任意 exe」**:装了两套宿主时那会挑中错的那个。
12+
- **「(无输出)」的根因是 stderr 被扔掉(`consumeHeadlessStream`)**:原来 `proc.stderr.on("data", () => {})` 一行注释「诊断进 stderr,不影响结果」就完了——而 headless 起不来时真正的原因(缺 credential、NO_ADAPTER、模块解析失败、CLI 路径不存在)全在 stderr,stdout 一个字都没有。现在收 stderr 尾巴(4 KiB,够一条栈顶报错、不至于把几万行 usage 端上来),失败时优先用它拼 reason;环境级判据也同时看 stdout + stderr。**只做诊断、不参与成败判定**:stderr 有输出不代表失败。
13+
- **找不到 CLI 时把试过的路径全列出来**:只报「找不到」的话,用户连自己装的是哪种布局都不知道(报告者只能靠读源码猜)。reason 里带完整候选清单,并指明 `DSH_CLI_JS` 这个人工出口;新增 CLI 旗标 `--dsh-cli <路径>`(走环境变量接线,不再造一条平行的传参链)。
14+
- **`--dsh-exe` 不再污染进程环境**:原来写进 `process.env.DSH_EXE` 就不还了,同一进程里后续每次定位都继承旧值(面板切仓库还是那个 exe),属于会记很久的脏状态。改成 `try/finally` 还原。
15+
- **可测性**:三种定位(exe / cli.js / spawn)全部做成可注入参数(`makeHeadlessRunner({ spawn, locateExe, resolveCli })`)——布局差异只有真机上看得见,**不能测的东西迟早会错**,这条 issue 就是证明。
16+
- **验证**:`test/wiki-t1.test.js` 新增 7 例(此前 235 行全是 stub runner,定位层零覆盖):新布局压过旧布局、只有旧布局仍认、`DSH_CLI_JS` 压过一切、全不中时 `verified:false` 且候选清单完整、`locateDshExe` 认 `DSH NEXT.exe` 与标准安装位且不瞎猜、stderr 尾巴进 reason(不再 `(无输出)`)、`--dsh-exe` 轮后 env 还原;`test/wiki-t0.test.js` 的 CLI 解析用例补 `--dsh-cli`。全量 3183 用例 / 3182 通过 / 0 失败 / 1 跳过。
17+
- **仍未验证的边界**:本机装的是旧布局,**新布局分支只有假目录树覆盖、没在真 DSH NEXT 上跑过**——报告者的实测(换 `lib/desktop-cli.js` 后 T1 立刻正常,packages-host 72 秒 / 18 条 claims)是这条分支唯一的外部证据。
18+
719
- **自动刷新不再静默丢掉语义段:有富化页就整轮拒绝,宁可没刷也不能白刷**。`chorographyAutoRefresh` 开着的时候,打开一个仓库看到「代码有变」会顺手跑一次 T0 重建骨架——而 T0 apply 的既定语义是「保留 CHORO:HUMAN 块、整页重写、清空 claims」(`src/wiki/t0.js:215-251`)。也就是说:用户只是点开一页想看看,那些花了几十秒模型时间富化出来的架构/约定/技术栈段落连同 claims 锚点一起没了,而且没有任何一处拦一下。T0 自己其实一直有清点(`collectT1Loss`),只是那份清点只写进回执 warnings,没人拿它做决定。
820

921
- **为什么整轮拒绝而不是跳过那几页(`src/wiki/t0.js`)**:`store.replaceChoroGraph` 是单事务的整仓替换。只保留几页的话,会留下「页面上有 T1 正文、库里 claims 已被清空」这种半截状态——比干脆不写更糟,因为面板从此对这几页显示「有结论但零条证据」,也就是 `inconsistent`,用户完全不知道怎么修。签名加 `guardT1Loss = false`,命中时抛 `ChoroRefusal("would-drop-t1")`,消息里带页数与前三页名,并指明「确实要重建骨架请在面板里手动点『重建骨架』」——**把决定权交回用户,但这次是显式的一次点击**。
@@ -245,7 +257,7 @@
245257
- **三重上限在 NDJSON 事件流上增量计数**(工具调用 / 输出字节 / 墙钟,超限即刻 kill):这里有一个实测坑——初版每个数据块都把整个累积 buffer 重扫一遍,tool_call 被平方级重复计数,11 秒就撞 40 上限的假象;改成按「已计行数」增量扫描。事件形状以 V1 实测为准(`tool_call` 与 `tool_result` 成对,只数前者;最终答案取 `final.text`)。
246258
- **输出契约同过同拒**(P16):章程要求只输出一个 JSON 对象;解析失败或 claims 的 `sourcePath` 不在该模块文件清单里 → 该轮 failed、**一条 claims 都不落**——编造的锚点比没有更伤。首跑真实会话就是这条契约拦下了跨模块引用(`../../tools/build-client.mjs`),章程收紧(跨模块结论写进段落文字、不带锚点)后重跑通过。
247259
- **失败记账(P17/P18)**:`choro_pages.fail_count` 列(addColumn 幂等迁移),连续两次到阈值标 `failed`(骨架原样保留),`--retry-failed` 可拉回、成功清零;**环境级失败(起不来 / MISSING_CREDENTIAL)≠ 页失败**——整档中止、页状态与计数都不动,receipt 带原因。
248-
- **exe 定位**:`DSH_EXE` 环境变量 > `--dsh-exe` > 进程自身 > 标准安装位;cli.js 在 app.asar 内部,**不能 existsSync 校验**(CLI 是普通 node,没有 asar 支持;exe 自己加载没问题,V1 实测)。
260+
- **exe 定位**:`DSH_EXE` 环境变量 > `--dsh-exe` > 进程自身 > 标准安装位;cli.js 在 app.asar 内部。~~不能 existsSync 校验(CLI 是普通 node,没有 asar 支持)~~ —— **这条断言已作废,见 Unreleased 里 issue #578 那条**:它对 CLI 子进程成立,但探测发生在插件进程里,Electron 的 fs asar 补丁让 existsSync 可用。
249261
- **边界如实声明(P22)**:headless 工具集由宿主管,章程里「只读、不修改文件」是软约束不是安全边界;T1 的硬保证是——人发起(CLI 显式 `--t1 --apply`)、本进程写路径断言在 `.chorography/**`、越界动作 git diff 可见。
250262
- **真实冒烟**(dsh-baleen src-client,池模型 deepseek-v4.1-flash):29s 富化完成、四段全出、33 条 claims 锚点文件存活率 33/33。模型工具路由是 CLI flag(P21:T1 只手动触发,不进 config schema)。
251263
- **重跑 T0 不许静默吞掉语义段**(M2 补洞):T0 重建整页时按 P19 丢弃富化层是设计意图,但**不说一声才是 bug**——实测在 dsh-baleen 上重跑 `--apply`,enriched 页退回 skeleton、`choro_claims` 清空,而 `.chorography/evidence/*.json` 留成孤儿,全程零提示。现在 T0 在 dry-run/apply 之前先清点(页内 `<!-- CHORO:T1:START -->` 计数 + evidence 下 `.json` 计数),命中就进 `warnings` 并在 receipt 带结构化 `t1Loss: { pages, orphanEvidence }`;清点只读,不改字节、不删 evidence,页已退回骨架后自动不再报警(免得变成常驻噪音)。T1 的两个标记因此收进 `src/wiki/render.js`(与 `CHORO:HUMAN` 同住)——写的人是 t1.js,读的人还有 t0.js。

‎dsh-mneme/bin/dsh-mneme-choro.mjs‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,7 @@ const USAGE = `${BIN_NAME} — 仓库地志(chorography):T0 确定性骨
3838
--timeout <秒> T1 单模块墙钟上限(缺省 240s)
3939
--retry-failed 把 failed 页拉进来重试(T1;成功后计数清零)
4040
--dsh-exe <路径> DeepSeek Harness 主程序定位(缺省走 DSH_EXE / 标准安装位)
41+
--dsh-cli <路径> 直接指定 headless CLI(缺省自动探测两种安装布局)
4142
--db <path> memory.db 路径(缺省 ~/.dsh/memory/memory.db,前导 ~ 会展开)
4243
--json receipt 用机器可读 JSON 输出
4344
-h, --help 本帮助
@@ -58,7 +59,7 @@ function parseArgv(argv) {
5859
else if (arg === "--json") flags.json = true;
5960
else if (arg === "--t1") flags.t1 = true;
6061
else if (arg === "--retry-failed") flags.retryFailed = true;
61-
else if (arg === "--module" || arg === "--model" || arg === "--dsh-exe") {
62+
else if (arg === "--module" || arg === "--model" || arg === "--dsh-exe" || arg === "--dsh-cli") {
6263
const next = argv[i + 1];
6364
if (next === undefined || next.startsWith("--")) {
6465
throw new Error(`${arg} 需要一个参数`);
@@ -143,6 +144,9 @@ async function main() {
143144
if (flags.t1) {
144145
// T1 档(M2):缺省 dry-run 只列候选模块与章程预览(零会话零写入);
145146
// --apply 才真开会话花钱。三重上限与降级表在 createT1 里。
147+
// --dsh-cli 走环境变量而不是新参数:探测层(resolveCliJs)本来就认 DSH_CLI_JS,
148+
// 再加一条平行的传参链只会让「两种说法哪个赢」变成新的坑。
149+
if (flags["dsh-cli"]) process.env.DSH_CLI_JS = flags["dsh-cli"];
146150
const t1 = createT1({ store });
147151
const receipt = await t1.runT1({
148152
repoRoot: repoPath,

0 commit comments

Comments
 (0)