本插件是 DeepSeek Harness (DSH) 的一個擴展,旨在解決開發者頻繁查詢本地 WSL 發行版和遠程 SSH 機器狀態的需求。它通過探測硬件資源(CPU、內存、磁盤、GPU)和運行時環境(Docker、進程、systemd 服務),將結果寫入一份原子更新的 JSON 快照,並以多種方式呈現。
核心功能¶
本插件提供以下能力:
- 探測範圍:支持探測本地 WSL 發行版和遠程 SSH 機器。採集指標包括 CPU、內存、磁盤、GPU、Docker、進程和 systemd 服務。
- 展示方式:
- WinUI 3 桌面面板:提供置頂的原生窗口,實時顯示快照。
- 文本表格:使用
/wsx ...會話命令查看對齊的純文本表格。 - 結構化數據:通過
remote_*agent 工具獲取結構化 JSON 數據。 - MCP 服務器:提供 MCP stdio 服務器,可與任意 MCP 客戶端連接。
- 安全與依賴:
- 默認只讀:默認僅探測,寫操作需通過
allowMutations開關控制。 - 零依賴:不持有任何憑據,使用系統 OpenSSH 客戶端;零運行時 npm 依賴,自帶預編譯 WinUI 3 面板。
- 默認只讀:默認僅探測,寫操作需通過
安裝與啓用¶
這是一個標準的 DSH bundle 包。安裝後必須重啓 DSH 才能生效。
dsh plugin --profile desktop add link:C:\path\to\dsh-remote-panel
配置與使用¶
在 profile 的 cordis.patch.yml 中配置 config.targets。
示例配置包括 WSL 發行版和 SSH 遠程主機:
- id: dsh-remote-panel
name: dsh-remote-panel
config:
targets:
# WSL 目標
- kind: wsl
name: WSL Ubuntu 24.04
distro: Ubuntu-24.04
user: root
# SSH 目標
- kind: ssh
name: lab-gpu-01
host: 192.168.1.50
user: ubuntu
配置完成後,可以通過 /wsx ... 命令查看信息,或使用 remote_* 工具獲取 JSON 數據。同時,插件提供 Skills 和 MCP stdio 服務器,便於集成到自動化流程中。
系統要求與限制¶
- 面板環境:WinUI 3 面板需要 Windows 10 1809 (build 17763) 或更新版本。
- 跨平臺:非 Windows 主機能加載 host,命令和工具可用,但無法顯示 WinUI 3 浮窗。
- 超時設置:WSL 冷啓動默認超時 60 秒,若發行版剛關閉,可能需要等待較長時間。
生態背景¶
DSH 理念爲「一切皆插件」。本插件由社區維護,可從 GitHub 獲取源碼與許可證。