← Context From First Principles

到达模型了吗?

编译 artefact 不是交付 artefact。编译器的 artefact 到达定义边界的观测充分是什么,当前仪器确立什么,reach 止于哪。

实验计划得很仔细。八个合成任务,每个围着任务文本推不出的事实建。每任务三条件跑:不给上下文、同样尺寸形状的匹配干扰、任务恰要的精确最小上下文。一模型,解码固定,每跑自己的会话,确定性打分。问题不大:如果 live 运行时交付正确上下文,行为变吗?

计划 24 跑,执行 24 跑。没有一跑产出指定上下文条件的 valid 观测。每跑报告零观测上下文记录,因为记录部件一个没产出。意图注入条件,交付没验证。无上下文 control,缺席没验证:没记录请求的观察器分不清无实验块的请求和它没看到的请求。

执行 24  ≠  valid 观测 24
没观测上下文缺席  ≠  上下文缺席的证据
没观测  ≠  观测零

两 setup gap 叠加。注入器没部署到运行时加载插件的位置,装的观察器是旧 build,这个 wave 配置下什么都不捕获。preflight 查包 identity、文件 digest、期待文件,没查配置的宿主真加载注入器、调 hook、给 live 请求写记录。那些静态检查全过,实验的观测路还是没 qualification。

三条件分数相同。那个相等解释不了给的上下文没 effect:没有一跑确立它声称接受的 treatment。缺失的观测记录本身证明不了每跑注入都没发生;独立的部署调查认出 setup 故障。行为相等既不诊断那些故障,也不修复失败的 manipulation check。这些跑还是执行记录,不是意图上下文 effect 对比的 valid 观测。

**本书结果——仪器 failure。**第一波行为计划 24 跑,执行 24,零 valid 行为观测:每跑零观测上下文记录,24 跑传输检查全挂。结果对上下文 inconclusive,对测量链 informative。证据登记列它为 Instrumentation failure。

指派不是交付

教训是基础实验 validity 用在运行时仪器:

问上下文改变行为否之前,先在实验声称的边界确立意图上下文条件真发生了。

意图 treatment  ≠  执行 treatment  ≠  观测 treatment
treatment 指派  ≠  treatment 交付

传输 reconciliation 是点名边界的 manipulation check:指定的实验材料以期待形式在那里观测到吗?行为打分评估结果,不评估 treatment 交付。manipulation check 挂了,按意图条件的对比回答不了交付的上下文造成结果差否。它记录执行了什么、意图对比为什么 invalid。结构证据检查编译 artefact([第 24 章](/zh-cn/books/context/24-chapter/));传输证据检查它在仪器边界出现;行为证据测 valid 干预下的 effect([第 26 章](/zh-cn/books/context/26-chapter/))。没有一个代替另两个。

边界在哪

本章的断言须窄定义,*传输(transport)*一词这里定义如下:

传输证据是边界相对的断言:reconciliation 说明期待的传输块以要求的内容 multiplicity 出现在观测的宿主上下文记录。会话模型归因要额外证据,宿主边界收据本身没确立 provider 线路交付或模型使用。

跑层传输收据三样分开成立时更强:

payload reconciliation  +  会话归因  +  模型归因

纯 reconciliation 函数检查 payload 对应和 model 标识可用时的宿主观测模型对比;它不强制会话 identity。会话配对 harness 做,单独评估。组合断言比插件加载检查强,比 provider 收到同样序列化请求弱。artefact 过几个边界,证据在一边界转下一边界只在中间变换独立观测或验证:

    flowchart TD
    C["编译器:ContextBundle"] --> R["渲染器:渲染文本 (A)"]
    R --> E["Envelope:传输块 (B)"]
    E --> I["注入器:宿主模型上下文"]
    I --> O["观察器:观测系统块 (C)<br/>仪器边界"]
    O --> P["宿主到 provider 翻译<br/>provider 请求:没观测"]
    P --> M["模型:没观测"]
  

