deerwork-ai
精选
deer-workflow
An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.
AI 仓库情报摘要
FR-AI / ANALYSIS为什么值得关注
所有实现都来自真实产品（Reina）而非 API 文档推测；超过 23 个机制都配有可直接运行的极简 demo，仅需 Node 18 且无其他依赖。
适合谁使用
- 正在构建或扩展 coding agent 的开发者
- 希望优化 agent 工具链和上下文管理的工程师
- 研究实用 agent 架构的学生和研究人员
- 准备 agent 方向技术面试的候选人
典型使用场景
- 从零学习如何搭建完整的 agent 循环（s01–s12）
- 实现特定机制如工具系统、上下文压缩、提示缓存等
- 通过 agent_analysis/ 对比不同 agent（pi、Kimi CLI）的设计决策
- 使用 interview/ 目录中的题目进行面试练习
项目优势
- 零依赖、单文件 demo，Node 18+ 即可运行，无需额外配置
- 来自 Reina 真实生产代码，非理论推测
- 覆盖从基础循环到高级问题（如缓存与压缩冲突）的 23 个主题
- 包含对其他流行 agent 的源码分析，便于交叉验证
使用前须知
- 需要 Node 18+ 环境，大多数 demo 需要兼容 OpenAI 的 API key（部分无需 key）
- 主要聚焦于 coding agent，未必适用于其他类型的 agent
- 仍在持续更新中，部分章节（如面试题系列）尚未完成
README 快速开始
learn-agent · AI Agent 开发笔记
简体中文 · English
开发桌面 agent Reina 过程中记下的笔记，讲 coding agent（Claude Code、Codex、opencode 这类工具）的内部实现机制。每篇讲一个机制，把 Reina 里的生产实现简化成零依赖、单文件、可直接运行的 Node 程序——所以这些做法不是照 API 文档推想的，是实际产品里验证过的。
仓库分三块：notes/ 是正篇笔记（s01–s23，每篇一个机制，配可运行 demo）；agent_analysis/ 是其他 agent（pi、Kimi CLI）的源码调研档案，笔记从这里取材；interview/ 是从笔记整理的面试题（连载中）。
运行
Node 18+，零依赖：
git clone https://github.com/7-e1even/learn-agent && cd learn-agent
AGENT_API_KEY=sk-xxx node notes/s01_agent_loop/agent.mjs
任何 OpenAI 兼容的 API key（DeepSeek / Kimi / GLM / OpenRouter / 本地 Ollama）都行；没有 key 的话，多数章节的 demo.mjs 和 s12 的自测模式不需要 key。
clone 之后可以一键验证所有免 key 的示例：node selftest.mjs——20 个章末 demo 加 s12 的整合自测，十几秒跑完。
目录
s01–s12 从零搭出一个完整可用的 agent，按顺序读；s13 之后是开发 Reina 时陆续踩到、记下来的边界问题，挑感兴趣的读。每篇结尾附 Reina 中对应生产实现的位置。
| # | 主题 | 要解决的问题 |
|---|---|---|
| s01 | Agent 主循环 | 最小可用的 agent 长什么样 |
| s02 | 工具系统 | 工具越加越多，怎么不用每次都改循环 |
| s03 | 循环预算与纠偏 | 模型原地打转、反复报错，怎么发现并拉回来 |
| s04 | 工具输出预算与溢出 | 一条 cat 的输出就能撑爆上下文，怎么办 |
| s05 | 流式输出与中断 | 用户按下 Ctrl+C，断在一半的消息记录怎么修 |
| s06 | 上下文压缩 | 上下文满了要压缩，怎么不忘掉最初的任务 |
| s07 | Prompt 缓存 | 同样的对话，为什么有人的账单贵 10 倍 |
| s08 | 会话持久化与恢复 | 进程崩了，跑了半小时的会话怎么接着跑 |
| s09 | 子代理与看门狗 | 子任务卡死了，怎么发现它并保住已完成的部分 |
| s10 | System prompt 组装 | system prompt 越写越长，怎么按需拼装 |
| s11 | 多 agent 协作 | 几个 agent 同时干活，怎么分工不重复不冲突 |
| s12 | 完整 agent 整合 | 前面所有机制装回一个循环里是什么样 |
| s13 | 权限与审批 | 模型要执行 rm -rf，怎么在动手前拦住 |
| s14 | Provider 兼容层 | 换个模 |
项目描述
从零写一个能活下来的 AI Agent：机制从真实产品 Reina 移植 | Build a coding agent from scratch — how Claude Code / Codex / Cursor actually work under the hood. 15 runnable lessons, zero deps.
相关仓库与替代方案
根据分类、Topic 和编程语言匹配的相似项目。
makecindy
精选
cindy
Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.
0xwilliamortiz
精选
openclaude-improved
OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.