dsh-remote-window 0.1.0-alpha.3 → 0.1.0-alpha.5

package/README-zh.md

@@ -16,10 +16,11 @@ target rail，并把 server 的**完整官方 DSH UI 以同源 iframe 全屏铺
 
 - **local（默认）**：agent、会话日志与工具仍在 server，但每次模型请求经 SSH 反向隧道转发到 client
   本机。默认接入方式是 **自动代理本机模型**：client 用本机 DSH 的 `ctx.llm` 枚举全部 provider/model，
-  无需填 endpoint 或 key，每个 provider 在 server profile 的模型选择器里各成一条 route。**高级选项**
-  会列出发现到的全部 provider/model（默认全选，可逐项勾选、按 provider 全选/清空、刷新），选择会
-  保存并决定 profile 生成哪些 route，server 会话即可在你允许的本地模型之间自由切换。新 server 通常
-  没配模型 key，所以默认走这里；本机模型目录读不到时阻止连接，绝不静默回退到 server 模型。
+  无需填 endpoint 或 key，每个 provider 在 server profile 的模型选择器里各成一条 route。**全部
+  provider/model 一律转发**，没有勾选 UI；server 会话直接在本机全部模型之间切换。本机暂时没有可用
+  模型时也能连接：此时不启动反向隧道，profile 用 server 自己已配的模型，之后本机新增的模型在下次
+  连接时自动同步。新 server 通常没配模型 key，所以默认走这里；本机模型目录读取异常时用带 code 的
+  错误提示，绝不静默回退到 server 模型。
 - **server（可选）**：server profile 使用自己的模型配置；仅当 server 已配置模型凭据时显式选择。
 
 两种来源写同一份 server 会话日志；切换模型来源需要重连，而不是换会话。
@@ -113,10 +114,11 @@ shell sidebar 隐藏，target rail 保留可用。
 `http://127.0.0.1:<随机>/<provider>/v1`。该端口是 SSH `forwardIn` 反向隧道，终止在 client 的
 loopback-only bridge。默认的 **自动代理** 用本机 DSH 自己的 `ctx.llm` 枚举 provider/model
 （`listProviders`/`listModels`），每个模型请求都以官方类型转成 `ctx.llm.stream()`，因此本机 DSH 的
-凭据与协议原样生效、无需重填。**高级选项** 保存的 `localSelection` 决定代理哪些 provider/model：
-未保存 = 全量，过滤后的集合裁剪生成的 route，过滤为空则报错拒绝。（旧的 **手动 endpoint** 路径仅为
-兼容旧设置/测试保留，对话框不再提供；profile 始终只看到占位 key。）本机目录读不到、模型列表为空或
-sshd 拒绝转发都返回带 code 的可操作错误，绝不静默回退 server 模型。
+凭据与协议原样生效、无需重填。本机发现到的**全部** provider/model 都会代理，没有过滤或勾选；本机
+一个模型都没有时仍然可以连接（不启动桥/隧道，profile 继续用 server 自己的模型），下次连接会重新
+发现并同步新模型。（旧的 **手动 endpoint** 路径仅为兼容旧设置/测试保留，对话框不再提供；profile
+始终只看到占位 key。）本机目录读取异常、桥启动失败或 sshd 拒绝转发都返回带 code 的可操作错误，绝不
+静默回退 server 模型。
 
 **server 权威数据。** workspace 清单/标题/顺序/pin/archive 来自 server 官方
 `workspaceRegistry`；session 清单/标题/blank/running 来自 `sessionController` + 插件 JSONL title fold。
@@ -159,8 +161,8 @@ client 包内置 server 插件 tarball，因此目标机不需要网络或包管
 1. 打开浮动 **target rail**（hover 或按 `Alt+R`），点 **新建连接**。
 2. 选择 `SSH`，填目标信息，首次连接确认 host key 指纹。
 3. 选择模型来源：**local**（默认）或 **server**（使用 server profile 自己的模型配置）。选 **local**
-   时，**高级选项** 会列出本机 DSH 的全部 provider/model（默认全选）；取消勾选即可不暴露某些模型，
-   点刷新重新发现，保存的选择决定 server profile 能切换到哪些模型。
+   时，本机 DSH 的全部 provider/model 都会转发给 server profile（没有勾选步骤）；本机还没有模型也能
+   连接，之后新增的模型会在下次连接时同步。
 4. 查看探测结果。client 检查 server 的 Node/DSH 运行时与 server 插件，决定后续步骤是部署、更新还是
    跳过；随后启动 profile server，选 local 模型时打开 SSH 反向隧道，并完成握手鉴权。失败的尝试不会
    保存。
