dsh-plugin-wallpaper-engine-pet-link 1.4.0 → 1.4.2

package/lib/index.js

@@ -1,20 +1,114 @@
+import { join } from 'node:path';
 import { registerOfficialPetRoutes } from './routes/official-pet.js';
+import { registerPetInstallRoutes } from './routes/pet-install.js';
+import { createStateProbe } from './pet-install/state-probe.js';
+
+/**
+ * 解析 DSH 数据根（`$DSH_HOME` 或 `<home>/.dsh`）。
+ *
+ * 与 `lib/subpackage-boot.js:493` 的 `dshHome()` 同口径（那边由
+ * `test/verify-subpackage-boot.mjs` 用合成 `DSH_HOME` 交叉对账）。
+ * @param env - process.env（可注入便于测试）
+ * @returns {string|null} 绝对路径；都取不到时返回 null
+ */
+function resolveDshHomeLocal(env = {}) {
+  const e = env || {};
+  const fromEnv = e.DSH_HOME || '';
+  if (typeof fromEnv === 'string' && fromEnv.trim()) return fromEnv.trim();
+  const home = e.USERPROFILE || e.HOME || '';
+  if (typeof home === 'string' && home.trim()) return join(home.trim(), '.dsh');
+  return null;
+}
+
+/**
+ * profile 下真实装包的地方（`<profileDir>/node_modules`）。
+ *
+ * state-probe 读的是这个目录；此前调用方传了 `profileDir`，两边键名对不上，
+ * 于是 `detect()` 恒判「未安装」——2026-11-02 修。
+ * @param {string|null|undefined} profileDir
+ * @returns {string|null}
+ */
+function resolveProfiledNodeModulesLocal(profileDir) {
+  return profileDir ? join(profileDir, 'node_modules') : null;
+}
+
+/**
+ * dsh-pet-dshwe 的运行期数据根（`<DSH_HOME>/dsh-pet-dshwe`，logs.txt 一类运行痕迹）。
+ * @param env - process.env（可注入便于测试）
+ * @returns {string|null}
+ */
+function resolvePetRuntimeDirLocal(env = {}) {
+  const dshHome = resolveDshHomeLocal(env);
+  return dshHome ? join(dshHome, 'dsh-pet-dshwe') : null;
+}
+
+/**
+ * 解析当前 DSH profile 目录（原 transaction.js 的 resolveProfileDir，随下载器一起移除后内联保留）。
+ *
+ * 优先级：config.profileDir → 环境变量 DSH_PROFILE_DIR → <home>/.dsh/profiles/desktop。
+ * 只用于「报告运行时装在哪」，不再参与任何下载或写盘。
+ * @param env - process.env（可注入便于测试）
+ * @returns {string|null} 绝对路径；都取不到时返回 null
+ */
+function resolveProfileDirLocal(env = {}) {
+  const e = env || {};
+  const fromEnv = e.DSH_PROFILE_DIR || e.DSH_PROFILE || '';
+  if (typeof fromEnv === 'string' && fromEnv.trim()) return fromEnv.trim();
+  const dshHome = resolveDshHomeLocal(e);
+  if (dshHome) {
+    return join(dshHome, 'profiles', 'desktop');
+  }
+  return null;
+}
+
 
 export const name = 'dsh-plugin-wallpaper-engine-pet-link';
 export const inject = ['webServer', 'wallpaperEngineHost'];
 export const routeConfigs = Object.freeze([Object.freeze({})]);
 
