前言¶
在 DeepSeek Harness(DSH)里跑智能体或插件时,宿主进程往往和普通用户权限一样:能读配置、能调工具,却很难稳妥地备份 Windows 核心系统文件、定期核对哈希,或在发现篡改后从可信副本还原。手工用 SFC、DISM 或脚本可以部分解决,但和 DSH 面板、Agent 工具、定时任务很难放在同一套流程里。下面介绍社区插件 dsh-system-guard(仓库 youchen-yc/dsh-system-guard):在 DSH 侧栏提供「系统守护」面板,对本机系统文件做分析与分类,对核心文件做隐藏备份与巡查,垃圾文件只归类展示、删除由用户勾选确认;需要写系统或修复时再经 UAC 授予「守护权限」。
这是什么¶
dsh-system-guard 是 DSH 的 admin-security 类插件,维护者为 youchen-yc(README 中交流人格为鲸進進)。一句话定位:分析并分类本机系统核心文件与运行时垃圾,隐藏备份核心文件,按间隔巡查完整性,发现损坏或被篡改时告警并支持从备份修复;授予管理员权限仅用于保护类操作,且 Agent 不能代点 UAC。
当前 package.json 中版本为 1.0.2,许可 MIT。README 明确:1.0.1 以前的版本存在代码安全与分发自检问题,请使用 1.0.1 及以上;1.0.1 起补齐 SECURITY.md、CI 静态与供应链检查、SBOM、Ed25519 发布签名等。运行要求:Node.js >= 20,DSH >= 0.2.1-rc.1。
能力边界(不夸大)¶
用户点「授予守护权限」并通过 UAC 后,插件以管理员身份执行受控 helper 内的保护操作;这不是内核级特权,也不能静默提权。写系统动作在 lib/privilege.js 中通过冻结的白名单与 assertSystemAction() 门控;核心代码发布前生成 integrity.json 并运行时自校验,被改则拒绝写操作并告警——能发现篡改,不能物理阻止有写权限的人改磁盘上的代码。巡查发现核心文件哈希或大小异常会告警并可从隐藏备份还原,没有文件系统过滤驱动,不能在内核层阻断写入。联网校准是查询官方渠道核对系统版本与支持状态,再与本地完整性验证结合,不是微软提供的逐文件哈希清单下载比对。DSH 未运行时不会自动巡查;macOS / Linux 后端在 README 中标注为未在真机验证。
系统记忆类文件(页面文件、休眠文件、崩溃转储、事件日志等)单独归类展示,永久不参与删除。
核心功能¶
分析与分类¶
首次「分析」会读取系统信息、联网核对版本、解析核心文件清单并分类、建立基线,并备份核心文件(备份步骤涉及读权限;部分修复类操作需管理员)。「维护」可重扫垃圾与系统文件分类、校验备份状态。
隐藏备份与巡查¶
核心文件备份到剩余容量最大的盘下的隐藏目录(attrib +h +s、清单 manifest.json 含 SHA-256 等)。「巡查」逐文件核对核心文件哈希与存在性,并在系统更新窗口内的变化做豁免标记。「立即备份」「校验备份」可在面板单独触发。
修复与校准¶
「修复」可从隐藏备份还原损坏文件,也可选择 SFC、DISM、创建系统还原点(需守护权限)。「立即联网校准」只读查询官方渠道。设置区可配置自动巡查间隔(天)、联网校准询问间隔、是否自动备份、备份盘等。
垃圾文件¶
按用户临时文件、Windows 临时文件、更新缓存、系统日志、缩略图、错误报告、回收站等分组;可展开、打钩、全选,「删除选中项」二次确认后删除并显示释放空间。Agent 侧删除垃圾与修复必须带 confirm: true。
Agent 工具¶
插件向 AI 注册 system_guard 工具,动作包括 status、analyze、patrol、junk-scan、junk-delete、backup、backup-status、repair、restore-point、calibrate、settings-save 等。授予守护权限只能用户在面板上操作,Agent 不能代为授权。
安装与启用¶
插件以本地 bundle 形式安装,不影响其它插件。官方 README 示例:
plugin_manager install_bundle target: F:\DSH1.0\system-guard
其中 target 指向你本机上的插件 bundle 目录路径,请按实际 DSH 安装布局修改,不要凭仓库名自行拼接其它安装命令。
安装成功后,设置侧栏底部面板列表会出现「系统守护」盾牌图标;首次打开会引导「开始首次分析」。插件数据目录:
C:\Users\<你>\.dsh\system-guard
用于设置、状态、基线清单、隔离区等。备份目录(隐藏)形如:
<剩余容量最大的盘>:\SystemGuardBackup\.system-guard\
内含 manifest.json 与核心文件副本。
安装前应阅读仓库源码与 MIT 许可证;插件能力依赖 DSH 进程与 helper 的实际权限,敏感写操作以 UAC 为准。README 注明:改动过的 Host 相关文件需重启 DSH 后才会全部生效。
典型用法(面板)¶
| 按钮 | 作用 | 是否需要管理员 |
|---|---|---|
| 授予守护权限 | UAC 后获取仅用于保护系统的管理员权限 | 会弹 UAC |
| 分析(首次分析) | 系统信息、联网版本、清单分类、基线、备份核心文件 | 否(备份读权限) |
| 维护 | 重扫垃圾与分类、校验备份 | 否 |
| 巡查 | 核对核心文件哈希与备份状态 | 否 |
| 修复 | 从备份还原或 SFC / DISM / 还原点 | 是 |
| 立即备份 / 校验备份 | 重新备份或检查备份完整性 | 否 |
| 创建系统还原点 | 调用 Windows 系统保护 | 是 |
| 立即联网校准 | 只读查询官方版本与支持状态 | 否 |
经过上面的步骤完成首次分析后,可按设置的间隔自动巡查,或手动点「巡查」。垃圾区勾选后再删除;系统记忆类分组复选框禁用。
适用场景与注意¶
适合在 Windows 上长期使用 DSH、希望把核心系统文件基线、隐藏备份、定期完整性检查、可选垃圾清理收进同一面板,并希望通过 Agent 只读/可控调用(删除与修复需确认)的开发者或高级用户。
使用前请注意:README 真机验证主要在 Windows 10 专业工作站版 build 19045 等环境完成;UAC 提权后的 SFC、DISM、从备份还原、创建还原点在文档中标注为测试期间未弹 UAC,仅验证到门控与 need-elevation 提示,实际修复请在面板授予权限后自行验证。联网校准在无 DeepSeek 搜索凭据时会降级为直连官方页面。
DSH 生态是「一切皆插件」;社区目录 SkillHub 插件页 为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-system-guard 把系统文件分类、隐藏备份、巡查与可选修复接到 DSH 面板与 system_guard Agent 工具上,并对权限与删除动作做了白名单与确认约束。进一步了解可查看 SkillHub 目录页 与 GitHub 仓库 README。