dsh-auto-open-web 0.1.3 → 0.1.4

package/README.en.md

@@ -86,14 +86,14 @@ whole config; fields not listed fall back to defaults):
 
 This package is a **bundle**: an npm package carrying a configuration layer — `dsh.bundle` in
 `package.json` declares the patch file (`cordis.patch.yml`), and a profile activates the plugin row
-by package name when installed. Published to the **npm registry** (`dsh-auto-open-web@0.1.3`) and
+by package name when installed. Published to the **npm registry** (`dsh-auto-open-web@0.1.4`) and
 **GitHub** (https://github.com/jinsiyu/dsh-auto-open-web, `main` branch).
 
 ### Packaging
 
 ```bash
 cd dsh-auto-open-web
-pnpm pack          # the prepack hook compiles the WebView2 host first (dotnet publish), producing dsh-auto-open-web-0.1.3.tgz
+pnpm pack          # the prepack hook compiles the WebView2 host first (dotnet publish), producing dsh-auto-open-web-0.1.4.tgz
 ```
 
 ### Installation (pick one)
@@ -108,7 +108,7 @@ dsh plugin --profile web add C:\path\to\dsh-auto-open-web
 **Option 2: tarball (published artifact, recommended for delivery; no build permission needed)**
 
 ```bash
-dsh plugin --profile web add ./dsh-auto-open-web-0.1.3.tgz
+dsh plugin --profile web add ./dsh-auto-open-web-0.1.4.tgz
 ```
 
 **Option 3: npm registry (after publishing)**
@@ -145,6 +145,11 @@ without touching the package.
 
 ### Notes
 
+- **DSH version requirement**: this plugin supports **dsh `>=0.1.0-rc.7 <0.2.0`** (declared as an
+  optional peer, provided by the DSH deployment, no install warnings). `settings.plugin.item`
+  became a keyed slot in that release; the card registers with both `id` and `key` so it mounts on
+  both old and new dsh generations. Below the supported range the host logs a clear error at
+  startup (pointing to a dsh upgrade) and the card may not mount.
 - **The npm package already contains the compiled WebView2 host** (built by the prepack hook before
   publishing); the **GitHub `main` branch and source-checkout installs do not** include
   `host-publish/` (build artifacts are .gitignore'd): for webview2 mode, run
@@ -167,7 +172,7 @@ without touching the package.
   win32.js is never evaluated on posix.
 - If installing by editing `package.json` manually (not via the `dsh plugin` command), you must add
   both the `dependencies` entry and `dsh.profile.bundles`; when using a local `file:` dependency,
-  `dsh web` normalizes `file:` to `^0.1.3` at startup, which does not affect runtime.
+  `dsh web` normalizes `file:` to `^0.1.4` at startup, which does not affect runtime.
 
 ## Icons
 

package/README.md

@@ -79,14 +79,14 @@ Job Object（强杀也生效）+ 退出清理结束进程树。
 
 本包是**组合包(bundle)**:一个附带配置层的 npm 包——`package.json` 的
 `dsh.bundle` 声明配置层文件(`cordis.patch.yml`),profile 安装它时按包名激活
-插件行。已发布到 **npm registry**(`dsh-auto-open-web@0.1.3`)与 **GitHub**
+插件行。已发布到 **npm registry**(`dsh-auto-open-web@0.1.4`)与 **GitHub**
 （https://github.com/jinsiyu/dsh-auto-open-web，main 分支）。
 
 ### 打包
 
 ```bash
 cd dsh-auto-open-web
-pnpm pack          # prepack 钩子自动先编译 WebView2 宿主(dotnet publish),产出 dsh-auto-open-web-0.1.3.tgz
+pnpm pack          # prepack 钩子自动先编译 WebView2 宿主(dotnet publish),产出 dsh-auto-open-web-0.1.4.tgz
 ```
 
 ### 安装方式(任选其一)
@@ -101,7 +101,7 @@ dsh plugin --profile web add C:\path\to\dsh-auto-open-web
 **方式二:tarball(发布产物,推荐交付;无需构建授权)**
 
 ```bash
-dsh plugin --profile web add ./dsh-auto-open-web-0.1.3.tgz
+dsh plugin --profile web add ./dsh-auto-open-web-0.1.4.tgz
 ```
 
 **方式三:npm 注册表(发布后)**
@@ -137,6 +137,10 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
 
 ### 注意事项
 
+- **dsh 版本要求**:本插件支持 **dsh `>=0.1.0-rc.7 <0.2.0`**(peer 声明,由 DSH 部署
+  提供,安装无警告)。`settings.plugin.item` 自该版本起为 keyed 插槽,卡片注册
+  同时提供 `id` 与 `key` 以兼容新旧两代 dsh;低于支持范围时宿主启动会记录
+  明确错误日志(提示升级 dsh),卡片可能无法挂载。
 - **npm 包已含 WebView2 宿主编译产物**(prepack 编译后发布);**GitHub
   main 分支与源码 checkout 方式不含** `host-publish/`(构建产物被
   .gitignore 忽略):webview2 模式需先在 `node_modules/dsh-auto-open-web`
@@ -153,7 +157,7 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
   不可用),且平台适配器按平台条件加载,posix 上完全不求值 win32.js。
 - 若手动编辑 `package.json` 安装(不经 dsh plugin 命令),需同时追加
   `dependencies` 与 `dsh.profile.bundles` 两项;使用本地 `file:` 依赖时
-  `dsh web` 启动会把 `file:` 规范化成 `^0.1.3`,运行时不受影响。
+  `dsh web` 启动会把 `file:` 规范化成 `^0.1.4`,运行时不受影响。
 
 ## 图标
 

package/host-publish/DshAppWindow.deps.json

@@ -6,7 +6,7 @@
   "compilationOptions": {},
   "targets": {
     ".NETCoreApp,Version=v10.0": {
-      "DshAppWindow/0.1.3": {
+      "DshAppWindow/0.1.4": {
         "dependencies": {
           "Microsoft.Web.WebView2": "1.0.3124.44",
           "Microsoft.Web.WebView2.Core": "1.0.3124.44",
@@ -63,7 +63,7 @@
     }
   },
   "libraries": {
-    "DshAppWindow/0.1.3": {
+    "DshAppWindow/0.1.4": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/lib/client.js

@@ -383,9 +383,13 @@ window.__ModuleLoader__.load({
         console.error('[auto-open-web] slots service unavailable')
         return
       }
+      // settings.plugin.item 注册的 dsh 版本兼容:
+      //   dsh ≥0.1.0-rc.7 为 keyed 插槽,必须带 options.key;
+      //   更早版本为 list 插槽,必须带 options.id。
+      // 同时提供 id 与 key:新版取 key,旧版取 id,两代 dsh 都能挂载卡片。
       slots.inject('settings.plugin.item', () =>
         slots.register(
-          { name: 'settings.plugin.item', id: 'auto-open-web', order: 40, label: '自动打开网页' },
+          { name: 'settings.plugin.item', id: 'auto-open-web', key: 'auto-open-web', order: 40, label: '自动打开网页' },
           () => React.createElement(AutoOpenSettingsPage, null)
         )
       )

package/lib/index.js

@@ -23,7 +23,7 @@
  * (WebView2 宿主例外:随 DSH 退出而关闭)。
  */
 import { spawn } from 'node:child_process';
-import { rmSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import z from '@deepseek-ai/schemastery';
 import { dshHome, appProfileDir, testProfileDir, instanceStateFile } from './paths.js';
@@ -311,6 +311,48 @@ 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),行为由本标志实时决定:
@@ -332,11 +374,24 @@ export const internals = {
   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', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-auto-open-web",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Open the DSH Web GUI in an app-style WebView2 window on profile start, with a settings card for browser paths",
   "type": "module",
   "main": "lib/index.js",
@@ -42,5 +42,13 @@
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"
   },
+  "peerDependencies": {
+    "@deepseek-ai/dsh": ">=0.1.0-rc.7 <0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh": {
+      "optional": true
+    }
+  },
   "license": "MIT"
 }