核心用法
Workspace Maintenance 是一套面向技术团队文档治理的轻量级维护框架，采用干运行优先（dry-run first）的设计理念。执行流程分为六个阶段：首先运行 scripts/archive-retention-audit.sh 生成候选清单；随后根据目录变更刷新文档索引；确保根目录的活跃控制文件（如任务追踪器、身份配置）保持原位；将过期快照、进度报告迁移至三大归档桶（meridian-snapshots、general-progress、session-hygiene）；更新任务状态时间戳；最终输出人工审查清单。
显著优点
- 零误删承诺：通过 shell 脚本预演 + 人工审查的双层机制，彻底规避自动化删除风险
- 可逆操作：所有移动均生成清单（move manifest），支持一键回滚
- 根目录保护：强制约束活跃控制文件不得外迁，维护项目核心导航结构
- 审计友好：干运行报告天然形成决策留痕，符合合规审计要求
潜在局限
- 人工瓶颈：最终删除决策依赖人工，高频维护场景下可能产生审查疲劳
- 脚本依赖：核心功能捆绑特定 shell 脚本，跨平台（Windows）适配需额外工作
- 无智能分类：归档规则基于预设路径，缺乏内容语义分析能力
适合人群
- 技术写作团队、开源项目维护者、需要长期保留历史快照的研发组织
- 对"自动化清理"持谨慎态度的合规敏感型团队
常规风险
- 脚本权限配置不当可能导致审计日志缺失
- 多人同时执行维护周期可能产生移动冲突
- 长期累积的干运行报告本身需二次治理
安全等级说明
工具设计上主动禁用自动删除，但脚本执行本身具备文件系统写权限（移动操作），需确保 scripts/ 目录权限可控。