dsh-auto-open-web 0.1.11 → 0.1.13

package/README.en.md

@@ -39,6 +39,11 @@ selected by `windowKind`:
    (win32 = `cmd /c start`, darwin = `open`, linux = `xdg-open`).
    `appWindow: false` behaves **exactly like the official core**: the GUI is opened in the
    system default browser (plain tab, official `open` method).
+4. **`--no-open` / SSH sessions (official identical suppression)**: `dsh web --no-open`
+   (`webStartup.openBrowser === false`) or an SSH session (`SSH_CONNECTION`/`SSH_TTY`
+   environment variables, the same source as the official `launchedThroughSsh`) opens
+   **nothing** — the plugin reads the **same source** as the official core (the `webStartup`
+   service provided by web-startup) and suppresses opening the same way.
 
 The port comes from the real listening value of the webServer service (`--port` overrides and
 `--port 0` both work). **No waiting needed**: the plugin declares webServer as a hard dependency
@@ -54,8 +59,9 @@ cleanup.
 > plugin's bundle patch, so the opening behavior is fully owned by the plugin: with
 > `appWindow: true` the app-style window opens and no ordinary browser page pops up; with
 > `appWindow: false` the plugin performs **the same default-browser handoff as the official core**
-> (open package → native platform launch), matching the no-plugin behavior. Uninstalling the
-> plugin restores the official default (or use `dsh web --no-open` to disable it temporarily).
+> (open package → native platform launch), matching the no-plugin behavior. With
+> `dsh web --no-open` (or in an SSH session) the plugin, like the official core, opens
+> nothing. Uninstalling the plugin restores the official default.
 
 ### WebView2 host requirements (webview2 mode only)
 
@@ -164,9 +170,10 @@ without touching the package.
 
 - **Zero dependencies**: every runtime dependency is provided by the **DSH deployment** and
   declared as an optional peer (no install warnings):
