知了 zhiliao：AI Agent 教学框架完整源码

这个包是什么

《AI Agent 从零到一》10 篇教程的配套可运行源码，0 元、免下单、点下载直接拿 zip。教程讲"为什么这么写"，这个包给你"写完长什么样"：核心循环、工具、记忆、RAG、技能、Web 界面、多 Agent 协作，每一篇对应包里的一个模块，可以逐篇对照着读代码。

里面有什么

zhiliao/
  agent/          核心循环（思考-行动-观察）、LLM 适配、记忆、RAG、技能、组装
  tools/          内置工具：代码执行、文件读写、网页搜索，以及工具注册表
  web/            FastAPI 服务与单页聊天界面
  skills/         示例技能：周报、英文润色等，Markdown 即技能
  knowledge/      示例知识库文档，供 RAG 检索
  tests/          基础测试
  main.py         CLI 入口
  Dockerfile / requirements.txt / .env.example

怎么跑

1. pip install -r requirements.txt（只用 CLI 可以不装 fastapi/uvicorn）；
2. cp .env.example .env，填一个 OpenAI 兼容接口的 API Key：智谱 GLM、DeepSeek、本地 Ollama 都行；
3. python main.py 进命令行版；要网页版就 uvicorn web.server:app 后打开提示的地址。

边界说清楚

• 包内不含任何密钥、不含模型权重，.env.example 只是模板，运行前自备 Key 并遵守相应服务商条款；
• 这是教学实现：单进程、内存/本地文件存储为主，接口与并发都按"读得懂"优先，上生产请自行加固；
• 网页搜索工具有无依赖的兜底实现，不装可选依赖也能跑；
• 供学习与研究自由使用、修改、转发。

更新记录

• v1.1：知识库与技能正式注册为工具（build_registry(cfg, rag, skills)，旧版这两类能力装不进工具表）；Web 版每个会话克隆注册表以绑定各自的记忆工具；代码执行子进程统一 UTF-8（修中文 Windows 下管道输出乱码）；会话存档同名时自动加序号；长对话滚动摘要；新增核心循环集成测试 tests/test_agent_loop.py（FakeLLM 剧本式模拟，无需 API Key 即可跑）。
• v1.0：首版，与教程 10 篇一一对应。

配套阅读

合集《AI Agent 从零到一：知了 zhiliao 实战》共 10 篇，从"什么是 Agent"讲到部署上线与学习路线图：/collections/ai-agent-zhiliao/