Windows 残留清理 CypressTube/dsh-windows-cleanup-skills

dsh-windows-cleanup-skills

两个 DeepSeek Harness 技能：盘点 Windows 已安装软件，找出「软件已不存在或未使用」留下的残留文件夹，并在确认后安全清理。

| 技能 | 模式 | 做什么 |
| dsh-app-inventory-audit | 只读 | 生成安装清单（注册表卸载键、服务、Run 键、App Paths、快捷方式、AppX、UserAssist），扫描 Program Files / ProgramData / AppData 文件夹，交叉比对，输出候选残留项，附证据与风险。绝不删除。 |
| dsh-orphan-folder-cleanup | 破坏性，带防护 | 按计划 JSON 删除用户已确认的路径列表：白名单校验、拒绝受保护路径、删除前备份并逐字节/逐文件校验、逐项记录日志、非管理员失败处理、清空回收站、删除后校验与还原。 |

安装 / Install

一键安装（复制到 DeepSeek Harness）/ One-paste install

把下面整段复制到 DSH 对话框发送即可：DSH 会自动下载、备份旧版本、安装到 %USERPROFILE%\.dsh\skills 并校验。

安装 DSH 技能：请执行 pwsh -NoProfile -Command "irm https://raw.githubusercontent.com/MrCypressBai/dsh-windows-cleanup-skills/main/install.ps1 | iex" 完成后列出 %USERPROFILE%\.dsh\skills 下的 dsh-* 技能并汇报安装结果。

raw.githubusercontent.com 访问不了时，把命令里的 URL 换成 jsDelivr： https://cdn.jsdelivr.net/gh/MrCypressBai/dsh-windows-cleanup-skills@main/install.ps1

install.ps1 参数：-TargetDir（默认 %USERPROFILE%\.dsh\skills）、-Repo、-Ref、-NoBackup、-SkipVerify。同名技能已存在时自动备份为 <name>.bak-<时间戳>，下载失败会回退备用地址。

手动安装 / Manual install

git clone https://github.com/MrCypressBai/dsh-windows-cleanup-skills.git
$dest = Join-Path $env:USERPROFILE '.dsh\skills'
New-Item -ItemType Directory -Force $dest | Out-Null
Copy-Item .\dsh-windows-cleanup-skills\dsh-* $dest -Recurse -Force

或者用目录联接，让 git pull 自动保持更新 / Or link the folders so git pull keeps them updated:

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\skills\dsh-app-inventory-audit" -Target "$PWD\dsh-windows-cleanup-skills\dsh-app-inventory-audit"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\skills\dsh-orphan-folder-cleanup" -Target "$PWD\dsh-windows-cleanup-skills\dsh-orphan-folder-cleanup"

DSH 从 %USERPROFILE%\.dsh\skills\<name>\SKILL.md 加载用户技能（项目技能从 <repo>/.dsh/skills/ 加载）。重启会话，或等文件系统监听器发现它们。

用法 / Usage

1. 在 DSH 里说：「列出 C 盘和 D 盘已安装的软件，找出软件已不存在的残留文件夹」→ 触发 dsh-app-inventory-audit。
2. 查看 Markdown 报告和 orphans.csv；确认一份路径列表。
3. dsh-orphan-folder-cleanup 按确认后的列表生成计划 JSON，先试运行，备份用户数据组，再删除，最后报告释放了多少空间、哪些需要管理员权限。

安全模型 / Safety model

- 盘点严格只读。
- 清理会拒绝驱动器根目录、通配符、重解析点、受保护的操作系统/安装程序/授权路径，以及计划允许列表之外的任何内容。
- 用户数据（sqlite、笔记、模型、登录状态、授权）在删除前会备份并校验；restore-backup.ps1 负责恢复。
- Program Files / C:\ 下的项目通常需要提权；脚本会把它们记为失败，并提供自动提权的后续操作，而不是假装成功。
- 已知误报（Office Click-to-Run Office 15、SQL CLR 授权文件、InstallAnywhere Zero G Registry、ADINA 授权目录、MuMu 启动驱动、Web Deploy/IIS、COMSOL LiveLink、Bonjour 双目录、Windows\Installer、Package Cache）记录在审计技能的 references/false-positive-traps.md 中。

Requirements / 环境

- Windows 10/11，PowerShell 7（pwsh）。
- 非管理员会话即可（仅管理员可处理的残留会先报告，留待后续提权处理）。
- 不依赖 WMI/CIM，Get-CimInstance 被禁用时也能正常工作。

Layout

install.ps1 # one-paste installer (download → backup → install → verify)
dsh-app-inventory-audit/
SKILL.md
agents/openai.yaml
scripts/{collect-evidence,scan-folders,find-orphans}.ps1
references/{evidence-sources,false-positive-traps}.md
dsh-orphan-folder-cleanup/
SKILL.md
agents/openai.yaml
scripts/{execute-cleanup,admin-fixup,restore-backup}.ps1
references/{plan-schema,safety-rules}.md

License

MIT — 见 LICENSE。