正在整理你需要的资料…
别人讲 Agent 都是玄学,你却想知道它每转一圈上下文怎么变长、卡在哪。NamiAgent 是中文教程兼可运行实例:从 100 行的 while 最小循环起步,一课加一个能力 —— 读写文件、执行命令、MCP、长期记忆;第 3 课的权限确认拦住有副作用的操作,第 10 课让它先出计划再动手,网页端把每次思考和上下文摊开。
适合想搞懂 Agent 到底怎么跑起来、又不想一上来就啃 Claude Code 源码的初学者;这是教学代码,Agent 会真的执行命令和读写文件,工作区别指到主目录。
下面是把仓库 README 逐节读完后归纳出的中文要点。
面向零基础的 AI Agent 入门教程,同时也是能在本地跑起来、带网页端的示例 Agent,核心是调模型、执行工具再写回上下文的循环。
配套可视化按十章逐格播放 Agent 的运行过程,能看到上下文每转一圈如何变长、在哪一步出问题,以及各种技巧在上下文里起什么作用。
起步部分很简单:需要 Python 3.10 以上,先跑一遍不需要 API Key 的测试,确认环境可用后再继续。
网页端把每一步摊开:左侧显示模型调用与工具返回,右侧显示完整上下文与 token 占用;写文件、跑命令前需人工确认,可先让它出计划。
列出环境变量:API_KEY 必填,BASE_URL 指向兼容接口,MODEL 选模型,另有工作区与状态目录变量,后续课程还会用到机器人令牌与 MCP 配置。
提醒这是教学代码,Agent 会真的执行命令和读写文件;权限机制能挡住误操作,但挡不住有意攻击,别把工作区指向主目录。
| 主要语言 | Python | 许可 | MIT |
|---|---|---|---|
| 创建时间 | 2026-10-30 | 最近提交 | 2026-10-30 |
| 站内采集 | 2026-11-06 起,连续观察 13 天 | 最近一次 | 2026-11-18 |
最近 13 次采集
2026-11-06 387 ★ → 2026-11-18 541 ★ (累计 +154)
数据来自 GitHub 公开接口的每日采集快照,star 数为采集当时读到的值, 与 GitHub 页面上显示的实时数字可能有几分钟的差距。 项目名点击可回到 本页。