dsh-over-ssh 0.2.2 → 0.2.4

package/README.md

@@ -19,6 +19,12 @@ npm i && npm run build
 dsh plugin --profile web add /绝对路径/dsh-over-ssh
 ```
 
+> **GUI 安装提示**：pnpm 会问是否允许安装脚本，列表里是 `ssh2` 与 `cpu-features`：允许后重试即可。
+> 它们是 `ssh2` 传输的可选原生加速，拒绝会让 pnpm 中止本次安装（插件源码本身没有安装脚本）。
+>
+> 0.2.2 及更早在运行中的页面上启用插件时出现过 `2 entries did not activate`（`workingDirectory` /
+> `fileReferences` 链）；0.2.3 删掉了那条私有域克隆链（审计 0134），不再需要为它重启。
+
 **远端终端**要额外配一次 `terminalController.Config.shell`——`Config.shell` 是静态单值，连哪台只能由 wrapper 运行时决定：
 
 | 装法 | 指向 |
@@ -35,6 +41,78 @@ shell:
 
 不配也能用，只是 Web 终端永远开在本地（远程文件、远端执行、`@` 补全不受影响）。
 
+## 0.2.4 更新
+
+> 下面这些内容相对 npm 上的 **0.2.3** 一起生效。
+
+### 传输与内存
+
+- transport lanes（审计 0164）：interactive/bulk/compute 分 lane（`limits.transportLanes`，失败回退 interactive）；job/LSP 按会话、watch 按会话（agentless 时连接级）使用 stateful lane（`limits.statefulLanes` 默认 8）；transfer stat 走 bulk；Go 在飞窗口从 8 提到 16；proc/LSP/index 按会话公平配额（含后来者预留名额）。
+- P6 读/解析分离：读协程只读原始帧，zstd 解压、JSON 解析与 blob 解压移出读协程；原始帧队列有界，慢盘/大 blob 不再阻塞同连接其它会话。
+- 修复 P6 读错误被 `readBlob` 消费后主循环永久阻塞；大帧解析后把 parser 缓冲降回 64 KiB；`#pollListings` 快照表加 64 条上限；并发上传的 stdin drain 监听器合并。
+- 修复重连 discard 期间 `releaseSession` 被忽略导致已删除会话 lane 复活；selector 抛错泄漏 lane 槽；watch 按会话分 lane 后会话删除会回收 `watch:<session>`。
+- 修复浏览后端 dispose 拒绝产生未处理拒绝；`#sendCancel` 写失败遗留 pending 槽。
+
+### 会话作用域与「添加目录」
+
+- 会话根按 `sessions` + `workspaces` 双重作用域过滤；带 `scopedForSession` 时，客户端仍按当前 workspace 过滤未限定行，dev 热修。
+- 工作区路径比较容忍尾斜杠与 Windows 大小写差异；真正切换会话/工作区时清空旧 roots，并复位卡片的 `open`/`browsing`。
+- 会话作用域修复覆盖：切会话/工作区不再显示上一条会话的目录；同 workspace 的两个会话按 session 隔离；fork 继承仍可见。
+
+### Agent / 子进程
+
+- 修复取消排队请求不生效：`sessionTable.Cancel` 摘除等待队列与 blob 队列，`dispatchMu` 覆盖出队+launch 与取消。
+- 修复子进程启动失败泄漏 fd：interactive `proc.start` 的 stdin，`rg`/`git status`/`git ls-files` 的 stdout，LSP stdout。
+- 修复 JSON 编码尺寸估算漏算 HTML 转义（`<`/`>`/`&`/U+2028/U+2029），避免含 `<` 的大输出被误判装得下而超帧。
+
+### 数据正确性与工具
+
+- `remote_read_many`：一次往返读多个文件（1..16，默认每文件 256 KiB），非 UTF-8 给 `binary`/`dataBase64` 与渲染警告；修复批量读总量上限与二进制截断一致。
+- `remote_project_summary`：一次往返给 git 状态、顶层结构、包清单、README 头与 test/build/lint 建议。
+- `remote_apply_patch`：一次往返多文件补丁，先全量校验，默认失败回滚。
+- `remote_exec` / `remote_job`：非 UTF-8 输出附带 base64 精确字节与渲染警告；`remote_job` 不再丢 exactBytes。
+- 协议 v3 zstd 跨帧压缩；`remote_grep` 支持 `offset`/`total`/`nextOffset` 分页；Tier 2 批量读走代理 `fs.readMany`。
+- LSP：`server` 支持带空格路径的引号切分、`lsp.read` 每轮 256 KiB、跨块多字节字符按 `exactBytes` 解析；卡片的初始焦点与 Tab 集合跳过不可见控件。
+- 文件引用补全：单来源失败只降级该来源；Windows 反斜杠路径参与排序；符号链接按目录处理，根内展开、根外只列链接；同根并发走查共享。
+- 端口转发：`net.probe` 远端预检，关闭端口在 start 阶段稳定失败；IPv6 `[::1]` 归一；旧代理没有 `net.probe` 时跳过预检继续。
+- 回收站与锁：父子还原、锁心跳、缺 `entryId` 行可见不可操作、已删连接编辑不再提交。
+- 会话管理页：修正短 id、工作区目录内联、行内回收站按钮、已选计数。
+
+### 其它修复
+
+- `remote_read_many`、`remote_exec`、`remote_job` 的二进制/截断/渲染一致性问题（审计 0160–0162）。
+- `writeFile` 非 Uint8Array 参数本地立即拒绝；`repo.summary` 只读普通文件；`patchMany` 超大文件先判大小；`fs.readMany` 先校验再起协程。
+- 主菜单/渲染修复：项目概览补顶层/清单/README、分页提示按 Tier 分档、`remote_grep` 真正分页、zstd 小帧只压缩一次。
+
+### 其它
+
+- 组合层仍为 6 个条目；本地写入围栏由平台沙箱执行。
+- 其余行为不变。
+
+## 0.2.3 更新
+
+> 下面这些内容相对 npm 上的 **0.2.2** 一起生效。
+
+- **热启用不再失败**：移除私有域里对平台 `@deepseek-ai/dsh-file-reference-local` 的克隆与 `localFileReferences` 桥：
+  根作用域的 `file-references` 本来就自己实现本地有界走查，那份克隆没有消费者。效果是启用插件时
+  不再出现 `2 entries did not activate`（`workingDirectory` / `fileReferences` 等待链），热启用可以直接
+  完成，不必为它完整重启。
+- 组合层因此只剩 6 个条目（原 8 个）：私有域只保留 `fs-sandbox` 克隆 + `localFs` 桥，本地写入围栏仍由
+  平台沙箱执行。
+- 文件引用补全复查（审计 0135）：单个远端来源失败只降级该来源，不再让整个 `@` 补全失败；缓存命中后
+  的取消仍按取消处理；Windows 本地根的反斜杠路径参与文件名/深度排序；符号链接目录按目录处理，只有
+  指向根内的链接会被展开（根外链接只列链接本身，不把工作区外的文件带进 `@`），并带环检测与 Windows
+  忽略目录大小写处理；打字快于一次走查时，同根并发调用共享一次树枚举、不再重复扫树（探针：6 次击键
+  = 1 次走查）。
+- LSP 复查（审计 0136）：`remote_lsp` 的 `server` 支持带空格的路径（引号切分，`"/opt/my tools/server" --stdio`，
+  未闭合引号明确报错）；宿主 `lsp.read` 每轮只取 256 KiB，不再吃满代理 2 MiB 默认块；客户端卡片的初始
+  焦点与 Tab 集合跳过不可见控件。
+- 回收站与锁（审计 0137）：索引记录父子关系，**还原父会话会连带还原子会话**（失败留在垃圾并回报）；
+  会话/回收站锁加心跳，跨设备大目录 copy 超过 60 s 也不会被当成陈旧锁抢走；缺 `entryId` 的回收站条目
+  现在可见但不可操作并说明原因；连接被删除后编辑对话框不再提交请求。
+- 构建：删掉的宿主入口产物会被清理，不再随包发出（0.2.3 首次打包曾多带一个 `local-bridge-refs.js`）。
+- 其余行为不变；远端 `@`、本地 `@`、文件工具、会话面板均未改动。
+
 ## 0.2.2 更新
 
 - 「添加目录」按会话作用域显示与删除，fork 子会话继承父会话的目录且立即可见。
