dsh-plugin-sysops

DSH（deepseek HARNESS）的本机系统运维插件：在左侧栏增加一个入口，打开一整页本机面板 —— 实时监控 + 两段式 C 盘清理 + 全盘文件搜索 + 监控记录 + 设置。

面向 Windows 桌面机器，自用工具的口吻写的：能做什么、做不到什么、以及删除这类不可逆动作是怎么被闸住的，都写在明面上。

它是什么

实时监控：CPU 使用率 / 内存占用 / 网络吞吐 / C 盘可用空间四条曲线（30 分钟环形缓冲），采集源状态条常显；进程榜只读，按 CPU 降序、可点 CPU / 内存切排序
阈值告警：规则可配（连续 N 次才报、冷却去重），触发后落进「监控记录」页签 + 侧边栏蓝点，不推系统通知（宿主不提供该能力，见下）
两段式 C 盘清理：扫描 → 冻结清单快照 → 逐项勾选 → 执行。执行前你看到的对象列表就是动手时删的对象列表；分类按「建议清理 / 建议先看一眼 / 建议保留」给，默认只勾第一档
AI 智能清理（lib/clean/ai-advisor.js）：把清单交给宿主模型做分类建议，全程零 apply —— 它只推荐，删不删由你在同一页逐项确认
全盘文件搜索：三级探测选通路（Everything HTTP / es.exe / 限定目录遍历），每条结果显示来源 pill；探不到就降级并说明缺哪一级，不静默失效
留痕：每次执行的清单快照、执行方式、前后容量差、成功 / 跳过 / 失败三档计数都落库，不是「大概清了多少」

它不是什么（红线，收口在 lib/clean/guard.js 单点，任何模块不得自行放宽）

不结束、不杀任何进程（进程榜只读）
不碰系统目录：C:\Windows\*、Program Files*、C:\$Recycle.Bin* 命中即拒
不改属主、不改 ACL、不写注册表（探测只读）
不做开机自启常驻（宿主不提供该能力，UI 上也不留假开关）
探测段绝不夹带安装：搜索通路三级探测（lib/search/probe.js）全程只读（existsSync / GET / 查询）
同时拒绕过形态：\\?\ 前缀、UNC、8.3 短文件名、.. 与 junction 逃逸、大小写与全角变体、未展开的 %VAR%、省略盘符。新增规则在写入阶段就被拒，而不是执行阶段才失败。

唯一一处写入系统的动作：搜索自检卡上的「Everything 一键安装」（lib/search/installer.js）。它是显式点击的独立动作，不藏在任何只读流程里，四道闸顺序不能反：

参数永不采信前端 —— start() 不收任何来自请求体的字段；包 id（voidtools.Everything）、源、参数表全是本文件常量。
非 shell —— 只经注入的 execFile 门面跑，命令行不是拼出来的字符串。
先探再起 —— 探不到 winget 就直接拒，界面上「按钮亮不起来」与「点了被拒」是同一句原因。
一次只跑一装 —— 运行期间的第二次点击拒成 SEARCH_INSTALL_BUSY。

UAC 提权窗口由 winget 自己弹，插件不代点同意，也不冒充管理员。不需要它的话，自己 winget install voidtools.Everything 或去官网装，插件只用不碰。

安装

方式 A：官方 CLI

dsh plugin --profile web add github:gh-gongjin/dsh-plugin-sysops

CLI 内部走 pnpm，需要 pnpm 在 PATH 里。也可以装本地目录：dsh plugin --profile web add <本仓库的绝对路径>。

方式 B：手工两步（不需要 pnpm）

编辑 profile 的 package.json（默认 ~/.dsh/profiles/web/package.json，Windows 为 %USERPROFILE%\.dsh\profiles\web\package.json）：
- dependencies 增加："dsh-plugin-sysops": "link:<本仓库的绝对路径>"
- dsh.profile.bundles 数组末尾追加 "dsh-plugin-sysops"

在 profile 的 node_modules 下建一个指向本仓库的目录联接：

New-Item -ItemType Junction `
  -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-plugin-sysops" `
  -Target "<本仓库的绝对路径>"

重启 dsh（宿主半边在启动时加载，只刷新页面不够）。

停用 / 卸载

