← 返回开源雷达

spacesky-cell/TwinFix

B · 精选

在一次性孪生环境中自动诊断、复现并修复故障的 AI Agent

⭐ 130 stars⑂ 0 forksPythonApache-2.0创建于 2026-11-13最近更新 2026-11-13

这个项目是什么

TwinFix 是一个专门处理线上故障的 AI 助手。当系统报警、出现错误日志,或者有人提交 Issue 时,它会自动接手:先判断问题是否真实存在,再分析根因,然后在完全隔离的「一次性孪生环境」里把故障复现出来,接着修改代码、跑测试验证,最后把修好的结果交给人工审核。整个过程它都不碰生产环境,也不会自己给自己打分。

它要解决的问题是:现有的运维类 AI 工具大多只告诉你「哪里出问题了」,不改代码;而一些自动修 bug 的工具虽然能生成代码改动,却没在真实运行环境中验证过,谁也不敢直接合并。TwinFix 坚持四条原则:没有稳定的失败用例就不动代码;修复的人不能自己判定通过与否;验证结果绑定具体代码版本;最后必须由人来点「批准合并」。

它适合运维/SRE 团队、后端开发者和需要快速响应线上事故的工程团队。项目支持 Java、Python、Go、TypeScript/JavaScript 和 C# 五种语言,能接 GitHub、GitLab、Prometheus、Grafana、Elasticsearch 等常见工具,并提供网页控制台查看诊断过程、代码改动和审批。目前处于 v0.1 alpha 早期阶段。

核心亮点

  • ▸先复现再修复:必须先写出一个能稳定失败的测试用例,才允许动业务代码,避免修错地方。
  • ▸验证与修复分离:修复的 AI 不能自己判定是否通过,由独立流程在沙箱中重跑,并用 AI 看不到的隐藏测试判分。
  • ▸不碰生产环境:所有改动都在从目标分支构建的一次性孪生容器环境里进行,可随时丢弃重建。
  • ▸安全边界清晰:工具统一走权限网关,敏感路径只读,只能推送 fix/twinfix-* 分支,合并必须人工批准。
  • ▸多语言多入口:一套流程支持 Java、Python、Go、TypeScript、C#,可从告警、错误日志、Issue 或手动创建事故进入。
  • ▸流程可恢复:用状态机编排并持久化每一步,worker 崩溃后能从断点继续,还有实时进度推送和急停开关。

谁做的

由独立开发者 spacesky-cell 维护,属于个人开源项目,目前处于早期 alpha 阶段,社区规模较小。

怎么用

它是需要自己部署的开源项目,官方推荐用 Docker Compose 一键跑起来。最快的方式是「演示模式」:克隆仓库后执行 docker compose -f deploy/compose.dev.yml up -d --build,然后打开 http://localhost:17317,手动创建一个内置事故场景,就能看到它从诊断到修复再到等待审批的完整流程——这一步不需要任何 API Key。

如果想接入真实的大模型做实际故障修复,需要把 deploy/.env.example 复制成 deploy/.env,填入一个兼容 OpenAI 接口的模型地址、API Key 和模型名,并把运行模式设为 llm,然后重新构建启动。项目本身采用 Apache-2.0 协议,完全免费开源,但调用大模型产生的费用由你自己的 API 服务商收取。本地默认关闭登录鉴权且只绑定本机地址,若要对外暴露,需先开启鉴权并配置密钥。

数据速览

Stars
130
Forks
0
Open Issues
2
收录时间
2026-11-16
ai-agentautomated-program-repairbenchmarkbug-fixingdevopsdockerfastapiincident-responsekuberneteslanggraph