系统监控 lof6yo/dsh-monitor

dsh-monitor

轻量 DSH Web 资源与运行监控插件，只保留左栏全局页。

仓库：<https://github.com/lof6yo/dsh-monitor>

- 左栏入口：sidebar.panellist 图标 → 中央「系统监控」页。
- 资源卡片：CPU（总/分核）、内存/Swap、磁盘（/、/home）、网络、DSH 服务进程/cgroup，均为圆角卡片。
- 工作区饼图：把工作区列表合并为一张宽圆角卡片。整圈 = 工作区所在磁盘的总空间；切片 = 各工作区目录大小 + 其他占用 + 未使用空间。图例直接标出工作区名称、目录大小与占磁盘总空间的百分比；卡片底部汇总工作区/会话/运行中智能体数量。
- 不再提供右栏标签：右侧边栏不再注册任何工作区监控 tab。
- 轻量：零第三方依赖；Host 只在有 SSE 订阅者时以 2s 间隔采样，最后一个订阅者离开即停止；浏览器页面隐藏时主动断开流。目录大小默认 5 分钟才重扫一次。
- 鉴权：所有路由先过 connection.requestRejection（Host/Origin + 浏览器登录），无 connection 服务时 fail-closed 到 loopback。
- 诚实归因：DSH 的会话/智能体运行在同一个 node 进程内，无法按工作区精确拆分 CPU/内存；饼图只展示可测的目录大小与所在磁盘空间，资源数字使用服务器/服务级口径。

安装

在 DSH 配置档里用 plugin_manager 的 install_bundle 安装本目录。bundle 的 cordis.patch.yml 插入一行 dsh-monitor-v3。

- 要求 DSH >=0.2.1-rc.2 <0.2.3；无第三方运行时依赖。
- bundle 同时声明了 dsh.client；安装后刷新一次 Web 页面让 Client 模块加载。若页面仍未出现，重启一次 dsh-web。
- 卸载/禁用时 Host 侧通过 ctx.effect 释放路由、定时器和目录扫描进程。

当前包的安装标识是 dsh-monitor-v3（-v3 是绕开 Client 模块缓存的后缀），仓库名为 dsh-monitor；界面上显示的「系统监控」来自 locale/meta.title。

数据

- GET /dsh-monitor/state：当前快照（JSON）。
- GET /dsh-monitor/events：SSE，每个采样周期一帧完整快照。
- 数据源：/proc/stat、/proc/meminfo、/proc/net/dev、/proc/self/cgroup、cgroup v2（memory.current/memory.peak/pids.current/cpu.stat）、fs.statfs、node:os；工作区目录大小由 du -sk 后台扫描。
- 非 Linux 平台自动降级：CPU/内存用 node:os，磁盘用 fs.statfs，网络/cgroup 标记不可用；目录大小扫描不可用时图例显示“不可用”。

配置（cordis.patch.yml 的 plugin row config）

| 键 | 默认 | 说明 |
| intervalMs | 2000 | 采样间隔，1000–30000 |
| historyPoints | 90 | 内存趋势点数（约 3 分钟 @2s） |
| workspaceSizeTtlMs | 300000 | 工作区目录大小缓存时长，60000–3600000 |
| path | /dsh-monitor | 路由前缀（客户端目前硬编码同一路径） |
| diskMounts | ['/', '/home'] | 服务器磁盘卡片展示的挂载点 |

开发

node --check index.js
node --check client.js

客户端插件更新需要一次完整页面 boot；重装后关闭标签页重新打开即可。

License

MIT