Tether 源码课
你不需要先懂 agent、依赖注入或事件溯源。这套课会先给你一张大地图,再用 16 周把地图上的每一块换成真实源码、测试和可运行实验。
软件工程大一 16 周 会基础 C# 即可 无 API key 起步
一句话先懂:Tether 不是“会聊天的模型”,而是把模型、工具、会话和安全边界组织成一个可运行软件系统的 harness。
先看整张地图
第一遍只看箭头,不必记住名词。后面每周都会回到这张图,放大其中一段。
读图边界:箭头表示“主要关系”,不代表每一步都是同步函数调用。真实系统里有异步流、事件派发、取消、失败回滚和持久化;课程会在相应周次补上这些精确语义。
你将走过五段路
一 · 看见全貌 →
第 1–2 周:先跑起来,再把 solution、项目和测试变成地图。
二 · Cordis 插件框架 →
第 3–8 周:插件、作用域、服务、事件、组合和期中链路实验。
三 · Tether Agent Runtime →
第 9–13 周:会话、投影、LLM 流、工具安全和 agent loop。
四 · 真实系统边界 →
第 14–15 周:文件、进程、沙箱、动态程序集与热重载。
五 · 综合实践 →
第 16 周:沿 seam、Provider、Consumer 路径完成一个小能力。
每周怎么学
- 先说出预测。看图或命令后,先写下你认为会发生什么。
- 再读最小源码。每课只给完成当前问题所需的文件,不要求漫游整个仓库。
- 运行并观察。实验默认使用已有测试和 ReplayLlm,结果可重复、不消耗模型额度。
- 用准确术语复述。类比帮助入门,最终答案必须落回类型、事件和生命周期。
- 打开自测答案。先作答,再展开
<details>核对;错题回到图和实验,不靠背结论。
开始前准备
- .NET SDK 10(仓库的
global.json固定版本)。 - 能在仓库根目录运行
dotnet build Tether.slnx与dotnet test Tether.slnx。 - 知道 class、interface、generic collection 和
async/await的基础写法;不要求理解其运行时细节。 - 综合实践前创建自己的 Git 分支;前 15 周实验不会要求改正式源码。
实验约定:看到“预测 → 运行 → 观察 → 解释”时,不要跳过预测。预测写错不是失败;没有预测,运行结果就只是一串路过的字符。
参考手册怎么用
课程页面给学习顺序,开发与 参考页面给完整语义。第一次学习时顺着“下一篇”走;写代码或查边界条件时,再从课程中的链接进入参考页。