dsh-mcp-setting

DeepSeek Harness 插件：在「设置」界面管理 DSH 配置文件里的 MCP 服务器。

功能

设置面板新增「MCP 服务器」页面，直接增删改 cordis.patch.yml 中的 @deepseek-ai/dsh-mcp-client 行：

• 列表：展示 $DSH_HOME/cordis.patch.yml（主配置）与 $DSH_HOME/profiles/<name>/cordis.patch.yml（各 profile 补丁）中的全部 MCP 服务器， 标注来源与端点摘要。
• 连接状态：每台服务器实时显示状态徽标（已连接 · 工具数 / 未连接 / 启动失败 / 加载中 / 其他 profile 未加载），页面每 5 秒静默刷新。状态由加载器 fiber 与工具 注册表（mcp__<serverName>__* 前缀）推断，不依赖 mcp-client 内部实现；断线重连的 退避窗口内可能短暂显示「已连接」。
• 开关：每台服务器自带启用/停用开关，写入 loader 行的 disabled 标志； DSH 的配置热加载会即时停用/恢复该服务器（无需重启）。
• 重启：页面顶部「重启 DSH」按钮（两次点击确认），以原命令行重新拉起 DSH 进程，页面自动刷新等待应用恢复。
• 新增：写入主配置文件（$DSH_HOME/cordis.patch.yml），自描述头注释自动补齐。
• 编辑 / 删除：作用于服务器所在文件；空掉的 insert 补丁条目一并移除。
• 校验：与 @deepseek-ai/dsh-mcp-client 的配置契约一致（id / serverName 唯一且 匹配命名规则，stdio 必须填写 command，streamable-http 必须填写 url），错误直接 拒绝写入并返回中文提示；编辑时保留表单未展示的字段（reconnect、 toolCallTimeoutMs 等），切换传输方式时自动清理另一侧的字段。
• 安全：所有写操作仅允许本机回环访问；每次写入前保留 .bak 备份，临时文件 + 改名原子落盘；yaml 文档级编辑，未触碰的注释与 !!js 表达式原样保留。

增删改与开关都会写入 cordis.patch.yml，DSH 的配置热加载（profile 与主配置的 cordis.patch.yml 监视）即时生效；完整重载可使用页面上的「重启 DSH」。

安装

快速安装（推荐）

插件已发布到 npm：dsh-mcp-setting。一条命令安装到目标 profile（如 web）：

pnpm dsh plugin --profile web add dsh-mcp-setting

该命令在 profile 目录执行 pnpm add，并自动把声明了 dsh.bundle 的 dsh-mcp-setting 加入 dsh.profile.bundles。重启 DSH 后插件随 bundles 自动装配（包内 cordis.patch.yml 自插入插件行），浏览器打开设置 → MCP 服务器。

移除：

pnpm dsh plugin --profile web remove dsh-mcp-setting

本地开发挂载

pnpm install && pnpm build          # 编译 lib/
# 或使用注入器生产线：dev_build_plugin → dev_install_package（web profile）

挂载后浏览器刷新页面，设置 → MCP 服务器。

开发

pnpm test          # vitest（patch-editor 纯逻辑 + controller fetch 桩）
pnpm typecheck
pnpm build         # tsc 编译 host + tsdown 打包 client

结构

• src/index.ts — Host 半边：/dsh-mcp-setting/api/* 路由（webServer），文件读写与校验。
• src/patch-editor.ts — 纯函数：patch 文档的增删改查与配置校验（可单测）。
• src/client/ — Client 半边：settings.section 槽位注册、fetch 传输、 React 设置页（zh/en）。
• tests/ — 单元测试。

协议

本项目以 MIT License 发布（Copyright © 2025 belowthetree），详见 LICENSE 文件。