@@ -183,29 +185,35 @@ client 包内置 server 插件 tarball，因此目标机不需要网络或包管
 
 ## Compatibility
 
-当前只对这一个运行时做过验证：
+兼容性是**声明出来的区间**，不是藏在代码里的常量：
 
-| 插件 | 已验证 DSH 运行时 | 状态 |
+<!-- verified-runtimes:start -->
+| Plugin | Supported DSH | Published runtimes |
 | --- | --- | --- |
-| 0.1.0-alpha.3 | 0.2.1-rc.3 | verified |
-<!-- verified-runtimes -->
-
-本版本针对 DSH `0.2.1-rc.3` 构建、打包并测试；`0.2.1-rc.2` 已不在已验证集合内，默认会被精确版本
-守卫拒绝，除非显式豁免该组合。检查项、剩余范围与升级步骤见
-[doc/dsh-rc3-compatibility.md](doc/dsh-rc3-compatibility.md)。
-
-声明是**精确版本**，不是区间：清单把 `engines.dsh` 与全部 `@deepseek-ai/dsh-*` peer 钉在上面的运行时，
-客户端也只在 server 版本属于已验证运行时时才接受它。DSH 还是开发者预览版；未验证版本会被一条可操作的
-错误拒绝，而不是跑到一半失败。
-
-如果确实要在本机试别的 DSH 版本，对这一对精确版本做豁免，并把结果视为不受支持：
-
-```bash
-dsh plugin --profile web allow-version dsh-remote-window@<已安装版本> \
-  --dsh-version <运行时版本> --accept-risk
-```
-
-豁免只覆盖本机宿主；server 必须运行已验证运行时——client 安装的独立 runtime，或复用该精确版本的全局 DSH。
+| 0.1.0-alpha.3 | = 0.2.1-rc.3 | 0.2.1-rc.3 |
+| 0.1.0-alpha.4 | >= 0.2.1-rc.2 <= 0.2.1-rc.5 | 0.2.1-rc.5, 0.2.1-rc.3 |
+| 0.1.0-alpha.5 | >= 0.2.1-rc.2 <= 0.2.1-rc.5 | 0.2.1-rc.5, 0.2.1-rc.3 |
+<!-- verified-runtimes:end -->
+
+这张表由 `node scripts/sync-compat.mjs` 从 [`compat/runtimes.json`](compat/runtimes.json) 生成；
+`--check` 会在清单、peer、README 与生成表不一致时让发布失败。三个版本号各有含义，故意分开：
+
+- **插件版本**（`0.1.0-alpha.4`）是我们自己的包版本，按我们的节奏走。
+- **DSH 区间**（`min … max`，两端闭）表示这个构建能驱动的 DSH 版本。DSH 是开发者预览版，高于上界的
+  版本和低于下界的版本一样可能不兼容，所以判断是闭区间，而不是「这个版本或更新」。区间退化为单版本时
+  就直接写成精确版本。
+- **runtime 产物**（`dsh-runtime-<dsh>-<平台>.tar.gz`）按它内含的 DSH 版本命名，而不是插件版本：包里是
+  `node/` 加 `@deepseek-ai/dsh@<dsh>`，不含插件代码，多个插件版本复用同一份产物。
+
+连接时会自动挑「能拿到 runtime 的最新受支持 DSH」：显式 `DSH_RW_RUNTIME_ARTIFACT` → 区间内且健康的
+全局 DSH → 本地缓存 → 已发布的 release 产物 → POSIX 宿主本地构建。版本在区间内但暂时没有产物时会明确
+报「没有可用 runtime 产物」，不会被当成不兼容。`engines.dsh` 与全部 `@deepseek-ai/dsh-*` peer 使用同一
+表达式：区间为单版本时写精确版本，否则写 `>=min <=max`。
+
+远端的 server 可以是 Linux、macOS 或 **Windows**。Windows 目标需要预置
+`dsh-runtime-<version>-win32-<arch>.tar.gz`（`DSH_RW_RUNTIME_ARTIFACT`，或放在
+`~/.dsh/remote-assets/` 的同名文件），或复用一份健康的全局 DSH——client 目前不会自行下载 runtime 产物。
+Windows 契约、失败码与真机验证记录见 [doc/windows-server-support.md](doc/windows-server-support.md)。
 
 独立 runtime 会优先复用 `~/.dsh/remote-assets/` 中该平台/版本的缓存包；缓存没有时，client 用本机 pnpm
 按同一 `node/` + `dsh/` 布局构建并上传，因此升级 DSH 后首次连接可能慢一些，之后直接复用。构建只写入
