dsh-system-vitals

dsh-system-vitals

DeepSeek Harness 的「负载条」插件 —— 在输入框卡片的工具行里常驻一条实时读数： CPU 占用 · CPU 温度 · 内存 · 磁盘 · 上传/下载速率。三平台、每秒采样、零运行时依赖。

不用打开任务管理器、不用切窗口，也不用往下翻对话——读数就在你打字的地方。

特性

• 一条极简状态行：CPU · 温度 · 内存 · 磁盘 · 上传 · 下载，常驻在发送按钮左侧。
• 零依赖：Linux 直接读内核计数器（/proc、/sys）；macOS 用系统自带 sysctl/netstat； Windows 用常驻 PowerShell 读性能计数器。不装原生模块、不需要管理员权限。
• 等宽格子、绝不跳动：每个读数是 标签 4ch + 数字 3ch + 单位 3ch 的定宽格子， 数值从 9% 变 10% 时整条不会左右晃。
• 数字最多 3 位有效数字：放不下就换单位（网速 B/s → K/s → M/s → G/s），绝不撑宽格子。
• 阈值变色：CPU/内存 75% 起警示色、90% 起错误色；磁盘 85% / 95%；温度 80°C / 92°C。
• 空间不够时整格裁切：优先保留靠左的读数，裁切点永远落在两格之间，不显示半个数字。
• 跟随主题与语言：只使用 --dsw-alias-* 主题 token，中英文自动切换。

安装

要求：DSH 0.2.1-rc.2 左右版本、Node ≥ 20、dsh web 带界面的 profile。

dsh plugin --profile web add github:abyss2021/dsh-system-vitals

装好后刷新页面。卸载：

dsh plugin --profile web remove dsh-system-vitals

• 版本发布记录见 GitHub Releases。
• 开发调试可以从本地目录装：dsh plugin --profile web add /path/to/dsh-system-vitals。
• 若将来发布到 npm，可用 dsh plugin --profile web add dsh-system-vitals。不要和上面那条写进同一个代码块： 插件商店的安装命令探测器遇到两个候选会判 ambiguous，反而一条都不显示。

本插件是 bundle + Client half 的组合：Host 半侧负责采样并暴露一条同源 HTTP 路由， Client 半侧向 conversation.input.right（输入框卡片 .trailing 组，与发送按钮同行）和 settings.section 各注册一个 React 组件。没有构建步骤，client.js 是可直接加载的浏览器模块。

显示内容

Host 每秒采样一次，Client 每 2 秒轮询 GET /system-vitals/api/snapshot。读不到的字段一律返回 null， 界面显示 —，不会编造数值。

各平台实现要点

• Linux：纯文件读取，零子进程。
• macOS：sysctl/netstat 短命令 + Node API；温度采样较贵，每 5 个采样点刷新一次并缓存。
• Windows：常驻 PowerShell 子进程，每秒输出一行 JSON（性能计数器本身已是百分比与每秒字节，无需差分）； 子进程退出后按 5 秒退避重启，期间沿用上一次采样。
• 其他平台回退到 Node os 的最小读数（内存、负载、运行时长），CPU 占用与网速显示 —。

用法

拖动排序

每个读数都是独立可选中的格子：

• 拖动：按住任一读数拖到新位置，拖动过程中实时换位，松手即生效；
• 键盘：Tab 聚焦后用 ← / → 移动（Enter / Space 选中）；
• 持久化：顺序存在 localStorage（dsh-system-vitals:order），刷新与重启后保留。

格子等宽、拖动时不留占位符，所以换序不改变整条细条的宽度与位置——变的只是哪个读数占哪个槽位。

显示哪些读数

设置 → 负载条 里逐项开关：

• 每项一个开关，取消勾选即隐藏，下方实时预览当前效果；
• 全部显示 一键恢复；顺序 区域可 恢复默认顺序；
• 偏好存在 localStorage（dsh-system-vitals:visible / :order）。

显隐只由你决定，窗口宽度不会改变显示内容与顺序。窄窗口下若嫌挤，就在设置里关掉不关心的项。

布局：宽度与换行

