Goose 源码学习
开源可扩展 AI Agent：不止代码建议，还能动手执行任务。这不是 API 速查表，而是一条可以重复走的源码路线：每天用 30 分钟，从一个真实相对路径出发，先用类比建立直觉，再把它接回整条运行链路。
开篇 · 这是个什么项目
Goose 可以先想成一间可扩展本地 Agent。它的代码不是一堆孤立文件：入口接到需求，核心对象做判断，工具或模型完成工作，状态把结果交给下一个环节。
架构全景（动起来看）
发光扫过的每一层都是一次任务可能经过的站点。不同仓库命名不同，但「接入 → 编排 → 核心能力 → 资源」的责任边界很相似。
怎么使用这份教程
每天 30 分钟
6 讲，每讲先问问题，再给本质和大白话。
真实相对路径
所有路径都从项目根目录算，不把你的机器路径写进源码引用。
先验证再推理
每页都有可复制 bash 命令；文件版本变化时以本地实际内容为准。
可迁移方法
学会从入口、数据结构、循环和扩展点读任何 AI 项目。
从 README.md 认识项目大门
README.md：围绕 README.md 建立因果链：谁调用、处理什么、交给谁；对应阶段是「入口与地图」。
配置与依赖：Cargo.toml
Cargo.toml：围绕 Cargo.toml 建立因果链：谁调用、处理什么、交给谁；对应阶段是「入口与地图」。
顶层入口与启动路径
crates：围绕 crates 建立因果链：谁调用、处理什么、交给谁；对应阶段是「入口与地图」。
核心对象：agents
crates/goose/src/agents：围绕 crates/goose/src/agents 建立因果链：谁调用、处理什么、交给谁；对应阶段是「核心循环」。
运转循环里的 agent.rs
crates/goose/src/agents/agent.rs：围绕 crates/goose/src/agents/agent.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「核心循环」。
协作主线穿过 container.rs
crates/goose/src/agents/container.rs：围绕 crates/goose/src/agents/container.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「核心循环」。
能力模块：index.ts
services/ask-ai-bot/utils/ai/tools/index.ts：围绕 services/ask-ai-bot/utils/ai/tools/index.ts 建立因果链：谁调用、处理什么、交给谁；对应阶段是「核心能力」。
业务动作落在 index.tsx
documentation/src/pages/skills/index.tsx：围绕 documentation/src/pages/skills/index.tsx 建立因果链：谁调用、处理什么、交给谁；对应阶段是「核心能力」。
把任务交给 final_output_tool.rs
crates/goose/src/agents/final_output_tool.rs：围绕 crates/goose/src/agents/final_output_tool.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「核心能力」。
扩展点附近的 platform_tools.rs
crates/goose/src/agents/platform_tools.rs：围绕 crates/goose/src/agents/platform_tools.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「核心能力」。
状态如何进入 memory
crates/goose-mcp/src/memory：围绕 crates/goose-mcp/src/memory 建立因果链：谁调用、处理什么、交给谁；对应阶段是「状态与协作」。
消息与协作：mod.rs
crates/goose-mcp/src/memory/mod.rs：围绕 crates/goose-mcp/src/memory/mod.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「状态与协作」。
持久化视角下的 session
crates/goose-cli/src/session：围绕 crates/goose-cli/src/session 建立因果链：谁调用、处理什么、交给谁；对应阶段是「状态与协作」。
模型侧连接：server.rs
crates/goose/src/config/signup_openrouter/server.rs：围绕 crates/goose/src/config/signup_openrouter/server.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「模型与扩展」。
工具/MCP 桥：server.rs
crates/goose/src/config/signup_tetrate/server.rs：围绕 crates/goose/src/config/signup_tetrate/server.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「模型与扩展」。
检索与知识：server.py
examples/mcp-wiki/src/mcp_wiki/server.py：围绕 examples/mcp-wiki/src/mcp_wiki/server.py 建立因果链：谁调用、处理什么、交给谁；对应阶段是「模型与扩展」。
集成层：mcp.rs
crates/goose-mcp/examples/mcp.rs：围绕 crates/goose-mcp/examples/mcp.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「模型与扩展」。
样例与复盘：server.rs
crates/goose/tests/acp_fixtures/server.rs：围绕 crates/goose/tests/acp_fixtures/server.rs 建立因果链：谁调用、处理什么、交给谁；对应阶段是「复盘与扩展」。
测试与边界：index.ts
ui/desktop/src/components/settings/extensions/index.ts：围绕 ui/desktop/src/components/settings/extensions/index.ts 建立因果链：谁调用、处理什么、交给谁；对应阶段是「复盘与扩展」。
收官：沿 pyproject.toml 串回全图
examples/mcp-wiki/pyproject.toml：围绕 examples/mcp-wiki/pyproject.toml 建立因果链：谁调用、处理什么、交给谁；对应阶段是「复盘与扩展」。