前言¶
DeepSeek Harness (DSH) 採用插件化架構，核心配置（MCP 服務器、技能、規則等）通常通過文件或命令行管理。對於需要頻繁調整配置或管理會話的用戶，這種方式不夠直觀。DSH Web 插件「基礎能力面板」提供了一套可視化的設置界面，允許在瀏覽器中直接管理 MCP 服務器、技能、規則與歸檔會話。
該插件由開發者 yxsj245 維護，採用模塊化 feature 註冊表設計，後續的可視化功能只需新增 feature 目錄即可接入，無需改動面板骨架。
核心功能¶
MCP 服務器¶
面板按作用域（用戶 profile / 預設 preset）分組展示所有 MCP 服務器。配置信息經過脫敏處理（環境變量、請求頭、密碼參數、URL 密碼均打碼），僅展示運行時狀態（已連接、工具數量、啓用/禁用狀態）。支持逐臺開關，寫入配置文件後 profile 熱重載，預設配置在新會話中生效。
技能¶
技能按作用域分組展示（項目級、自定義、用戶級、內置、運行時），支持搜索與過濾。可編輯技能的描述、觸發條件、元數據及調用權限，保存後通過 filesystem watcher 熱刷新生效。同名技能按註冊表優先級顯示生效版本（項目級 > 自定義 > 用戶級 > 內置）。
規則¶
展示全局規則（~/.dsh/AGENTS.md）與項目級規則（項目根至當前目錄鏈上的 AGENTS.md / CLAUDE.md / .local）。支持新建與整文件編輯，保存後對後續新會話生效。
歸檔會話¶
列出所有已歸檔會話，顯示標題、工作目錄、創建時間、日誌大小及事件條數。狀態標記包括運行中、已裝載、文件缺失。支持從歸檔集合恢復會話，以及刪除會話（提供單行、批量選中與全選功能，均需二次確認）。刪除時，只有 Agent 狀態爲 running 的會話不可刪除，確認條會提示“已裝載但空閒”的風險。
安裝與啓用¶
通過官方插件通道安裝：
dsh plugin --profile web add dsh-basics-panel@<version>
安裝完成後，在 DSH 的 Web 設置中即可看到「基礎能力面板」入口。
開發與同步¶
本倉庫當前使用 file: 本地依賴掛載到 web profile。pnpm build 僅更新本地倉庫代碼，不會更新 DSH 實際運行的代碼。開發完成後，必須執行同步命令將構建產物複製到 DSH 的 profile 安裝副本。
pnpm build
pnpm run sync
同步後需要重啓 DSH 進程，並在瀏覽器中硬刷新（Ctrl+F5）以加載新的客戶端代碼。配置文件（如 cordis.patch.yml / LICENSE）因硬鏈接機制，無需同步即可生效。
安全與約束¶
- 數據安全：敏感值只脫敏展示，絕不回傳明文；所有寫操作使用嚴格白名單與原子寫（臨時文件 + rename）機制。
- 會話保護：歸檔會話的恢復/刪除僅接受歸檔集合內的 ID，且運行中的會話不可刪除。
- 服務解析：可選服務（如
workspaceRegistry）必須在調用時刻解析，不能在apply()階段緩存，否則會拿到undefined並導致功能失效。
適用場景¶
適合需要通過圖形界面管理 DSH 配置、頻繁調試技能與規則、或處理歸檔會話的用戶。使用前請確認源碼與許可證，插件以當前 DSH 進程的權限運行。
結尾¶
該插件爲 DSH 生態提供了一個標準化的可視化配置入口，簡化了 MCP 服務器與技能的管理流程。更多細節與源碼，可訪問插件目錄或 GitHub 倉庫。
