如何给 AI 工作流做版本管理，方便回滚和对比？

学完这篇，你能把 AI 工作流像代码一样用 Git 管起来，做到随时回滚到旧版本、清楚对比两个版本改了什么。

第一步：建一个独立仓库，得到可版本化的目录骨架

这一步要做什么：给 AI 工作流建一个专用 Git 仓库，并固定目录结构，避免提示词、配置、导出文件散落各处。
打开终端执行：

mkdir ai-workflow && cd ai-workflow
git init
mkdir -p workflows/n8n workflows/dify workflows/comfyui prompts configs tests reports

然后新建 .gitignore，至少写入：

.env
.venv/
node_modules/
__pycache__/
*.log
.cache/
reports/*.json

注意：API Key、数据库密码只放 .env，仓库里只提交 .env.example。AI 工作流一旦密钥泄露，回滚也救不回来。

第二步：把工作流导出成文件，得到可提交的 JSON/YAML

这一步要做什么：不同平台的 AI 工作流要导出为文本文件，Git 才能记录和比较。
具体入口：

• n8n 1.x：打开工作流，点右上角 ⋯ > Download，保存到 workflows/n8n/order-bot.json。也可以用命令：n8n export:workflow --id=<工作流ID> --output=workflows/n8n/order-bot.json
• Dify 1.x：进入应用编排页，点右上角 发布 右侧的 ... > 导出 DSL，保存到 workflows/dify/order-bot.yml
• ComfyUI：顶部菜单 Workflow > Save (API Format)，保存到 workflows/comfyui/portrait-api.json
• LangChain/LlamaIndex：把链或图定义保存为 workflows/langchain/order_bot.py

注意：不要只截图或口述流程。没有导出文件，Git 无法 diff，也无法精确回滚。

第三步：拆出提示词和参数，得到最小变更单元

这一步要做什么：把提示词、模型参数、工具配置从工作流大文件里拆出来，改一处只动一个文件。
建立：

prompts/order-bot/system.md
prompts/order-bot/user.md
configs/order-bot.yaml

configs/order-bot.yaml 示例：

model: gpt-4o-mini
temperature: 0.2
top_p: 0.9
max_tokens: 800
seed: 42
tools:
  - refund_lookup
  - order_query

第四步：锁定依赖，得到可复现环境

这一步要做什么：记录 Python/Node 依赖版本，避免“代码没变但跑不起来”。
Python 用：

pip freeze > requirements.lock.txt

Node 用：

npm install
git add package-lock.json

注意：requirements.txt 可以写范围，但 requirements.lock.txt 要写死版本。回滚时两个都要回滚。

第五步：提交并打标签，得到可回滚节点

这一步要做什么：把当前可用版本提交，并打上语义化标签，以后能一键定位。
执行：

git add .
git commit -m "feat: 订单机器人 v1.2 增加退款分支"
git tag -a v1.2.0 -m "订单机器人 v1.2.0"
git push origin main --tags

第六步：对比两个版本，得到差异报告

这一步要做什么：查看旧版和新版到底改了哪些提示词、参数和工作流节点。
执行：

git diff v1.1.0 v1.2.0 -- prompts/ configs/ workflows/
git difftool v1.1.0 v1.2.0

重点看三处：temperature 是否变化、系统提示词是否新增限制、工作流是否新增工具节点。

第七步：回滚，得到旧版运行状态

这一步要做什么：把指定文件恢复到旧标签，再提交一次，避免破坏共享分支历史。
执行：

git checkout v1.1.0 -- workflows/dify/order-bot.yml prompts/order-bot/system.md configs/order-bot.yaml
git commit -m "rollback: 订单机器人回滚到 v1.1.0"

如果整个提交都要撤销，用：

git revert <commit-id>

注意：共享分支上别用 git reset --hard 后强推。用 git revert 或 git checkout <tag> -- <file> 更安全。

第八步：加评测用例，得到可比较指标

这一步要做什么：每次改版跑同一批测试，把准确率、耗时、成本记下来，回滚才有依据。
建立 tests/cases/refund.yaml，然后运行：

python tests/run_eval.py --workflow order-bot --version v1.2.0 --cases tests/cases/refund.yaml

结果写入 reports/order-bot-v1.2.0.json。对比时直接看 v1.1.0 和 v1.2.0 的通过率、平均延迟、token 成本。

小结

• AI 工作流要导出成 JSON/YAML/Python 文件，不能只存在平台里。
• 提示词、模型参数、依赖锁文件分开管，diff 才看得清。
• 用 git tag 标记可用版本，用 git diff 对比，用 git revert 或 checkout <tag> -- <file> 回滚。
• 密钥不入库，评测结果要留档，回滚前先确认旧版依赖也能装回来。