系统资源监控 JulioAkaminee/dsh-plugin-system-monitor

为 DeepSeek Harness 监控 CPU、RAM 和订阅额度

本地插件 dsh-plugin-system-monitor，版本 1.3.0。把 CPU 和 RAM 常驻在侧边栏，并把订阅额度加到对话顶部栏。不修改 Harness 内部包，也不额外开服务器。它打包为 Harness 的 bundle，所以任何配置档都能装——包括 DeepSeek Harness Desktop 应用使用的 desktop。

安装

包声明了 dsh.bundle.patch → cordis.patch.yml，这一层按名字引用插件（dsh-plugin-system-monitor），绝不用机器路径。装到你实际要用的配置档里：

- 在 Harness 界面里：侧边栏 → Plugins → Add plugin → 这个文件夹的绝对路径。
- 用命令行，在选定的配置档里：dsh plugin --profile desktop add ~/Desktop/dsh-plugins/system-monitor。

bundle 是组合成员，不是补丁层：加入、移除或更新 bundle，都要重启配置档后才生效。而配置档里 cordis.patch.yml 的改动走热重载。

想不安装直接开发，就把 host half 的绝对路径写进配置档的 cordis.patch.yml——不用 pnpm，立即重载，代价是嵌入一条机器路径：

- insert:
- id: system-monitor
name: /Users/julioakamine/Desktop/dsh-plugins/system-monitor/lib/index.js

侧边栏里的 CPU 和 RAM

- CPU： 所有逻辑核心的平均使用率，用操作系统计数器的两次采样差值算出。
- RAM： 占用百分比，以及已用/总量，单位 GiB。
- 标签页可见时每 3 秒刷新一次。
- 侧边栏收起时显示紧凑版，只带百分比。

这些指标来自运行 Harness 的机器，不只是浏览器、Node 进程或当前会话。CPU 第一次读数需要两次采样，可能要等三秒左右。

在 macOS 上，已用 RAM 遵循活动监视器的「已用内存」：应用匿名页，减去可清除页，加上内核占用和压缩器占用的内存。文件缓存不算在内。如果 vm_stat 读取失败，就退回 os.totalmem() - os.freemem()。鼠标悬停在面板上时，提示里也会显示这个算法。GiB 按 1024³ 字节换算。

顶部栏里的订阅

在对话标题右侧、现有控件之前，每个已连接账号都有一个按钮，只显示服务商 logo 和已用百分比。同一服务商的多个账号各有独立按钮：悬停和展开详情时显示身份。

点击后，面板显示：

- 服务商、账号和套餐（如果有）；
- 用量条和百分比；
- 选中的窗口：5h，没有 5h 就显示每周；
- 距离重置的时间，以及服务商给出的日期/时间；
- 数据过旧或额度不可用时，给出提示。
点击外部、按 Esc，或用关闭按钮，都能收起面板。按钮和面板也支持键盘操作。空间狭窄时，logo 列表可以横向滚动，不会撑开顶部栏。

Harness 的对话头部在完全空的会话里会隐藏；各项指示器跟这个头部一起出现。CPU 和 RAM 始终在侧边栏可用。

选择与刷新规则

这个集成复用已安装的 dsh-plugin-subscriptions 0.9.2：通过 Harness 的连接调用需要认证的端点 subscriptions-auth.status 和 subscriptions-auth.usage。不需要重新登录，不直接读取 token，也不复制各服务商的适配器。

1. 使用归一化窗口 kind: session（5h），与它在响应中的顺序无关。
2. 如果不存在这样的窗口，就把 kind: other 当作 5h 区间。Antigravity 就是这种情况，它的轮换配额按模型划分：Subscriptions 插件自己的徽章也把这个区间当作服务商的通用窗口。
3. 如果也没有，就用 kind: weekly。
4. 优先使用账号的全局窗口。如果只有按模型划分的限制，就显示消耗最多的那个，并在详情里标明对应模型；不把相互独立的配额相加，也不求平均。
5. 如果没有任何兼容的窗口，logo 显示 —，点击后会说明不可用的原因。

配额每 30 秒查询一次，复用 Subscriptions 的缓存和防请求过载保护。这不会强制向服务商发起新调用：已安装的版本使用约 5 分钟的缓存，遇到故障或等待期时可能一直保留上一次的读数。所以界面在多次查询之间可能重复同一个百分比——这个数据不像 CPU/RAM 那样每 30 秒变化，后者的采样在本地完成。

一个采集器服务页面上所有头部，包括并排的对话。没有挂载头部、标签页隐藏或浏览器离线时，查询会停止。

在本机安装

插件注册在 /Users/julioakamine/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: system-monitor
name: /Users/julioakamine/Desktop/dsh-plugins/system-monitor/lib/index.js

刷新已在 http://127.0.0.1:3080 打开的页面，加载更新后的界面。lib/ 里的文件已经是可直接用于 Harness 的产物；没有编译步骤，也不需要安装额外的 npm 依赖。

尚未在浏览器里验证更新。如果进程仍保留旧的 bundle，方便时重启同一个 Harness 实例；不要在同一端口再启动一个实例。

注册项指向这个文件夹：如果你移动或删除插件，也要更新或删除配置档里的条目。订阅插件必须保持安装并启用，才能提供配额；它缺失不影响 CPU 和 RAM 的读取。

文件

- package.json：元数据和 Web 插件声明。
- lib/index.js：采集 CPU/RAM，以及受保护的路由 GET /api/system-monitor。
- lib/client.js：侧边栏、页头指示器和详情面板；React 与 Harness 共享。
- THIRD-PARTY-NOTICES.md：LobeHub Icons 矢量图标的许可证与来源，已本地内嵌，使用期间不调用 CDN。

使用 Node.js 22+，以及 Harness 0.1.5 本地安装中提供的插件契约。

安全与生命周期

- 路由复用 Harness 的认证和 Host/Origin 校验。
- 本插件不访问凭据，也不直接查询服务商：由现有的 Subscriptions 负责查询并维护自己的缓存。
- 不向外部服务请求图片；图标是 bundle 内的本地 SVG。
- 后端每 3 s 采样一次 CPU/RAM，所有标签页共享；配额每 30 s 读取一次。
- 查询不会重叠；移除插件时，定时器、请求、样式和注册项都会被清理。
- 展示不会向屏幕阅读器播报每一次数值更新，并遵循减少动态效果的偏好设置。

移除

以 bundle 方式安装：在 Plugins 页面关闭，或运行 dsh plugin --profile <perfil> remove dsh-plugin-system-monitor，然后重启配置档。

以补丁方式插入（未安装）：从配置档补丁中删除 system-monitor 条目，然后刷新页面。如果它是唯一条目，把补丁内容恢复为 []（注释可以保留）。原有的 Subscriptions 插件不会因这次集成而改变。

验证

在隔离 DSH_HOME 的 desktop 配置档中验证了打包：dsh plugin add 启用了该包，并把 dsh-plugin-system-monitor 加入 dsh.profile.bundles 列表，dsh --dump-config 显示了 # == dsh-plugin-system-monitor 层，其中 system-monitor row 已解析。

打包后没有在浏览器中重新测试插件行为（读取、侧边栏、页头、配额面板）：唯一会改变行为的文件是 lib/，而本次修订没有改动它。