Tau三层架构全解析tau_ai、tau_agent、tau_coding如何分离设计与实现【免费下载链接】tauA Python port of Pi’s minimalist coding agent.项目地址: https://gitcode.com/gh_mirrors/tau16/tauTau 是一个运行在终端里的 Python 编码智能体coding agent也是理解 AI 编程代理系统结构的绝佳教学项目。它的核心设计是把整个智能体拆成三个各司其职的包tau_ai负责对接模型tau_agent提供可复用的大脑tau_coding则把它包装成你真正会用的终端应用。这篇文章带你快速看懂这套三层架构的设计思路无需阅读大量代码。一张图看懂 Tau 的分层依赖Tau 的依赖方向只有一条单向链这也是整个项目最核心的约定tau_coding → tau_agent → tau_ai 编码应用 可复用大脑 模型接入用三句话概括各层的定位AgentHarness 可复用的大脑 CodingSession 编码代理的运行环境 TUI 众多前端中的一种官方架构文档对这个边界的定义非常干脆website/content/internals/architecture.md 中写道——可复用的智能体大脑对终端、文件路径和渲染一无所知所有应用相关的东西都包裹在它外面。设计笔记 dev-notes/design/01-architecture.md 同样规定了tau_agent禁止导入 CLI、Rich、Textual 等任何界面或应用层代码。tau_ai把各家模型统一成一条事件流最底层的 src/tau_ai/ 解决一个实际问题不同模型厂商的 API 各不相同OpenAI、Anthropic、Google、Mistral、OpenAI Codex、OpenAI 兼容端点等而上层不应该关心你用的是哪家的模型。tau_ai做的事情就是翻译内置多家供应商的 Provider 实现如 src/tau_ai/anthropic.py、src/tau_ai/google.py、src/tau_ai/openai_compatible.py把各家流式响应统一翻译成 Tau 的供应商中立事件文本增量、思考块、工具调用等定义见 src/tau_ai/events.py公共入口统一暴露在 src/tau_ai/init.py 中上层只需从这里导入 对新手而言记住一点就够了tau_ai是接线员它让上层的智能体永远只面对同一种事件格式换模型厂商时几乎不用改上层代码。tau_agent与界面彻底解耦的可复用大脑中间的 src/tau_agent/ 是整个项目的精华它拥有智能体的全部思维部件模块职责src/tau_agent/messages.py消息与内容类型用户消息、助手消息、工具调用、思考块、用量统计src/tau_agent/events.py智能体级事件回合开始/结束、消息更新、工具执行进度src/tau_agent/loop.pyAgent 循环提示 → 模型 → 工具 → 再提示src/tau_agent/harness.pyAgentHarness带状态的复用式智能体外壳src/tau_agent/tools.py工具即带 schema 的异步函数抽象src/tau_agent/session/会话原语条目、JSONL 存储、会话树AgentHarness的配置极其精简见 src/tau_agent/harness.py给它一个 provider、模型名、系统提示和工具列表它就吐出一条事件流harness AgentHarness(AgentHarnessConfig(provider..., model..., system..., tools...)) async for event in harness.prompt(Explain this package): ...注意它输出的是事件而不是界面。这正是 Tau 能在内置 TUI、打印模式print mode以及你自己写的前端之间共享同一个核心的原因。tau_coding把大脑装进终端应用最外层的 src/tau_coding/ 负责把它变成一个真正能跑的编码工具内容最多公共入口 src/tau_coding/init.py 导出了大量应用级组件️CLI 与 TUI交互式 Textual 界面在 src/tau_coding/tui/命令行入口见 src/tau_coding/cli.py️编码工具read/write/edit/bash四个内置工具定义在 src/tau_coding/tools.py会话落盘CodingSession把tau_agent的会话原语落到~/.tau/sessions/的 JSONL 文件支持恢复与分支⚙️模型配置供应商目录与凭据管理内置目录见 src/tau_coding/data/catalog.toml渲染层src/tau_coding/rendering/ 提供 Rich、纯文本、JSON、转写稿等多种事件渲染器✂️上下文压缩上下文窗口估算与压缩策略在 src/tau_coding/context_window.py为什么事件是整个架构的契约Tau 的设计哲学可以浓缩为一句话事件是契约。tau_ai 发射 模型流事件 tau_agent 加工 智能体事件回合、消息、工具执行 前端TUI / 打印模式 / 自建界面只负责消费事件这带来两个直接好处核心保持可移植智能体核心不依赖任何 UI 框架换终端框架甚至换语言前端都不受影响每层只回答一个问题读代码时你只需要在对应层内打转这正是 README.md 中所说的 Small layers beat magic小分层胜过魔法。新手阅读路线3 个入口就够如果你打算按顺序读源码建议从这三个入口切入先看架构约定dev-notes/design/01-architecture.md10 行讲清三层边界再看大脑src/tau_agent/harness.py理解prompt如何变成事件流最后看应用如何套壳src/tau_coding/session.py 中的CodingSession看大脑如何被环境、工具与渲染器包裹。总结三层分离带来的价值层一句话职责关键约束tau_ai模型接入与事件翻译不感知智能体逻辑tau_agent可复用智能体大脑禁止依赖 UI 与应用代码tau_coding终端编码应用只消费事件不反向侵入核心Tau 用一个非常克制的结构展示了编码智能体系统的完整形态接入层抹平厂商差异核心层沉淀可复用能力应用层专注用户体验。理解了tau_ai → tau_agent → tau_coding这条单向依赖链你就掌握了阅读大多数 coding agent 源码的钥匙。【免费下载链接】tauA Python port of Pi’s minimalist coding agent.项目地址: https://gitcode.com/gh_mirrors/tau16/tau创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
