前言¶
跑 DeepSeek Harness（DSH）时，本机变慢往往要另开终端：htop、Activity Monitor、任务管理器，或 ncdu 查磁盘。对住在浏览器里的工作流来说，这意味着频繁切上下文。dsh-server-resources 在 DSH 右侧栏增加 Resources 页签，用只读方式汇总 CPU、RAM、swap、磁盘占用，以及进程、目录、文件的排行，面向 Linux、macOS、Windows，不额外安装监控服务。下面介绍它的定位、能力、安装方式与使用注意。
这是什么¶
维护者为 brungcm。插件全名 dsh-server-resources，npm 包名与此相同，当前发布版本为 0.3.0（MIT 许可证，零 npm 依赖）。它归类为 DSH 客户端插件：界面在 Web 侧栏展示，数据来自运行 DSH 的那台主机上的系统命令与内核接口。
一句话定位：在 DSH 里回答「是 CPU、内存、swap 还是磁盘」「哪个程序在吃资源」「磁盘被谁占满」，无需 SSH 或系统自带图形监控。
核心功能¶
面板与操作系统能力对齐：某 OS 无法提供的指标会隐藏，而不是填零。三大平台共有的能力包括：
- 仪表盘：CPU、RAM、swap / 页面文件、最满磁盘，绿→琥珀→红指示。
- 历史曲线：近几分钟 CPU、RAM。
- Per-core 条形图：便于发现单核打满而平均值仍偏低的情况。
- 进程排行：CPU、RAM 消耗前列；可按程序聚合（如
claude ×4）或按 PID、用户、命令行列出。 - 磁盘页：各卷、最大目录（可点进下钻）、较大文件（约 20 MB～1 GB）。
- 主题：跟随 DSH 明暗主题。
平台差异（摘自官方功能表）：
| 能力 | Linux | macOS | Windows |
|---|---|---|---|
| 进程 swap 排行 | ✅ | — | ✅（committed memory） |
| I/O wait · steal · page cache | ✅ | 仅 cache | — |
| Pressure (PSI) | ✅ | — | — |
Linux 侧依赖 /proc、df、du、find 等常见工具；macOS 用 sysctl、vm_stat、ps 等；Windows 通过 PowerShell（优先 pwsh 7+）调用 Get-CimInstance。各平台具体命令见仓库内 docs/PLATFORMS.md。
安装与启用¶
依赖 dsh-better-sidebar ≥ 0.30（面板渲染在其侧栏内）以及 Node.js ≥ 20。
任选一种安装方式：
# 从 npm
dsh plugin --profile <your-profile> add dsh-server-resources
# 或从 GitHub
dsh plugin --profile <your-profile> add github:brungcm/dsh-server-resources
安装完成后，打开右侧栏的 + 菜单，选择 Resources 即可出现资源页。
典型用法¶
- 日常在 DSH 中开发或运维时，保持 Resources 页签打开，观察仪表盘与近几分钟历史，判断瓶颈在 CPU 还是内存。
- 切换到 Processes，按 CPU 或 RAM 排序，确认是单个 PID 还是同一程序的多个实例。
- 磁盘告急时进入 Disk，查看各卷占用，点进大目录下钻，对照大文件列表清理（插件本身只读，不会删除或改配置）。
- Linux 上若关心调度 stall，可查看 PSI 相关指标（内核支持时）。
路由经 DSH 连接层提供，仅登录所有者可达；请勿在未鉴权的情况下把 DSH 暴露到公网。
设计与安全边界¶
官方强调的设计原则包括：
- 只读：不杀进程、不删文件、不改设置；无额外网络依赖。
- 对机器温和：磁盘扫描低优先级、串行执行，单次最长约 150 s，带缓存与队列上限；概览采样频率受限；标签页隐藏时停止轮询。
- 路径防护：Linux/macOS 不扫描
/proc、/sys等；Windows 仅接受盘符路径，拒绝 UNC 等；遍历不跟符号链接。
命令行可见性：Processes 会显示命令行，参数里可能含密钥；常见形态会打码，但不保证全部。若需完全隐藏，在 DSH 服务端环境中设置：
export DSR_HIDE_COMMAND_LINES=1
内容与本地 ps、任务管理器等同级敏感，请按最小权限运行 DSH。
限制与适用场景¶
- 数字描述的是 运行 DSH 进程的那台主机；容器 cgroup 限额不在面板内。
- macOS 单进程 CPU 为系统自己的衰减平均，突发可能滞后；无 per-process swap。
- Windows 单次采样约 1～2 s，刷新间隔比 Linux/macOS 更长；杀软可能对重复的
powershell -EncodedCommand告警。
适合：在本机或内网已部署 DSH、希望少切工具就能确认资源占用的开发者与运维。安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认与自身安全策略一致；插件以 DSH 进程权限读取系统信息。
社区目录 skillhub.cn 上的条目 与 GitHub 同源，属于 DSH「一切皆插件」生态中的第三方收录，并非 DeepSeek 或幻方官方应用商店。
小结¶
dsh-server-resources 把本机资源观测收进 DSH 侧栏：Resources 页签、跨 Linux / macOS / Windows、只读且无 npm 运行时依赖。装好 dsh-better-sidebar 与插件后，从侧栏 + 启用即可。进一步细节见 https://github.com/brungcm/dsh-server-resources。
