只读系统监控pc439527/dsh-side-monitor

dsh-side-monitor

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

License: MIT awesome · DSH plugin

全程只读：不提供 docker restart/stop、process kill、exec、shell 等任何控制操作，适合随手查资源、排障和观察容器状态。
v0.3.1 — DSH 0.1.1-rc.2 兼容性适配

- 已在 DeepSeek Harness 0.1.1-rc.2 下验证通过：sidebar.footer.action 插槽（ctx.slots.inject + ctx.slots.register）、浏览器端 ctx.connection.rpc.call 与 Host 端 connection.rpc.handle 通道注册均与 0.1.1-rc.2 运行时一致（已实测：/side-monitor 的 overview / processes / containers / meta 均返回实时数据）。
- 移除过时的 @deepseek-ai/dsh-client-ui-slots 引用：该包在 DSH 0.1.1-rc.2 中已不再发布（其插槽运行时已并入 @deepseek-ai/dsh-client-runtime）。已从 dsh.client.inject 与 peerDependencies 中删除，避免全新 dsh plugin 安装时解析到 rc.6 时代的遗留包。

v0.3.0 — 停止/异常语义拆分、性能、能力与漂移检查

- Docker 停止/异常语义拆分：正常停止（退出码 0）的容器现在只算「已停止」，不再计入「异常」；异常只统计真正的问题——不健康、健康检查中、重启中（崩溃循环）、dead、或非零退出。概览与 Docker 页都展示独立的 总数 / 运行 / 已停止 / 异常 徽标与筛选，崩溃容器显示退出码（已崩溃 (137)）。
- 宿主网络探测性能优化：--net=host 探测从 5s 一次降到最多 15s 一次，且不再阻塞概览轮询——缓存未过期直接复用，过期时后台刷新；并加了基线保护，避免容器 netns 回退与宿主 netns 计数器互相差分产生错误速率。
- Client 版本自动同步：lib/client.js 的 CLIENT_VERSION 由 tools/sync-generated.mjs（取代 tools/convert-i18n.mjs）从 package.json 重新生成，同时重新生成内联 i18n 字典并做「禁止字符串拼接」lint；npm run check:gen 可校验无漂移。
- i18n 禁止字符串拼接：所有可见句子都是带占位符的完整消息，客户端不再有 t("a") + t("b") 拼接，生成器内置 lint 强制约束。
- 文案与 Header 打磨：接口表 接收/发送 -> RX/TX；DSH Container -> DSH running in container（DSH on host -> DSH running on host）；Header 下方的状态行不再重复数据来源（此前与徽标的 Host view 重复），视角文案修正为正确空格的 Host view（不再是 Hostview）。
- meta 状态细分 + capabilities：meta 端点新增细粒度状态（运行模式、各数据来源、网络探测、一致性）与宿主能力（Host Mount、Docker Socket、宿主 netns 探测、进程聚合、容器实时统计），在「关于」弹窗新增 状态/能力 区块展示。
- 进程聚合详情：聚合卡片展开后展示命令、去重用户与总 RSS。
- 内存图透明度：内存 Sparkline 填充透明度调高（0.2，CPU 为 0.12）更清晰；Docker 卡片进一步压缩。

v0.2.3 — 完整中英文 & 宿主机网络

- 完整中英文双语 UI（zh-CN / en-US）：默认简体中文（不跟随浏览器），右上角菜单「⋯ → 语言」即时切换，语言持久化在 dsh-side-monitor:language。Header / Tab / 卡片 / 进程 / Docker / Toast / 错误 / Tooltip / 诊断信息全部翻译（字典在 lib/i18n.js，由 tools/sync-generated.mjs 生成进客户端包）。
- Header 改为展示数据来源徽标（宿主数据 / Host Data），副标题带运行环境说明（PC9527-fnOS · DSH 运行于容器）；关于 展示 Browser / Host / RPC / 运行环境 / 系统 / 进程 / Docker 数据来源。
- 宿主模式真实网络：/proc/net 是 netns 作用域，挂载 /host/proc 仍看到容器接口 —— v0.2.3 通过短暂 --net=host 只读探测容器读取真实宿主 netns（带缓存、失败自动回退），并裁剪 veth/br/docker 噪音；磁盘去重改用 st_dev 并展示宿主数据卷（fnOS 的 /vol1）。
- Docker 端口徽标视觉规则：Web = 蓝色 🌐 宿主 → 容器，普通 TCP = 中性灰 📋，Loopback = 黄色 🔒 + 仅宿主机，未发布 = 灰黄 🔒 + 容器内；IPv4+IPv6 双栈合并为单个徽标并带 IPv4 + IPv6 标记。

截图

功能特性

概览（Overview）

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

进程（Processes）

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

Docker（Containers）

- 容器名 / 镜像 / 状态 / health（healthy/unhealthy/starting）/ CPU% / 内存 / 端口。正常停止（退出码 0）显示为「已停止」且不计入异常；崩溃容器显示「已崩溃 (137)」徽标。
- 端口可操作：已发布（有 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 /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 必须只读挂载。

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

已知限制

- 完整宿主 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