600行代码手写一个AI编程助手：零基础搞懂PI-Agent核心原理

你是否好奇，那些能读代码、改文件、执行命令的AI编程助手（比如pi、Cursor、Windsurf）底层到底是怎么工作的？SaladDay团队推出的「PI from Scratch」项目，用仅600行TypeScript，从零带你手写一个极简但功能完整的Coding Agent——它不是玩具，而是真正遵循PI架构思想、可运行、可调试、可扩展的AI代理原型。没有黑盒封装，不依赖复杂框架，只用最直觉的代码，帮你撕开LLM智能体的“神秘外衣”。

核心功能

• 完整Agent循环（Agent Loop）：实现标准的Plan → Tool Call → Observe → Reflect四步闭环，清晰展现AI如何自主拆解任务并迭代执行
• 真实工具调用能力：内置文件读写（readFile/writeFile）、终端命令执行（execCommand）、代码编辑（patchFile）三大实用工具，支持真实环境交互
• 可交互式学习体验：配套教学网站将文章与代码编辑器联动——你逐段阅读时，右侧编辑器同步补全代码，读完即写出完整nano-pi
• 可视化执行追踪（Trace）：内置断点调试模式，每一步模型输出、工具调用、状态更新都可展开查看，彻底告别“AI在想什么”的困惑
• OpenAI兼容接口设计：支持任意兼容OpenAI API的LLM服务（如Claude Code、Qwen、DeepSeek等），无需修改核心逻辑即可切换模型
• 零配置快速验证：本地启动后即可直接与Agent对话（例如：“把README.md里的‘600行’改成‘不到600行’”），5分钟内看到AI动手改代码

适合哪些人用

如果你是：
• 刚入门AI Agent开发的前端/全栈工程师——厌倦了被LangChain、LlamaIndex等大框架淹没，想先看清“Agent到底长什么样”；
• 高校学生或技术爱好者——希望用最小认知成本理解PI架构、Tool Calling、ReAct模式等核心概念；
• 教育者或技术讲师——需要一个结构清晰、注释友好、可演示可拆解的教学级代码范例；
• 对AI编程工具有强烈好奇心的开发者——不满足于只会用Cursor，更想亲手造一个属于自己的mini pi。
那么，这个项目就是为你而生的“第一块积木”。

快速上手

只需三步，10分钟跑起来：

1. 准备环境：安装 Node.js 22+（推荐v22.14.0），确保系统已安装Git
2. 获取项目：git clone https://github.com/SaladDay/pi-from-scratch.git && cd pi-from-scratch
3. 启动Agent：npm install && export NANOPI_API_KEY=sk-xxx && npm run dev（替换为你的OpenAI或兼容API密钥）

打开 http://localhost:3000 即可与nano-pi对话。想边学边写？访问 在线教学网站，文章+实时编码+Trace调试三位一体，沉浸式掌握Agent构建逻辑。

项目信息

编程语言：TypeScript｜Star 数：471｜开源协议：MIT｜GitHub 项目地址

这不是又一个“教你调API”的教程，而是一次真正的“手写操作系统内核式”学习体验——当你亲手敲完第600行，你会真正相信：AI Agent，原来真的可以这么简单、透明、可控。