细条挂在 conversation.input.right，位于 .trailing 组内、与发送按钮同一 flex 组。 宿主那行是 flex-wrap: wrap，并且用 observeControlRow 量自身宽度决定模型选择器是否紧凑—— 细条的宽度被算进这一行，而 .trailing 是 flex: none，所以细条必须让路，否则整行会被挤到换行， 把「完全权限」和发送按钮推走。因此细条按行内剩余宽度封顶，超出的部分在自己内部整格裁切： 它永远是让步的那一方，原生按钮位置不变。

上限是运行时实测的，不是固定魔法数：ResizeObserver 监听那一行，取行的内容宽度 （与宿主判定"放得下吗"用的是同一个盒子），减去不在细条自己祖先链上的所有控件宽度、它们之间的间距， 再留 8px 安全余量。模型选择器按紧凑宽度计入——空间不足时宿主会自动把它收成图标； 若按展开宽度算，细条会被压到几乎没有，宿主又因此永远不会进入紧凑模式。

关键在于上限在绘制之前就生效：它由 ResizeObserver 回调直接写到元素样式上，而不是绕一圈 setState。 React 的状态更新要到下一个任务才提交，那时这一帧已经画完——过去每缩小一档，就会有一帧把细条按旧宽度画出来， 溢出把这一行里可压缩的原生控件挤扁或顶到第二行，下一帧再弹回，看起来就是左侧控件"快速跳动然后归位"。 现在修正属于同一个渲染更新，任何一帧都不会画出超宽的细条（回归测试见 CHANGELOG 里 1.3.11 / 1.3.13 的验证数据）。

典型行为（行宽 → 可见读数，随字体与宿主版本略有浮动）：396px→1 项；500px→2 项；620px→4 项； 900px 及以上→6 项。细条永远单行，放不下时从右缘裁切并优先保留靠左的读数 （也就是你自定义顺序里靠前的那些）。

配置

在 profile 的 patch 层覆盖行 config：

- insert:
    - id: system-vitals
      name: dsh-system-vitals
      config:
        intervalMs: 1000   # Host 采样间隔，250–10000 ms；网速按该间隔的字节差计算

兼容性

• 平台：Linux 完整支持；macOS、Windows 支持 CPU/内存/磁盘/网速，温度视机型与权限可能不可用。
• DSH：在 0.2.1-rc.2 上开发并验证；只使用稳定的 webServer.register、 ctx.slots.register/inject、ctx.locale.register 接口。
• Node：≥ 20（fs.statfs）。

安全说明

Host 半侧注册的 GET /system-vitals/api/snapshot 是本机未鉴权路由，只绑在 DSH Web 的监听地址上 （默认 127.0.0.1）。同机的其他进程本来就能读 /proc，因此不构成额外暴露；但不要把 DSH Web 直接暴露 到公网（--host 0.0.0.0）后再开着这个插件，否则这些读数会随页面一起对外可见。

项目结构

dsh-system-vitals/
├── package.json          # 包清单：dsh.bundle / dsh.client / exports
├── cordis.patch.yml      # 插入插件行
├── index.js              # Host 半侧：采样 + HTTP 路由
├── client.js             # Client 半侧：工具行里的细条 + 设置页
├── platform/             # linux / darwin / win32 采样实现
├── locale/{zh,en}.json   # 插件市场展示用元数据
├── docs/preview.png      # 截图
├── icon.svg              # 插件图标
└── CHANGELOG.md / README.md / README.en.md / LICENSE

开发与发布

node --check index.js                    # 语法检查
node --check client.js
for file in platform/*.js; do node --check "$file"; done
npm pack --dry-run                       # 看将发布的文件列表

改完在本地装一份即可生效：

dsh plugin --profile web remove dsh-system-vitals
dsh plugin --profile web add /home/abyss/app/system-vitals

发布流程：改 package.json 版本 → 更新 CHANGELOG.md → 提交并打 vX.Y.Z tag → 在 GitHub 上基于该 tag 建 Release。.github/workflows/publish.yml 会在 Release 发布时校验 tag 与 package.json 一致，并在仓库配置了 NPM_TOKEN secret 时执行 npm publish --provenance； 没有配就跳过并留一条 notice（当前只发 GitHub Releases，npm 未发布）。

许可

MIT