dsh-tui-skill-mcp-panel:在 dsh-TUI 裏管理 Skill 與 MCP

前言

在 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,未發佈前請按維護者文檔在可信環境中自行拉取與構建。

典型用法

  1. 在 dsh-TUI 中輸入 /skill-mcp 並回車,打開管理場景;Esc 或 q 關閉。
  2. 用方向鍵在「焦點」區域間移動(類似文件管理器);Tab 或數字 1–4 切換頁籤(技能、診斷、MCP、分組等,以界面爲準)。
  3. 技能頁:全局/工作區篩選、搜索;空格 啓停,d 軟刪除,u 撤銷,a 本地路徑導入,v 多選批量,g 管理分組。
  4. MCP 頁:a 新增;Enter 編輯、d 刪除、u 撤銷本面板受管行;空格 啓停 profile 行;g 分組,f 狀態與分組篩選,/ 搜索,x 清除過濾;i 查看已知配置字段的脫敏詳情。
  5. 分組頁:t 切換技能/MCP;可新建、重命名、刪除分組;共享技能分組若遇外部修改拒寫,按大寫 R 刷新後重試。
  6. 通用:/ 搜索,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.json engines 爲 ^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/ 爲準。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