BeeX AI Worker 角色说明

把 AI 当成团队里的长期岗位来建设：有机器、有仓库、有监控、有 Runbook、有交付标准，而不是临时聊天工具。

1. 一句话定位

BeeX AI Worker 是一台长期在线的项目工作节点，承担「代码执行、文档沉淀、运维巡检、问题定位、发布辅助、内部问答」等重复但重要的工作。它不替代负责人做业务判断，也不绕过发布/资金/数据安全边界。

2. 当前已经落地

远程工作节点

ECS：beex-id-ops-ai-01，代码目录 /opt/beex-ai-workspace/x，所有仓库从 Git 拉取，不从个人电脑拷贝。

Git 监控

beex-git-watch.timer 每 5 分钟 fetch 一次，记录分支、HEAD、dirty、ahead/behind。

自检巡检

beex-ai-worker-selfcheck.timer 每 5 分钟检查机器、核心服务、关键 endpoint，异常状态变化会发飞书。

Uptime 监控

Uptime Kuma 已部署，监控 API、Admin API、H5、Admin、PRD、官网、runtime-config、H5 latest。

Runbook

第一批故障手册已放在 /opt/beex-ai-ops/runbooks，覆盖 H5 白屏、WA 登录、TikTok 同步、云效发布等。

飞书告警

通过本地签名桥 beex-uptime-feishu-bridge.service 转发到飞书机器人，密钥不进仓库。

3. 角色分工

子角色	负责什么	当前状态
项目记忆员	维护架构、PRD、接口、规则、部署和事故文档，回答“之前为什么这么做”。	进行中
代码执行员	按需求读代码、改代码、跑测试、提交可验证结果。	进行中
AI SRE	巡检 ECS、API、H5、订单同步、WA、支付、离线包，按 Runbook 排障。	基础可用
发布助手	触发/查看云效流水线，记录版本、发布人、发布结果、回滚建议。	待接指令入口
QA 助手	维护自动化用例、生成测试说明、复现用户反馈日志。	待扩展
内部问答助手	基于仓库和文档回答运营、测试、设计、开发的问题。	待飞书入口

4. 工作架构

flowchart TD Team["团队成员 / 飞书群"] --> Task["任务请求"] Task --> AI["AI Worker
Codex/Claude 工作节点"] subgraph ECS["beex-id-ops-ai-01"] AI Workspace["/opt/beex-ai-workspace/x
Git 工作区"] Ops["/opt/beex-ai-ops
脚本 + Runbook"] GitWatch["beex-git-watch.timer"] SelfCheck["beex-ai-worker-selfcheck.timer"] Kuma["Uptime Kuma"] Bridge["Feishu signed bridge"] end AI --> Workspace AI --> Ops GitWatch --> Workspace SelfCheck --> Bridge Kuma --> Bridge Bridge --> Feishu["飞书告警群"] AI --> Aliyun["阿里云 / ECS / OSS / CDN / SLS"] AI --> Yunxiao["云效流水线"] AI --> GitHub["GitHub"] AI --> BeeX["BeeX API / Admin / H5 / App"]

5. 团队怎么使用

你要什么	推荐说法	AI Worker 输出
查系统状态	`查一下 id-test 当前健康状态`	服务状态、Git 状态、监控状态、异常项。
查订单问题	`查用户 XXX 这单为什么没同步`	点击、转链、三方原始返回、订单表、佣金表、结论。
发布 H5	`发布一个 H5 测试包并告诉我版本号`	流水线结果、包版本、latest 状态、验证链接。
排查 App 反馈	`分析这个反馈日志包`	关键日志、时间线、根因、修复建议。
写 PRD	`把这个规则整理成给设计/开发看的 PRD`	HTML 文档、Mermaid 流程图、变量表、验收标准。

6. 机器上常用命令

ssh root@147.139.167.175

# 看 AI Worker 汇总状态
/opt/beex-ai-ops/ai-worker-status.sh

# 手动跑一次自检
/opt/beex-ai-ops/ai-worker-selfcheck.sh

# 看 Git 监控
systemctl status beex-git-watch.timer
cat /var/lib/beex-ai-ops/git-watch/latest.tsv

# 看 Uptime
docker ps | grep uptime
systemctl status beex-uptime-feishu-bridge.service

7. 权限边界

不能让 AI Worker 暗箱操作。 测试环境可以快，但代码、配置、部署、数据修复都必须留下记录。正式环境发布、资金规则、提现数据、删除真实数据等动作，需要明确授权和回滚/备份方案。

动作	默认权限	说明
读仓库/查日志/查监控	允许	AI Worker 的基础能力。
测试环境代码修复和部署	允许	需要说明版本和验证结果。
正式环境发布/回滚	需确认	走流水线，记录发布人、版本和健康检查。
修改资金/分佣/提现规则	需业务确认	AI 可实现，不自行决定数值。
删除生产数据/重置数据库	默认禁止	必须备份、审批、留审计。

8. 下一步开发

阶段	要补什么	验收标准
1	飞书自然语言指令入口	群里 @AI Worker 可触发查询状态、发布、回滚、刷新 CDN 等标准指令。
2	业务心跳	订单同步延迟、WA webhook 延迟、H5 包版本新鲜度、Xendit webhook 可被监控。
3	日报/周报	每天自动输出系统健康、发布、订单同步、告警、成本风险。
4	内部知识库问答	运营/测试问业务规则时，AI Worker 能引用文档和代码回答。