-  - `@deepseek-ai/dsh` (the host; declares the compatibility range `>=0.1.0-rc.7 <0.2.0` —
-    `settings.plugin.item` became a keyed slot in that release, registration requires
-    `options.key`; no runtime version check is performed)
+  - `@deepseek-ai/dsh` (the host; declares the compatibility range `>=0.1.0-rc.8 <0.2.0` —
+    rc.8 removed `dsh-client-schema-form` from the client frozen table and introduced
+    `dsh-client-runtime`; the plugin's settings card and opening behavior depend on that
+    release; no runtime version check is performed)
   - `@deepseek-ai/schemastery` (config schema validator; resolved at runtime: normal import
     first, then the DSH deployment copy under the Windows global npm layout)
   - `koffi` (Windows only: Job Object / process verification / native file dialog; same runtime

package/README.md

@@ -36,6 +36,11 @@ dsh web profile 启动后自动打开独立应用窗口（或网页标签页）
    linux = `xdg-open`）。
    `appWindow: false` 时**与官方相同**:默认浏览器打开(普通标签页,官方
    open 方式)。
+4. **`--no-open` / SSH 会话（与官方相同的不打开）**：`dsh web --no-open`
+   （webStartup 服务的 `openBrowser === false`）或 SSH 会话（`SSH_CONNECTION`/
+   `SSH_TTY` 环境变量，与官方 `launchedThroughSsh` 同源）时不打开任何
+   窗口/页面——插件读取与官方**同一来源**（web-startup 提供的 webStartup
+   服务）做同样的抑制。
 
 端口取自 webServer 服务的真实监听值（`--port` 自定义、`--port 0` 均正确）。
 **无需等待**：插件把 webServer 声明为硬依赖（`inject`），Cordis 会等
@@ -49,8 +54,9 @@ Job Object（强杀也生效）+ 退出清理结束进程树。
 > 安装本插件后，插件的 bundle 补丁会把 `web-runtime.openBrowser` 置为 `false`，
 > 打开行为完全由本插件接管：`appWindow: true` 时打开独立应用窗口，不弹出
 > 普通浏览器页面；`appWindow: false` 时插件执行**与官方核心相同的默认浏览器
-> 交接**（open 包 → 平台原生拉起），行为与未安装插件时一致。卸载插件后恢复
-> 官方默认行为（临时关闭也可用 `dsh web --no-open`）。
+> 交接**（open 包 → 平台原生拉起），行为与未安装插件时一致；`dsh web
+> --no-open`（或 SSH 会话）时与官方一致不打开任何窗口/页面。卸载插件后
+> 恢复官方默认行为。
 
 ### WebView2 宿主要求（仅 webview2 模式）
 
@@ -154,8 +160,9 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
 
 - **本包零 dependencies**:所有运行时依赖均由 **DSH 部署提供**,以 optional
   peer 声明(安装无警告):
-  - `@deepseek-ai/dsh`(宿主,声明兼容范围 `>=0.1.0-rc.7 <0.2.0`,
-    `settings.plugin.item` 自该版本起为 keyed 插槽,注册需 `options.key`;
+  - `@deepseek-ai/dsh`(宿主,声明兼容范围 `>=0.1.0-rc.8 <0.2.0`:
+    自 rc.8 起客户端冻结表移除 `dsh-client-schema-form`、引入
+    `dsh-client-runtime`,本插件的设置卡片与打开行为均依赖该版本;
     不做运行时版本检测)
   - `@deepseek-ai/schemastery`(配置 schema 校验器;运行时解析:常规 import
     优先,其次 Windows 全局 npm 布局下的 DSH 部署副本)

package/cordis.patch.yml

@@ -12,6 +12,8 @@
 # openBrowser 关闭后打开行为由插件全权接管:appWindow: true → 独立应用窗口;
 # appWindow: false → 插件执行与官方核心相同的默认浏览器交接(open 包 →
 # 平台原生拉起,普通标签页),行为与未安装本插件时一致。
+# `dsh web --no-open`(webStartup.openBrowser === false)或 SSH 会话时,插件
+# 读取**同一 webStartup 服务**判断,与官方一致不打开任何窗口/页面。
 - id: web-runtime
   config:
     openBrowser: false

package/lib/client.js

@@ -3,10 +3,10 @@
 // require 解析浏览器端模块表(react 为壳层静态模块,@deepseek-ai/dsh-client-runtime
 // 为动态包)。**不** require @deepseek-ai/dsh-client-ui-primitives 等官方 UI 包。
 //
-// 依赖边界(与官方数据的对接面,均为公开接口):
-//   - settingsScope:官方 settings 域(命名空间 `auto-open-web`,dsh ≥0.1.0-rc.7
-//     取消第三方命名空间白名单)
-//   - slots:settings.plugin.item 插槽(keyed 注册,同时带 id 兼容旧版)
+// 依赖边界(与官方数据的对接面,均为公开接口;本插件声明 dsh ≥0.1.0-rc.8):
+//   - settingsScope:官方 settings 域(命名空间 `auto-open-web`;第三方命名空间
+//     白名单自 rc.7 起已取消,rc.8 下无限制)
+//   - slots:settings.plugin.item 插槽(keyed 注册,rc.7 起要求 options.key)
 //   - locale:文案注册(zh/en/ja/ko/fr/de/ru,跟随界面语言)
 //   - dsh-client-runtime:createSnapshotStore 快照 store(缺失时内置兜底实现)
 //

package/lib/index.js

@@ -17,6 +17,8 @@
  *     作为最后的兜底;open 包不可用时平台原生 cmd start / open / xdg-open)。
  *  appWindow: false → **与官方相同**:同样执行默认浏览器交接(官方 open 方式),
  *  替代被本插件补丁关闭的官方核心交接,行为与未安装本插件时一致。
+ *  --no-open / SSH 会话 → **与官方相同**:不打开任何窗口/页面(读取官方
+ *  webStartup 服务的 openBrowser 标志;SSH 会话按官方同源环境变量判定)。
  *
  * 配置来源:行配置(cordis.patch.yml)作为启动种子;设置页卡片(客户端 bundle,
  * settings.plugin.item 插槽)经官方 settings 域(settingsScope)读写本命名
@@ -296,6 +298,33 @@ async function openDefaultBrowser(url) {
   return platform.openDefaultBrowser(url);
 }
 
+// ── 与官方相同的打开抑制(--no-open / SSH 会话) ────────────────────────────
+//
+// 官方(web-app)的默认浏览器交接条件是 handoffBrowser = config.openBrowser &&
+// !launchedThroughSsh(ctx):config.openBrowser 来自 web-startup 插件提供的
+// webStartup 服务(--no-open 时 openBrowser === false,即 commander 对
+// --no-open 的反向选项 options.open);SSH 会话(SSH_CONNECTION/SSH_TTY 进程
+// 环境变量)同样不自动打开。本插件的 bundle 补丁把官方 openBrowser 恒置为
+// false、打开行为由本插件接管,故此处读取**同一来源**做同样的抑制,保证
+// `dsh web --no-open`(及 SSH 会话)与官方行为一致:不打开任何窗口/页面。
+/**
+ * --no-open 是否已传(webStartup.openBrowser === false)。
+ * webStartup 由 web-startup 插件提供(同一 isolate 的根服务表,ctx.get 可见);
+ * 非 web 组合(服务缺失)视为未传,不误伤。
+ */
+function noOpenRequested(ctx) {
+  const webStartup = ctx.get('webStartup');
+  return webStartup !== undefined && webStartup !== null && webStartup.openBrowser === false;
+}
+
+/** 是否 SSH 会话(与官方 launchedThroughSsh 同源:进程环境变量)。 */
+function sshSessionDetected() {
+  return (
+    (process.env.SSH_CONNECTION !== undefined && process.env.SSH_CONNECTION !== '') ||
+    (process.env.SSH_TTY !== undefined && process.env.SSH_TTY !== '')
+  );
+}
+
 // ── 配置与历史迁移(共通) ─────────────────────────────────────────────────
 
 /** 删除 v0.3 遗留的 state 文件(一次性清理,防孤儿数据)。 */
@@ -421,6 +450,8 @@ export const internals = {
   spawnHostWindow,
   getOpenPackage,
   openDefaultBrowser,
+  noOpenRequested,
+  sshSessionDetected,
   /** 测试钩子:同步"窗口关闭时退出 DSH"生效标志(模拟设置保存)。 */
   setExitWatcherEnabled(value) {
     exitWatcherEnabled = value === true;
@@ -561,6 +592,15 @@ export function apply(ctx, config) {
     }
     const url = `http://127.0.0.1:${String(server.port)}`;
 
+    // 与官方相同的打开抑制:--no-open(webStartup.openBrowser === false)或
+    // SSH 会话时不打开任何窗口/页面(官方同样不交接)。
+    const noOpen = noOpenRequested(ctx);
+    const ssh = sshSessionDetected();
+    if (noOpen || ssh) {
+      console.log(`[auto-open-web] ${noOpen ? '--no-open given' : 'SSH session'}; not opening anything (official behavior)`);
+      return;
+    }
+
     // 独立应用窗口:按 windowKind 显式选择(webview2 | browser),直接加载 GUI 根地址。
     // 所选类型不可用时降级到最后兜底:默认浏览器打开(官方 dsh web 同款,
     // 普通标签页),保证用户至少能打开 GUI。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-auto-open-web",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Open the DSH Web GUI in an app-style WebView2 window on profile start, with a settings card for browser paths",
   "repository": {
     "type": "git",
@@ -46,7 +46,7 @@
     "README.en.md"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh": ">=0.1.0-rc.7 <0.2.0",
+    "@deepseek-ai/dsh": ">=0.1.0-rc.8 <0.2.0",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "peerDependenciesMeta": {