dsh-over-ssh 0.1.1 → 0.2.1

package/README.md

@@ -45,11 +45,11 @@ shell:
 
 | 平台 | 字节 | sha256 |
 |---|---|---|
-| linux-amd64 | 4,907,168 | `08998e6f51bc1a3759a966e96263c380f81f4281f2a50b0257b61f12b1341c3b` |
-| linux-arm64 | 4,653,216 | `0e19b3e77590f233093c09a7adc20487d721407bf805a9f879a756c9f03b9a11` |
+| linux-amd64 | 4,944,032 | `fd5a5d6f8be07e786cc7c34a1aad8e2f040f1de3b7f124e739d2209df5ab5038` |
+| linux-arm64 | 4,653,216 | `202f4be3d1c1d98ccae27b9ccaa4879fa148c741981063f8be98689674b3ad2e` |
 
-- 代理版本：`1.7.0-0ae8c02`
-- 源码提交：`0ae8c02`（Go 仓 `dsh-over-ssh-agent` 的这个提交）
+- 代理版本：`0.2.1-e019f2d`
+- 源码提交：`e019f2d`（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`，纯静态单文件（随包产物的体积与摘要以 `agents/agent-manifest.json` 的 `bytes`/`sha256` 为准，交叉编译矩阵见 `../dsh-over-ssh-agent/doc/05-benchmarks/baseline.md`；零第三方依赖），经 ssh stdio 通信（不监听端口），补齐原生监听/索引/长任务/远端 LSP/Landlock 围栏。决策见 `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 两个横切用例）
 ```
 
 ## 测试

package/agents/agent-manifest.json

@@ -1,19 +1,19 @@
 {
   "version": 1,
-  "generatedAt": "2026-11-02T16:02:32.695Z",
-  "agentVersion": "1.7.0-0ae8c02",
-  "sourceCommit": "0ae8c02",
+  "generatedAt": "2026-11-05T23:45:29.528Z",
+  "agentVersion": "0.2.1-e019f2d",
+  "sourceCommit": "e019f2d",
   "artifacts": [
     {
       "platform": "linux-amd64",
       "path": "linux-amd64/dsh-over-ssh-agent",
-      "sha256": "08998e6f51bc1a3759a966e96263c380f81f4281f2a50b0257b61f12b1341c3b",
-      "bytes": 4907168
+      "sha256": "fd5a5d6f8be07e786cc7c34a1aad8e2f040f1de3b7f124e739d2209df5ab5038",
+      "bytes": 4944032
     },
     {
       "platform": "linux-arm64",
       "path": "linux-arm64/dsh-over-ssh-agent",
-      "sha256": "0e19b3e77590f233093c09a7adc20487d721407bf805a9f879a756c9f03b9a11",
+      "sha256": "202f4be3d1c1d98ccae27b9ccaa4879fa148c741981063f8be98689674b3ad2e",
       "bytes": 4653216
     }
   ]