dsh-auto-open-web 0.1.4 → 0.1.9

package/lib/index.js

@@ -7,28 +7,58 @@
  *   - 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 插槽)经 /auto-open-web/config API 读写,持久化到官方
- * settings 命名空间 `auto-open-web`(首次保存后设置值优先于行配置)。
+ * settings.plugin.item 插槽)经官方 settings 域(settingsScope)读写本命名
+ * 空间,持久化到官方 settings 文档(首次保存后设置值优先于行配置)。
+ * 宿主保留的辅助路由:/auto-open-web/pick-browser(原生浏览对话框)、
+ * /auto-open-web/test-browser(浏览器拉起测试)。
  *
  * 端口来自 webServer 服务的真实监听值(--port 自定义、--port 0 均正确)。
  * 打开窗口的子进程 detached + unref,不阻塞 DSH、不随 DSH 退出被终止
  * (WebView2 宿主例外:随 DSH 退出而关闭)。
  */
 import { spawn } from 'node:child_process';
-import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { existsSync, rmSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
 import { join } from 'node:path';
-import z from '@deepseek-ai/schemastery';
+import { pathToFileURL } from 'node:url';
 import { dshHome, appProfileDir, testProfileDir, instanceStateFile } from './paths.js';
 import * as platform from './platform.js';
 
+/**
+ * schemastery 依赖策略(与 win32.js 的 koffi 同一模式):本包零 dependencies,
+ * schemastery 由 DSH 部署自带(官方核心依赖),运行时解析:
+ *   常规 import(profile 已装/手动安装)优先 → Windows 全局 npm 布局的
+ *   DSH 部署副本;两者都不可用时模块加载失败(插件依赖 Config,无法降级)。
+ */
+let z = null;
+try {
+  z = (await import('@deepseek-ai/schemastery')).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)) z = createRequire(dshEntry)('@deepseek-ai/schemastery');
+  } catch {
+    /* 两次解析均失败 → 下方抛错 */
+  }
+}
+if (z === null || z === undefined) {
+  throw new Error(
+    '[auto-open-web] schemastery not found (neither local nor DSH deployment); ' +
+      'this plugin cannot build its config schema. Check the DSH deployment.',
+  );
+}
+
 export const name = 'auto-open-web';
 
 /**
@@ -45,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(''),
@@ -53,7 +83,6 @@ export const Config = z.object({
   exitOnWindowClose: z.boolean().default(false),
 });
 
-const CONFIG_API_PATH = '/auto-open-web/config';
 const PICK_API_PATH = '/auto-open-web/pick-browser';
 const TEST_API_PATH = '/auto-open-web/test-browser';
 const ICON_SIZES = [16, 32, 48, 64, 128, 256];
@@ -205,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 文件(一次性清理,防孤儿数据)。 */
@@ -311,48 +400,6 @@ async function ensureIconFile(server) {
 
 // ── 插件主体 ─────────────────────────────────────────────────────────────
 
-/**
- * dsh 宿主版本兼容范围(与 package.json 的 peerDependencies 一致):
- * settings.plugin.item 自 dsh 0.1.0-rc.7 起为 keyed 插槽(注册需 options.key);
- * 0.1.4 的卡片注册同时提供 id 与 key,新旧两代 dsh 均可挂载,但低于
- * 0.1.0-rc.7 时官方 UI 未定义该插槽的 keyed 语义,超出支持范围。
- */
-const DSH_MIN_VERSION = '0.1.0-rc.7';
-const DSH_MAX_VERSION = '0.2.0';
-
-/** 解析 "x.y.z[-rc.N]" 为数值数组;rc 缺失视为 Infinity(正式版 > 同号 rc)。失败返回 null。 */
-function parseVersion(text) {
-  const m = /^(\d+)\.(\d+)\.(\d+)(?:-rc\.(\d+))?/.exec(String(text).trim());
-  if (m === null) return null;
-  return [Number(m[1]), Number(m[2]), Number(m[3]), m[4] !== undefined ? Number(m[4]) : Infinity];
-}
-
-function compareVersions(a, b) {
-  return a[0] - b[0] || a[1] - b[1] || a[2] - b[2] || a[3] - b[3];
-}
-
-/** dsh 版本是否在支持范围内;版本未知(读不到/解析失败)返回 true(不误伤)。 */
-export function isDshVersionSupported(versionText) {
-  const v = parseVersion(versionText);
-  const min = parseVersion(DSH_MIN_VERSION);
-  const max = parseVersion(DSH_MAX_VERSION);
-  if (v === null || min === null || max === null) return true;
-  return compareVersions(v, min) >= 0 && compareVersions(v, max) < 0;
-}
-
-/** 尽力读取部署的 dsh 版本(Windows 全局 npm 布局;其余环境返回 null)。 */
-export function detectDshVersion() {
-  try {
-    const globalRoot = process.env.APPDATA ? join(process.env.APPDATA, 'npm', 'node_modules') : '';
-    const entry = join(globalRoot, '@deepseek-ai', 'dsh', 'package.json');
-    if (!existsSync(entry)) return null;
-    const version = JSON.parse(readFileSync(entry, 'utf8')).version;
-    return typeof version === 'string' && version !== '' ? version : null;
-  } catch {
-    return null;
-  }
-}
-
 /**
  * 窗口退出监听共享标志:"窗口关闭时退出 DSH"当前是否生效。
  * 监听始终注册(见 openAppWindow/spawnHostWindow),行为由本标志实时决定:
@@ -370,28 +417,17 @@ export const internals = {
   buildIco,
   resolveHostExe: platform.resolveHostExe,
   spawnHostWindow,
+  getOpenPackage,
+  openDefaultBrowser,
   /** 测试钩子:同步"窗口关闭时退出 DSH"生效标志(模拟设置保存)。 */
   setExitWatcherEnabled(value) {
     exitWatcherEnabled = value === true;
   },
-  isDshVersionSupported,
-  detectDshVersion,
 };
 
 export function apply(ctx, config) {
   removeLegacyState();
 
-  // dsh 宿主版本约束(声明性):低于支持范围时明确提示(宿主能力兼容,
-  // 卡片注册做了新旧双兼容,不硬停;日志指导用户升级 dsh)。
-  const dshVersion = detectDshVersion();
-  if (dshVersion !== null && !isDshVersionSupported(dshVersion)) {
-    console.error(
-      `[auto-open-web] DSH version ${dshVersion} is outside the supported range ` +
-        `(${DSH_MIN_VERSION} <= dsh < ${DSH_MAX_VERSION}); the settings card may not mount. ` +
-        'Please upgrade dsh to continue using this plugin.',
-    );
-  }
-
   // browser 模式的专用实例随 DSH 退出:正常退出时结束其实例进程树
   // (被强杀时由下次启动前的预清理兜底)。
   process.on('exit', () => {
@@ -434,7 +470,9 @@ export function apply(ctx, config) {
   }
   syncExitWatcher(); // 启动时的最终生效值(settings 已合并或行配置)
 
-  // ---- 设置卡片 API(读写与测试,配置由宿主权威校验) ----
+  // ---- 卡片辅助 API(浏览/测试;设置读写走官方 settings 域) ----
+  // 设置卡片经客户端 settingsScope(settings 域)读写本命名空间,不再自建
+  // config 路由;这里只保留官方通道无法覆盖的能力。
   function sendJson(res, status, value) {
     res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' });
     res.end(JSON.stringify(value));
@@ -445,44 +483,6 @@ export function apply(ctx, config) {
     return body;
   }
   if (typeof server.register === 'function') {
-    server.register({
-      kind: 'exact',
-      path: CONFIG_API_PATH,
-      handler: async (req, res) => {
-        if (req.method === 'GET') {
-          sendJson(res, 200, { ok: true, ...state, writable });
-          return;
-        }
-        if (req.method === 'POST') {
-          if (!writable) {
-            sendJson(res, 200, { ok: false, error: '当前配置只读(settings 不可写)' });
-            return;
-          }
-          let parsed;
-          try {
-            parsed = JSON.parse(await readBody(req));
-          } catch {
-            sendJson(res, 400, { ok: false, error: 'invalid JSON body' });
-            return;
-          }
-          try {
-            const next = normalizeState(parsed);
-            if (scope !== null) await scope.update(next);
-            state = next;
-            syncExitWatcher(); // 保存后即时生效,当前会话无需重启
-            sendJson(res, 200, { ok: true, ...state });
-          } catch (error) {
-            sendJson(res, 200, {
-              ok: false,
-              error: String(error && error.message !== undefined ? error.message : error),
-            });
-          }
-          return;
-        }
-        res.writeHead(405);
-        res.end();
-      },
-    });
     // 原生"浏览"对话框:选择浏览器可执行文件(平台能力;非 Windows 提示手动输入)。
     server.register({
       kind: 'exact',
@@ -560,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);
@@ -574,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);
@@ -597,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.4",
+  "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": {
@@ -22,7 +26,9 @@
       "inject": [
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-client-ui-settings"
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale"
       ]
     }
   },
@@ -39,15 +45,16 @@
     "README.md",
     "README.en.md"
   ],
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1"
-  },
   "peerDependencies": {
-    "@deepseek-ai/dsh": ">=0.1.0-rc.7 <0.2.0"
+    "@deepseek-ai/dsh": ">=0.1.0-rc.7 <0.2.0",
+    "@deepseek-ai/schemastery": "^3.18.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh": {
       "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
     }
   },
   "license": "MIT"