#!/usr/bin/env bash # pigo 协作 supervisor(单 agent 版) # # 在容器内运行一个 pigo headless 进程完成 /blackboard/task.md 中的任务。 # agent 的工作区为 /blackboard/workspace,产物与轮次日志保留在黑板上; # 任务完成(agent 用 blackboard 工具创建 DONE)后,supervisor 把结果 # 以结构化 JSON(result.json)落盘并打印一行摘要,供外部调度方直接解析。 # # 与旧双 agent 版的关键差异: # 1. 单 agent:每轮只运行一个 pigo 进程,无评审者,串行推进直至 DONE。 # 2. 结构化结果:无论成功/未解出/超时/失败,统一写 $BB/result.json # (status / exit_code / summary / flag / artifacts),主 agent 无需再 # 漫游黑板文件逐段猜测结果。 # 3. 日志精简:supervisor 只输出带 [supervisor] 前缀的状态行;agent 的 # stream-json 事件只写日志文件,不再混入 stdout。 # # 环境变量(均由外部调用方传入): # MODEL 模型名,如 deepseek-chat (必填) # BASE_URL OpenAI 兼容 API base-url (必填) # API_KEY API key (必填) # PROTOCOL 协议 openai|anthropic (可选,默认按 model 推断) # TASK 任务描述 (必填;或挂载 $BB/task.md) # BLACKBOARD 黑板目录 (默认 /blackboard) # PROMPTS 协作 prompt 目录 (默认 /prompts) # ROUND_MAX 最大轮次 (默认 10) # TIMEOUT 单轮超时秒数,0=不超时 (默认 600) # FAIL_MODE agent 失败时:stop=立即退出(默认)| continue=继续下一轮 set -u BB="${BLACKBOARD:-/blackboard}" PROMPTS="${PROMPTS:-/prompts}" ROUND_MAX="${ROUND_MAX:-10}" TIMEOUT="${TIMEOUT:-600}" FAIL_MODE="${FAIL_MODE:-stop}" log() { echo "[supervisor] $*"; } # emit_result 把任务结果以结构化 JSON 写入 $BB/result.json 并打印一行摘要。 # status: solved | unsolved | error | timeout emit_result() { local status="$1" summary="$2" code="$3" local flag="" artifacts_json="[]" summary_json='""' flag_json='""' # flag 优先从 summary 提取,其次在 workspace 产物中全量检索 if [ -n "$summary" ]; then flag=$(printf '%s' "$summary" | grep -oE 'flag\{[^}]+\}' | head -1) fi if [ -z "$flag" ] && [ -d "$BB/workspace" ]; then flag=$(grep -rhoE 'flag\{[^}]+\}' "$BB/workspace" 2>/dev/null | head -1) fi # 产物清单:workspace 下的全部文件(最多 50 个),经 python3 转义为 JSON 数组 if [ -d "$BB/workspace" ]; then artifacts_json=$( cd "$BB/workspace" && find . -type f 2>/dev/null | sed 's|^\./||' | head -50 | python3 -c 'import json,sys; print(json.dumps([l.rstrip("\n") for l in sys.stdin]))' 2>/dev/null ) [ -z "$artifacts_json" ] && artifacts_json="[]" fi # summary 截断到 4000 字符并经 python3 转义,防止引号/换行破坏 JSON summary_json=$(printf '%s' "$summary" | head -c 4000 | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))' 2>/dev/null) [ -z "$summary_json" ] && summary_json='""' flag_json=$(printf '%s' "$flag" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))' 2>/dev/null) [ -z "$flag_json" ] && flag_json='""' cat > "$BB/result.json" <&2 exit 2 fi if [ -z "${TASK:-}" ] && [ ! -f "$BB/task.md" ]; then echo "错误:请通过 TASK 环境变量或挂载 $BB/task.md 提供任务" >&2 exit 2 fi if [ -f "$BB/DONE" ]; then log "黑板已有完成标记,如需重新开始请删除 $BB/DONE" exit 0 fi # ---- 初始化黑板 ---- mkdir -p "$BB/workspace" "$BB/logs" "$BB/sessions" if [ -n "${TASK:-}" ]; then printf '%s\n' "$TASK" > "$BB/task.md" fi # 协议注入:agent 的 cwd 是 $BB/workspace,AGENTS.md 注入链从 cwd 起, # 因此把协议副本放进工作区(勿修改,它是每轮系统提示的一部分) cp "$PROMPTS/AGENTS.md" "$BB/workspace/AGENTS.md" log "黑板初始化完成:$BB" log "任务:$(head -c 200 "$BB/task.md")" # ---- 单轮运行:一个 pigo 进程,输出 stream-json(首事件携带 sessionId)供 --resume ---- run_agent() { local round="$1" local session_file="$BB/sessions/agent.session" local task_prompt="轮次 $round 开始。先读取 /blackboard/task.md 中的任务,检查工作区已有产物与 DONE 状态,然后继续推进任务。全部工作完成、交付物完整时,用 blackboard 工具 action=done 创建完成标记(summary 写最终交付总结,含关键结果/flag/提交响应/产物清单)。" local args=(-p "$task_prompt" -a -C "$BB/workspace" -o stream-json \ --model "$MODEL" --base-url "$BASE_URL" --api-key "$API_KEY" \ --append-system-prompt "$PROMPTS/agent.md") [ -n "${PROTOCOL:-}" ] && args+=(--protocol "$PROTOCOL") if [ -s "$session_file" ]; then args+=(--resume "$(cat "$session_file")") fi export ROUND="$round" NAME="agent" BB="$BB" local logfile="$BB/logs/round-$round.log" log "第 $round 轮开始运行 agent(日志:$logfile)" if [ "$TIMEOUT" -gt 0 ] 2>/dev/null; then timeout "$TIMEOUT" pigo "${args[@]}" > "$logfile" 2>&1 else pigo "${args[@]}" > "$logfile" 2>&1 fi local rc=$? # 从 stream-json 首事件提取 sessionId 供下一轮 --resume(agent_start 事件带 env.sessionId) local sid sid=$(grep -o '"sessionId":"[^"]*"' "$logfile" 2>/dev/null | head -1 | cut -d'"' -f4) if [ -n "$sid" ]; then printf '%s' "$sid" > "$session_file" fi return $rc } # ---- 主循环:逐轮运行 agent,直到 DONE 或达到轮次上限 ---- for round in $(seq 1 "$ROUND_MAX"); do [ -f "$BB/DONE" ] && break log "===== 第 $round 轮开始 =====" run_agent "$round" rc=$? if [ "$rc" -eq 0 ]; then log "第 $round 轮完成" else log "第 $round 轮失败(exit=$rc),日志见 $BB/logs/round-$round.log" if [ "$FAIL_MODE" = "stop" ]; then # 兜底:agent 虽超时/失败,但黑板已有提交成功证据(workspace 内 *.md 含 correct:true) # → 视为完成正常退出,避免"flag 已提交却因未写 DONE 被强杀(exit 143)"。 _done=0 for _f in "$BB"/workspace/*.md "$BB"/messages/*.md; do [ -f "$_f" ] && grep -q '"correct":true' "$_f" && _done=1 && break done if [ "$_done" = "1" ]; then log "检测到提交成功证据,自动标记完成" { echo "Task finished (auto-detected submit success)"; } > "$BB/DONE" emit_result solved "$(cat "$BB/DONE")" 0 exit 0 fi if [ "$rc" -eq 124 ]; then emit_result timeout "" "$rc" else emit_result error "agent 退出码 $rc,日志见 logs/round-$round.log" "$rc" fi exit "$rc" fi fi done if [ -f "$BB/DONE" ]; then log "检测到完成标记,任务结束" emit_result solved "$(cat "$BB/DONE")" 0 exit 0 fi log "达到最大轮次 $ROUND_MAX 仍未完成,请检查黑板产物与日志" emit_result unsolved "" 1 exit 1