@xxxyz/dsh-mcp-manager 2.0.1 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +20 -9
  2. package/README.zh-CN.md +20 -13
  3. package/package.json +3 -2
  4. package/uninstall.mjs +0 -0
  5. package//345/256/211/350/243/205/346/226/271/345/274/217.md +22 -9
package/README.md CHANGED
@@ -34,17 +34,27 @@ The loader entry is the single composition point for both halves — no changes
34
34
 
35
35
  ## Install (any platform)
36
36
 
37
- **Quickest — one npx command (requires Node.js >= 18):**
37
+ **Quickest — one command, via npm (requires Node.js >= 18):**
38
+
38
39
  ```bash
39
- # from npm (recommended)
40
+ # Option A — one-shot with npx, nothing to install
40
41
  npx -y @xxxyz/dsh-mcp-manager
41
42
 
42
- # or directly from GitHub (no npm account needed)
43
- npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
43
+ # Option B — global npm install, then run the command any time
44
+ npm i -g @xxxyz/dsh-mcp-manager
45
+ dsh-mcp-manager # install the plugin
46
+ dsh-mcp-manager-uninstall # uninstall the plugin
47
+ npm i -g @xxxyz/dsh-mcp-manager@latest # upgrade
44
48
  ```
45
- All flags pass through: `npx -y @xxxyz/dsh-mcp-manager --dsh-home /path/.dsh --profile web --repair --port 3080`.
46
49
 
47
- > 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.
50
+ All flags pass through in both options: `npx -y @xxxyz/dsh-mcp-manager --dsh-home /path/.dsh --profile web --repair --port 3080`.
51
+
52
+ > 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.
53
+
54
+ **No-npm alternative — directly from GitHub:**
55
+ ```bash
56
+ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
57
+ ```
48
58
 
49
59
  **Alternative — run the installer scripts from a source checkout** (all installers share one cross-platform logic file, `install.mjs`). Install steps:
50
60
 
