dsh-project-mcp-manager 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wldxiaobai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# dsh-project-mcp-manager
+
+独立项目级 MCP 自动加载插件：在项目根 `<projectRoot>/.dsh/mcp.yml` 写入 MCP
+服务器配置，在该项目开启 dsh 会话时自动装载（经官方
+`@deepseek-ai/dsh-mcp-client`），文件改动热重载到运行中的 dsh 进程，并按
+会话 cwd 控制工具可见性。无 UI，核心功能精简型插件。
+
+## 工作原理
+
+- **项目发现**：在线 agent 会话的 `session.header.cwd` + dsh 进程启动目录 →
+  向上找最近的含 `.git` 的祖先目录作为项目根（无 `.git` 时退回目录本身）。
+- **装载**：每个 `(项目, serverName)` 在宿主 ctx 上装载一个
+  `@deepseek-ai/dsh-mcp-client` 实例（`ctx.plugin`），注册进全局工具层。
+  同一项目内多会话共享同一连接。
+- **热重载**：chokidar 监听各项目根（depth 2，忽略 node_modules/.git/.hg/
+  .svn），`.dsh/mcp.yml` 的增删改经 150ms 防抖触发全量对账：新增行装载、
+  删除行卸载、配置变化重装。
+- **生效名**：原始 `serverName` 在整个目录（全局行 + 全部项目行）中唯一时
+  保持原名；冲突时双方都改为 `p<sha256(项目根)前6位>_<原名>`（截断 32 字符，
+  确定性、与装载顺序无关），避免 `dsh-mcp-client` 按进程根的 serverName
+  预留冲突。全局行（profile `cordis.patch.yml` / bundle 层已装载的
+  mcp-client 行）参与占用判定但不改名。
+- **会话可见性**：agent 创建时按其会话 cwd 解析项目，对该 agent 应用
+  `tools.restrict({ deny })`，deny 掉除本会话项目外的全部项目服务器；会话
+  无 cwd 时回退 owner 项目（子代理），再回退 dsh 进程 cwd 所在项目。会话
+  销毁时释放。
+
+## 配置格式
+
+`<projectRoot>/.dsh/mcp.yml`，格式与 profile `cordis.patch.yml` 的受管块
+一致（begin/end 标记之间的 YAML insert 列表），每行一个 MCP 服务器：
+
+```yaml
+# >>> dsh-project-mcp-manager:mcp:begin
+- insert:
+    - id: panel-mcp-gitlab
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: gitlab
+        transport: stdio
+        command: npx
+        args: ['-y', '@modelcontextprotocol/server-gitlab']
+        cwd: .            # 相对项目根解析
+        toolCallTimeoutMs: 60000
+        failOnStartupError: false
+        reconnect:
+          enabled: true
+          initialDelayMs: 500
+          maxDelayMs: 30000
+          maxAttempts: 10
+# <<< dsh-project-mcp-manager:mcp:end
+```
+
+`transport` 支持 `stdio`（command/args/env/cwd）与 `streamable-http`
+（url/headers）。行加 `disabled: true` 即停用。标记之外的内容逐字节保留。
+
+## 安装（挂载到 profile）
+
+插件通过 **bundle patch** 挂载：把包加入 `dsh.profile.bundles` 后，dsh 启动时
+按顺序合成每个 bundle 的 patch（`dsh.bundle.patch` 指向的 `cordis.patch.yml`）
+作为插件行。**不要再往 profile 的 `cordis.patch.yml` 手动插入同名行**——两层
+同时存在会启动失败：`duplicate loader entry id: mcp-project`（EntryGroup
+拒绝重复 id）。二选一：留在 bundles，或移出 bundles 改手动插行，不能同时。
+
+**本地开发安装**（未发布 npm 前的推荐方式，junction 实时同步源码）：
+
+```powershell
+cd C:\Users\haima\.dsh\profiles\web
+pnpm add link:D:\path\to\dsh-mcp-project   # 源码包目录
+```
+
+然后在 `package.json` 的 `dsh.profile.bundles` 数组末尾追加
+`"dsh-project-mcp-manager"`，重启 dsh 生效（HMR 只热装首次 insert 的行，
+换实现需重启宿主进程）。
+
+**发布后安装**：`pnpm add dsh-project-mcp-manager`（或 dsh 的插件子命令，
+`dsh plugin --profile web ...`），同样确认包已加入 `dsh.profile.bundles`。
+
+## 与 dsh-skill-mcp-panel 的关系
+
+- 已装的 v2.0.1 面板：无项目级装载能力，与本插件不冲突；其全局受管块行
+  会被本插件读取（loader entries），项目同名行自动改名避开。
+- v2.1 面板源码（含 ProjectMcpRegistry）：与本插件功能重复，**同一进程内
+  两者只能启用一个**（双装载同一 serverName 会触发 mcp-client 的进程根
+  预留冲突）。v2.1 写出的项目文件行（`panel-mcp-` 前缀 id）本插件可直接
+  读取，过渡平滑。
+
+## 构建与测试
+
+```powershell
+npm install
+npm run build     # tsc → lib/
+node test/test-model.mjs
+node test/test-registry.mjs
+```
+
+## 安全边界
+
+`.dsh/mcp.yml` 中的 `stdio` 行会在 dsh 宿主进程内 spawn 其 `command`——
+项目文件是**可执行代码载体**，只应在可信项目中添加。装载失败/配置无效行
+仅告警跳过，不影响其他服务器。

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh-project-mcp-manager bundle patch.
+# When this package is installed with `dsh plugin --profile <name> add ...`,
+# the profile auto-appends it to dsh.profile.bundles and applies this layer,
+# so the plugin mounts without any manual cordis.patch.yml editing.
+- insert:
+    - id: mcp-project
+      name: dsh-project-mcp-manager

