buchidonggua/dg-ai-notes
Pi-Agent SDK 的双语源码解读与实战教程，附配套代码和 AI 开发助手 skill。
- Star
- 3,422
- Fork
- 271
- 未关闭 Issue
- 21
- 最近提交
- 2个月前
这是什么？
本仓库是 Pi-Agent 的学习资料。Pi-Agent 是一个用于构建生产级 AI Agent 的开源 SDK，也是 OpenClaw 等 Agent 产品的底层框架。源码解读部分共 10 章，涵盖三层架构、Agent Loop、工具与消息系统、事件驱动、上下文工程和会话管理，同时提供 TypeScript 与 Python 两个版本。
实战部分以企业数据分析助手 DataAgent 为例，从环境部署、模型接入、系统提示词、工具定义、事件监听讲到封装成服务，配套 7 组代码，可用 npm install 直接运行。仓库还提供一个与教程同步维护的 skill，可装入 Claude Code、Codex 等智能体，用于辅助编写 pi-agent 代码。
内容可通过在线电子书、本地 Markdown 文件和 PDF 版本阅读。代码采用 MIT 协议，文档采用 CC-BY-SA-4.0 协议。
核心功能
- 01Pi-Agent 源码解读共 10 章，提供 TypeScript 与 Python 双版本
- 02从零搭建可部署数据分析 Agent 的实战教程
- 037 组配套代码，npm install 后即可运行
- 04可单步运行的 Agent Loop Jupyter 实验
- 05可装入编程助手的 skill，与 pi-coding-agent v0.83.0 API 同步
适用场景
- 学习生产级 Agent SDK 的循环、工具与会话设计
- 基于 Pi-Agent 搭建企业内部定制 Agent
- 让 AI 编程助手根据需求直接编写 Pi-Agent 代码
快速上手
- 1
在线阅读教程
- 2
下载 dg-piagent skill 文件夹到你的智能体 skills 目录
- 3
安装配套代码的依赖
npm install
使用前须知
- 这是教程和源码解读，不是可独立运行的应用。
- README 主要以简体中文撰写。
- 文档采用 CC-BY-SA-4.0 许可，要求衍生作品以相同条款开源。
标签
常见问题
- dg-ai-notes 是什么？
- Pi-Agent SDK 的双语源码解读与实战教程，附配套代码和 AI 开发助手 skill。 本仓库是 Pi-Agent 的学习资料。Pi-Agent 是一个用于构建生产级 AI Agent 的开源 SDK，也是 OpenClaw 等 Agent 产品的底层框架。源码解读部分共 10 章，涵盖三层架构、Agent Loop、工具与消息系统、事件驱动、上下文工程和会话管理，同时提供 TypeScript 与 Python 两个版本。
- dg-ai-notes 可以免费使用吗？用的什么许可证？
- dg-ai-notes 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
- dg-ai-notes 还在维护吗？
- 半年内有更新。dg-ai-notes 最近一次提交是在 2026年8月23日。
- dg-ai-notes 适合用来做什么？
- 学习生产级 Agent SDK 的循环、工具与会话设计 基于 Pi-Agent 搭建企业内部定制 Agent 让 AI 编程助手根据需求直接编写 Pi-Agent 代码
- dg-ai-notes 怎么安装和运行？
- 在线阅读教程 下载 dg-piagent skill 文件夹到你的智能体 skills 目录 安装配套代码的依赖: npm install
- 在哪里获取 dg-ai-notes？
- 源代码和安装说明在 GitHub 上：https://github.com/buchidonggua/dg-ai-notes
概要由 AI 根据项目 README 生成；GitHub 数据每日更新。
相关项目
一本中文教材，沿 15 个可运行的 Git checkpoint，用 TypeScript 从零实现 Pi 风格的编程 Agent。
一个分步骤的 Go 教程，带你基于 Claude API 从零构建一个编程智能体，逐步加入文件、命令和代码搜索工具。
开源通用 AI Agent 框架，可通过终端运行由大模型驱动的智能体，支持工具调用、MCP 与浏览器自动化。
可自托管的 Python 个人 AI 智能体框架，提供浏览器 WebUI、终端客户端、聊天应用接入、记忆与 MCP 支持。
一款开源终端编程智能体 CLI，可接入云端 API 和 Ollama 等本地模型。