@kira905/dsh-butler-install 0.3.7 → 0.3.9

package/README.md

@@ -14,6 +14,9 @@
 > ```
 > 想点着鼠标装也行：`dsh-butler-install --ui` 会起一个本地向导页（只绑 `127.0.0.1`、只读、不执行）。
 >
+> 💬 那个 `profile` 是什么？就是 DSH 放插件的一个「格子」的名字。你平时用网页版，格子里填 `web` 就对了；
+> 用的桌面版（Electron）则是 `desktop`。**不知道填什么，照抄 `web` 即可**。
+>
 > ### 先看它长什么样（真实输出）
 > ```text
 > dsh-butler-install —— 大管家全家桶薄壳安装器
@@ -34,6 +37,14 @@
 > 找到那条自带命令 ⇒ 用 `--profile desktop` 时**自动改用它**（命令原语不变，只是换了一条壳）。
 > 找不到自带命令时**不会硬来**：直接停手（rc=2），并告诉你怎么指路（`DSH_DESKTOP_DIR`）。
 > ⚠️ 桌面版只加载 `desktop` 这一个 profile；往 `--profile web` 里装 = 装了看不见。
+>
+> ### 它不附带什么（先看清楚，省得装完失望）
+> 这套开源出来的是**能用的工具 + 装完自检 + 设计文档**。有两块**不在开源范围里**：
+>
+> 1. **「自己盯着活干」的那套引擎**：定时调度、队列盯守、管家日报、自主决定要不要动手 —— 这几件还没整理出来放（整理完会陆续放）。它的**设计本身是公开的**，写在 [`ops-handoff-design`](https://github.com/kira905/ops-handoff-design) 仓里，想自己实现的人照着做得到。
+> 2. **「出事喊到人」的通道**：企业微信、语音播报这类 —— **不随开源发布**。
+>
+> 所以：装完你拿到的是一套**能用的工具**，不是一个会自己上班的管家。
 
 ---
 

package/bin/install-ui.mjs

@@ -92,6 +92,17 @@ export async function runEntry({
     out.write(`端口 ${port} 上没有我们自己的向导页（${found.reason}）⇒ 现在起一个。\n`);
   }
 
+  // 桌面版探测**在这里做一次**（允许探进程），结果挂到 options 上给每个请求复用：
+  //  · 向导要求"每请求零 spawn" ⇒ 不能每次请求都去探进程；
+  //  · 而要知道"桌面版正开着"，又必须探进程（source === 'process'）——
+  //    不然同机装了 CLI + 桌面版的人会默认落回 web，装完桌面版界面一个插件都看不到（2026-11-07 实测）。
+  if (options.ui && !options.desktopPre) {
+    try {
+      const { detectDesktop } = await import('../lib/desktop.mjs');
+      options.desktopPre = await detectDesktop({ home: options.home, allowProcessProbe: true });
+    } catch { /* 探测失败就当没桌面版：退回原来的默认 web */ }
+  }
+
   const started = await startServer({ options, port: options.uiPort });
   if (!started.ok) {
     for (const line of started.log) out.write(`${line}\n`);

package/lib/plan.mjs

@@ -208,6 +208,8 @@ export function resetDesktopDetectCache() {
 }
 
 async function desktopFor(home, options) {
+  // 启动时已解析过的（--ui 用它保证每请求零 spawn，同时也才有资格做进程探测）
+  if (options.desktopPre) return options.desktopPre;
   const env = options.env || process.env;
   const key = `${home}|${env.DSH_DESKTOP_DIR || ''}|${env.DSH_DESKTOP_CLI || ''}`;
   if (desktopDetectCache.has(key)) return desktopDetectCache.get(key);
@@ -247,6 +249,13 @@ export function decideProfile({ options, home, desktop }) {
     return { profile: requested, changed: false, source: 'explicit', notices };
   }
   if (!options.profileExplicit) {
+    // ① 桌面版**正在运行** ⇒ 用户此刻就在用它，默认就该装 desktop。
+    //    为什么要这条：下面 ② 只处理"只有 desktop、没有 web"的机器；而同时装了 CLI 与桌面版的人
+    //    两个 profile 都在，② 不命中 ⇒ 会落回 web ⇒ 装完桌面版界面上一个插件都看不到（2026-11-07 实测）。
+    if (desktop.source === 'process' && desktop.cliCmd) {
+      notices.push('检测到桌面版（Electron）正在运行，已默认改成 --profile desktop —— 装进 web 的那套界面，桌面版永远不加载');
+      return { profile: 'desktop', changed: true, source: 'auto-desktop-running', notices };
+    }
     const webExists = readProfile(home, 'web').exists;
     if (desktop.desktopProfileExists && desktop.cliCmd && !webExists) {
       notices.push('这台机器的数据根里只有桌面版自建的 desktop profile（没有 web），已改成 --profile desktop —— 装进 web 的那套界面桌面版永远不加载');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kira905/dsh-butler-install",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Thin installer for the DSH butler suite: one command installs the plugin + CLI bundle through the host's own commands, then tells you whether it actually took effect, and can roll the whole batch back. Also ships a local wizard page (--ui) that lives outside DSH and can install from the browser: nothing runs until you press confirm; loopback only, per-process token + same-origin check, four POST entry points (preview/start/cancel/rollback), two honest rollbacks. It does not isolate you from other programs running as the same local user.",
   "type": "module",
   "license": "MIT",

package/suite-manifest.json

@@ -5,7 +5,7 @@
   "items": [
     {
       "name": "@kira905/dsh-ecosystem-panel",
-      "versionRange": "^0.5.0",
+      "versionRange": "^0.5.1",
       "type": "plugin",
       "group": "核心",
       "mount": "auto",
@@ -15,7 +15,7 @@
     },
     {
       "name": "@kira905/dsh-butler-archive",
-      "versionRange": "^0.5.0",
+      "versionRange": "^0.5.1",
       "type": "plugin",
       "group": "界面",
       "mount": "auto",
@@ -25,7 +25,7 @@
     },
     {
       "name": "@kira905/dsh-session-title-live",
-      "versionRange": "^0.3.0",
+      "versionRange": "^0.3.1",
       "type": "plugin",
       "group": "界面",
       "mount": "auto",