给团队成员看的图解
MAI × Vooo 协作与审批流程
MAI 负责开发、编译、可选测试机验证和可选生产部署；Vooo 只负责让用户与各 AI 角色持续对话、校正和批准。
执行都在 MAI，决策都在 Vooo：代码、构建、测试机和生产凭据不经过 Vooo；计划、进度、测试证据、审批和部署结果全部回到同一个 thread。
谁负责什么
批准计划、检查测试、批准生产
测试与部署均在本机编排
可选上传测试机并验证
获批后可选部署生产
Vooo 只做协作控制面
- 保存用户与 AI 的完整 thread
- 显示 planner、developer、reviewer、tester、deployer 等角色
- 记录每一版新计划和修订计划
- 让用户批准计划与生产部署
- 把批准转换成 MAI 可领取的任务
Vooo 不执行
- 不修改、编译或打包代码
- 不接收工作树、ZIP 或构建产物
- 不上传测试机，也不运行测试
- 不保存测试机或生产环境凭据
- 不 SSH/rsync 到生产环境
一个 thread 的完整生命周期
用户提出需求或校正
用户随时在 Vooo thread 发言。无论当前在讨论、开发还是部署阶段，Vooo 都会把新消息排成 reply 任务。
不同 AI 角色逐条反馈
MAI 读取完整 thread。每个角色的结论都带 role、kind 和 result_status POST 回 Vooo，用户能看清是谁做了什么判断。
planner · plan · pending
reviewer · progress · info计划持续修订，用户批准最新版
每一版新开发计划都以 kind: plan 完成当前任务，并替换 thread 的“当前计划”。新计划会回到讨论状态并终止尚未完成的旧开发或部署任务；只有用户点击“批准开发计划”后，Vooo 才生成新的 develop 任务。
MAI 开发、审查和编译
MAI 直接操作 Git，在本机完成开发、代码审查、编译和基础验证。中间进度使用 done: 0 持续回帖。
git pull --ff-only
# develop / review / build
git push origin main可选：上传测试机并测试
是否使用测试机由 MAI 工作流决定。若执行，上传、测试和凭据全部由 MAI 管理；测试步骤、版本、结果和证据以 test_result 回到 Vooo，方便用户检查。
完成开发并登记 commit
MAI 将最终代码直接 push Git，再用 commit_sha 和开发/构建/测试摘要完成任务。Vooo 只保存对话和 Git 引用。
用户检查测试并批准生产
用户在同一 thread 检查各角色回复与测试证据。需要上线时点击“批准生产部署”；Vooo 只创建带精确 commit 的 deploy 任务，不连接生产机器。
可选：MAI 部署 Prod 并反馈
MAI 使用本机管理的生产凭据部署获批 commit，完成健康检查，再以 deploy_result 回帖。若不批准，流程停在可检查的开发结果，不会自动上线。
两个明确的人工闸门
/api/topic/:id/approve_plan批准计划：把最新版计划变成 develop 任务。AI 回帖本身不能代替用户批准。
discussing
↓ 用户批准
plan_approved → develop/api/topic/:id/approve_deploy批准生产：把已经检查过的精确 commit 变成 deploy 任务。Vooo 不执行部署。
dev_done
↓ 用户批准
deploy_approved → deployMAI 回帖的结构
/mai/topic?topic_id=42每个新阶段开始前刷新完整 thread，读取用户最新校正、当前计划和 release commit。
{
"topic": {"status": "developing"},
"posts": [{
"author_role": "planner",
"kind": "plan",
"result_status": "pending"
}],
"release": null
}/mai/post所有角色更新走同一个接口，内容在 Vooo thread 中按角色与结果状态显示。
{
"role": "tester",
"kind": "test_result",
"result_status": "success",
"content": "测试机验证通过",
"done": "0"
}MAI 的回帖类型
plan：新计划或修订计划，等待用户批准progress / build_result：开发、审查和编译反馈test_result：可选测试机上传与测试证据deploy_result：可选生产部署及健康检查结果chat：解释、提问或其他对话内容没有用户批准计划，MAI 不开始开发。
没有用户批准生产，MAI 不部署 Prod。
任何新校正、计划、角色结论、测试与部署结果，都必须回到当前 Vooo thread。