Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
### 升级恢复、会话工作区与依赖闭包

Expand Down
2 changes: 1 addition & 1 deletion docs/promote.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down
62 changes: 62 additions & 0 deletions docs/release/1.3.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# 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 <old>: 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、脚本模型) |

升级矩阵(`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 结果。
2 changes: 1 addition & 1 deletion lib/client.js
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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 <flyphp@outlook.com>",
Expand Down
Loading