上下文编译器
本书挣到的约束强制执行的最小确定性机制:它吃什么,保证什么,实现哪里是或有政策,spec 哪里超前它。
整个接口在这里。
const output = compileContext(request, candidates, policy);
if (output.result.success) {
const bundle = output.bundle; // the ordered ContextBundle
const trace = output.result.trace; // one entry per candidate: what was decided and why
} else {
const reason = output.result.failure?.reason; // a named refusal, never a guess
}
请求、候选表、政策进去。成功调用返回包和实现表示的决定轨迹;失败返回具名拒绝和现有决定记录。调用本身不读文件、不调模型、不碰网络时钟随机。纯洁是编译器边界的属性,不是周围流水线的:候选 builder 调用者从可变来源拿事实、给过时判断都可能。确定性编译让给的决定可复现,没确立给的信息正确。
第 22 章推导了 spec:给定合格候选、关系、可准入表示、硬约束、预算,定 valid 包存在否,可行包里按显式目标选,不然返回结构化失败。实现的编译器更窄:它用确定性政策构造检查包,不穷举可行集。拒绝报告的可能是构造流程满足不了请求,不是证明合法包不存在。本章拿编译器当实验 artefact,三件事分开:结构 justified 的机制、或有政策选择、代码还没挣到的 spec 要求。
本书的编译器是从声明的候选 state 约束政策到 valid 有序包或显式失败的确定性变换。它不是取回、记忆、候选发现、真相发现、对世界验证、摘要、行为评估、传输。它消费别处做的决定。
任务
这里的数来自编译器附带的小合成 case。它们演示机制,什么都不测量。智能体调查失败的数据库 migration。上游系统产出常驻规则(生成文件永不动)、任务、几种形式的事故报告、早修订观测的后端、不同项目的配置文件、migration 完成(对一租户 qualification 没完成)的断言、关于数据库分歧的两文档。编译器决定这次算子收到什么。
它拿到什么
请求带任务标识、声明的可用 token 预算([第 4 章](/zh-cn/books/context/04-chapter/)的 envelope,当上限)、现行范围、具体点名的候选标识、期待政策版本、调用者给的创建时间。创建时间是输入值,不是编译器读的时钟;给了不验证候选年龄新鲜度。预算也不是 provider 确认的 token 数:含义看调用者的核算契约与渲染器的估计器。
候选是一份信息的一种表示加编译器判断能不能用的东西:
| 种类 | 字段 | Role |
|---|---|---|
| Identity | 候选标识、内容 identity、表示标识 | 哪个信息哪种形式 |
| 约束 | 范围新鲜度权威性 verdicts(各带理由)、形式排名下限、必需类 | 硬准入资格与义务 |
| 关系 | 依赖、组标识、组必需否 | 什么陪什么 |
| 成本 | 声明 token 数 | 声明的,不是测的 |
| 目标信号 | 相关性、覆盖键 | 可行选项里选 |
| 排布 | 顺序 role | 排序政策 |
| Payload | 来源种类、种类、内容、来源引用 | 渲染跟踪什么 |
政策很小:不加覆盖的可选材料的最小相关性、必需形式里"最便宜"的支持选择、role 顺序、渲染超支修复规则。实现选择前拒绝一些畸形输入,含重复标识、负声明 token 数、缺失依赖、某些跨类组。调用者须区分这些输入契约违反和 well-formed 编译返回失败。解释第三 state 重要:报告的编译失败不一定是数学不可行的证明,选择流程不完备。
invalid 请求 ≠ 无合法包 ≠ 有合法包
准入资格是给的
编译器执行给的准入资格判断。它不发现范围新鲜度权威性。
门确立的只在给定判断政策下候选这次编译没资格。它确立不了判断描述世界。builder 把过时观察标新鲜,编译器准入它,记录过门了。
第 19–21 章给比布尔丰富的模型:贡献数据的许可和指导的许可不同,操作相对的新鲜度 UNKNOWN 留得下,范围含几个世界。编译器消费二值 verdict 不实现那些模型,只在上游为被编译的具体操作把每丰富判断投影过。描述的 builder 拿一范围字符串和另一比,消费给的验证器状态;那些机制本身确立不了多世界适用、操作相对新鲜度。允许 UNKNOWN verdict 意思是政策授权不确认 current 就往前走,不是证据变 current。编译器执行投影的 verdict 与理由;投影正确还是上游义务。
可行先于偏好
主要 law 是:
编译器永不用软目标 trade 硬义务。它要么构造满足声明硬约束的包,要么返回显式失败,合法区里软目标才影响选择。
可行 ≠ 偏好 约束 ≠ 分数
那个 law 要 valid 输出,不完整可行 solver。三属性分开:
可靠性: 返回的包满足强制的约束
完备性: 合法包存在,编译器找得到
最优性: 合法包里选最好的
这里可靠性指相对可靠性:产出的包满足实际编码给编译器的硬约束,按它的验证器单位。它不蕴含来源断言 true、上游准入资格正确、provider 数同样 token 数。完备性没确立:贪心选择修复挂了,别的可准入选择 fit 也可能。最优性不断言,穷举搜索验证过的效用目标都没有。阶段验证输入点名候选、施加门、处理必需要求类、选可选单元、排序、渲染、检查结果。产出包 valid、false 拒绝、政策质量的测试分开保留。
flowchart TD
IN["请求、候选、政策"] --> V["验证输入与点名来源"]
V --> G["给定 verdicts 的硬门<br/>范围、新鲜度、权威性、下限"]
G --> M["必需,要求<br/>闭包组整体定价"]
M --> P["政策可选单元,<br/>上限下停止"]
P --> O["按 role 排序"]
O --> X["渲染,编译器单位估计成本,<br/>对 envelope 验证,修复"]
X --> OK["包与轨迹"]
V -.-> F["失败与轨迹"]
M -.-> F
X -.-> F
高相关性分数修不了错范围、时间 invalid、没授权、低于下限的候选,门里没有分数:
function hardGate(c: ContextCandidate): Gate {
if (!c.scopeEligible) return reject("scope_ineligible", c.scopeReason);
if (!c.freshnessEligible) return reject("freshness_ineligible", c.freshnessReason);
if (!c.authorityEligible) return reject("authority_ineligible", c.authorityReason);
if (c.formRank < c.minRank) return reject("illegal_representation", "below floor");
return eligible();
}
两合成 case 演示执行。另一项目的配置文件相关性 0.99 被拒。过时观察(100 token,相关性 0.9)旁边当前观察(600 token,相关性 0.75),过时的被拒。这些展示门覆盖成本相关性。没展示上游判断正确。
义务
编译器四必需类,第 22 章推导更简单的区分(硬义务对软偏好)。读代码看出每类实际改变什么:
| 类 | 处理 | 准入不了 | 不同处 |
|---|---|---|---|
| 必需 | 第一,按内容 identity,最小边际成本的形式 | 编译失败 | 点名失败理由;预算第一 claim |
| 要求 | 第二;组先于单条目 | 编译失败 | 同样义务;处理优先低 |
| 偏好 | 贪心,按相关性 | 跳过 | 自由裁量前考虑 |
| 自由裁量 | 贪心,按相关性 | 跳过 | 渲染修复唯一能删的类 |
必需要求在描述的实现都是硬义务,处理顺序不同,诊断不同。顺序在备选共享依赖争预算时改变贪心结果。任一类的报告失败是执行结果,不一定是每 valid 包都挂的证书。偏好自由裁量用类似的相关性选择,优先和渲染修复删谁不同。概念基线是硬可选材料加显式删除优先;四类划分或有,直到 ablation 说明额外区分重要。请求点名的候选变成要求,池里没有那个标识另当 unavailable 来源处理。
必需是这次算子要求,不是重要:
保留政策 ≠ 编译必需
必需 ≠ 相关 相关 ≠ 必需
保留类说空间紧张条目能动什么([第 7 章](/zh-cn/books/context/07-chapter/)),必需类说这次编译没它走不走。pin 规则只给精确形式,只在改代码的任务必需。上游保留政策约束提供哪些表示,编译器执行产出的可准入信息。它不把保留映到通用数值下限。
表示:替代与互补
第 12 章和[第 18 章](/zh-cn/books/context/18-chapter/)确立内容 identity 不是表示 identity。事故报告四形式:
| 形式 | 排名 | Token | 要什么 |
|---|---|---|---|
| 全文 | 3 | 900 | 不要 |
| 紧凑摘要 | 2 | 300 | 不要 |
| 锚点 | 1 | 90 | 不要 |
| bare 引用 | 0 | 20 | 150 token 的 resolver 定义 |
排名是上游 fixture 约定,不是保真度的 general valid 排序。引擎拿 formRank 和 minRank 比,但[第 12 章](/zh-cn/books/context/12-chapter/)的保留要求多维:结构化形式保精确标识符比长叙事好。所以数值排名只在 builder 证明排名阈值代表声明义务的 fixture 下当准入资格 proxy。不然编译器数执行对,形式 inadequate 也收。它在提供的表示里选,不创造。只给转述的规则,验证要求精确措辞就拒,不管名义排名。
这里代码和 spec 分歧。编译器拿同样内容 identity 的候选当备选:一准入,别的当备选拒绝,内容 identity 准入的依赖算 collision。第 18 章允许互补表示,比如短结构化摘要旁精确引用 clause,锚点旁选的精确证据,第 22 章让混合可能。所以:
同样内容 identity ≠ 互斥
替代 ≠ 互补
互斥对替代集声明,不从共享内容 identity 推断。结构推断里结构化记录和精确引用 clause 互补(同一来源对象也一样)。本章代码检查说明当前一内容一形式规则排除第二个;这还不是测得的行为失败,合成语料缺互补对 fixture。有界修复候选是声明的替代组标识加互补形式的显式兼容。实验先确立规则改变结构 valid 或下游结果,再加编译器机器。
依赖、耦合与成本
earlier 事故的引用写 20 token。跟它要 resolve 它的工具,650 token:
flowchart LR
R1["事故引用<br/>20 token"] --> T["Resolver 定义<br/>650 token"]
R2["第二引用<br/>25 token"] --> T
成本几个单位,编译器分开:
声明条目成本 ≠ 增量选择成本 ≠ 依赖闭包成本
声明成本 ≠ 渲染估计 ≠ provider 核算成本
编译器从给的关系算依赖闭包,没选的成员收费。20 token 引用加 650 token resolver,第一次引用花 670 token。20、25 token 两引用共享 300 token resolver,合闭包 345 token;那是单独说明的 resolver 成本,不是同一 fixture 的两价格。没资格依赖 block 父准入,可选必需父结果不同。遍历节点一次防循环无限递归,不证明循环关系某任务语义可准入。池缺失依赖当畸形输入拒绝。闭包精确只相对声明的关系:发现不了省略的解释工具来源依赖。
依赖闭包 ≠ 语义完整
依赖和耦合不同。依赖有向,A 要 B,不蕴含 B 要 A。耦合组全有全无。必需组机制实现耦合。migration 完成(120 token)的断言和"一租户除外"的 qualification(80)成组,组装不下具名理由失败。必需组须一必需类,代码输入强制,看像实现简化(准入按类走),不是语义要求。
分歧保留只在上游政策说一起保留时用同样机制([第 19 章](/zh-cn/books/context/19-chapter/)),语义冲突 ≠ 自动耦合。两断言加 marker(60、60、40 token)一起进或全不进。
fixture 描述 400 token 完整事故表示和依赖闭包 670 token 的引用满足同样需要,相关性优先自由裁量政策选了引用。两真是同样义务下可准入替代,这是高成本合法选择的例子,不是硬约束违反。它没确立相关性优先总浪费:provider 缓存、后面复用、任务行为、全文保留成本改变整轨迹经济。例子暴露待测的政策选择,不是观测的效率结果。
选择、停止与拒绝
可行可选材料里编译器每轮准入相关最高,再最新覆盖,再最低成本,再标识符。加东西没有的单元跳过,相关性低于政策阈值且无新覆盖键,语料阈值 0.3。那个顺序是确定性基线,没证明挣到。3,000 token 预算的合成 case 编译器产出 265 的包。有用 150 token 笔记进了,不碰任务的两长笔记政策下没选,2,700 token 没花:
预算上限 ≠ 开支目标 预算没花完 ≠ 失败
结构要求组装器上限下能停。特定相关覆盖规则是政策是假设。
失败具名。失败带理由、block 标识、用的预算 total、诊断句、轨迹,无包:
| 理由 | 何时 | 恢复 |
|---|---|---|
INSUFFICIENT_BUDGET |
必需要求材料装不下,或渲染包超支无合法修复 | 抬预算或缩小请求 |
UNSATISFIED_DEPENDENCY |
必需要求候选要没资格 collision 的东西 | 修候选构造 |
NO_LEGAL_REPRESENTATION |
必需条目的每形式低于下限 | 给可准入形式 |
UNRESOLVED_REQUIRED_GROUP |
必需组整组准入不了,依赖或预算原因 | 修组或预算 |
REQUIRED_SOURCE_UNAVAILABLE |
请求点名的候选池里没有 | 找来源 |
REQUIRED_INELIGIBLE |
必需条目无合格形式 | 改任务范围或上游判断 |
数不定,新名字只在标不同 state 恢复证据时重要。INSUFFICIENT_BUDGET 覆盖选择溢出、渲染溢出、失败的编译后检查,UNRESOLVED_REQUIRED_GROUP 覆盖依赖预算两病因。渲染溢出值不值得自己理由,看调用者要不要和普通预算不可行不同的恢复路。unknown 成本理由没有,因为成本是数不能 unknown,unknown 成本不免费,实现这里有 gap。
编译器能拒绝,不得静默 weaken 已知的约束制造 apparent 可行:丢必需材料、降执行下限、收上游没资格候选、省略声明依赖、拆必需组、截断精确表示。拒绝守住执行边界。完备性没确立,调用者把失败读成"这个编译器这些输入政策下没找到包",除非失败带独立检查的不可行证书。从失败恢复是上游的决定,不是编译器放松规则的 license。
排序、渲染、验证
成员不是顺序。编译器按 role 给选中候选排序(指令、任务、state、证据、 supporting、工具),role 内按标识符。相关性没份,顺序是政策默认不是发现。第 6 章说明同样条目不是同样上下文,排序不是装饰,编译器没确立它的顺序行为最好。
渲染加 header、条目 label、分隔,编译器估计 token 成本不查 provider 分词器。一合成 case 声明条目数 total 770 编译器单位,渲染估计 789;另一声明和 250 变成 265,修(删自由裁量条目)产出估计 111 单位包。这些是编译器自己核算的值,不是 provider 观测输入 token。描述的修复在依赖组规则下删合格自由裁量材料,保留的依赖留没用的成本。每次删除后闭包、必需义务、耦合组完整重查。估计单位的 pass 只确立内部预算合规;provider token 合规要独立测量或保守 bound。
确定性估计 ≠ 精确 token 数
估计 fit ≠ provider 核算 fit
项目校准里词估计远低于 provider 数,一会话一模型。编译器还检查自己的输出(渲染成本对预算、排布对条目顺序、每条目对选中集),内部不变量检查,不是独立验证:
内部检查 ≠ 独立验证器 ≠ 跨实现 parity
确定性与轨迹
确定性以固定编译器实现、归一化输入政策为条件,含候选顺序 tie-break 规则。描述的结果记录请求、政策版本、包 hash,不记编译器 build 修订 identity;后面同样代码 replay 变了,每版本还确定。包 hash 只认出声明典范化下 hash 的东西,不一定是精确 provider 可见消息序列。可复现编译、语义正确、渲染字节 identity、provider 交付 identity 分开检查。
确定性 ≠ 正确 可复现 ≠ valid
轨迹是机械决定记录,不是模型推理,不是来源真相的陈述,不是后面行为的因果解释。陈述字段含每候选决定、理由码细节、必需类、相关性、边际成本、依赖闭包、准入父、预算变化、位置。每失败路字段全否是可测的轨迹覆盖要求,字段表确立不了。独立检查器要冻结输入、编译器政策版本、无歧义成本约定、重建验证声明约束够完整的记录。轨迹完整和编译器正确分开测。
名字只挣到约束执行的 artefact 构造。编译器不翻译程序,不证明语义等价,不优化任何。
测什么,不测什么
| 要求 | 实现 | 测试证据 | Gap |
|---|---|---|---|
| 输入验证 | 有,决定前抛 | 核心测试 | unknown 成本表示不了 |
| 给 verdicts 的硬门 | 有 | 错范围过时便宜 case | verdicts 是给的 |
| 必需类 | 有,四 | 溢出 unavailable case | 可选拆分只改变顺序修复 |
| 替代备选 | 有,按内容 identity | 备选 case | identity,不是声明关系 |
| 互补表示 | 无 | 无 | 当备选拒绝 |
| 表示下限 | 有,数值排名 | 无合法表示 case | 排名是约定 |
| 依赖闭包,边际成本 | 有 | 依赖陷阱共享依赖 case | — |
| 环 | 有,走一次 | 依赖环 case | — |
| 耦合 | 有,必需组 | qualification 冲突 case | 一组一类 |
| 上限下停止 | 有,相关覆盖 | 预算 slack case | 阈值是政策 |
| 拒绝分类 | 有,六理由 | 溢出下限 unavailable case | 渲染溢出共享理由 |
| 渲染成本修复 | 有 | 渲染溢出 case | 估计单位 |
| 排序 | 有,按 role 标识符 | 排布检查 | 政策默认 |
| 轨迹 replay | 有 | Golden 输出 | 编译器版本没记 |
语料 14 case 家族三预算跑,42 编译。语料无互补表示、unknown 成本、多世界 case,没 case 诱弱组装器打破权威规则。
生态门
真实会话语料是空的。建更多机器前,真实池须展示:
- **结构:**每内容 identity 表示、替代互补集、依赖、共享依赖、环、耦合组、保留冲突。
- **准入资格:**范围新鲜度权威性下限拒绝、UNKNOWN 上游判断、多世界任务。
- **成本结果:**估计对渲染对 provider 核算成本、没用预算、理由失败、渲染溢出、runtime 轨迹尺寸。
编译器支撑机制先于本书知道那个机制在真实会话多久重要。
提议的实验
**实验 A:结构一致,模型 free。**调用实现前冻结 fixture 输入、硬约束、允许表示组合、有没有 valid 包的真相。小池用独立实现的穷举枚举器或等价参照检查器区分真不可行和贪心 false 拒绝;编译器自己的失败不当 oracle。接受多 valid 包,不要求唯一选择,编译器声明单位检查精确渲染约束。保留现有 fixture 覆盖,加互补表示、可选必需父(依赖没资格)、unknown 成本、多世界准入资格投影、共享依赖的竞争必需备选。分开记录 invalid 产出包、false 拒绝、失败码精度、不完整轨迹、独立成本检查分歧。
- 政策一起允许的互补表示,当前编译器可能挂;
- 可选必需父(依赖非法),分开;
- unknown 成本;
- 编译器不懂世界的多世界准入资格投影强制;
- 贪心准入下共享依赖 false 不可行。
实验 B 与 ablation。第 24 章对比选择策略;这个实验问声明不变量要编译器哪些机制。一次去一机制——硬门、依赖闭包、耦合、替代处理、表示可准入、显式拒绝、渲染成本检查、停止、稳定 tie-break——fixture 政策固定。ablation 输出 invalid、只改变选择、什么都不变,分开报告。机制只因去掉它 specific 构造的对抗 fixture 挂了,不算 justified。生态门下游评估定失败模式重要到值生产复杂度。单综合质量分数不提。
编译证明不了什么
合法包 ≠ 有用包
结构 valid ≠ 行为有效
编译器选中它 ≠ 模型用了它
包产出 ≠ 包交付
第 26 章拥有行为证据,第 25 章拥有传输。结构合法包能装干扰,成功编译既不说包到达模型,也不说它帮忙。边界还在原处:编译器不推导范围新鲜度权威性,不建候选的形式,不精确数 token。
证据不对称。硬门、依赖闭包、耦合、拒绝、确定性、轨迹是机制里结构理由最清、fixture 覆盖现存的,第 24 章问执行证据支撑什么。四必需类、数值形式排名、相关性优先排序、0.3 阈值、一内容一形式、role 排序、删最后自由裁量修复带更多或有政策。编译器当约束执行 artefact 比证据 justify 选择政策成熟。
在 Context Viewer 里检查
本章的 viewer scene 走小候选集过流水线:硬门先行,依赖闭包,断言带 qualification 走,4,000 上限合法包渲染 3,400,slack 合法空着。打开 scene 读每拒绝的理由码,再和同样候选的排名填充对比。看什么:错世界条目这里为什么拒绝、排名下赢,轨迹关于组 slack 记录什么。这是决定记录的构造演示,不是 conformance 跑;它展示合法,合法不是有用。
交接
现在有机器,显式约束候选 metadata 确定性返回包或拒绝。但实现不是证据。编译器说尊重门、闭包依赖、核算单位内、记录每决定。下个问题是什么观测 justify 那些断言,多远到得了:什么证据确立可靠性,什么确立完备性,什么(如果有)支撑最优断言。
参考
- Project Context Compiler. Source repository, Apache-2.0, first-party code by this book’s author. The library, command-line tool, agent tools and synthetic conformance cases used in this chapter. https://github.com/ernanhughes/project-context-compiler