pi-agent：最小可扩展 Agent 底座，学习二开两相宜

是什么

pi（pi-agent）是 earendil-works 出品的开源「极简 agent harness」，主打「自我可扩展的 coding agent」，官网 pi.dev 提供演示与一键安装。仓库拆为四个包：pi-coding-agent（交互式 coding agent）、pi-agent-core（带工具调用与状态管理的运行时）、pi-ai（多供应商 LLM 统一 API）、pi-tui（差分渲染终端 UI）。

关键内容

作者总结 pi-agent 的「三种身份」：替代 Claude Code 当 coding agent 用、作为结构清晰且能跑通的开源 Agent 学习样板、作为二次开发底座构建垂直 Agent（只换业务层，循环骨架与模型调用复用）。实操演示了用 ~/.pi/agent/models.json + ModelRegistry 接入智谱 GLM-4-Flash、DeepSeek 等国产模型（声明 base URL、API 协议、模型 ID、上下文窗口）；并用 createAgentSession、Skill、扩展（logger、memory、/analyze 命令）搭建数据查询 Agent。终端实机确认：pi 不内置 MCP 与子智能体，均可通过扩展或包实现。

可借鉴之处

• 「让 Pi 适应你的工作流，而非相反」的极简 harness 理念，适合对照学习 Agent Loop、工具注册、扩展机制。
• 本地 JSON 声明多供应商模型配置的模式可直接复用到自己的 Agent 项目。

边界与风险

• 「比 DSH 好」「替代 Claude Code」均为作者主观判断，DSH 指向在证据中无法确认。
• OCR 噪声明显，模型名（如 deepseek-v4-flash/pro）疑有误读，需以官方文档核验。
• 视频为教学视角，生产可用性与安全性未验证，采用前应实测扩展生态与权限控制。