Repository navigation
docs(release): complete Core 2.4 upgrade guide and attribution - #8912
Conversation
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
REQUEST_CHANGES,P2:补齐版本区间内的首次社区贡献。 审查提交为 5e798c59f1df8c013af2062556e3cb3918834f7f。用法结构与操作边界可接受,当前归因遗漏仍须修复。
动机 / Motivation
准备升级 Core 2.4.0 或试用可选集成的用户,需要知道哪些行为已提供、怎样启用和验证,以及失败后怎样保留原工作。
此前已有版本锚点,却没有这份双语版本用法稿;候选把升级、旧暂停字段迁移及六项可选流程放到同一页,避免用户从提交历史拼接操作步骤。
双语用法结构、18 段 Bash 语法和九份版本文档路径已核对;贡献归因仍遗漏一位实际首次获合并的作者,因此本头尚不能作为完整的发行用法稿接受。
本次评审不发布 2.4.0,不修改安装或默认配置,也不把这份稿件当作原生 Host、真实模型或平台制品的资格证明。
必须补齐 #8459 的贡献归因并更正两语人数;最终整版发行、个人图文指南和公开渠道仍由原发布职责单独验收。
改动思路 / Approach
复用既有 release-readiness 契约和各能力的运行入口,以单份版本文档解释用户操作;无需新增状态、配置器或执行流程。
本 PR 只交付版本用法与准确归因;安装、回退执行、发布和真实环境采用仍保持各自现有 owner 与权限。
不改会继续缺少版本集中的用法;按现有模板补一份稿件是合理的独立增量。回退先核目标读取器、历史读取不重新授予执行权、恢复保留原 capture/Turn/结算身份,这些约束没有被压成笼统的“重新运行”。本次不要求文档 PR 完成整个发行。
具体改动 / Changes
完整差异只有一份 Markdown,+472/-0。依据修改前 docs/product/release-readiness.md,不可变版本 d210e4cc1d002f92498b2811c565b9430e79f4c1:upgrade-decision 已覆盖两语升级决策;optional-lifecycle 的六项启用、验证、停用、权限与版本文档均通过;qualification-boundary 保留给最终发行;community-attribution 当前未满足。
关键内容讲解
- 第39行升级决策和第280行中文段明确旧
paused/stopped迁移,由当前 registry owner 备份后执行,不把裸 pip 安装等同迁移成功。 - 第110行起六组可选流程有实际使用入口与停用路径;第133行完整 Turn 示例保留原捕获及诊断模式的权限区别,第213行备份段明确隔离检查不会激活历史租约。
- 第88行及第319行贡献列表声称完整,却都没有 @cf3901646 和 #8459。该 PR 改善 SQLite 底层错误的诊断,实际 merge commit
b8ff2b762a1e41811c132fb95d35fcb54af1ac52在92271fe114916428be6fd36558bb7a93fbe49da8..d210e4cc1d002f92498b2811c565b9430e79f4c1内;GitHub 记录其于2026-11-10合入,并且没有更早的该作者合并记录。
对主干的风险 / Risks
[P2] 版本归因漏掉实际首次贡献者。 我独立读取未饱和的594条近期 merged 元数据,用 mergeCommit 与上述完整 Git 区间相交得到420个 PR;社区作者集合为20位,首次获合并为9位。候选写成19/8,格式校验却仍通过,说明格式通过不能证明来源完整。请补齐这位作者、具体贡献和 PR 链接,并同步首屏、升级决策与中文段的人数;重算时不要只靠提交标题中的 PR 编号。
PASS 六项双语用法校验、18个 Bash 语法块、九份版本源码文档路径,以及标准 docs premerge。删除必填 Authority boundary 的独立临时变体会被同一校验拒绝。#8906 的原前置现在已合入,不需要重做其旧头审查。未来 v2.4.0 文档链接随最终 tag 生效,此处不按当前404判错。没有查询、轮询或等待 CI。
我的整体评价 / Verdict
文档是有用的发行准备增量。长程连续性方面,它保留原恢复身份和停止条件;用户体验方面,升级条件、最小读回和六项生命周期集中可查,且没有增加额外确认。
已在 GitHub 实际预览检查 1180px 首屏和 390px 的可选能力及中文备份恢复段。升级条件紧邻命令,能力各自分段;窄屏正文可读,代码块保留横向滚动。
这只是当前提交的 GitHub Markdown 展示,不能证明最终 Release 或个人飞书图文已发布;中文字段的星号未全部渲染成粗体,是可顺手修正的排版问题。
必须补齐 #8459 的贡献归因并更正两语人数;最终整版发行、个人图文指南和公开渠道仍由原发布职责单独验收。
修正归因后只需对新精确 head 复核完整文档与来源差异,最终发行资格保持单独核验。
English verdict: REQUEST_CHANGES at 5e798c5. The bilingual usage guide passes structural checks, but omits first-time contributor cf3901646 and PR #8459; correct both attribution lists and the 20/9 totals. Final release qualification remains separate.
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
APPROVE;当前头未发现阻断问题。 完整审查 29c4c8efbd23691df9c5958d3239a774b365eae4,原 #8459 贡献归因问题在本头已修复。
动机 / Motivation
准备升级 Core 2.4.0 或试用可选集成的用户,需要集中查看升级、恢复与权限边界。
此前缺少这份版本用法稿,原提交还漏掉一位首次贡献者;当前候选把七项可选流程与完整两语归因放到同一页。
完整文档、七项用法及新开关的实际 CLI 读取已核对,20位贡献者与9位首次获合并的两语集合和引用一致,原 #8459 漏项已修复。
本次接受版本用法文档,不实施发行、安装、生产迁移或实验。
最终干净源码、打包旅程、原生 Host、平台和真实模型、个人图文及渠道分发,仍沿原发布职责单独验收。
改动思路 / Approach
版本稿复用既有升级、扩展、材料、备份和上下文 owner,把用户可做的操作与所需权限放在一起。保持原有执行入口,不新增同步状态或另一个归因生成器。原发布流程增加九行来源检查,比只修这一次人数更能防止再次遗漏。当前边界是可独立使用和回退的文档增量,最终产品发行仍是下一步原有工作。
具体改动 / Changes
整个 base-to-head 差异为两份文档 +518/-0;另核对原 5e798c59f1df8c013af2062556e3cb3918834f7f 到本头的文档变化。依据修改前 docs/product/release-readiness.md 的不可变版本 05fb23c54ee2aabbb3b14a6d58943b29c4d64e85:upgrade-decision 与 optional-lifecycle 已实现,community-attribution 现在满足,qualification-boundary 继续由最终发行验收承担。
关键内容讲解
docs/product/releases/v2.4.0.md的两语升级决策保留旧暂停字段的备份迁移、原任务读回,以及目标旧读取器无法核验时保持现用运行时的边界。- 两语贡献清单补齐 cf3901646 的 SQLite 错误诊断与 #8459。本轮独立读到513条未饱和 merged 元数据,与
92271fe114916428be6fd36558bb7a93fbe49da8..05fb23c54ee2aabbb3b14a6d58943b29c4d64e85相交得到425个 PR;四个未直接对应的集成提交经 associated PR 核对,均归入已有 #8504/#8541。两语作者集合、所引 PR 作者与20/9标记一致。各作者最早合并记录与此前独立查询的边界一致,未沿用旧19/8结论。 - 新增第七项实验性工作记忆:默认off,既有原生根会话与来源捕获是前置,来源失败回退普通恢复;关闭移除命名空间以兼容旧编辑器。实际源码 CLI 在隔离配置中读回缺省off、文档所写JSON路径的true、移除后off,与已合入owner和设置保存/移除实现一致。没有把保存开关说成当前会话已采用。
对主干的风险 / Risks
PASS 七项两语用法门、20个 Bash 语法块、10份版本源码文档路径;删去一个必填权限字段的临时变体被同一校验拒绝。标准 premerge 的4项直接检查和17项选中检查通过,未跳过,公开边界检查通过。首次错误的 --quick 参数在解析阶段被拒,之后使用完整标准命令;该次未执行检查,不计为通过。没有查询、轮询或等待CI。
格式门不能证明贡献来源完整,因此另做上述 Git/GitHub 集合核验。文档没有修改产品默认值或活动配置;实际原生压缩、平台、付费模型和发行采用未执行。版本化链接随最终tag生效,不能从本稿推断2.4.0已可下载;最终范围若继续变化,归因应重算。
我的整体评价 / Verdict
这是有用、完整可审阅的发行准备增量:长程连续性保持原身份、Stop和必读约束;用户体验改善了升级和七项能力的集中查阅,没有新增确认轮次。新增检查落在现有发布流程,同领域无需另建运行时抽象。
已在当前提交的实际 GitHub Markdown 检查1180px首屏、贡献清单下部和390px中文实验用法。升级条件紧邻命令,修复后的中文标签清楚分组,长 JSON 路径可换行,代码块保留独立滚动。
这些观察限于此提交的 GitHub 文档;最终 Release 和个人图文的渲染、真实原生压缩采用及收益未在此评审中验收。
最终干净源码、打包旅程、原生 Host、平台和真实模型、个人图文及渠道分发,仍沿原发布职责单独验收。
English verdict: APPROVE at 29c4c8e. The missing contributor is restored, both 20/9 lists and all seven workflow entries are independently checked. Final release qualification remains separate.
Core 2.4.0 needs a versioned guide for upgrading existing work and using the optional workflows. This proposal documents the upgrade decision, legacy pause migration, original-Turn recovery and seven optional workflows in English and Chinese.
Contributor attribution is checked against actual GitHub merge commits in
v2.3.0(92271fe114916428be6fd36558bb7a93fbe49da8) through the verified source05fb23c54ee2aabbb3b14a6d58943b29c4d64e85: 20 community contributors, including nine first merged contributions. Both language lists include @cf3901646's SQLite diagnostics in #8459. The existing release procedure now checks complete range coverage and earlier author history, so commit-title PR numbers cannot silently define attribution.The guide also covers the default-off compaction working-memory setting merged in #8872: activation, persisted readback, source-bound recovery, disable/downgrade and its authority and unqualified outcome/cost boundaries. Chinese field labels render correctly in GitHub Markdown.
The documented rollback prerequisite #8906 is merged. Final source, packaged-product, native-Host, platform, real-model, personal illustrated-guide and distribution qualification continue under the existing release contract. Versioned links become available with the final tag. Independent review is required for this exact head; this PR delivers the guide and release procedure.
Validation at
29c4c8efbd23691df9c5958d3239a774b365eae4:Visual evidence
Actual GitHub Markdown at the tested head: 1180px desktop and 390px narrow viewport. The first viewport is byte-identical to the previous head, so one capture is reused. The detailed attribution now includes the missing author; the narrow view shows the corrected labels and new opt-in workflow. The page has no horizontal overflow at 390px; its code block retains its own scrolling.
These are public documentation captures. Final Release and personal-guide presentation retain their own readback.