agent-unpacked

August 14, 2026 · View on GitHub

来自于 Stellar鱼 的 Agent 源码拆解教程。

一个面向初学者的交互式学习网站，以源码证据为主线，逐层拆解 DeepSeek Harness、PI Agent、nanobot、Claude Code 第三方复原版与 OpenClaw：消息如何进入系统、上下文怎样组装、模型如何调用工具、状态怎样留下，以及这些能力最终如何组成完整产品。

在线阅读

教程内容

  • 拆 DSH：插件内核、会话即真源、轮次边界、能力替换、上下文持续与产品组装。
  • 拆 PI Agent：分层骨架、模型事件流、Agent Loop、工具控制、会话树与扩展机制。
  • 拆 nanobot：消息总线、执行循环、上下文、模型与工具、记忆和产品边界。
  • 拆 Claude Code（第三方复原版）：基于 claude-code-best/claude-code，分析 CLI 启动、QueryEngine、Agent Loop、模型流、工具权限、Prompt、Compaction、Transcript、React Ink 与插件。该仓库自述为逆向工程 / 反编译复原项目，不是 Anthropic 官方源码；仓库根目录目前没有许可证。
  • 拆 OpenClaw：Gateway、路由、Harness、embedded runner、agent-core、prepared runtime、会话与插件契约。
  • 横向对照：使用统一问题比较五套 Agent 架构的设计取舍。

全站包含 40 节课程。每节课程都提供：

  1. 面向小白的问题解释和生活类比；
  2. 关键术语的通俗说明；
  3. 可播放、暂停、点击和重播的运行流程动画；
  4. 教学示意代码与阅读顺序；
  5. 可跳转到对应源码仓库的代码证据；
  6. 架构定位、常见误区、动手练习和自测答案。

每条源码路线采用“总—分”结构：先通过路线总览理解核心设计理念、五种架构的根本区别、完整请求旅程、八课关系图和关键源码悬念，再进入单节课程逐层拆解。

本地运行

需要 Node.js 22 或更高版本。

npm install
npm run dev

生产构建：

npm test

静态产物生成在 out/，默认使用 /agent-unpacked 作为部署子路径。

EdgeOne Pages 根路径构建：

npm run build:edgeone

在 EdgeOne Pages 中将构建命令设为 npm run build:edgeone、输出目录设为 out，即可从站点根路径访问；普通 npm run build 仍保留腾讯云服务器的 /agent-unpacked 子路径。

参考项目

作者

教程策划与整理：Stellar鱼。

本项目用于源码学习与架构研究。相关项目的源码与商标归各自作者和组织所有。