@@ -71,9 +81,10 @@ node dsh-mcp-manager/install.mjs [--dsh-home <path>] [--profile <name>] [--port
71
81
 
72
82
  Then **restart DSH** and open **Settings → MCP 管理**. The four `mcp_manager_*` tools become callable by the model after that restart.
73
83
 
74
- Uninstall (same three ways):
75
- ```powershell
76
- .\dsh-mcp-manager\uninstall.ps1 # or: ./uninstall.sh or: node uninstall.mjs [--dsh-home <path>] [--profile <name>]
84
+ Uninstall (any method):
85
+ ```bash
86
+ dsh-mcp-manager-uninstall # if installed via npm -g
87
+ # or: .\dsh-mcp-manager\uninstall.ps1 | ./uninstall.sh | node uninstall.mjs [--dsh-home <path>] [--profile <name>]
77
88
  ```
78
89
  then restart DSH. Uninstall removes the deployed copy, the `local-packages` true source, and the loader row.
79
90
 
package/README.zh-CN.md CHANGED
@@ -38,13 +38,13 @@
38
38
 
39
39
  ## 安装（任选一种方式）
40
40
 
41
- ### 方式 0：npx 一条命令（最快捷，需要 Node.js >= 18）
41
+ ### 方式 0：npx 一条命令（免安装，最快捷，需要 Node.js >= 18）
42
42
 
43
43
  ```bash
44
- # 从 npm 安装（推荐）
44
+ # 从 npm 临时运行（推荐，无需安装）
45
45
  npx -y @xxxyz/dsh-mcp-manager
46
46
 
47
- # 或直接从 GitHub 安装（无需 npm 账号）
47
+ # 或直接从 GitHub 运行（无需 npm 账号）
48
48
  npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
49
49
  ```
50
50
 
@@ -52,13 +52,18 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
52
52
 
53
53
  > npm 包名是 `@xxxyz/dsh-mcp-manager`（裸名 `dsh-mcp-manager` 在 npm 上已被无关插件占用）。插件部署名仍是 `dsh-mcp-manager`——npx 只是配送渠道，安装器会把文件复制到下方同样的固定位置。
54
54
 
55
- 以上所有方式实际执行的是同样的三个步骤（幂等，可重复运行）：
55
+ ### 方式 1：npm 全局安装（适合经常使用）
56
56
 
57
- 1. 复制包到 `<DSH主目录>/local-packages/dsh-mcp-manager`（真源备份，DSH 升级不会动它）；
58
- 2. 复制到 `<DSH主目录>/profiles/node_modules/dsh-mcp-manager`（**普通复制而非软链接**——软链接会让 Node ESM 按真实路径解析时找不到 `@deepseek-ai/dsh-tools`）；
59
- 3. 在 `profiles/<profile>/cordis.patch.yml` 追加 loader 行（insert 块，**幂等**，重复运行不会重复添加）。
57
+ ```bash
58
+ # 安装插件
59
+ npm i -g @xxxyz/dsh-mcp-manager
60
+ dsh-mcp-manager # 安装插件（参数同 npx）
61
+ dsh-mcp-manager-uninstall # 卸载插件
62
+ # 升级插件
63
+ npm i -g @xxxyz/dsh-mcp-manager@latest
64
+ ```
60
65
 
61
- ### 方式 1：Windows（PowerShell）
66
+ ### 方式 2：Windows（PowerShell）
62
67
 
63
68
  ```powershell
64
69
  # 默认使用 ~/.dsh 和 web profile
@@ -71,7 +76,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
71
76
  .\dsh-mcp-manager\install.ps1 -Repair -Port 3080
72
77
  ```
73
78
 
74
- ### 方式 2：macOS / Linux（bash）
79
+ ### 方式 3：macOS / Linux（bash）
75
80
 
76
81
  ```bash
77
82
  # 默认使用 ~/.dsh 和 web profile
@@ -86,7 +91,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
86
91
 
87
92
  > 若 `install.sh` 没有执行权限，先运行：`chmod +x dsh-mcp-manager/install.sh`
88
93
 
89
- ### 方式 3：任何平台直接运行（推荐，最通用）
94
+ ### 方式 4：任何平台直接运行（推荐，最通用）
90
95
 
91
96
  ```bash
92
97
  node dsh-mcp-manager/install.mjs # 默认 ~/.dsh + web
@@ -113,13 +118,15 @@ node dsh-mcp-manager/install.mjs --repair --port 3080 # 修复模式
113
118
 
114
119
  ## 卸载
115
120
 
116
- ```powershell
121
+ ```bash
122
+ # npm 全局安装时（推荐）
123
+ dsh-mcp-manager-uninstall
124
+
125
+ # 或使用脚本 / 直接运行
117
126
  # Windows
118
127
  .\dsh-mcp-manager\uninstall.ps1 [-DshHome <路径>] [-Profile <名>]
119
-
120
128
  # macOS / Linux
121
129
  ./dsh-mcp-manager/uninstall.sh [--dsh-home <路径>] [--profile <名>]
122
-
123
130
  # 任何平台
124
131
  node dsh-mcp-manager/uninstall.mjs [--dsh-home <路径>] [--profile <名>]
125
132
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xxxyz/dsh-mcp-manager",
3
- "version": "2.0.1",
3
+ "version": "2.0.2",
4
4
  "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.",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -10,7 +10,8 @@
10
10
  "./package.json": "./package.json"
11
11
  },
12
12
  "bin": {
13
- "dsh-mcp-manager": "install.mjs"
13
+ "dsh-mcp-manager": "install.mjs",
14
+ "dsh-mcp-manager-uninstall": "uninstall.mjs"
14
15
  },
15
16
  "files": [
16
17
  "lib",
package/uninstall.mjs CHANGED
File without changes
package//345/256/211/350/243/205/346/226/271/345/274/217.md CHANGED
@@ -16,13 +16,13 @@
16
16
 
17
17
  ## 一、安装（任选一种方式）
18
18
 
19
- ### 方式 0：npx 一条命令（最快捷，需要 Node.js >= 18）
19
+ ### 方式 0：npx 一条命令（免安装，最快捷，需要 Node.js >= 18）
20
20
 
21
21
  ```bash
22
- # 从 npm 安装（推荐）
22
+ # 从 npm 临时运行（推荐，无需安装）
23
23
  npx -y @xxxyz/dsh-mcp-manager
24
24
 
25
- # 或直接从 GitHub 安装（无需 npm 账号）
25
+ # 或直接从 GitHub 运行（无需 npm 账号）
26
26
  npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
27
27
  ```
28
28
 
@@ -30,7 +30,18 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
30
30
 
31
31
  > npm 包名是 `@xxxyz/dsh-mcp-manager`（裸名 `dsh-mcp-manager` 在 npm 上已被无关插件占用）。插件部署名仍是 `dsh-mcp-manager`——npx 只是配送渠道，执行的是与下面同样的安装逻辑。
32
32
 
33
- ### 方式 1：Windows（PowerShell）
33
+ ### 方式 1：npm 全局安装（适合经常使用）
34
+
35
+ ```bash
36
+ # 安装插件
37
+ npm i -g @xxxyz/dsh-mcp-manager
38
+ dsh-mcp-manager # 安装插件（参数同 npx）
39
+ dsh-mcp-manager-uninstall # 卸载插件
40
+ # 升级插件
41
+ npm i -g @xxxyz/dsh-mcp-manager@latest
42
+ ```
43
+
44
+ ### 方式 2：Windows（PowerShell）
34
45
 
35
46
  ```powershell
36
47
  # 默认使用 ~/.dsh 和 web profile
@@ -43,7 +54,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
43
54
  .\dsh-mcp-manager\install.ps1 -Repair -Port 3080
44
55
  ```
45
56
 
46
- ### 方式 2：macOS / Linux（bash）
57
+ ### 方式 3：macOS / Linux（bash）
47
58
 
48
59
  ```bash
49
60
  # 默认使用 ~/.dsh 和 web profile
@@ -58,7 +69,7 @@ npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
58
69
 
59
70
  > 若 `install.sh` 没有执行权限，先运行：`chmod +x dsh-mcp-manager/install.sh`
60
71
 
61
- ### 方式 3：任何平台直接运行（推荐，最通用）
72
+ ### 方式 4：任何平台直接运行（推荐，最通用）
62
73
 
63
74
  ```bash
64
75
  node dsh-mcp-manager/install.mjs # 默认 ~/.dsh + web
@@ -89,13 +100,15 @@ node dsh-mcp-manager/install.mjs --repair --port 3080 # 修复模式
89
100
 
90
101
  ## 三、卸载
91
102
 
92
- ```powershell
103
+ ```bash
104
+ # npm 全局安装时（推荐）
105
+ dsh-mcp-manager-uninstall
106
+
107
+ # 或使用脚本 / 直接运行
93
108
  # Windows
94
109
  .\dsh-mcp-manager\uninstall.ps1 [-DshHome <路径>] [-Profile <名>]
95
-
96
110
  # macOS / Linux
97
111
  ./dsh-mcp-manager/uninstall.sh [--dsh-home <路径>] [--profile <名>]
98
-
99
112
  # 任何平台
100
113
  node dsh-mcp-manager/uninstall.mjs [--dsh-home <路径>] [--profile <名>]
101
114
  ```