前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的理念。在 Web 界面中，直接监控 MCP (Model Context Protocol) 连接的实时状态往往需要依赖开发者工具或非官方 UI 组件。dsh-mcp-pill 插件旨在提供一种原生的、可视化的状态胶囊，配合官方设置卡片，解决连接状态查看与切换的痛点。
插件定位¶
这是一个面向 DSH Web 进程的客户端插件，由 YrracOwl 维护，采用 MIT 许可证。它提供本机同源 RPC 接口、官方风格的设置卡片以及输入框状态胶囊，旨在为 MCP 连接提供生命周期安全的状态管理。
核心功能¶
状态胶囊与交互¶
- 提供输入框状态胶囊，用于显示所有已配置 MCP 连接的 JSON 状态。
- 胶囊默认隐藏，需在设置中开启。
- 支持拖动胶囊图标切换四个角落锚点，位置会保存在
localStorage(dsh.mcpPill.anchor) 中。 - 胶囊位于输入框层级，会覆盖 DSH Web 的原生弹窗（模态框、菜单、提示等）。
设置卡片¶
- 提供官方设置卡片，包含「显示状态胶囊」开关。
- 卡片注册在两个设置位置：
plugins.row.config(DSH >= 0.1.7-rc.2) 和settings.plugin.item(DSH <= 0.1.5)，确保兼容性。
RPC 接口¶
- 提供
GET /api/mcp-pill/status接口，返回所有连接状态及胶囊可见性。 - 提供
POST /api/mcp-pill/set接口，通过disabled标记切换连接状态。
兼容性¶
- 优先支持 DSH 0.1.2+ 的
remote.settings，旧版 RC 会自动回退到 connection API。 - 依赖
@deepseek-ai/schemastery(版本 >= 3.18.4)。
安装与启用¶
- 安装插件
确保环境满足要求：Node.js >= 18，且 DSH 版本为 0.1.2 或更高。
运行安装命令：
dsh plugin --profile web add dsh-mcp-pill
- 加载与配置
- 安装后必须重启 DSH Web 进程，Host 才会扫描到插件。
- 打开设置面板，找到插件卡片（或dsh-mcp-pill配置行）并开启「显示状态胶囊」。
典型用法¶
- 查看状态：胶囊会显示每个 MCP 连接的当前状态。
- 切换连接：在设置卡片中点击开关，或通过
POST /api/mcp-pill/set接口修改连接的disabled字段。 - 调整位置：按住胶囊图标拖动，可在输入框的四个角落间切换显示位置。
适用场景与注意¶
- 默认行为：胶囊默认隐藏，必须手动在设置中开启。
- 覆盖层级：由于胶囊渲染在输入框层级，可能会遮挡 DSH Web 的原生弹窗。
- 源码与许可证：安装前建议检查源码与许可证（MIT）。
生态背景¶
DSH 社区维护了插件目录（SkillHub），该目录独立于 DeepSeek 官方，仅作为社区资源索引。
结语¶
该插件为 DSH Web 提供了标准化的 MCP 状态监控入口，适合需要频繁调试 MCP 连接的开发者使用。
