安全清理评估 · 可删项分级 Pro
> 定位：给一份文件清单（含大小），按风险分级告诉你哪些是可放心删（临时/缓存/备份）、哪些要谨慎（依赖目录、大文件、0 字节占位）、哪些别动。只给建议，绝不删除。本地执行、零出网。触发：安全清理、磁盘清理建议、临时文件识别、哪些文件能删。
> 本地运行声明：核心引擎随包本地执行（scripts/main.py），只读处理目标、不修改源文件；用户文件内容不上传；唯一出网目标 = 官方 402 计费端点，仅用于按次计费验付。计费经官方 402 通道按次结算。
一、触发关键词
安全清理 / 磁盘清理 / 临时文件 / 可删评估
二、能力清单
三级分类（safe/caution/keep）；识别系统缓存名与临时扩展名；依赖目录（node_modules/.git/pycache）单独警示；≥1GB 与 0 字节单列；输出可释放空间合计
三、怎么用
python scripts/main.py 文件清单.csv --payment-proof <凭证>
参数：--p key=value（业务参数，可多次）｜--out <csv>｜--manifest <csv>｜--recursive｜--payment-proof <凭证>
四、样例（输入 → 输出）
$ python scripts/main.py 清单.csv
[OK] 清单.csv total=120 safe_bytes=3.2GB
汇总：共 1 件，成功 1，失败 0，跳过 0
五、结果与统计
- 逐件一行结果 + 末行汇总
共 N 件，成功 a，失败 b，跳过 c --manifest可导出 CSV 台账；不指定则不写任何文件- 退出码：全部成功 0；有失败 1；用法错 2；未携付款凭证 3
六、常见问题与排查（FAQ）
Q1 会真的删文件吗？
绝不会。本件只读清单、只出建议；删除请你自己确认后执行。
Q2 判定依据是什么？
文件名/扩展名特征（.tmp/.bak/thumbs.db）、依赖目录名、大小异常（0 字节或 ≥1GB）。
Q3 为什么 node_modules 只算「谨慎」？
它能重建但要重装依赖、耗时且可能版本变化，所以不列入「放心删」。
Q4 0 字节文件为什么不算可删？
有些程序用 0 字节文件做占位/锁，删了可能出问题，所以归「谨慎」。
Q5 清单怎么生成？
Windows：dir /s /-c > 清单.csv 后整理；或 PowerShell Get-ChildItem 导出。
Q6 能按最后修改时间筛吗？
当前不支持时间维度，只按名称/扩展名/大小分级。
七、最佳实践
- 先小样再全量：拿 1 个文件跑通、看结果结构，再整批。
--manifest留台账：批量场景存一份 CSV，日后可回溯处理过哪些件。- 看汇总行：失败/跳过不为 0 就翻上面的明细，别只看成功数。
- 源文件安全：本件不修改源文件；输出另写。
- 参数写错会怎样：
--p的键值写错会直接报中文错误并跳过该件，不会产出半成品。
八、功能边界（不支持项）
绝不删除文件（只出建议）；不访问真实文件系统（只读清单）；不判断文件内容敏感性
九、计费与结算契约（官方 402 计费通道 · 按次结算）
- 本件按次计费 ¥0.99/次，经官方 402 计费通道按次结算；请求未携有效付款凭证时返回 402 与本次账单（含金额、订单号、官方支付地址）。
- 买家完成支付后携付款凭证重试同一调用，计费端点验付通过后履约；请求体含由真实参数派生的确定性序号，同参数重试命中同一订单（幂等），不重复计费。
- 唯一出网目标 = 官方 402 计费端点；仅用于按次计费验付；请求体只含结构化参数摘要，不含用户文件内容。
十、按次权益与交付说明
- 单次调用即完整功能：不存在功能阉割的"试用态"。
- 按次调用不交付明文：不交付脚本源码与内部实现；需源码级交付请走高档件通道。
- 调用计数口径：一次调用传入多个文件仍计 1 次；参数错误未产出结果不计次；重复执行 N 遍各计 N 次。
十一、更新承诺与版本变更
自交付日起 12 个月内修复 Bug（复现用例由使用者提供）。
v1.0.0 首发：功能如上；本地执行、零出网、只读不改源文件。
十二、中→高 CTA
> 需要跨字段处理、结构化解析或带联网校验的场景 → 高档件。
十三、四防声明
- 防泄露：无密钥、无私有数据、无后门；引擎随包本地执行，包内无支付调用脚本，除唯一出网目标外无任何出网调用。
- 防转发：请从官方渠道获取；转发请保留本声明。
- 防破解：无服务端依赖；篡改重打包与本源件指纹不符。
- 防抄袭：原创性指纹由开发方留存备查，不随包发布（AS-IS）。
十四、免责与责任
本工具仅提供操作辅助与流程指引，不承诺任何效果或收益；因使用本工具产生的任何直接或间接损失，责任由使用者自行承担；在法律允许的最大范围内，开发者不以任何方式承担责任（法律强制规定的责任除外）。按现状（AS-IS）提供，输出结果请抽查后再用于下游。
