[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-79667":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":10,"languages":10,"totalLinesOfCode":10,"stars":11,"forks":12,"watchers":13,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},79667,"how-pi-agent-works","cellinlab\u002Fhow-pi-agent-works","cellinlab","Pi Agent 原理与实现","https:\u002F\u002Fhow-pi-agent-works-teaching-agent.vercel.app",null,354,26,1,0,6,28,219,80.29,"MIT License",false,"main",true,[],"2026-06-12 04:01:25","# Pi Agent 原理与实现：从零到一实现一个 AI Agent\n\n这是一个完整可运行的中文 VitePress 教程项目，参考 [earendil-works\u002Fpi](https:\u002F\u002Fgithub.com\u002Fearendil-works\u002Fpi) 与 [pi.dev 官方文档](https:\u002F\u002Fpi.dev\u002Fdocs\u002Flatest)，从工程视角拆解 Pi Agent 的核心原理，并带你实现一个教学版 Agent。\n\n教程不是逐文件源码翻译，而是按学习路径组织：\n\n- 核心概念：Agent Loop、消息、流式事件、工具调用、会话树、上下文压缩。\n- Pi 源码拆解：`pi-ai`、`pi-agent-core`、`pi-coding-agent` 的分层和关键链路。\n- 渐进式 Demo：四个核心 TypeScript 小 Demo 从最小循环逐步加工具、会话和压缩，另有一个可选真模型烟测 Demo。\n- 最终项目：React + Node.js + TypeScript 实现一个可运行的教学版 Agent。\n\n## 运行教程站点\n\n```bash\nnpm install\nnpm run docs:dev\n```\n\n构建验证：\n\n```bash\nnpm run docs:build\n```\n\n## 部署教程站点到 Vercel\n\n本仓库默认部署 VitePress 教程站点，配置见 `vercel.json`：\n\n- Install Command：`npm install`\n- Build Command：`npm run docs:build`\n- Output Directory：`docs\u002F.vitepress\u002Fdist`\n\n本地已登录 Vercel CLI 时，可以执行：\n\n```bash\nnpx vercel deploy --prod\n```\n\n教学版 Agent 的 Express API 仍是本地教学运行时，不随这个静态站点配置一起部署。\n\n## 运行渐进式 Demo\n\n```bash\nnpm run demo:01\nnpm run demo:02\nnpm run demo:03\nnpm run demo:04\n```\n\n可选真实模型烟测：\n\n```bash\nOPENAI_COMPATIBLE_BASE_URL=\"https:\u002F\u002Fexample.com\u002Fv1\" \\\nOPENAI_COMPATIBLE_API_KEY=\"你的 key\" \\\nOPENAI_COMPATIBLE_MODEL=\"mimo-v2.5-pro\" \\\nnpm run demo:05\n```\n\n请只通过环境变量传入 API Key，不要把密钥写进仓库。\n\n## 运行教学版 Agent\n\n```bash\nnpm run teaching-agent:dev\n```\n\n默认地址：\n\n- 前端：`http:\u002F\u002Flocalhost:5174\u002F`\n- API：`http:\u002F\u002Flocalhost:4317\u002F`\n\n也可以单独检查：\n\n```bash\nnpm run teaching-agent:test\nnpm run teaching-agent:typecheck\nnpm run teaching-agent:build\n```\n\n## 项目结构\n\n```text\ndocs\u002F                         # VitePress 教程站点\nexamples\u002Fdemos\u002F                # 四个核心渐进式 Demo + 可选真模型烟测\nexamples\u002Fteaching-agent\u002F       # React + Node 教学版目标项目\nspecs\u002F                         # 项目计划与工作日志\n```\n\n## 联系我\n\nHi，我是 Cell 细胞。可以扫码加我微信，备注 **Github** 就行。\n\n我正在做订阅制真人秀 **造物矩阵·BIP**：👉 [zwjz.flowus.cn](https:\u002F\u002Fzwjz.flowus.cn)，欢迎订阅。\n\n社媒更新：👉 [X \u002F Twitter @cellinlab](https:\u002F\u002Fx.com\u002Fcellinlab)\n\n更多信息：👉 [Cell 的个人说明书](https:\u002F\u002Fchaojizhizao.feishu.cn\u002Fwiki\u002FGbm8wMdS1itpk7kIVRlcN2WCnw)\n\n\u003Ctable align=\"center\">\n  \u003Ctr>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\".\u002Fpublic\u002Fwetouch\u002Fwechat.webp\" alt=\"Cell 细胞微信二维码\" width=\"200\">\u003Cbr>\n      \u003Cp align=\"center\">扫码加微信\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\".\u002Fpublic\u002Fwetouch\u002Fwechat-channels.webp\" alt=\"Cell 细胞微信视频号二维码\" width=\"200\">\u003Cbr>\n      \u003Cp align=\"center\">视频号\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\".\u002Fpublic\u002Fwetouch\u002Fwechat-official.webp\" alt=\"Cell 细胞微信公众号二维码\" width=\"200\">\u003Cbr>\n      \u003Cp align=\"center\">公众号\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## 赞助\n\n\u003Ctable align=\"center\">\n  \u003Ctr>\n    \u003Ctd align=\"center\" width=\"50%\">\n      \u003Cimg src=\".\u002Fpublic\u002Fsponsor\u002Fzfb.webp\" alt=\"支付宝二维码\" width=\"200\">\u003Cbr>\n      \u003Cp align=\"center\">支付宝\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"50%\">\n      \u003Cimg src=\".\u002Fpublic\u002Fsponsor\u002Fwx.webp\" alt=\"微信赞赏二维码\" width=\"200\">\u003Cbr>\n      \u003Cp align=\"center\">微信赞赏\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## License\n\nMIT\n","这个项目是一个从零到一实现AI Agent的中文VitePress教程，旨在帮助开发者理解并构建类似Pi Agent的系统。它详细解析了Agent Loop、消息处理、流式事件等核心概念，并通过四个渐进式的TypeScript示例逐步展示如何添加工具调用、会话管理和上下文压缩等功能。此外，还提供了一个使用React和Node.js编写的完整教学版Agent。该项目适合希望深入了解AI Agent工作原理及其实际应用的开发人员学习和参考。",2,"2026-06-11 03:58:12","CREATED_QUERY"]