💀 codead

is your open source project dead yet?

输入一个 GitHub 仓库，秒出死亡指数 (0-100)。想知道为什么死的？加一条命令做深度尸检。

快速开始

# 安装
npm install -g codead

# 检查脉搏（纯数据分析，不调LLM，免费秒出）
codead pulse atom/atom

# 深度尸检（LLM多Agent协作分析，输出死因叙事）
codead autopsy bower/bower --format html

输出示例 (codead pulse)

💀 codead pulse — 检查脉搏

  目标: atom/atom

  ╔══════════════════════════════════════╗
  ║   死亡指数:   91/100                ║
  ║   状态:  💀 已经死亡                 ║
  ╚══════════════════════════════════════╝

  📊 六维诊断:

    活跃度衰减  [██████████████████████████    ]  87/100  (权重30%)
    社区流失    [████████████████████████      ]  82/100  (权重20%)
    响应力退化  [██████████████████████████████] 100/100  (权重15%)
    交付停滞    [██████████████████████████████] 100/100  (权重15%)
    需求积压    [████████████████              ]  55/100  (权重10%)
    总线风险    [██████████████████████        ]  75/100  (权重10%)

  死亡指数 91/100 — 该项目已经死亡。

  💡 使用 'codead autopsy' 进行 LLM 深度尸检，获取死因叙事和复活建议

两个命令

| 命令 | 做什么 | 需要LLM？ | 耗时 | |------|--------|----------|------| | codead pulse <repo> | 检查脉搏，输出死亡指数 | ❌ 不需要 | 3-5秒 | | codead autopsy <repo> | 深度尸检，5个AI Agent协作分析 | ✅ 需要 | 30-60秒 |

死亡指数

纯代码计算，不依赖大模型。六个维度加权：

| 维度 | 权重 | 测量什么 | |------|------|---------| | 活跃度衰减 | 30% | 相对巅峰期的 commit 活跃下降程度 | | 社区流失 | 20% | 贡献者是否还在、是否持续流失 | | 响应力退化 | 15% | issue/PR 响应越来越慢 | | 交付停滞 | 15% | 多久没发版了 | | 需求积压 | 10% | issue 开得比关得快 | | 总线风险 | 10% | 几个人掌控全部代码 |

评级：

| 分数 | 等级 | 含义 | |------|------|------| | 0-19 | 💚 alive | 活蹦乱跳 | | 20-39 | 🟢 healthy | 基本健康 | | 40-59 | 🟡 declining | 在走下坡路 | | 60-79 | 🟠 critical | 进ICU了 | | 80-100 | 💀 dead | 已经凉了 |

深度尸检 (autopsy)

当 pulse 告诉你项目死了，autopsy 会用 5 个 AI Agent 协作分析为什么死的：

Agent 1: 时间线构建者   → 找出关键转折点
Agent 2: 社区病理学家   → 分析社区冲突和维护者倦怠
Agent 3: 技术考古学家   → 挖掘技术债和决策失误
Agent 4: 战略分析师     → 判断竞争格局和被替代原因
Agent 5: 验尸官         → 综合所有证据，出具最终裁定

输出：死亡时间线 + 根因分析 + 同赛道对比 + 复活可行性评估

安装 & 配置

git clone https://github.com/your-name/codead.git
cd codead
npm install
cp .env.example .env

.env 配置：

GITHUB_TOKEN=ghp_xxx          # 必需（pulse + autopsy 都要）
OPENAI_API_KEY=sk-xxx          # autopsy 时需要
LLM_PROVIDER=openai            # 或 ollama（本地模型）

适合"验尸"的经典案例

codead pulse atom/atom           # 被 VS Code 杀死
codead pulse angular/angular.js  # 被自己革命
codead pulse bower/bower         # 被 npm 替代
codead pulse gulpjs/gulp         # 被 webpack 替代
codead pulse ariya/phantomjs     # 被 Puppeteer 替代

技术栈

• TypeScript + Node.js
• Octokit (GitHub API)
• OpenAI / Ollama (LLM)
• Commander.js (CLI)
• 零外部服务依赖（除 GitHub API 和可选的 LLM）

License

MIT