[loopx-agent]

The 2.2 release guide described differential context without its progressive reading path and omitted the shipped Todo queue overview. Explain the enabled native path, current recovery selection, JSON Pointers, batched reads and subtree discovery in both languages, and add the fifteenth capability's activation, validation and rollback instructions.

Reconcile community attribution against the exact v2.1.1–candidate ancestry and merged PR metadata: 173 community PRs from 21 contributors, plus 12 verified direct community commits. Keep product groups first and retain existing contribution descriptions and links.

Validation: the bilingual 15-surface release-body gate, generated-manpage equality, CLI help/manpage and developer-book preflights, public-boundary checks, and the standard risk-based premerge gate all passed (17 selected premerge checks). Final release qualification, publication and installed-version readback remain separate work.

Contract: final release-body usage gate.

Visual evidence

Actual GitHub Markdown rendering at ae5b1e8c3ff2baef7d601351eb3d7ec36c2872f6, compared with b0768d953a6d9cc9a0786255f3969594535dabda. Public repository content only; this is documentation rendering, not a packaged or installed application qualification. The first viewport retains the upgrade decision and verification commands. Added context details and credits were also inspected lower in the populated document; the 390 px view wraps prose without document-level horizontal overflow. Long command blocks retain their own horizontal scrolling.

Before: first viewport

After: first viewport

Enabled context reading and recovery

Concrete community attribution

Narrow context guidance (390 × 900)

[loopx-agent]

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

Reviewer: actor_kind=model_agent; model=gpt-6.1-sol; provider=OpenAI; runtime_reported; reasoning_effort=max

动机 / Motivation

面向准备升级到 2.2 的操作者，以及需要按来源核对贡献归属的社区成员。

原说明只概述差分，读者还需自行查找渐进选读和当前恢复路径，也缺少已交付的队列概览用法；修改后可在同一份双语发布说明找到启用、核验、停用、边界和版本化文档。

已核对两种语言的 15 项能力用法、当前源码中的选读契约及完整贡献范围；文档验证和实际 GitHub 渲染均通过。

本 PR 不改变运行时、默认开关或权限，不声称完整 release 已合格，也不把文件字节变化当作模型 token、费用或任务收益。

固定源码的完整测试、真实模型与原生 Goal、打包安装旅程及最终发布渠道仍须独立通过。

改动思路 / Approach

沿既有发布说明补齐机制和用法，不另建一套配置或执行入口。完整来源、适用必要视图、有效周期的 full/delta 选择、默认文件引用和当前恢复读取各有自己的边界。已知 JSON Pointer 批量选读与陌生父节点的目录发现分别说明；连续性丢失保留原未结工作身份，不能重新准入或重复效果。

不修改已有开关和 parser。贡献归属从前一个正式 tag 的实际祖先范围和已合并 PR 元数据推导，保留原描述，再补新增贡献。这样比只增加宣传概述更能支持升级者核验，也比另开一份版本说明更容易保持唯一来源。本次差异仅一份 Markdown；不增加生产分支、持久状态或配置同步。

具体改动 / Changes

关键内容讲解

审阅精确版本 ae5b1e8c3ff2baef7d601351eb3d7ec36c2872f6，整个 PR 为一份文档增加 99 行、删除 39 行。英文和中文均补齐 context delivery 的 enabled path、当前 recovery 读取、批量 Pointer、子树目录和恢复限制；新增 Todo 概览五项使用字段和示例。社区归属核对为 21 位贡献者的 173 个已合并 PR 和 12 个独立提交，不把未关联提交虚构成 PR。

规范：docs/product/release-readiness.md#final-release-body-usage-gate，spec_revision: b0768d953a6d9cc9a0786255f3969594535dabda。按修改前已接受契约核对：

• release-body-completeness：implemented。保留原 14 项并新增第 15 项，双语启用、验证、停用／回退、权限边界、版本文档和命令检查全部通过。
• release-attribution：implemented。沿 v2.1.1 至候选祖先范围复核元数据，保持产品分组在前；两种语言保留全部 21 位作者、原描述和链接，并补齐新增 PR 与直接提交。
• current-source-boundary：implemented。按当前 reader 和 Todo 合同核对批量选择、缺失路径拒绝、数组位置绑定当前捕获、默认关闭、只读概览和完整读取义务；未完成的更广统一交付仍明示。

正向路径是升级者先读发布决策，再沿能力小节完成设置和真实验证；已知地址直接批量读取，不要求先翻旧基线。反向核对覆盖 Pointer 缺失或摘要不符、未知连续性和只读概览不能执行工作等文案，均沿已有失败／恢复 owner，不在本 PR 改造运行时。

对主干的风险 / Risks

主要风险是说明超出真实交付范围，或贡献范围／中英表述不一致。已将 native POSIX 边界、默认关闭、完整来源读取义务、MCP／Claude raw 输出和更广统一输入未完成保留在正文，并逐项核对贡献范围。发布说明仍须在真正发布时按最终 tag 和完整远端正文再次验证；此处的通过不替代 release 资格。

PASS：15 项双语发布正文校验、manpage 生成字节一致、CLI help/manpage 和 developer-book 预检、原生公开边界检查、git diff --check，以及标准 premerge 的 17 项检查。此文档 PR 不额外运行整套产品资格或付费模型；它们属于后续固定源码 release 验证。未查询、轮询或等待 PR CI。此前 a4 源码整套测试的九项失败保留原记录；其中三项后续未复现，原因未确认，不在这里宣布修复。

我的整体评价 / Verdict

problem_context: justified_increment。长程行为 preserved：无执行路径改动，完整要求、停止和恢复身份仍由原 owner 负责。用户旅程 improved：同一份说明给出完整使用入口，未增加确认轮次。已在实际 GitHub Markdown 页面检查首屏、中文上下文机制、长贡献者列表及页面底部的 Todo 用法，并检查 390 px 窄屏；正文和操作示例仍可区分，长代码块在自身区域滚动。 GitHub 发布页最终正文及各平台打包／安装界面尚未在此 PR 验证。

代码体量判定 necessary；唯一新增成本是双语说明与确切归属，没有兼容 decoder 或新配置。保留文档 owner 和现成验证器，未引入第二份产品事实。此精确版本可批准并在既有维护者授权下合并；完整 release 资格与渠道发布仍保持独立门槛。

English verdict: APPROVE — The bilingual documentation is consistent with the inspected contracts and local validation; full release qualification remains separate.