dsh-mcp-panel 使用指南

给 DSH 官方 MCP 客户端加一个只读管理面板：/mcp 命令看服务器状态与健康诊断，Settings 里通过追加式配置文件片段增删改 MCP 服务器，并能试跑 mcp__* 工具。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add dsh-mcp-panel

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

/mcp 命令 —— 每 server 一行：transport、目标、工具数、连接状态（来自上游 seam；未观测时如实显示 unknown）、最近错误、重连计数——模型可读、会话日志可重建、五种输出语言。
/mcp <server> tools —— 模型可见的 mcp__* 工具名与描述。
/mcp <server> health —— 派生自愈建议（ENOENT → 依赖缺失、ECONNREFUSED、超时、401/403/404、DNS、限流、重连耗尽…）；退出码 / stderr 尾部如实标注待官方支持。
/mcp <server> call <tool> [json] —— 经官方工具管线（ctx.tools.execute()）试用调用；pre-execute 权限策略、审批、guard、post-execute 全部生效。
设置 → 插件 → MCP 页 —— 状态卡片（徽章、诊断、探测），加 server CRUD 与工具试用台。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个插件和我手写的 cordis.yml 有什么关系？

不冲突。官方 MCP 客户端是"桥"（每台服务器在 cordis.yml / cordis.patch.yml 里写一行），这个插件是"控制台"，只读取桥的状态、要写也只是追加新片段并自动备份，不会动你已写好的行。

它会改动我现有的 MCP 服务器配置吗？

不会。任何写入都是追加到 cordis.patch.yml 的尾部、并且先复制原文件到带时间戳的备份；卸载或回滚时只需删掉追加的那块，配置保持原状。

我能让它完全只读吗？

可以。把配置项 writeEnabled 设为 false，所有写入请求都会被拒绝（但仍然可以在控制台生成片段并复制到剪贴板，手动粘贴）。

/mcp 显示的连接状态为什么有时是 unknown？

因为官方 MCP 客户端目前没有把连接状态外发为可观察事件，控制台无法猜测——这是诚实默认值，只有上游真的发来状态事件后才会变成 connecting / connected / waiting / exhausted / disposed 之一。

在 Settings 里试跑工具会绕过审批吗？

不会。试跑走的就是官方 ctx.tools.execute() 流水线，权限策略、审批请求、护栏全部照常生效；如果当前会话有打开的回合，审批会路由到 Web 的审批通道。

探针（probe）会不会暴露我的 API Key？

不会。stdio 探针在子进程里只完成一次 MCP initialize 握手，不会发送你的密钥；任何 URL、错误文本、JWT、Bearer token 在显示前都会被 sanitize.ts 模块统一替换成 ***；你配置的 header 值根本不会出现在快照里。

/mcp 输出为什么有五种语言？Web 面板怎么只有两种？

/mcp 命令有独立的 outputLanguage 配置（en/zh/es/pt/hi），方便命令行和会话日志消费；浏览器面板的语言跟随应用 UI 语言（en/zh），两者是两套词库。

怎么彻底卸载？

从 cordis.patch.yml 删掉 mcp-panel 行（Web 配置热加载，无需重启），从 node_modules 移除 dsh-mcp-panel 包，再用 dsh --dump-config 确认没有 mcp-panel 行残留。

— 源: plugin_wiki.faq_json

DSH: 0.1.0-rc.8（dshWorkshop.compatibility.dshVersions 仅列出 rc.8；四个 dsh-* peerDependencies 范围 >=0.1.0-rc.8 <0.2.0）
Node: ^22.19.0 || >=24.0.0（package.json#engines.node）

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则