Harness
把模型变成可运行产品的上下文、状态、工具、控制和交互底座。
GLOSSARY + SOURCE INDEX
从人话词典，直达官方源码
术语负责建立共同语言，源码锚点负责约束解释边界。所有解读固定到一个可复核快照。
UPSTREAM RESEARCH SNAPSHOT
47f943859bef60e4160492346772ded9b24f765a2026-08-13 · 324 docs · 3746 package filesPLAIN-LANGUAGE GLOSSARY
15 个词，消除阅读摩擦
Context
Cordis 的作用域容器：服务、事件、配置和可逆副作用都挂在这里。
Effect
插件创建的资源及其回收函数；安装和卸载因此对称。
Fiber
一次带父子关系、取消与回收语义的异步工作单元。
Profile
一个可命名的产品组合入口，选择 Bundle 并承载用户 Patch。
EpochHeader
某一步模型请求实际看到的模型、工具、提示词与限制的完整快照。
Turn
认领一条输入后必须结清的工作单元，可能包含多个 Step。
Step
一次模型请求及其流式响应；工具循环会开启新的 Step。
SessionEvent
仅追加、可回放、模型可见的会话事实，不等同于 UI 展示顺序。
Surface
从事件日志计算出的模型上下文视图；压缩会改 Surface，不改历史事实。
Capability seam
服务定义、Provider、Consumer 和策略消费者共同构成的替换边界。
Tool debt
模型发出工具调用后必须返回匹配结果，Turn 才能合法结束。
Projection
从事件增量计算的读模型，使用水位避免重复或错序消费。
Spill
把超大内容移出上下文，仅留下不透明定位符，按需再读回。
Provider
能力接口的一种实现，拥有自己的配置、SDK 与资源生命周期。
CURATED SOURCE MAP
按学习层级组织，而不是把目录倒给你
每个文件只在它最能回答的问题旁出现。点击章节，先看解释；点击文件，直接核验。
建立全局直觉
能向别人讲清模型、Agent 与 Harness 的边界
掌握组合语法
能读懂一棵真实插件树为何可安装、可替换、可卸载
追踪 Agent 主干
能逐事件解释一次完整模型请求
理解安全与耐久性
能判断系统在拒绝、崩溃、取消和长上下文下是否仍可信
从单 Agent 扩到协作系统
能区分状态、委派、编排与长期运行的责任边界
动手扩展并交付
能在不修改 Agent Loop 的前提下交付一项完整能力
PRIMARY SOURCE
教学项目搭桥，官方仓库定案
DeepSeek Harness 仍处于 developer preview。遇到接口、事件名和默认配置差异，请以当前官方提交为准。