这里报告的 OpenCode 结果,仪器观测宿主模型上下文事件,不是 provider 请求。宿主翻译、序列化、provider 加的材料、分词、截断、缓存、路由还在观测外。这是证据的定义 limit,不是下游改了的证明。后面的 Pi 脚本 provider 检查点名不同的观察点,不能拿来升级 earlier OpenCode 断言:

宿主模型上下文观测  ≠  provider 线路捕获
边界 N 的证据  ≠  边界 N+1 的证据

一 adapter,和不 mutate 的观察器

冻结结果背后的运行时 adapter 为 OpenCode 写,对它插件接口第二个大版本(2026 年 9 月的样子)。后面的 Pi adapter 同样的分开用在不同的宿主边界;下面描述,它不在 earlier 结果的 qualification 里。OpenCode adapter 做两件分开的事,默认都关。

注入把点名文件读的一块追加到运行时组装的系统材料。它先建新系统数组一次赋值,错误留不下写一半。结果是小 state 机:

结果 运行时上下文改了吗? 含义
注入 改了,加一块 块加上了
no-op,相同 没 完全相等的块已在
失败,冲突 没 不同的运行时块已在;大声报错,不复制第二份
错误,块文件 没 点名块加载不了或缺 marker
错误,不支持形状 没 系统材料不是期待数组
没尝试 没 注入器从没调

末行是组合层 state,不是注入 hook 发出的结果。编译拒绝,调用者不产出传输块,不尝试注入;这须和尝试注入失败区分开。no-op 意思是相同的块已在,不证明这次调用插入它。相等对一系统数组条目精确比对,冲突检查认出带 opening marker 的块。测试的幂等契约因此是关于不追加第二块;不是一般 marker collision 或别的 hook mutation 的保证。

观察把宿主暴露的模型上下文事件拷贝到本地记录,不改那个事件。记录含会话智能体标识、请求观测 provider 模型、系统材料、消息、暴露工具定义、序列计时字段。测试确立观察器捕获时保留事件结构,含注入后。它们没确立零计时开销、durable 记录完整、别的插件隔离、和终 provider 请求同一。

顺序是测量的一部分。注入 hook 代码里注册在观察器前,观察器看到注入后上下文,组合测试 pin 那个顺序和后果:注入开记录 hold marker 一次,关了记录等于没碰的上下文。观察器先跑,它没 marker,尽管注入后面发生:

仪器顺序  ≠  无关实现细节

观察器多独立?

观察器读宿主事件,不把注入器的成功报告当测量。那分开两代码路,不分开 failure domain:两者住同一包同一进程,依赖同一 hook 框架,同一可变宿主事件的不同 hook 位置观测。共享加载注册失败让两者一起消失。所以两记录一致是有用的宿主边界证据,不是 provider 交付的外部独立确认:

代码路分开  ≠  failure domain 分开
只读观察器  ≠  外部独立观察器

它是宿主里做的测量,失败 wave 说明为什么重要:没 live 的观察器静默,静默 ambiguous。

序列号重启存活,每号记录追加前预留,崩溃留 gap 永不重号。那给出顺序。给不了完整:

单调序列  ≠  完整观测

三 artefact,“不变"什么意思

它是什么 谁造的
A. 渲染 包当文本 编译器的渲染器
B. 传输块 A 包进 envelope,带编译器版本、请求、政策、包 identity hash、估计尺寸、唯一 marker adapter
C. 观测系统块 观察器从模型上下文读回的东西 观察器

A 设计上不等于 B。能断言的是:

A 原样嵌在 B 里
B 恰注入一次
C 含 B 恰一次

A 从 B 两固定分隔行之间读恢复,envelope 加 metadata 不改渲染。相等是 JavaScript 字符串精确字符串相等,hash 记录处 UTF-8 文本 hash。它不是跨序列化边界的 raw 字节相等,最 honest 的措辞是仪器边界观测的精确文本。渲染恰含结束分隔,提取产出前缀,reconciliation 挂不通过。identity 分开:

包 identity  ≠  渲染 identity  ≠  传输 identity  ≠  交付 identity

交付 identity 按边界定义,这里什么都没捕获 provider 请求 identity。

