跳到主要内容
dsh marketplace

dsh-server-deck

已验证

dsh-server-deck · v0.1.0 · MIT · Web 界面

DSH 能力插件:服务器卡片仪表盘——已连接服务器的卡片视图(状态/CPU/内存/磁盘/延迟)+ 点卡片进入 xterm 交互终端;better-sidebar 页签与独立右侧抽屉双形态挂载

安装

dsh plugin add dsh-server-deck

用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。

源码

标签

说明文档

DSH Server Deck 🖧

DeepSeek Harness 的服务器卡片仪表盘 —— 已连接服务器的卡片视图(在线状态 / CPU / 内存 / 磁盘 / 延迟),点卡片直接进入 xterm.js 交互终端。

服务器卡片仪表盘

✨ 功能一览

卡片式服务器仪表盘

每台服务器一张卡,状态一目了然:

元素 说明
🟢🟡🔴⚪ 状态点 在线(带呼吸光晕)/ 离线 / 探测中 / 未知
系统信息行 OS 名称(Linux PRETTY_NAME / macOS 回退)、运行时长、核数、握手延迟
三条用量条 CPU · 内存 · 磁盘,<60% 绿 / ≥60% 黄 / ≥85% 红
错误详情 离线时内联展示失败原因(悬停看全文)

自动刷新周期可选 手动 / 10s / 15s / 30s / 60s,面板不可见或浏览器切后台时自动暂停。

⌨ 点卡片进交互终端

xterm.js 全功能终端:5000 行回滚、256 色、窗口尺寸实时同步、光标闪烁。Node 半区做 WebSocket ↔ ssh2 shell 双向桥。

交互终端

⤓ 一键导入 ~/.ssh/config

解析标准 ssh config(Host / HostName / User / Port / IdentityFile / ProxyJump),自动:

  • 跳过通配条目(Host *)与已存在主机;
  • 跳过 Git 托管平台密钥别名(如 Host github.com-xxx / User git——它们不是可管理的服务器);
  • 多别名行(Host 1.2.3.4 prod-gw)优先取语义化别名做展示名。

＋ 手动添加主机

密码 / 私钥文件(+口令)/ SSH Agent 三种认证;连接测试按钮即时反馈延迟。

添加服务器表单

🔀 双形态挂载

环境 形态
安装了 dsh-better-sidebar 注册为侧边栏「🖥 服务器」页签(order 45),原生 tab chrome、设置页开关、visible 门控轮询
未安装 自绘右侧可展开/收起面板:右缘竖条开关 + 拖缘调宽,宽度持久化

装载顺序无关:client 入口不声明强制依赖,由内层动态子插件等待服务就绪后注册页签并自动收起独立面板。

📦 安装

# 方式一:npm(已发布时)
dsh plugin --profile web add dsh-server-deck@latest

# 方式二:从源码
git clone https://github.com/meyaomiao/DSH-server-deck.git
cd DSH-server-deck && pnpm install && pnpm build
dsh plugin --profile web add /path/to/DSH-server-deck

安装后重启 dsh web(host 半新增了路由),浏览器 Ctrl+F5 强刷。侧边栏「+」菜单出现「服务器」页签即成功。

🔐 安全模型

  • 所有 API 与 PTY 升级路由仅回环放行(127.0.0.1/::1),防 DNS rebinding 与局域网直连;
  • 密码 / 私钥口令单独存放 ~/.dsh/server-deck.secrets.json(0600),台账文件不含秘密,API 响应永不回传;
  • 删除主机仅移出台账并断开连接池,不会在远端执行任何操作;
  • 指标采集通过一段只读 POSIX sh 探针脚本(top/free/df/uptime,Linux 与 macOS 宽容双兼容),解析失败的字段显示「—」。

🏗️ 架构

┌─ Client(lib/client.js)──────────────┐   ┌─ Host(lib/index.js)────────────────┐
│ better-sidebar 页签 ⇄ 独立抽屉 双形态 │◄──│ /server-deck/api/*  REST(仅回环)    │
│ React 卡片网格 / 表单 / xterm.js      │WS▶│ /server-deck/ws/pty ws↔ssh2 PTY 桥 │
└──────────────────────────────────────┘   │ ssh2 连接池 · 台账 ~/.dsh/*.json    │
                                           └────────────────────────────────────┘

🛠️ 开发

pnpm install
pnpm build       # esbuild:server bundle + client bundle(ModuleLoader 包装)
pnpm typecheck   # tsc --noEmit
pnpm test        # ssh config 解析 / 探针输出解析(Linux+Darwin) / 台账校验

📋 兼容性

  • DeepSeek Harness 0.1.0-rc.x(web profile)
  • dsh-better-sidebar 可选(未装时走独立抽屉形态)
  • Node ≥ 20;被管理服务器只需开放 SSH(无需预装任何东西)

License

MIT