@xxxyz/dsh-mcp-manager 2.0.1 → 2.0.3

package/README.md

@@ -34,17 +34,27 @@ The loader entry is the single composition point for both halves — no changes
 
 ## Install (any platform)
 
-**Quickest — one npx command (requires Node.js >= 18):**
+**Quickest — one command, via npm (requires Node.js >= 18):**
+
 ```bash
-# from npm (recommended)
+# Option A — one-shot with npx, nothing to install
 npx -y @xxxyz/dsh-mcp-manager
 
-# or directly from GitHub (no npm account needed)
-npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
+# Option B — global npm install, then run the command any time
+npm i -g @xxxyz/dsh-mcp-manager
+dsh-mcp-manager                  # install the plugin
+dsh-mcp-manager-uninstall        # uninstall the plugin
+npm i -g @xxxyz/dsh-mcp-manager@latest   # upgrade
 ```
-All flags pass through: `npx -y @xxxyz/dsh-mcp-manager --dsh-home /path/.dsh --profile web --repair --port 3080`.
 
-> npm package name: `@xxxyz/dsh-mcp-manager` (the bare name `dsh-mcp-manager` is taken on npm by an unrelated package). The deployed plugin name is still `dsh-mcp-manager` — npx is only the delivery channel; the installer copies the files to the same fixed locations below.
+All flags pass through in both options: `npx -y @xxxyz/dsh-mcp-manager --dsh-home /path/.dsh --profile web --repair --port 3080`.
+
+> npm package name: `@xxxyz/dsh-mcp-manager` (the bare name `dsh-mcp-manager` is taken on npm by an unrelated package). The deployed plugin name is still `dsh-mcp-manager` — npm/npx is only the delivery channel; the installer copies the files to the same fixed locations below.
+
+**No-npm alternative — directly from GitHub:**
+```bash
+npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
+```
 
 **Alternative — run the installer scripts from a source checkout** (all installers share one cross-platform logic file, `install.mjs`). Install steps:
 