Reconciliation

reconciler 是纯函数:不读文件不调模型。给编译器记录、渲染、传输块、注入轨迹、观察器记录、请求模型,检查指定的相等 multiplicity,返回带累积失败的收据。通过意思是实现的谓词没检出违反;没确立没实现的谓词,比如独立会话配对、provider 线路保真、复制的编译器 metadata 正确。下面表精确定义通过收据的 perimeter:

精确重算对比 和复制 metadata 对比 函数不检查
块等于观测块,恰一次;恢复渲染等于发出渲染;观测系统文本 marker 出现计数;恰增一系统块;请求模型对观测模型 envelope 包 identity、包 hash、请求政策对编译器记录 会话 identity;envelope 里编译器版本尺寸字段

envelope 的包 hash 和编译器记录的 hash 比,不从恢复渲染文本独立重算。两字段一致保留共同错误;单独精确渲染对比是检出渲染内容变化的检查。mutation 探针练成功 gap 两边。请求 identity、政策版本、重复缺失块、渲染内容、分隔处理、注入结果变化挂实现的检查。反过来会话 mismatch、一致改的编译器版本字段、改的尺寸字段、缺席的请求模型 identity 过纯函数。缺失模型 case 记 unattributed 观测,不发明归因;它不该描述成肯定模型归因。会话配对 harness 拥有,纯函数 PASS alone 不是完整跑层传输收据。

metadata 对上  ≠  payload 对上
marker 在场  ≠  artefact 完整

marker 跑里唯一只在 harness 给新鲜标识,代码验证字符不检查唯一,出现次数跨系统材料数。它证明这跑的块出现几次。完整渲染对比证明 artefact 完整,两者都要有。

会话跑请求是不同的 identity,另一会话正确匹配的块验证不了这跑的指派。harness 按会话配对注入观察记录,当前选最新记录,hook 会话 unknown 时不强制会话配对。多请求并发事件,单凭新近还要 demonstrated 对应意图调用;第二波多请求 case 是保留逐请求 identity 收据的理由。请求模型对比用宿主观测模型字段,不是 provider attestation:

请求模型 = 观测宿主模型  ≠  独立 provider attestation

阴性 control 要 live 仪器

空观测能指没请求发生、观察器禁用没加载、hook 没触发、写失败、路径看错、记录丢了:

空观测  ≠  观测缺席

阴性传输条件要肯定证据(观察器为意图请求跑过,归因会话里),加观测材料验证缺席实验块。期待值是 valid 捕获里零匹配块,不是零捕获记录。同样仪器归因规则须无上下文、干扰、oracle 条件通用,不然对比继承不对称测量失败。第二波给它记录的配置提供阴性 control,不是后面每宿主 adapter 修订的。

在 Context Viewer 里检查

本章的 viewer scene 把两结果并排放 fixture 数据:验证 case(渲染、传输块、观测文本 reconcile),失败 case(观察器 liveness 从没确立)。打开 scene 检查每 case license 什么。看什么:每 case 观测了哪些边界,失败 case 止于哪,为什么失败 case inconclusive 不是阴性。验证 case 只确立 hook 边界等价;两 case 都不说 provider 线路交付模型内部。历史 wave 本身是研究登记记录的书结果,这里不复现。

Viewer 交付对比。验证 case:渲染、传输块、观测文本 reconcile。失败 case:无 live 观测,reconciliation 不可能,跑 inconclusive。
只在观测宿主边界 reconciliation;死仪器对交付什么都不证明。区别的构造说明。

在 Context Viewer 里打开交付对比

静态 identity 不是 liveness

失败 wave 停在几个分开断言的第一个,一处通过不是下处通过:

层 通过说明 不说明
装了 包在期待 identity resolve 加载
加载 宿主启动它,setup 跑了 hook 触发
注册 hook 按意图顺序挂上 请求穿过它们
注入 一 live 请求块加一次 谁看到了
观测 观察器产出宿主上下文的只读记录 记录 hold 块,或观察器外部独立
reconcile 块记录里恰一次,没变,marker 一次 对的会话、provider 线路 identity、模型使用
归因 请求模型是观测宿主模型 行为变了
行为 行动动了([第 26 章](/zh-cn/books/context/26-chapter/))

