dsh-over-ssh 0.1.0 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 DSH（DeepSeek Harness）第三方插件：把 VSCode Remote-SSH 式的远程开发做进 DSH —— 连接管理（密钥 / 密码 / ProxyJump / `~/.ssh/config` 导入）、远程文件（**无同步**直读直写）、远程终端、远程工作区、远端 `@` 补全、上传/下载，并支持"本地根 + 远端根"同处一个工作区。
 
-设计依据：[`doc/01-product/02-技术设计-SSH远程开发插件.md`](doc/01-product/02-技术设计-SSH远程开发插件.md)（v0.2）。需求依据：[`doc/01-product/01-需求分析-多根工作区-远程根-会话管理.md`](doc/01-product/01-需求分析-多根工作区-远程根-会话管理.md)（v0.4）。文档知识库入口：[`doc/README.md`](doc/README.md)。
+设计依据：`doc/01-product/02-技术设计-SSH远程开发插件.md`（v0.2）。需求依据：`doc/01-product/01-需求分析-多根工作区-远程根-会话管理.md`（v0.4）。文档知识库入口：`doc/README.md`。
 
 ## 安装
 
@@ -45,11 +45,11 @@ shell:
 
 | 平台 | 字节 | sha256 |
 |---|---|---|
-| linux-amd64 | 4,907,168 | `08998e6f51bc1a3759a966e96263c380f81f4281f2a50b0257b61f12b1341c3b` |
-| linux-arm64 | 4,653,216 | `0e19b3e77590f233093c09a7adc20487d721407bf805a9f879a756c9f03b9a11` |
+| linux-amd64 | 4,927,648 | `4f47307e4927e39972ebad9c2f25b3676e990ff1335b72ee33c3e8ec25a1e2cf` |
+| linux-arm64 | 4,653,216 | `9c1895ca3310a8fe5aed13a281cbdd98fe95928c24848ba58fea509b5f7341e6` |
 
-- 代理版本：`1.7.0-0ae8c02`
-- 源码提交：`0ae8c02`（Go 仓 `dsh-over-ssh-agent` 的这个提交）
+- 代理版本：`0.2.0-2dc1feb`
+- 源码提交：`2dc1feb`（Go 仓 `dsh-over-ssh-agent` 的这个提交）
 - 清单原文：包内 `agents/agent-manifest.json`
 - 核对：`sha256sum agents/<平台>/dsh-over-ssh-agent` 与上表比对；按上面的提交检出 Go 仓后
   `scripts/check.sh` 可重建同样的产物。
@@ -61,7 +61,7 @@ shell:
 - **传输层自研**，不使用核心 `packages/ssh/*` 家族。原因见设计文档 §3.1：官方实现的 `BatchMode=yes` 让密码认证不可能、远端必须预装 Node + helper、`ctx.ssh` 单例、且其 Web 集成需单独实现（preset 的 `isolate` 子树覆盖不到 `agent.ctx`）。
 - **文件按路径路由，进程不路由**：核心 provider 的公开方法收不到 agent/session 身份，因此 fs 用自研路由 provider 支持"本地 + 远端多根"，而 bash/终端保持单一执行世界，远端命令走显式入口。
 - **远端零安装（Tier 1，地板）**：只依赖远端已有的 POSIX 工具（`sh`/`base64`/`stat`/`find`/可选 `git`/`rg`），连上后做一次能力探测并按能力降级。
-- **可选 Go 代理（Tier 2，增强）**：独立仓库 [`../dsh-over-ssh-agent`](../dsh-over-ssh-agent)，纯静态单文件（随包产物的体积与摘要以 `agents/agent-manifest.json` 的 `bytes`/`sha256` 为准，交叉编译矩阵见 [`../dsh-over-ssh-agent/doc/05-benchmarks/baseline.md`](../dsh-over-ssh-agent/doc/05-benchmarks/baseline.md)；零第三方依赖），经 ssh stdio 通信（不监听端口），补齐原生监听/索引/长任务/远端 LSP/Landlock 围栏。决策见 [`doc/03-decisions/0005-optional-go-remote-agent.md`](doc/03-decisions/0005-optional-go-remote-agent.md)；代理不可用时一律回退 Tier 1。
+- **可选 Go 代理（Tier 2，增强）**：独立仓库 `../dsh-over-ssh-agent`，纯静态单文件（随包产物的体积与摘要以 `agents/agent-manifest.json` 的 `bytes`/`sha256` 为准，交叉编译矩阵见 `../dsh-over-ssh-agent/doc/05-benchmarks/baseline.md`；第三方依赖 4 个，全部经 ADR-0008 授权），经 ssh 通信（stdio 或常驻 daemon 的 unix socket，**不监听 TCP 端口**），补齐原生监听/索引/长任务/远端 LSP/Landlock 围栏。决策见 `doc/03-decisions/0005-optional-go-remote-agent.md`；代理不可用时一律回退 Tier 1。
   - **默认尝试部署**（2026-10-13 起，审计 0040）：连接的默认传输是 `agent`，首次连接会把代理装到远端 `$HOME/.cache/dsh-over-ssh/dsh-over-ssh-agent`（约 4.7 MiB / 4,907,168 B，以 `agents/agent-manifest.json` 为准，`0700`），失败自动回退 Tier 1。想避开远端写入就显式写 `transport: alias`。
   - **密码认证同样可用**：代理经系统 ssh 启动，而系统 ssh 靠 `SSH_ASKPASS` 助手取密码（秘密只经环境变量传递，不落盘）。此前"密码认证无法用代理"的说法是把本插件硬写 `BatchMode=yes` 误当成了 SSH 的限制。
   - 随包只带 `linux-amd64` 与 `linux-arm64` 两个产物；其它平台的远端会正常降级到 Tier 1。
