DeepSeek HarnessHub
提交插件

lsl1931/dsh-resource-bar ↗★ 0

dsh-resource-bar

在左侧边栏常驻显示CPU与内存占用及详情面板 适合需要实时监控本机CPU、内存、系统负载及进程Top5详情的用户。

记忆与知识库界面扩展
包名
dsh-resource-bar
兼容性
待验证
Cordis 依赖范围
^4.0.2
版本
0.1.0
许可证
MIT
最近更新
2026年9月22日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:lsl1931/dsh-resource-bar

说明文档

阅读完整 README ↗

dsh-resource-bar

在 DeepSeek Harness（dsh）Web 版左侧边栏「设置」按钮上方常驻显示本机 CPU 与内存使用率的药丸，点击展开完整详情。

与 dsh-usage-bar 同一座位（sidebar.footer.action）、同一呈现思路：一枚常驻药丸 + 点击弹出面板。

功能

  • 常驻药丸：CPU 37.5% + 内存条 + 内存 62.5%，带迷你占用条，按占用分档着色（ github:lsl1931/dsh-resource-bar 这种简写在本机不可用：pnpm 会把它解析成

git+ssh://，没有 SSH 密钥时会以 Host key verification failed 失败。 上面的 codeload HTTPS URL 可以完全绕开 git。

在本仓库目录开发时，用 link: 让改动即时生效：

cd ~/.dsh/profiles/web
pnpm add "link:/path/to/dsh-resource-bar"

开发提示：用 link: 而非 file:。file: 会做快照拷贝，改完源码后 host 端可能仍加载旧版本。

开发

零构建依赖，仅需 Node.js ≥ 22：

node build.mjs           # 由 src/ 生成 lib/
npm test                 # 全量自检（9 个套件）
npm run test:e2e         # 真实 dsh web 挂载验证（临时 DSH_HOME，不碰你的 profile）
  • src/index.js → lib/index.js（Node half，原样拷贝）
  • src/client/index.js → lib/client.js（包成 window.__ModuleLoader__ 的 factory 形式）

只改 client half 时，浏览器硬刷新即可生效；改 Node half 需要重启 dsh web。

测试

node run-selftests.mjs 依次运行：

套件覆盖
selftest-parse.mjs解析与折叠：真实 /proc 交叉校验、字段偏移、重置/截断/敌意输入
selftest-timers.mjs定时器归属：dispose 后零存活定时器（含惰性进程采样器）
selftest-routes.mjs路由契约：kind:exact、方法校验、信任栅栏、fail-closed、不泄漏密钥
selftest-failure.mjs失败路径：不可读的 procfs 全部降级而非抛异常
selftest-client.mjs客户端渲染：真实 React + happy-dom 驱动真实 bundle，断言交互与可访问性
selftest-contracts.mjs官方条例：清单约束、patch 形状、样式归属、主题 token 白名单、无硬编码颜色
selftest-live.mjs真实采样：对活着的 /proc 连续采样并校验数值区间
selftest-packaging.mjs发布面：npm pack 后 tarball 恰为 6 个文件、无测试/源码泄漏、打包清单无生命周期脚本
selftest-perf.mjs性能边界：单次采样与快照序列化耗时上限

测试只依赖 react / react-dom / happy-dom（devDependencies，不进发布面，files 白名单已排除）。

端到端挂载验证

in-process 自检跑不出启动期的契约违规（读未声明的 ctx.X、清单字段被加载器拒绝）—— 只有真实启动才能。因此 npm run test:e2e 会：

  1. 在 /tmp 下建一个一次性 DSH_HOME（你的真实 profile 全程不被触碰）；
  2. dsh plugin --profile web add 把本插件装进 scratch profile；
  3. 在空闲端口真实启动 dsh web，等待就绪并确认启动日志无加载器报错；
  4. 经鉴权 HTTP 跑 38 项契约检查：信任栅栏（未鉴权 401）、方法校验（POST 405）、实时 CPU/内存载荷、逐核读数、惰性进程采样器及其 18 秒自动停止；
  5. 确认客户端 bundle 确实被打进 boot combo 并在 /plugins 正常下发；
  6. 解析真实 __DSH_BOOT__ 载荷，确认本插件的行存在、未被 rejected、且其指向的资源可 200 下载（11 项检查）。

合计 57 项端到端检查。

脚本按端口持有者识别进程（本平台的 dsh 进程 comm 是 MainThread，用 pgrep node 找不到它 —— 这个坑在开发时真的留下过孤儿进程）。清理只杀自己那个端口的进程，不会波及你 :3080 上的服务。

CI

.github/workflows/ci.yml 在每次 push / PR 上跑：全量自检 + 校验提交的 lib/ 不是陈旧的（git diff --exit-code -- lib/）+ 打包清单门（npm pack 后确认无 cordis 依赖、无生命周期脚本、tarball 内容正确）。

端到端挂载测试不进 CI：它要真实启动 dsh web、依赖可用的 dsh 安装与空闲端口，属于本机发布前的手动门禁（npm run test:e2e）。

发布到 GitHub

仓库尚需创建（本机无任何 GitHub 凭据）。本地仓库已就绪：分支 main、两处提交、origin 指向 https://github.com/lsl1931/dsh-resource-bar.git（不含凭据）。

两种方式二选一：

A. 自己推（不需要交出凭据） —— 在 GitHub 建空公开仓库 dsh-resource-bar（不要勾 README/gitignore），然后：

cd ~/dsh-resource-bar && git push -u origin main

B. 用脚本一键建仓并推送 —— 需要 repo scope 的 PAT：

# token 只进文件，不进命令行历史
read -rsp "PAT: " T && printf '%s' "$T" > ~/.gh-pat && chmod 600 ~/.gh-pat && unset T
bash scripts/publish.sh     # 建仓（已存在则跳过）+ 推送 + 校验远程 ref
rm ~/.gh-pat                # 完成后自行删除

该脚本把 token 经临时 credential helper 传给 git，且 helper 在调用时从文件读取，因此 token 既不会写进 .git/config、日志，也不会出现在任何进程的 argv 里（可用 ps 验证）。

已知边界

  • 仅 Linux：数据源是 procfs。其他平台下药丸仍会渲染，但显示「无读数」，不报错。
  • 每进程 RSS 的页大小按 4096 假定（Linux/amd64 默认）。它只用于进程排行，不影响总量口径（总量来自 /proc/meminfo 的字节值）。
  • 进程排行需要两次采样：新出现的进程首次上报 0%，避免用生命周期均值把长命进程排到真实负载前面。
  • 负载均值是内核的 1/5/15 分钟指数平均，不是瞬时值。

许可

MIT