@xxxyz/dsh-mcp-manager 2.0.0

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@xxxyz/dsh-mcp-manager",
+  "version": "2.0.0",
+  "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",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "dsh-mcp-manager": "install.mjs"
+  },
+  "files": [
+    "lib",
+    "install.mjs",
+    "uninstall.mjs",
+    "install.ps1",
+    "install.sh",
+    "uninstall.ps1",
+    "uninstall.sh",
+    "README.md",
+    "README.zh-CN.md",
+    "安装方式.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "mcp",
+    "mcp-server",
+    "plugin",
+    "cordis"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xxxyz/DeepSeekHarness-MCP-Manager.git"
+  },
+  "homepage": "https://github.com/xxxyz/DeepSeekHarness-MCP-Manager",
+  "bugs": {
+    "url": "https://github.com/xxxyz/DeepSeekHarness-MCP-Manager/issues"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-api-remotes"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7",
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.0"
+  },
+  "license": "MIT"
+}

package/uninstall.mjs

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+// dsh-mcp-manager uninstall.mjs — cross-platform uninstaller core
+// (Windows / macOS / Linux, Node.js >= 18, no dependencies).
+//
+// uninstall.ps1 (Windows) and uninstall.sh (macOS / Linux) are thin wrappers.
+//
+// What it removes:
+//   1. <dshHome>/local-packages/dsh-mcp-manager        (true source)
+//   2. <dshHome>/profiles/node_modules/dsh-mcp-manager  (deployed copy)
+//   3. the loader row (`id: mcp-manager`) from
+//      <dshHome>/profiles/<profile>/cordis.patch.yml
+//      (other entries are left untouched; the patch stays a valid YAML array)
+//
+// Then restart DSH. Idempotent — safe to run repeatedly.
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { fileURLToPath } from 'node:url'
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url))
+const PKG_NAME = 'dsh-mcp-manager'
+const LOADER_ID = 'mcp-manager'
+const DEFAULT_PROFILE = 'web'
+
+const log = (msg) => console.log(msg)
+const warn = (msg) => console.warn('[警告] ' + msg)
+const fail = (msg) => { console.error('[错误] ' + msg); process.exit(1) }
+
+function parseArgs(argv) {
+  const opts = {
+    dshHome: process.env.DSH_HOME || null,
+    profile: DEFAULT_PROFILE,
+    help: false,
+  }
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    const next = () => {
+      i++
+      if (i >= argv.length) fail('缺少参数值: ' + a + '（用 --help 查看用法）')
+      return argv[i]
+    }
+    switch (a) {
+      case '--dsh-home': opts.dshHome = next(); break
+      case '--profile': opts.profile = next(); break
+      case '-h':
+      case '--help': opts.help = true; break
+      default: fail('未知参数: ' + a + '（用 --help 查看用法）')
+    }
+  }
+  if (!opts.dshHome) opts.dshHome = path.join(os.homedir(), '.dsh')
+  return opts
+}
+
+function printUsage() {
+  log(`dsh-mcp-manager 卸载脚本（跨平台：Windows / macOS / Linux）
+
+用法:
+  node uninstall.mjs [选项]
+
+选项:
+  --dsh-home <path>   DSH 主目录。默认取 $DSH_HOME 环境变量，否则 ~/.dsh
+  --profile <name>    安装时使用的 profile 名（默认 ${DEFAULT_PROFILE}）
+  -h, --help          显示本帮助
+
+示例:
+  node uninstall.mjs
+  node uninstall.mjs --dsh-home D:\\path\\.dsh --profile web`)
+}
+
+// Remove the loader entry from the patch, then re-normalise so the file stays a
+// valid top-level YAML array (empty/comments-only → `[]`), mirroring the
+// plugin's own joinLines() behaviour. Handles both the current `- insert:`
+// block form and the legacy plain `- id: mcp-manager` row.
+function removeLoader(patchPath) {
+  if (!fs.existsSync(patchPath)) return false
+  const lines = fs.readFileSync(patchPath, 'utf8').split(/\r?\n/)
+  const n = lines.length
+  const reChild = () => new RegExp("^(\\s+)- id:\\s*'?" + LOADER_ID + "'?\\s*$")
+  const rePlain = () => new RegExp("^- id:\\s*'?" + LOADER_ID + "'?\\s*$")
+  const out = []
+  let removed = false
+  let i = 0
+  while (i < n) {
+    const line = lines[i]
+    if (/^- insert:/.test(line)) {
+      let end = i + 1
+      while (end < n && !/^- /.test(lines[end])) end++
+      const block = lines.slice(i, end)
+      if (block.some((l) => reChild().test(l))) {
+        removed = true // drop the whole block
+      } else {
+        out.push(...block)
+      }
+      i = end
+      continue
+    }
+    if (rePlain().test(line)) {
+      removed = true
+      i++
+      continue
+    }
+    out.push(line)
+    i++
+  }
+  if (!removed) return false
+
+  let res = out.join('\n').replace(/\n{3,}/g, '\n\n').replace(/^\n+/, '').replace(/\n*$/, '\n')
+  if (!res.trim()) res = '[]\n'
+  else if (!/^- /m.test(res) && !/^\[\]\s*$/m.test(res)) res = res.replace(/\n*$/, '\n[]\n')
+  fs.writeFileSync(patchPath, res, 'utf8')
+  return true
+}
+
+function main() {
+  const opts = parseArgs(process.argv.slice(2))
+  if (opts.help) { printUsage(); return }
+
+  const dshHome = opts.dshHome
+  const localPkg = path.join(dshHome, 'local-packages', PKG_NAME)
+  const deployDir = path.join(dshHome, 'profiles', 'node_modules', PKG_NAME)
+  const projectPatch = path.join(dshHome, 'profiles', opts.profile, 'cordis.patch.yml')
+
+  log(`操作系统: ${process.platform === 'win32' ? 'Windows' : process.platform === 'darwin' ? 'macOS' : 'Linux'}`)
+  log(`DSH 主目录: ${dshHome}`)
+  log(`profile: ${opts.profile}`)
+  log('')
+
+  let anything = false
+
+  if (fs.existsSync(localPkg)) {
+    fs.rmSync(localPkg, { recursive: true, force: true })
+    log('已删除 local-packages 真源: ' + localPkg)
+    anything = true
+  } else {
+    log('跳过（不存在）: ' + localPkg)
+  }
+
+  if (fs.existsSync(deployDir)) {
+    fs.rmSync(deployDir, { recursive: true, force: true })
+    log('已删除部署副本: ' + deployDir)
+    anything = true
+  } else {
+    log('跳过（不存在）: ' + deployDir)
+  }
+
+  if (removeLoader(projectPatch)) {
+    log('已从补丁中移除 loader 行: ' + projectPatch)
+    anything = true
+  } else {
+    log('跳过（无 loader 行）: ' + projectPatch)
+  }
+
+  log('')
+  if (!anything) {
+    warn('未发现 dsh-mcp-manager 的安装痕迹（可能 DSH 主目录不对？用 --dsh-home 指定）')
+    return
+  }
+  log('✔ 卸载完成。请重启 DSH 使设置页与 mcp_manager_* 工具下线。')
+}
+
+main()

