| name | c-drive-cleaner |
| description | AI驱动的C盘智能决策顾问——不是清理工具，而是你的磁盘健康私人AI管家。深度分析+个性化建议+安全执行指导。当用户询问C盘空间不足、想清理垃圾、释放磁盘空间、想将某些数据移出C盘时调用此技能。 |
| version | 6.1.2 |
| brand | CleanSight |
CleanSight — AI Disk Health Advisor
我不是清理工具，我是你的 AI 磁盘健康顾问。
传统工具 = 执行层：帮你删文件（但不懂你）
CleanSight = 决策层：理解你 → 分析数据 → 智能建议 → 教你安全执行
💰 Token 成本预估（重要）
本技能的核心工作是纯本地的：扫描（PowerShell）、分析逻辑、报告生成全部在本地运行，不消耗 Token。
AI 对话轮次会消耗 Token（接入的模型费用），但这取决于你问了多少问题。
| 场景 | 预估成本（DeepSeek Flash） | 说明 |
|---|
| 直接运行清理脚本（不对话） | ¥0 | 纯本地，完全免费 |
| 让 AI 运行一次完整扫描 + 报告 | ¥0.05-0.1 | AI 解读报告，给建议 |
| 让 AI 指导执行清理 + 后续追问 | ¥0.1-0.3 | 正常使用范围 |
| 调试 bug + 反复修复 | ¥1.0+ | 异常情况，不应发生 |
💡 省钱技巧: 直接运行 .\cleaners\clean-safe.ps1 -ReallyDelete 或 .\cleaners\clean-apps.ps1 -RiskLevel safe 是完全免费的。
🧠 三大核心优势（为什么用 AI 而不是 CCleaner）
| 优势 | 传统工具 | CleanSight |
|---|
| 上下文感知 | 固定规则，一刀切 | 基于你的使用习惯动态分析 |
| 动态风险评估 | 只说"能删/不能删" | 告诉你为什么 + 替代方案 + 迁移指导 |
| 知识赋能 | 删完就结束 | 教你根本解决方法，一劳永逸 |
差异化公式: 迁移 > 删除 > 忽略 — 传统工具只会删，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" # 只扫描开发缓存+浏览器
扫描类别速查
| 类别 | 脚本 | 覆盖 | 适用 |
|---|
| A-系统隐藏 | scan-system-hidden | hiberfil/pagefile/还原点/WinSxS | 了解即可 |
| B-临时缓存 | scan-temp-files | Temp/缩略图/回收站/Update缓存 | ✅ 日常首选 |
| C-开发缓存 | scan-dev-caches | npm/pip/cargo/maven/gradle等 | 开发者必看 |
| D-浏览器 | scan-browsers | Chrome/Edge/Firefox等 | 所有人 |
| E-应用数据 | scan-app-data | IDE/媒体/办公/AI工具 | 深度清理 |
| F-大文件 | scan-large-files | TOP 20大文件+文件夹排行 | 快速定位 |
| G-特殊占用 | scan-special-sources | Docker/WSL/游戏平台 | 特殊需求 |
| H-安全软件 | scan-security-software | EDR/NAC/杀毒 | 仅了解 |
| I-多版本 | scan-multi-version | 多版本残留 | 整洁度 |
| J-重复运行时 | scan-duplicate-runtimes | Electron/CEF重复 | 高级优化 |
| K-输入法 | scan-ime-data | 词库/日志 | 细节清理 |
| L-即时通讯 | scan-im-apps | 微信/QQ/钉钉缓存 | 社交应用 |
🛡️ 安全原则
风险等级
| 标记 | 含义 | 处理 |
|---|
| ✅ | 纯临时/缓存，删除无副作用 | 可直接执行 |
| ⚠️ | 需人工确认的低风险项 | 备份后执行 |
| ❌ | 系统核心/企业管控/用户数据 | 绝不触碰 |
| 🔴 | 可疑/未知，AI无法确定 | 引导自行判断 |
安全红线（永远不自动执行）
- ❌ 删除系统还原点 / 关闭休眠 / 移动页面文件
- ❌ 清理 WinSxS /ResetBase
- ❌ 删除 Program Files / 用户文档/桌面/下载
- ❌ 触碰企业安全软件(EDR/NAC/杀毒)
- ❌ vssadmin / diskpart 操作
安全机制
- 只读默认: 扫描脚本只读不写
- WhatIf 模式: 清理脚本支持
-WhatIf 预览
- 明确确认: 危险操作需
-ReallyDelete
- 管理员检测: 清理前自动检查管理员权限（v6.1.2）
- 永久删除提示: 执行前显示"文件将永久删除，不经过回收站"（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 优化）
性能对比
| 操作 | 修复前 | 修复后 (v6.1.2) | 提升 |
|---|
| 删除 4.81 GB 飞书目录 | ❌ 卡死 30 分钟 | ✅ ~30 秒 | 60x+ |
| 删除 10.3 GB Trae CN | ❌ 没机会跑 | ✅ ~60 秒 | ∞ |
| 清理 3 项共 15.8 GB | ❌ 卡死后全崩 | ✅ ~3 分钟 | ∞ |
管理员权限
执行清理前自动检测管理员权限，未提权时给出明确提示。
安全提示
所有清理都是永久删除（不经过回收站），执行前会红色警示。
📋 报告命名规范
| 格式 | 示例 | 含义 |
|---|
| Markdown | CleanSight-CS-20260513-143022-72.md | 品牌-日期-时间-健康评分 |
| JSON | CleanSight-CS-20260513-143022-72.json | 同上 |
报告自动包含：执行摘要 → 扫描明细 → AI决策建议(Tier分级) → 使用指南 → 工具推荐
🔄 维护规范（AI Agent Skill 工程化标准）
版本管理
- 遵循语义化版本：
MAJOR.MINOR.PATCH
- 所有变更记录在
CHANGELOG.md
app-signatures.json 的 _schema 版本号与主版本同步
更新流程
- 签名更新: 编辑
app-signatures.json 或 user-custom.json，无需改代码
- 扫描器更新: 修改
scanners/ 下对应脚本
- 报告格式更新: 修改
analyze.ps1 中的报告生成逻辑
- 版本发布: 更新
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
| 操作 | 方式 | 复杂程度 | 推荐 |
|---|
| 搬 npm/pip/yarn 缓存到 D 盘 | 一行命令（Skill 自动） | 🟢 低 | ✅ 强烈推荐 |
| 搬微信/飞书缓存 | 无自动化脚本，目录结构复杂 | 🔴 高 | ❌ 不建议 |
| 搬 JetBrains 配置 | 配置文件与缓存混在一起 | 🔴 高 | ❌ 不建议 |
CleanSight v6.1.2 — AI Disk Health Advisor
理解你 · 分析数据 · 智能建议 · 赋能执行
