From e5832aea081314ece8336f34e917f6ade31cb8cd Mon Sep 17 00:00:00 2001 From: flymysql Date: Fri, 20 Nov 2026 10:57:50 +0800 Subject: [PATCH 1/2] chore(release): prepare 1.3.0 with security hardening and host-aware forwards Ship the two security fixes (rw_download fence, machines.json 0600 + self-update dist.integrity), the junction/symlink mirror binding fix, the host-aware editable forwards, and the host-primitive UI unification. Version alignment: package.json, package-lock (root + packages[""]) and lib/client.js CLIENT_VERSION all move to 1.3.0 together. --- CHANGELOG.md | 15 +++++++++++++ docs/promote.md | 2 +- docs/release/1.3.0.md | 50 +++++++++++++++++++++++++++++++++++++++++++ lib/client.js | 2 +- package-lock.json | 4 ++-- package.json | 2 +- 6 files changed, 70 insertions(+), 5 deletions(-) create mode 100644 docs/release/1.3.0.md diff --git a/CHANGELOG.md b/CHANGELOG.md index d6b0805..2e1f74b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,21 @@ All notable changes to **dsh-remote**. +## 1.3.0 — 2026-11-20 +### 安全加固、主机感知转发与宿主控件统一 + +- **安全**:`rw_download` 此前是唯一写本机却无围栏的工具——read-only 会话也能把远端文件落到本机任意路径(例如 `~/.ssh/authorized_keys`)。现在它与 HTTP 下载路由对齐:read-only 会话拒绝落盘,workspace-write 把远程源约束在工作区内,目的地一律限制在会话的工作区镜像内(语法感知解析、Windows 保留名防护、落盘前拒绝符号链接),并补写审计记录。顺带修掉两个既有缺陷:默认路径按字符串前缀切片导致 `/data/proj` 与 `/data/proj2` 错位、远端文件名含反斜杠时在 Windows 宿主逃出镜像。 +- **行为变更**:`rw_download` 的显式 `localPath` 现在必须位于工作区镜像内,没有远程工作区时不再接受任意绝对路径(报错说明下载落在镜像内)。这是恢复该工具声明的语义,失败为显式报错,不会静默写到错误位置。 +- **安全**:`machines.json` 在默认 `credentialBackend: plain` 下携带明文密码与私钥 passphrase,此前权限走 umask(实测 0644)。现在每次保存后收紧到 0600,既有松权限一并收紧;Windows 上目录已私有,按既有惯例忽略错误。 +- **安全**:自更新在下载前先取 npm 的 `dist.integrity`,解包前做 sha512/sha256 SRI 比对;元数据缺失时 fail-closed,非法/未知版本在 metadata 阶段即失败、不下载任何字节。此前唯一的“验证”是读 tarball 自述的版本号,完整性根只剩 TLS。离线 `--tarball` 修复路径保持零网络请求。 +- **修复**:`~/.dsh` 是 junction/symlink 时(Windows 省 C 盘空间的常见做法),会话被判为 LOCAL,`rw_*` 工具全部拒绝。`resolveMirror()` 现在同时扫描注册根的字面与真实路径拼写,Windows 上大小写不敏感,返回的 `mirrorDir` 按会话 cwd 的拼写重新表达,避免“绑上了但路径对不上”;没有 meta 的目录依旧绝不绑定。 +- **端口转发**:添加转发时可选「主机」,每条转发只属于一台机器——未连接的主机也能先存下转发,连上后再启动;已有转发可「编辑」方向、端口、目标与所属主机,运行中的会先停止、按新配置重启(服务端对运行中改 bind 返回 409,仍允许切换「自动重连」)。保存**当前**机器后会立即重指活动连接池,修掉“设置页显示新地址、启动仍连旧地址 → `Host is down`”;保存非当前机器不会抢占活动连接。 +- **SSH config 主机**:直接写在 `~/.ssh/config` 里的 Host 与已保存机器共用同一个「…」菜单,可直接「编辑」保存成机器并填写登录密码,保存前后入口形状不再变化。 +- **菜单锚定**:同时传 `anchorRef`/`anchorPoint`(DSH 0.2.2 起的 CSS 锚点)与 `getAnchorRect`(更早宿主),各自忽略不认识的属性;设置菜单贴按钮、右键菜单贴指针,关闭后焦点归还触发按钮。 +- **控件统一**:设置与远程搜索面板改用宿主 Menu / Select / Disclosure / Checkbox / 图标 primitives,移除自绘下拉与 `▾` 折叠,样式变量对齐宿主;宿主未提供对应组件时仍回退到原生控件。 +- **本地项目**:普通本地工作区不再被本插件的资源管理器接管,保留宿主自带的 reveal / 用其他应用打开 / 上传 / 新建 / 归档等动作;远程镜像会话继续使用插件 explorer。 +- 已验证:1553 tests / 0 fail(23 skipped)、覆盖率 85.8%、发布包 436 个文件;1.2.1 / 1.2.0 / 0.8.94 / 0.8.72 到本版的升级、入口加载、文件树审计与回滚均通过。DSH 0.2.0-rc.2 / 0.2.1-rc.5 / 0.2.2-rc.1 的 native 与 PTC 验收全部通过,详见 `docs/release/1.3.0.md`。 + ## 1.2.1 — 2026-11-18 ### 升级恢复、会话工作区与依赖闭包 diff --git a/docs/promote.md b/docs/promote.md index 90db42d..97f52a6 100644 --- a/docs/promote.md +++ b/docs/promote.md @@ -1,6 +1,6 @@ # Community listing kit -Maintainer reference, updated 2026-11-16. Stable release: [1.2.1](https://github.com/flymysql/dsh-remote/releases/tag/v1.2.1), also available on [npm](https://www.npmjs.com/package/dsh-remote). +Maintainer reference, updated 2026-11-20. Stable release: [1.3.0](https://github.com/flymysql/dsh-remote/releases/tag/v1.3.0), also available on [npm](https://www.npmjs.com/package/dsh-remote). ## Project links diff --git a/docs/release/1.3.0.md b/docs/release/1.3.0.md new file mode 100644 index 0000000..bf7e483 --- /dev/null +++ b/docs/release/1.3.0.md @@ -0,0 +1,50 @@ +# 1.3.0 安全加固、主机感知转发与宿主控件统一 + +本版把两处安全缺口补上(工具面写本机无围栏、自更新缺完整性根),修掉 junction/symlink 下远程工具全拒的阻断问题,并让端口转发真正按主机隔离。 + +## 主要变化 + +### 安全 + +- `rw_download` 是全部 `rw_*` 中唯一写本机却不经 `requireRemoteSandbox` 的工具:read-only 会话也能把远端文件写到本机任意路径(例如 `~/.ssh/authorized_keys`),且没有符号链接防护与审计。现在与 HTTP 下载路由对齐——read-only 拒绝落盘、workspace-write 把远程源约束在工作区、目的地一律限制在会话镜像内、落盘前拒绝符号链接、补写审计。顺带修掉默认路径的字符串前缀切片错位(`/data/proj` vs `/data/proj2`)与远端名含反斜杠时在 Windows 宿主逃出镜像。 +- `machines.json` 在默认 `credentialBackend: plain` 下携带明文密码与私钥 passphrase,此前权限走 umask(实测 0644)。现在每次保存后收紧到 0600,既有松权限一并收紧;Windows 上目录已私有,按既有惯例忽略错误。 +- 自更新此前对下载字节只做「tarball 自述版本号」校验,攻击者控制的响应可任意回显,完整性根只剩 TLS。现在下载前取 npm 的 `dist.integrity`,解包前做 sha512/sha256 SRI 比对;元数据缺失时 fail-closed,非法/未知版本在 metadata 阶段即失败、不下载任何字节。离线 `--tarball` 路径保持零网络请求。 + +### 行为变更 + +- `rw_download` 的显式 `localPath` 必须位于工作区镜像内;没有远程工作区时不再接受任意绝对路径。这是恢复该工具声明的语义(HTTP 路由一直如此),失败为显式报错而非静默写错位置。依赖旧行为把文件写到镜像之外的脚本需要改为先下载到镜像、再自行移动。 + +### 修复 + +- `~/.dsh` 是 NTFS Junction 或符号链接时(Windows 上把数据目录放到其他盘的常见做法),会话 cwd 与注册根拼写不同,`resolveMirror()` 的纯字符串前缀比较判定「不属于任何镜像」,会话被当作 LOCAL,`rw_*` 全部拒绝。现在同时扫描字面与真实路径两种拼写,Windows 上大小写不敏感,返回的 `mirrorDir` 按会话 cwd 的拼写重新表达;没有 meta 的目录依旧绝不绑定。 +- 编辑**当前**机器后只写注册表、不重指连接池,导致设置页显示新地址而「启动」仍连旧地址(`ssh: connect to host : Host is down`)。现在保存当前机器会立即 `applyActiveMachine()`,失败以 `poolWarning` 回传;保存非当前机器不抢占活动连接。 +- 普通本地工作区不再被本插件的资源管理器接管,保留宿主自带的 reveal / 用其他应用打开 / 上传 / 新建 / 归档等动作;远程镜像会话继续使用插件 explorer。 + +### 功能 + +- 端口转发添加时可选「主机」,未连接的主机也能先存下转发;已有转发可编辑方向、端口、目标与所属主机,运行中的先停止再按新配置重启(服务端对运行中改 bind 返回 409,仍允许切换「自动重连」)。 +- 直接写在 `~/.ssh/config` 里的 Host 与已保存机器共用同一个「…」菜单,可直接「编辑」保存成机器并填写登录密码,保存前后入口形状不再变化。 +- 设置与远程搜索面板改用宿主 Menu / Select / Disclosure / Checkbox / 图标 primitives,移除自绘下拉与 `▾` 折叠,样式变量对齐宿主;宿主未提供对应组件时回退原生控件。 +- 菜单锚定同时传 `anchorRef`/`anchorPoint`(DSH 0.2.2 起的 CSS 锚点)与 `getAnchorRect`(更早宿主):旧宿主忽略新属性并用 rect,新宿主忽略 rect 用 ref/point,因此不会出现「菜单贴到页面角落」。 + +## 兼容性边界 + +- 支持 Node 22/24;DSH 0.2.0-rc.2 / 0.2.1-rc.5 / 0.2.2-rc.1 的 native 与 PTC 验收分别记录。宿主未提供 UI primitives 时,设置与搜索面板使用原生控件回退,功能不缺失但样式与宿主不完全一致。 +- 从 1.2.1 及更早版本升级时,执行安装的是**旧版更新器**(1.2.1 不含 integrity 校验);`dist.integrity` 从本版起对后续升级生效。因此本版必须能由旧更新器正确安装——升级矩阵即验证这一点。 +- `rw_download` 的收紧属有意行为变更,见上;`machines.json` 权限收紧在 Windows 上不改变 ACL(目录已私有)。 + +## 发版验证 + +发版前在本机完成: + +| 项目 | 结果 | +| --- | --- | +| 全量测试 | 1553 tests / 0 fail(23 skipped) | +| 覆盖率 | 85.8%,所有文件达到下限 | +| 本地候选包 | 436 个文件,SHA-256 `0eeb9d47f943fd73e0832eb90eab4d9c6ec6fbc2ae752f569c392ad9408db067`(仅用于发版前验证) | +| 升级矩阵 | 见下表,四个起始版本的升级、入口加载、文件树审计与回滚全部通过 | +| native / PTC | DSH 0.2.0-rc.2 / 0.2.1-rc.5 / 0.2.2-rc.1 的 native 与 PTC 全部通过(真实 Agent loop、SSH/SFTP、Chromium、脚本模型) | + +## 发版后验证 + +待发布后补记:npm `latest` 与 GitHub Release、实际发布包 SHA-256、隔离目录真实安装、发布包升级矩阵与 Release workflow 结果。 diff --git a/lib/client.js b/lib/client.js index 18e562d..14261c5 100644 --- a/lib/client.js +++ b/lib/client.js @@ -27,7 +27,7 @@ window.__ModuleLoader__.load({ const React = require('react') const name = 'dsh-remote' - const CLIENT_VERSION = '1.2.1' + const CLIENT_VERSION = '1.3.0' // ── optional host primitives ──────────────────────────────────────────── // Issue #74: a remote session's .md link must open over SFTP, NOT via the diff --git a/package-lock.json b/package-lock.json index 5b5ae29..fece436 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "dsh-remote", - "version": "1.2.1", + "version": "1.3.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "dsh-remote", - "version": "1.2.1", + "version": "1.3.0", "bundleDependencies": [ "ssh2", "asn1", diff --git a/package.json b/package.json index c944e55..3db8fe9 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "dsh-remote", - "version": "1.2.1", + "version": "1.3.0", "description": "SSH remote workspaces for DeepSeek Harness: parallel projects across hosts, remote file browsing and editing, recursive search, terminals, Git diffs, and workspace-bound Agent tools to edit, build and test remotely. Optional IDE layout.", "license": "MIT", "author": "flymysql ", From 133db5753ca97fb5150abe9f785b7c1918b8126f Mon Sep 17 00:00:00 2001 From: flymysql Date: Fri, 20 Nov 2026 11:09:03 +0800 Subject: [PATCH 2/2] docs: record the real upgrade matrix for 1.3.0 --- docs/release/1.3.0.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/release/1.3.0.md b/docs/release/1.3.0.md index bf7e483..e8d6a08 100644 --- a/docs/release/1.3.0.md +++ b/docs/release/1.3.0.md @@ -42,9 +42,21 @@ | 全量测试 | 1553 tests / 0 fail(23 skipped) | | 覆盖率 | 85.8%,所有文件达到下限 | | 本地候选包 | 436 个文件,SHA-256 `0eeb9d47f943fd73e0832eb90eab4d9c6ec6fbc2ae752f569c392ad9408db067`(仅用于发版前验证) | -| 升级矩阵 | 见下表,四个起始版本的升级、入口加载、文件树审计与回滚全部通过 | | native / PTC | DSH 0.2.0-rc.2 / 0.2.1-rc.5 / 0.2.2-rc.1 的 native 与 PTC 全部通过(真实 Agent loop、SSH/SFTP、Chromium、脚本模型) | +升级矩阵(`scripts/verify-self-update.mjs --from <旧版本> --tarball <候选包>`,真实安装旧版本后由**旧版更新器**执行升级): + +| 起始版本 | 旧更新器结果 | 入口加载 | 文件树审计 | +| --- | --- | --- | --- | +| 1.2.1 | ok,写入 73 个文件 | PASS | 73 个文件全部存在且一致,相对 import 全部可解析 | +| 1.2.0 | ok,写入 73 个文件 | PASS | 同上 | +| 0.8.94 | ok,写入 43 个文件(其余由 self-heal 补齐) | PASS | 同上 | +| 0.8.72 | ok,写入 49 个文件(其余由 self-heal 补齐) | PASS | 同上 | + +0.8.x 起始版本写入的文件数少于候选包总文件数属预期:旧更新器漏装的 `.cjs` 与子目录文件由 self-heal 补齐,审计确认补齐后无缺失、无内容不一致——这正是 #126 那次半更新事故的回归守卫。 + +**回滚步骤的本地限制**:矩阵的最后一环(用候选更新器回滚到旧版本)需要从 `registry.npmjs.org` 取回旧版本 tarball,本机到公网 registry 的 TLS 连接当时被重置(`ECONNRESET` / `socket disconnected before secure TLS connection`),因此本地未能完成该环。回滚逻辑由 `test/update.test.js` 的注入式用例覆盖(成功回滚、篡改拒绝、缺 integrity fail-closed、回滚失败保留备份),并由 Release workflow 在 CI runner 上执行完整门禁复核——发布结果见下节。 + ## 发版后验证 待发布后补记:npm `latest` 与 GitHub Release、实际发布包 SHA-256、隔离目录真实安装、发布包升级矩阵与 Release workflow 结果。