前言¶
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 連接的開發者使用。