package/lib/index.js

@@ -0,0 +1,44 @@
+import { MCP_PLUGIN_NAME } from "./mcp-file.js";
+import { ProjectMcpRegistry } from "./registry.js";
+export const name = "dsh-project-mcp-manager";
+/** agents 为硬依赖：宿主启动早期插件行先于 agents 服务装载时，等待其就绪后再 apply，
+ *  保证构造时的 liveAgents 补扫能看到已恢复/已存在的会话。 */
+export const inject = ["tools", "agents"];
+export function apply(ctx) {
+    const registry = new ProjectMcpRegistry(ctx, {
+        /** 全局已装载 mcp-client 行的 serverName：从 loader include entry 的
+         *  config.patches（dsh-app-boot 传入的已生效 patch 配置，含 bundle 层
+         *  与 profile patch 层全部行）提取；loader.entries() 本身只暴露顶层
+         *  include entry，子树行必须经 patches 展开。 */
+        globalNames: async () => {
+            try {
+                const loader = ctx.loader;
+                if (loader === undefined || typeof loader.entries !== "function")
+                    return [];
+                const names = [];
+                for (const entry of loader.entries()) {
+                    const patches = entry?.config?.patches ?? entry?.options?.config?.patches;
+                    if (!Array.isArray(patches))
+                        continue;
+                    for (const patch of patches) {
+                        const rows = Array.isArray(patch?.insert) ? patch.insert : [];
+                        for (const row of rows) {
+                            if (row?.name !== MCP_PLUGIN_NAME || row?.disabled === true)
+                                continue;
+                            const serverName = row?.config?.serverName;
+                            if (typeof serverName === "string" && serverName !== "")
+                                names.push(serverName);
+                        }
+                    }
+                }
+                return [...new Set(names)];
+            }
+            catch {
+                return [];
+            }
+        }
+    });
+    // registry 的装载/清理全部由其自身在构造时经 ctx.on / ctx.effect 注册，
+    // 此处只需保持引用存活（apply 作用域 + registry 内部 fiber 持有）。
+    void registry;
+}

package/lib/mcp-file.js

