← Overview

pi-starter 全景架构

pi-starter 全景架构 由 Archify 生成的架构图。 web/ 前端 · Vite · React · 前端 web/ 前端 Vite · React 入口 / 传输 · CLI·HTTP·WS·RPC · 单进程运行时 入口 / 传输 CLI·HTTP·WS·RPC buildAgent() · src/agent.ts · 单进程运行时 buildAgent() src/agent.ts Conversation · 会话栈 · 快照 rev · 单进程运行时 Conversation 会话栈 · 快照 rev pi SDK · ModelRuntime · 外部 pi SDK ModelRuntime 可注入资源 · tools·skills·知识 · 单进程运行时 可注入资源 tools·skills·知识 护栏 · guard·approval · 护栏 护栏 guard·approval 外部后端 · MCP·embeddings · 外部 外部后端 MCP·embeddings 状态与检索 · sqlite·memory · 单进程运行时 状态与检索 sqlite·memory SSE · ws 装配 会话 prompt tool_call 注入 放行 SQL MCP 前端 单进程运行时 护栏 外部

入口（5 种传输）

  • • CLI（npm run dev）
  • • HTTP + SSE（npm run web）
  • • WebSocket（/ws 快照 + rev）
  • • Library（import buildAgent）
  • • RPC stdio（--mode rpc）

装配与资源

  • • buildAgent(): model+prompts+tools+skills+knowledge+memory+database+extensions
  • • 会话栈 SessionHub → ClientSession → SnapshotEmitter
  • • Retriever: KeywordRetriever | VectorRetriever

护栏

  • • guard 拦截危险 bash / 路径逃逸 / 敏感文件
  • • approval gate: deny 关不掉、超时按 deny
  • • 工具看门狗

外部

  • • pi-coding-agent SDK + ModelRuntime
  • • providers · MCP · embeddings · 向量后端
  • • web/ React 复用 src/protocol.ts