@@ -54,11 +132,11 @@ shell:
 
 | 平台 | 字节 | sha256 |
 |---|---|---|
-| linux-amd64 | 4,944,032 | `d45237ef1bfec1955fb5e6a2391bd651ffeaffb89e781e1c518e9e9836eec974` |
-| linux-arm64 | 4,653,216 | `237a3cc9f5ae57f752f62eee4f8a57bd8c4684fd4d3fa6ab5851115baa844ccd` |
+| linux-amd64 | 5,591,200 | `c1b5e1ffcc9c7fd26e21140090dafec28f90a50fd3c5a3edb315d0165f84dc40` |
+| linux-arm64 | 5,243,040 | `524e8752ba5a63ac006d50f132f6286afa2ccfe55ed217d286e4ada361deea71` |
 
-- 代理版本：`0.2.2-e019f2d`
-- 源码提交：`e019f2d`（Go 仓 `dsh-over-ssh-agent` 的这个提交）
+- 代理版本：`0.2.4-a7e77fb`
+- 源码提交：`a7e77fb`（Go 仓 `dsh-over-ssh-agent` 的这个提交）
 - 清单原文：包内 `agents/agent-manifest.json`
 - 核对：`sha256sum agents/<平台>/dsh-over-ssh-agent` 与上表比对；按上面的提交检出 Go 仓后
   `scripts/check.sh` 可重建同样的产物。