package/uninstall.ps1

@@ -0,0 +1,33 @@
+# dsh-mcp-manager uninstall.ps1 — Windows uninstaller (thin wrapper around uninstall.mjs)
+#
+#   .\dsh-mcp-manager\uninstall.ps1                   # default: ~/.dsh, web profile
+#   .\uninstall.ps1 -DshHome D:\path\.dsh -Profile web
+[CmdletBinding()]
+param(
+  [string]$DshHome,
+  [string]$Profile = '',
+  [switch]$Help
+)
+
+$ErrorActionPreference = 'Stop'
+
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$mjs = Join-Path $scriptDir 'uninstall.mjs'
+
+$node = Get-Command node -ErrorAction SilentlyContinue
+if (-not $node) {
+  Write-Error '未找到 node 命令，请先安装 Node.js 18+（https://nodejs.org）'
+  exit 1
+}
+
+if ($Help) {
+  & $node $mjs '--help'
+  exit $LASTEXITCODE
+}
+
+$argsList = [System.Collections.Generic.List[string]]::new()
+if ($DshHome) { $argsList.Add('--dsh-home'); $argsList.Add($DshHome) }
+if ($Profile) { $argsList.Add('--profile');  $argsList.Add($Profile) }
+
+& $node $mjs @argsList
+exit $LASTEXITCODE

