spendtron

spendtron

一个只读工具，可找出哪个 GitHub Actions 工作流正在推高你的 CI 账单，按实际计算成本对工作流和仓库进行排名，并根据真实运行时长（而非估算值）确认问题，提供可直接粘贴的修复差异（例如缺少缓存、缺少 timeout-minutes）。

它以 MCP 服务的形式提供——可在 Claude、ChatGPT 或任何兼容 MCP 的客户端中调用 check_actions_cost，无需仪表板。身份验证使用 GitHub App（只读权限：Actions + Contents + Metadata）和 spendtron API 密钥，并以 bearer token 形式传入。每次调用均免费提供成本排名和一条已确认的修复差异。一次性支付 $39（通过 Stripe）即可解锁完整修复列表——不是订阅。

底层审计逻辑最初来自 ~/code/ci-audit/actions-teardown.sh（bash + gh api）——lib/auditActions.js 使用相同的算法，并将其移植为按安装实例运行，从而审计多家客户的组织，而非单个本地 gh 身份验证用户。

状态

这是一个真实产品，而非候补名单——请查看 ~/code/ci-audit 中的 HANDOFF.md/FINDINGS.md/CARRD.md，了解项目发展历程（早期尝试候补名单并发布到 Reddit 的方案已正确放弃；审计逻辑本身始终真实可用）。

GitHub App 必须设为公开（GitHub → spendtron-app → Advanced → Make this GitHub App public），这样任何人都能点击 Connect GitHub。此开关位于 GitHub 界面中，不在此仓库内。

设置

1. 将 .env.example 复制为 .env.local（或在生产环境中将这些配置设到 Cloud Run 的 Secret Manager）。
2. 在 github.com/settings/apps/new 创建 GitHub App — slug 为 spendtron-app，权限：Actions：只读、Contents：只读、Metadata：只读。回调 URL：<your deployed host>/github/callback。引导客户访问 /github/install 之前，请先将 App 设为公开。
3. 创建 Neon Postgres 数据库，并对其运行 db/schema.sql。
4. 为修复差异解锁创建一次性 Stripe Price（非定期），并将其 ID 填入 STRIPE_UNLOCK_PRICE_ID。将 Stripe webhook 指向 /stripe/webhook，用于处理 checkout.session.completed。（STRIPE_PRICE_ID 和 Customer Portal 是早期每月 $99 模式遗留的内容；已不再接入任何线上结账流程。）
5. 将 spendtron.com 和 www.spendtron.com 都映射到 Cloud Run 服务（在 Squarespace 上，www 应通过 CNAME 指向 ghs.googlehosted.com）。应用会将 www 以 301 重定向到主域名。
6. Stripe 隐私政策 / 条款页面：https://spendtron.com/privacy 和 https://spendtron.com/terms。
7. npm install && npm start。

测试

npm test — 使用模拟的 GitHub 客户端（这些测试无需真实凭据），覆盖成本计算逻辑的移植（必须与 actions-teardown.sh 中的 bash/awk 完全一致）和 API 密钥身份验证。