Cleanup safety model: risk classes, plan and confirmation
清理前的风险分类、审阅与确认。
开发手册
以智能体为先，使用 ProjectStore 开发。
本项目既是 Mac 实用工具，也是人类与智能体协作开发的实际案例。欢迎你带上自己的智能体参与贡献。
人类设定目标、批准决策。智能体协助规划、实现、质疑方案与审查改动。共享 vault 让不同贡献者与会话都能接续项目上下文。
- 界面设计
- Claude Artifact
- 智能体参考
- 智能体参考（纯文本）
一次改动的开发流程
代码与项目记忆存放在两个仓库。从 vault 开始，检查是否与现有工作重叠，并遵循项目的审批与检查关卡。
- 项目记录编写故事与验收标准。重要决策记录为 ADR，必要时补充规范。
- 批评审查具有全新上下文的智能体在实现前审查方案，再由人类批准项目记录。
- 规划阅读代码映射与现有实现，确定改动应放在哪里。
- 实现实现已达成一致的行为，并运行与改动相关的检查。
- 代码审查独立审查者将代码差异与验收标准核对。关闭故事前记录验证证据。
贡献者环境设置
完整贡献指南 ↗前提条件： Node.js 20 或更高版本。请在普通终端中运行初始化，不要在智能体会话内运行。将两个仓库克隆到同一父目录。
1.克隆并绑定项目
git clone https://github.com/SmartAndPoint/DeepDriveCleaner.git git clone https://github.com/SmartAndPoint/DeepDriveCleaner-projectstore.git cd DeepDriveCleaner npx projectstore setup --vault ../DeepDriveCleaner-projectstore
2.启动 Claude Code 或 Codex
在 DeepDriveCleaner 代码目录中启动智能体。请先提供以下项目导览提示词，再提出代码修改请求：
我们目前进展到哪里了？ 请阅读 AGENTS.md 与已绑定的 ProjectStore vault，总结正在推进的史诗、未完成的故事和相关决策。帮我选择一个小规模贡献，检查是否与现有工作重叠。遵循项目的项目记录、批评审查、规划与代码审查关卡。修改代码前，先提出下一步建议。
3.保持改动易于审查
先就故事达成一致，保持代码差异聚焦，并附上相关验证结果。协调代码与 vault 的拉取请求，让审查者了解意图与实现。
make check- Rust 改动：格式、clippy 与测试。
make app-test- 应用逻辑改动：DDCKit 测试。
项目记录
浏览 vault ↗状态快照：2026 年 10 月 28 日。以 vault 为准。下方记录标题保留英文原文。
Rust core: library + CLI with JSON output
共享引擎及其命令行职责边界。
Faster clean: re-check only what the selection needs
所属史诗：Menu bar app。 一个明确保留清理检查约束的性能改进。
许可证与贡献条款
代码采用 PolyForm Noncommercial 1.0.0 许可证，源码可用。提交贡献还意味着授权 SmartAndPoint 使用、修改并重新许可该贡献，包括商业用途。贡献前请阅读原始条款。