-/** 官方 pet 是用户独立安装的可选插件；装载时不写它的配置或资源目录。 */
+/**
+ * 可选服务探测：读取同页可能**不存在**的 Cordis 服务。
+ *
+ * ⚠️ 这是可选探测，不是必需依赖 —— 不许把 petApiDshwe 加进上面的 inject。
+ *
+ * 为什么用 `ctx.get` 而不是 inject 声明：pet-link 必须在「没装 dsh-pet-dshwe」时也能加载，
+ * 这是双 provider 的降级前提（联动计划 §3.3）。本机 DSH（dsh-desktop-next 2.0.20-next）实际
+ * 使用的 `@deepseek-ai/cordis@4.0.5` 里，`Inject = (keyof M)[] | { [K in keyof M]?: M[K] }`：
+ * 对象形态的键值对是「服务名 → 拦截配置」，**没有** required / optional 之分；凡写进 inject 的
+ * 服务都是**必需依赖**（fiber 会等它出现才激活，见 registry.ts「required service」）。
+ * 相反，`ctx.get(name)` 是 Cordis 官方提供的「不声明 inject 也能读服务」的入口
+ * （reflect.ts：「Read a service from the store without the inject requirement」），读不到返回
+ * undefined —— 正好是可选探测。所以这里保留 `ctx.get`，并把「可选 vs 必需」的判断收敛到本函数。
+ *
+ * @param {object} ctx - Cordis 上下文。
+ * @param {string} name - 服务名。
+ * @returns {any|null} 服务实例；不存在时为 null（绝不让探测异常冒到装载流程）。
+ */
+export function probeOptionalService(ctx, name) {
+  try {
+    return ctx && typeof ctx.get === 'function' ? (ctx.get(name) ?? null) : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 官方 pet 是用户独立安装的可选插件；装载时不写它的配置或资源目录。
+ *
+ * ⚠️ 这里**不做资源注入**：九段专属动画与五张气泡图已经内置进 `dsh-pet-dshwe` 自己的包
+ * （`assets/webm`、`assets/memes` 与 `assets/config.jsonc` 的 `DSHWE` 池）。桥接只负责发指令，
+ * 不再在装载期往运行时数据根写文件 —— 那是「pet 是第三方包、只能外部注入」时代的做法。
+ */
 export function apply(ctx, config) {
+  config ??= {};
   const host = ctx.wallpaperEngineHost;
   if (!host) throw new Error('[wallpaper-engine] pet-link 缺少 wallpaperEngineHost 服务');
   const keys = host.keys('pet-link', ctx);
   const deps = Object.freeze({ ...keys, http: host.http });
-  return keys.handOffTeardown(ctx, keys.runComponent('pet-link', ctx, config || {}, deps, applyImpl));
+  return keys.handOffTeardown(ctx, keys.runComponent('pet-link', ctx, config, deps, applyImpl));
 }
 
 export function applyImpl(ctx, config = {}, c) {
-  const { webServer } = ctx;
+  const webServer = c.tolerantWebServer(ctx.webServer);
   const { base, http } = c;
   const disposers = [];
   let active = true;
@@ -29,6 +123,17 @@ export function applyImpl(ctx, config = {}, c) {
     registerOfficialPetRoutes(webServer, { disposers, base, http }, {
       isLinkEnabled: () => config.linkEnabled !== false,
     });
+    // 运行时安装态报告（M4）：只读——下载/安装已改由 DSH 官方入口完成。
+    const profileDir = config.profileDir || resolveProfileDirLocal(process.env);
+    const installer = createStateProbe({
+      // 键名必须与 state-probe 的 `opts.profiledNodeModules` / `opts.runtimeDir` 对齐；
+      // 之前传的是 `profileDir`，导致 detect() 永远拿到 null、卡片恒显示「未安装」。
+      profiledNodeModules: config.profiledNodeModules || resolveProfiledNodeModulesLocal(profileDir),
+      runtimeDir: config.runtimeDir || resolvePetRuntimeDirLocal(process.env),
+      // 可选探测：本页没有 dsh-pet-dshwe 时返回 false，不影响 pet-link 装载（见 probeOptionalService）。
+      probeRunning: () => Boolean(probeOptionalService(ctx, 'petApiDshwe')),
+    });
+    registerPetInstallRoutes(webServer, { disposers, base, http }, { installer });
   } catch (error) { dispose(); throw error; }
   return dispose;
 }

package/lib/pet-install/state-probe.js

@@ -0,0 +1,79 @@
+// state-only 探测：只回答「装没装 / 什么版本 / 在不在跑」，不做任何下载或写盘。
+// 2026-11-01 取代原 transaction.js（那套自研下载解包已整体移除：
+// 它绕过 DSH 的依赖管理，与本地 link: 布局冲突，曾造成重复注册 / 误判未安装 / 启动崩溃）。
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+const RUNTIME_NAME = 'dshpet-dshwe';
+const LEGACY_NAME = 'dsh-pet-dshwe';
+const CANDIDATES = [RUNTIME_NAME, LEGACY_NAME];
+
+/**
+ * 找已安装副本：在给定 node_modules 下按候选名找目录，读它的 package.json 版本。
+ * @param {string} nodeModulesDir - profile 的 node_modules 绝对路径
+ * @returns {{installed:boolean,name:string|null,version:string|null,path:string|null}}
+ */
+function detect(nodeModulesDir) {
+  if (!nodeModulesDir || !existsSync(nodeModulesDir)) {
+    return { installed: false, name: null, version: null, path: null };
+  }
+  for (const name of CANDIDATES) {
+    const dir = join(nodeModulesDir, name);
+    const pkg = join(dir, 'package.json');
+    if (!existsSync(pkg)) continue;
+    try {
+      const json = JSON.parse(readFileSync(pkg, 'utf8'));
+      return { installed: true, name, version: typeof json.version === 'string' ? json.version : null, path: dir };
+    } catch {
+      return { installed: true, name, version: null, path: dir };
+    }
+  }
+  return { installed: false, name: null, version: null, path: null };
+}
+
+/**
+ * 跑一次探测；探测本身抛错时按「没在跑」处理（状态行不该因为探测异常变红）。
+ * @param {() => unknown} fn
+ * @returns {boolean}
+ */
+function safelyProbe(fn) {
+  try { return Boolean(fn()); } catch { return false; }
+}
+
+/**
+ * 造一个只读状态提供者，接口与原 installer 的 `state()` 保持兼容
+ * （这样路由与 UI 不用改调用方式）。
+ * @param {{ profiledNodeModules?: string, runtimeDir?: string, probeRunning?: () => boolean }} opts
+ * @returns {{ state: () => object }}
+ */
+export function createStateProbe(opts = {}) {
+  const nodeModulesDir = opts.profiledNodeModules || null;
+  const runtimeDir = opts.runtimeDir || null;
+  const probeRunning = typeof opts.probeRunning === 'function' ? opts.probeRunning : null;
+  return {
+    /** 当前安装态：installed / version / name / path / runtimePresent。纯读，无副作用。 */
+    state() {
+      const found = detect(nodeModulesDir);
+      let runtimePresent = false;
+      try {
+        runtimePresent = Boolean(runtimeDir && existsSync(runtimeDir) && readdirSync(runtimeDir).length > 0);
+      } catch {
+        runtimePresent = false;
+      }
+      return {
+        installed: found.installed,
+        version: found.version,
+        name: found.name,
+        path: found.path,
+        runtimePresent,
+        // pet 宿主半边是否已在本页注册服务（可选探测；没有就是 false，不报错）。
+        running: probeRunning ? safelyProbe(probeRunning) : false,
+        // UI 需要的官方安装入口（不再由本插件代下载）
+        installUrl: 'https://www.npmjs.com/package/dshpet-dshwe',
+        installCommand: 'dsh plugin add dshpet-dshwe',
+      };
+    },
+  };
+}
+
+export { RUNTIME_NAME, LEGACY_NAME, CANDIDATES, detect };

package/lib/routes/official-pet.js

@@ -74,7 +74,16 @@ export function registerOfficialPetRoutes(webServer, c, options = {}) {
         const input = JSON.parse(Buffer.concat(chunks).toString('utf8'));
         if (!enabled()) return send(res, 200, { ok: false, reason: 'bridge-disabled' });
         const methods = { start: coordinator.start, heartbeat: coordinator.heartbeat,
-          command: coordinator.command, finish: coordinator.finish };
+          command: coordinator.command, finish: coordinator.finish,
+          // 浏览器半边 → 宿主日志的诊断通道。
+          // 桌面版没有 DevTools（用户看不到 console），所以把「走位目标算成了什么」
+          // 「气泡配图取图成不成功」这类运行期真值送到宿主日志，由维护者读文件取证。
+          diag: async payload => {
+            try {
+              console.log('[pet-link diag] ' + JSON.stringify(payload?.payload ?? payload));
+            } catch { /* 诊断序列化失败不影响业务 */ }
+            return { ok: true };
+          } };
         if (!Object.hasOwn(methods, input?.op)) return send(res, 400, { ok: false, reason: 'bad-request' });
         return send(res, 200, await methods[input.op](input));
       } catch { return send(res, 400, { ok: false, reason: 'bad-request' }); }
@@ -114,5 +123,58 @@ export function registerOfficialPetRoutes(webServer, c, options = {}) {
         stream.pipe(res);
       } catch { res.statusCode = 404; res.end(); }
      } }));