后面的验证层蕴含前面一些事件,前面通过永不确立后面。加载检查确认前三无推断。smoke 测试发一 live 请求确认后面几。静态 identity(work 系统为真的事实)不是它 work 的证据:

装了  ≠  加载  ≠  执行  ≠  观测

qualification vs 逐跑验证

qualification 问仪器能不能 work。跑层验证问这跑 work 否:

qualification  ≠  逐跑证据

上周通过的 canary 说上周路通。实验 harness 有逐跑传输检查,24 跑全是它 flag 的。它还有 preflight 检查两 canary 文档(marker canary 编译包 canary)对排期模型。两者回答不同的问题,一 isolate 注入观测机制,一测从编译到观测的组合,第二个不让第一个冗余,直到证明一 subsumes 另一的失败面。但 preflight 只在路径给了才强制 canary 检查。没给,静态检查照旧跑,两个都给是未来 wave 的规则,代码不强制。第二波在门后跑,下面描述。

live qualification

链条在 Exercis 每步的最小 case 端到端跑过。单条目合成包编译、渲染、新鲜 marker 包装、注入一 live 会话、观察器读回,模型回复忽略。

**本书结果——live 编译到观测 qualification。**一 trivial 合成请求链条通过。编译成功,运行时报告注入了,系统块数四变五。观察器在注入记录同一会话记请求为第一条记录,marker 恰一次。请求模型等于观测模型。编译器渲染在注入块原样在场,块在观测上下文原样在场。证据登记列它为 Live compile-to-observe qualification。

它确立的是那个 case 仪器宿主模型上下文边界的交付,perimeter 紧。它是一包一条目、一请求、一模型、一宿主版本、一编译器 adapter 修订,adapter 编译器后来变了,历史证据管那个组合,不 qualification 当前代码。块尺寸是编译器词估计。观察器捕获 hold 完整模型上下文,私有,只有 digest 登记,owner 查本地原件,别人不行。provider 请求没捕获,行为断言不跟:

一次成功的 live qualification  ≠  传输可靠性估计
历史证据  ≠  当前 qualification

它说明路能通。不给失败率,不给会话模型宿主版本并发重启大包的可靠性。

earlier 探针用不同的(已替换)独立插件固定 marker 无编译器排布。留两按顺序。第一,两 live 调用产出 valid 捕获,marker 永不在场,干跑(无推理)说明运行时包无可加载插件 entrypoint,宿主静默跳过:装了没加载。修好第二探针门全过,块加一次,marker 观测一次,注入注册在观察器前。它们说明运行时机制,仅此而已,不和编译包 qualification 合数。

第二波

开篇 wave 在门后重跑。八 fixture 三指派条件,24 跑报告的逐跑宿主边界 reconciliation 全过。无上下文臂 valid 观察器记录无实验块;干扰 oracle 臂意图块每观测模型请求出现一次。一干扰跑产生两请求,验证单位从每跑一记录修订成每请求精确对应。reader digest 首调用前检查,两 canary 都要。早两次 launch harness 故障挂,valid 跑前排除。这些是记录配置的观测;修订的 matcher 不追认第一波失败。第二波多请求 case 是保留逐请求 identity 收据的理由。

这是那个配置的宿主边界传输证据,仅此而已。块从 fixture 真相作者,冻结流水线渲染,不是编译到观测测试,会话配对还是 harness 的。编译器 pin wave 中途只在包文件变。行为结果归[第 26 章](/zh-cn/books/context/26-chapter/)。

跑过什么没跑过什么

条目 状态
adapter 测试套件(注入结果、观察器不干扰、hook 顺序、序列恢复、组合、reconciliation) 自动化,跑过
reconciler mutation 探针 跑过:八 mutation 失败 closed;会话、版本、尺寸、缺席模型变化通过
记录的 live 结果 仪器 failure;earlier marker 探针两;编译到观测 qualification;第二波 24/24 reconcile
注入幂等 collision、hook 顺序反转 幂等冲突测试有;反转提议
加载 smoke 检查 脚本有;这里没跑
无上下文 live 阴性 control 第二波记录(八跑,一配置);当前配置 control 提议
重复重启 qualification 提议
reconciler 会话强制 提议

