Codex 智能体管理台

Codex 智能体管理台是一个本机 localhost 工具，用中文浏览和维护 Codex agent 配置、项目配置、运行线程、动态工作流证据，并对单个 agent TOML 执行受控写回。

项目由 Go 后端和 Vue 3 + Vite 前端组成。后端默认只读取当前用户的 CODEX_HOME，前端通过集中 API client 调用后端端点，并把来源、置信度、状态和写回结果转换为中文展示。

启动后端

默认配置：

启动命令：

go run ./cmd/codex-agent-manager

健康检查：

curl http://127.0.0.1:18083/api/health

如需指向测试用 Codex home，可在启动前设置 CODEX_HOME。

前端位于 web/，默认 dev 地址为 127.0.0.1:13083，Vite 代理本机后端 API。

cd web
pnpm install
pnpm dev

打开 http://127.0.0.1:13083/ 查看工作台。

后端和整体检查：

go test ./...
go test -count=1 ./...
git diff --check

前端检查：

cd web
pnpm test
pnpm build

如果需要浏览器视觉验证，由主智能体或可用浏览器工具访问 http://127.0.0.1:13083/ 后记录截图结果；不要伪造截图记录。

GET /api/health: 健康检查，返回 { "status": "ok" }
GET /api/agents: 只读列出 CODEX_HOME/agents/*.toml 直属文件；坏 TOML 作为 invalid 条目返回
POST /api/agents/{id}/validate: 校验单个 agent TOML 草稿，返回 diff、字段变化、目标路径和当前 sha256 hash；不写文件
POST /api/agents/{id}/write: 使用 expectedHash 写回单个已有 agent TOML；写回前重新校验、创建备份并做原子替换
GET /api/projects: 只读解析 .codex/config.toml 中的项目配置
GET /api/runtime/threads: 只读读取 Codex SQLite 运行线程、spawn edges 和 goals，并返回来源证据
GET /api/workflow/events: 从运行线程、goals、spawn edges 和计划文件生成动态工作流事件、交接边和阶段状态

前端 API client 位于 web/src/api/client.js，中文 normalizer 位于 web/src/api/normalizers.js。