@@ -71,13 +71,15 @@ shell:
 
 ```
 src/
+  index.ts fs.ts file-references.ts   # 三个 DSH 入口（组合根）
   host/
     domain/        # 纯 TS、零框架依赖、100% 单测覆盖
-    app/           # 应用层用例（依赖抽象）
+    app/           # 应用层用例（根路由、传输服务、状态）
     infra/         # 传输/后端/缓存/持久化实现
     integration/   # 与核心对接：fs provider、fileReferences、tools、Remote API、终端 wrapper
-    client/        # web client 半（React + TS + CSS Modules）
-tests/             # 每个模块一个独立测试文件
+  client/          # web client 半（React + TS + CSS Modules）——与 host/ 是兄弟目录
+  shared/          # 两半共用的纯工具（路由常量、根键等）
+tests/             # 镜像 src/ 的测试树（每模块一个 *.test.ts；根级只留 architecture/config 两个横切用例）
 ```
 
 ## 测试
@@ -91,7 +93,7 @@ npm run typecheck # 需要先安装 devDependencies（typescript）
 
 约定：**一个源文件对应一个 `tests/<同名>.test.ts`**；领域层与基础设施层不依赖核心包，因此测试无需安装 `@deepseek-ai/*`。
 
-当前数字只在 [`doc/05-benchmarks/baseline.md`](doc/05-benchmarks/baseline.md) 维护，本文不重复抄录。抄录的副本会与基准不一致，这类不一致在本仓库已经出现过。要现在的数字就跑命令：
+当前数字只在 `doc/05-benchmarks/baseline.md` 维护，本文不重复抄录。抄录的副本会与基准不一致，这类不一致在本仓库已经出现过。要现在的数字就跑命令：
 
 ```sh
 node --test --test-concurrency=4 "tests/**/*.test.ts"        # 正确性：用例数与失败数
@@ -108,13 +110,13 @@ npm run agents                                               # 随包代理清
 
 见设计文档 §13：M0 spike（三个未验证假设）→ M1 传输与连接管理 → M2 路由 fs → M3 远端搜索与 `@` → M4 文件树与传输 → M5 远程终端 → M6 会话管理 → M7 性能与内存回归。
 
-当前进度（本仓库内）：只列最近三条，更早的里程碑见 [`doc/06-audits/README.md`](doc/06-audits/README.md) 的历史记录表。
+当前进度（本仓库内）：只列最近三条，更早的里程碑见 `doc/06-audits/README.md` 的历史记录表。
 
 - [x] **改名 `dsh-over-ssh`**：仓库目录、Go module、二进制、状态目录、两个回收站、HTTP 路由共 11 处名字统一，
-  已有数据走 4 条一次性迁移（远端旧代理目录不删）。见 [`0110`](doc/06-audits/0110-rename-to-dsh-over-ssh.md)。
-- [x] 阶段 2 的「添加目录」按**会话**隔离。同一工作区开两个会话时，A 加的目录 B 既看不到也用不了；fork 出来的会话继承父会话的目录，老数据（无 `sessions` 字段）保持工作区级不打断。会话身份由 `AsyncLocalStorage` 从工具派发带到 `ctx.fs`（平台只给 fs 传 `cwd`）。GUI 文件面板、`glob`/`grep` 与隐式会话根三处残余面已写明。见 [`0108`](doc/06-audits/0108-per-session-root-isolation.md)。
-- [ ] 阶段 2 的「一键接管」开关尚不可用。审计 0095 的实现有宿主异步清单、行标识与回滚缺陷，不安全的逐行写入路径已移除，面板只显示状态与手动配置提示。平台的单行管理 API 不能保证四行批量原子切换或精确恢复原有 profile 覆盖，要等可靠的批量事务与还原机制可用并通过真实组合验证后才能启用。见 [`0096`](doc/06-audits/0096-takeover-safety-correction.md)。
-- [x] 阶段 2 的会话工作目录根。活会话 cwd 自动成为会话作用域、隐藏、纯内存的本地根；`resolve`/`lstat` 失败时同步一次再重试。真机端到端未跑。见 [`0094`](doc/06-audits/0094-session-workspace-root.md)。
-- [x] 卸载不等于关闭。用时间区分重注册与真关闭：`surfaceDetached()` 推迟一个任务、`surfaceAttached()` 取消，调度可注入，策略离线可测。见 [`0091`](doc/06-audits/0091-unmount-is-not-close.md)。
+  已有数据走 4 条一次性迁移（远端旧代理目录不删）。见 `0110`（`doc/06-audits/0110-rename-to-dsh-over-ssh.md`）。
+- [x] 阶段 2 的「添加目录」按**会话**隔离。同一工作区开两个会话时，A 加的目录 B 既看不到也用不了；fork 出来的会话继承父会话的目录，老数据（无 `sessions` 字段）保持工作区级不打断。会话身份由 `AsyncLocalStorage` 从工具派发带到 `ctx.fs`（平台只给 fs 传 `cwd`）。GUI 文件面板、`glob`/`grep` 与隐式会话根三处残余面已写明。见 `0108`（`doc/06-audits/0108-per-session-root-isolation.md`）。
+- [ ] 阶段 2 的「一键接管」开关尚不可用。审计 0095 的实现有宿主异步清单、行标识与回滚缺陷，不安全的逐行写入路径已移除，面板只显示状态与手动配置提示。平台的单行管理 API 不能保证四行批量原子切换或精确恢复原有 profile 覆盖，要等可靠的批量事务与还原机制可用并通过真实组合验证后才能启用。见 `0096`（`doc/06-audits/0096-takeover-safety-correction.md`）。
+- [x] 阶段 2 的会话工作目录根。活会话 cwd 自动成为会话作用域、隐藏、纯内存的本地根；`resolve`/`lstat` 失败时同步一次再重试。真机端到端未跑。见 `0094`（`doc/06-audits/0094-session-workspace-root.md`）。
+- [x] 卸载不等于关闭。用时间区分重注册与真关闭：`surfaceDetached()` 推迟一个任务、`surfaceAttached()` 取消，调度可注入，策略离线可测。见 `0091`（`doc/06-audits/0091-unmount-is-not-close.md`）。
 
-并行轨道（独立仓库 [`../dsh-over-ssh-agent`](../dsh-over-ssh-agent)）：协议、文件原语、索引与搜索、watch、proc、LSP、Landlock 围栏均已实现，多会话与常驻 daemon 分四阶段完成。当前状态、未做项与实测数字见该仓库的 [`README.md`](../dsh-over-ssh-agent/README.md) 与 [`benchmark`](../dsh-over-ssh-agent/doc/05-benchmarks/baseline.md)。
+并行轨道（独立仓库 `../dsh-over-ssh-agent`）：协议、文件原语、索引与搜索、watch、proc、LSP、Landlock 围栏均已实现，多会话与常驻 daemon 分四阶段完成。当前状态、未做项与实测数字见该仓库的 `README.md`（`../dsh-over-ssh-agent/README.md`） 与 `benchmark`（`../dsh-over-ssh-agent/doc/05-benchmarks/baseline.md`）。

package/agents/agent-manifest.json

@@ -1,19 +1,19 @@
 {
   "version": 1,
-  "generatedAt": "2026-11-01T13:33:43.884Z",
-  "agentVersion": "1.7.0-0ae8c02",
-  "sourceCommit": "0ae8c02",
+  "generatedAt": "2026-11-04T23:44:48.795Z",
+  "agentVersion": "0.2.0-2dc1feb",
+  "sourceCommit": "2dc1feb",
   "artifacts": [
     {
       "platform": "linux-amd64",
       "path": "linux-amd64/dsh-over-ssh-agent",
-      "sha256": "08998e6f51bc1a3759a966e96263c380f81f4281f2a50b0257b61f12b1341c3b",
-      "bytes": 4907168
+      "sha256": "4f47307e4927e39972ebad9c2f25b3676e990ff1335b72ee33c3e8ec25a1e2cf",
+      "bytes": 4927648
     },
     {
       "platform": "linux-arm64",
       "path": "linux-arm64/dsh-over-ssh-agent",
-      "sha256": "0e19b3e77590f233093c09a7adc20487d721407bf805a9f879a756c9f03b9a11",
+      "sha256": "9c1895ca3310a8fe5aed13a281cbdd98fe95928c24848ba58fea509b5f7341e6",
       "bytes": 4653216
     }
   ]