前言¶
DeepSeek Harness 的核心理念是插件化。在本地开发或运行智能体时，管理连接的服务器往往需要手动维护 SSH 连接。dsh-server-deck 作为一个插件，为 DSH 客户端提供了可视化的服务器管理入口。
插件简介¶
dsh-server-deck 是 DeepSeek Harness 的服务器卡片仪表盘，由 meyaomiao 维护，采用 MIT 许可证。它解决了在 DSH 环境中缺乏直观的服务器状态监控和交互终端入口的问题。
核心功能¶
该插件提供以下能力：
- 服务器卡片仪表盘：实时监控在线状态、CPU、内存、磁盘和延迟。状态点通过颜色区分在线（带呼吸光晕）、离线、探测中或未知。
- xterm.js 交互终端：点击卡片可直接进入终端，支持 5000 行回滚、256 色显示以及窗口尺寸实时同步。
- 趋势视图：独立记录并可视化 CPU/内存/磁盘的变化，支持多时间窗口（1小时、24小时、一周、一个月等）。
- 双形态挂载：支持 better-sidebar 侧边栏页签或独立抽屉。若安装了 better-sidebar，会优先注册为侧边栏页签；未安装则显示为独立抽屉。
- SSH Config 导入：自动解析标准
~/.ssh/config文件，支持 Host、HostName、User、Port、IdentityFile、ProxyJump 等字段的解析与导入。 - 安全模型：API 与 PTY 升级路由仅回环放行（127.0.0.1/::1），防止 DNS rebinding 与局域网直连。密码与私钥口令单独存储在
~/.dsh/server-deck.secrets.（权限 0600），台账文件不包含秘密。
安装与启用¶
使用以下命令安装插件：
dsh plugin --profile web add dsh-server-deck
安装完成后，需要重启 dsh web 命令并强制刷新浏览器（Ctrl+F5）。重启后，侧边栏的“+”菜单中会出现“服务器”页签。
典型用法¶
- 打开“服务器”页签，点击工具栏的“📈 趋势”按钮，可以查看历史数据趋势。
- 点击任意服务器卡片，即可进入 xterm 交互终端进行操作。
注意事项¶
- 安全：API 与 PTY 仅允许回环访问。秘密文件存储在
~/.dsh/server-deck.secrets.，权限需设为 0600。 - 系统兼容：Linux / macOS / BSD 走只读 POSIX sh 探针；Windows OpenSSH 无 sh 时使用 PowerShell。
- 指标采集：指标采集在主机侧常驻，默认间隔 10 秒（可选 30s / 1m），与面板是否打开无关。
总结¶
dsh-server-deck 为 DeepSeek Harness 提供了从监控到终端交互的一站式解决方案，适合需要在 DSH 中管理多台服务器的场景。