@@ -261,7 +269,7 @@ dsh plugin --profile web allow-version dsh-remote-window@<已安装版本> \
 
 | 症状 | 检查 |
 | --- | --- |
-| `incompatible-version` | 本机装 DSH `0.2.1-rc.3`，或对该精确版本做豁免（见 Compatibility）。 |
+| `incompatible-version` | 本机装区间内的 DSH（`0.2.1-rc.2 … 0.2.1-rc.5`），或对该精确版本做豁免（见 Compatibility）。 |
 | 没有 target rail | 插件必须已安装并在 `web` 启用；重启 `dsh web` 并刷新。hover rail 或按 `Alt+R` 展开。 |
 | `server-plugin-missing` / `server-plugin-version-mismatch` | client 包内置的 server 插件 tarball 丢失/版本不匹配；重装 client 插件后重连。 |
 | `server-plugin-integrity-failed` | 内置/下载的 server 插件 sha256 校验失败；重装 client 包。 |

package/README.md

@@ -131,12 +131,13 @@ that point at `http://127.0.0.1:<random>/<provider>/v1`. That port is an SSH `fo
 tunnel, terminated by a loopback-only bridge on the client. The default **auto proxy** enumerates the
 local DSH's own `ctx.llm` providers/models (`listProviders`/`listModels`) and answers every model call
 from `ctx.llm.stream()` with the harness' native types, so the local DSH's own credentials and protocols
-keep working and nothing is re-entered. The client's **advanced options** persist which providers/models
-are proxied (`localSelection`): unset means “all”, a filtered set trims the generated routes, and an
-empty result is rejected. (The legacy manual endpoint path still exists for old saved settings and tests,
-but the UI no longer offers it; the profile always sees a placeholder key.) An unreadable catalog, an
-empty model list or an sshd that refuses forwarding is a coded, actionable failure — never a silent
-fallback to server models.
+keep working and nothing is re-entered. **Every** provider and model is proxied — there is no per-model
+opt-in and no selection UI; the server's model picker simply lists all of this host's models. A host with
+no model at all still connects: no bridge is started, the profile keeps the server's own models, and
+models added later are picked up by the next connection. (The legacy manual endpoint path still exists for
+old saved settings and tests, but the UI no longer offers it; the profile always sees a placeholder key.)
+An unreadable catalog, a broken bridge or an sshd that refuses forwarding is a coded, actionable failure —
+never a silent fallback to server models.
 
 **Server-authoritative data.** Workspace list/title/order/pin/archive come from the server's official
 `workspaceRegistry`; session list/title/blank/running come from `sessionController` plus a plugin-side
@@ -212,33 +213,41 @@ package manager. Then:
 
 ## Compatibility
 
-Verified against exactly this runtime:
+Compatibility is a **declared interval**, not a constant hidden in the code:
 
-| Plugin | Verified DSH runtime | Status |
+<!-- verified-runtimes:start -->
+| Plugin | Supported DSH | Published runtimes |
 | --- | --- | --- |
-| 0.1.0-alpha.3 | 0.2.1-rc.3 | verified |
-<!-- verified-runtimes -->
-
-This release is built, packed and tested against DSH `0.2.1-rc.3`. `0.2.1-rc.2` is no longer in the
-verified set, so the exact-version guard refuses it unless you explicitly exempt that pair. See
-[doc/dsh-rc3-compatibility.md](doc/dsh-rc3-compatibility.md) for what was checked, what remains, and the
-upgrade procedure.
-
-The declaration is a **precise version**, not a range: the manifest pins `engines.dsh` and every
-`@deepseek-ai/dsh-*` peer to the runtime above, and the client accepts the server only when its version is
-one of the verified runtimes. DSH is a developer preview; an unverified release is refused with an
-actionable message instead of failing halfway.
-
-If you intentionally run another DSH version locally, exempt the exact pair and treat the result as
-unsupported:
-
-```bash
-dsh plugin --profile web allow-version dsh-remote-window@<installed version> \
-  --dsh-version <runtime version> --accept-risk
-```
-
-That exemption covers the local host only. The server side must run the verified runtime — either the
-isolated runtime the client installs, or a global DSH reusing that exact verified version.
+| 0.1.0-alpha.3 | = 0.2.1-rc.3 | 0.2.1-rc.3 |
+| 0.1.0-alpha.4 | >= 0.2.1-rc.2 <= 0.2.1-rc.5 | 0.2.1-rc.5, 0.2.1-rc.3 |
+| 0.1.0-alpha.5 | >= 0.2.1-rc.2 <= 0.2.1-rc.5 | 0.2.1-rc.5, 0.2.1-rc.3 |
+<!-- verified-runtimes:end -->
+
+The table is generated from [`compat/runtimes.json`](compat/runtimes.json) by
+`node scripts/sync-compat.mjs`; `--check` fails the release when the manifest, the peers, the READMEs or
+the generated table disagree. Three different version numbers appear on purpose:
+
+- **Plugin version** (`0.1.0-alpha.4`) names our packages; it moves on our schedule.
+- **DSH interval** (`min … max`, both ends inclusive) says which DSH releases this build can drive. DSH is
+  a developer preview, so a release *above* the upper bound can break exactly like one below the lower
+  bound: the check is a closed interval, not "this version or newer". An interval of one release is
+  written as the exact version.
+- **Runtime artifact** (`dsh-runtime-<dsh>-<platform>.tar.gz`) is named after the DSH release it carries,
+  not after the plugin: it contains `node/` plus `@deepseek-ai/dsh@<dsh>` and no plugin code, so several
+  plugin versions reuse one artifact.
+
+On connect the client picks the newest supported DSH for which a runtime is reachable — explicit
+`DSH_RW_RUNTIME_ARTIFACT` → a healthy global DSH inside the interval → the local cache → a published
+release asset → a local build on a POSIX host. A DSH version *inside* the interval that has no artifact
+yet is reported as such (`no runtime artifact is available for …`), never as an incompatibility.
+`engines.dsh` and every `@deepseek-ai/dsh-*` peer carry the same expression: exact while the interval is a
+single release, `>=min <=max` otherwise.
+
+Remote servers can be Linux, macOS or **Windows**. A Windows server needs either a pre-seeded
+`dsh-runtime-<version>-win32-<arch>.tar.gz` (`DSH_RW_RUNTIME_ARTIFACT`, or the same file under
+`~/.dsh/remote-assets/`) or a healthy global DSH to reuse, because the client does not download runtime
+artifacts yet. See [doc/windows-server-support.md](doc/windows-server-support.md) for the Windows contract,
+the codes it can fail with, and the verified real-machine run.
 
 The isolated runtime reuses a platform/version cache under `~/.dsh/remote-assets/` first. When the cache is
 missing, the client builds the same `node/` + `dsh/` layout with the host pnpm and uploads it, so the first
@@ -304,7 +313,7 @@ credential store.
 
 | Symptom | What to check |
 | --- | --- |
-| `incompatible-version` | Install DSH `0.2.1-rc.3` locally, or exempt that exact pair (see Compatibility). |
+| `incompatible-version` | Install a DSH release inside the supported interval (`0.2.1-rc.2 … 0.2.1-rc.5`) locally, or exempt that exact pair (see Compatibility). |
 | No target rail | The plugin must be installed and enabled in `web`; restart `dsh web` and reload. Hover the rail or press `Alt+R`. |
 | `server-plugin-missing` / `server-plugin-version-mismatch` | The client package lost or mismatched its bundled server-plugin tarball; reinstall the client plugin and reconnect. |
 | `server-plugin-integrity-failed` | The bundled/downloaded server plugin failed its sha256 check; reinstall the client package. |

package/assets/server-plugin/checksums.json

@@ -1,3 +1,4 @@
 {
-  "dsh-remote-window-server-0.1.0-alpha.3.tgz": "2562e1610f5022ee9ed5211c755058dba32a72f42defde7eae94e6d632d3bab2"
+  "dsh-remote-window-server-0.1.0-alpha.4.tgz": "7e801b0032f0739e7f9f40d3f5d491c08ab67094e8b2868bb068f3b83f44138f",
+  "dsh-remote-window-server-0.1.0-alpha.5.tgz": "122fff60787d8530b0a5f9e44a1b5c28aead9cee5e88b357b65e51d07f4c6f6f"
 }