前言¶
在 DeepSeek Harness(DSH)生態裏,Skill 與 MCP 服務器往往散落在 profile 配置、工作區目錄和 ~/.dsh 下的文件中。瀏覽器端的 dsh-skill-mcp-panel 可以可視化管理,但若你長期在終端裏用 dsh-TUI,切到 Web 再改配置會打斷工作流。下面介紹面向 dsh-TUI 的客戶端插件 dsh-tui-skill-mcp-panel:在 TUI 內輸入 /skill-mcp 打開全屏管理場景,查看、啓停、添加、分組 Skill 與 MCP,改動儘量熱加載,不必重啓 TUI。
這是什麼¶
dsh-tui-skill-mcp-panel 由社區維護者 wuqiuwangtian 發佈,歸類爲 DSH 生態的客戶端插件(SkillHub 目錄:wuqiuwangtian/dsh-tui-skill-mcp-panel)。倉庫:github.com/wuqiuwangtian/dsh-tui-skill-mcp-panel。
一句話定位:給 dsh-TUI 用的 Skill 與 MCP 可視化管理面板,入口是 slash 命令 /skill-mcp 背後的全屏場景(README 中標註開發階段含 M0 探測 / M1 骨架,當前以 README「功能與進度」表爲準)。
核心功能¶
以下能力均來自倉庫 README(截至文檔中的開發狀態說明 2026-11-09)。
技能(Skill)¶
| 能力 | 狀態 |
|---|---|
| 只讀:全局/工作區列表、詳情、作用域篩選、搜索 | 已實現 |
寫入(M2 P0):啓用/停用(*.disabled)、軟刪除 + 回收站撤銷、本地路徑添加/導入、分組、批量 |
已實現 |
| 遷移/複製、zip 導入 | P1,未實現 |
MCP¶
| 能力 | 狀態 |
|---|---|
| 列表/啓停;stdio/HTTP 新增表單 | 已實現 |
本面板受管行編輯、刪除、撤銷;!!js 保留與脫敏 |
已實現(README 稱 M4) |
| 已有 profile 行仍僅支持啓停,home 層只讀 | 已實現 |
| 按 profile 隔離的 MCP 分組、搜索與狀態篩選 | 已實現 |
| 連接測試 | P1 可選 |
分組、診斷與入口¶
- 分組:顯示層分組、加入/移出、按組過濾;技能分組與 web 版共享
groups.json(v1);MCP 分組存私有配置並按 profile 隔離;組內批量動作爲 P1。 - 診斷:發現根與路徑、frontmatter 合法性、遮蔽/停用狀態、宿主能力探測;鎖 / 備份 / 回收站(M2+)等基礎能力。
- 入口:
/skill-mcp打開全屏場景。
熱加載¶
- 技能:磁盤 watcher。
- MCP:HMR 重組合;保存後面板顯示「已保存,熱加載中…」,生效後改爲「已生效」。README 註明 MCP 配置寫入後 HMR 約 2–2.5 秒,不承諾瞬時生效。
安裝與啓用¶
npm 尚未發佈。 插件以 trusted-in-process 方式運行:與宿主同進程、無沙箱,能讀寫 README 披露的配置與技能路徑;permissions: [] 不構成文件系統隔離。安裝前請自行覈對源碼與 MIT 許可證。
README 給出的發佈後安裝命令爲:
dsh plugin --profile dsh-tui add dsh-tui-skill-mcp-panel
當前版本號在 package.json 中爲 0.1.0-dev.0。從源碼安裝、構建與真機驗證見倉庫 AGENT.md §7。本任務禁止 git clone,未發佈前請按維護者文檔在可信環境中自行拉取與構建。
典型用法¶
- 在 dsh-TUI 中輸入
/skill-mcp並回車,打開管理場景;Esc或q關閉。 - 用方向鍵在「焦點」區域間移動(類似文件管理器);
Tab或數字1–4切換頁籤(技能、診斷、MCP、分組等,以界面爲準)。 - 技能頁:全局/工作區篩選、搜索;
空格啓停,d軟刪除,u撤銷,a本地路徑導入,v多選批量,g管理分組。 - MCP 頁:
a新增;Enter編輯、d刪除、u撤銷本面板受管行;空格啓停 profile 行;g分組,f狀態與分組篩選,/搜索,x清除過濾;i查看已知配置字段的脫敏詳情。 - 分組頁:
t切換技能/MCP;可新建、重命名、刪除分組;共享技能分組若遇外部修改拒寫,按大寫R刷新後重試。 - 通用:
/搜索,r重新掃描,?幫助。場景可用區域至少 40×16(宿主提供給場景的區域;終端窗口通常還需留出宿主邊距)。
MCP 表單中 args 使用 JSON 字符串數組,例如:
["--port", "3000"]
env / headers 每行 KEY=VALUE,支持 ${ENV} 表達式;敏感值輸入隱藏,保存前只顯示變更字段。
適用場景與注意¶
適合誰:主要在 dsh-TUI 裏作業、需要與 Web 面板相近的 Skill/MCP 管理能力、又希望留在終端內的用戶。與 Web 版共享部分磁盤約定(*.disabled、groups.json、補丁鎖等),但受管塊標記名不同;同時編輯同一分組文件時需注意 README 所述鎖與衝突行爲。
兼容性(README):
- 目標宿主:
@deepseek-harness-tui/dsh-tui>=0.19.0 <0.20.0 - DSH 內核:
0.2.2-rc.1線;Node>=24.9(package.jsonengines 爲^22.19 || >=24)
信任與權限:插件不申請額外權限聲明、不安裝插件、不執行用戶命令、不 eval 用戶表達式;但仍直接讀寫 ~/.dsh 下技能文件與當前 profile 的 cordis.patch.yml,寫前備份、原子寫。卸載面板會保留已保存的 MCP、分組、備份和回收站;MCP 與技能啓停狀態不會隨管理器卸載而自動恢復。
已知限制(節選):
- MCP 無「工作區級」,僅有 profile 可寫層與 home 全局只讀層。
- 只支持本面板新增的 MCP 受管行做完整編輯/刪除;未知 YAML 結構可能拒寫。
- 技能發現不遞歸嵌套目錄,與 DSH 內核一致。
- 首版不做技能正文編輯、插件安裝/更新、MCP OAuth、單工具禁用、伴隨 CLI 等。
DSH 社區插件目錄(如 SkillHub)由社區維護,與 DeepSeek / 幻方無官方從屬關係;選用插件前請閱讀倉庫 docs/需求文檔.md 與 docs/release-readiness.md 瞭解發佈前驗收狀態。
結尾¶
dsh-tui-skill-mcp-panel 把 Skill 與 MCP 的日常運維收進 dsh-TUI 的全屏場景,並與 Web 版在分組和部分文件約定上對齊,適合不願在 TUI 與瀏覽器之間來回切換的開發者。當前 npm 未發佈,安裝命令以上述 README「發佈後」一行爲準;細節與進度以 GitHub README 與 docs/ 爲準。