正在打开每日关注
正在打开每日关注
用交互式文章和逐行 Trace，从零拆解并实现一个可读写、改码、执行命令的 TypeScript coding agent。
前段时间看了 @QuantumTransf 老师的 pi-agent book(https://t.co/tEE7aiTPjD)，写得很好，pi 的每一个设计细节都拆得很透。如果你喜欢系统性地啃一个东西，这本书是很好的选择。 但我个人读这种蓝皮书很难保持兴奋。我得在造的过程中学，光读不写我会坐不住。 但是直接看PI的源码容易给搞晕，太多工程细节了。 所以我把 pi 砍到只剩 600 行，写了一篇叫 PI-from-Scratch 的文章（对，他只是一篇文章，你花半天就能看完） 我做了一个小巧思，文章右边有一个代码编辑器，读到哪段，那段的代码就浮现出来，走完整个过程，一个完整的nano pi 就做好了。 全程每一个组件都是需求得来的，我需要他，所以我创造了他，非常符合直觉。 希望大家在创造出属于你自己的pi-agent之后，能找回当初第一次输出hello world的兴奋感😄 同时因为我在古法时代编程喜欢逐行断点debug，所以在这里特地设计了一个trace跟踪，可以逐行过代码，希望能帮助大家理解代码执行流。 在这里和大家保证，文字基本上手敲，ai味非常淡！ 学完再看 @QuantumTransf 老师的书或者直接去看 pi 源码，一切都变得很好懂。 BTW， 可能PI-from-scratch会是一个文章系列，以后我们会把pi的各类 components 挨个作为一篇小文章拓展到nanopi上。 github repo: https://t.co/iUWQJpSDLJ 在线读: https://t.co/RD5EJaa9zk
是什么 这是 SaladDay/pi-from-scratch：一个以文章为载体的 TypeScript 教学项目，用约 600 行代码从零实现可读文件、改代码、执行命令的迷你 coding agent。仓库根目录用于运行 nano-pi，web 目录用于运行教学网站；元数据显示项目已有 1,140 Stars，创建于 2026-08-09，最近提交于 2026-08-18。
核心设计 内容链路是“先降低复杂度—按需求引入组件—边读边补全源码—用 Trace 逐行观察执行流—再回到 pi 书籍或原始源码”。网站将文章与源码并置，阅读推进时逐步显现代码，形成代码、解释和运行轨迹的联动式学习体验。
关键洞察 最值得借鉴的是把系统学习拆成可运行的最小闭环：每个组件都有明确需求，代码规模受控，执行轨迹帮助把静态文本连接到运行时行为。对 Agent 工程师而言，它适合建立模型调用、工具调用和执行流的基础心智模型。
边界与风险 README 只确认了文件读取、代码修改、命令执行及 OpenAI 兼容接口，不能据此推断其具备生产级安全隔离、权限治理、复杂上下文管理或完整 pi 特性。600 行实现更适合教学和原理验证；本地运行需要 API key，线上 Trace 是预生成静态数据，不代表网页会实时调用模型。