package/uninstall.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# dsh-mcp-manager uninstall.sh — macOS / Linux uninstaller (thin wrapper around uninstall.mjs)
+#
+#   ./dsh-mcp-manager/uninstall.sh                    # default: ~/.dsh, web profile
+#   ./uninstall.sh --dsh-home /path/.dsh --profile web
+#
+# If "permission denied", run: chmod +x dsh-mcp-manager/uninstall.sh
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MJS="$SCRIPT_DIR/uninstall.mjs"
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "未找到 node 命令，请先安装 Node.js 18+（https://nodejs.org）" >&2
+  exit 1
+fi
+
+declare -a ARGS=()
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dsh-home) ARGS+=("--dsh-home" "${2:?--dsh-home 需要路径参数}"); shift 2 ;;
+    --profile)  ARGS+=("--profile" "${2:?--profile 需要名称参数}"); shift 2 ;;
+    -h|--help)  ARGS+=("--help"); shift ;;
+    *) echo "未知参数: $1（用 --help 查看用法）" >&2; exit 2 ;;
+  esac
+done
+
+exec node "$MJS" "${ARGS[@]}"

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

@@ -0,0 +1,131 @@
+# dsh-mcp-manager 安装方式
+
+![dsh-mcp-manager 设置页图例](show.png)
+
+一个给 DeepSeek Harness (DSH) 用的**常驻 MCP 服务管理插件**（loader 插件，不是动态会话插件）：安装后重启 DSH 依然存在，DSH 升级后可用一条命令修复。
+功能入口：**设置 → MCP 管理**。
+
+- 管理 `@deepseek-ai/dsh-mcp-client` 服务（新增 / 编辑 / 启用 / 禁用 / 重启 / 删除）
+- 支持两个级别：**项目级**（`profiles/<profile>/cordis.patch.yml`）、**全局**（`~/.dsh/cordis.patch.yml`）
+- 修改经 HMR 实时生效；附带工具数健康检查、JSON 导出/导入
+- 按 DSH 官方插件标准实现：对象形态插件（`name` + `inject` + `apply`）、`inject` 声明依赖、
+  `ctx.tools.register(defineTool(...))` 注册 4 个模型工具（`mcp_manager_list` / `set_enabled` / `restart` / `add`）
+- 包本身纯 JS、零依赖、跨平台（Windows / macOS / Linux 均支持）
+
+---
+
+## 一、安装（任选一种方式）
+
+### 方式 0：npx 一条命令（最快捷，需要 Node.js >= 18）
+
+```bash
+# 从 npm 安装（推荐）
+npx -y @xxxyz/dsh-mcp-manager
+
+# 或直接从 GitHub 安装（无需 npm 账号）
+npx -y github:xxxyz/DeepSeekHarness-MCP-Manager
+```
+
+所有参数照常透传，例如：`npx -y @xxxyz/dsh-mcp-manager --dsh-home D:\path\.dsh --profile web --repair --port 3080`。
+
+> npm 包名是 `@xxxyz/dsh-mcp-manager`（裸名 `dsh-mcp-manager` 在 npm 上已被无关插件占用）。插件部署名仍是 `dsh-mcp-manager`——npx 只是配送渠道，执行的是与下面同样的安装逻辑。
+
+### 方式 1：Windows（PowerShell）
+
+```powershell
+# 默认使用 ~/.dsh 和 web profile
+.\dsh-mcp-manager\install.ps1
+
+# 指定 DSH 主目录 / profile
+.\dsh-mcp-manager\install.ps1 -DshHome D:\path\.dsh -Profile web
+
+# 修复模式（见第四节）
+.\dsh-mcp-manager\install.ps1 -Repair -Port 3080
+```
+
+### 方式 2：macOS / Linux（bash）
+
+```bash
+# 默认使用 ~/.dsh 和 web profile
+./dsh-mcp-manager/install.sh
+
+# 指定 DSH 主目录 / profile
+./dsh-mcp-manager/install.sh --dsh-home /path/.dsh --profile web
+
+# 修复模式
+./dsh-mcp-manager/install.sh --repair --port 3080
+```
+
+> 若 `install.sh` 没有执行权限，先运行：`chmod +x dsh-mcp-manager/install.sh`
+
+### 方式 3：任何平台直接运行（推荐，最通用）
+
+```bash
+node dsh-mcp-manager/install.mjs                       # 默认 ~/.dsh + web
+node dsh-mcp-manager/install.mjs --dsh-home /path/.dsh --profile web
+node dsh-mcp-manager/install.mjs --repair --port 3080  # 修复模式
+```
+
+### 参数说明
+
+| 参数 | 说明 | 默认值 |
+|---|---|---|
+| `--dsh-home` / `-DshHome` | DSH 主目录（含 `profiles`、`settings.yaml` 的目录） | `$DSH_HOME` 环境变量，否则 `~/.dsh` |
+| `--profile` / `-Profile` | 要安装到的 profile 名 | `web` |
+| `--port` / `-Port` | 修复模式下探测 API 的端口（= DSH Web 端口） | `3080` |
+| `--repair` / `-Repair` | 修复模式：重新部署 + 触发 HMR 重应用 + 轮询 API 直到恢复 | 无 |
+| `--skip-patch` | 只复制包、不修改补丁文件 | 无 |
+
+---
+
+## 二、安装后验证
+
+1. **重启 DSH**（宿主插件与客户端模块在启动时加载；`mcp_manager_*` 4 个工具也在重启后注册）。
+2. 打开 **设置 → MCP 管理**，应能看到页面并管理现有 MCP 服务（如 stepfun）。
+
+> 如果页面在安装前就已打开，先刷新浏览器；仍不出现则重启 DSH。
+
+---
+
+## 三、卸载
+
+```powershell
+# 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 <名>]
+```
+
+然后重启 DSH。卸载会删除部署目录、`local-packages` 真源目录，并清理补丁里的 loader 行（补丁保持合法）。
+
+---
+
+## 四、DSH 升级后维护（--repair）
+
+DSH 升级后若发现 **设置里没有 MCP 管理** 或 **`mcp_manager_*` 工具消失**，运行一次修复命令即可：
+重新复制包、把 loader 行的 `config.version` 加一（触发 HMR 重新应用）、然后轮询 API 直到
+`POST /dsh-mcp-manager/api` 返回 `{ok:true}`（默认等 30 秒）。
+
+```bash
+node dsh-mcp-manager/install.mjs --repair --port 3080
+```
+
+> 如果 30 秒后 API 仍未恢复，重启一次 DSH —— loader 在启动时会重新导入最新代码。
+
+---
+
+## 五、常见问题
+
+- **重启后设置页没有"MCP 管理"**：确认安装脚本输出的路径是实际 DSH 主目录；
+  如果 DSH 用了非默认目录，请用 `--dsh-home` 指定。
+- **安装后立刻报补丁解析错误**：不会发生——脚本保证补丁始终是合法的顶层数组。
+- **给别人分发**：把整个 `dsh-mcp-manager` 文件夹发过去，对方按上面任一方式执行即可。
+- **HTTP 接口无鉴权**：仅限本机使用，不要把 DSH 的 Web 端口暴露到公网。
+
+---
+
+*版本：2.0.0 · 常驻 loader 插件（宿主 HTTP API + 4 个模型工具 + 浏览器设置页）*