+  // 引导截图：安装教程用三张图（插件入口 / 添加插件按钮 / 输入包名对话框）。
+  // 与 meme 同款 exact 路由，避免 prefix 命中问题；只从本包 assets/guide/ 出。
+  const guideShots = [
+    { file: fileURLToPath(new URL('../../assets/guide/step1-plugin-entry.png', import.meta.url)), type: 'image/png' },
+    { file: fileURLToPath(new URL('../../assets/guide/step2-add-plugin.png', import.meta.url)), type: 'image/png' },
+    { file: fileURLToPath(new URL('../../assets/guide/step3-dialog.png', import.meta.url)), type: 'image/png' },
+  ];
+  disposers.push(webServer.register({ kind: 'exact', path: `${BASE}/pet-link/official/guide-step`, handler: (req, res) => {
+    try {
+      const step = Number(new URL(req.url || '/', 'http://x').searchParams.get('n'));
+      const shot = Number.isSafeInteger(step) ? guideShots[step - 1] : null;
+      if (!shot) { res.statusCode = 404; res.end(); return; }
+      if (req.method !== 'GET' && req.method !== 'HEAD') { res.statusCode = 405; res.end(); return; }
+      const { size } = statSync(shot.file);
+      res.statusCode = 200;
+      res.setHeader('Content-Type', shot.type);
+      res.setHeader('Content-Length', size);
+      res.setHeader('Cache-Control', 'private, max-age=3600');
+      if (req.method === 'HEAD') { res.end(); return; }
+      const stream = createReadStream(shot.file);
+      streams.add(stream);
+      stream.on('error', () => res.destroy());
+      stream.on('close', () => streams.delete(stream));
+      res.on('close', () => stream.destroy());
+      stream.pipe(res);
+    } catch { res.statusCode = 404; res.end(); }
+  } }));
+  // 气泡配图专用：**exact 路由**按 `?i=<index>` 出一张 PNG。
+  //
+  // 为什么不复用上面的 prefix：`/assets/m<i>.png` 在实测里稳定 404（prefix 路由没命中——
+  // 浏览器侧日志 `{"kind":"meme","ok":false,"reason":"404"}` ×5）。而同一注册器里的 exact
+  // 路由（`/pet-link/official` 的 diag）是通的，所以这里改走 exact，绕开 prefix 的路径解析。
+  // 图仍然只从本包的 `assets/memes/` 出，不复制、不注入。
+  disposers.push(webServer.register({ kind: 'exact', path: `${BASE}/pet-link/official/meme`, handler: (req, res) => {
+    try {
+      const index = Number(new URL(req.url || '/', 'http://x').searchParams.get('i'));
+      const image = Number.isSafeInteger(index) ? images[index] : null;
+      if (!image) { res.statusCode = 404; res.end(); return; }
+      if (req.method !== 'GET' && req.method !== 'HEAD') { res.statusCode = 405; res.end(); return; }
+      const { size } = statSync(image.file);
+      res.statusCode = 200;
+      res.setHeader('Content-Type', image.type);
+      res.setHeader('Content-Length', size);
+      res.setHeader('Cache-Control', 'private, max-age=3600');
+      if (req.method === 'HEAD') { res.end(); return; }
+      const stream = createReadStream(image.file);
+      streams.add(stream);
+      stream.on('error', () => res.destroy());
+      stream.on('close', () => streams.delete(stream));
+      res.on('close', () => stream.destroy());
+      stream.pipe(res);
+    } catch { res.statusCode = 404; res.end(); }
+   } }));
   return coordinator;
 }

