Repository navigation
docs(release): document 2.2.0 upgrade and optional capabilities - #7511
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
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
APPROVE,精确 head 06afed92bad799fba6437ed353f797c7c26d384c。
动机 / Motivation
使用研究页、原会话报告、原生宿主或 Windows 安装的 2.x 用户与维护者。用户升级时需要在多份契约与 PR 中寻找功能入口,容易把候选、实验配置、后台前置和已发布完整旅程混为一谈。同一版本文档先回答升级与迁移决策,再按用户任务给出入口、结果核对和完整双语可选功能生命周期,能明确发现尚未资格化的边界。本文不改变产品代码、默认开关、权限或资格标准,不声称最终模型、安装、全仓或发布渠道已经通过。 本 PR 的可验收结果是完整、可追溯的版本使用文档,正式发布交付仍有独立流程;没有用说明文档替代真实运行证据。
改动思路 / Approach
沿用现有发布模板、功能 owner 和带版本文档,集中组织已经合入的变化,不新增设置、发布状态 owner 或重复产品规则。 对照 dd30e694a0c3db80e59600c781d67647a73d0bc9 的 docs/product/release-readiness.md 三个发布 owner:正文按 RELEASE-DECISION、OPTIONAL-LIFECYCLE、ATTRIBUTION、QUALIFICATION-TRUTH 四项判据逐一核对:第一实质段为五项升级决策,后续按五个产品组组织,再给社区归因与可选能力使用。原来的重复前置贡献名单移到产品内容之后,避免读者先看到维护工作再找用户结果。此处没有复杂控制流变化,采用直接文字解释即可。
具体改动 / Changes
新增一个 561 行版本文档,先解释研究结果到原始证据、原会话完整周期报告、中断恢复,以及显式上下文/Explore 选择;每项具体主张链接相关 PR。完整 Git 范围和 merged PR 元数据确认 11 位社区作者,双语名单逐项保留相同贡献范围和链接,不以 commit 显示名或搜索结果数量认定完整归因。
12 个可选面均解释启用、验证、停用/回退、权限边界与版本化文档。核对了 configure-goal 的默认预览与 --execute、Goal 范围 registry check、当前 SQLite 新建默认与已有 File/SQLite 选择的区别,以及原生上下文默认关闭和实际 lifecycle 证据要求。Windows 自动更新限 NSIS/main,稳定通道与 MSI 保留手动/不可用;minisign 不等于平台公证。重复 Task、显式 research checkpoint、被动诊断和 controller/executor 提案的阶段限制没有包装为完整产品旅程。
精确 head 的 premerge 4 项直接检查和 17 项选定检查通过;完整正文的 12 个双语可选面通过 usage validator;25 个版本化文档路径存在;独立隔离公开边界扫描通过。 全部可选项 validator 针对完整正文运行,版本路径逐一在当前源码存在,私有路径、密钥形状和内部文档链接检查无发现。源包版本与 editable import 路径已核对,验证没有生成或提交无关 lock 更新。没有 UI 实现变化,因此没有用旧截图或合成页面冒充新界面验证;实际图文指南仍单独创建与读回。
对主干的风险 / Risks
主要风险是文档过度承诺:配置存在不等于真实宿主使用,引用绑定不证明科学结论,Task 完成不等于完整报告送达,CLI 版本不证明 App 版本。全文分别保留上述边界,以及未知操作先读回、原权限/配额/lease 不变、旧冻结 cohort 不重认证和升级不迁移 authority 的限制。英文与中文结构对应,破坏性兼容说明明确给出旧未迁移集成的迁移路径,不能只写没有破坏性变更。
我的整体评价 / Verdict
这是一份独立且可逆的公开说明,帮助读者判断升级、找到已有入口并验证返回结果。沿用已有功能与发布 owner 足够,不需要新增状态或框架。删去重复前置块是同域简化,必要生命周期内容保留。正式发布仍须统一 clean commit 的完整资格、个人账户图文指南和各渠道制品读回;这些由发布流程继续完成。 当前批准只覆盖这份文档,整体发布的失败、跳过和未验证项继续保持原记录;CI 按 Goal 配置未查询。
English verdict: APPROVE 06afed92bad799fba6437ed353f797c7c26d384c. The complete bilingual document passes the twelve-surface usage gate, versioned-path checks and exact-head premerge/public-boundary validation. It preserves activation, authority, migration and experimental limits. Final model, installed-artifact and release-channel qualification remains separate.
Problem and result
2.2.0 needs versioned, bilingual upgrade guidance for its research reading, original-conversation reports, recovery and optional host capabilities. This document records the changed defaults, explicit enable/verify/disable paths, privacy and authority limits, and concrete community contributions derived from the previous tag and merged PR metadata.
Validation and limits
The complete optional-surface usage validator passes for all 12 entries; all 25 versioned documentation paths resolve in this source. The document separates candidate source, release qualification and installed artifacts: it does not assert that final release or model gates have passed. Exact-head risk-based validation and public-boundary checks are recorded in the review.
Specification: docs/product/release-readiness.md, Release Note Checklist, Personal Feishu Release Guide and Final Release Body Usage Gate. The personal illustrated guide and final external release body remain separate release deliverables.