@@ -71,9 +81,10 @@ node dsh-mcp-manager/install.mjs [--dsh-home <path>] [--profile <name>] [--port
 
 Then **restart DSH** and open **Settings → MCP 管理**. The four `mcp_manager_*` tools become callable by the model after that restart.
 
-Uninstall (same three ways):
-```powershell
-.\dsh-mcp-manager\uninstall.ps1      # or: ./uninstall.sh   or: node uninstall.mjs [--dsh-home <path>] [--profile <name>]
+Uninstall (any method):
+```bash
+dsh-mcp-manager-uninstall          # if installed via npm -g
+# or: .\dsh-mcp-manager\uninstall.ps1 | ./uninstall.sh | node uninstall.mjs [--dsh-home <path>] [--profile <name>]
 ```
 then restart DSH. Uninstall removes the deployed copy, the `local-packages` true source, and the loader row.
 

package/README.zh-CN.md

@@ -38,13 +38,13 @@
 
 ## 安装（任选一种方式）
 
-### 方式 0：npx 一条命令（最快捷，需要 Node.js >= 18）
+### 方式 0：npx 一条命令（免安装，最快捷，需要 Node.js >= 18）
 
 ```bash
-# 从 npm 安装（推荐）
+# 从 npm 临时运行（推荐，无需安装）
 npx -y @xxxyz/dsh-mcp-manager
 
-# 或直接从 GitHub 安装（无需 npm 账号）
+# 或直接从 GitHub 运行（无需 npm 账号）
 npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 ```
 
@@ -52,13 +52,18 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 
 > npm 包名是 `@xxxyz/dsh-mcp-manager`（裸名 `dsh-mcp-manager` 在 npm 上已被无关插件占用）。插件部署名仍是 `dsh-mcp-manager`——npx 只是配送渠道，安装器会把文件复制到下方同样的固定位置。
 
-以上所有方式实际执行的是同样的三个步骤（幂等，可重复运行）：
+### 方式 1：npm 全局安装（适合经常使用）
 
-1. 复制包到 `<DSH主目录>/local-packages/dsh-mcp-manager`（真源备份，DSH 升级不会动它）；
-2. 复制到 `<DSH主目录>/profiles/node_modules/dsh-mcp-manager`（**普通复制而非软链接**——软链接会让 Node ESM 按真实路径解析时找不到 `@deepseek-ai/dsh-tools`）；
-3. 在 `profiles/<profile>/cordis.patch.yml` 追加 loader 行（insert 块，**幂等**，重复运行不会重复添加）。
+```bash
+# 安装插件
+npm i -g @xxxyz/dsh-mcp-manager
+dsh-mcp-manager                  # 安装插件（参数同 npx）
+dsh-mcp-manager-uninstall        # 卸载插件
+# 升级插件
+npm i -g @xxxyz/dsh-mcp-manager@latest
+```
 
-### 方式 1：Windows（PowerShell）
+### 方式 2：Windows（PowerShell）
 
 ```powershell
 # 默认使用 ~/.dsh 和 web profile
@@ -71,7 +76,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 .\dsh-mcp-manager\install.ps1 -Repair -Port 3080
 ```
 
-### 方式 2：macOS / Linux（bash）
+### 方式 3：macOS / Linux（bash）
 
 ```bash
 # 默认使用 ~/.dsh 和 web profile
@@ -86,7 +91,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 
 > 若 `install.sh` 没有执行权限，先运行：`chmod +x dsh-mcp-manager/install.sh`
 
-### 方式 3：任何平台直接运行（推荐，最通用）
+### 方式 4：任何平台直接运行（推荐，最通用）
 
 ```bash
 node dsh-mcp-manager/install.mjs                       # 默认 ~/.dsh + web
@@ -113,13 +118,15 @@ node dsh-mcp-manager/install.mjs --repair --port 3080  # 修复模式
 
 ## 卸载
 
-```powershell
+```bash
+# npm 全局安装时（推荐）
+dsh-mcp-manager-uninstall
+
+# 或使用脚本 / 直接运行
 # Windows
 .\dsh-mcp-manager\uninstall.ps1 [-DshHome <路径>] [-Profile <名>]
-
 # macOS / Linux
 ./dsh-mcp-manager/uninstall.sh [--dsh-home <路径>] [--profile <名>]
-
 # 任何平台
 node dsh-mcp-manager/uninstall.mjs [--dsh-home <路径>] [--profile <名>]
 ```

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# Bundle patch layer for `dsh plugin add` installs: pnpm installs the scoped
+# package as @xxxyz/dsh-mcp-manager, so the insert row names the scoped
+# package. The loader-entry installer (install.mjs) mounts the same plugin
+# under `dsh-mcp-manager` — both names are registered by the client bundle.
+- insert:
+    - id: dsh-mcp-manager
+      name: '@xxxyz/dsh-mcp-manager'

package/lib/client.js

@@ -2,9 +2,7 @@
 // Registers the "MCP 管理" settings page. Talks to the host half through the
 // exact-path HTTP route /dsh-mcp-manager/api (same origin) instead of the
 // dynamic-only host.call channel.
-window.__ModuleLoader__.load({
-  id: 'dsh-mcp-manager',
-  factory: (require) => {
+const factory = (require) => {
     var module = { exports: {} }
     var exports = module.exports
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
@@ -299,5 +297,12 @@ window.__ModuleLoader__.load({
       },
     }
     return module.exports
-  },
-})
+  }
+
+  // Register the client bundle under both names: the loader-entry install
+  // (install.mjs) mounts it as `dsh-mcp-manager`, while `dsh plugin add`
+  // (via the dsh.bundle patch) installs the scoped npm package and mounts it
+  // as `@xxxyz/dsh-mcp-manager`. The boot graph row id must match the id the
+  // bundle registers, so both are registered — the unused one is inert.
+  window.__ModuleLoader__.load({ id: 'dsh-mcp-manager', factory })
+  window.__ModuleLoader__.load({ id: '@xxxyz/dsh-mcp-manager', factory })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xxxyz/dsh-mcp-manager",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "DSH-standard MCP manager plugin: Settings UI + HTTP API + model-facing mcp_manager_* tools. Composed as a loader entry, survives restarts. Install via npx, PowerShell, bash or node.",
   "type": "module",
   "main": "lib/index.js",
@@ -10,10 +10,12 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "dsh-mcp-manager": "install.mjs"
+    "dsh-mcp-manager": "install.mjs",
+    "dsh-mcp-manager-uninstall": "uninstall.mjs"
   },
   "files": [
     "lib",
+    "cordis.patch.yml",
     "install.mjs",
     "uninstall.mjs",
     "install.ps1",
@@ -53,6 +55,9 @@
     "url": "https://github.com/xxxyz/DeepSeekHarness-MCP-Manager/issues"
   },
   "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
     "client": {
       "platform": "web",
       "inject": [

package//345/256/211/350/243/205/346/226/271/345/274/217.md

@@ -16,13 +16,13 @@
 
 ## 一、安装（任选一种方式）
 
-### 方式 0：npx 一条命令（最快捷，需要 Node.js >= 18）
+### 方式 0：npx 一条命令（免安装，最快捷，需要 Node.js >= 18）
 
 ```bash
-# 从 npm 安装（推荐）
+# 从 npm 临时运行（推荐，无需安装）
 npx -y @xxxyz/dsh-mcp-manager
 
-# 或直接从 GitHub 安装（无需 npm 账号）
+# 或直接从 GitHub 运行（无需 npm 账号）
 npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 ```
 
@@ -30,7 +30,18 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 
 > npm 包名是 `@xxxyz/dsh-mcp-manager`（裸名 `dsh-mcp-manager` 在 npm 上已被无关插件占用）。插件部署名仍是 `dsh-mcp-manager`——npx 只是配送渠道，执行的是与下面同样的安装逻辑。
 
-### 方式 1：Windows（PowerShell）
+### 方式 1：npm 全局安装（适合经常使用）
+
+```bash
+# 安装插件
+npm i -g @xxxyz/dsh-mcp-manager
+dsh-mcp-manager                  # 安装插件（参数同 npx）
+dsh-mcp-manager-uninstall        # 卸载插件
+# 升级插件
+npm i -g @xxxyz/dsh-mcp-manager@latest
+```
+
+### 方式 2：Windows（PowerShell）
 
 ```powershell
 # 默认使用 ~/.dsh 和 web profile
@@ -43,7 +54,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 .\dsh-mcp-manager\install.ps1 -Repair -Port 3080
 ```
 
-### 方式 2：macOS / Linux（bash）
+### 方式 3：macOS / Linux（bash）
 
 ```bash
 # 默认使用 ~/.dsh 和 web profile
@@ -58,7 +69,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
 
 > 若 `install.sh` 没有执行权限，先运行：`chmod +x dsh-mcp-manager/install.sh`
 
-### 方式 3：任何平台直接运行（推荐，最通用）
+### 方式 4：任何平台直接运行（推荐，最通用）
 
 ```bash
 node dsh-mcp-manager/install.mjs                       # 默认 ~/.dsh + web
@@ -89,13 +100,15 @@ node dsh-mcp-manager/install.mjs --repair --port 3080  # 修复模式
 
 ## 三、卸载
 
-```powershell
+```bash
+# npm 全局安装时（推荐）
+dsh-mcp-manager-uninstall
+
+# 或使用脚本 / 直接运行
 # Windows
 .\dsh-mcp-manager\uninstall.ps1 [-DshHome <路径>] [-Profile <名>]
-
 # macOS / Linux
 ./dsh-mcp-manager/uninstall.sh [--dsh-home <路径>] [--profile <名>]
-
 # 任何平台
 node dsh-mcp-manager/uninstall.mjs [--dsh-home <路径>] [--profile <名>]
 ```