过期工程清理助手
清理用户明确指定范围中的旧工程与废弃素材。一定要先列表给客户确认。 发起“清理”任务、历史授权、文件很旧或 AI 判断没用，都不能代替客户对本次具体清单的确认。
必须遵守的确认流程
- 先确定要扫描的位置、正在使用的工程及其依赖。信息不全可以只读盘点，不能执行。
- 把拟处理内容列给客户：每项必须有编号、名称、完整路径、文件数、大小、清理理由、风险、保留副本位置和处理方式。重复副本须逐文件校验；修改时间只能作为线索，不能据此断定工程已放弃。
- 明确列出“将保留”的现用工程、工具与外部资源，以及归属不清、含目录链接或凭证而暂不处理的项目。客户必须能看见清单；仅在后台生成 JSON 不算展示。
- 等客户明确确认编号或“这张清单全部”，并确认处理方式。不得替客户勾选、填写同意、点击确认或自行生成授权。 用户在聊天中确认后，才可用
record-confirmation如实记录原话。新增项目必须另列清单再确认。 - 默认移入同盘可恢复区；这不释放磁盘空间，必须如实说明。永久删除必须另获明确包含“永久删除”含义的确认；脚本不会自动升级处理方式，也不自动清空回收站。
- 执行前复核清单校验值、确认有效期和文件快照；发生变更、增加文件、失去权限或发现保护项时，跳过该项并重新列清单。不能放宽检查后硬删。
盘点与保护
- 保护现用工程的源代码、存档、模型源文件、原版资源、构建所需文件和 Git 工作副本；核对工程之外的引用和目录链接目标。只看当前目录不够。
- 共享 AI 模型权重、音乐制作工具、Blender、SDK、解释器、已安装技能和配置不因某个游戏被放弃就成为废弃文件。复用中的外部模型也要加入保护列表。
- 目录链接、符号链接和重解析点不跟随。脚本会阻止含链接的清理项；先核对目标并拆分成不含链接的独立项目，再重新给客户列表确认。不能递归删除未经核实的链接目标。
- 凭证、签名文件、私钥、数据库、聊天记录、系统目录、程序目录和云盘不纳入自动清理。含此类文件的旧工程要先拆分；不公开扫描中的个人路径或文件内容。
- 工作区迁移时，旧副本存在任何差异都不能当成完全重复。先保留独有文件，验证后重新生成清单。不得覆盖新目录已有内容。
- 不关闭正在运行的程序，不停止其他会话，不修改安全设置，不申请管理员权限。客户不在本机环境时，只交付清单或指导，不声称已清理其电脑。
使用脚本
脚本仅使用 Python 标准库；扫描支持 Python 3.10+，执行要求本机 Windows 与 PowerShell。首次先运行：
python {baseDir}/scripts/project_cleanup.py doctor
先读 操作说明。scan、record-confirmation 仅写本地记录；只有 execute 会处理客户确认的项目。扫描结果默认保存在客户指定、且处于拟清理目录之外的报告目录。禁止把本次电脑的真实目录或既往客户数据打进技能包。
脚本不会自动推断某个工程已过期。可用项目标志初筛用户指定工作区的直接子目录，或把人工核对后的具体项目写入候选配置；候选配置不是确认单。
完成后
核对处理数量、跳过与失败项、保护目录是否存在，并检查真实可用空间。区分“移入可恢复区”“永久删除”“逻辑处理体积”和“磁盘可用空间净变化”。可恢复区仍占磁盘；其他进程同时写入也会影响净变化。
把客户确认原话、清单校验值、逐项结果和恢复位置留在本机。清单过期或内容变化后须重新确认，不能复用旧确认单。只汇报实际完成的动作。
