跳转至

Agent Portal — 03-13~14 Codex审计与自动同步基础建设

关键产品决策

  • Dad 决策：统一 Codex 运行策略
  • Codex 任务从单目录切换到上层 poc/ 运行，确保前后端联动
  • 开启 full access 权限，超时从几分钟提升到 5 小时

  • 原因：Agent Portal 是前后端联动项目，长时间代码生成、部署、截图验证都可能超过短超时

  • Dad 决策：产出物和项目说明必须自动同步

  • Portal 不只是静态展示，Artifacts 和项目说明应由后端自动扫描工作区并同步到 UI

  • 这是 Agent Portal 从"看板"走向"研究管理工作台"的关键转折

  • Dad 决策：固化 Codex 协作流程为 skill

  • 把"调用 Codex 的流程"固化成工作区 skill，包含关键规则：
    • 如果需求不清晰，必须先向用户确认，再发给 Codex
    • 展示 prompt 给 Dad 确认后再调用

技术问题与根因分析

Codex 缺少全局 API Key

  • 现象：Codex 执行时反复提示缺 key
  • 根因：key 虽在 ~/.bashrc，但执行环境没有 source，交互 shell 与实际 agent/exec/systemd 环境不一致
  • 解决方案：将 key 加到多个全局层：shell profile、systemd 环境、其他全局可继承位置

Codex 新版本配置变化

  • 现象：新版 Codex v0.113.0 不再自动使用 AZURE_OPENAI_API_KEY
  • 根因：旧版行为与新版本不同，未配置 Azure provider，默认走 OpenAI
  • 解决方案：
  • 查到 Codex 支持 --provider azure
  • 在 .codex config 中明确配置：
    • URL 和 env
    • model 使用 gpt-5.4
    • reasoning effort: high

Bot 架构/实现决策

工作区自动扫描逻辑

  • 技术方案：在 server.js 中加入工作区扫描逻辑
  • 扫描 projects/ 下每个项目的 README、代码、报告、配置等文件
  • 将文件映射到研究阶段，并 upsert 到 AP_artifacts 表
  • 选型理由：后端集中扫描比前端拼装更可靠，数据落库后便于统一展示、排序、过滤

自动同步每小时运行机制

  • 实现方式：创建 skill，编写同步脚本，用系统 crontab 每小时执行
  • 选型理由：当前 research agent 没有现成 heartbeat/cron，系统 crontab 是最直接可靠的调度方式
  • 监控方案：在 Portal 中为每个项目创建"项目同步"任务，记录运行状态

里程碑

  1. Codex 全局环境修复：后续 Codex 不再反复报缺 key，Azure OpenAI 正式接入
  2. 自动同步首次成功：启动后自动扫描并导入 117 个产出物，第二次扫描全部 skipped，说明去重正常
  3. Portal 具备研究资产视图：首次具备"自动从工作区生成研究资产视图"的能力，项目详情中出现"阶段产出物"（如 ClawCraft 可见 54 个阶段产出物）
  4. 标准协作流程确立：固定流程为"先确认需求 → 必要时拉 Gemini 分析 → 展示 prompt 确认 → 调用 Codex → 验证部署汇报"

关键文件线索

  • v2-pixel/server.js：工作区扫描与自动同步逻辑
  • v3-shadcn/：前端目录结构
  • AP_artifacts 表：产出物数据存储
  • ~/.openclaw/workspace/skills/codex-delegate/：Codex 协作流程 skill

这一阶段标志着 Agent Portal 从手工录入转向自动化采集，奠定了后续"研究管理工作台"的数据基础。