本插件是 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 获取源码与许可证。