临时停用：在 ~/.dsh/profiles/web/cordis.patch.yml 里加

- id: sysops
  disabled: true

彻底卸载：删掉方式 B 的两处改动 + 那个目录联接，重启即可。

界面

五个页签，同一个时刻只渲染一个面板：

页签	答哪一问
监控	现在这台机器在忙什么（四曲线 + 采集源条 + 进程榜）
监控记录	哪些规则在什么时候真的触发过（时间线 + 未读蓝点）
清理	到底扫了哪些目录、扫出了什么、要删哪些
搜索	这个文件在哪，以及这个答案是哪条通路给的
设置	四个采集源开关、阈值、清理规则、搜索通路、宿主能力表

版式约定：错误与状态一律就地落在触发它的那张卡（行内 notice），零顶部浮层 toast；无原生 confirm / alert；断点 1080 / 860 / 620。

采集是怎么分层的

各源代价差两个数量级，所以不是一个节奏包打天下（数字为 2026-09-28 本机实测，复跑命令 node scripts/probe-collect.mjs）：

层	采什么	手段	代价
L0	CPU / 内存 / 磁盘容量	纯 Node（`os.cpus` / `os.totalmem` / `fs.statfsSync`），不起子进程	`os.cpus()` ×100 = 61ms，1s 采样无感
L1a	网络吞吐	常驻 `typeperf`，定窗续采（每窗 `-sc 30 -si 1`）	暖身 ≈402ms/窗，摊到 30 样本窗 1.3%
L1b	进程榜	常驻 PowerShell（`Get-CimInstance Win32_Process`）	冷启动单轮 1475ms ⇒ 默认关，页面可见才采
L2	清理扫描	请求驱动的 Node 遍历	`%LOCALAPPDATA%\Temp` 85,122 条目 / 4,532ms ⇒ 必须带进度与可停止

子进程由 lib/collect/supervisor.js 统一监督：退避 1s/2s/4s/8s/30s、5 次封顶后进 exited-max 并标红 + 附最后一段 stderr；超过 3× 采样间隔无输出判 stalled（挂着不输出比崩更难发现）；Windows 下 child.kill() 对 shell:true 不可靠，改用 taskkill /PID <pid> /T /F，PID 只取 spawn 返回值，绝不接受外部输入拼进命令行。

数据与隐私

配置与留痕存在宿主的 KV 存储里（domain sysops：prefs / clean_rules / alert_hit / clean-plan / clean-log），不落本仓库目录，不上传任何第三方。
HTTP 面只挂在前缀 /sysops 下，写端点全 POST，非回环请求一律 403。
告警与曲线在内存环形缓冲 + KV 留痕；「系统通知 / 后台常驻」宿主不提供，能力表里如实标，UI 上不留开关。
采集异常分四类各写各的文案：未开启 / 进程已退出 / 权限不足 / 数据异常（NaN、负值、>100%）。第四类的脏点丢弃不写入缓冲并单独计数 —— 一个假点会在曲线上被读成真实尖峰。

做不到就写出来（诚实降级）

宿主能力启动时探测一次并缓存，结果在设置页能力表可见：

缺什么	表现
`storageDomain`	配置转只读，写接口返回 501，保存按钮置灰并注明原因
`webServer`	不注册侧边栏入口（点开空白页比看不到入口更糟）
`timer`	退回 `setInterval`，但必须显式 `stop()`，能力表如实标这行降级
系统通知 / 开机自启	能力表标「宿主不提供」，UI 上不留开关

清理执行的错误口径同样不糊：EBUSY / EPERM / ENOTEMPTY → 该项 skipped 并写原因、不重试；快照 re-stat 不过 → rejected-snapshot 提示重扫；暂存目录跨卷 move 报 EXDEV → 回退 copy + delete 且先写成功再删源，失败保留原件并报因。禁止 catch {}：每个 catch 必须产生一个可见状态变化或一条时间线记录。

测试

零依赖：node:assert/strict + 自研 check(name, fn)，node test/<x>.test.mjs 直跑，无测试框架、无 npm script。真机项由 SKIP_LOCAL=1 跳过。

