π
Pi Agent 系统架构
单 Agent 可运行 Core（Java v1 + React + SSE）· 可审计、可扩展的 ReAct runtime，后续按真实需求吸收 Harness / Service 能力。
主链路：Java v1 (8787) + React (5173)
Harness / Service 规划中
图例（点击高亮某层）：
仅看已实现
提示：悬停查看模块，点击任意卡片展开职责 / 代码位置 / 新功能放置规则。窄屏自动堆叠为单列。
交互契约
跨层暂停 / 恢复协议
🔒 高风险命令审批
1
bash
工具触发
tool_permission
事件（SSE 下行）
2
浏览器提交
POST /api/approvals/{approvalId}
（REST 上行）
3
allow
执行；
deny / timeout
作为工具失败回灌 AgentLoop
💬 结构化信息追问
1
ask_user
触发
user_input_required
事件（SSE 下行）
2
用户填写后提交
POST /api/chat/continue
（REST 上行）
3
结构化答案作为成功工具结果回灌，恢复同一次 Agent 任务