@kira905/dsh-butler-panel 0.9.2 → 0.9.4

package/cordis.patch.yml

@@ -3,6 +3,14 @@
 # latest changelog, memory pulse). The node half (exports ".") serves
 # GET /api/dsh-butler/state; the `dsh.client` declaration makes the browser
 # half (exports "./client") load in the web GUI sidebar bottom area.
+#
+# 🔴 name 必须等于 package.json#name（发行名带 scope）。
+# 0.9.3 及更早写的是不带 scope 的 `dsh-butler-panel` —— 那是"本地手放实体"时代的
+# 名字。从注册表装（`dsh plugin --profile <p> add @kira905/dsh-butler-panel`）时，
+# profile 里只有 `@kira905/dsh-butler-panel` 这个包，宿主解析不到 `dsh-butler-panel`
+# 那一行 ⇒ **宿主半根本没挂上 ⇒ 它的 dsh.client 也不会被扫进 boot graph ⇒ 侧边栏连
+# 入口都不出现，而且没有任何报错**（2026-11-09 A-8 关 4 实测，桌面版上就是这个症状）。
+# 同一处坑在 @kira905/dsh-task-board-local 的 patch 里已有同文提醒，这里是同一类错误。
 - insert:
     - id: butler-panel
-      name: 'dsh-butler-panel'
+      name: '@kira905/dsh-butler-panel'

package/lib/client.js

@@ -28,8 +28,19 @@ window.__ModuleLoader__.load({
 		 *  浏览器 bundle 拿不到各包的 lib/host-adapter.js 副本（宿主按 exports["./client"] **单文件**
 		 *  serve），故由 dsh-host-adapter-client 的 client 面提供常量；本包 package.json 的
 		 *  `dsh.client.external` 已声明它 —— 宿主据此排序 boot graph，保证依赖先 register，
-		 *  同步 require 才命中模块表（不声明 = require MISS = 整个 client bundle 崩）。 */
-		const ADAPTER = require("dsh-host-adapter-client");
+		 *  同步 require 才命中模块表（不声明 = require MISS = 整个 client bundle 崩）。
+		 *
+		 *  🔴【0.9.4 · 2026-11-09】两条曾经把整个面板打死的事实：
+		 *  ① 从注册表装的是 **@kira905/dsh-host-adapter-client**（package.json#name 带 scope），
+		 *     而 boot graph 的行 id = 那个 name ⇒ 裸 `require("dsh-host-adapter-client")` 找不到行、
+		 *     整个 client bundle 在 factory 顶层就抛，侧边栏连入口都不出现（没有任何错误提示）。
+		 *  ② 老 profile 里那份是**不带 scope** 的本地件（name = dsh-host-adapter-client）。
+		 *  ⇒ 两个名字都试，谁在就用谁；都没有也只是缺一个常量，本面板照常挂（下面有同值兜底），
+		 *     绝不因为一个依赖名字对不上而整块消失。 */
+		let ADAPTER = null;
+		try { ADAPTER = require("@kira905/dsh-host-adapter-client"); } catch (e1) {
+			try { ADAPTER = require("dsh-host-adapter-client"); } catch (e2) { ADAPTER = null; }
+		}
 		//#region consts
 		const ENTRY_ATTR = "data-dsh-butler-entry";
 		const ENTRY_SELECTOR = "[" + ENTRY_ATTR + "]";
@@ -62,7 +73,10 @@ window.__ModuleLoader__.load({
 		const COLD_MS_DEFAULT = 3200;
 		const SLOW_MS = 1000;             // "重算慢"阈值（连续退化判据的一半）
 		const DEGRADE_STREAK_ALERT = 3;   // 连续退化 ≥3 次 → 显式提示（别让主人以为一直正常）
-		const inject = [ADAPTER.SVC.slots];
+		// 【0.9.4】适配层只在常量层需要：拿不到就退回同值字面量（"slots"）。
+		// 这一条就是当年"适配层名字对不上 ⇒ 整个面板消失"的兜底；不是新语义，值与 ADAPTER.SVC.slots 相同。
+		const SLOTS_SERVICE = (ADAPTER && ADAPTER.SVC && ADAPTER.SVC.slots) || "slots";
+		const inject = [SLOTS_SERVICE];
 		// 大管家图标（账本清单，16px 描边，与生态面板 grid 同视觉语言）
 		const ICON = "<svg viewBox=\"0 0 16 16\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.3\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M2.6 3.2h6.8M2.6 8h6.8M2.6 12.8h6.8\"/><path d=\"M11.4 4.6l1.4 1.4 2.6-2.8M11.4 9.4l1.4 1.4 2.6-2.8\"/></svg>";
 		const CSS_ID = "dsh-butler-panel-css";

package/lib/shards.mjs

@@ -1112,10 +1112,18 @@ export async function collectServiceShard(ctx = {}) {
   const home = dshHome();
   const asOf = { at: now, source: 'compute' };
   // 可选依赖：宿主若提供了「外部通道健康」判定件（butlerLib 能解析到），就渲染它的结论；
-  // 解析不到 ⇒ 走下面的显式降级。**开源包里不带这份判定件**（它属于宿主侧能力），这不是故障。
+  // 解析不到 ⇒ 走下面的显式降级。**开源包里不带这份判定件**（它属于宿主侧能力、且不开源），这不是故障。
+  // 🔴 降级话术必须把"为什么没有"说成人话：不是"坏了"，是"这个模块不在包里"。留一行可照做的指引。
   const sh = await butlerLib('secretary-health.mjs');
   if (!sh || typeof sh.collectHealth !== 'function') {
-    return { ok: false, reason: '宿主没有提供「外部通道健康」判定件（这是可选能力，面板本身不判健康）—— 所以这里不是「服务面正常」', asOf };
+    return {
+      ok: false,
+      // 机器可读的降级原因（面板 UI 不需要它，给夹具/排障用；新增字段，向后兼容）
+      unavailable: 'module-not-shipped',
+      reason: '该模块不开源，本功能不可用（开源包里不带「外部通道健康」判定件；要接就由宿主自己提供同名模块，'
+        + '放进大管家工具目录或设 BUTLER_ROOT）—— 面板本身不判健康，所以这里不是「服务面正常」',
+      asOf,
+    };
   }
   let health = null;
   let healthError = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kira905/dsh-butler-panel",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "大管家的可视化面板：在 DSH 侧边栏看今天该看什么（结论 / 待处理 / 资产 / 流水 / 健康），只读为主；另带 P5 写入守门人（可挂可摘）。",
   "type": "module",
   "main": "lib/index.js",
@@ -39,7 +39,7 @@
     "node": ">=18.17"
   },
   "dependencies": {
-    "dsh-host-adapter-client": "npm:@kira905/dsh-host-adapter-client@^0.1.2"
+    "dsh-host-adapter-client": "npm:@kira905/dsh-host-adapter-client@^0.2.0"
   },
   "peerDependencies": {},
   "license": "AGPL-3.0-only",
@@ -52,6 +52,7 @@
     },
     "client": {
       "external": [
+        "@kira905/dsh-host-adapter-client",
         "dsh-host-adapter-client"
       ],
       "inject": [],