pc439527/dsh-side-monitor

DSH（DeepSeek Harness）Web 的只读系统监控插件：在左侧 Sidebar 底部提供「系统监控」入口，点击打开右侧监控面板，实时展示宿主机（DSH 所在主机）的系统概览、进程列表与 Docker 容器状态。

全程只读：不提供 docker restart/stop、process kill、exec、shell 等任何控制操作，适合随手查资源、排障和观察容器状态。

截图

功能特性

概览（Overview）

• CPU / 内存两张强卡片：大百分比 + 副信息 + 面积填充 Sparkline（固定 0–100 纵轴）。
• 网络主接口吞吐 / 根分区磁盘两张轻量 KPI。
• 下方 section 呈现：系统负载、系统信息、磁盘分区（多挂载点）、网络接口（默认路由 + 虚拟接口标记）、Docker 汇总（总数 / 运行 / 异常）。

进程（Processes）

• 来源标识（宿主机 / 当前容器）。
• 搜索 / 排序 / 分页全部下沉到 Host RPC（扫描全部进程后再过滤），数据量大也不卡浏览器。
• CPU / 内存 / PID / 名称排序 Chip；卡片显示 PID · PPID · 用户，点击展开 RSS / 运行时长 / 命令。
• 「列表 / 聚合」双视图：按 name+command 分组，展开查看 PID 列表。

Docker（Containers）

• 容器名 / 镜像 / 状态 / health（healthy/unhealthy/starting）/ CPU% / 内存 / 端口。
• 端口可操作：已发布（有 hostPort）的 Web 端口点击在新标签页打开；非 Web 端口点击复制 host:port；右键弹出 HTTP/HTTPS 打开 / 复制地址菜单。
• 正确处理 127.0.0.1 / 0.0.0.0 / 指定 hostIp（IPv6 自动加方括号）；未发布端口显示 🔒 且禁止打开；stats 失败容器显示 ⚠ tooltip。

体验与可靠性

• Sidebar 入口：注册到 sidebar.footer.action 插槽，展开时显示文字、折叠时仅图标，打开后高亮。
• 响应式：桌面端为可拖动宽度的右侧 Drawer（默认 500px，范围 360–800px，宽度持久化）；viewport < 768px 时自动切换为全屏页面，采用 Container Query 按面板自身宽度自适应，移动端 100dvh + 安全区适配。
• 采集来源标识：自动识别运行环境（Host / Container），顶部徽标 + 状态行（概览 / 进程 / Docker 分别标注来源）+「查看采集来源」弹窗（逐项展示真实来源路径 + 一致性自检）。
• 状态独立：三个模块各自 error / 更新时间，请求失败保留最后成功数据并显示 stale 横幅。
• 版本握手：RPC 响应携带 protocolVersion（v3）+ pluginVersion；不匹配时显示「版本不一致」横幅与「关于」面板（Browser / Host / RPC 版本），避免旧 Host 导致的 undefined 字段。
• 手动刷新（旋转动画）、「复制诊断信息」一键生成诊断文本。
• 面板关闭或浏览器标签页隐藏时停止/暂停轮询；同一轮询 await 上一请求，禁止重入。

安装

# 本地目录安装
dsh plugin --profile web add /path/to/dsh-side-monitor

安装后刷新页面，左侧 Sidebar 底部出现「系统监控」入口。

宿主机采集（Host Mount Mode）

DSH 运行在容器内时，默认读取的是容器自身的 /proc（容器视角）。要监控真正的宿主机，请为 DSH 容器增加只读挂载，把宿主机的 proc / sys / 根文件系统暴露到固定路径：

services:
  deepseek-harness:
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/host/root:ro
      - /var/run/docker.sock:/var/run/docker.sock

Collector 会自动检测这些路径（存在则优先使用宿主视角，否则回退容器视角），也可通过插件 config 显式指定：

procRoot: /host/proc
sysRoot:  /host/sys
fsRoot:   /host/root

挂载后，概览 / 进程读取宿主机资源，顶部来源标识自动变为「宿主机视角」。注意：/proc、/sys、/ 必须只读挂载。

刷新频率

数据	频率
CPU / 内存 / 网络 / 负载 / Uptime	2s
磁盘	10s（Host 端缓存）
进程列表	3s（Host 端 Snapshot Cache）
Docker 列表 + stats	5s（stats 3s 缓存）

架构

Client UI (Sidebar Trigger + Monitor Drawer/Fullscreen + 3 Tabs)
        │  RPC: connection.rpc.call('/side-monitor', ...)
        ▼
Host Service (lib/collectors.js + lib/rpc.js)
  ├─ Environment        (mode / systemSource / processSource / dockerSource / hostname)
  ├─ Overview Collector (procRoot/stat|meminfo|loadavg|uptime|cpuinfo|sys/kernel/osrelease + fsRoot/etc/os-release + net/dev|net/route + mounts/statfs)
  ├─ Process Collector  (procRoot/<pid>/stat|status|cmdline，Host 端搜索/排序/分页，含 PPID)
  ├─ Network Collector  (procRoot/net/dev 采样差分 + procRoot/net/route 默认路由 + fib_trie/if_inet6 接口 IP)
  ├─ Disk Collector     (procRoot/mounts + statfs 多挂载点，mountinfo major:minor 同设备去重，10s 缓存)
  └─ Docker Collector   (/var/run/docker.sock 只读 Engine API，health + 结构化端口)

安全说明

• 浏览器端不直接访问宿主机文件系统或 Docker Socket，所有采集经 Host 端白名单 RPC。
• Host 端仅暴露 /side-monitor 三个只读端点：overview / processes / containers；权限沿用 DSH 标准 trusted-host。
• 不提供任意命令执行、任意 Docker API 代理或任何控制操作。
• Host Mount Mode 的 /host/proc、/host/sys、/host/root 必须只读挂载。

开发

npm run check   # 语法检查
npm test        # node:test 单元测试（test/fixtures/proc 为真实 /proc 快照）

CI：GitHub Actions（Node 20 / 22）自动运行 check + test。

已知限制

• 完整宿主 PID 视图可通过 pid: host 获得，但默认不强制开启；开启后一致性自检会提示 PID 命名空间未隔离。
• 宿主 / 容器进程双视角切换、设置页、历史趋势、DSH 原生 Side Card 集成留待后续版本。

更新日志

• v0.2.2 可靠性收口：网络以 /proc/net/dev 为事实源（IP 解析失败仍保留接口与流量）；CPU 区分物理核心 / 逻辑 CPU；Docker 端口细化（loopback 锁定、hostIp 去重、uptime 中文化）；RPC 版本握手；进程聚合视图；移动端 100dvh + 安全区；fixture 单元测试与 CI。
• v0.2.1 宿主机指标准确性：负载 / 运行时长 / CPU 核心与型号 / 内核 / OS 改读宿主机真实来源；进程运行时长统一宿主机 uptime；网络 IP 改自 /proc/net/fib_trie 与 if_inet6；磁盘去重改用 mountinfo major:minor；来源自检。
• v0.2.0 采集来源标识、CPU / 内存卡片重做、Docker 端口可操作、Host Mount 模式。
• v0.1.0 首个版本：响应式监控面板。

License

MIT