package/agents/agent-manifest.json

@@ -1,20 +1,20 @@
 {
   "version": 1,
-  "generatedAt": "2026-11-06T16:15:01.747Z",
-  "agentVersion": "0.2.2-e019f2d",
-  "sourceCommit": "e019f2d",
+  "generatedAt": "2026-11-08T16:23:50.384Z",
+  "agentVersion": "0.2.4-a7e77fb",
+  "sourceCommit": "a7e77fb",
   "artifacts": [
     {
       "platform": "linux-amd64",
       "path": "linux-amd64/dsh-over-ssh-agent",
-      "sha256": "d45237ef1bfec1955fb5e6a2391bd651ffeaffb89e781e1c518e9e9836eec974",
-      "bytes": 4944032
+      "sha256": "c1b5e1ffcc9c7fd26e21140090dafec28f90a50fd3c5a3edb315d0165f84dc40",
+      "bytes": 5591200
     },
     {
       "platform": "linux-arm64",
       "path": "linux-arm64/dsh-over-ssh-agent",
-      "sha256": "237a3cc9f5ae57f752f62eee4f8a57bd8c4684fd4d3fa6ab5851115baa844ccd",
-      "bytes": 4653216
+      "sha256": "524e8752ba5a63ac006d50f132f6286afa2ccfe55ed217d286e4ada361deea71",
+      "bytes": 5243040
     }
   ]
 }

package/cordis.patch.yml

@@ -12,10 +12,14 @@
 #     ctx.fs             ← dsh-over-ssh/fs（多根路由）
 #     ctx.fileReferences ← dsh-over-ssh/file-references（多根 @ 补全）
 #
-#   私有域（isolate: fs / fileReferences）：
+#   私有域（isolate: fs）：
 #     ctx.fs             ← @deepseek-ai/dsh-fs-sandbox（**原版**，继续服务本地路径）
-#     ctx.fileReferences ← @deepseek-ai/dsh-file-reference-local（**原版**）
-#     两个 bridge 把域内实例以 localFs / localFileReferences 暴露给根作用域。
+#     一个 bridge 把域内实例以 localFs 暴露给根作用域。
+#
+#   文件引用**不再克隆平台实现**：根作用域的 dsh-over-ssh/file-references 自己实现了本地有界走查
+#   （见 integration/fs/file-reference-provider.ts），平台侧的 localFileReferences 没有任何消费者。
+#   2026-11-07 审计 0134 删掉了那条克隆链：它让私有域多等一个 workingDirectory 服务，而 DSH 热启用
+#   时这个依赖会短暂缺失，表现为「启用失败：2 entries did not activate」。
 #
 # 为什么是「接管」而不是「共存」：`ctx.fs` 是 Cordis 单例服务，同一隔离作用域只能有一个提供方，
 # 再注册第二个会抛 `service "fs" has been registered`。`isolate` 让原版实现能在私有域里继续跑，
@@ -24,8 +28,9 @@
 # 已实测的前提（cordis 0.2.1-rc.2）：域内 `fs` 解析到域内实例；根 `fs` 不受影响；可以同时存在多个域；
 # 根作用域的消费者能注入到域内 bridge 暴露出来的 `localFs`。任何一条不成立这套组合都不成立。
 #
-# 这两组行必须**同时**生效或同时不生效：只禁用核心行而不启用本插件的行，会让 `ctx.fs` /
-# `ctx.fileReferences` 无人提供，所有文件能力一起失效。
+# `ctx.fs` 与 `ctx.fileReferences` 两级都要有提供方：核心 fs-sandbox / file-reference-local 被本包
+# 禁用后，根作用域由 dsh-over-ssh/fs 与 dsh-over-ssh/file-references 接管；本地路径的写入围栏由私有域
+# 里那份原版 fs-sandbox 经 localFs 桥接执行。
 #
 # 还原：禁用整个 bundle。不要只删其中一行。
 #
@@ -57,19 +62,12 @@
       group: true
       isolate:
         fs: true
-        fileReferences: true
       config:
         - id: 远程工作区-平台沙箱副本
           name: '@deepseek-ai/dsh-fs-sandbox'
-        - id: 远程工作区-平台文件引用副本
-          name: '@deepseek-ai/dsh-file-reference-local'
-        # 两个 bridge 分开：file-reference-local 依赖 workingDirectory（在下游），不能和 fs 挤在同一行。
         - id: 远程工作区-桥接fs
           name: dsh-over-ssh/local-bridge
           inject: [fs]
-        - id: 远程工作区-桥接文件引用
-          name: dsh-over-ssh/local-bridge-refs
-          inject: [fileReferences]
 
     # 根作用域的提供方。两个入口都是「路由型」：本地路径与远端路径由同一套表分发。
     - id: 远程工作区-路由fs