dg-ai-notes

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 现代浏览器（直接在线阅读 MDX 电子书）
• Node.js 与 npm（运行 L01–L07 配套示例代码）
• 可运行 Jupyter 的 Python 环境（打开 agent-loop.ipynb 实验场）

安装与启动步骤

1. 1在线阅读教程

   不安装也能学：打开在线电子书即可阅读双轨教程，支持深浅色主题切换。

2. 2克隆仓库

   把教程、配图与 7 组配套代码拉到本地，注意仓库含图片资源体积较大。

   git clone https://github.com/buchidonggua/dg-ai-notes.git

   复制

3. 3进入代码目录

   切换到实战案例的配套代码目录，L01–L07 示例都在这里。

   cd dg-ai-notes/pi-agent/pi_sdk_learn/code

   复制

4. 4安装示例依赖

   在具体示例目录中安装依赖，README 称 npm install 后即可运行。

   npm install

   复制

5. 5打开实验场

   用 Jupyter 打开 pi-agent/notebooks/agent-loop.ipynb，可单步运行 Agent Loop 并随意改参数。

6. 6对照双版本源码

   阅读 pi_source_dive 下的 TypeScript 与 Python 两个目录，10 章理解生产级 Agent SDK 设计。

如何确认成功

访问 dg-ai-notes.pages.dev 能正常翻页阅读；npm install 无报错且对应示例可运行起来。

常见问题

注意事项

• README 未提供完整安装文档，上述步骤依据仓库目录与说明整理，具体以在线版为准。
• 克隆仓库时注意包含 30+ 配图资源，网络较慢可使用代理或直接在线阅读。
• 配套代码共 7 组（L01–L07），运行前请确认 Node.js 与 npm 已正确安装。
• dg-piagent skill 的 API 核对到 pi-coding-agent v0.83.0，使用时注意版本差异。