dg-ai-notes README

The project's README from github.com/buchidonggua/dg-ai-notes. As one markdown file: README.md.

Pi源码解读和二次开发实战

🌐 在线阅读：dg-ai-notes.pages.dev —— 双轨教程 · 沉浸式阅读 · 深浅色主题

在线电子书首页

🤔 Pi-Agent 是什么？为什么值得学？

Pi-Agent 是 @earendil-works 开源的 Agent SDK，定位是生产级 AI Agent 的运行时底座——也是 OpenClaw 这类 Agent 产品的底层框架。

它不是玩具框架：Claude Code、Cursor、Cline 等同类产品的内部架构，都能在 Pi 里找到对应实现。Agent Loop、工具系统、消息系统、事件驱动、会话管理、扩展机制——一个 Agent SDK 该有的东西它都有。看懂 Pi，等于看懂一个完整的 Agent SDK 应该怎么设计。

🎯 三大内容，总有一个你用得上

🔬 源码解读 · 10 章拆完一个生产级 SDK

不是贴代码加注释，而是每章回答「是什么 / 怎么做 / 为什么」：从三层架构、Agent Loop 一路讲到上下文工程、会话管理，把 Pi 的设计取舍讲透。TypeScript + Python 双版本对照，30+ 配图，还配了一个可单步运行、随便改参数的 Agent Loop 实验场。

怎么读：TS 版目录 · Python 版目录 · 在线版 · PDF 下载

🚀 实战案例 · 7 章搭一个能上线的 Agent

拿真实场景（企业数据分析助手 DataAgent）从零开始：环境部署 → 模型接入评估 → 系统提示词 → 定义工具 → 事件监听 → 封装成服务。讲的是「改哪一层、为什么这样接」，7 组配套代码（L01–L07）npm install 即跑——跟着敲完，你手里就有一个能部署的垂直 Agent。

怎么学：教程目录 · 配套代码 · 在线版

🧩 Skill 应用 · 让你的 AI 助手秒懂 pi-agent

dg-piagent 是与教程同步维护的 SDK 开发助手 skill（API 核对到 pi-coding-agent v0.83.0）。它从两个视角装订成册：SDK 功能视角可当官方文档查，场景应用视角可当学习手册翻。装进智能体后，写 pi-agent 代码不用再翻文档——你只管提需求，AI 查 skill 完成开发。

快速上手示例（装好后对 AI 直接说人话）：

你说 AI 做
"使用 dg-piagent skill，开发一个 DataAgent：web 应用、数据自己造、拦截危险 SQL" 按需求匹配场景、查 SDK 用法，从零搭环境到跑通一步到位
"使用 dg-piagent skill，根据这份模型接口文档生成模型配置" 判断内网模型能否接入 pi-agent（缺哪些参数、如何绕过），直接输出一份可用的模型配置文件
"使用 dg-piagent skill，帮我实现 XX 功能，没有设计思路" 搜索社区同类扩展、自行解读源码，结合你的项目给出一套设计方案

skill 里还沉淀了作者踩过的坑与最佳实践（比如工具报错时把原因和解决办法封装成结果交还模型自行纠错），AI 会照着这些经验做设计，比让它自己搜网上的零散文档靠谱。

怎么装：下载 skills/dg-piagent/ 文件夹，放进你所用智能体的 skills 目录即可——Claude Code / ZCode / Codex / pi 通用，无需其他配置，详见安装说明。

🗺️ 全部章节目录与推荐阅读路径（先实战上手、再源码精读），见 Pi-Agent 教程 README。

📺 配套讲解视频

不想干读文字？B 站有视频版：

📚 三种阅读方式

方式 入口 适合场景
🌐 Web 在线版（推荐） https://dg-ai-notes.pages.dev PC 端沉浸式阅读，双轨切换 + 深浅色主题
📥 Markdown 下载版 pi-agent/ 目录下两系列 下载到本地，配合 AI 边读边问、对照源码
📕 PDF 版 Releases 离线阅读、打印、长期存档（源码精读篇）

🤝 贡献

发现 typo / 内容错误？欢迎：

详见 CONTRIBUTING.md。

📜 License

👋 关于作者

大家好，我是冬瓜，一个热衷于拆解 AI 工程的博主

如果你觉得内容有帮助，欢迎关注，一起交流 AI / Agent / LLM 的工程实践——

冬瓜的抖音二维码
抖音 · 冬瓜
AI 技术科普 · 源码拆解 		冬瓜的 B 站二维码
B 站 · 冬瓜
长视频教程 · 直播 coding

🙏 Acknowledgments

dg-ai-notes (buchidonggua/dg-ai-notes)

Searching Database…

3.4K ·GitHub
Dg-ai-notes
这是什么？一个深度剖析的学习笔记项目（一本书），逆向解析 Pi-Agent SDK——OpenClaw 背后的运行时，架构与 Claude Code、Cursor 和 Cline 的内部实现相似——并配有动手实战教程和一个现成的 AI 技能。
这是一本书、代码库，还是工具？它主要是一份双语图文教程（分 TypeScript 和 Python 版本，含 30 多张图），涵盖源码解析和一个可运行的实战项目，外加一个可安装的“skill”包，可以放进 AI 编程智能体——不是独立应用。
我怎么阅读或使用它？可以在 dg-ai-notes.pages.dev 在线阅读，从 pi-agent/ 文件夹下载 Markdown 文件，或从 Releases 获取 PDF；要走实战路线，就先 npm install 再运行 L01-L07 的课程代码。
哪些编程智能体能用 dg-piagent 技能？该技能适用于 Claude Code、ZCode、Codex 或 pi 本身——只要把 skills/dg-piagent/ 文件夹放进对应智能体的技能目录即可，无需其他配置。
这个技能会跟上真实 SDK 的更新吗？它与教程同步维护，并对照 pi-coding-agent v0.83.0 做过验证，但作为人工整理的摘要，可能会落后于全新的 SDK API 变更。
dg-piagent 技能到底能让我的 AI 智能体做什么？它从书中提炼出两个参考视图——SDK-API 视图和场景/操作指南视图——让你的智能体可以随查随用 Pi-Agent 的用法和最佳实践，而不用你自己去翻文档。
DataAgent 实战教程讲的是什么？一份 7 章（L01-L07）的完整实操指南，端到端构建一个真实的企业级数据分析智能体：环境搭建、模型评估、系统提示词、工具定义、事件监听器，以及把它打包成可部署的服务。
作者为什么不满足于用 Pi-Agent，反而为它的源码写了整本书？作者（冬瓜）想展示一个生产级 Agent SDK 究竟是如何设计的，因为 Pi 的内部架构与支撑 Claude Code、Cursor 和 Cline 的底层设计如出一辙。
这些内容有视频版吗？有。作者在 Bilibili（B 站）和抖音发布配套讲解视频，涵盖与书面书相同的源码拆解和技能构建主题。
What are similar projects?vibe-coding-cn, awesome-agent-skills, SwiftUI-Agent-Skill, source-reading-methodology, awesome-openclaw-tutorial, claude-code-book, lieflat-charts, harness-engineering
Which topics is it in?pi-agent, pi-coding-agent, mdx, book, skill, skills, guide, sdk, china, documentation, ai-agent, agent-skills
Creator
buchidonggua
Size
2 MB
Stars
3.4K
Updated
CommitAug 23Releasev1.0Jul 05
Age
3mo
Commits · 90 Days