提议的不是证据。

**什么 weaken 断言。**注入断言在同样重试复制块、畸形块 mutation 上下文、错误留部分 state 时 weaken。不干扰在开观察器改变传下去的上下文时 weaken。reconciliation 断言在缺失观察器重复 marker case 通过时 weaken。纯 reconciler 不执行会话 identity,mutation 探针确认会话 mismatch 过得了,会话配对归周围 harness。会话 identity 进 reconciliation 还是显式独立归因检查,是 open 设计选择,两种都合法。“reconciled” 一词不该蕴含它不检查的会话正确。liveness 门在 canary 挂了推理还能跑时 weaken,可选参数设计允许。阴性 control 断言在空文件推出缺席时 weaken。

换宿主:薄 Pi adapter

编译器定成员渲染包不需要智能体框架。宿主 specific 工作在那个决定后开始:把渲染放进下次算子,观测宿主组装了什么。薄 adapter 换那部分,编译器契约保留。

Pi adapter 用具名结构化提示词节。轮次准备 hook 编译显式输入,验证返回包,不变渲染放传输块。它把块设成 Pi 提示词选项的一节,别的节工具声明保留。独立观察器拷贝后面含系统消息的 transcript。注入 raw 捕获独立 opt-in。

hook 选择重要。Pi 在这个 transcript hook 后整提示词替换,earlier 观察器确立不了替换内容含什么。结构化节让 adapter 的贡献成 transcript 本身。这 follow 宿主的组装契约;它不说提示词节对模型更有用。

adapter 的检查跑真实 Pi 会话,脚本 provider stand 外部模型。它拿观察器的 effective 系统文本和 provider 收到的对比,再检查意图块字节、单一、会话、模型归因。阴性 control 引入后面的整提示词覆盖,要求 provider 对比检出 hook reconciliation alone 排除不了的差别。扩展组合因此要自己的 provider 边界 qualification。

这是实现检查,不是关于真实模型交付行为的冻结结果。Pi 捕获点名自己的边界格式。它不冒充 OpenCode 记录,earlier OpenCode 结果还是原配置的证据。换宿主换 adapter qualification work;不改变成功编译证明什么。

标题的问题

标题 deliberate 问得比 OpenCode 仪器直接看到的多。它在 qualification 跑确立归因宿主上下文观察点的完整传输块。它没捕获 provider 线路请求和模型内部消费。后面的 Pi 脚本 provider 检查在受控测试练额外的宿主到 provider 对比,不是观测的商业 provider 收据。解释行为对比,每指派条件要自己的 valid 边界收据结果记录,剩下下游不确定说清不静默转成确定。

编译  ≠  交付  ≠  用了  ≠  有帮助

现在,只在现在,问改变交付的上下文改变行为否。那是[第 26 章](/zh-cn/books/context/26-chapter/)。

参考

  • Pi project. Pi source repository. First-party code and extension documentation, checked October 2026. The new adapter is grounded in its pinned installed SDK declarations; exact pins and the scripted-session check are recorded with the adapter source.
  • Project Context Pi. First-party local source package: compiler-core import, structured prompt-section injection, separate observer, reconciliation and real-SDK tests with a scripted provider. Implementation check only; no real-model or provider-wire qualification is claimed.
  • Project Context OpenCode. Source repository, Apache-2.0, first-party code by this book’s author. The injection and observation mechanisms, the composition layer (envelope, reconciliation) and the load-check and smoke scripts. https://github.com/ernanhughes/project-context-opencode
  • Project Context evidence register (companion repository, evidence/README.md). Consumed here: Instrumentation failure, Live compile-to-observe qualification and Earlier runtime qualifications. Transport evidence and one inconclusive behavioural wave; no behavioural claim.