用途:扫描本机中被放弃的项目仓库,从 git 历史推断其停止原因,总结个人项目"死亡模式",并挑选最值得复活的一个项目协助交付。全部本地运行,无 API、无网络,不写入被扫描的仓库。
主要能力:统计墓园概况(死亡数、总寿命、最老项目);为每个死项目生成墓志铭(名称、寿命、提交数、死因及证据);归类死因模式(如支付墙、被新项目杀死、完成、慢慢淡出等);按"复活可能性分数"排序并给出前 3 名;提供状态文件以支持"复发监控";支持 Necromancer 模式,在用户提新想法时先查旧项目是否已实现大半。
使用方式:运行 python3 scripts/graveyard.py ~/dev ~/projects,无参数时扫描常见目录。常用参数:--days 90 设定判定为死亡的静默天数(默认 45);--json report.json 输出机器可读数据;--me work@email.com 认领其他邮箱的提交;--include-foreign 纳入少量提交的仓库;--state FILE 记录扫描与复活状态。复活时用 --state ~/.project-graveyard.json --mark-resurrected /path/to/the/corpse 记录。
复活流程:从候选中选一个,阅读其 README 并略读代码,再核查当初的阻碍如今是否变容易、世界上是否已有类似产品;最多 7 个具体步骤,终点为真正交付,步骤 0 是确认仍能运行,步骤 1 当天可完成。若用户不再关心、窗口已关闭或候选都很弱,应明确建议保持埋葬。
限制:脚本只读 git,死因是带证据的推测而非定论;"死亡"是阈值判断,长期稳定的完工项目也可能被误判;归属过滤依赖 git 邮箱,多邮箱提交可能被跳过;一天项目通常是一次性尝试,不应简单视为失败;不适用于清理磁盘或在 GitHub 归档仓库。以上细节均来自所给资料,未提供的信息暂未提供。