# 全套（含会真建目录树、真删的机器相关用例）
for f in test/*.test.mjs; do node "$f"; done

# 跳过机器相关用例（在别的机器 / CI 上跑）
SKIP_LOCAL=1 node test/clean.test.mjs

# 宿主兼容性验证（可选，指向一个 dsh 安装；没设会明确打 SKIP，不假装验证过）
DSH_MODULES="D:\Deepseek harness\node_modules" node test/host-compat.test.mjs

当前读数（2026-10-02 本机 SKIP_LOCAL=1，9 个文件共 489 过 / 0 挂）：alerts 34 · clean 81 · client 191 · collect 53 · guard 19 · host-compat 25 · plugin 44 · prefs 29 · search 46。

文件	覆盖
`guard.test.mjs`	红线矩阵 19 项，按 `BRANCH_IDS` 分支清单逐条打勾（系统目录 / 回收站 / `\\?\` / UNC / 8.3 短名 / `..` 与 junction 逃逸 / 全角 / 未展开 `%VAR%` / 省略盘符 / 通配越界）：用例若写了清单里不存在的分支 id 会直接失败
`collect.test.mjs`	ring 边界；typeperf 输出 fixture（表头、多实例、中文计数器、半行断流）；进程榜 JSON；supervisor 假 child 驱动退避与 stall 判定
`alerts.test.mjs`	阈值穿越、连续 N 次、冷却窗口、依赖关闭后不评估
`clean.test.mjs`	在 `%TEMP%` 真建目录树真遍历比对与真删；伪造 itemId / 伪造路径必须被拒；EXDEV 回退打桩
`search.test.mjs`	probe 三级 8 种组合 → 通路选择；Everything HTTP 响应 fixture（403 / 超时 / 畸形 JSON）；两条通路结果归一化一致
`prefs.test.mjs`	五条记录的 schema 与读写语义；未声明字段丢弃；命中红线的规则在写入阶段被拒
`plugin.test.mjs` / `client.test.mjs`	加载级：宿主半边 inject / 路由表 / 回环闸门 / 源码零 `@deepseek-ai` import；浏览器半边页签骨架、零浮层、四页渲染与端到端接线证人
`host-compat.test.mjs`	缺 `storageDomain` / `webServer` / `timer` 三种组合下加载不抛、状态如实报

guard.js 是唯一要求分支全覆盖的模块 —— 它是这台机器上不可逆动作的单点。本仓库不产覆盖率百分比（引工具即破坏零依赖），改为维护一份分支清单、每条红线一个用例 ID。

目录结构

.
├── package.json            插件清单（dsh.bundle.patch / dsh.client），零第三方依赖
├── cordis.yml              bundle patch：把插件插进 profile 的插件树
├── index.js                宿主半边：能力探测、依赖装配、建服务、注路由
├── client.js               浏览器半边：侧边栏入口 + 主面板（React，零构建，CSS 以字符串注入）
├── lib/
│   ├── kv-schema.js          自造记录校验器（宿主只调 parse/safeParse，零 instanceof 检查）
│   ├── kv-records-base.js    domain 建域 / 写链 / 关停 / 容量的公共基座
│   ├── caps.js               宿主能力探测，结果缓存并对外可查
│   ├── api.js                前缀内路由表 + SSE hub + 回环闸门
│   ├── disk.js               容量与字节的单点折算（清单分组、进度、留痕共用同一口径）
│   ├── collect/              ring / l0-node / l1a-typeperf / l1b-powershell / supervisor / service
│   ├── alerts/               rules（纯函数判定）/ store（alert_hit）/ service（评估编排 + 未读计数）
│   ├── clean/                guard（红线单点）/ rules（内置库）/ scanner / ai-advisor（只推荐不执行）/
│   │                         plan-store（冻结清单）/ executor（两段式执行）/ log-store（留痕）/ quarantine（暂存）/ service
│   ├── records/              spec.js —— alert_hit / clean-plan / clean-log 三张记录表的声明处
│   ├── search/               probe（三级探测，全程只读）/ everything-http / es-exe / walk / installer（一键安装四道闸）/ service
│   └── prefs/                spec + store（采集档位、源开关、阈值、限定目录）/ rules-store（本机清理规则）
├── docs/
│   ├── design-spec.md          设计说明：决策表、实测代价、数据流、错误处理、测试与验收门禁
│   └── implementation-plan.md  25 个 Task 的实现计划（含逐条契约）
├── scripts/probe-collect.mjs   实测代价探针（只报事实，恒 exit 0）
├── prototype/index.html        可点原型（与 client.js 同口径，改设计先改它）
└── test/                       见上

kv-schema.js 与 dsh-plugin-stock-analysis / dsh-plugin-modelwatch 的同名文件是同源拷贝：宿主以 link: 挂载时 import 官方包会解析出第二份模块实例，所以三份实现必须保持同源，改一处要三处对齐。

许可

MIT。见 LICENSE。

本插件只做本机读写与显式确认的删除，不提供任何提权、不提供结束进程的能力，也不替你决定删什么。用完请自行核对留痕。

dsh-plugin-sysops

面向 Windows 桌面机器，自用工具的口吻写的：能做什么、做不到什么、以及删除这类不可逆动作是怎么被闸住的，都写在明面上。

它是什么

实时监控：CPU 使用率 / 内存占用 / 网络吞吐 / C 盘可用空间四条曲线（30 分钟环形缓冲），采集源状态条常显；进程榜只读，按 CPU 降序、可点 CPU / 内存切排序
阈值告警：规则可配（连续 N 次才报、冷却去重），触发后落进「监控记录」页签 + 侧边栏蓝点，不推系统通知（宿主不提供该能力，见下）
两段式 C 盘清理：扫描 → 冻结清单快照 → 逐项勾选 → 执行。执行前你看到的对象列表就是动手时删的对象列表；分类按「建议清理 / 建议先看一眼 / 建议保留」给，默认只勾第一档
AI 智能清理（lib/clean/ai-advisor.js）：把清单交给宿主模型做分类建议，全程零 apply —— 它只推荐，删不删由你在同一页逐项确认
全盘文件搜索：三级探测选通路（Everything HTTP / es.exe / 限定目录遍历），每条结果显示来源 pill；探不到就降级并说明缺哪一级，不静默失效
留痕：每次执行的清单快照、执行方式、前后容量差、成功 / 跳过 / 失败三档计数都落库，不是「大概清了多少」

它不是什么（红线，收口在 lib/clean/guard.js 单点，任何模块不得自行放宽）

不结束、不杀任何进程（进程榜只读）
不碰系统目录：C:\Windows\*、Program Files*、C:\$Recycle.Bin* 命中即拒
不改属主、不改 ACL、不写注册表（探测只读）
不做开机自启常驻（宿主不提供该能力，UI 上也不留假开关）
探测段绝不夹带安装：搜索通路三级探测（lib/search/probe.js）全程只读（existsSync / GET / 查询）
同时拒绕过形态：\\?\ 前缀、UNC、8.3 短文件名、.. 与 junction 逃逸、大小写与全角变体、未展开的 %VAR%、省略盘符。新增规则在写入阶段就被拒，而不是执行阶段才失败。

参数永不采信前端 —— start() 不收任何来自请求体的字段；包 id（voidtools.Everything）、源、参数表全是本文件常量。
非 shell —— 只经注入的 execFile 门面跑，命令行不是拼出来的字符串。
先探再起 —— 探不到 winget 就直接拒，界面上「按钮亮不起来」与「点了被拒」是同一句原因。
一次只跑一装 —— 运行期间的第二次点击拒成 SEARCH_INSTALL_BUSY。

UAC 提权窗口由 winget 自己弹，插件不代点同意，也不冒充管理员。不需要它的话，自己 winget install voidtools.Everything 或去官网装，插件只用不碰。

安装

方式 A：官方 CLI

dsh plugin --profile web add github:gh-gongjin/dsh-plugin-sysops

CLI 内部走 pnpm，需要 pnpm 在 PATH 里。也可以装本地目录：dsh plugin --profile web add <本仓库的绝对路径>。

方式 B：手工两步（不需要 pnpm）

编辑 profile 的 package.json（默认 ~/.dsh/profiles/web/package.json，Windows 为 %USERPROFILE%\.dsh\profiles\web\package.json）：
- dependencies 增加："dsh-plugin-sysops": "link:<本仓库的绝对路径>"
- dsh.profile.bundles 数组末尾追加 "dsh-plugin-sysops"

在 profile 的 node_modules 下建一个指向本仓库的目录联接：

New-Item -ItemType Junction `
  -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-plugin-sysops" `
  -Target "<本仓库的绝对路径>"

重启 dsh（宿主半边在启动时加载，只刷新页面不够）。

停用 / 卸载

临时停用：在 ~/.dsh/profiles/web/cordis.patch.yml 里加

- id: sysops
  disabled: true

彻底卸载：删掉方式 B 的两处改动 + 那个目录联接，重启即可。

界面

五个页签，同一个时刻只渲染一个面板：

页签	答哪一问
监控	现在这台机器在忙什么（四曲线 + 采集源条 + 进程榜）
监控记录	哪些规则在什么时候真的触发过（时间线 + 未读蓝点）
清理	到底扫了哪些目录、扫出了什么、要删哪些
搜索	这个文件在哪，以及这个答案是哪条通路给的
设置	四个采集源开关、阈值、清理规则、搜索通路、宿主能力表

版式约定：错误与状态一律就地落在触发它的那张卡（行内 notice），零顶部浮层 toast；无原生 confirm / alert；断点 1080 / 860 / 620。

采集是怎么分层的

各源代价差两个数量级，所以不是一个节奏包打天下（数字为 2026-09-28 本机实测，复跑命令 node scripts/probe-collect.mjs）：

层	采什么	手段	代价
L0	CPU / 内存 / 磁盘容量	纯 Node（`os.cpus` / `os.totalmem` / `fs.statfsSync`），不起子进程	`os.cpus()` ×100 = 61ms，1s 采样无感
L1a	网络吞吐	常驻 `typeperf`，定窗续采（每窗 `-sc 30 -si 1`）	暖身 ≈402ms/窗，摊到 30 样本窗 1.3%
L1b	进程榜	常驻 PowerShell（`Get-CimInstance Win32_Process`）	冷启动单轮 1475ms ⇒ 默认关，页面可见才采
L2	清理扫描	请求驱动的 Node 遍历	`%LOCALAPPDATA%\Temp` 85,122 条目 / 4,532ms ⇒ 必须带进度与可停止

数据与隐私

配置与留痕存在宿主的 KV 存储里（domain sysops：prefs / clean_rules / alert_hit / clean-plan / clean-log），不落本仓库目录，不上传任何第三方。
HTTP 面只挂在前缀 /sysops 下，写端点全 POST，非回环请求一律 403。
告警与曲线在内存环形缓冲 + KV 留痕；「系统通知 / 后台常驻」宿主不提供，能力表里如实标，UI 上不留开关。
采集异常分四类各写各的文案：未开启 / 进程已退出 / 权限不足 / 数据异常（NaN、负值、>100%）。第四类的脏点丢弃不写入缓冲并单独计数 —— 一个假点会在曲线上被读成真实尖峰。

做不到就写出来（诚实降级）

宿主能力启动时探测一次并缓存，结果在设置页能力表可见：

缺什么	表现
`storageDomain`	配置转只读，写接口返回 501，保存按钮置灰并注明原因
`webServer`	不注册侧边栏入口（点开空白页比看不到入口更糟）
`timer`	退回 `setInterval`，但必须显式 `stop()`，能力表如实标这行降级
系统通知 / 开机自启	能力表标「宿主不提供」，UI 上不留开关

测试

零依赖：node:assert/strict + 自研 check(name, fn)，node test/<x>.test.mjs 直跑，无测试框架、无 npm script。真机项由 SKIP_LOCAL=1 跳过。

# 全套（含会真建目录树、真删的机器相关用例）
for f in test/*.test.mjs; do node "$f"; done

# 跳过机器相关用例（在别的机器 / CI 上跑）
SKIP_LOCAL=1 node test/clean.test.mjs

# 宿主兼容性验证（可选，指向一个 dsh 安装；没设会明确打 SKIP，不假装验证过）
DSH_MODULES="D:\Deepseek harness\node_modules" node test/host-compat.test.mjs

文件	覆盖
`guard.test.mjs`	红线矩阵 19 项，按 `BRANCH_IDS` 分支清单逐条打勾（系统目录 / 回收站 / `\\?\` / UNC / 8.3 短名 / `..` 与 junction 逃逸 / 全角 / 未展开 `%VAR%` / 省略盘符 / 通配越界）：用例若写了清单里不存在的分支 id 会直接失败
`collect.test.mjs`	ring 边界；typeperf 输出 fixture（表头、多实例、中文计数器、半行断流）；进程榜 JSON；supervisor 假 child 驱动退避与 stall 判定
`alerts.test.mjs`	阈值穿越、连续 N 次、冷却窗口、依赖关闭后不评估
`clean.test.mjs`	在 `%TEMP%` 真建目录树真遍历比对与真删；伪造 itemId / 伪造路径必须被拒；EXDEV 回退打桩
`search.test.mjs`	probe 三级 8 种组合 → 通路选择；Everything HTTP 响应 fixture（403 / 超时 / 畸形 JSON）；两条通路结果归一化一致
`prefs.test.mjs`	五条记录的 schema 与读写语义；未声明字段丢弃；命中红线的规则在写入阶段被拒
`plugin.test.mjs` / `client.test.mjs`	加载级：宿主半边 inject / 路由表 / 回环闸门 / 源码零 `@deepseek-ai` import；浏览器半边页签骨架、零浮层、四页渲染与端到端接线证人
`host-compat.test.mjs`	缺 `storageDomain` / `webServer` / `timer` 三种组合下加载不抛、状态如实报

目录结构

.
├── package.json            插件清单（dsh.bundle.patch / dsh.client），零第三方依赖
├── cordis.yml              bundle patch：把插件插进 profile 的插件树
├── index.js                宿主半边：能力探测、依赖装配、建服务、注路由
├── client.js               浏览器半边：侧边栏入口 + 主面板（React，零构建，CSS 以字符串注入）
├── lib/
│   ├── kv-schema.js          自造记录校验器（宿主只调 parse/safeParse，零 instanceof 检查）
│   ├── kv-records-base.js    domain 建域 / 写链 / 关停 / 容量的公共基座
│   ├── caps.js               宿主能力探测，结果缓存并对外可查
│   ├── api.js                前缀内路由表 + SSE hub + 回环闸门
│   ├── disk.js               容量与字节的单点折算（清单分组、进度、留痕共用同一口径）
│   ├── collect/              ring / l0-node / l1a-typeperf / l1b-powershell / supervisor / service
│   ├── alerts/               rules（纯函数判定）/ store（alert_hit）/ service（评估编排 + 未读计数）
│   ├── clean/                guard（红线单点）/ rules（内置库）/ scanner / ai-advisor（只推荐不执行）/
│   │                         plan-store（冻结清单）/ executor（两段式执行）/ log-store（留痕）/ quarantine（暂存）/ service
│   ├── records/              spec.js —— alert_hit / clean-plan / clean-log 三张记录表的声明处
│   ├── search/               probe（三级探测，全程只读）/ everything-http / es-exe / walk / installer（一键安装四道闸）/ service
│   └── prefs/                spec + store（采集档位、源开关、阈值、限定目录）/ rules-store（本机清理规则）
├── docs/
│   ├── design-spec.md          设计说明：决策表、实测代价、数据流、错误处理、测试与验收门禁
│   └── implementation-plan.md  25 个 Task 的实现计划（含逐条契约）
├── scripts/probe-collect.mjs   实测代价探针（只报事实，恒 exit 0）
├── prototype/index.html        可点原型（与 client.js 同口径，改设计先改它）
└── test/                       见上

许可

MIT。见 LICENSE。

本插件只做本机读写与显式确认的删除，不提供任何提权、不提供结束进程的能力，也不替你决定删什么。用完请自行核对留痕。

gh-gongjin/dsh-plugin-sysops

dsh-plugin-sysops

安装

方式 A：官方 CLI

方式 B：手工两步（不需要 pnpm）

停用 / 卸载

界面

采集是怎么分层的

数据与隐私

做不到就写出来（诚实降级）

测试

目录结构

许可

Community comments

gh-gongjin/dsh-plugin-sysops

dsh-plugin-sysops

安装

方式 A：官方 CLI

方式 B：手工两步（不需要 pnpm）

停用 / 卸载

界面

采集是怎么分层的

数据与隐私

做不到就写出来（诚实降级）

测试

目录结构

许可

Community comments