@@ -0,0 +1,220 @@
+/**
+ * dsh-project-mcp-manager —— 项目 MCP 配置文件（<projectRoot>/.dsh/mcp.yml）编辑器。
+ *
+ * 项目文件使用与 profile cordis.patch.yml 相同的受管块格式：begin/end 标记
+ * 之间的 YAML insert 列表（与 @deepseek-ai/dsh-mcp-client 插件行同构）。
+ * 本插件只读写 begin/end 标记之间的行，标记之外的内容逐字节保留。
+ * 写入使用同目录临时文件 + rename，并通过锁文件避免并发写。
+ *
+ * 标记名与 dsh-skill-mcp-panel 不同（dsh-project-mcp-manager vs dsh-skill-mcp-panel），
+ * 但行 id 前缀兼容 panel 的 `panel-mcp-`，v2.1 面板写出的项目文件可直接读取。
+ */
+import { open, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parseDocument, stringify } from "yaml";
+export const MCP_BLOCK_BEGIN = "# >>> dsh-project-mcp-manager:mcp:begin";
+export const MCP_BLOCK_END = "# <<< dsh-project-mcp-manager:mcp:end";
+export const MCP_PLUGIN_NAME = "@deepseek-ai/dsh-mcp-client";
+/** 兼容 dsh-skill-mcp-panel 的受管行 id 前缀（其项目文件行可直接装载）。 */
+export const MANAGED_ROW_ID_PREFIX = "panel-mcp-";
+const delay = (ms) => new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
+/** 读取 patch 文件；缺失/读失败统一带路径报错。 */
+export async function readPatchFile(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        throw new Error("无法读取 patch 文件（" + path + "）：" + (error instanceof Error ? error.message : String(error)));
+    }
+}
+/** 校验整份 patch 文本：可解析且顶层是数组。不解出/写回任何值。 */
+export async function validatePatchText(raw) {
+    const doc = parseDocument(raw, { logLevel: "silent" });
+    if (doc.errors.length > 0) {
+        throw new Error("cordis.patch.yml 解析失败：" + String(doc.errors[0]?.message ?? doc.errors[0]));
+    }
+    const parsed = doc.toJS();
+    if (!Array.isArray(parsed))
+        throw new Error("cordis.patch.yml 顶层必须是 YAML 数组");
+}
+/** 把 YAML 解析出的顶层条目拍平成 patch 行。 */
+function flattenPatchRows(entries) {
+    const rows = [];
+    if (!Array.isArray(entries))
+        return rows;
+    const pushRow = (value) => {
+        if (value === null || typeof value !== "object" || Array.isArray(value))
+            return;
+        const row = value;
+        if (typeof row.id === "string" || typeof row.name === "string") {
+            const normalized = { ...row };
+            if (typeof row.id !== "string")
+                delete normalized.id;
+            if (typeof row.name !== "string")
+                delete normalized.name;
+            if (typeof row.disabled !== "boolean")
+                delete normalized.disabled;
+            if (row.config === null || typeof row.config !== "object" || Array.isArray(row.config))
+                delete normalized.config;
+            rows.push(normalized);
+        }
+    };
+    for (const entry of entries) {
+        if (entry === null || typeof entry !== "object" || Array.isArray(entry))
+            continue;
+        const record = entry;
+        if (Array.isArray(record.insert)) {
+            for (const row of record.insert)
+                pushRow(row);
+        }
+        else {
+            pushRow(record);
+        }
+    }
+    return rows;
+}
+/** 提取 begin/end 标记之间的受管行；无标记返回空数组。 */
+export function extractManagedRows(raw) {
+    const begin = raw.indexOf(MCP_BLOCK_BEGIN);
+    const end = raw.indexOf(MCP_BLOCK_END);
+    if (begin < 0 && end < 0)
+        return [];
+    if (begin < 0 || end < 0 || end < begin)
+        throw new Error("项目 MCP 文件中 dsh-project-mcp-manager 受管块标记不完整（begin/end 必须成对）");
+    const blockStart = raw.indexOf("\n", begin);
+    if (blockStart < 0)
+        throw new Error("项目 MCP 文件受管块格式损坏");
+    const blockText = raw.slice(blockStart + 1, end);
+    const doc = parseDocument(blockText, { logLevel: "silent" });
+    if (doc.errors.length > 0)
+        throw new Error("受管块解析失败：" + String(doc.errors[0]?.message ?? doc.errors[0]));
+    const parsed = doc.toJS();
+    if (!Array.isArray(parsed))
+        throw new Error("受管块内容必须是 YAML 数组");
+    return flattenPatchRows(parsed);
+}
+/** 生成受管块文本（无行时为空字符串）。 */
+export function generateManagedBlock(rows) {
+    if (rows.length === 0)
+        return "";
+    const body = stringify([{ insert: rows }], { indent: 2, lineWidth: 0 });
+    return MCP_BLOCK_BEGIN + "\n" + body + MCP_BLOCK_END + "\n";
+}
+/**
+ * 替换受管块；无标记且要写入行时追加到文件末尾。标记之外的所有字节原样保留。
+ */
+export function replaceManagedBlock(raw, rows) {
+    const begin = raw.indexOf(MCP_BLOCK_BEGIN);
+    const end = raw.indexOf(MCP_BLOCK_END);
+    const block = generateManagedBlock(rows);
+    if (begin >= 0 || end >= 0) {
+        if (begin < 0 || end < 0 || end < begin)
+            throw new Error("项目 MCP 文件中 dsh-project-mcp-manager 受管块标记不完整（begin/end 必须成对）");
+        const lineStart = raw.lastIndexOf("\n", begin - 1) + 1;
+        const afterEnd = raw.indexOf("\n", end);
+        const lineEnd = afterEnd < 0 ? raw.length : afterEnd + 1;
+        const next = raw.slice(0, lineStart) + block + raw.slice(lineEnd);
+        if (block !== "")
+            return next;
+        // 删除最后一批受管行后，原文件可能只剩注释；此时必须补回流式空数组，
+        // 否则文件不再是合法顶层数组。
+        const meaningful = next.split(/\r?\n/).map((line) => line.trim()).filter((line) => line !== "" && !line.startsWith("#"));
+        if (meaningful.length === 0)
+            return next.replace(/\s*$/, "") + "\n[]\n";
+        return next;
+    }
+    if (block === "")
+        return raw;
+    // 空模板是流式空数组 `[]`：直接追加块序列会变成 `[] - insert`，
+    // 必须在追加前把 `[]` 替换为受管块序列。
+    const lines = raw.split(/\r?\n/);
+    const meaningful = lines.map((line) => line.trim()).filter((line) => line !== "" && !line.startsWith("#"));
+    if (meaningful.length === 1 && meaningful[0] === "[]") {
+        const index = raw.lastIndexOf("[]");
+        return raw.slice(0, index) + block + raw.slice(index + 2);
+    }
+    const prefix = raw.length === 0 ? "" : raw.endsWith("\n") ? "\n" : "\n\n";
+    return raw + prefix + block;
+}
+/** 同目录临时文件 + rename 原子写；Windows 上 rename 覆盖失败时退化为 rm+rename。 */
+export async function writeFileAtomic(path, content) {
+    const temp = join(dirname(path), ".dsh-project-mcp-manager-tmp-" + process.pid + "-" + Math.random().toString(36).slice(2, 8));
+    try {
+        await writeFile(temp, content, "utf8");
+        try {
+            await rename(temp, path);
+        }
+        catch (error) {
+            if (error === null || typeof error !== "object" || !["EPERM", "EEXIST", "EACCES"].includes(error.code ?? ""))
+                throw error;
+            await rm(path, { force: true });
+            await rename(temp, path);
+        }
+    }
+    finally {
+        await rm(temp, { force: true }).catch(() => { });
+    }
+}
+/**
+ * 以 `<path>.mcp-project.lock` 为锁执行 fn。锁文件记录 pid + 时间；超过 30 秒
+ * 视为陈旧锁自动清理。获取超时 5 秒。
+ */
+export async function withPatchLock(path, fn) {
+    const lockPath = path + ".mcp-project.lock";
+    // 项目文件首次写入时父目录可能不存在：锁文件也需要父目录。
+    await mkdir(dirname(lockPath), { recursive: true });
+    const started = Date.now();
+    let handle;
+    while (handle === undefined) {
+        try {
+            handle = await open(lockPath, "wx");
+        }
+        catch (error) {
+            if (error === null || typeof error !== "object" || error.code !== "EEXIST")
+                throw error;
+            try {
+                const info = await stat(lockPath);
+                if (Date.now() - info.mtimeMs > 30000)
+                    await rm(lockPath, { force: true }).catch(() => { });
+            }
+            catch {
+                // 锁在检查间隙被释放：继续重试。
+            }
+            if (Date.now() - started > 5000)
+                throw new Error("等待项目 MCP 文件写锁超时（可能有其他进程正在写入）");
+            await delay(50);
+        }
+    }
+    try {
+        await handle.writeFile(process.pid + "\n" + Date.now() + "\n", "utf8");
+        return await fn();
+    }
+    finally {
+        await handle.close().catch(() => { });
+        await rm(lockPath, { force: true }).catch(() => { });
+    }
+}
+/**
+ * 读取 patch 文件、替换受管块、校验、加锁原子写回。
+ * createIfMissing 时文件缺失（或父目录缺失）按空文件处理：用于项目级
+ * <projectRoot>/.dsh/mcp.yml 的首次写入。
+ * 返回写回后的完整文本。
+ */
+export async function writeManagedRows(path, rows, options = {}) {
+    return withPatchLock(path, async () => {
+        let raw;
+        try {
+            raw = await readPatchFile(path);
+        }
+        catch (error) {
+            if (options.createIfMissing !== true)
+                throw error;
+            await mkdir(dirname(path), { recursive: true });
+            raw = "";
+        }
+        const next = replaceManagedBlock(raw, rows);
+        await validatePatchText(next);
+        await writeFileAtomic(path, next);
+        return next;
+    });
+}

