欢迎使用 tau τ——一个教你如何构建代理框架的教育型代理

我将发布教程和演示，介绍如何使用它创建你自己的 TUI、框架、扩展等。

祝大家 Tau 日快乐！！🤓

👉 https://t.co/5sWxNtXTZP https://t.co/uiViXChBbw

学习编码代理如何构建。

来源：https://twotimespi.dev/ τtauv0.1

一个教育型编码代理项目

Tau是一个你可以像读教科书一样阅读的小型 Python 编码代理。观察它流式输出模型、调用工具、管理会话，并逐步成长为终端用户界面——每次只增加一个可读的层次。

没有隐藏的机制。每个活动部件都在页面上显现。

θ 扫过 0 → τθ = 0.00 学习代理架构

阅读小型 Python 层次

运行一个真实的终端代理

01

一个以课程形式呈现的编码代理

Itau_ai

模型变为流

提供者适配器将模型响应转换为代理其他部分使用的提供者无关事件。

IItau_agent

代理循环

可复用的框架：消息、工具、转录状态、取消、排队提示、会话。

IIItau_coding

变得实用

编码环境：文件、外壳、持久会话、技能、斜杠命令以及一个 Textual TUI。

课程内容

每个活动部件都可见。

Tau 回答了那些教程跳过的问题：代理循环到底是什么？工具调用从何而来？转录如何增长？会话如何在进程退出后存活？

模型流令牌（token）、工具请求、思考增量

↓

事件流各层之间的契约

↓

代理循环决策、调用工具、更新转录

↓

会话可检查的 JSONL 历史

前端打印、Rich 或 TUI

核心理念

将大脑、环境和界面分离。

整个课程的核心是边界。一个可复用的框架绝不能依赖于终端、文件路径或 Rich 渲染。这些都只是对框架的包装——它们永远不该存在于框架内部。

02

你能从 Tau 学到什么

提供者无关的流式接口

请求并执行工具的代理循环

类型化的本地工具，用于读取、写入、编辑和 bash

~/\.tau/sessions 下的持久会话

会话恢复、分支、JSONL 导出和 HTML 导出

项目指令、技能和提示模板

斜杠命令和模型/提供者选择

上下文核算、压缩和思考控制

如何在 UI 适配器边界后保持 Textual

03

教育原则

小层次胜于黑魔法

每个包一个职责。独立学习提供者层、框架和编码应用。

事件让代理可教学

代理发出一个可渲染、可测试、可导出的流，而不是将控制流深埋在回调中。

真实到足以产生影响

教育性的，但不是玩具。一边阅读背后的代码，一边将其作为真实的终端代理运行。

文档紧随实现

按阶段构建，每个阶段都附有关于添加了什么、为什么添加以及如何适配的说明。

灵感来源

灵感来源于 Pi，作为一条 Python 学习路径而编写。

Tau 借鉴了 Pi 的架构课程——保持框架、环境和界面分离。不是逐行移植；而是对相同核心思想的教育性 Python 诠释。

τ一张构建你自己的代理的蓝图：从事件开始，加入循环，包装成框架，然后赋予它工具和 UI。