From eb153fafb0c7928a056a7e264c9299d894652e17 Mon Sep 17 00:00:00 2001 From: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> Date: Tue, 3 Nov 2026 00:24:26 +0800 Subject: [PATCH] fix(site): keep context diagrams complete within their panels Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> --- .../public/blog/context-delivery/index.html | 4 +- .../context-delivery/context-cycle-v9-en.svg | 18 +- .../context-delivery/context-cycle-v9.svg | 18 +- .../context-native-path-v10-en.svg | 176 ++++++++---------- .../context-native-path-v10.svg | 176 ++++++++---------- .../blog/zh/context-delivery/index.html | 4 +- 6 files changed, 170 insertions(+), 226 deletions(-) diff --git a/apps/presentation/site/public/blog/context-delivery/index.html b/apps/presentation/site/public/blog/context-delivery/index.html index 7a72704e74..4877c9662d 100644 --- a/apps/presentation/site/public/blog/context-delivery/index.html +++ b/apps/presentation/site/public/blog/context-delivery/index.html @@ -174,7 +174,7 @@

On the next continuation, deliver what changed

When enabled, the default output is a reading entrypoint

Connect these operations back to the currently supported native Codex quota path:

-

One capture, from saved source to reading

Default Mechanism Path with Context Delivery Enabled: projection.json, required-context.json, compact reference envelope, and progressive readback
decision-<id>/
+

One capture, from saved source to reading

Default Mechanism Path with Context Delivery Enabled: projection.json, required-context.json, compact reference envelope, and progressive readback
decision-<id>/
 ├─ projection.json        source
 ├─ required-context.json  facts
 ├─ delivery.json          full/delta
@@ -201,7 +201,7 @@ 

Recover missing context while preserving the original work

Paged content: follow next_command with capture digest, selection digest and byte cursor; combine contiguous content in order. Selection EOF covers only that selection.
  • Unknown or inapplicable structures: retain complete content and original read obligations rather than guessing which prose can be hidden.
  • -

    Continuity and recovery

    Differential Delivery: Reuse Within an Epoch, Full Recovery on Break

    One valid cycle: complete baseline → changed facts and delta → exact reconstruction.

    New cycle or known continuity loss: complete current source → read necessary facts again.

    An unfinished Turn retains its original capture, work and settlement identity. Reading recovery does not repeat external effects.
    +

    Continuity and recovery

    Differential Delivery: Reuse Within an Epoch, Full Recovery on Break

    One valid cycle: complete baseline → changed facts and delta → exact reconstruction.

    New cycle or known continuity loss: complete current source → read necessary facts again.

    An unfinished Turn retains its original capture, work and settlement identity. Reading recovery does not repeat external effects.

    What the measurements establish

    The example separates three mechanisms: avoid repeatedly moving history not currently needed, combine reads that belong together, and avoid retransmitting unchanged verified structures. Complete sources, requirements and recovery connect them.

    Reader figures include actual CLI page metadata; local path length affects a small amount of framing. Projection figures compare capture bodies; the cycle table compares codec output. The reproduction script checks these distinct measurements and exact reconstruction.

    diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg index 2c9c0de3b2..0f20eca8cd 100644 --- a/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg +++ b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg @@ -1,7 +1,7 @@ Differential Delivery: Reuse Within an Epoch, Full Recovery on Break Within continuity epoch A, baseline is followed by verified delta 1 and delta 2. On compaction or continuity break, epoch B automatically resets with a fresh full baseline. - + \ No newline at end of file + diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg index 18b3c19ca3..060b7e26a4 100644 --- a/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg +++ b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg @@ -1,7 +1,7 @@ Differential:同一有效周期内复用,失效即完整恢复 在有效周期 A 内,完整基线后仅传递经哈希核验的 Δ1、Δ2;一旦发生上下文压缩或连续性失效,新周期 B 自动重置为完整来源。 - + \ No newline at end of file + diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg index ca446750e1..2046446f4a 100644 --- a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg +++ b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg @@ -1,7 +1,7 @@ - + Context Delivery: Standard Path Tree & JSON Pointer Structure Standard on-disk capture directory decision-<id>/, progressive JSON Pointer hierarchy in required-context.json, and context_capture_navigation_v1 envelope. - + \ No newline at end of file + Path Invariant: even when delivery.json is mode: "delta", recovery.reference_file points to current required-context.json for direct --select; context_details links to raw projection.json. + diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg index d8b7fd524a..f757ac3c99 100644 --- a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg +++ b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg @@ -1,7 +1,7 @@ - + Context Delivery 标准交付路径与 JSON Pointer 结构 展示 ~/.loopx/context-delivery/decision-<id>/ 标准目录树、required-context.json 内部 JSON Pointer 分层结构、以及 context_capture_navigation_v1 默认交付包络。 - + \ No newline at end of file + 核心路径不变量:即使 delivery.json 为 mode: "delta",recovery.reference_file 仍直指当前 required-context.json,支持直接 --select 任意当前事实;context_details 直通原始 projection.json。 + diff --git a/apps/presentation/site/public/blog/zh/context-delivery/index.html b/apps/presentation/site/public/blog/zh/context-delivery/index.html index 8c96105945..4110aeb177 100644 --- a/apps/presentation/site/public/blog/zh/context-delivery/index.html +++ b/apps/presentation/site/public/blog/zh/context-delivery/index.html @@ -174,7 +174,7 @@

    下一轮继续,交付这次改变了什么

    开启后,默认交付的是一个读取入口

    把前面的动作接回产品,当前支持的 Codex 原生 quota 路径是:

    -

    同一次捕获,从保存到读取

    Context Delivery 开启后的默认机制路径:完整原始捕获 projection.json、必要视图 required-context.json、小文件引用与按问题逐层选读
    decision-<id>/
    +

    同一次捕获,从保存到读取

    Context Delivery 开启后的默认机制路径:完整原始捕获 projection.json、必要视图 required-context.json、小文件引用与按问题逐层选读
    decision-<id>/
     ├─ projection.json        原始捕获
     ├─ required-context.json  必要视图
     ├─ delivery.json          full/delta
    @@ -201,7 +201,7 @@ 

    压缩或读取失败,恢复上下文,也保留原工作长内容跨页: 按 next_command 接读,保留捕获摘要、选择摘要和字节游标,按连续偏移组合正文。某组选读的 EOF 只覆盖该选择。
  • 遇到未知结构或不适用的来源: 保留完整内容及原有读取义务,不猜哪些文字可以隐藏。
  • -

    连续性与恢复

    Differential:同一有效周期内复用,失效即完整恢复

    同一有效周期:完整基线 → 新事实与差分 → 完整还原。

    新周期或已知连续性丢失:当前完整来源 → 必要事实重新读取。

    未结束的 Turn 保留原捕获、原工作与结算身份。恢复读取不重新执行外部副作用。
    +

    连续性与恢复

    Differential:同一有效周期内复用,失效即完整恢复

    同一有效周期:完整基线 → 新事实与差分 → 完整还原。

    新周期或已知连续性丢失:当前完整来源 → 必要事实重新读取。

    未结束的 Turn 保留原捕获、原工作与结算身份。恢复读取不重新执行外部副作用。

    这些数据说明了什么

    这组例子把三个收益来源分开了:少重复搬当前用不上的历史,少发本可合并的读取请求,少重复交付已经核验的不变结构。 完整来源、要求与恢复路径贯穿其中。

    上面的 reader 数字包含实际 CLI 响应中的分页元数据;本机路径长度会影响少量封装字节。原生投影数字比较捕获正文,周期表比较编码层,三种口径分别列出。示例脚本可复算这些值与完整还原结果。