@kira905/dsh-butler-install 0.3.2 → 0.3.4

package/README.md

@@ -23,7 +23,8 @@
 >   --manifest <path>       清单文件，默认用包内自带的 suite-manifest.json
 > ```
 >
-> 另有一个自足的 Windows exe（双击出界面，自带 node 运行时，不用先装环境）。
+> 另有一个 Windows exe（双击出界面）。它**自带 node 运行时**，所以 exe 自己不用你先装 Node；
+> 但**这台电脑上仍然得先有 DSH 和 npm** —— exe 只装大管家组件，不装 DSH 本身。
 
 ---
 
@@ -130,6 +131,9 @@ npx @kira905/dsh-butler-install --ui --port 45090
 上面那套都要敲命令。**连 PowerShell 都不想开**的话，下载一个 exe 就行：
 
 > **下载地址**：https://pan.baidu.com/s/1RezIxD4LitmEJ9U1FtFqFQ?pwd=pamq（提取码 `pamq`；文件名 `dsh-butler-install-0.3.1-win-x64.exe`，约 89 MB · 93,149,184 B）
+>
+> 说明：**网盘上现在放的就是 0.3.1 这一版**（下载文件名以它为准）。比它新的版本会先在仓里出（`npm run build:exe`），
+> 重新上传网盘之后这里才会跟着更新 —— 文件名里的版本号要是没变，就说明网盘上还没更新的。
 
 用法就三步：
 
@@ -153,9 +157,14 @@ npx @kira905/dsh-butler-install --ui --port 45090
 
 ### 这个 exe 的前提
 
-- **这台电脑上已经装好了 DSH**（`dsh --version` 能打出版本号）。exe **不负责装 DSH**、也不装 Node；
-  缺了它会在黑窗口里用大字告诉你缺什么、怎么装，然后停住等你按任意键（不会一闪就没）。
-- 只有 Windows x64 版。**自带 node 运行时**所以 89 MB —— 好处是你机器上 node 不在 PATH 也能起界面。
+- **这台电脑上已经装好了 DSH，并且有 npm** —— `dsh --version` 与 `npm --version` 都能打出版本号。
+  exe **不负责装 DSH、也不负责装 npm**：开界面之前它先体检这两件事，缺哪个就在黑窗口里用大字
+  说清楚、停住等你按任意键（不会一闪就没）。
+- **装的是「桌面版 / 图形版」DSH 的话，它可能没带命令行** —— 那种情况下装不上大管家（exe 走的是
+  `dsh plugin` 这条命令）。需要再装一个命令行版：`npm i -g @deepseek-ai/dsh`；
+  `dsh --version` 能打出版本号，再双击 exe。
+- 只有 Windows x64 版。**自带 node 运行时**所以 89 MB —— 省的是「**exe 自己**不用装 node 就能跑起来」
+  （exe 里已经打了一份 node.exe）。但请别读成「全流程不依赖本机 node」：**装插件那一步仍然要调这台电脑的 npm**。
 
 ### exe 里到底跑了什么
 
@@ -273,7 +282,7 @@ npm run build:exe           # → dist/dsh-butler-install-<版本>-win-x64.exe
 | `probe` | ✅ | 见下「探针」 |
 | `aliases` | 可选 | `--only` 用的别名（如 `面板`、`看板`），不许与包名重复 |
 | `note` | 可选 | 一句人话：这个包是什么、有什么坑 |
-| `excluded[]` | 顶层可选 | **不可安装项**：不是包的目录（如历史聚合仓）。演练档会跳过它并打印原因 |
+| `excluded[]` | 顶层可选 | **不随这套默认安装的项**，两种都放这儿：① **不是包的目录**（如历史聚合仓）；② **能装、但另有用途的可选件**（如 Router / 对偶 / 生活侧的工具包 —— 默认装进来只会多一份用不上的东西，`reason` 里写清单独装命令）。演练档会跳过它并打印原因 |
 
 **期望版本一律写区间，不钉精确版本**：宿主落进 profile 的本来就是区间，
 钉精确版本只会造出"清单与实体永远不一致"的假红。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kira905/dsh-butler-install",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "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",
@@ -29,6 +29,9 @@
     "test": "node test/run-all.mjs",
     "build:exe": "node scripts/build-exe.mjs"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "devDependencies": {
     "esbuild": "^0.28.2",
     "postject": "1.0.0-alpha.6"

package/suite-manifest.json

@@ -55,7 +55,7 @@
     },
     {
       "name": "@kira905/dsh-memory-toolkit",
-      "versionRange": "^0.2.0",
+      "versionRange": "^0.3.0",
       "type": "plugin",
       "group": "记忆",
       "mount": "auto",
@@ -168,6 +168,18 @@
       "id": "dsh-diagnostic-tools",
       "reason": "历史聚合仓，仓根没有 package.json，不是可安装的包；它里面两份子目录包的包名在 npm 上都取不到，且其中一个与已发布的作用域包同名不同域。别 git clone 它当安装源（会得到第二份来源）。要的这两件本清单已经单列了，装上即可。",
       "installInstead": ["@kira905/dsh-closure-tools", "@kira905/dsh-diagnostics-extra"]
+    },
+    {
+      "id": "dsh-life-toolkit",
+      "reason": "后建的服务端包，可安装，但**不随大管家套装默认安装** —— 它面向\"生活侧\"（人生记忆的落库与检索），跟工作侧的大管家不是同一套用法，默认装进来只会给每台机器多加一份用不上的东西。要单装：`npm i -g @kira905/dsh-life-toolkit@0.1.0`"
+    },
+    {
+      "id": "dsh-peer-toolkit",
+      "reason": "后建的跨机对偶工具包，可安装，但**不随大管家套装默认安装** —— 它只在多机对偶场景（两台机器互认、跨机递话）下才有意义，单机用户装了是空转。要单装：`npm i -g @kira905/dsh-peer-toolkit@0.1.1`"
+    },
+    {
+      "id": "dsh-router-toolkit",
+      "reason": "后建的 Router 工具包，可安装，但**不随大管家套装默认安装** —— 它是\"会派活的那只手\"，要么你已经在用 Router，要么就不该装（装了也不会自己跑）。要单装：`npm i -g @kira905/dsh-router-toolkit@0.2.0`"
     }
   ]
 }