From 20fc751587ec652138ddd4f64cd6b7ffd1394297 Mon Sep 17 00:00:00 2001 From: QQ Date: Wed, 11 Nov 2026 22:35:57 +0800 Subject: [PATCH] Import vendor/dsh-remote-ssh/CHANGELOG.md --- vendor/dsh-remote-ssh/CHANGELOG.md | 1224 ++++++++++++++++++++++++++++ 1 file changed, 1224 insertions(+) create mode 100644 vendor/dsh-remote-ssh/CHANGELOG.md diff --git a/vendor/dsh-remote-ssh/CHANGELOG.md b/vendor/dsh-remote-ssh/CHANGELOG.md new file mode 100644 index 0000000..76e84bb --- /dev/null +++ b/vendor/dsh-remote-ssh/CHANGELOG.md @@ -0,0 +1,1224 @@ +# Changelog + +本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照(`pkg-N`)。 + +## [2.4.45] — 2026-11-06 + +### 修:远程工作区里在侧栏编辑器改文件「保存不上」(issue #37) + +**现象**(报告者,better-sidebar v0.28.0):远程工作区打开一个文件,在侧栏「文件」编辑器里改完, +点 √ 或 Ctrl+S 都保存不上 —— 远端文件内容不变。 + +**根因**:better-sidebar 的保存走的是**原始路由** `POST /sidebar/write`(0.25 起 `/sidebar/api` 里 +已经没有 `fs.write` 这个"方法"),而本插件此前只接管了 `/sidebar/api/*`(`fs.*` / `git.*`)与 `/sidebar/file`。 +于是保存写进了**本地镜像**那一份:编辑器认为成功,下一次读(走 SSH)又拿回远端旧内容。 + +**修法**: + +- 客户端(fetch 包装,与已有的上传改投同一处)把「镜像路径的保存」改投本插件的 `POST /remote-ssh/write`; + **本地工作区完全不经过这段代码**,行为零变化; +- 服务端按远端文件**原格式**落盘:保留 UTF-8 BOM、按原文件的多数行尾还原 CRLF/LF(编辑器只送 LF, + 直接写回会把 CRLF 文件整篇变成 LF); +- `expectedMtimeMs` 对**远端** mtime 做乐观锁(不一致回 `409 fs-conflict`,编辑器提示重载; + 带基线但文件已不存在同样 409,不静默重建);`fs.read` 现在返回 `mtimeMs`(远端秒级 ×1000), + 编辑器因此第一次真正拿到基线; +- 非 UTF-8(GBK / UTF-16 / UTF-32)**明确拒绝**,绝不用 UTF-8 覆盖老编码文件; +- 写完同步本地镜像、失效远端读/树缓存、作废写回护栏 B 的记录;单次保存上限 32 MiB。 + +**验证**: + +- 新增 `tests/sidebar-write-route.test.mjs`(49 条):格式探测 / 编码真值表、乐观锁 409、BOM / CRLF 保留、 + 镜像同步与缓存失效、GBK 拒绝、写失败 / 超限 / 信任 / 方法错误、接线断言、2 条变异负向控制; + `tests/trust-fence.test.mjs` 的调用点计数随新路由更新(6→7 / 5→6)。 +- 新增 `scripts/verify-remote-write-route.mjs`(参数化真机 E2E,真实 sshd + 真实 bash):**14/14 通过** —— + CRLF 还原、BOM 保留、409 冲突且文件一字未改、GBK 拒绝且字节完好、新文件创建、幽灵文件不静默重建。 +- 全量 **43 文件 / 2325 断言 / 0 失败**。 + +**未做(诚实记录)**:没有在 GUI 里真按一次保存(需要运行中的宿主 + 远程工作区会话), +真机证据走的是「真实处理器 + 真实 sshd」这条链路;`/sidebar/archive`(侧栏打包下载)仍读本地镜像那一份, +本版未处理;`/sidebar/upload` 的远端化在 2.1.5 起就有。 + +## [2.4.44] — 2026-11-03 + +### 修(2.4.43 复测收尾):按停止键 / `remote_ssh_kill` 现在会终止**远端**进程(issue #35 复测) + +**现象**(报告者真机复测,本机同版本复核一致):2.4.43 让停止键在秒级返回了,但只断开了本地 ssh —— +远端命令继续跑完(`sleep 60` 的 `END` 在 turn 结束后才写日志,`ps` 里仍有孤儿进程);`timeoutMs` 超时同样只是放弃等待。 +语义上「按停止」≈「关终端」,应当终止远端。 + +**根因**:取消只 `dropSession()`(本地 ssh 退出),远端 bash 及其前台子进程收不到任何信号。 + +**修法**: + +- 池化会话建连时先写一条探针 `printf '\002RSSHPID%s\002\n' "$$"`(比任何排队命令都先执行),从 stdout 解析后 + **剥离标记**并记下远端 shell 的 PID(池化 bash 是会话首进程,PID = PGID = SID);断线重连清空重探, + 远端非 bash 时超长缓冲即放弃(退化为旧行为); +- 取消(abort 分支)与 `remote_ssh_kill` 都用**独立一次性通道**发 `kill -HUP -`(短超时 4s, + **绝不复用已取消的 `exec.signal`**),并与本地停稳**并行**,不额外拖长取消返回; +- 用 **SIGHUP** 而非 SIGTERM:与关终端一致,`nohup` / `setsid` 起的任务照常存活; +- 超时 / 断连**不**发 HUP —— 文档写清「取消 = 终止;超时 = 仅放弃等待」。 + +**验证**: + +- 新增 `tests/remote-hup.test.mjs`(42 条):探针写入 / 解析 / 剥离 / 只探一次 / 重连重置、`hupRemoteGroup` 短路与独立通道、 + runPooled 与 kill 的接线顺序、工具描述与两份 README 的语义断言、4 条变异负向控制; + `tests/cancel.test.mjs` 增 8 条(取消发 HUP、PGID 未知传 0、超时不发、HUP 慢也不拖长返回)。 +- 真机 E2E(`scripts/verify-remote-hup-group.mjs`,真实 sshd):池化 shell `PID=PGID=SID`;仅杀本地 ssh → 远端 `sleep` 存活; + `kill -HUP -` → 前台 `sleep` 消失、`nohup` 后台任务存活。全部通过。 +- 全量 **42 文件 / 2276 断言 / 0 失败**。 + +**未做(诚实记录)**:没有在 GUI 里真按一次停止键验证(需要运行中宿主 + 真实 profile); +本轮证据是真实函数沙箱 + 真机 sshd 上「探针 + 进程组 HUP」这条链路的实测。 +`remote_ssh_sync` / `remote_ssh_push` 的远端 `tar` 未单独发 HUP(管道两端终止后远端 tar 会因 EPIPE 自行退出);如需强制清掉远端 tar,用 `remote_ssh_kill` 或在远端手动处理。 + +## [2.4.43] — 2026-11-03 + +**协作式取消(issue #35):`remote_ssh_*` 工具现在真的能被「停止键」停下。** + +**现象**:DSH 的取消是**协作式**的 —— 注册表不与工具 promise 竞速,工具必须观察 `exec.signal` 并在自有工作停下后才返回。 +2.4.42 及以前本插件全文件 `exec.signal` 出现 **0 次**:按停止键只把 turn 标记为取消,实际仍要等远端命令自己结束。 +默认超时下最多多等 120 s / 10 分钟;而 README 推荐长任务用 `timeoutMs: 0`,一旦这么用等待就**没有上限**, +唯一的手动兜底 `remote_ssh_kill` 本身也是一次工具调用 —— 同一 turn 卡住时按不到。报告者用 `sleep 60` 实测:连按 4 次停止键,工具仍耗 60.053 s。 + +**根因与修法**(`lib/index.js`): +- `withTimeout()` 增第 5 参 `signal`:取消以 `isAbort` reject,**先 reject 再** `onTimeout`(丢弃会话)—— 顺序反了的话, + terminate/close 顺带 settle 的 `done` 会抢在 race 之前落地,把「取消/超时」误报成「命令自己失败了」(测试 F2/F8 就是抓这个的);settle 时摘掉监听器 + (`exec.signal` 的生命周期比单次调用长,监听器泄漏会让下一次 abort 误触发旧回调)。 +- `runRemote()` / `runPooled()` 增尾参 `signal`;取消走 `isAbort` 分支,**绝不回退到一次性连接** —— 否则会把刚被用户停掉的命令 + **再执行一遍**(与 issue #5「超时不重试」同一条不变量)。丢弃会话后各给 ≤3 s 停稳窗口(`CommandSession.close()` 会立刻 reject 挂起的 exec)。 +- `toolContext()` 带出 `exec.signal`;新增 `signalRunner(signal)` 把信号绑进 runner:`ls` / `cat` / `write` / `grep` / `glob` / `sync` 经 runner 的 helper + 无需改签名就获得取消能力,`exec` / `mkdir` / `delete` / `move` 直接透传第 8 参。 +- `runTarPipe()`(sync / push 的 tar 管道)增 `signal`:取消时两端 `terminate()`,等停稳后返回 `isAbort`,调用方保留「本地镜像未改动」的既有语义。 +- **返回值净化**:`isAbort` 是内部标记。`exec` 型工具走 `normExec()`(只挑 schema 里的字段),`sync` / `push` 走新增的 `stripAbort()`, + 普通失败也不挂该字段 —— 否则 `additionalProperties: false` 会把「取消」判成 `returned invalid output`。 + +**验证**:新增 `tests/cancel.test.mjs`(86 条)—— withTimeout 四种形态与监听器摘除、runRemote(一次性连接)与 runPooled(池化会话)的 +预取消 / 取消中 / **取消不回退重跑** / 超时仍不回退 / 真失败仍回退且信号透传、runTarPipe 取消、`signalRunner` 与 `toolContext` 透传、 +返回值净化(schema 合法)、 +11 个走 SSH 的工具接线,另含 3 条变异负向控制(删掉 abort 分支 / 把 ls 改回裸 runner → 断言必须变红)。 +全量 **41 文件 / 2226 断言 / 0 失败**(本机,含下面的 issue #36 回归);`tests/sync-safety.test.mjs` 的两条静态断言同步接受 `signalRunner` 形态。 + +**未做(诚实记录)**:GUI 里按停止键的真机 E2E 未做 —— 需要真实 profile + 运行中的宿主,而本机桌面 profile 仍是 2.4.41; +取消行为目前由「真实函数 + 可编排假会话/假管道」的沙箱覆盖。 + +### 修(同版本第二项):Windows 用户名含非 ASCII 字符 → 密码认证 100% 失败(issue #36) + +**现象**:Windows 用户名是中文(报告者 `宜川联社`,`%USERPROFILE%` = `C:\Users\宜川联社`)时,password 认证的连接「测试连接」与所有 +`remote_ssh_*` 工具一律失败;stderr 里是 `ssh_askpass: posix_spawnp: No such file or directory` + `Permission denied (publickey,password)`, +而界面提示却在说「公钥认证失败,请检查 keyPath」—— 方向完全带偏。 + +**真机复现(本机 OpenSSH_for_Windows_9.5p2,与报告者同版本)**:`ssh-keygen -p` 改口令时由 OpenSSH 亲自调用 askpass, +同一份字节相同的助手脚本、只改路径: + +| `SSH_ASKPASS` | 结果 | +|---|---| +| `…\中文目录\askpass.cmd` | 失败:`CreateProcessW failed error:2` + `ssh_askpass: posix_spawnp: No such file or directory` | +| `…\ascii\askpass.cmd` | 成功:`Your identification has been saved with the new passphrase.`(exit 0) | + +**根因**:Windows OpenSSH 用**窄字符路径**启动 askpass(`CreateProcessW` / `posix_spawnp`),路径含非 ASCII 字符时助手根本不会执行 → +ssh 把**空口令**发给服务端 → 服务端只回 Permission denied。插件此前把助手写在 `~/.dsh/remote-ssh/askpass.cmd`,中文用户名下必然命中; +`%TEMP%` 也在 `%USERPROFILE%` 下面,同样不能当替代落点。 + +**修法**(`lib/index.js`): +- `ensureWindowsAskpass()` 改为按 `ProgramData\dsh-remote-ssh` → `Public\dsh-remote-ssh` → 用户目录(旧位置,仅当整条路径 ASCII 时)回退, + 落盘前用 `isAsciiAskpassPath()`(`/^[\x20-\x7E]+$/`)校验;文件名按 `sha256(home)` 前 12 位区分用户, + 内容仍是不含口令的两行脚本(无 BOM / CRLF / 第二行补换行)。 +- 支持环境变量 `DSH_REMOTE_SSH_ASKPASS` 显式指定纯 ASCII 目录下的助手(覆盖内置落点;值非 ASCII 时忽略并回退)。 +- 全部落点都不可用时 `sshArgv()` **抛明确错误**(给出「设环境变量 / 改用密钥认证」两条出路),不再让 ssh 发空口令后报一个误导性的公钥失败。 +- `sshErrorHint(text, p)` 改为**按认证方式归因**,并先识别 `ssh_askpass` / `posix_spawnp` / `CreateProcessW` 证据:密码连接不再输出 + 「公钥认证失败 / 检查 keyPath」,而是点名 askpass 与非 ASCII 路径;key 连接的原有归因(私钥缺失 / authorized_keys / 用户名写法)保持不变。 + +**验证**:新增 `tests/askpass-ascii.test.mjs`(39 条)—— 落点选择与回退(ProgramData 优先 / 不可写回退 Public / 全非 ASCII → `ascii:false` / +环境变量覆盖 / 非 ASCII 覆盖被忽略)、助手内容(无 BOM、CRLF、两行、不含口令)、按用户分文件名、`sshArgv` 抛错文案、 +诊断归因(askpass 证据 / 密码拒绝 / key 连接三条回归)、源码接线,以及**真机 OpenSSH E2E** 三条:中文路径复现失败 → 同字节 ASCII 路径成功 → +插件落点被真实 `ssh-keygen` 接受。`tests/password-auth.test.mjs`(29 条)同步改为在新落点上验证助手的口令保真。 +全量 **41 文件 / 2226 断言 / 0 失败**(本机)。 + +**未做(诚实记录)**:没有中文用户名的 Windows 机器,「设置 → 远程连接 → 测试连接」的真机 GUI E2E 未做;本次用 `ssh-keygen` 走的是 +OpenSSH 内部同一条 askpass 通路(同一 `read_passphrase` → `posix_spawnp`),因此能证明「助手能被启动且口令正确回传」, +但不能替代一次真实 sshd 密码登录。 + +## [2.4.42] — 2026-11-02 + +### 修:better-sidebar 0.28.2 新增的 `git.history` 未接管 —— 远程工作区翻历史读的是本地镜像(upstream-drift 报红) + +**现象**:`upstream-drift` 流水线(每周把 `dsh-better-sidebar@latest` 装进假 profile 跑全量对拍)在 2026-11-02 报红:`sidebar-0250-endpoints.test.mjs` 的 C9 对拍断言 `缺: git.history`(该文件 104 通过 / 1 失败;全量 38 文件 / 1985 通过 / 1 失败)。本机装 0.28.2 后逐条复现一致。 + +**根因**:上游 0.28.2(2026-10-27 发布)新增端点 `git.history` —— 提交图在分支数超过上限(`graph-limit`)时,客户端会**回落到它继续翻页**。本插件只接管到 0.28.0 的 `git.graph`,`git.history` 未注册 → 请求回落到上游实现,而远程工作区里上游用的是会话 cwd(本地镜像目录):翻出来的历史来自镜像仓库(通常为空或滞后),与 2.4.18 / 2.4.28 / 2.4.32 同源的静默失效。 + +**修法**:按上游口径接管(`lib/index.js` 新增 `gitHistoryPage` + `historyLocalIo` / `historyRemoteIo`,`GIT_METHODS` 追加 `history`): +- 入参 `{ count = 50, cursor? }`:`count` 安全整数且 ≥1、内部上限 200;`cursor` 为 `base64url(JSON{version:1,fingerprint,offset})`,`offset` 1..10000。 +- 取数:`log --branches --remotes HEAD --topo-order --no-decorate --no-show-signature --encoding=UTF-8 --max-count=limit+1 --skip=offset --format=… --`。 +- 前后各取一次「全量 refs(`for-each-ref` **不限** heads/remotes)+ HEAD + shallow 边界文件」快照算 sha256 指纹(与 `git.graph` 的指纹刻意分开算);期间历史变了 → `graph-stale`(409);refs > 100000 / shallow > 1 MiB / 翻页越过 10000 → `graph-limit`(400)。 +- 远端仍是**一次 SSH 往返**(快照 + log + 快照用标记分段),`root` 回映射成本地镜像路径,远端目录不在时回 `isRepo:false` 而不是 500。 +- 条目形状与 `git.graph` 一致,但 `refs` 恒为 `[]`(上游 history 不做引用装饰)。 + +**验证**:新增 `tests/sidebar-0282-history.test.mjs`(75 条:A 本地契约/参数/指纹/游标/8 类错误码,B 远端脚本标记与每页 2 次往返,C 真实临时仓库的分页闭环 + 真过期检测 + 多分支,D 接线断言与上游 handler 键集合对拍);`tests/sidebar-0250-endpoints.test.mjs` 增加 C2b(`GIT_METHODS` 含 `history`)。全量 39 文件 / 2098 断言 / 0 失败(`tests/perf-remote-open-2433.test.mjs` 的 C2 也已从「2 处 git 通道」更新为「3 处」)。另加 `scripts/verify-remote-history-script.mjs`(25 条,WSL 真 sh + 真 git):直接跑 `historyRemoteIo` 生成的那段脚本,覆盖标记分段、`--skip` 真分页、真过期、NOREPO、**浅克隆的 shallow 边界文件(`case`/`wc -c`/`base64` 三段)**、多分支与中文 `%B` —— 假 SSH 出口看不出的 POSIX 问题只有这里能抓到(25 通过 / 0 失败)。 + +**顺带修掉一处流水线自身的脆弱**:`tests.yml` 对拍的钉版是 0.26.1(没有 `git.history`),而新测试里「上游确实有 `git.history`」是硬断言 —— 2.4.42 发布提交的首跑因此红了(2059 通过 / 1 失败,`upstream-drift` 同一提交却全绿)。改为**「上游有而本插件没接管」才判红**(钉旧版 → 打印 SKIP 而不是失败),并补两向对照 D7/D8(旧上游不要求接管、上游多出未知端点必须精确报缺)。`tests.yml` 的钉版 0.26.1 → 0.28.2 暂缓:本机 gh token 没有 `workflow` scope,改 workflow 文件会被 GitHub 拒绝(`refusing to allow an OAuth App to create or update workflow`);钉旧版现在也不会误红(判据是「上游有而本插件没接管」),要升只需先 `gh auth refresh -s workflow`。 + +## [2.4.41] — 2026-10-27 + +### 修:DSH 0.1.5 / 0.1.6 线上「连接列表恒为空、导入与保存都无效」(issue #34,举报人 EmptyVessel-000) + +**现象**:DSH 0.1.5-rc.3 上,设置 → 远程连接永远显示「还没有连接配置」;「从 ~/.ssh/config 导入」与手动保存都没反应,`remote_ssh_profiles` 恒回 `profiles: []`,`settings.yaml` 里不落任何东西。 + +**根因**:判据只看接口存不存在 —— `if (svc && typeof svc.describe === "function" && typeof svc.update === "function")`。0.1.5 / 0.1.6 的 settings **同时**具备 `register()` 与新三件套 `configure` / `describe` / `update`,但那一代还没把 loader 行的 Config 注册成 settings 命名空间,于是误走新分支:`describe()` 看不到本插件(读恒空)、`update()` 抛 `settings namespace "remote-ssh" is not registered`(写必失败)——「导入」退化成纯 UI 动作。这是 issue #16 的镜像:那边是 0.1.7 拿掉了 `register`,这边是 0.1.5 还没开始用 entry 命名空间。 + +**修法**:新增 `settingsApiMode(svc, entryId)` 三态判定(`new` / `legacy` / `config`)。两套接口都在时**只有 `describe({ redactSecrets: false })` 真能看到本插件命名空间才走新路径**,否则走 `register(ns, schema)` 旧路径(读写落 `settings.yaml` 的 section,升级前存下的旧数据可直接读到);探测抛错按 `legacy` 处理,绝不静默当新版。另外给 `register()` 加了 try/catch:万一它抛(命名空间已被别处注册 / 服务实现又变了),退到只读 config 并打一行 warn,插件照常挂载(连接列表能看、改不动),而不是让 `apply()` 抛错、整个插件不加载。 + +**验证**:新增 `tests/settings-api-mode.test.mjs`(25 条):三态与边界(两套都有但读不到 / 读得到 / 只看到别的 ns / 探测抛错 / 接口不完整 / svc 缺失)、0.1.5 现场语义(`update()` 抛 `not registered` 时仍判 legacy)、命名空间比对用 **entry id**、探测带 `redactSecrets: false`、接线断言,以及**变异负向控制**(把判定改回「两套都算新版」→ A3 / C8 必须变红)。全量 38 文件 / 2022 断言 / 0 失败。 + +## [2.4.40] — 2026-10-25 + +### 修:密码认证从未真正可用(所有平台)——`redactSecrets: true` 在运行时抹掉了口令(PR #33,贡献者 LPLS1zhang) + +**现象**:`authMethod: password` 的连接保存密码后永远连不上:连接测试 / 文件面板 / 模型工具全部挂起 120 秒后超时,或在 POSIX 上报 sshpass 相关错误。所有密码连接在所有平台上均受影响(不是 Windows 独有)。 + +**根因**(三层叠加): + +1. **运行时读不到口令(核心)**:`createNewSettingsFace` 用 `svc.describe({ redactSecrets: true })` 读设置 —— 密钥字段被脱敏成空值,于是 `sshArgv()` 里 `p.password` 永远为空、`sshpass` 前缀从未被拼上。ssh 在管道上等待密码提示,永不返回 → 120s 超时。 +2. **Windows 没有 sshpass**:README 能力矩阵写明「密码认证需本机 sshpass(POSIX)」,Windows 无解。 +3. **失败静默化**:`CommandSession` 的 `h.done` 失败分支只置 `alive = false`、不 reject 排队命令 —— 可执行缺失(如 sshpass ENOENT)时命令挂到超时而不是立即报错。 + +**修法**: + +1. **脱敏移到边界**:settingsFace 以 `redactSecrets: false` 读(运行时需要明文口令拼子进程);新增 `publicProfiles()` —— `listProfiles` / `saveProfile` / `deleteProfile` / `remote_ssh_profiles` 等一切对外出口只回 `passwordConfigured` 布尔,不再回明文(比原先 redactSecrets 的覆盖面更宽:连 API 边界都不出)。 +2. **Windows 原生密码通道**:新增 `ensureWindowsAskpass()` —— 在 `~/.dsh/remote-ssh/` 写一个两行的 `askpass.cmd`(`@ 维护者补充:环境变量命名为 `RSSH_ASKPASS_PW`(不用 `DSH_` 前缀 —— 那是 `dsh-subprocess` 保留给宿主事实的命名空间,将来若收紧过滤会让口令通道静默失效);`sshArgv()` 返回类型改为 `{ argv, env }` 后,`sync-safety` / `unicode-names` / `tool-output-schema` 三个测试桩已同步适配;Windows 上密码认证不再需要 `sshpass`(POSIX 仍需要)。 + +**验证**:新增 `tests/password-auth.test.mjs`(26 条):settingsFace 明文读取与边界脱敏、`sshArgv` 平台分流(Windows env 注入 / POSIX sshpass / 缺口令抛错 / tty 豁免)、密码留空保留旧值、fs 拦截 profileId 路由、askpass 助手幂等/无 BOM/元字符保真/尾换行。`tests/settings-compat.test.mjs` 的 redactSecrets 断言同步更新(`true` → `false`)。真机端到端:密码连接的连接测试 / 远程工作区文件面板 / 目录浏览 / 文件读取 / 池化会话(stdout/stderr 分离)全部通过。 + +## [2.4.39] — 2026-10-25 + +### 修:壳层删掉工作区后设置里留残条目 / 再添加同一工作区会重复 / 删重复条目连坐删会话行(issue #32,举报人 ZhanRuiXin) + +**现象**(2.4.37,报告原文三段): + +1. 在工作区(壳层侧)里删除工作区后,插件**设置面板**里对应的条目还在; +2. 之后再添加**同一个**远程工作区,设置里出现两条一模一样的条目; +3. 删除其中一条重复条目时,会话栏里那条(还在用的)工作区行也跟着消失。 + +**根因**(三件事各自独立,但会互相喂大): + +1. **删除没有联动**:壳层的「删除工作区」最终走 `workspaceRegistry.delete(id)`(`@deepseek-ai/dsh-api-workspace-controller` 的 delete 处理器),而本插件的设置条目只在自己那套 API 被调用时才删。于是壳层删完,配置里留下一条永远不会自愈的孤儿条目。 +2. **建区不去重**:`createRemoteWorkspace` 每次都生成新记录 id + 新镜像目录并 `push`。上面那条孤儿条目还在时再添加同一「连接 + 远程路径」,就得到两条内容相同、镜像目录不同的记录 —— 设置面板里看起来完全一样。 +3. **删除会连坐**:`cleanupWorkspace` 只按镜像路径反查就删原生工作区。两条重复条目一旦指向同一原生实体(或用户分不清点错),删一条就会把另一条还在用的会话行一起删掉。 + +**修法**: + +1. **挂上删除联动**(`installNativeDeleteSync()`):包一层 `workspaceRegistry.delete(id)` —— 原生删除成功后,按落盘的 `shellWorkspaceId` 精确清掉配置里的对应条目(老记录没有 id 时按镜像路径反查兜底),并 rm 掉该条目的镜像目录。只包一次(幂等标记),服务对象不可写时静默放弃(退化成"手动删条目",不影响其它能力)。 +2. **建区接管旧条目**:`createRemoteWorkspace` 先按「profileId + remotePath」找旧记录;命中则**接管**它(沿用原 id、原镜像目录、原同步范围与写回护栏,只更新标题与 `shellWorkspaceId`)并返回 `reused: true`,不再 `push` 新记录。既根治重复条目,也不丢镜像里没推回去的本地改动。 +3. **删除前判共用**:新增 `sharingEntryOf()` —— 其它条目还引用同一镜像目录/原生 id 时,`cleanupWorkspace` 一律不动原生工作区、也不 rm 镜像目录。`deleteWorkspace` 先摘掉本条再判共用,顺序明确。另外清理时优先用 `workspaceRegistry.get(shellWorkspaceId)` 精确删,取不到才退回按路径反查。 + +**验证**:新增 `tests/workspace-delete-sync.test.mjs`(42 条)覆盖:共用保护正反例、精确优先/路径兜底、联动清条目+清镜像、挂钩子幂等与原实现仍生效、服务不可写时静默放弃、建区接管(id/镜像/护栏/同步范围全部保留)与不同路径正常新建、源码接线,以及 `getPrefs` 的 `deleteSync` 自检位(重启后不走 UI 也能确认钩子挂没挂上)。全量 **36 文件 / 1971 通过 / 0 失败**。 + +`tests/settings-sync-scope-ui.test.mjs` 的建区范围断言同步更新为「显式参数 > 旧记录 > 全局默认」三层优先级(接管旧条目时不能把用户设好的范围重置回默认)。 + +## [2.4.38] — 2026-10-24 + +### 修:重启后 `shellWorkspaceId` 会过期,导致远程工作区角标不再出现(2.4.37 的后续) + +**现象**:2.4.37 上线当天真机暴露 —— 新建的远程工作区记录里存着原生工作区 id,但 DSH 重启后壳层那侧的原生注册没保住(`workspace.json` 里没有这一行),记录里的 id 就指向一个**已不存在**的实体。角标按行键找行,自然一行都对不上;而旧实现"有 id 就跳过",于是永远不会自愈。 + +**修法**:`reconcileShellWorkspaceIds()` 从「缺了才补」升级为「每次列表都核对」,三种情况都覆盖: + +1. 没有 id(老记录)→ 按镜像路径反查回填(2.4.37 已有); +2. **id 变了**(原生工作区被重建)→ 跟上真实 id; +3. **原生工作区已不存在**(重启丢注册 / 用户删了)→ **清空**,客户端退回标题匹配,绝不拿一个不存在的 id 去猜行。 + +反查抛错时保持原值(宁可慢一拍,也不要把好 id 清掉)。结果一致时**不写盘**,所以常态开销只是每个工作区一次内存反查,settings 不会被反复抖。 + +**验证**:`tests/workspace-shell-id.test.mjs` 扩到 25 条(新增 B/B2:常数开销、漂移自愈、消失清空、异常保值的持久化断言);全量 **35 文件 / 1927 通过 / 0 失败**。 + +## [2.4.37] — 2026-10-24 + +### 修:同名本地项目被误标成远程工作区(🌐)(issue #31,举报人 ZhanRuiXin) + +**现象**:新建一个与已有本地项目**同名**的远程工作区后,那个**本地**项目也被打上了地球角标(🌐)。 + +**根因**:地球角标是客户端半边做的 DOM 装饰(壳层没有 per-workspace 图标 API,只能找到工作区行、往行首文件夹 svg 里追加一组经纬线)。旧实现**只按行标题文本**认行 —— 两个项目同名时文本完全一样,于是本地项目也命中。举报人给的猜测("可能是按项目名称匹配导致的")完全正确。 + +**修法**:改用壳层自带的行键。`@deepseek-ai/dsh-client-ui-workspace` 渲染的每个工作区行都带 `data-row-key="workspace:<原生工作区 id>"`,而 `workspaceView()` 把 `workspaceId` 直接取成注册表实体的 `id`(与 `workspaceRegistry.resolveByPath()` 返回的 `id` 同一空间)。于是: + +1. **宿主侧**:`createRemoteWorkspace` 建区时把原生工作区 id 落进记录(`shellWorkspaceId`);老记录没有这个字段,`listWorkspaces` 会按**镜像路径**反查 `workspaceRegistry.resolveByPath()` 回填一次并持久化 —— 幂等,全部就绪后零额外 IPC、零额外写盘;反查失败只是留空(客户端自动退回标题匹配),不影响列表可用性。 +2. **客户端**:按行键精确匹配后打标;标题匹配**只作为旧壳层回退**,且同名行不止一行时**都不标**(宁可漏标,绝不误标)。 +3. **反向自愈**:升级前被误标的行,只要扫描到它不属于远程工作区就摘掉角标,不必等 React 重渲染。 +4. **局部子树重渲染不退回标题猜**:见过行键的壳层此后只按行键判断(避免标题 span 重建时的那一小块被重新误标)。 + +**验证**: + +- `tests/workspace-globe-rowkey.test.mjs`(新增,28 条):同名本地行不标 / 远程行照标 / 箭头槽位不误加 / 幂等 / 反向自愈 / 局部子树不误标 / 旧壳层同名不标 / 自检字段。 +- `tests/workspace-shell-id.test.mjs`(新增,18 条):按镜像路径回填、幂等不写盘、反查抛错不炸、缺 registry/mirrorPath 跳过、三处接线。 +- 全量 **35 文件 / 1920 通过 / 0 失败**。 +- 真机复核口径:本机唯一远程工作区的镜像目录在壳层工作区存储里对应 id ``;升级后 `listWorkspaces` 返回的 `shellWorkspaceId` 应等于该 id(即行键 `workspace:` 能对上壳层真实行)。 + +## [2.4.36] — 2026-10-21 + +### 修 2.4.35 回归:没有远程镜像的普通路径丢了 not-found 语义(issue #30,举报人 hugo2046) + +升级 2.4.35 后,在**没有** `/.dsh/skills` 与 `/.agents/skills` 的项目里,技能全部消失:系统提示里没有 ``,`skill` 工具对任何技能都报 `unknown or no longer available`;`~/.dsh/skills` 本身完好,重启无效,换回 2.4.34 立刻恢复。 + +根因(举报人定位,我复核一致):2.4.35 的读影子层在"本地不存在"时回远端取,而**该路径不在任何远程工作区镜像里**时,读取器返回的内部错误是 `FS_IO_ERROR`,包装层又把它原样抛给调用方 —— 于是本地原本的 not-found 被换成一句中文 IO 错误。`@deepseek-ai/dsh-skill-filesystem` 只把 `FS_NOT_FOUND / ENOENT / FS_NOT_DIRECTORY` 当作"这个根不存在",其余一律按 provider 失败处理;`@deepseek-ai/dsh-tool-skill` 又有 `if (!snapshot.complete) return decision;`,结果是**整份技能目录一条都不注入**。绝大多数项目没有项目级技能目录,所以第一次 `listDir` 必踩,与用户装了多少技能无关。受影响的不止技能:任何依赖 `ctx.fs` not-found 语义的消费者(例如读一个不存在的本地文件)都会拿到错误码而不是 not-found。 + +修法两步: + +1. 读取器新增专有码 **`NO_MIRROR`** 表示"该路径没有远程工作区镜像",不再冒充 `FS_IO_ERROR`; +2. 包装层的 `readText` / `streamText` / `readBytes` / `readByteRange` / `listDir` 统一走 `localFirst()` 收尾:**凡"远端也拿不到"(无镜像 / 远端也没有 / 连接失败)都退回本地原始错误**,语义与 2.4.34 完全一致;只有"远端确实取到了内容"之后才可能出现的语义错误(`FS_NOT_TEXT` / `FS_TOO_LARGE` / `FS_ABORTED`)照旧透出。有镜像但连接失败时留一条 `warn`(可诊断,不静默)。 + +现场复现(本机,2.4.35 运行中):`~/.dsh/skills` 下有 12 个技能目录、会话 cwd 无项目级技能目录 → `skill image-gen` 报 `skill "image-gen" is unknown or no longer available`,与举报人描述一致。修复后单测覆盖同一调用链(本地 not-found + 无镜像 → 抛本地错误、码为 `FS_NOT_FOUND`);发布并重启后复验技能恢复。 + +回归测试:`tests/fs-read-bridge.test.mjs` **+19 条**(5 个读方法在无镜像时都抛回本地原始错误、码保持 `FS_NOT_FOUND`、且不打警告;连接失败仍退本地错误但留 warn;`stat` / `lstat` 返回 `undefined`;`resolve` 抛原错;远端二进制仍透出 `FS_NOT_TEXT`;合成 target 不把内部码泄给消费者)。全量 **33 文件 / 1874 通过 / 0 失败**。 + +## [2.4.35] — 2026-10-20 + +### 内置预览读不到"只在远端存在"的文件(issue #29,举报人 zijun-T) + +远程工作区里「文件」页签能列远端、右键下载正常、编辑器打开也正常,唯独点某个文件「预览」报 **「文件不存在,可能已被移动或删除」**;同一路径右键下载拿到的内容却是对的。举报人自己把根因定位到了:那句文案来自**内核内置**的 `dsh-client-ui-sidebar-documentpreview`,它把 `workspace-file/not-found` 映射成这句话;而提供该码的 `dsh-api-workspace-files` 的全部 I/O 都走进程内的 `ctx.fs`(`resolve` / `lstat` / `stat` / `readBytes` / `readByteRange` / `streamText` / `listDir`),它的 `workspaceRoot` 取的是**本地镜像目录** —— 镜像里没有的文件,`lstat` 就返回 `undefined`,`locateFile` 随即抛 not-found。预览走 RPC 而不是 `/sidebar/*` HTTP 路由,所以 2.4.27 / 2.4.28 那套 `exact` 路由拦截**够不着它**(与 #10 的 `fileReferences` 同属"进程内服务"这一面)。一句话:**这是 #15「read 仍读镜像」在内置预览上的另一面**,不是路径解析 bug。 + +修法即举报人建议的方案 1:给 `ctx.fs` 的读方法加一层**影子**,原则是「**本地优先,本地缺失才回远端**」。 + +- 每个包装方法**先调原实现**:`stat` / `lstat` 有结果、读方法没抛错,就原样透传 —— 本地工作区、镜像里已有的文件、沙箱围栏、错误码、版本号全部保持旧行为(零回归;`tests/fs-read-bridge.test.mjs` 用假 fs 断言"本地有 → 一次远端调用都没有")。 +- 只有"本地不存在"(`stat` / `lstat` 返回 `undefined`、读方法抛 `FS_NOT_FOUND` / `ENOENT`)才回远端取:`stat` / `lstat` 用**一次往返**的条目探测(类型 + `size:mtime`,符号链接单独给 `symlink`),整文件读复用既有的合并读命令(base64 载荷 + stat 帧),区间读复用 `fs.readPage` 那条 `tail -c` 窗口命令,目录列举复用 `remoteListDir`(命中 treeCache,不多花往返)。 +- 远端也没有时**原样返回原实现的结果 / 抛原实现的错**,绝不伪造"存在";确实是远端文件时才合成 `FsTarget`(WeakSet 标记),`contains` / `processPath` / `fileUrl` 对合成 target 走 `displayPath`,不把伪造的 key 递给原生后端(`workspace-file` 的目录围栏因此不会误杀)。 +- 错误码与后端同一套:二进制 → `FS_NOT_TEXT`、超 4 MiB → `FS_TOO_LARGE`、连接失败 → `FS_IO_ERROR`、已取消 → `FS_ABORTED`。 +- 与 2.4.14 的写桥各包各的方法、互不覆盖;两者的恢复函数都做"当前函数是否仍是我自己的包装"的身份校验。 + +仍未覆盖(已写进两份 README 的「已知限制」):① 远端被改动、而镜像里也有旧版本时读到的仍是**镜像**那份(本地优先;`remote_ssh_sync` 重拉即最新);② `ctx.fs.watch` 对远端影子是空实现,远端变更**不会**触发实时刷新,预览不会自动跟新;③ 远端整文件读受 4 MiB 单次上限约束。 + +复现与验证:举报人的自查命令(远端 `ls` 有、镜像 `ls` 没有)+ 代码路径核对(documentpreview → workspace-file RPC → `ctx.fs` → 本地 fs-sandbox)。**本机拿不到 GUI 的 token URL,无法自动点预览**,所以真机验证由重启后的宿主 + 举报人复核补上(届时把实据追加到 `MAINTENANCE.md` §0,格式同 2.4.33 / 2.4.34)。 + +回归测试:新增 `tests/fs-read-bridge.test.mjs` **87 条**(A 条目探测命令与标记解析;B 读取器三态 / 整读 / 区间读 / 列举 / 连接异常;C 桥的本地优先、远端兜底、合成 target、错误码、安装恢复;D 接线与包装方法集合覆盖 `workspace-files` 实际调用的 12 个方法)。全量 **33 文件 / 1851 通过 / 0 失败**。 + +## [2.4.34] — 2026-10-20 + +### 同步范围终于有了 GUI 入口(issue #28,举报人 yanghuan) + +`syncPaths` / `syncExclude` / `syncMaxBytes` 是 #20 就落地的**后端**能力:schema 有字段、`updateWorkspace` 能写、`syncOptsFrom` 有「逐次参数 → 工作区字段 → 全局默认」三级回退。但**客户端一个入口都没有** —— 设置面板只管 `writeBack` / `writeBackExclude`,「添加工作区」固定只传 `profileId + remotePath`,于是新工作区永远是 `syncPaths: []`。后果不是"少个功能",而是把安全阀变成陷阱:`remotePath: ~` 的工作区空范围 = 整树 tar,2 GiB 体积哨兵当场拒绝;用户只能每次直调 `POST /remote-ssh/api/updateWorkspace`、或手改 `cordis.patch.yml`(举报人两条都试过,都是应急)。本次四项: + +- **工作区卡片:同步范围 / 同步排除 / 体积上限**三个输入框(体积界面按 GiB 填,宿主存字节)。保存仍是**一次** `updateWorkspaceGuards` 原子写 —— 写回护栏与同步范围一起落库,不会只改一半。语义:`undefined` = 不动、`[]` / `0` = 显式清空(回到整树 / 内置 2 GiB)。 +- **「添加工作区」弹窗:可选同步范围**。只传非空值;留空交给「全局默认」,再留空才是整树 —— 建区即定范围,不必建完再补一遍。 +- **全局默认(进阶设置)**:`defaultSyncPaths` / `defaultSyncExclude` / `defaultSyncMaxBytes` 进 `PrefsSchema`,`savePrefs` 白名单扩展、`getPrefs` 回读;三个 settings face(新版 `describe` / 旧版 `register` / 只读 `config` 兜底)的 `read()` **都**回这三个默认值 —— 少一处就会在旧版 DSH 上显示成空。 +- **手动「⬇ 同步 / ⬆ 推送」按钮**:复用已有 `syncDown` / `syncUp` 端点(走该工作区的持久化范围),把 client 里闲置已久的 `sync.*` 文案接上。同步/推送是显式点击,不必"叫模型跑一下"。**不新增任何路由**(接管清单仍是 31 条)。 + +### 归一化:一处拆分、一处解析,不让脏值进 tar 命令行 + +新增两个纯函数并在宿主所有入口统一使用: + +- `normalizeSyncList`:数组或「逗号 / 换行 / 分号分隔」整串 → `trim` + 去空 + 去重。**空串必须丢** —— `tar --exclude=""` 会命中一切,这是 #20 踩过的坑;重复项只会让命令行无谓变长。 +- `parseSyncMaxBytes`:字节数,或 `2 GiB` / `512MB` / `1.5GiB` 这类带单位写法(`GiB` 走 1024、`GB` 走 1000);非法 → `null`,由调用方回落默认。 + +`updateWorkspace` 也改走同一套(原来的 `parseInt("2 GiB")` 会得到 `2` 字节)。手调 HTTP 传整串、传数组、传带单位字符串,都不会写进脏数据。 + +### 兼容性 + +老配置没有这三个字段 → schema `default([])` / `default(0)` = **旧行为不变**(整树 + 内置 2 GiB 上限)。所有新逻辑只在「传了值」时生效;`updateWorkspaceGuards` 既有调用方(只传 `writeBack` / `writeBackExclude`)行为完全不变。 + +### 回归测试(新增 84 条;全量 1763 通过 / 0 失败) + +`tests/settings-sync-scope-ui.test.mjs`:①归一化与解析的**行为**(抽真实函数跑,不是看代码里有没有写);②schema 与三个宿主入口(含「只有传了才写」的负向控制);③三处 `read()` 都回默认值;④客户端控件 / 弹窗 / 手动按钮 + 中英文案各恰好一份;⑤`splitList` / `bytesToGibText` / `gibTextToBytes` / `prefsForUi` 的行为。**G 段把 `updateWorkspaceGuards` / `savePrefs` 的真实函数体抽出来、注入假 `settingsFace` 执行** —— 验到 `syncPaths` 真的落库(trim + 去重 + 拆整串)、`undefined` 不改原值、`[]`/空串清空、乱填体积归 `0`(不写 NaN)、工作区不存在报错、白名单外的键不写。`tests/settings-compat.test.mjs` 同步把两个新 helper 纳入 `eval` 沙箱 —— 漏了会整文件 CRASH(本次已修)。 + +### 复现证据(对运行中的 2.4.33 宿主,只读 + 一次无副作用重写) + +`POST /remote-ssh/api/listWorkspaces`:3 个工作区的 `syncPaths` / `syncExclude` 全为 `[]`、`syncMaxBytes` 全为 `0`(即全部整树同步,与举报人描述一致)。对其一发 `updateWorkspaceGuards` 并显式带上 `syncPaths: [".dsh"]` / `syncExclude: ["data/"]` / `syncMaxBytes: 1048576` → 返回 `ok:true`,但回读**三个值分毫未变**:旧构建静默忽略这三个字段。⚠️ 探针注记:该接口返回 `{"ok":true,"value":{…}}` **信封**,直接读 `body.workspaces` 会误判成「0 个工作区」(第一次探测就是这么错的,与 §0 记录的同一个坑)。 + +## [2.4.33] — 2026-10-17 + +### 性能:远程打开目录/文件的耗时治理(实机测量驱动) + +运行中宿主 + 远程工作区(超算登录节点,高延迟公网链路,大仓库)的实测画像:热目录列举 **30ms**、热文件读取 **~150ms** 都很快;慢感来自三处 —— **远端 `git.status` 每次 1.6~3.7s**(大仓库 `status --untracked-files=all` + 两条全仓 numstat),而 0.28.0 客户端在文件操作后会 invalidate→立即重取同一仓库,把共享 SSH 会话队列堵死;**空闲 10min 关断会话**后下一次点击要重新付 ~1.7s 握手;高延迟链路上传输无压缩。本次四项修复(`tests/perf-remote-open-2433.test.mjs`,22 条断言 + 2 条变异负向控制): + +- **`git.status` 响应缓存(5s TTL + epoch 感知,仅远端分支)**:同仓库重复请求 0 RTT;任何写/删/移/exec/git 变更都 `bumpCacheEpoch` → 立即失效,缓存只在「没有任何写动作」的窗口内生效(与 readCache/treeCache 同一纪律)。本地分支不缓存(本机 git 是进程内子进程,本来就不是瓶颈)。 +- **numstat 短路(远端脚本)**:status 没有任何 tracked 变更(干净仓库 / 只有未跟踪文件)时,两条全仓 `git diff --numstat` 输出必然为空却各扫一遍整个工作树 —— 直接跳过,与本地实现 `pathspec=[]` 短路同口径。⚠️ N 计数必须在 `cat; rm` 之前 —— 这个时序 bug 是真 sh 验证逮住的(见下)。 +- **`git.*` 专用池化会话**:`runPooled`/`getSession` 增加 role 参数,status/graph/通用 git runner 走 `profileKey|git` 独立会话 —— 大仓库的数秒级 git 命令不再让点击目录/文件排队等它,代价是每个 profile 多一条按需建立、同受 ServerAlive 保活的连接。 +- **非 tty SSH 连接开启内建压缩(`Compression=yes`)+ 空闲窗口 10→30min**:文件树/文件读取的 base64/文本载荷在高延迟公网链路上压缩收益显著;tty 交互终端保持默认。空闲窗口拉长减少「回来点两下就重付 1.7s 握手」,死连接由 ServerAlive 90s 探活 + 255 重建兜底。 + +### 独立验证:真 sh + 真 git(16 条断言,含一个被逮住的真实 bug) + +`scripts/verify-remote-status-script.mjs`:WSL 真 `sh` + 真 git 2.43,真实现 `gitStatusRemote` + 真解析器(只把 `runPooled` 换成 `wsl -e sh -c`)。干净仓库(段缺席 → 空 entries 且分支身份齐全)、脏仓库(真 numstat 行数经真 sh 分段逐条对上:暂存 +1/-0、未暂存 +3/-1、真改名 origin、未跟踪无行数)、只有未跟踪(tracked=0 → 段缺席)、PATH shim 让 status 全变体失败(`$T` 不存在 → `${N:-0}` 兜底不炸)、非 git 目录/不存在的目录 → `isRepo:false`。**第一版脚本把 N 计数放在 `cat; rm` 之后**,`$T` 已删导致短路退化成"总是短路"、脏仓库行数全丢 —— 单测(伪造 SSH 出口)查不出这种运行序问题,真 sh 验证立即红,修正后全绿。 + +## [2.4.32] — 2026-10-17 + +### 兼容:better-sidebar 0.28.0(新增 `git.graph` 提交图端点 + `git.status` 响应形状漂移) + +上游 0.28.0 的 HTTP 派发表从 42 个方法增加到 43 个,**唯一新增的是 `git.graph`**(0.28.0 新增「Git Graph」提交图面板的取数端点);另有一处**已接管端点**的响应形状漂移(`git.status`)。这两件事都不会报错,只会静默给出旧/空的仓库视图 —— 与 2.4.18 / 2.4.28 修的是同一类问题:**没被拦截的端点会落在本地镜像上**。 + +- **新增接管 `git.graph`**(`GIT_METHODS` 18 → 19 项)。 + - 入参 `{branch?, count?, cursor?}`:`branch` 必须是 `refs/heads/…` / `refs/remotes/…` 全名;`count` 安全整数且 ≥1(内部上限 200);`cursor` 是 `base64url(JSON{version:1,fingerprint,offset})`。返回 `{isRepo, root?, entries[{hash,hashFull,parents,author,date,subject,message,refs}], branches[{ref,name,hashFull}], hasMore, nextCursor?, snapshot}`。 + - 分页游标锚在 **sha256 快照指纹**上(`for-each-ref` + `HEAD` + `symbolic-ref`,日志前后各取一次):分页期间历史变了 → `graph-stale`(**HTTP 409**);分支 >1000 或翻页越过 10000 → `graph-limit`(**400**)。这些 HTTP 码与上游逐条一致(此前本插件把业务错误一律映射 500)。 + - **远端分支**把 `root` 回映射成本地镜像路径:客户端把它当 `repoRoot` 用(`client.js` 里与树根标签比较),返回远端绝对路径会让它落到另一个分支上。远端仓库根在会话目录之下 → 映射成镜像内的对应子目录;在会话目录之上(工作区是仓库子目录)→ 退化成镜像根,保证跨页稳定。 + - **测试**:新增 `tests/sidebar-0280-git-graph.test.mjs`(**79 条断言**):本地分支逐条比对实参与返回形状(含 `%x00` 日志解析、装饰、`count` 上限、游标往返、指纹过期、未知分支、>1000 分支、非仓库、空仓库、`offset+limit>10000`);远端分支验证**只发远端、一次分页恰好 2 次 SSH 往返**、命令带只读环境、`root` 三种映射;最后用一个**真实临时 git 仓库**做端到端(真 `git log` 解析、真分页闭环、真过期检测、真空仓库、真非仓库目录)。 + +- **`git.status` 对齐 0.28.0 的响应形状**(本插件**已经接管**这个端点,所以此前是静默降级:既不报错也不提示)。 + - 取数从 `--porcelain=v1 -z` 换成上游同款 `status --porcelain=v2 --branch --ahead-behind -z --untracked-files=all`,并补齐 0.28.0 新增字段:`upstream` / `ahead` / `behind` / `detached` / `operation`(`merge` / `rebase`,按 `.git` 目录状态判定),以及条目级 `staged` / `unstaged` 行数(两条 `diff --numstat`;上游口径是**绝不合并**,因为合并会重复计行)、`truncated`(>2000 条截断)。 + - **有意差异(健壮性)**:`--ahead-behind` 需要 git ≥ 2.41,远程主机(尤其超算登录节点)可能更旧。本插件依次降级 **v2+ahead-behind → v2 → v1**,v1 路径明确缺新字段而不是给错值,面板不会因 git 版本整体失败。 + - **远端实现改成一次 SSH 往返**(`status` + `operation` + 两侧 `numstat` 同一条脚本,`@@DSH_GS@@` 分段;含 NUL 的 status 输出先落远端临时文件再 `cat`,**不经 shell 变量**——命令替换会吃掉 NUL)。旧实现是 3 次往返且永远拿不到新字段。远端 `numstat` 不带 pathspec(整仓),结果与本地同构、只是多算一点。 + - **远端目录不在(工作区被删/改名)→ `isRepo:false`,不再 500**:原来的 `cd || exit 3` 会让脚本以非 0 退出、被映射成 `git-error` 500(git 面板弹红字)。现在脚本自己打印 `NOTREPO` / `NOREPO`,与"目录存在但不是仓库"同一口径;真正的 SSH 失败仍照旧 500(不会被这条兜底吞掉)。 + - **测试**:新增 `tests/sidebar-0280-git-status.test.mjs`(**95 条断言**):纯解析器(v2 records/meta、改名 origin、二进制 `-\t-`、行框改名记法折叠、pathspec 的未跟踪排除与 >8000 字节兜底、截断);本地分支(新字段、`operation` 三态、**三条降级链**、只有未跟踪时跳过 numstat);远端分支(一次往返、脚本不捕获 NUL、NOTREPO/v1/none/SSH 失败四种结局、cd 失败必须给 NOTREPO 而不是 `exit 3`);真实仓库端到端(真 `ahead/behind=1/0`、真改名 `origin` 与非零行数、真二进制 `{binary:true}`、真 detached、真 merge-in-progress)。 + +### 独立验证:真 sh + 真 git(不是只有伪造 SSH 出口的单测) + +单测把 SSH 出口整个替换掉了,**脚本本身的 POSIX 正确性**(引用、标记、NUL 传输、shell 侧 `elif` 降级链)未被覆盖。本次另外在 **WSL 的真 `sh` + 真 git 2.43** 上,用真实现 + 真解析器 + 真 handler 跑了一遍(`runPooled` 换成 `wsl -e sh -c