package/lib/model.js

@@ -0,0 +1,253 @@
+/**
+ * dsh-project-mcp-manager —— MCP 服务器配置模型（纯函数）。
+ *
+ * 模型本身不含 scope：scope 是配置所在文件（profile cordis.patch.yml =
+ * 全局，<projectRoot>/.dsh/mcp.yml = 项目）的属性。env/headers 的 null 是
+ * 编辑语义：string = 覆盖该 key，null = 删除该 key，不出现 = 保留旧值。
+ */
+import { z } from "zod";
+import { createHash } from "node:crypto";
+import { resolve } from "node:path";
+import { MANAGED_ROW_ID_PREFIX, MCP_PLUGIN_NAME } from "./mcp-file.js";
+export const SERVER_NAME_RE = /^[A-Za-z0-9_-]{1,32}$/;
+export const DEFAULT_TOOL_CALL_TIMEOUT_MS = 60000;
+export const DEFAULT_RECONNECT = {
+    enabled: true,
+    initialDelayMs: 500,
+    maxDelayMs: 30000,
+    maxAttempts: 10
+};
+const serverNameSchema = z.string().regex(SERVER_NAME_RE, "serverName 只能包含 1-32 位字母、数字、下划线或连字符");
+const secretMapSchema = z.record(z.string(), z.string().nullable()).optional();
+const reconnectSchema = z.object({
+    enabled: z.boolean().default(DEFAULT_RECONNECT.enabled),
+    initialDelayMs: z.number().int().min(1).default(DEFAULT_RECONNECT.initialDelayMs),
+    maxDelayMs: z.number().int().min(1).default(DEFAULT_RECONNECT.maxDelayMs),
+    maxAttempts: z.number().int().min(1).default(DEFAULT_RECONNECT.maxAttempts)
+}).default({ ...DEFAULT_RECONNECT });
+export const stdioServerSchema = z.object({
+    serverName: serverNameSchema,
+    transport: z.literal("stdio"),
+    command: z.string().min(1),
+    args: z.array(z.string()).default([]),
+    env: secretMapSchema,
+    cwd: z.string().default(""),
+    toolCallTimeoutMs: z.number().int().min(1).default(DEFAULT_TOOL_CALL_TIMEOUT_MS),
+    failOnStartupError: z.boolean().default(false),
+    reconnect: reconnectSchema
+});
+export const httpServerSchema = z.object({
+    serverName: serverNameSchema,
+    transport: z.literal("streamable-http"),
+    url: z.string().url(),
+    headers: secretMapSchema,
+    toolCallTimeoutMs: z.number().int().min(1).default(DEFAULT_TOOL_CALL_TIMEOUT_MS),
+    failOnStartupError: z.boolean().default(false),
+    reconnect: reconnectSchema
+});
+export const mcpServerInputSchema = z.discriminatedUnion("transport", [stdioServerSchema, httpServerSchema]);
+/** 项目根的规范化键（Windows 大小写不敏感），作 Map 键用。 */
+export function projectKeyOf(projectRoot) {
+    const normalized = resolve(projectRoot);
+    return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+/**
+ * 冲突时的命名空间生效名：`p<sha256(projectKeyOf(projectRoot))前6位hex>_<原始名>`，
+ * 截断到 32 字符（保持 SERVER_NAME_RE 合法）。确定性，与装载顺序、路径大小写
+ * 写法无关。
+ */
+export function namespacedServerName(projectRoot, name) {
+    const hash = createHash("sha256").update(projectKeyOf(projectRoot)).digest("hex").slice(0, 6);
+    return ("p" + hash + "_" + name).slice(0, 32);
+}
+/**
+ * 计算全部 (projectRoot, 原始名) → 生效名的映射：
+ * 原始名在整个目录（全局行 + 所有项目行）中唯一时保持原名；否则该名的
+ * 每个项目拥有者都改用 namespacedServerName（全局行参与占用判定但不改名）。
+ * 键 = projectKeyOf(projectRoot) + "\0" + 原始名。
+ */
+export function effectiveServerNames(projects, globalNames = []) {
+    const counts = new Map();
+    const add = (name) => counts.set(name, (counts.get(name) ?? 0) + 1);
+    for (const name of globalNames)
+        add(name);
+    for (const project of projects) {
+        for (const name of project.names)
+            add(name);
+    }
+    const result = new Map();
+    for (const project of projects) {
+        for (const name of project.names) {
+            result.set(projectKeyOf(project.projectRoot) + "\0" + name, (counts.get(name) ?? 0) > 1 ? namespacedServerName(project.projectRoot, name) : name);
+        }
+    }
+    return result;
+}
+/**
+ * 会话可见性：某会话项目应 deny 的生效名 = 全部已装载项目服务器 − 本会话
+ * 项目的。sessionProject 为 undefined（无 cwd / 未知项目）时 deny 全部。
+ */
+export function denySetFor(sessionProject, mounted) {
+    const deny = new Set();
+    const own = sessionProject === undefined ? undefined : projectKeyOf(sessionProject);
+    for (const group of mounted) {
+        if (own !== undefined && projectKeyOf(group.projectRoot) === own)
+            continue;
+        for (const name of group.effectiveNames)
+            deny.add(name);
+    }
+    return [...deny];
+}
+/** 兼容 dsh-skill-mcp-panel 的行 id ↔ serverName。 */
+export function rowIdForServerName(serverName) {
+    return MANAGED_ROW_ID_PREFIX + serverName;
+}
+export function serverNameFromRowId(id) {
+    if (typeof id !== "string" || !id.startsWith(MANAGED_ROW_ID_PREFIX))
+        return undefined;
+    const name = id.slice(MANAGED_ROW_ID_PREFIX.length);
+    return SERVER_NAME_RE.test(name) ? name : undefined;
+}
+/** null = 删除，string = 覆盖；缺省 key 保留旧值。 */
+export function mergeSecretPatch(previous, patch) {
+    const merged = { ...(previous ?? {}) };
+    for (const [key, value] of Object.entries(patch ?? {})) {
+        if (value === null)
+            delete merged[key];
+        else
+            merged[key] = value;
+    }
+    return merged;
+}
+function normalizeReconnect(input) {
+    return {
+        enabled: input.reconnect.enabled,
+        initialDelayMs: input.reconnect.initialDelayMs,
+        maxDelayMs: input.reconnect.maxDelayMs,
+        maxAttempts: input.reconnect.maxAttempts
+    };
+}
+/** 面板输入 → 官方 @deepseek-ai/dsh-mcp-client 配置。 */
+export function toOfficialConfig(input) {
+    const common = {
+        serverName: input.serverName,
+        toolCallTimeoutMs: input.toolCallTimeoutMs,
+        failOnStartupError: input.failOnStartupError,
+        reconnect: normalizeReconnect(input)
+    };
+    if (input.transport === "stdio") {
+        return {
+            ...common,
+            transport: "stdio",
+            command: input.command,
+            args: input.args,
+            env: mergeSecretPatch({}, input.env),
+            cwd: input.cwd
+        };
+    }
+    return {
+        ...common,
+        transport: "streamable-http",
+        url: input.url,
+        headers: mergeSecretPatch({}, input.headers)
+    };
+}
+/** 输入 → cordis.patch.yml / 项目 mcp.yml 行。 */
+export function toPatchRow(input, enabled = true) {
+    return {
+        id: rowIdForServerName(input.serverName),
+        name: MCP_PLUGIN_NAME,
+        ...(enabled ? {} : { disabled: true }),
+        config: toOfficialConfig(input)
+    };
+}
+/** 读取 patch 行中的 config（宽松，坏行返回 undefined）。 */
+export function configFromPatchRow(row) {
+    if (row === undefined || row.name !== MCP_PLUGIN_NAME)
+        return undefined;
+    if (row.config === null || typeof row.config !== "object" || Array.isArray(row.config))
+        return undefined;
+    return row.config;
+}
+function asString(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function asStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function asNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function asBoolean(value, fallback) {
+    return typeof value === "boolean" ? value : fallback;
+}
+function secretKeys(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return [];
+    return Object.keys(value).filter((key) => typeof value[key] === "string");
+}
+/** patch 行 → 脱敏 view。密钥值不返回。scope/effectiveServerName 由调用方给出。 */
+export function patchRowToView(row, scope, effectiveServerName) {
+    const config = configFromPatchRow(row);
+    if (config === undefined)
+        return undefined;
+    const serverName = asString(config.serverName);
+    if (!SERVER_NAME_RE.test(serverName))
+        return undefined;
+    const transport = config.transport === "streamable-http" ? "streamable-http" : config.transport === "stdio" ? "stdio" : "unknown";
+    const reconnectRaw = config.reconnect !== null && typeof config.reconnect === "object" && !Array.isArray(config.reconnect) ? config.reconnect : {};
+    return {
+        serverName,
+        transport,
+        enabled: row.disabled !== true,
+        entryId: row.id,
+        ...(scope === undefined ? {} : { scope }),
+        ...(effectiveServerName === undefined ? {} : { effectiveServerName }),
+        command: transport === "stdio" ? asString(config.command) : undefined,
+        args: transport === "stdio" ? asStringArray(config.args) : undefined,
+        envKeys: transport === "stdio" ? secretKeys(config.env) : [],
+        cwd: transport === "stdio" ? asString(config.cwd) : undefined,
+        url: transport === "streamable-http" ? asString(config.url) : undefined,
+        headerKeys: transport === "streamable-http" ? secretKeys(config.headers) : [],
+        toolCallTimeoutMs: asNumber(config.toolCallTimeoutMs, DEFAULT_TOOL_CALL_TIMEOUT_MS),
+        failOnStartupError: asBoolean(config.failOnStartupError, false),
+        reconnect: {
+            enabled: asBoolean(reconnectRaw.enabled, DEFAULT_RECONNECT.enabled),
+            initialDelayMs: asNumber(reconnectRaw.initialDelayMs, DEFAULT_RECONNECT.initialDelayMs),
+            maxDelayMs: asNumber(reconnectRaw.maxDelayMs, DEFAULT_RECONNECT.maxDelayMs),
+            maxAttempts: asNumber(reconnectRaw.maxAttempts, DEFAULT_RECONNECT.maxAttempts)
+        }
+    };
+}
+/** 从 patch 行读取完整输入（含 secret 值，仅供本机装载/测试使用，不跨 RPC）。 */
+export function inputFromPatchRow(row) {
+    const config = configFromPatchRow(row) ?? {};
+    const serverName = asString(config.serverName, serverNameFromRowId(row.id) ?? "");
+    const common = {
+        serverName,
+        toolCallTimeoutMs: asNumber(config.toolCallTimeoutMs, DEFAULT_TOOL_CALL_TIMEOUT_MS),
+        failOnStartupError: asBoolean(config.failOnStartupError, false),
+        reconnect: {
+            enabled: asBoolean(config.reconnect?.enabled, DEFAULT_RECONNECT.enabled),
+            initialDelayMs: asNumber(config.reconnect?.initialDelayMs, DEFAULT_RECONNECT.initialDelayMs),
+            maxDelayMs: asNumber(config.reconnect?.maxDelayMs, DEFAULT_RECONNECT.maxDelayMs),
+            maxAttempts: asNumber(config.reconnect?.maxAttempts, DEFAULT_RECONNECT.maxAttempts)
+        }
+    };
+    if (config.transport === "streamable-http") {
+        return mcpServerInputSchema.parse({
+            ...common,
+            transport: "streamable-http",
+            url: asString(config.url),
+            headers: config.headers
+        });
+    }
+    return mcpServerInputSchema.parse({
+        ...common,
+        transport: "stdio",
+        command: asString(config.command),
+        args: asStringArray(config.args),
+        env: config.env,
+        cwd: asString(config.cwd)
+    });
+}

package/lib/project-root.js

@@ -0,0 +1,30 @@
+/**
+ * dsh-project-mcp-manager —— 项目锚点解析。
+ *
+ * 与 dsh 官方 skills 发现（@deepseek-ai/dsh-skill-filesystem）的项目根规则
+ * 一致：向上找最近的含 .git 的祖先目录，找不到就退回 cwd 本身。
+ */
+import { access } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+/** 判断文件系统路径是否存在。 */
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 项目锚点：向上找最近的含 .git 的祖先目录；找不到就退回 cwd 本身。 */
+export async function findProjectRoot(cwd) {
+    let current = resolve(cwd);
+    while (true) {
+        if (await pathExists(join(current, ".git")))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return resolve(cwd);
+        current = parent;
+    }
+}