package/lib/routes/pet-install.js

@@ -0,0 +1,57 @@
+/**
+ * 路由：pet-link 宿主半的运行时**只读**状态面。
+ *
+ *   GET `${BASE}/pet-link/pet/state` → { ok, installed, name, version, path, runtimePresent,
+ *                                        installUrl, installCommand, running, ... }
+ *
+ * 安装 / 卸载 / 安装进度三条路由已于 2026-11-01 移除（自研下载解包绕过 DSH 依赖管理、
+ * 与 link: 布局冲突，实测造成重复注册 / 误判未安装 / 启动崩溃）；安装改走 DSH 官方入口。
+ * 本文件只负责「装了没有、什么版本、运行时在不在」的只读探测。
+ *
+ * 安全口径与 `routes/official-pet.js` 一致：
+ *   · 同源校验：带 Origin 时必须 http + 本机回环 + 同端口；`sec-fetch-site: cross-site` 一律 403。
+ *   · 只读：GET 之外一律 405，不读请求体。
+ *
+ * @module pet-link/routes/pet-install
+ */
+export const DEPS = ['disposers', 'base', 'http'];
+
+/** 判断请求是否为本机同源（无 Origin 视为本机直连，放行）。仅本文件内部使用，不导出。 */
+function isSameOrigin(req, webServer) {
+  if (req.headers?.['sec-fetch-site'] === 'cross-site') return false;
+  const origin = req.headers?.origin;
+  if (!origin) return true;
+  try {
+    const from = new URL(origin);
+    return from.protocol === 'http:'
+      && Number(from.port || 80) === webServer.port
+      && ['127.0.0.1', 'localhost', '[::1]'].includes(from.hostname);
+  } catch { return false; }
+}
+
+/**
+ * 注册只读状态路由。
+ * @param {{ register: Function, port: number }} webServer
+ * @param {{ disposers: Function[], base: string, http: { sendJson: Function } }} c
+ */
+export function registerPetInstallRoutes(webServer, c, options = {}) {
+  const { disposers, base, http } = c;
+  const BASE = base;
+  const installer = options.installer;
+  if (!installer) throw new Error('pet-install 路由需要 installer');
+  const send = (res, status, value) => http.sendJson(res, status, value);
+  let active = true;
+  disposers.push(() => { active = false; });
+
+  const guard = (req, res) => {
+    if (!active) { send(res, 410, { ok: false, reason: 'bridge-disposed' }); return false; }
+    if (!isSameOrigin(req, webServer)) { send(res, 403, { ok: false, reason: 'cross-site-request' }); return false; }
+    return true;
+  };
+
+  disposers.push(webServer.register({ kind: 'exact', path: `${BASE}/pet-link/pet/state`, handler: (req, res) => {
+    if (!guard(req, res)) return;
+    if (req.method !== 'GET') return send(res, 405, { ok: false, reason: 'method-not-allowed' });
+    return send(res, 200, installer.state());
+  } }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-wallpaper-engine-pet-link",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Optional official dsh-pet bridge: public API control, four interaction sequences and independent page bubbles; no bundled pet or patching.",
   "icon": "./icon.png",
   "type": "module",
@@ -17,7 +17,7 @@
       "patch": "./cordis.patch.yml"
     },
     "client": {
-      "inject": ["@deepseek-ai/dsh-client-runtime"],
+      "inject": ["@deepseek-ai/dsh-client-runtime", "dsh-plugin-wallpaper-engine"],
       "platform": "web",
       "immediately": true
     }