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

dsh-side-monitor

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

awesome · DSH plugin

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

v0.6.0 — 左侧分区导航、丰富的主机指标与历史趋势

- 主面板左侧分区导航（概览 / 性能 / 进程 / Docker / 硬件与系统）。窄屏（<768px）时导航变为顶部横向条。
- 性能页：服务端保存 10 分钟历史（每 2 秒一个样本，仅内存，不落盘），可切换 1 / 5 / 10 分钟；展示 CPU、内存、交换分区、负载、网络与磁盘 IO 趋势，以及每核 CPU 柱状图。
- 概览新增交换分区、线程 / 可运行任务数、磁盘 IO 速率、内存分布（空闲 / 缓冲 / 缓存 / 可用）。
- 硬件与系统新增 CPU 主频与温度传感器（无法读取时显示“无温度传感器”）。
- Docker 新增守护进程摘要卡片（只读，来自 /info 与 /version）。
- RPC 协议升级为 v4（加性变更）：新增端点 history、dockerInfo；meta.capabilities 新增 swap、perCpu、diskIo、temperature、history、dockerInfo。仍然只读。

v0.5.0 — 系统监控改为主面板页

- 入口移入导航组：位于 插件 / 自动化任务 之后，与上下文洞察使用同一个 sidebar.panellist 席位。原底部脚注入口已移除。
- 监控改为主面板页（main 槽位，key 为 dsh-side-monitor），不再是右侧抽屉。页头、视图切换（概览 / 进程 / Docker）、可滚动内容区与响应式卡片对齐上下文洞察布局；宽度拖拽与抽屉动画已删除。
- 导航行文字使用 thunk（t("monitorTitle")），语言切换时无需重新注册。
- 修复空白页：页面组件曾被写成字符串标签，React 把它当作未知元素渲染。

v0.4.0 — DSH 0.2.0-rc.2 兼容性适配

- 已在 DeepSeek Harness 0.2.0-rc.2 下对齐运行时契约：sidebar.footer.action 插槽（ctx.slots.inject + ctx.slots.register）、浏览器端 ctx.connection.rpc.call 与 Host 端路由挂载注册均与 0.2 运行时一致（/side-monitor 端点已在真实启动进程上端到端驱动：token 交换、会话 cookie、meta / overview 响应）。
- 抽屉改为 shell.overlay 插槽条目，不再向 document.body 追加第二个 React 应用：0.2 的 UI 规范禁止插件自建应用根，而 shell 的整帧浮层天然带来宿主主题、明暗切换与层叠顺序；该浮层默认点击穿透，只有抽屉自身区域（显式恢复 pointer events）接收点击，面板打开时应用其余部分仍可正常操作。
- Host 通道注册采用官方路由挂载模式：随 DSH 发布的 dsh-host-open-in-app 是 0.2 插件挂载浏览器路由的活样例。沿 0.1.x 的走法通过 connection.rpc.handle() 触达路由载体行不通：该外壳经由 owner.webServer 挂载路由，而 cordis 4 会拒绝在它最终绑定的 shadow 上下文上读取该服务（即使插件已声明），导致通道静默未挂载、面板报'transport failure ... HTTP 405'。v0.4.0 改为声明 inject = ['connection', 'webServer']，自注册 POST /side-monitor/<endpoint> 前缀路由，先用 connection.requestRejection 建立信任围栏再放行任何请求，并按 0.2 客户端线路（client-request / server-response 信封）通信。
- 清单修正：dsh.client.inject 与 peerDependencies 移除 @deepseek-ai/dsh-client-runtime（该包止步于 0.1.1-rc.2）。inject 现列出面板所用席位与服务所属的模块——@deepseek-ai/dsh-client-connection、@deepseek-ai/dsh-client-ui-layout（声明 shell.overlay）、@deepseek-ai/dsh-client-ui-renderer（提供 slots 服务）与 @deepseek-ai/dsh-client-ui-sidebar（声明 sidebar.footer.action）；peerDependencies 将 @deepseek-ai/dsh-client-connection 与 @deepseek-ai/dsh-client-ui-renderer 固定到 ^0.2.0-rc.2 版本线，@deepseek-ai/cordis 固定为 ~4.0.4。
- 主题 token 更新：已删除的 --dsw-specific-surface-fill 替换为 --dsw-specific-menu（下拉菜单 / 端口菜单 / 模态框），Toast 改用 --dsw-alias-toast-bg / --dsw-alias-toast-label；抽屉阴影改用 --dsw-elevation-panel。
- 回归测试新增：清单字段、挂载路由上的线路契约（信任围栏、媒体类型、信封校验、rpcId 回显）、shell.overlay 注册，以及「不存在 document.body React 根」的守护断言。

面板目前仍自带 zh-CN / en-US 词典与语言切换（dsh-side-monitor:language），尚未接入 0.2 的 Client locale 服务；后续版本计划迁移到 ctx.locale，以跟随「设置 → 通用」并出现在语言目录中。

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 < 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 Row + Monitor Main-Panel Page + 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。每个请求都先经 connection.requestRejection 围栏——DSH Connection 的 Host/Origin 信任围栏（loopback 与配置的 --trusted-host 授权来源）及其浏览器会话鉴权——之后任何内容才可达。
- 不提供任意命令执行、任意 Docker API 代理或任何控制操作。
- Host Mount Mode 的 /host/proc、/host/sys、/host/root 必须只读挂载。

开发

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

已知限制

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

更新日志

- v0.4.0 DSH 0.2.0-rc.2 兼容性适配：抽屉迁入 shell.overlay 插槽（不再挂载 document.body 应用根）、Host handle(channel, handler) 参数对齐、清单 peer 依赖与 dsh.client.inject 指向 0.2 版本线、主题 token 更新。
- v0.3.x 停止/异常语义拆分、宿主机 netns 探测缓存、Client 版本自动同步、i18n 拼接检查、0.1.1-rc.2 兼容。
- 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