@oh-agent/dsh-mcp-manager 0.1.0 → 0.1.1

package/README.md

@@ -1,5 +1,55 @@
 # @oh-agent/dsh-mcp-manager
 
+[English](#english) · 中文
+
+一个设置页，管理散落在本机各个 AI 开发工具里的 MCP 服务器。
+
+同一个 MCP 服务器，在 Claude Code 里写在 `~/.claude.json`，在 Cursor 里写在
+`~/.cursor/mcp.json`，在 VS Code 里叫 `servers` 而不是 `mcpServers`，在 OpenCode 里
+`command` 又变成了数组。这个插件把 18 个工具各自的配置文件读出来，按「文件」分组展示 ——
+每个配置文件一张卡片，点开看它声明了哪些服务器、每个服务器用什么启动命令、哪些字段带着明文令牌。
+每个服务器给一个开关，把它挂进 DeepSeek Harness；再给一次真连探活，看它到底能不能启动、
+手里有哪些工具。
+
+**开关只作用于 DeepSeek Harness，不改动任何其他工具的配置文件。** 这是整个插件最重要的一条约束。
+
+入口：DeepSeek Harness → **设置 → MCP**（位于「技能管理」和「插件市场」之间）。
+
+## 安装
+
+**方式一：插件管理页**（推荐）
+
+设置 → 插件管理 → 安装，搜索 `@oh-agent/dsh-mcp-manager`。
+
+**方式二：让 agent 安装**
+
+直接对 agent 说「安装 @oh-agent/dsh-mcp-manager」，它等价于：
+
+```
+plugin_manager  action: install_bundle  target: "@oh-agent/dsh-mcp-manager@0.1.1"
+```
+
+`target` 也可以填一个绝对目录 —— 本地源码目录，或者
+[v0.1.1 release](https://github.com/wangbobo-coder/dsh-mcp-manager/releases) 里附的
+`dsh-mcp-manager.tgz` 解出来的目录。
+
+**不要**手动 `pnpm add` 进 profile，也不要手改 profile 的 `package.json` 或
+`cordis.patch.yml`：装了包不等于选中了它的 bundle，手动装的后果是那一行存在但永远不会被挂载。
+
+安装后增加一个设置页和一个 agent 工具（`mcp_manage`）。它没有任何运行时依赖，不需要构建，
+也没有 `allowBuilds` 授权步骤。要求 Node `^22.19.0 || >=24.0.0`（DeepSeek Harness 自带
+Node 24，无需另装）。
+
+页面会读取其他工具的配置文件，但**开关不需要对它们有写权限**。所有数据都不离开本机 ——
+唯一的对外流量是你主动点的那次探活，且只发往你点的那一个服务器。
+
+完整中文文档（支持的工具清单、方言差异、安全模型、已知限制）见
+[README.zh.md](README.zh.md)。
+
+---
+
+## English
+
 Management page for the MCP servers scattered across every local AI development
 tool — one card per configuration file showing what it declares, one switch per
 server that mounts it in DeepSeek Harness, and one probe of what actually
@@ -10,11 +60,16 @@ Market).
 
 ## Install
 
-Install the bundle from the **Plugin Manager** page in Settings — from the npm
-registry, from this repository, or from the `dsh-mcp-manager.tgz` attached to the
-[v0.1.0 release](https://github.com/wangbobo-coder/dsh-mcp-manager/releases).
-The agent-side equivalent is `plugin_manager` with `action: install_bundle` and
-the bundle's absolute directory as `target`.
+Install the bundle from the **Plugin Manager** page in Settings, or point
+`plugin_manager` at the npm package:
+
+```
+plugin_manager  action: install_bundle  target: "@oh-agent/dsh-mcp-manager@0.1.1"
+```
+
+An absolute directory works as `target` too, which is how you install a local
+checkout or the `dsh-mcp-manager.tgz` attached to the
+[v0.1.1 release](https://github.com/wangbobo-coder/dsh-mcp-manager/releases).
 
 Do not `pnpm add` the package into the profile by hand, and do not edit the
 profile's `package.json` or `cordis.patch.yml`: installing a package is not the
@@ -350,3 +405,4 @@ node scripts/test-locale.mjs         en/zh key parity
 - **The MCP registry is not consulted.** `registry.modelcontextprotocol.io` is
   explicitly preview and not intended for direct host consumption, so server
   discovery is by scanning local files only.
+

package/README.zh.md

@@ -6,15 +6,26 @@
 
 ## 安装
 
-从设置的「插件管理」页安装 —— 可以从 npm 源装、从本仓库装，或者用
-[v0.1.0 release](https://github.com/wangbobo-coder/dsh-mcp-manager/releases) 里附的
-`dsh-mcp-manager.tgz`。agent 侧的等价写法是 `plugin_manager` 的 `action: install_bundle`，
-`target` 填 bundle 的绝对目录。
+**方式一：插件管理页**（推荐）
 
-不要手动 `pnpm add` 进 profile，也不要手改 profile 的 `package.json` 或
+设置 → 插件管理 → 安装，搜索 `@oh-agent/dsh-mcp-manager`。
+
+**方式二：让 agent 安装**
+
+直接说「安装 @oh-agent/dsh-mcp-manager」，等价于：
+
+```
+plugin_manager  action: install_bundle  target: "@oh-agent/dsh-mcp-manager@0.1.1"
+```
+
+`target` 也可以填一个绝对目录 —— 本地源码目录，或者
+[v0.1.1 release](https://github.com/wangbobo-coder/dsh-mcp-manager/releases) 里附的
+`dsh-mcp-manager.tgz` 解出来的目录。
+
+**不要**手动 `pnpm add` 进 profile，也不要手改 profile 的 `package.json` 或
 `cordis.patch.yml`：装了包不等于选中了它的 bundle，手动装的后果是那一行存在但永远不会被挂载。
 
-安装后增加一个设置页和一个 agent 工具（`mcp_manage`）。它没有任何运行时依赖，不需要构建，也没有 `allowBuilds` 授权步骤。
+安装后增加一个设置页和一个 agent 工具（`mcp_manage`）。它没有任何运行时依赖，不需要构建，也没有 `allowBuilds` 授权步骤。要求 Node `^22.19.0 || >=24.0.0`（DeepSeek Harness 自带 Node 24，无需另装）。
 
 页面会读取其他工具的配置文件，但**开关不需要对它们有写权限**。所有数据都不离开本机 —— 唯一的对外流量是你主动点的那次探活，且只发往你点的那一个服务器。
 
@@ -211,3 +222,4 @@ node scripts/test-locale.mjs         en/zh key parity
 ## 许可证
 
 MIT
+

package/lib/probe.js

@@ -20,7 +20,12 @@
 import { spawn } from 'node:child_process';
 
 const PROTOCOL_VERSION = '2025-06-18';
-const CLIENT_INFO = { name: 'dsh-mcp-manager', version: '0.1.0' };
+/*
+ * Sent to every server we handshake with, so a server's logs attribute the
+ * connection to this plugin and a version we still recognise. `test-release.mjs`
+ * asserts it matches package.json — a stale value here is otherwise invisible.
+ */
+const CLIENT_INFO = { name: 'dsh-mcp-manager', version: '0.1.1' };
 
 function rpcRequest(id, method, params) {
   return JSON.stringify({ jsonrpc: '2.0', id, method, params });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oh-agent/dsh-mcp-manager",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "One settings page for every MCP server on your machine: scan each AI tool's own config file, see which directory holds which server, probe whether it really starts, and mount or unmount it in DeepSeek Harness without ever editing the other tools' files. / 一个设置页管理本机所有 AI 开发工具的 MCP：按配置文件分组展示、真连探活、只在 DeepSeek Harness 内挂载/卸载，绝不改动其他工具的配置。",
   "license": "MIT",
   "type": "module",
@@ -66,3 +66,4 @@
     "node": "^22.19.0 || >=24.0.0"
   }
 }
+