dsh-auto-open-web 0.1.5 → 0.1.9

package/README.en.md

@@ -31,7 +31,12 @@ selected by `windowKind`:
    kills the dedicated instance process tree (matching only our own user-data-dir, never the normal
    browser); instances left behind by a force-kill are cleaned up before the next launch.
 3. If the selected type is unavailable (host missing / browser not found / non-Windows, etc.) →
-   **nothing is opened** (a log entry is written), with no automatic cross-fallback.
+   **falls back to the official default-browser handoff** — the URL is given to the OS default
+   browser (plain tab), so the user can always reach the GUI. The implementation mirrors exactly
+   how the DSH core (web-app bundle) opens the page at startup: it prefers the `open` package
+   shipped with the DSH deployment (win32 = PowerShell Start, darwin = `open`, linux = `xdg-open`);
+   when the package is unavailable it falls back to a native platform launch
+   (win32 = `cmd /c start`, darwin = `open`, linux = `xdg-open`).
    `appWindow: false` opens nothing automatically.
 
 The port comes from the real listening value of the webServer service (`--port` overrides and
@@ -42,6 +47,13 @@ Both modes close with DSH: the webview2 host watches the parent process; the
 browser dedicated instance is ended by the Job Object (also effective on force-kill) plus exit
 cleanup.
 
+> **Relationship with DSH's core browser handoff**: the DSH core (web-app bundle) opens the GUI
+> in the system default browser at startup by default (`openBrowser: true` — a plain tab/window,
+> not an app window). Installing this plugin flips `web-runtime.openBrowser` to `false` via the
+> plugin's bundle patch, so only the plugin's app-style window opens and no ordinary browser page
+> pops up; uninstalling the plugin restores the default behavior (or use `dsh web --no-open`
+> to disable it temporarily).
+
 ### WebView2 host requirements (webview2 mode only)
 
 - Windows 10 1803+ / Windows 11 / Windows Server 2016+
@@ -69,7 +81,7 @@ Two equivalent ways:
 | Field | Default | Description |
 | --- | --- | --- |
 | `appWindow` | `true` | Automatically open the independent app window on start; `false` opens nothing |
-| `windowKind` | `webview2` | `webview2` = WebView2 host (own process, DSH taskbar icon, exits with DSH); `browser` = dedicated `--app` browser instance. If the selected type is unavailable, only a log entry is written and nothing opens |
+| `windowKind` | `webview2` | `webview2` = WebView2 host (own process, DSH taskbar icon, exits with DSH); `browser` = dedicated `--app` browser instance. If the selected type is unavailable, it falls back to the default-browser handoff (official open method, plain tab) |
 | `exitOnWindowClose` | `false` | **（Experimental）** Exit DSH when the auto-opened window closes (off by default; only effective while `appWindow` is on). Triggered only when the window process exits **normally** (user closes the window) → `process.exit(0)`; startup failures/crashes/force-kills (non-zero exit code) do not trigger, preventing accidental exits. **Takes effect immediately in the current session after saving** (the exit listener is always registered; behavior is driven by a live flag), no restart needed |
 | `browserPath` | `''` | Manual browser executable path (single entry, e.g. `C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe`; used only in browser mode), preferred over the built-in candidates Edge → Chrome; a non-existent path is skipped with a warning. The "Browse" button on the card opens a **native file dialog**: same mechanism as the official workspace directory picker (child process + koffi-driven `IFileOpenDialog`; the dialog is the child's first window and is automatically brought to front; no PowerShell). The "Test" button **actually launches** a dedicated `--app` test instance (separate user-data-dir `~/.dsh/<browser>-test-profile`, never pollutes the real instance): after confirming the browser main process stays alive it reports success, then automatically ends that test process tree after a few seconds of display (exact pid, never touches the real instance; the test instance is also placed in the Job Object when available as an exit safety net); the test uses the currently typed path (works even when unsaved), and failures show the reason |
 
@@ -185,8 +197,8 @@ without touching the package.
 ## Platform support
 
 - Windows: `windowKind: webview2` (default, DSH taskbar icon) or `windowKind: browser` (dedicated
-  `--app` instance); nothing opens if the selected type is unavailable
-- macOS/Linux: `webview2` mode is unavailable (logs and opens nothing); `browser` mode is untested
+  `--app` instance); falls back to the default-browser handoff (official open method, plain tab) if the selected type is unavailable
+- macOS/Linux: `webview2` mode is unavailable (falls back to the default-browser handoff); `browser` mode is untested
   (dedicated `--app` instance)
 
 ## Edge cases

package/README.md

@@ -27,8 +27,13 @@ dsh web profile 启动后自动打开独立应用窗口（或网页标签页）
    依赖任何退出事件。另有两层兜底：DSH 正常退出时 `process 'exit'` 结束该
    专用实例的整个进程树（仅匹配我们自己的 user-data-dir，不影响正常浏览器）；
    DSH 被强杀后的残留实例由下次启动前预清理。
-3. 所选类型不可用时（宿主缺失/浏览器找不到/非 Windows 等）→ **不打开任何东西**
-   （记录日志），不自动交叉兜底。
+3. **默认浏览器打开（最后兜底）**：所选类型不可用时（宿主缺失/浏览器找不到/
+   非 Windows 等）→ **降级为官方同款的默认浏览器交接**——把 URL 交给操作系统
+   默认浏览器（普通标签页），保证用户至少能打开 GUI。实现与 DSH 核心
+   （web-app bundle）启动时打开网页的方式一致：优先用 DSH 部署自带的
+   `open` 包（win32 = PowerShell Start，darwin = `open`，linux = `xdg-open`），
+   `open` 包不可用时退回平台原生拉起（win32 = `cmd /c start`，darwin = `open`，
+   linux = `xdg-open`）。
    `appWindow: false` 时不自动打开任何窗口。
 
 端口取自 webServer 服务的真实监听值（`--port` 自定义、`--port 0` 均正确）。
@@ -38,6 +43,12 @@ webServer 插件 `Service.init()` 完成（HTTP socket 已绑定、端口已写
 两种模式都随 DSH 退出而关闭：webview2 宿主监视父进程；browser 专用实例由
 Job Object（强杀也生效）+ 退出清理结束进程树。
 
+> **与 DSH 核心浏览器交接的关系**：DSH 核心（web-app bundle）默认会在启动后
+> 用系统默认浏览器打开 GUI（`openBrowser: true`，普通标签页/窗口，非独立窗口）。
+> 安装本插件后，插件的 bundle 补丁会把 `web-runtime.openBrowser` 置为 `false`，
+> 只保留插件的独立应用窗口，不再弹出普通浏览器页面；卸载插件后恢复默认行为
+> （临时关闭也可用 `dsh web --no-open`）。
+
 ### WebView2 宿主要求（仅 webview2 模式）
 
 - Windows 10 1803+ / Windows 11 / Windows Server 2016+
@@ -169,8 +180,8 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
 
 ## 平台支持
 
-- Windows：`windowKind: webview2`（默认，任务栏图标 DSH）或 `windowKind: browser`（--app 专用实例）；所选类型不可用则不打开
-- macOS/Linux：`webview2` 模式不可用（会记录日志不打开）；`browser` 模式未测试（--app 专用实例）
+- Windows：`windowKind: webview2`（默认，任务栏图标 DSH）或 `windowKind: browser`（--app 专用实例）；所选类型不可用时降级为默认浏览器打开（官方同款，普通标签页）
+- macOS/Linux：`webview2` 模式不可用（降级为默认浏览器打开）；`browser` 模式未测试（--app 专用实例）
 
 ## 边界情况
 

package/cordis.patch.yml

@@ -3,3 +3,15 @@
 - insert:
     - id: auto-open-web
       name: dsh-auto-open-web
+
+# 本插件用独立应用窗口打开 GUI,替代 DSH 核心(web-app bundle)启动后的
+# 默认浏览器交接,避免同时弹出普通浏览器页面(核心的 openBrowser 默认 true,
+# 会以普通标签页/窗口打开 GUI;插件窗口才是"独立应用窗口")。
+# 补丁按 id 整体替换 config,故逐键重述 web-runtime 原配置,仅把
+# openBrowser 置为 false(trustedHosts 保留 webStartup 提供的原表达式)。
+- id: web-runtime
+  config:
+    openBrowser: false
+    printUrl: true
+    surfaceContext: true
+    trustedHosts: !!js ctx.webStartup.trustedHosts

package/lib/client.js

@@ -1,7 +1,7 @@
 // dsh-auto-open-web — Client bundle(设置卡片,与官方 Shell/Agent loop 卡片同构)
 // 格式:window.__ModuleLoader__.load({ id, factory });factory(require) 的
 // require 解析浏览器端冻结模块表(react、@deepseek-ai/dsh-client-ui-primitives、
-// @deepseek-ai/dsh-client-schema-form 等)。
+// @deepseek-ai/dsh-client-runtime)。
 //
 // 架构完全对齐官方 @deepseek-ai/dsh-client-ui-settings-plugins:
 //   - 数据通道:settingsScope.bind({namespace})(官方 settings 域,dsh ≥0.1.0-rc.7
@@ -12,7 +12,8 @@
 //     附带"浏览/测试"按钮槽);checkbox/radio 值型字段自绘但带同款徽章
 //   - 外壳:PluginCard 移植(折叠/未保存标记/只读提示/放弃/保存/保存失败)
 //   - 文案:locale 注册(zh/en),与官方同机制
-//   - 依赖:manifest 5 包 + 代码级 5 服务,与官方 settings-plugins 完全一致
+//   - 依赖:react/primitives(壳层 seed 词)+ dsh-client-runtime(动态包)
+//     + 代码级 5 服务,与官方 settings-plugins 一致
 //
 // 宿主保留的辅助路由(官方通道无法覆盖):
 //   POST /auto-open-web/pick-browser → 原生"浏览"对话框
@@ -55,20 +56,44 @@ window.__ModuleLoader__.load({
     injectCss(EXTRA_TAG, EXTRA_CSS)
 
     // ---- 官方共享模块(冻结表) ----
+    // 与官方 settings-plugins 同源:react/primitives 是壳层 seed 词,
+    // dsh-client-runtime 是动态包(经 /plugins/<pkg>/client.js 提供)。
+    // 各 require 独立容错:任一可选模块缺失不得拖垮其余模块(尤其 runtime)。
     var prim = null
-    var form = null
     var runtime = null
     try {
       prim = require('@deepseek-ai/dsh-client-ui-primitives')
-      form = require('@deepseek-ai/dsh-client-schema-form')
+    } catch (e) {
+      console.error('[auto-open-web] primitives require failed:', e !== null && e !== undefined && e.message !== undefined ? e.message : String(e))
+    }
+    try {
       runtime = require('@deepseek-ai/dsh-client-runtime')
     } catch (e) {
-      console.error('[auto-open-web] shared modules require failed:', e !== null && e !== undefined && e.message !== undefined ? e.message : String(e))
+      console.error('[auto-open-web] runtime require failed:', e !== null && e !== undefined && e.message !== undefined ? e.message : String(e))
     }
     var Button = prim !== null && prim.Button !== undefined ? prim.Button : null
     var Input = prim !== null && prim.Input !== undefined ? prim.Input : null
     var ChevronIcon = prim !== null && prim.IconChevronDownOutline14 !== undefined ? prim.IconChevronDownOutline14 : null
-    var createSnapshotStore = runtime !== null && runtime.createSnapshotStore !== undefined ? runtime.createSnapshotStore : null
+    // 快照 store 契约与官方一致:{ getSnapshot, subscribe, set }。runtime 缺失
+    // 或版本不含 createSnapshotStore 时退化为内置最小实现(卡片仍可用)。
+    var createSnapshotStore = runtime !== null && runtime.createSnapshotStore !== undefined ? runtime.createSnapshotStore : fallbackSnapshotStore
+    function fallbackSnapshotStore(init) {
+      let value = init
+      const listeners = new Set()
+      return {
+        getSnapshot: () => value,
+        subscribe: (listener) => {
+          listeners.add(listener)
+          return () => {
+            listeners.delete(listener)
+          }
+        },
+        set: (next) => {
+          value = next
+          for (const listener of [...listeners]) listener(value)
+        }
+      }
+    }
 
     function ProxyInput(props) {
       if (Input !== null) return React.createElement(Input, props)

package/lib/index.js

@@ -7,12 +7,14 @@
  *   - Windows:   lib/win32.js(全量实现)
  *   - 其他平台:  lib/posix.js(降级实现,记日志不打开)
  *
- * 行为:
+ * 行为(逐级降级,前一级失败即进入下一级):
  *  1. 默认打开 **WebView2 宿主窗口**(随包分发的 DshAppWindow.exe,独立进程,
  *     无标签栏/地址栏,直接加载 GUI 根地址):窗口/任务栏图标 = DSH(Form.Icon);
  *     宿主监视父进程 PID,随 DSH 退出而关闭。
  *  2. 宿主缺失/启动失败 → `--app` **专用浏览器实例**(--user-data-dir 隔离,
- *     不与正常浏览器页面共用进程);再失败则不打开任何东西(仅记录日志)。
+ *     不与正常浏览器页面共用进程)。
+ *  3. 再失败 → **默认浏览器打开**(官方 dsh web 同款 open 交接,普通标签页,
+ *     作为最后的兜底;open 包不可用时平台原生 cmd start / open / xdg-open)。
  *
  * 配置来源:行配置(cordis.patch.yml)作为启动种子;设置页卡片(客户端 bundle,
  * settings.plugin.item 插槽)经官方 settings 域(settingsScope)读写本命名
@@ -28,6 +30,7 @@ import { spawn } from 'node:child_process';
 import { existsSync, rmSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
 import { dshHome, appProfileDir, testProfileDir, instanceStateFile } from './paths.js';
 import * as platform from './platform.js';
 
@@ -72,7 +75,7 @@ export const Config = z.object({
   appWindow: z.boolean().default(true),
   /** 窗口类型:webview2 = WebView2 宿主(独立进程,任务栏 DSH 图标,随 DSH 退出);
    *  browser = 浏览器 --app 专用实例(--user-data-dir 隔离)。所选类型不可用时
-   *  不打开任何东西(仅记录日志),不自动交叉兜底。 */
+   *  降级为最后的兜底:默认浏览器打开(官方 dsh web 同款,普通标签页)。 */
   windowKind: z.union([z.const('webview2'), z.const('browser')]).default('webview2'),
   /** 手动维护的浏览器可执行文件路径(单条;优先于内置候选 Edge → Chrome;仅 browser 模式使用)。 */
   browserPath: z.string().default(''),
@@ -231,6 +234,66 @@ function spawnHostWindow(exe, url, iconPath) {
   }
 }
 
+// ── 最后的兜底:默认浏览器打开(官方 dsh web 同款) ──────────────────────────
+//
+// 官方(web-app bundle)启动后把 URL 交给操作系统默认浏览器,方式是:在独立
+// node 子进程里用 `open` npm 包打开(win32 = PowerShell Start,darwin = open,
+// linux = xdg-open),win32 下还等待启动器退出码确认交接成功。本插件把这一
+// 方式作为 WebView2 宿主与 --app 专用实例都失败后的最后兜底——至少用户能
+// 打开 GUI(普通标签页)。
+//
+// open 包解析策略(与 schemastery/koffi 同一模式):常规 import(profile 已装)
+// 优先,其次 DSH 部署副本(官方 web-app 的依赖,open@11,纯 ESM,须先 resolve
+// 出文件路径再动态 import)。open 包不可用时退回平台适配器原生拉起
+// (win32: cmd start;darwin: open;linux: xdg-open)。
+let openPkgPromise = null;
+
+/** 解析 open 包(惰性 + 缓存);两次解析均失败返回 null。 */
+function getOpenPackage() {
+  if (openPkgPromise === null) {
+    openPkgPromise = (async () => {
+      try {
+        const mod = await import('open');
+        if (mod !== null && mod !== undefined && mod.default !== undefined) return mod.default;
+      } catch {
+        /* 常规解析失败,尝试部署副本 */
+      }
+      try {
+        const globalRoot = process.env.APPDATA ? join(process.env.APPDATA, 'npm', 'node_modules') : '';
+        const dshEntry = join(globalRoot, '@deepseek-ai', 'dsh', 'package.json');
+        if (existsSync(dshEntry)) {
+          const resolved = createRequire(dshEntry).resolve('open');
+          const mod = await import(pathToFileURL(resolved).href);
+          if (mod !== null && mod !== undefined && mod.default !== undefined) return mod.default;
+        }
+      } catch {
+        /* 部署解析失败 */
+      }
+      return null;
+    })();
+  }
+  return openPkgPromise;
+}
+
+/**
+ * 最后兜底:把 URL 交给操作系统默认浏览器(普通标签页)。
+ * 优先 open 包(与官方同一路径);不可用/启动失败时退回平台原生拉起。
+ * 返回 true = 已交给默认浏览器;false = 全部失败(调用方仅记录日志,
+ * 提示手动访问 URL)。
+ */
+async function openDefaultBrowser(url) {
+  const openPkg = await getOpenPackage();
+  if (openPkg !== null && openPkg !== undefined) {
+    try {
+      await openPkg(url); // wait:false → spawn 后即 resolve,子进程已 unref
+      return true;
+    } catch (error) {
+      console.error(`[auto-open-web] open package launch failed: ${error.message}`);
+    }
+  }
+  return platform.openDefaultBrowser(url);
+}
+
 // ── 配置与历史迁移(共通) ─────────────────────────────────────────────────
 
 /** 删除 v0.3 遗留的 state 文件(一次性清理,防孤儿数据)。 */
@@ -354,6 +417,8 @@ export const internals = {
   buildIco,
   resolveHostExe: platform.resolveHostExe,
   spawnHostWindow,
+  getOpenPackage,
+  openDefaultBrowser,
   /** 测试钩子:同步"窗口关闭时退出 DSH"生效标志(模拟设置保存)。 */
   setExitWatcherEnabled(value) {
     exitWatcherEnabled = value === true;
@@ -495,7 +560,18 @@ export function apply(ctx, config) {
     const url = `http://127.0.0.1:${String(server.port)}`;
 
     // 独立应用窗口:按 windowKind 显式选择(webview2 | browser),直接加载 GUI 根地址。
-    // 所选类型不可用时仅记录日志,不打开任何东西,不自动交叉兜底。
+    // 所选类型不可用时降级到最后兜底:默认浏览器打开(官方 dsh web 同款,
+    // 普通标签页),保证用户至少能打开 GUI。
+    const fallbackOpen = async (reason) => {
+      console.log(`[auto-open-web] ${reason}; falling back to default browser (official open method)`);
+      const ok = await openDefaultBrowser(url);
+      if (ok) {
+        console.log(`[auto-open-web] opened default browser at ${url}`);
+      } else {
+        console.error('[auto-open-web] default browser open failed; visit the URL manually');
+      }
+    };
+
     if (state.appWindow) {
       if (state.windowKind === 'browser') {
         const resolved = platform.resolveBrowserExe(state.browserPath);
@@ -509,21 +585,21 @@ export function apply(ctx, config) {
             console.log(`[auto-open-web] opened browser app window (${resolved.browser} --app) at ${url}`);
             return;
           }
-          console.log('[auto-open-web] browser app window launch failed; not opening anything');
-        } else {
-          console.log('[auto-open-web] no Edge/Chrome executable found; not opening anything');
+          await fallbackOpen('browser app window launch failed');
+          return;
         }
+        await fallbackOpen('no Edge/Chrome executable found');
         return;
       }
 
       // webview2 模式
       if (!platform.isWindows) {
-        console.log('[auto-open-web] webview2 mode requires Windows; not opening anything');
+        await fallbackOpen('webview2 mode requires Windows');
         return;
       }
       const hostExe = platform.resolveHostExe();
       if (hostExe === null) {
-        console.log('[auto-open-web] host exe not found; not opening anything');
+        await fallbackOpen('host exe not found');
         return;
       }
       const iconPath = await ensureIconFile(server);
@@ -532,7 +608,7 @@ export function apply(ctx, config) {
         console.log(`[auto-open-web] opened host window (DshAppWindow) at ${url}`);
         return;
       }
-      console.log('[auto-open-web] host window launch failed; not opening anything');
+      await fallbackOpen('host window launch failed');
       return;
     }
 

package/lib/platform.js

@@ -9,6 +9,7 @@
 //   killProcessTree(pid)
 //   pickBrowserExe()             → Promise<string | null>
 //   resolveHostExe()             → string | null
+//   openDefaultBrowser(url)      → Promise<boolean>(原生拉起默认浏览器,兜底)
 //
 // 按平台**条件加载**适配器(ESM 顶层 await):
 //   - Windows:加载 win32.js(koffi 驱动 Job Object / 进程校验 / 原生对话框)
@@ -25,3 +26,4 @@ export const killDedicatedBrowserInstances = impl.killDedicatedBrowserInstances;
 export const killProcessTree = impl.killProcessTree;
 export const pickBrowserExe = impl.pickBrowserExe;
 export const resolveHostExe = impl.resolveHostExe;
+export const openDefaultBrowser = impl.openDefaultBrowser;

package/lib/posix.js

@@ -6,7 +6,10 @@
 //   - 专用实例清理:无操作(Unix 下浏览器实例由 Job-less 方式管理,暂无实现)
 //   - 进程树终止:尽力而为(SIGKILL 单进程,后代进程不保证)
 //   - 原生文件对话框:不支持(返回 null,卡片提示手动输入)
-//   - WebView2 宿主:无(返回 null,webview2 模式记日志不打开)
+//   - WebView2 宿主:无(返回 null,webview2 模式降级到最后兜底)
+//   - 默认浏览器打开:原生拉起(darwin: open;linux: xdg-open)
+import { spawn } from 'node:child_process';
+
 export const isWindows = false;
 
 export function resolveBrowserExe() {
@@ -40,3 +43,23 @@ export function pickBrowserExe() {
 export function resolveHostExe() {
   return null;
 }
+
+/**
+ * 原生默认浏览器打开(最后兜底,open 包不可用时):darwin 用 open,其余
+ * 平台用 xdg-open。detached + stdio ignore,不阻塞 DSH;启动失败返回 false。
+ */
+export function openDefaultBrowser(url) {
+  const command = process.platform === 'darwin' ? 'open' : 'xdg-open';
+  return new Promise((resolve) => {
+    let child;
+    try {
+      child = spawn(command, [url], { detached: true, stdio: 'ignore' });
+    } catch {
+      resolve(false);
+      return;
+    }
+    child.on('error', () => resolve(false));
+    child.on('exit', (code) => resolve(code === 0));
+    child.unref();
+  });
+}

package/lib/win32.js

@@ -381,3 +381,28 @@ export function resolveHostExe() {
   const exe = fileURLToPath(new URL('../host-publish/DshAppWindow.exe', import.meta.url));
   return existsSync(exe) ? exe : null;
 }
+
+// ── 原生默认浏览器打开(最后兜底,open 包不可用时) ─────────────────────────
+//
+// 与官方 web-app 同效但零依赖:cmd /c start 把 URL 交给系统默认浏览器
+// (普通标签页)。detached + stdio ignore + windowsHide,不闪控制台窗口、
+// 不阻塞 DSH;启动失败(找不到 cmd)返回 false。exit code 仅作参考——start
+// 交出 URL 后 cmd 即退出,交接是否成功由操作系统决定。
+export function openDefaultBrowser(url) {
+  return new Promise((resolve) => {
+    let child;
+    try {
+      child = spawn('cmd.exe', ['/d', '/c', 'start', '', url], {
+        detached: true,
+        stdio: 'ignore',
+        windowsHide: true,
+      });
+    } catch {
+      resolve(false);
+      return;
+    }
+    child.on('error', () => resolve(false));
+    child.on('exit', (code) => resolve(code === 0));
+    child.unref();
+  });
+}

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "dsh-auto-open-web",
-  "version": "0.1.5",
+  "version": "0.1.9",
   "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",
+    "url": "https://github.com/jinsiyu/dsh-auto-open-web.git"
+  },
   "type": "module",
   "main": "lib/index.js",
   "scripts": {