C Drive Cleaner

CleanSight — AI Disk Health Advisor

我不是清理工具，我是你的 AI 磁盘健康顾问。

传统工具 = 执行层：帮你删文件（但不懂你）
CleanSight = 决策层：理解你 → 分析数据 → 智能建议 → 教你安全执行

💰 Token 成本预估（重要）

本技能的核心工作是纯本地的：扫描（PowerShell）、分析逻辑、报告生成全部在本地运行，不消耗 Token。

AI 对话轮次会消耗 Token（接入的模型费用），但这取决于你问了多少问题。

💡 省钱技巧: 直接运行 .\cleaners\clean-safe.ps1 -ReallyDelete 或 .\cleaners\clean-apps.ps1 -RiskLevel safe 是完全免费的。

🧠 三大核心优势（为什么用 AI 而不是 CCleaner）

差异化公式: 迁移 > 删除 > 忽略 — 传统工具只会删，AI 教你迁移保留功能的同时释放空间。

🔧 工作流程

用户触发 "C盘快满了" / "帮我分析C盘"
  ↓
1. 执行 12 类别只读扫描（scanners/）
  ↓
2. 生成 AI 决策报告（健康评分 + Tier 分级建议）
  ↓
3. 展示摘要 → 用户追问 → 深入分析
  ↓
4. 用户选择执行项 → AI 提供精确命令 + 安全提示

一键模式

.\analyze.ps1                                          # 控制台输出
.\analyze.ps1 -OutputFormat markdown                   # 生成 Markdown 报告
.\analyze.ps1 -OutputFormat json                       # JSON 格式
.\analyze.ps1 -Categories "C,D"                        # 只扫描开发缓存+浏览器

扫描类别速查

🛡️ 安全原则

风险等级

安全红线（永远不自动执行）

• ❌ 删除系统还原点 / 关闭休眠 / 移动页面文件
• ❌ 清理 WinSxS /ResetBase
• ❌ 删除 Program Files / 用户文档/桌面/下载
• ❌ 触碰企业安全软件(EDR/NAC/杀毒)
• ❌ vssadmin / diskpart 操作

安全机制

1. 只读默认: 扫描脚本只读不写
2. WhatIf 模式: 清理脚本支持 -WhatIf 预览
3. 明确确认: 危险操作需 -ReallyDelete
4. 管理员检测: 清理前自动检查管理员权限（v6.1.2）
5. 永久删除提示: 执行前显示"文件将永久删除，不经过回收站"（v6.1.2）

📐 架构

c-drive-cleaner/
├── SKILL.md                    ← 你在这里
├── _common.ps1                 ← 公共模块（性能+统一接口）
├── analyze.ps1                 ← 一键入口（console/markdown/json）
│
├── scanners/   (12个只读扫描)
├── cleaners/   (3个清理: safe/deep/dev-caches)
├── migrators/  (3个迁移: appdata/dev-caches/wsl-docker)
├── extensions/
│   ├── app-signatures.json     ← 100+ 应用签名（14类别）
│   ├── user-custom.json        ← 用户自定义签名
│   └── scan-discover.ps1       ← 未知应用发现引擎
├── safety/     (备份+快照+回滚)
├── reports/    (生成的报告)
├── scheduled/  (定期自动化)
├── tests/      (测试评测体系 — 与 CONTEST-SUBMISSION.md 同步维护)
│   ├── TEST-RESULTS-LOG.md     ← 真实测试结果
│   ├── IDEA-LOG.md             ← 想法与优化追踪
│   └── migration-guide.md      ← 缓存迁移方案选择指南
└── memory/     (v6.2 个性化系统 — 架构设计中)

扩展性

新软件签名只需一行 JSON，无需修改代码：

{ "name": "我的软件", "detect_paths": ["%LOCALAPPDATA%\\MyApp\\cache"], "cleanable": true, "risk_level": "safe" }

编辑 extensions/user-custom.json 保存即生效。scan-discover.ps1 可自动发现未知大文件夹。

🛠️ 清理执行（v6.1.2 优化）

性能对比

管理员权限

执行清理前自动检测管理员权限，未提权时给出明确提示。

安全提示

所有清理都是永久删除（不经过回收站），执行前会红色警示。

📋 报告命名规范

报告自动包含：执行摘要 → 扫描明细 → AI决策建议(Tier分级) → 使用指南 → 工具推荐

🔄 维护规范（AI Agent Skill 工程化标准）

版本管理

• 遵循语义化版本：MAJOR.MINOR.PATCH
• 所有变更记录在 CHANGELOG.md
• app-signatures.json 的 _schema 版本号与主版本同步

更新流程

1. 签名更新: 编辑 app-signatures.json 或 user-custom.json，无需改代码
2. 扫描器更新: 修改 scanners/ 下对应脚本
3. 报告格式更新: 修改 analyze.ps1 中的报告生成逻辑
4. 版本发布: 更新 SKILL.md version + analyze.ps1 $VERSION + CHANGELOG.md

兼容性要求

• PowerShell 5.1+（Windows 自带）
• 不使用 PS7+ 专有语法（如三元运算符 ?:）
• 路径使用环境变量（$env:LOCALAPPDATA 等）
• 应用检测前置 Test-Path（不存在则跳过）

测试验证

# 验证扫描器正常
.\analyze.ps1 -Categories "B"    # 测试临时文件扫描
.\analyze.ps1 -OutputFormat json # 测试 JSON 输出

# 验证清理脚本
.\cleaners\clean-safe.ps1                      # WhatIf 预览
.\cleaners\clean-apps.ps1 -WhatIf -RiskLevel safe  # 预览可清理项

🔄 缓存迁移说明

详见 tests/migration-guide.md

CleanSight v6.1.2 — AI Disk Health Advisor 理解你 · 分析数据 · 智能建议 · 赋能执行