用途:整理项目文件、收纳归类、归档归位,解决项目或下载文件夹太乱、散文件无归属的问题。核心原则是升级:默认用最小可用结构,只有现有结构装不下真实复杂度时才升级目录形态。
主要能力:Projects 第一层只允许项目容器、_Project-Inbox/、_Archive/ 三类。升级阶梯分 L0 Inbox(未判断归属先入收件箱)、L1 普通项目(最小结构 00_Context/10_Source/20_Docs/90_History,按需生长 30_Assets/40_Builds/50_Data/60_Run-Release/70_References,清理任务才加 99_Delete-Review)、L2 项目族(同一目标下出现 2 个以上独立演化输出时升级,用 10_Shared/20_Subprojects 替代 L1 的 10_Source/20_Docs)。提供文件意图判断表,按归属层级、文件意图、置信度(High/Medium/Low)决定移动。备份与版本泛滥按“识别同源族→留最新→旧的收进待删除区→永不自动删→用户复核”处理。
使用方式:先判断走方案模式(默认,先只读扫描再给极简 move plan,用户确认后执行)还是直接模式(用户明示马上整理,或目标目录已是该结构)。确认 Projects 根路径,只读扫描第一层和 Inbox,让用户确认项目名。移动 Git 仓库前先跑 git status --short。所有移动写入搬运日志,记录原路径到新路径、时间、置信度。完成后用 find 验证第一层无散文件。
限制:不删除文件;不自动清 node_modules、.next、.build、模型、venv;不移动系统目录、隐藏配置目录、bin;不合并 Git 仓库;不把证书、token、.env、私钥放进项目仓库。中文模式或语言迁移时须先写完整映射文件与日志快照再移动。macOS 大小写不敏感,改大小写需临时名中转。无日志的移动视为不可逆,不允许。