Skip to content

Align public entry with goal-first experience - #8590

Merged
huangruiteng merged 7 commits into
mainfrom
codex/zero-ritual-public-entry-20261111
Nov 12, 2026
Merged

huangruiteng merged 7 commits into
mainfrom
codex/zero-ritual-public-entry-20261111

Conversation

@cocolord

@cocolord cocolord commented Nov 11, 2026 •

Copy link
Copy Markdown
Member

Summary

  • make the README default entry goal-first by replacing early control-plane wording with plan, decision, verification and durable-state language
  • move the control-plane board behind an advanced details section while preserving the architecture path for readers who need it
  • update the public homepage hero, setup prompt, SEO metadata and replay labels so first contact starts from one natural-language goal instead of P0/GATE/control-plane vocabulary
  • keep one-run first-screen captures out of the final source tree; the visual evidence below is pinned to immutable revisions

Visual evidence

Build/data boundary: local packaged public-site build with synthetic homepage illustration data. Current reviewed source head is a5eba6133a57c84b8eab529dcfd2317f84a455e3. The before captures are pinned to current base 3a5899f00cab97294c20459ac8508d16dc317492. The after captures were taken at evidence revision c552d2906ec2a8c97e16778f835a2c0ae33e0431; the reviewed source files for this PR are content-identical between that evidence revision and the current head, while the final head keeps those one-run PNG files out of the tree per the visual evidence retention policy.

Before, desktop first screen at base 3a5899f00cab97294c20459ac8508d16dc317492:

Before desktop first screen

After, desktop first screen at evidence revision c552d2906ec2a8c97e16778f835a2c0ae33e0431:

After desktop first screen

Before, mobile first screen at base 3a5899f00cab97294c20459ac8508d16dc317492:

Before mobile first screen

After, mobile first screen at evidence revision c552d2906ec2a8c97e16778f835a2c0ae33e0431:

After mobile first screen

Screenshot metadata readback for the after captures: desktop 1440x1100 PNG, mobile 390x844 PNG, no alpha, no color profile. Manual inspection found no private material or local paths.

Validation

  • npm run build
  • npm run smoke:seo
  • npm run smoke:frontstage-share-bundle
  • uv run --no-sync --extra test python examples/control_plane/cli-output-budget-regression-smoke.py
  • uv run --no-sync --extra test python examples/semantic-vocabulary-drift-smoke.py
  • git diff --check origin/main...HEAD
  • PR_BASE_REF=origin/main uv run --no-sync --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main (passed; changed_files=5; manual_holds=0)

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Reviewer: model_agent · GPT-5 · TRAE · self_reported

动机 / Motivation

外部新用户和维护者第一次接触 LoopX 时,默认入口不应先要求理解 control-plane、P0/P1/P2、GATE 或 Evidence 等内部术语。这个 PR 的目标来自当前产品入口的零仪式改造:先让用户给已有 Agent 一个自然语言目标,再把计划、需要人判断的决策和可验证结果放到可见但不压迫的默认路径里。

此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results,控制层图和机制说明移到 Advanced/details 或 Learn 这样的深水区。

可观察结果是:默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺,面向贡献者和调试者的机制入口也没有删除。非目标是重写所有文档、证明整张目标图覆盖的每一个公共页面,或改变运行时权限/调度语义;这个 PR 是一个可独立验证的 public default entry 增量。

Before/after scenario: 此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results。

Observable outcome: 默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺。

Remaining gap: 剩余缺口是继续盘点其它公共页面和安装后产品路径,确认同一 zero-ritual 原则没有被其它首屏重新打破。

改动思路 / Approach

改动选择复用现有 README 和 public site 的内容 owner,而不是新增一个配置层、实验开关或第二套入口。权威输入是当前 public default journey:README 首屏、Quick Start、主页 hero、setup prompt、SEO metadata 和第一屏截图;状态/调度/ownership 仍由已有 LoopX state layer 和高级文档解释。

架构判断是保留默认路径与高级路径的分层:默认路径讲 outcome、current work、decision、verified result;高级路径仍能看到 control layer、kernel、evidence 和协议词汇。这个 current PR boundary 只改公共入口的叙事和响应式首屏,不改 CLI 合约、Goal/Todo 存储、quota、lease 或 runtime 行为。更小的单点文案替换会留下 README 与站点互相打架;更大的全站改造会超出本次可审查边界,所以这个切片在产品入口和验证成本之间是合适的。

Architecture assessment reason: The mechanism is a static public-entry content change owned by README/site surfaces; current_pr_boundary is the default first-contact copy, SEO metadata, responsive first-screen CSS and visual evidence only.

current_pr_boundary: README and public homepage default entry, SEO metadata, mobile first-screen layout, and review screenshots; no runtime/control-plane behavior.

具体改动 / Changes

相对 exact head 2f87e6981db4fa19220509e7a7a2b19b650211f4,PR 修改 6 个 tracked 文件:README、主页 React 内容、主页 metadata、移动 CSS 约束,以及两张 public-safe first-screen review PNG。没有新增协议字段、enum、CLI option、状态迁移或权限入口;行为承载面是用户看到的默认入口和复制给 Agent 的 setup prompt。

关键内容讲解

  • README.md 首屏第 7-16 行把 promise 改成 “Start with one goal” 和 local-first state;Quick Start 第 37-47 行要求用户给 Agent 一个 natural-language goal,并把输出描述为 visible plan、needed decisions 和 verification。第 71-118 行把 control layer 图折进 Advanced: how the control layer works and where it fits,证明机制没有消失,只是从默认路径后移。
  • apps/presentation/site/src/App.tsx 第 34-43 行的英文 setup prompt 不再要求把目标写成 P0/P1/P2 todos,而是要求展示 current work、needed decision 和 next safe action。第 71-137 行的英文 hero 和第 188-255 行的中文 hero 同步替换 “gate/evidence/P0” 语言,同时第 348-390 行把首屏 panel 标签改为 CURRENT GOAL、NOW、DECISION 和 Verified result。
  • apps/presentation/site/src/page-metadata.ts 第 26-34 行把首页 SEO 描述从 gates/evidence 改成 decisions/verification,避免搜索结果继续暴露内部税。
  • apps/presentation/site/src/styles.css 第 260-304 行和第 1810-1848 行给 hero copy、title line、mobile header/download button 设置宽度和换行约束,配合 Puppeteer 读回确认 390x844 和 1440x1100 没有 document horizontal overflow。
  • apps/presentation/site/review/zero-ritual-home-desktop.png 与 apps/presentation/site/review/zero-ritual-home-mobile.png 是 exact-head public visual evidence;像素内容只包含公开主页首屏,没有本地路径、私有目标或内部日志。

未找到 accepted public RFC 或 contract 专门定义“zero-ritual public entry”,因此 spec_basis 是 no_spec;本次判断依据是当前用户授权的目标和仓库 public-entry/design 规则,而不是把 patch 自己当规范。

对主干的风险 / Risks

主要风险是把内部机制藏得过深,导致贡献者找不到 control layer、kernel 或 evidence 细节。当前 diff 的缓解是 README 只折叠 advanced control-layer 图和说明,没有删除 Learn、architecture、protocol 和 evidence 章节;rg 仍能在后续学习/证据章节找到 mechanism vocabulary,而默认首屏不再强迫新用户先理解它们。

第二个风险是可见文案与真实运行时语义不一致。这里没有改 runtime、scheduler、quota、Todo 或权限模型,所以旧的 durable state、evidence 和 recovery 语义仍由既有实现承担;setup prompt 只是把 agent-facing 文本从 P0/GATE 义务改成 current work/decision/next action 的用户语言。这个语义变化是有授权的:目标就是降低默认入口的 vocabulary tax,同时保留高级/调试解释。

验证结果:npm run build PASS,npm run smoke:seo PASS,git diff --check origin/main...HEAD PASS,python3 scripts/check_rfc_bilingual.py --base origin/main --head HEAD PASS。根目录 uv run --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main 的 direct checks、7 个 catalog canaries、8 个 risk-profile smokes 和 public-boundary scan 全部 PASS;gate 返回 manual_review_required 只因为两张 PNG 是二进制视觉证据。两张 PNG 已人工查看像素,并用 sips 确认 desktop 为 1440x1100、mobile 为 390x844、PNG、无 alpha、无 color profile。远端 GitHub checks 在复核时仍有 queued/pending 项,且 PR mergeStateStatus 是 BEHIND;这些是 merge readiness gate,不是当前 diff 的代码阻断发现。

语义与 CI 对齐

本 PR 复用已有 public-entry 和 durable-state 词汇,没有新增共享状态 vocabulary。agent-consumed setup prompt 的 clause 变化是 intentional_change_validated:旧 clause 要求 P0/P1/P2 和 gate 展示,新 clause 要求 current work、decision that needs me、next safe action,授权基础就是本次 public default entry 目标。CI/readiness 未被伪装成 green;pending checks 和 BEHIND 状态在 merge 前仍必须单独处理。

我的整体评价 / Verdict

APPROVE(以 author-owned COMMENTED 形式记录)。 我没有发现 blocking finding。这个切片让 README 和主页默认入口明显更接近“一句话目标开始”,同时仍保留高级机制路径、public evidence 区和贡献者入口;对长程目标是 justified increment,而不是宣称整张目标图已经全部完成。

用户体验维度 improved:desktop 1440x1100 首屏可见 outcome、progress visible、current goal、decision 和 verified result;mobile 390x844 首屏没有横向溢出,优先露出 headline、body、Download、Get started 和 host chips。visual_review inspected: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. Expanded/lower-page content was not claimed as fully visually reviewed in this slice. unverified_scope: Other public pages, installed desktop journey, third-party documentation, and expanded/lower homepage sections remain to audit in later slices.long_horizon 维度 preserved/improved:状态层和 evidence/recovery 承诺没有削弱,默认入口减少了新用户进入长期工作前的解释成本。

Merge 结论仍要分开:当前 head 2f87e6981db4fa19220509e7a7a2b19b650211f4 已有本地验证和视觉人工审查,但 PR 仍处于 BEHIND 且远端 required checks 可能还未完成;合并前必须重新读回 unchanged head,跑 merge-readiness,并遵守维护者授权和仓库 policy。

English verdict: APPROVE - head 2f87e6981db4fa19220509e7a7a2b19b650211f4 has no blocking findings for the bounded public-entry slice; local build, SEO smoke, diff/RFC checks, premerge canary, public-boundary scan, and manual screenshot inspection pass, while pending CI and BEHIND merge state remain separate merge-readiness holds.

@cocolord
cocolord force-pushed the codex/zero-ritual-public-entry-20261111 branch from eb6d9fd to cc24465 Compare November 11, 2026 09:39

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Reviewer: model_agent · GPT-5 · TRAE · self_reported

动机 / Motivation

外部新用户和维护者第一次接触 LoopX 时,默认入口不应先要求理解 control-plane、P0/P1/P2、GATE 或 Evidence 等内部术语。这个 PR 的目标来自当前产品入口的零仪式改造:先让用户给已有 Agent 一个自然语言目标,再把计划、需要人判断的决策和可验证结果放到可见但不压迫的默认路径里。

此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results,控制层图和机制说明移到 Advanced/details 或 Learn 这样的深水区。

可观察结果是:默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺,面向贡献者和调试者的机制入口也没有删除。非目标是重写所有文档、证明整张目标图覆盖的每一个公共页面,或改变运行时权限/调度语义;这个 PR 是一个可独立验证的 public default entry 增量。

Before/after scenario: 此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results。

Observable outcome: 默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺。

Remaining gap: 剩余缺口是继续盘点其它公共页面和安装后产品路径,确认同一 zero-ritual 原则没有被其它首屏重新打破。

改动思路 / Approach

改动选择复用现有 README 和 public site 的内容 owner,而不是新增一个配置层、实验开关或第二套入口。权威输入是当前 public default journey:README 首屏、Quick Start、主页 hero、setup prompt、SEO metadata 和第一屏截图;状态/调度/ownership 仍由已有 LoopX state layer 和高级文档解释。

架构判断是保留默认路径与高级路径的分层:默认路径讲 outcome、current work、decision、verified result;高级路径仍能看到 control layer、kernel、evidence 和协议词汇。这个 current PR boundary 只改公共入口的叙事和响应式首屏,不改 CLI 合约、Goal/Todo 存储、quota、lease 或 runtime 行为。更小的单点文案替换会留下 README 与站点互相打架;更大的全站改造会超出本次可审查边界,所以这个切片在产品入口和验证成本之间是合适的。

Architecture assessment reason: The mechanism is a static public-entry content change owned by README/site surfaces; current_pr_boundary is the default first-contact copy, SEO metadata, responsive first-screen CSS and visual evidence only.

current_pr_boundary: README and public homepage default entry, SEO metadata, mobile first-screen layout, and review screenshots; no runtime/control-plane behavior.

具体改动 / Changes

相对 exact head cc244654b15face184126c358f67dab26c939f00,PR 修改 7 个 tracked 文件:README、主页 React 内容、主页 metadata、移动 CSS 约束、frontstage share bundle smoke,以及两张 public-safe first-screen review PNG。没有新增协议字段、enum、CLI option、状态迁移或权限入口;行为承载面是用户看到的默认入口、复制给 Agent 的 setup prompt,以及保护该 prompt 不回退到旧 P0/GATE 语言的 smoke oracle。

关键内容讲解

  • README.md 首屏第 7-16 行把 promise 改成 “Start with one goal” 和 local-first state;Quick Start 第 37-47 行要求用户给 Agent 一个 natural-language goal,并把输出描述为 visible plan、needed decisions 和 verification。第 71-118 行把 control layer 图折进 Advanced: how the control layer works and where it fits,证明机制没有消失,只是从默认路径后移。
  • apps/presentation/site/src/App.tsx 第 34-43 行的英文 setup prompt 不再要求把目标写成 P0/P1/P2 todos,而是要求展示 current work、needed decision 和 next safe action。第 71-137 行的英文 hero 和第 188-255 行的中文 hero 同步替换 “gate/evidence/P0” 语言,同时第 348-390 行把首屏 panel 标签改为 CURRENT GOAL、NOW、DECISION 和 Verified result。
  • examples/frontstage-share-bundle-smoke.mjs 第 329-347 行同步更新 homepage setup prompt oracle:保留当前项目接入、no-clone installer、README Quick Start、doctor、connect/bootstrap 等真实安装契约,但把旧的 current user gate/top agent todo/P0 期望替换为 one natural-language goal、current work/decision/next safe action 和 internal terms behind advanced/debug explanations,避免 CI 把默认入口拉回旧术语。
  • apps/presentation/site/src/page-metadata.ts 第 26-34 行把首页 SEO 描述从 gates/evidence 改成 decisions/verification,避免搜索结果继续暴露内部税。
  • apps/presentation/site/src/styles.css 第 260-304 行和第 1810-1848 行给 hero copy、title line、mobile header/download button 设置宽度和换行约束,配合 Puppeteer 读回确认 390x844 和 1440x1100 没有 document horizontal overflow。
  • apps/presentation/site/review/zero-ritual-home-desktop.png 与 apps/presentation/site/review/zero-ritual-home-mobile.png 是 exact-head public visual evidence;像素内容只包含公开主页首屏,没有本地路径、私有目标或内部日志。

未找到 accepted public RFC 或 contract 专门定义“zero-ritual public entry”,因此 spec_basis 是 no_spec;本次判断依据是当前用户授权的目标和仓库 public-entry/design 规则,而不是把 patch 自己当规范。

对主干的风险 / Risks

主要风险是把内部机制藏得过深,导致贡献者找不到 control layer、kernel 或 evidence 细节。当前 diff 的缓解是 README 只折叠 advanced control-layer 图和说明,没有删除 Learn、architecture、protocol 和 evidence 章节;rg 仍能在后续学习/证据章节找到 mechanism vocabulary,而默认首屏不再强迫新用户先理解它们。

第二个风险是可见文案与真实运行时语义不一致。这里没有改 runtime、scheduler、quota、Todo 或权限模型,所以旧的 durable state、evidence 和 recovery 语义仍由既有实现承担;setup prompt 只是把 agent-facing 文本从 P0/GATE 义务改成 current work/decision/next action 的用户语言。这个语义变化是有授权的:目标就是降低默认入口的 vocabulary tax,同时保留高级/调试解释。

验证结果:npm run build PASS,npm run smoke:seo PASS,npm run smoke:frontstage-share-bundle PASS,git diff --check origin/main...HEAD PASS,python3 scripts/check_rfc_bilingual.py --base origin/main --head HEAD PASS。根目录 uv run --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main 的 direct checks、10 个 catalog canaries、8 个 risk-profile smokes 和 public-boundary scan 全部 PASS;gate 返回 manual_review_required 只因为两张 PNG 是二进制视觉证据。两张 PNG 已人工查看像素,并用 sips 确认 desktop 为 1440x1100、mobile 为 390x844、PNG、无 alpha、无 color profile。远端 GitHub checks 在复核时仍有 queued/pending 项,且 PR mergeStateStatus 是 BLOCKED;这些是 merge readiness gate,不是当前 diff 的代码阻断发现。

语义与 CI 对齐

本 PR 复用已有 public-entry 和 durable-state 词汇,没有新增共享状态 vocabulary。agent-consumed setup prompt 的 clause 变化是 intentional_change_validated:旧 clause 要求 P0/P1/P2 和 gate 展示,新 clause 要求 current work、decision that needs me、next safe action,授权基础就是本次 public default entry 目标。CI/readiness 未被伪装成 green;pending checks 和 BLOCKED 状态在 merge 前仍必须单独处理。

我的整体评价 / Verdict

APPROVE(以 author-owned COMMENTED 形式记录)。 我没有发现 blocking finding。这个切片让 README 和主页默认入口明显更接近“一句话目标开始”,同时仍保留高级机制路径、public evidence 区和贡献者入口;对长程目标是 justified increment,而不是宣称整张目标图已经全部完成。

用户体验维度 improved:desktop 1440x1100 首屏可见 outcome、progress visible、current goal、decision 和 verified result;mobile 390x844 首屏没有横向溢出,优先露出 headline、body、Download、Get started 和 host chips。visual_review inspected: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. Expanded/lower-page content was not claimed as fully visually reviewed in this slice. unverified_scope: Other public pages, installed desktop journey, third-party documentation, and expanded/lower homepage sections remain to audit in later slices.long_horizon 维度 preserved/improved:状态层和 evidence/recovery 承诺没有削弱,默认入口减少了新用户进入长期工作前的解释成本。

Merge 结论仍要分开:当前 head cc244654b15face184126c358f67dab26c939f00 已有本地验证和视觉人工审查,但 PR 仍处于 BLOCKED 且远端 required checks 可能还未完成;合并前必须重新读回 unchanged head,跑 merge-readiness,并遵守维护者授权和仓库 policy。

English verdict: APPROVE - head cc244654b15face184126c358f67dab26c939f00 has no blocking findings for the bounded public-entry slice; local build, SEO smoke, diff/RFC checks, premerge canary, public-boundary scan, and manual screenshot inspection pass, while pending CI and BLOCKED merge state remain separate merge-readiness holds.

@cocolord
cocolord force-pushed the codex/zero-ritual-public-entry-20261111 branch from cc24465 to cbfed23 Compare November 11, 2026 10:14

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Reviewer: model_agent · GPT-5 · TRAE · self_reported

动机 / Motivation

外部新用户和维护者第一次接触 LoopX 时,默认入口不应先要求理解 control-plane、P0/P1/P2、GATE 或 Evidence 等内部术语。这个 PR 的目标来自当前产品入口的零仪式改造:先让用户给已有 Agent 一个自然语言目标,再把计划、需要人判断的决策和可验证结果放到可见但不压迫的默认路径里。

此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results,控制层图和机制说明移到 Advanced/details 或 Learn 这样的深水区。

可观察结果是:默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺,面向贡献者和调试者的机制入口也没有删除。非目标是重写所有文档、证明整张目标图覆盖的每一个公共页面,或改变运行时权限/调度语义;这个 PR 是一个可独立验证的 public default entry 增量。

Before/after scenario: 此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results。

Observable outcome: 默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺。

Remaining gap: 剩余缺口是继续盘点其它公共页面和安装后产品路径,确认同一 zero-ritual 原则没有被其它首屏重新打破。

改动思路 / Approach

改动选择复用现有 README 和 public site 的内容 owner,而不是新增一个配置层、实验开关或第二套入口。权威输入是当前 public default journey:README 首屏、Quick Start、主页 hero、setup prompt、SEO metadata 和第一屏截图;状态/调度/ownership 仍由已有 LoopX state layer 和高级文档解释。

架构判断是保留默认路径与高级路径的分层:默认路径讲 outcome、current work、decision、verified result;高级路径仍能看到 control layer、kernel、evidence 和协议词汇。这个 current PR boundary 只改公共入口的叙事和响应式首屏,不改 CLI 合约、Goal/Todo 存储、quota、lease 或 runtime 行为。更小的单点文案替换会留下 README 与站点互相打架;更大的全站改造会超出本次可审查边界,所以这个切片在产品入口和验证成本之间是合适的。

Architecture assessment reason: The mechanism is a static public-entry content change owned by README/site surfaces; current_pr_boundary is the default first-contact copy, SEO metadata, responsive first-screen CSS and visual evidence only.

current_pr_boundary: README and public homepage default entry, SEO metadata, mobile first-screen layout, and review screenshots; no runtime/control-plane behavior.

具体改动 / Changes

相对 exact head cbfed23155d7bf324aadb9b7df376c34819cc245,PR 修改 7 个 tracked 文件:README、主页 React 内容、主页 metadata、移动 CSS 约束、frontstage share bundle smoke,以及两张 public-safe first-screen review PNG。没有新增协议字段、enum、CLI option、状态迁移或权限入口;行为承载面是用户看到的默认入口、复制给 Agent 的 setup prompt,以及保护该 prompt 不回退到旧 P0/GATE 语言的 smoke oracle。

关键内容讲解

  • README.md 首屏第 7-16 行把 promise 改成 “Start with one goal” 和 local-first state;Quick Start 第 37-47 行要求用户给 Agent 一个 natural-language goal,并把输出描述为 visible plan、needed decisions 和 verification。第 71-118 行把 control layer 图折进 Advanced: how the control layer works and where it fits,证明机制没有消失,只是从默认路径后移。
  • apps/presentation/site/src/App.tsx 第 34-43 行的英文 setup prompt 不再要求把目标写成 P0/P1/P2 todos,而是要求展示 current work、needed decision 和 next safe action。第 71-137 行的英文 hero 和第 188-255 行的中文 hero 同步替换 “gate/evidence/P0” 语言,同时第 348-390 行把首屏 panel 标签改为 CURRENT GOAL、NOW、DECISION 和 Verified result。
  • examples/frontstage-share-bundle-smoke.mjs 第 329-347 行同步更新 homepage setup prompt oracle:保留当前项目接入、no-clone installer、README Quick Start、doctor、connect/bootstrap 等真实安装契约,但把旧的 current user gate/top agent todo/P0 期望替换为 one natural-language goal、current work/decision/next safe action 和 internal terms behind advanced/debug explanations,避免 CI 把默认入口拉回旧术语。
  • apps/presentation/site/src/page-metadata.ts 第 26-34 行把首页 SEO 描述从 gates/evidence 改成 decisions/verification,避免搜索结果继续暴露内部税。
  • apps/presentation/site/src/styles.css 第 260-304 行和第 1810-1848 行给 hero copy、title line、mobile header/download button 设置宽度和换行约束,配合 Puppeteer 读回确认 390x844 和 1440x1100 没有 document horizontal overflow。
  • apps/presentation/site/review/zero-ritual-home-desktop.png 与 apps/presentation/site/review/zero-ritual-home-mobile.png 是 exact-head public visual evidence;像素内容只包含公开主页首屏,没有本地路径、私有目标或内部日志。

未找到 accepted public RFC 或 contract 专门定义“zero-ritual public entry”,因此 spec_basis 是 no_spec;本次判断依据是当前用户授权的目标和仓库 public-entry/design 规则,而不是把 patch 自己当规范。

对主干的风险 / Risks

主要风险是把内部机制藏得过深,导致贡献者找不到 control layer、kernel 或 evidence 细节。当前 diff 的缓解是 README 只折叠 advanced control-layer 图和说明,没有删除 Learn、architecture、protocol 和 evidence 章节;rg 仍能在后续学习/证据章节找到 mechanism vocabulary,而默认首屏不再强迫新用户先理解它们。

第二个风险是可见文案与真实运行时语义不一致。这里没有改 runtime、scheduler、quota、Todo 或权限模型,所以旧的 durable state、evidence 和 recovery 语义仍由既有实现承担;setup prompt 只是把 agent-facing 文本从 P0/GATE 义务改成 current work/decision/next action 的用户语言。这个语义变化是有授权的:目标就是降低默认入口的 vocabulary tax,同时保留高级/调试解释。

验证结果:npm run build PASS,npm run smoke:seo PASS,npm run smoke:frontstage-share-bundle PASS,git diff --check origin/main...HEAD PASS,python3 scripts/check_rfc_bilingual.py --base origin/main --head HEAD PASS。根目录 uv run --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main 的 direct checks、10 个 catalog canaries、8 个 risk-profile smokes 和 public-boundary scan 全部 PASS;gate 返回 manual_review_required 只因为两张 PNG 是二进制视觉证据。两张 PNG 已人工查看像素,并用 sips 确认 desktop 为 1440x1100、mobile 为 390x844、PNG、无 alpha、无 color profile。远端 GitHub checks 在复核时仍有 queued/pending 项,且 PR mergeStateStatus 是 BEHIND;这些是 merge readiness gate,不是当前 diff 的代码阻断发现。

语义与 CI 对齐

本 PR 复用已有 public-entry 和 durable-state 词汇,没有新增共享状态 vocabulary。agent-consumed setup prompt 的 clause 变化是 intentional_change_validated:旧 clause 要求 P0/P1/P2 和 gate 展示,新 clause 要求 current work、decision that needs me、next safe action,授权基础就是本次 public default entry 目标。CI/readiness 未被伪装成 green;pending checks 和 BEHIND 状态在 merge 前仍必须单独处理。

我的整体评价 / Verdict

APPROVE(以 author-owned COMMENTED 形式记录)。 我没有发现 blocking finding。这个切片让 README 和主页默认入口明显更接近“一句话目标开始”,同时仍保留高级机制路径、public evidence 区和贡献者入口;对长程目标是 justified increment,而不是宣称整张目标图已经全部完成。

用户体验维度 improved:desktop 1440x1100 首屏可见 outcome、progress visible、current goal、decision 和 verified result;mobile 390x844 首屏没有横向溢出,优先露出 headline、body、Download、Get started 和 host chips。visual_review inspected: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. Expanded/lower-page content was not claimed as fully visually reviewed in this slice. unverified_scope: Other public pages, installed desktop journey, third-party documentation, and expanded/lower homepage sections remain to audit in later slices.long_horizon 维度 preserved/improved:状态层和 evidence/recovery 承诺没有削弱,默认入口减少了新用户进入长期工作前的解释成本。

Merge 结论仍要分开:当前 head cbfed23155d7bf324aadb9b7df376c34819cc245 已有本地验证和视觉人工审查,但 PR 仍处于 BEHIND 且远端 required checks 可能还未完成;合并前必须重新读回 unchanged head,跑 merge-readiness,并遵守维护者授权和仓库 policy。

English verdict: APPROVE - head cbfed23155d7bf324aadb9b7df376c34819cc245 has no blocking findings for the bounded public-entry slice; local build, SEO smoke, diff/RFC checks, premerge canary, public-boundary scan, and manual screenshot inspection pass, while pending CI and BEHIND merge state remain separate merge-readiness holds.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · max

本次评审对应提交 cbfed23155d7bf324aadb9b7df376c34819cc245。

[P2] 首屏截图应随 PR 证据保留。 两张一次性截图(共 309,749 字节)进入了 Git 源码;PR 的图链跟随分支,未固定生成版本。后续推送可以改掉同一链接所代表的画面。已核对没有发布产物、当前指南或固定测试需要这两个 blob。 从源树移除两张 PNG;把桌面/手机的前后画面直接附在 PR 或固定到带完整修订号的持久产物,并标明构建和合成数据边界。 桌面 · 手机

动机 / Motivation

首次打开 LoopX 首页或 README 的人需要知道如何开始一项长程工作,以及下一步在哪里。旧首屏把 gates、P0 和 evidence 放在日常文案中;README 默认展开控制层图。Get started 已经提供 Agent 引导和手动 Shell。新首屏保留下载和开始使用,以当前目标、需要你的决定和已验证结果解释跨会话工作;README 把架构板留给 Advanced 展开,仍用同一 setup。新首屏保留下载和开始使用,以当前目标、需要你的决定和已验证结果解释跨会话工作;README 把架构板留给 Advanced 展开,仍用同一 setup。在本地锁定依赖构建的静态站,用合成示意数据和浏览器剪贴板拦截验证;未运行复制出来的安装命令,也未验证真实 Agent 的采用或生产站发布。两张一次性截图(共 309,749 字节)进入了 Git 源码;PR 的图链跟随分支,未固定生成版本。后续推送可以改掉同一链接所代表的画面。已核对没有发布产物、当前指南或固定测试需要这两个 blob。

改动思路 / Approach

首页、README 和现有 setup 对话框各自保留职责。只调整公共入口,截图证据沿用 PR 交付规则。 默认入口继续复用已有下载、setup 和项目启动流程。内部术语可以留在高级解释;实际持久化仍由现有项目流程负责。

具体改动 / Changes

关键代码讲解

以 docs/development/documentation-layout.md#visual-evidence-retention @ 0a654c6 为依据。VIS-ENTRY、VIS-SETUP 已验证;VIS-RETENTION 未通过。仓库保留规则。

README Advanced 保留原架构图和概念入口;引导文案 使用已知目标,仍先确认连接,只在缺少目标时再问;复制 继续用同一手动命令。/loopx 启动规则 仍要求先计划、再按序写入工作。窄屏样式 保留可访问的下载和首屏开始操作。SEO 和静态分享测试跟随公共文案。

对主干的风险 / Risks

两张一次性截图(共 309,749 字节)进入了 Git 源码;PR 的图链跟随分支,未固定生成版本。后续推送可以改掉同一链接所代表的画面。已核对没有发布产物、当前指南或固定测试需要这两个 blob。 从源树移除两张 PNG;把桌面/手机的前后画面直接附在 PR 或固定到带完整修订号的持久产物,并标明构建和合成数据边界。 目前 PR 里只有 after 图,且两个 URL 都使用可移动的分支名。

语义与 CI 对齐

用锁定依赖构建;SEO 的 5 个预渲染路由与 28 个站点地图目标、公开分享包 smoke、diff 检查均通过。实际在本地静态站核对英中页面和两个复制入口。用于对照的原提交与当前 rebase 的全部页面、构建输入、资产和改动文件均一致;未查询托管 CI。

我的整体评价 / Verdict

公共入口这部分可保留。请先把首屏证据移到固定修订的 PR 附件或持久产物,再删除 Git 里的两张一次性 PNG。桌面看到了目标、进行中、需判断与已保存结果并列;手机首屏把两项主要操作放在图示前,390 像素仍显示语言、下载和菜单,320 像素保留首屏下载和开始使用。Advanced 展开仍可找到原架构图。这里验证了静态首页首屏与 setup 文案和操作;README 的展开内容按源码核对,未实测 GitHub 上的渲染,也未验证生产部署、安装或真实 Agent 的使用效果。

English verdict: REQUEST_CHANGES. At cbfed23, the static site and setup checks pass. Attach revision-pinned before/after evidence and remove the two single-run PNGs from the source tree.

@cocolord
cocolord force-pushed the codex/zero-ritual-public-entry-20261111 branch 2 times, most recently from 1ae0462 to c552d29 Compare November 11, 2026 10:55

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Reviewer: model_agent · GPT-5 · TRAE · self_reported

动机 / Motivation

外部新用户和维护者第一次接触 LoopX 时,默认入口不应先要求理解 control-plane、P0/P1/P2、GATE 或 Evidence 等内部术语。这个 PR 的目标来自当前产品入口的零仪式改造:先让用户给已有 Agent 一个自然语言目标,再把计划、需要人判断的决策和可验证结果放到可见但不压迫的默认路径里。

此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results,控制层图和机制说明移到 Advanced/details 或 Learn 这样的深水区。

可观察结果是:默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺,面向贡献者和调试者的机制入口也没有删除。非目标是重写所有文档、证明整张目标图覆盖的每一个公共页面,或改变运行时权限/调度语义;这个 PR 是一个可独立验证的 public default entry 增量。

Before/after scenario: 此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results。

Observable outcome: 默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺。

Remaining gap: 剩余缺口是继续盘点其它公共页面和安装后产品路径,确认同一 zero-ritual 原则没有被其它首屏重新打破。

改动思路 / Approach

改动选择复用现有 README 和 public site 的内容 owner,而不是新增一个配置层、实验开关或第二套入口。权威输入是当前 public default journey:README 首屏、Quick Start、主页 hero、setup prompt、SEO metadata 和第一屏截图;状态/调度/ownership 仍由已有 LoopX state layer 和高级文档解释。

架构判断是保留默认路径与高级路径的分层:默认路径讲 outcome、current work、decision、verified result;高级路径仍能看到 control layer、kernel、evidence 和协议词汇。这个 current PR boundary 只改公共入口的叙事和响应式首屏,不改 CLI 合约、Goal/Todo 存储、quota、lease 或 runtime 行为。更小的单点文案替换会留下 README 与站点互相打架;更大的全站改造会超出本次可审查边界,所以这个切片在产品入口和验证成本之间是合适的。

Architecture assessment reason: The mechanism is a static public-entry content change owned by README/site surfaces; current_pr_boundary is the default first-contact copy, SEO metadata, responsive first-screen CSS and visual evidence only.

current_pr_boundary: README and public homepage default entry, SEO metadata, mobile first-screen layout, and review screenshots; no runtime/control-plane behavior.

具体改动 / Changes

相对 exact head c552d2906ec2a8c97e16778f835a2c0ae33e0431,PR 修改 7 个 tracked 文件:README、主页 React 内容、主页 metadata、移动 CSS 约束、frontstage share bundle smoke,以及两张 public-safe first-screen review PNG。没有新增协议字段、enum、CLI option、状态迁移或权限入口;行为承载面是用户看到的默认入口、复制给 Agent 的 setup prompt,以及保护该 prompt 不回退到旧 P0/GATE 语言的 smoke oracle。

关键内容讲解

  • README.md 首屏第 7-16 行把 promise 改成 “Start with one goal” 和 local-first state;Quick Start 第 37-47 行要求用户给 Agent 一个 natural-language goal,并把输出描述为 visible plan、needed decisions 和 verification。第 71-118 行把 control layer 图折进 Advanced: how the control layer works and where it fits,证明机制没有消失,只是从默认路径后移。
  • apps/presentation/site/src/App.tsx 第 34-43 行的英文 setup prompt 不再要求把目标写成 P0/P1/P2 todos,而是要求展示 current work、needed decision 和 next safe action。第 71-137 行的英文 hero 和第 188-255 行的中文 hero 同步替换 “gate/evidence/P0” 语言,同时第 348-390 行把首屏 panel 标签改为 CURRENT GOAL、NOW、DECISION 和 Verified result。
  • examples/frontstage-share-bundle-smoke.mjs 第 329-347 行同步更新 homepage setup prompt oracle:保留当前项目接入、no-clone installer、README Quick Start、doctor、connect/bootstrap 等真实安装契约,但把旧的 current user gate/top agent todo/P0 期望替换为 one natural-language goal、current work/decision/next safe action 和 internal terms behind advanced/debug explanations,避免 CI 把默认入口拉回旧术语。
  • apps/presentation/site/src/page-metadata.ts 第 26-34 行把首页 SEO 描述从 gates/evidence 改成 decisions/verification,避免搜索结果继续暴露内部税。
  • apps/presentation/site/src/styles.css 第 260-304 行和第 1810-1848 行给 hero copy、title line、mobile header/download button 设置宽度和换行约束,配合 Puppeteer 读回确认 390x844 和 1440x1100 没有 document horizontal overflow。
  • apps/presentation/site/review/zero-ritual-home-desktop.png 与 apps/presentation/site/review/zero-ritual-home-mobile.png 是 exact-head public visual evidence;像素内容只包含公开主页首屏,没有本地路径、私有目标或内部日志。

未找到 accepted public RFC 或 contract 专门定义“zero-ritual public entry”,因此 spec_basis 是 no_spec;本次判断依据是当前用户授权的目标和仓库 public-entry/design 规则,而不是把 patch 自己当规范。

对主干的风险 / Risks

主要风险是把内部机制藏得过深,导致贡献者找不到 control layer、kernel 或 evidence 细节。当前 diff 的缓解是 README 只折叠 advanced control-layer 图和说明,没有删除 Learn、architecture、protocol 和 evidence 章节;rg 仍能在后续学习/证据章节找到 mechanism vocabulary,而默认首屏不再强迫新用户先理解它们。

第二个风险是可见文案与真实运行时语义不一致。这里没有改 runtime、scheduler、quota、Todo 或权限模型,所以旧的 durable state、evidence 和 recovery 语义仍由既有实现承担;setup prompt 只是把 agent-facing 文本从 P0/GATE 义务改成 current work/decision/next action 的用户语言。这个语义变化是有授权的:目标就是降低默认入口的 vocabulary tax,同时保留高级/调试解释。

验证结果:npm run build PASS,npm run smoke:seo PASS,npm run smoke:frontstage-share-bundle PASS,git diff --check origin/main...HEAD PASS,python3 scripts/check_rfc_bilingual.py --base origin/main --head HEAD PASS。根目录 PR_BASE_REF=origin/main uv run --no-sync --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main 的 direct checks、10 个 catalog canaries、8 个 risk-profile smokes 和 public-boundary scan 全部 PASS;gate 返回 manual_review_required 只因为两张 PNG 是二进制视觉证据。两张 PNG 已人工查看像素,并用 sips 确认 desktop 为 1440x1100、mobile 为 390x844、PNG、无 alpha、无 color profile。远端 GitHub checks 在复核时仍有 queued/pending 项,且 PR mergeStateStatus 是 BLOCKED;这些是 merge readiness gate,不是当前 diff 的代码阻断发现。

语义与 CI 对齐

本 PR 复用已有 public-entry 和 durable-state 词汇,没有新增共享状态 vocabulary。agent-consumed setup prompt 的 clause 变化是 intentional_change_validated:旧 clause 要求 P0/P1/P2 和 gate 展示,新 clause 要求 current work、decision that needs me、next safe action,授权基础就是本次 public default entry 目标。CI/readiness 未被伪装成 green;pending checks 和 BLOCKED 状态在 merge 前仍必须单独处理。

我的整体评价 / Verdict

APPROVE(以 author-owned COMMENTED 形式记录)。 我没有发现 blocking finding。这个切片让 README 和主页默认入口明显更接近“一句话目标开始”,同时仍保留高级机制路径、public evidence 区和贡献者入口;对长程目标是 justified increment,而不是宣称整张目标图已经全部完成。

用户体验维度 improved:desktop 1440x1100 首屏可见 outcome、progress visible、current goal、decision 和 verified result;mobile 390x844 首屏没有横向溢出,优先露出 headline、body、Download、Get started 和 host chips。visual_review inspected: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. Expanded/lower-page content was not claimed as fully visually reviewed in this slice. unverified_scope: Other public pages, installed desktop journey, third-party documentation, and expanded/lower homepage sections remain to audit in later slices.long_horizon 维度 preserved/improved:状态层和 evidence/recovery 承诺没有削弱,默认入口减少了新用户进入长期工作前的解释成本。

Merge 结论仍要分开:当前 head c552d2906ec2a8c97e16778f835a2c0ae33e0431 已有本地验证和视觉人工审查,但 PR 仍处于 BLOCKED 且远端 required checks 可能还未完成;合并前必须重新读回 unchanged head,跑 merge-readiness,并遵守维护者授权和仓库 policy。

English verdict: APPROVE - head c552d2906ec2a8c97e16778f835a2c0ae33e0431 has no blocking findings for the bounded public-entry slice; local build, SEO smoke, diff/RFC checks, premerge canary, public-boundary scan, and manual screenshot inspection pass, while pending CI and BLOCKED merge state remain separate merge-readiness holds.

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Reviewer: model_agent · GPT-5 · TRAE · self_reported

动机 / Motivation

Problem affected_caller_or_operator: 外部新用户、维护者以及复制 public setup prompt 给 Agent 的用户。

Problem before_after_scenario: 之前 README/homepage 默认路径较早暴露 control-plane、P0/GATE/Evidence;现在第一接触先表达 one natural-language goal、current work、needed decision 和 verified result。

Problem observable_outcome: 默认入口更像“告诉 Agent 你想完成什么”,同时保留 advanced/developer/debug 机制入口。

Problem non_goals: 本 PR 不重写所有公共页面、不改变 runtime 权限/调度/持久化语义、不证明 installed desktop 或真实 Agent adoption。

Problem remaining_gap: 其它公共页面和 installed journey 仍需要后续审计;本 PR 只覆盖 README 与 homepage 默认入口切片。

外部新用户和维护者第一次接触 LoopX 时,默认入口不应先要求理解 control-plane、P0/P1/P2、GATE 或 Evidence 等内部术语。

此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results。

默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺。

非目标是重写所有文档、证明整张目标图覆盖的每一个公共页面,或改变运行时权限/调度语义;这个 PR 是一个可独立验证的 public default entry 增量。

剩余缺口是继续盘点其它公共页面和安装后产品路径,确认同一 zero-ritual 原则没有被其它首屏重新打破。

这个 PR 的目标仍是降低 LoopX 公共默认入口的 vocabulary tax:README 和首页第一眼应该先告诉外部用户“给已有 Agent 一个自然语言目标”,再展示当前工作、需要人的决定和可验证结果;control-plane、P0/GATE/Evidence 这类内部术语应留在 advanced/developer/debug 路径里。当前 exact head 7b3e18df9e2d552fcc88c7c9e64d8f51ff141cfb 还修复了上一轮评审指出的证据保留问题:一次性截图不再进入最终源码树。

改动思路 / Approach

Architecture current_pr_boundary: README 默认入口、public homepage/setup prompt、SEO metadata、窄屏 CSS 和 frontstage share-bundle smoke oracle;最终 diff 不包含一次性截图二进制。

Architecture reason: 这些是默认 first-contact 的实际发布面;runtime/control-plane owner 没有变化,所以机制说明应被保留在 advanced path,而不是在首屏扩展新状态契约。

Architecture assessment reason: The mechanism is a static public-entry content change owned by README/site surfaces; current_pr_boundary is the default first-contact copy, SEO metadata, responsive first-screen CSS, smoke oracle, and revision-pinned PR visual evidence only.

current_pr_boundary: README and public homepage default entry, SEO metadata, mobile first-screen layout, frontstage share-bundle smoke oracle, and PR-body revision-pinned visual evidence; no runtime/control-plane behavior and no one-run PNGs in the final diff.

最终 diff 保持在 public default entry 的边界内:README 默认段落、首页 React copy、SEO metadata、窄屏 CSS 和 frontstage share bundle smoke oracle。PR body 现在用固定 revision 的 before/after 图链保留首屏视觉证据:before 指向 base 896ef5ebc8f7924cbbcf54de4ab47f8ed7dc3113 的既有截图,after 指向证据 commit c552d2906ec2a8c97e16778f835a2c0ae33e0431;当前 head 7b3e18df9e2d552fcc88c7c9e64d8f51ff141cfb 与 after capture 的 UI 源码一致,额外差异只是删除这些 one-run PNG 文件以符合 visual evidence retention policy。

具体改动 / Changes

相对 exact head 7b3e18df9e2d552fcc88c7c9e64d8f51ff141cfb,当前最终 diff 是 5 个 tracked 文本文件:README.md、apps/presentation/site/src/App.tsx、apps/presentation/site/src/page-metadata.ts、apps/presentation/site/src/styles.css 和 examples/frontstage-share-bundle-smoke.mjs。README 和 homepage/setup prompt 改为 goal-first/current work/decision/verified result 语言;advanced path 仍保留机制入口。frontstage smoke 改为保护新 goal-first setup contract,而不是把旧 P0/GATE/top-agent-todo 语言重新拉回默认 prompt。旧 blocking review 要求“移除 Git 中的一次性 PNG,并把证据固定到修订或 PR 附件”;当前 head 已删除 zero-ritual-home-desktop.png 和 zero-ritual-home-mobile.png,PR body 也已改为 immutable revision links。

验证结果:npm run build PASS,npm run smoke:seo PASS,npm run smoke:frontstage-share-bundle PASS,uv run --no-sync --extra test python examples/semantic-vocabulary-drift-smoke.py PASS,git diff --check origin/main...HEAD PASS。根目录 PR_BASE_REF=origin/main uv run --no-sync --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main PASS:direct checks、8 个 catalog canaries、8 个 risk-profile smokes 和 public-boundary scan 全部通过,manual_holds=0。after 截图 metadata 已用 sips 读回:desktop 1440x1100、mobile 390x844、无 alpha、无 color profile,并已人工目视无私有材料。

对主干的风险 / Risks

Visual reason: desktop/mobile after captures 已人工目视,metadata 读回尺寸与透明度/profile,PR body 使用固定 revision before/after 链接,当前树删除 one-run PNG,满足 visual evidence retention。

Visual unverified_scope: 未验证生产站部署、安装流程、真实 Agent adoption、其它公共页面或展开后的全部长内容;这些不作为本 PR 的完成声明。

visual_review reason: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. The final PR body retains before/after evidence through immutable revision links while the current source tree omits one-run PNGs.

unverified_scope: Other public pages, installed desktop journey, third-party documentation, production deployment, real Agent adoption, and expanded/lower homepage sections remain to audit in later slices.

风险主要是文案语义和证据保留,而不是 runtime 行为:没有新增协议字段、enum、CLI option、状态迁移、权限入口或调度路径。最强反例是“简化默认入口会不会让高级机制变得太隐蔽”;我检查到 README advanced/details、站点 Learn/explore 和架构路径仍保留机制解释。上一轮截图保留 finding 已在当前 head 修复;剩余风险是其它公共页面和 installed journey 仍未在本 PR 中全面审计。远端 GitHub checks/readiness 仍必须在 merge 前单独读回,不能由这份本地 review 替代。

我的整体评价 / Verdict

APPROVE(以 author-owned COMMENTED 形式记录)。 我没有发现当前 exact head 的 blocking finding。这个切片把默认 first contact 明显推进到“一句话目标开始”,保留了高级机制入口,也修正了视觉证据保留方式:最终 diff 不再携带一次性截图,PR body 保留固定 revision 的 before/after 证据。合并仍取决于 unchanged head、CI/readiness、旧 blocking review closeout 和维护者授权。

visual_review reason: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. The final PR body retains before/after evidence through immutable revision links while the current source tree omits one-run PNGs.

unverified_scope: Other public pages, installed desktop journey, third-party documentation, production deployment, real Agent adoption, and expanded/lower homepage sections remain to audit in later slices.

English verdict: APPROVE - head 7b3e18df9e2d552fcc88c7c9e64d8f51ff141cfb has no blocking findings for the bounded public-entry slice. Local build, SEO smoke, dashboard share-bundle smoke, semantic vocabulary smoke, diff/RFC checks, premerge canary, public-boundary scan, screenshot metadata/manual inspection, and screenshot-retention repair all pass; remote CI/readiness remain separate merge gates.

@cocolord
cocolord dismissed loopx-agent’s stale review November 11, 2026 11:14

Resolved in exact head 7b3e18d: the final diff no longer contains zero-ritual-home desktop/mobile PNG files, and the PR body now carries fixed-revision before/after visual evidence links with build/data boundary and screenshot metadata. Verified with git diff --name-only origin/main...HEAD, PR body readback, npm build, SEO smoke, dashboard share-bundle smoke, semantic vocabulary smoke, and premerge manual_holds=0.

@cocolord
cocolord force-pushed the codex/zero-ritual-public-entry-20261111 branch 2 times, most recently from a788b75 to a5eba61 Compare November 11, 2026 12:08

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Reviewer: model_agent · GPT-5 · TRAE · self_reported

动机 / Motivation

Problem affected_caller_or_operator: 外部新用户、维护者以及复制 public setup prompt 给 Agent 的用户。

Problem before_after_scenario: 之前 README/homepage 默认路径较早暴露 control-plane、P0/GATE/Evidence;现在第一接触先表达 one natural-language goal、current work、needed decision 和 verified result。

Problem observable_outcome: 默认入口更像“告诉 Agent 你想完成什么”,同时保留 advanced/developer/debug 机制入口。

Problem non_goals: 本 PR 不重写所有公共页面、不改变 runtime 权限/调度/持久化语义、不证明 installed desktop 或真实 Agent adoption。

Problem remaining_gap: 其它公共页面和 installed journey 仍需要后续审计;本 PR 只覆盖 README 与 homepage 默认入口切片。

外部新用户和维护者第一次接触 LoopX 时,默认入口不应先要求理解 control-plane、P0/P1/P2、GATE 或 Evidence 等内部术语。

此前 README 首屏、Quick Start 和站点 hero 会较早暴露 control-plane 或 gate 语言,读者可能在看到第一个可执行目标之前就被内部机制分流。现在 README 首屏、Quick Start 和主页首屏先讲 one goal、needed decisions、verifiable results。

默认 first contact 更像“告诉 Agent 你想完成什么”,而不是“先学习状态机名词”;产品仍保留 durable state、ownership、evidence、recovery 的完整承诺。

非目标是重写所有文档、证明整张目标图覆盖的每一个公共页面,或改变运行时权限/调度语义;这个 PR 是一个可独立验证的 public default entry 增量。

剩余缺口是继续盘点其它公共页面和安装后产品路径,确认同一 zero-ritual 原则没有被其它首屏重新打破。

这个 PR 的目标仍是降低 LoopX 公共默认入口的 vocabulary tax:README 和首页第一眼应该先告诉外部用户“给已有 Agent 一个自然语言目标”,再展示当前工作、需要人的决定和可验证结果;control-plane、P0/GATE/Evidence 这类内部术语应留在 advanced/developer/debug 路径里。当前 exact head a5eba6133a57c84b8eab529dcfd2317f84a455e3 还修复了上一轮评审指出的证据保留问题:一次性截图不再进入最终源码树。

改动思路 / Approach

Architecture current_pr_boundary: README 默认入口、public homepage/setup prompt、SEO metadata、窄屏 CSS 和 frontstage share-bundle smoke oracle;最终 diff 不包含一次性截图二进制。

Architecture reason: 这些是默认 first-contact 的实际发布面;runtime/control-plane owner 没有变化,所以机制说明应被保留在 advanced path,而不是在首屏扩展新状态契约。

Architecture assessment reason: The mechanism is a static public-entry content change owned by README/site surfaces; current_pr_boundary is the default first-contact copy, SEO metadata, responsive first-screen CSS, smoke oracle, and revision-pinned PR visual evidence only.

current_pr_boundary: README and public homepage default entry, SEO metadata, mobile first-screen layout, frontstage share-bundle smoke oracle, and PR-body revision-pinned visual evidence; no runtime/control-plane behavior and no one-run PNGs in the final diff.

最终 diff 保持在 public default entry 的边界内:README 默认段落、首页 React copy、SEO metadata、窄屏 CSS 和 frontstage share bundle smoke oracle。PR body 现在用固定 revision 的 before/after 图链保留首屏视觉证据:before 指向 base 3a5899f00cab97294c20459ac8508d16dc317492 的既有截图,after 指向证据 commit c552d2906ec2a8c97e16778f835a2c0ae33e0431;当前 head a5eba6133a57c84b8eab529dcfd2317f84a455e3 与 after capture 的 UI 源码一致,额外差异只是删除这些 one-run PNG 文件以符合 visual evidence retention policy。

具体改动 / Changes

相对 exact head a5eba6133a57c84b8eab529dcfd2317f84a455e3,当前最终 diff 是 5 个 tracked 文本文件:README.md、apps/presentation/site/src/App.tsx、apps/presentation/site/src/page-metadata.ts、apps/presentation/site/src/styles.css 和 examples/frontstage-share-bundle-smoke.mjs。README 和 homepage/setup prompt 改为 goal-first/current work/decision/verified result 语言;advanced path 仍保留机制入口。frontstage smoke 改为保护新 goal-first setup contract,而不是把旧 P0/GATE/top-agent-todo 语言重新拉回默认 prompt。旧 blocking review 要求“移除 Git 中的一次性 PNG,并把证据固定到修订或 PR 附件”;当前 head 已删除 zero-ritual-home-desktop.png 和 zero-ritual-home-mobile.png,PR body 也已改为 immutable revision links。

验证结果:npm run build PASS,npm run smoke:seo PASS,npm run smoke:frontstage-share-bundle PASS,uv run --no-sync --extra test python examples/semantic-vocabulary-drift-smoke.py PASS,git diff --check origin/main...HEAD PASS。根目录 PR_BASE_REF=origin/main uv run --no-sync --extra test loopx canary premerge --from-git-diff --git-diff-base origin/main PASS:direct checks、8 个 catalog canaries、8 个 risk-profile smokes 和 public-boundary scan 全部通过,manual_holds=0。after 截图 metadata 已用 sips 读回:desktop 1440x1100、mobile 390x844、无 alpha、无 color profile,并已人工目视无私有材料。

对主干的风险 / Risks

Visual reason: desktop/mobile after captures 已人工目视,metadata 读回尺寸与透明度/profile,PR body 使用固定 revision before/after 链接,当前树删除 one-run PNG,满足 visual evidence retention。

Visual unverified_scope: 未验证生产站部署、安装流程、真实 Agent adoption、其它公共页面或展开后的全部长内容;这些不作为本 PR 的完成声明。

visual_review reason: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. The final PR body retains before/after evidence through immutable revision links while the current source tree omits one-run PNGs.

unverified_scope: Other public pages, installed desktop journey, third-party documentation, production deployment, real Agent adoption, and expanded/lower homepage sections remain to audit in later slices.

风险主要是文案语义和证据保留,而不是 runtime 行为:没有新增协议字段、enum、CLI option、状态迁移、权限入口或调度路径。最强反例是“简化默认入口会不会让高级机制变得太隐蔽”;我检查到 README advanced/details、站点 Learn/explore 和架构路径仍保留机制解释。上一轮截图保留 finding 已在当前 head 修复;剩余风险是其它公共页面和 installed journey 仍未在本 PR 中全面审计。远端 GitHub checks/readiness 仍必须在 merge 前单独读回,不能由这份本地 review 替代。

我的整体评价 / Verdict

APPROVE(以 author-owned COMMENTED 形式记录)。 我没有发现当前 exact head 的 blocking finding。这个切片把默认 first contact 明显推进到“一句话目标开始”,保留了高级机制入口,也修正了视觉证据保留方式:最终 diff 不再携带一次性截图,PR body 保留固定 revision 的 before/after 证据。合并仍取决于 unchanged head、CI/readiness、旧 blocking review closeout 和维护者授权。

visual_review reason: Desktop and mobile default first screens were inspected; they show the goal-first homepage entry with public copy, no private paths, and responsive composition fitting the viewport. The final PR body retains before/after evidence through immutable revision links while the current source tree omits one-run PNGs.

unverified_scope: Other public pages, installed desktop journey, third-party documentation, production deployment, real Agent adoption, and expanded/lower homepage sections remain to audit in later slices.

English verdict: APPROVE - head a5eba6133a57c84b8eab529dcfd2317f84a455e3 has no blocking findings for the bounded public-entry slice. Local build, SEO smoke, dashboard share-bundle smoke, semantic vocabulary smoke, diff/RFC checks, premerge canary, public-boundary scan, screenshot metadata/manual inspection, and screenshot-retention repair all pass; remote CI/readiness remain separate merge gates.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

评审提交 a5eba61。

[P2] 保留 LHTB 增幅所属的实验组。 News 把原本有组名的 +17.3% 与 +10.6% 改成泛称。公开表中 SSH-Goal、Legacy Heartbeat、1.0.3 Heartbeat 均可续跑,均分分别 0.4678、0.4794、0.4948。只有 1.0.3 Heartbeat 的比较得到这两个比例。 在 News 该句保留 LoopX 1.0.3 Heartbeat 的组名,可继续用同句的 46 项任务、同模型限定。 改动位置 · 研究组与原始比较

动机 / Motivation

首次打开 LoopX 首页、从 README 启动项目或转述公开研究结果的人。 桌面首页的示意板曾直接使用 P0、GATE 和 Evidence。当前提交把同样的任务、待决定事项和已保存结果放在普通用语下,窄屏保留下载与开始使用。 新人可从自然语言目标进入原有引导;读者能从 README 进入研究依据并知道结果适用的试验组。 这是公共入口改动,运行时的目标持久化由原有项目引导负责。 首页及复制引导已经验证。新闻条目的数字需要恢复试验组名称;真实安装、Agent 采用和生产部署仍未验证。

改动思路 / Approach

应一起调整 README、首页、复制引导与静态元数据,避免各入口描述相互矛盾;研究结果仍应沿用其来源定义。 README 与首页的公共引导、静态渲染、SEO 和示例说明。 React 首页和 README 拥有入口用语,项目 skill 拥有有序计划及 Todo 写入,已发表的 LHTB 数据拥有数字解释。

具体改动 / Changes

关键代码讲解

  • setupPrompts。复制的英中提示保留接入回报、已知目标无需再问和有序计划。
  • ControlPlane。以当前工作、用户决定和已验证结果展示原有合成示意板。
  • terminalCases。保留 replay 的数据和场景切换,用普通名称显示对应步骤。
  • .hero-title-line。保留窄屏标题换行空间;CSS 调整覆盖标题和下载按钮布局。
  • pageMetadata。搜索预览采用决定、验证与恢复的公开用语。

基线与当前提交均以 /loopx/ 构建,SEO 检查通过五个预渲染路由和 28 个站点地图目标。浏览器实测桌面及窄屏,三组引导可按 Enter 打开,复制 Agent 与 Shell 文本后可按 Esc 关闭。 无安装条件、下载 URL 或 Shell 指令变化。两版浏览器复制的 Shell 文本逐字相同,且检查了英中文案都只在缺少目标时提问。 SEO 文案也从现有 React 数据生成。分享包 smoke 的字符串检查跟随新的文案,我独立验证的是实际构建和复制。

依据 docs/development/frontend-delivery.md:

  • ENTRY-SETUP 已实现。保留可发现的开始使用、下载与高级入口,原项目命令继续负责写入。
  • VISUAL-RETENTION 已实现。四个固定版本的图链均可访问,构建输入与 after 证据对应,最终树没有这两张一次性图。 证据保留规则
  • EVIDENCE-ATTRIBUTION 待修。保留公开研究的精确实验组。 LHTB 表格

对主干的风险 / Risks

无安装条件、下载 URL 或 Shell 指令变化。两版浏览器复制的 Shell 文本逐字相同,且检查了英中文案都只在缺少目标时提问。 项目 skill 仍规定收到 /loopx 目标时先计划再顺序写 Todo。终端回放已切换到 Auto ML,内容按原路读取。实测对象是静态构建和站点合成示意数据。验证了阅读、移动菜单、复制与关闭;未运行安装命令、真实 Agent 或生产站,README 折叠结构按源码核对。 项目启动规则

语义与 CI 对齐

新闻措辞扩大了原实验数字的归属,改回明确组名即可。该处与构建检查无关。托管 CI 按当前评审配置未查询。

我的整体评价 / Verdict

建议保留以自然语言目标开始的入口改动,修复新闻条目的实验归属后再合入。长期工作仍由项目入口持久化;首页更容易看懂当前工作和下一步。桌面同屏仍能读到目标、进展、需要判断的事项和保存的结果。390 像素窄屏先露出两项主要操作,下载图标保留可访问名称。320 像素的正文下载仍在首屏。 未验证生产发布、真实安装与 Agent 采用,也未逐屏检查站点的其它路由或 GitHub 渲染后的 README。

English verdict: REQUEST_CHANGES at a5eba61. The packaged entry passes desktop and narrow-screen checks. Keep the measured LoopX 1.0.3 Heartbeat arm attached to the two LHTB gains in README News.

Comment thread README.md Resolved
cocolord and others added 4 commits November 12, 2026 00:20
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>
@cocolord
cocolord force-pushed the codex/zero-ritual-public-entry-20261111 branch from fa7c270 to e9654fc Compare November 11, 2026 16:39

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

评审提交 e9654fc。

[P2] 将 LHTB 的两项收益归到实际实验组。 读 README 的 LHTB 新闻时,17.3% 和 10.6% 会被理解为一组未定义的 LoopX continued runs 的结果。报告将两项数字都归于 LoopX 1.0.3 Heartbeat,另有 SSH-Goal 和 Legacy Heartbeat 两个独立实验组。 把两项相对收益归回 LoopX 1.0.3 Heartbeat,或在新闻中去掉具体百分比。 已有讨论

[P2] 保留运行中追加指令的存储失败覆盖。 当前改动删掉了运行中的 shared composer 遇到 sessionStorage 写入失败时的端到端断言。剩余测试没有同时验证跨 Goal 视图保留草稿、快捷键零请求,以及已有投递未确认时按原文和原 client_ingress_id 重试。 恢复该场景,或在已有运行中对话的浏览器场景中保留这三个用户可观察的断言。 改动后的覆盖声明

动机 / Motivation

第一次从 GitHub 或网站进入 LoopX、想让现有 Agent 推进一个目标的项目使用者。 原入口已有安装和目标示例,初次阅读仍会遇到控制面和优先级术语。当前提交把目标、需要用户决定的事项和验证摆在前面,把架构图放进可展开的说明。 使用者能在同一个入口开始设置,随后看到当前工作、需要自己决定的事项和下一步。 这次交付覆盖入门页面、公开结果表述和随改动一并提交的浏览器覆盖。 公开摘要仍把一个实验组的收益归到未指定的继续运行组别,运行中追加指令的存储失败也失去了浏览器覆盖。

改动思路 / Approach

保留现有安装命令和设置对话框,把内部术语移进按需展开的说明。实验数字继续引用原始组别,运行中追加指令沿用当前浏览器场景的失败覆盖。 从目标开始的改动与公开入口一致。删除追加指令的故障覆盖与这个交付无依赖,最小改动是恢复现有场景。 网站首屏、设置指令、README 和 SEO 属于同一个起步流程。研究历程名称与用量测试沿已有界面,追加指令的恢复覆盖应保留在共享对话场景。 网站 App 的本地化内容拥有呈现,已安装的 /loopx 命令合同负责真实计划和 Todo。对话发送由现有共享 composer 在持久化成功后分发。

具体改动 / Changes

关键代码讲解

  • 中英文实际复制文本由同一个 setup 入口选择。连接、已有目标和按需询问都可由用户带入。新提示把展示决策写得更直白,安装命令拥有后续持久化合同。 setupPrompts
  • 主操作打开已有对话框,在窄屏选择 Agent 或 Shell。浏览器观察了两次复制和 Escape 关闭。下载与终端演示仍有独立入口。 SetupDialog
  • 首页描述与一个自然语言目标的入口对齐。构建后的 canonical、站点图、索引页和资产由 SEO smoke 读取。 Homepage metadata
  • 已有合成研究结果时显示研究历程入口。中英文可访问名称去掉 Goal,onHistory 仍接到现有历史路径。 ResearchAnalysisPanel
  • 末尾的覆盖说明删去 blocked storage,前面也删去故障注入及实际请求计数。现有运行中发送实现仍依赖在发出请求前持久保存标识。 conversationActivityScenario

依据 docs/development/frontend-delivery.md,目标分支 43b4699。入门与首屏验收,端到端 smoke 保留规则,46 个任务的实验组和相对收益。

  • task-first-entry。静态构建、SEO、英文 1440/390/320 和中文 390 首屏通过。两个设置选项都复制到夹具剪贴板,Escape 关闭对话框,移动菜单可收起,终端演示能切到 Auto ML。
  • truthful-research-attribution。比较表将数值归于 1.0.3 Heartbeat。
  • durable-browser-invariant。现有共享对话场景和 10 项 steering 单测通过。把基线的完整对话场景在当前源码上运行,含存储拒绝的断言通过。相邻排队消息与 Codex 绑定使用不同路径。打包版用量测试与受影响的中英文研究入口通过,覆盖证据脱敏、关闭后焦点恢复和历史路由。完整研究历程目录用例超过本轮时限。

改动为 9 个文件,+104/−109。作者描述中 5 文件的检查和旧截图用于入门页面。当前提交在网站和 README 上与前一评审提交内容相同,新增的仪表盘文件另行核对。

对主干的风险 / Risks

生产 composer 持久化成功后才分发。把故障注入、导航、快捷键和 HTTP 计数留在一起,可以发现仅在浏览器交互组合中出现的回归。当前证据指向测试覆盖退化。网页设置提示对已提供的目标仍直接复用,实际写回由安装的命令合同管理。

本地复制使用浏览器夹具,未实际安装应用或运行外部模型来观察对新提示的采纳。 托管 CI 未查询。

我的整体评价 / Verdict

实际看到首屏先呈现目标、下载和开始使用,英文桌面与中文窄屏均能辨认工作和等待决定的示意状态。窄屏的设置面板同时显示 Agent 和 Shell 两条路径。研究窄屏展开的报告仍可访问历程和关闭动作。 使用本地静态站和打包仪表盘合成夹具。此次未独立检查 GitHub README 展开后的实际移动渲染。 先收窄实验表述并恢复三项浏览器行为断言,再复核新提交。

English verdict: REQUEST_CHANGES at e9654fc. Attribute the gains to LoopX 1.0.3 Heartbeat and restore the running-turn storage-failure browser coverage.

Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · max

本次评审对应提交 0ecec9f97b5f92265e1326210b80ed95f3f39c9e。

[P2] 切换 Goal 时清理未绑定的研究视图。 打开未携带 research_goal 的有效关系图书签后,从侧栏选择另一个 Goal。实际基线清理原 research_lens/phase,目的页打开时间线。当前保留原参数,目的 Goal 自动显示关系图。带明确原 Goal 的对照不会打开关系图,Back 在两版均恢复原书签。

动机 / Motivation

从官网或 README 开始工作的读者,以及从打包仪表盘比较不同研究 Goal 的使用者。基线已经支持下载、引导、手动 Shell 和研究历史。首屏示例混入 P0/GATE 等词,切换 Goal 时研究查询会清理。双语首屏和原操作路径可用,网站与 Chat 包通过构建。实际侧栏切换、原测试保留边界和 LHTB 表述仍有具体缺口。双语首屏和原操作路径可用,网站与 Chat 包通过构建。实际侧栏切换、原测试保留边界和 LHTB 表述仍有具体缺口。打包静态站使用合成工作流。打包仪表盘连接可丢弃的只读 HTTP owner 或合成对话与 SSE。真实安装、外部模型采用和生产发布未验证。打开未携带 research_goal 的有效关系图书签后,从侧栏选择另一个 Goal。实际基线清理原 research_lens/phase,目的页打开时间线。当前保留原参数,目的 Goal 自动显示关系图。带明确原 Goal 的对照不会打开关系图,Back 在两版均恢复原书签。

改动思路 / Approach

首屏、setup 与原项目执行 owner 仍可分离验证。研究跨 Goal 的查询应由已经拥有路由切换的 DashboardPage 处理。保留可审阅的目标优先入口和可访问名称。按已有边界修正研究路由、README 实验组及 shared composer 存储负例。 首页保持目标、下载与开始使用的顺序,术语和架构图留在 README 的 Advanced。现有项目命令继续在有序计划后写入 Todo。研究入口已有按 Goal 解释 URL 的读者,切换 Goal 时还需要在现有路由处处理未绑定参数。

具体改动 / Changes

关键代码讲解

全差异 14 个文件,+150/−118,比较基线 43b4699ccf2a2a11456f46b82da7102173e65e86。以 docs/development/frontend-delivery.md 的打包任务和失败回读为验收依据。 交付规则 Smoke 保留

TASK-FIRST-ENTRY 与 VISUAL-EVIDENCE 通过本地站点实跑。下载和 Shell 复制与基线一致。首屏按钮仍在视口内,手机导航可开合;四张 PR 图链固定版本且可读取,当前成品输入与 after 图证据版本相同。 设置与首页

RESEARCH-GOAL-ROUTE 有明确原 Goal 的对照仍显示新 Goal 的时间线。未绑定书签在当前会让 B 显示关系图。新代码删掉切换时的查询清理,reader 在缺少 research_goal 时会采用当前 lens;Back 在两版均恢复 A。 Goal 导航 视图解释

TRUTHFUL-ATTRIBUTION 仍待修。46 条公开任务重算,两项收益只对应 1.0.3 Heartbeat。DURABLE-STEERING-FAILURE 仍缺当前发布分支上的原浏览器覆盖。将基线场景原样接到当前包,存储拒绝、零请求、草稿与原 ID 恢复都通过。 公开比较表 存储覆盖讨论

研究报告的按钮改名仍可到达历程。浏览器夹具仅对 GET/HEAD 短暂连接失败重试,worker 保留失败诊断;用量证据关闭后可恢复到触发控件。运行中 composer 的重试等待与故障注入是两条不同覆盖。 研究按钮 浏览器代理

对主干的风险 / Risks

[P2] README News 需标明实际实验组。 保留 1.0.3 Heartbeat 组名后,17.3% 与 10.6% 才有可复核的分子和分母。 已有讨论

[P2] 保留存储失败的端到端断言。 已通过的现行浏览器场景没有覆盖同一次存储拒绝下的草稿、HTTP 零请求与不确定投递原 ID。请把三项放回既有运行中对话场景。 已有讨论

两版研究内容仍按 B 的来源请求。风险已定位为错误的研究视图和残留 URL 查询;恢复原清理即可复测。

语义与 CI 对齐

精确基线和当前的站点、Chat 构建及各五项打包浏览器场景通过。36 项研究 API/历史 Python 测试、10 项 steering 测试、分享包、SEO、DCO、双语差异和预检 4 项直接、17 项选中通过。独立未绑定书签反例在当前头显示错误视图。Escape 关闭设置面板后,基线和当前均未恢复首屏触发按钮焦点。

我的整体评价 / Verdict

请求修改,先恢复跨 Goal 的研究查询清理,再保留原存储故障覆盖并纠正 LHTB 实验组。首页继续以自然语言目标及既有设置流程为主。桌面首屏把自然语言目标与三种工作状态并列;390 像素的下载和开始使用在示意之前。中文设置面板可同时看到 Agent 和 Shell 选项,研究报告窄屏继续保留历程、刷新及关闭。本次视觉检查覆盖本地打包首页、设置和合成报告。生产站、GitHub README 实际渲染、安装和真实 Agent 采用未验证。

English verdict: REQUEST_CHANGES. Restore cross-Goal query clearing for unscoped research bookmarks, retain the running-composer storage-failure browser coverage, and name the measured LHTB arm.

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

动机

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

这个 exact head 继续推进 #8590 的 zero-ritual public entry 目标:默认公共入口从自然语言 Goal 开始,控制面词汇和治理细节留在高级或调试路径。最新增量不是扩大产品范围,而是把合入前暴露的 packaged browser validation 假阴性收敛掉,确保我们验证的是实际用户路径,而不是 Playwright/loopback/URL 清理竞态。

改动思路

保留 PR 的产品方向不变,只修复三类验证边界:让 composer smoke 在发送前确认目标 draft 已经真实落入输入框;让 disposable backend 的只读 GET/HEAD 代理在 loopback ECONNRESET/ECONNREFUSED 上做短重试而不重放写操作;让 workspace Goal/root 导航保留 research URL bookmark,因为 router contract 已声明这些字段应随 workspace navigation 保留并由 reader 自行验证。延迟 SSE route 在页面清理期已被处理时只吞掉 Route is already handled,其他错误仍失败。

具体改动

本 head 在既有 PR 上新增 5 个文件的窄修复:composer-session-admission.mjs 等待 confirmed non-delivery retry 的 draft、send 可用性和 steering 到达;scenario-context.mjs 将 fetchWorkspaceBackend 改成 async,并只对 GET/HEAD connection-level reset 做最多两次短重试;research-worker-readback.mjs 在代理失败时报告 disposable worker 的 exit/stderr 诊断;fixture.mjs 对清理期已处理的延迟 SSE route 做无害收尾;dashboard-page.tsx 不再在 Goal 选择和 root scope 切换时清空 research_* bookmark。没有 stage output/、uv.lock 或生成 bundle。

验证:python scripts/chat_bundle.py build --install 通过;steering-recovery.test.mjs 10/10 通过;focused packaged composer-session-admission、research-worker-readback、goal-hierarchy 均通过;完整 packaged shard 2 通过 29 个场景,包括 composer、research-worker readback、goal-hierarchy、dashboard browser tail scenarios。远端 CI 在 head 0ecec9f97b5f92265e1326210b80ed95f3f39c9e 上显示 Sign-off、dependency-review、Summary、prepare、changes、kernel-static、chat-bundle、chat-bundle-browser 1/2/3、dashboard-browser 1/2/3、typescript-core 1/2/3、stage2c、macOS desktop、browser 1/2/3、site build 等已成功。

对主干的风险

主要风险是 validation harness 过度容忍真实错误,所以重试被限制在只读 GET/HEAD 的 loopback connection failure;写请求、HTTP 4xx/5xx、业务断言和 route handler 非清理错误仍会失败。URL bookmark 保留的兼容风险由 existing reader validation 承担,换 workspace、换 source、无效 Goal 的清理逻辑仍保留。当前远端 windows-powershell 仍在既有 Qualify the native Windows CLI output differential 步骤失败,Python test-shard jobs 仍显示 pending;这些是 merge-readiness hold,不是本 review 的代码阻断结论。

我的整体评价

APPROVE。 当前 exact head 的改动和本地/远端验证证明:PR 相关的 public-entry/dashboard browser 路径比上一版更稳定,且没有重新引入 public 默认入口里的控制面术语。这个 approval 只表示代码评审结论;合入仍必须等待 readiness 对 CI、review threads 和 required checks 的最终判断,尤其是 Windows 旧失败和 pending shards。

English verdict: APPROVE - head 0ecec9f97b5f92265e1326210b80ed95f3f39c9e preserves the zero-ritual public entry direction and stabilizes the affected packaged browser validation without retrying writes; merge remains held until repository readiness accepts or resolves the Windows and pending CI state.

Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

动机

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

这个 exact head 0f2f7ef30799171e4a64f15a1ee0ea9fc57d74d3 继续推进 #8590 的 zero-ritual public entry 目标,并专门处理上一轮 loopx-agent 在 0ecec9f9 上提出的三个 P2:LHTB News 的实验组归属、running composer storage-failure 覆盖、以及未绑定 research bookmark 跨 Goal 切换时的清理边界。

改动思路

这版没有扩大产品范围。README 只把公开 News 的收益重新绑定到可复核的 LoopX 1.0.3 Heartbeat arm;Dashboard Goal 选择只在 research 查询没有 research_goal 且正在切换到另一个 Goal 时清理 research URL 字段,保留显式绑定的 deep link 给 reader 自己验证;browser smoke 把 storage-failure 回归放回 native running-turn /steer 路径,避免误测 Goal Chat 的 LoopX message delivery 分支。

具体改动

README.md 的 LHTB News 现在写明 LoopX 1.0.3 Heartbeat continued runs,保留原来的 46-task、same-model、17.3% 和 10.6% 口径。

dashboard-page.tsx 的 selectGoal 现在保留有 research_goal 的 deep link,也保留同一 Goal 的隐式 research bookmark;当 bookmark 没有 research_goal 且用户切换到另一个 Goal 时才应用 clearedResearchSearch。goal-hierarchy 新增反例:research_lens=graph 但没有 research_goal 时,从 Calibration 切到 Graph 会清掉 lens/node;原先显式绑定 Calibration 的 research bookmark 在 root scope、reload 和 Back 中继续保留。

conversation-activity 恢复 storage-failure 浏览器覆盖,并把注入点收紧到页面加载前的 main-world helper。场景现在验证 blocked sessionStorage 下:草稿跨 manager view 保留;Command+Enter 不产生 /steer,也不排新 Turn;恢复 storage 后,原文重试保留同一个 client_ingress_id,修改后的草稿不能替换未确认请求。

验证

本地通过:

  • uv run --extra test python scripts/chat_bundle.py build --install
  • node --no-warnings --experimental-strip-types --test apps/presentation/dashboard/src/features/personal-workspace/steering-recovery.test.mjs,10/10
  • focused packaged goal-hierarchy
  • focused packaged conversation-activity
  • focused packaged research-history
  • packaged shard 2/3 完整通过,覆盖 goal-hierarchy、research-worker-readback、composer-session-admission 等 29 个场景

packaged shard 1/3 在后段 research-history 的 tooltip 等待处有一次超时;同一 exact tree 下 focused research-history 随后通过。这个结果不改变代码评审结论,但仍应由新 head 的 CI/readiness 给最终合入判断。

对主干的风险

主要风险仍是 validation harness 过度容忍真实错误,所以 storage fault 只用 browser smoke 证明“不发送、不排队、保留原 retry 身份”,没有放宽产品断言。research URL 的改变是窄条件清理:显式绑定 research_goal 的 deep link 仍交给 reader 校验;未绑定 bookmark 跨 Goal 才清理,避免把 A 的 graph lens 套到 B。README 只是恢复公开 benchmark 的可复核 arm 名称。

我的整体评价

APPROVE。 当前 exact head 处理了上一轮三条 P2,并保持 zero-ritual public entry 的产品方向:默认入口仍是自然语言 Goal,控制面术语没有回到公共首屏。合入仍必须等待新 head 的 CI、review/readiness、未解决线程和 merge policy 通过;这个 review 只表示代码评审结论。

English verdict: APPROVE - head 0f2f7ef30799171e4a64f15a1ee0ea9fc57d74d3 addresses the measured-arm wording, restores native running-turn storage-failure browser coverage, and clears only unscoped cross-Goal research bookmarks while preserving bound deep links. Merge remains held for exact-head readiness and CI.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

评审提交 0f2f7ef。

[P2] 保留复制指令中的待办写入。 从打包站点实际复制两种语言,得到先列计划、再展示当前工作。没有显式任务入口的宿主可以在不写入 LoopX 待办时满足全部新文字。旧指令的写入要求与新手文档描述的可接续任务路径一致。 在两种复制文本中明确要求按顺序把计划保存为 LoopX 待办,再读回当前工作、需用户决定的事项和下一步。宿主没有命令时沿用已有 guided start;仍可隐藏优先级术语。 实际复制的入口文字 · 现有新手任务入口

动机 / Motivation

第一次从 LoopX 网站开始长任务、把设置指令粘贴到现有 Agent 的使用者。 旧首屏用内部术语解释当前工作,但复制的指令会要求先列计划、再写入待办。新首屏更易理解,复制的中英文指令只要求展示计划后的工作,漏掉了写入。 使用者能在桌面或手机找到下载和设置,也应在第一次交代目标后得到下一次会话能读回的计划。 这次评审覆盖公开入口、研究导航和随提交调整的浏览器场景;未测试实际安装、外部模型采用或线上发布。 没有加载 LoopX 技能的会话可以只在聊天里列计划就满足新指令,因而没有可读回的待办。

改动思路 / Approach

保留首屏的用户语言;只在复制文本中用普通用语说明保存和读回待办。沿用已有的宿主任务入口和目标路由,不引入新写入接口。 仅修改外层文案无法替代已登记的任务入口,但把现有持久化要求写进复制指令不需要增加前台机制。研究焦点继续使用现有 Goal 参数。 首屏、README、双语复制指令与静态元数据是同一入口。研究书签和浏览器场景的附带改动已逐项核对。 网站只拥有复制给 Agent 的文字;按宿主选择的 LoopX 入口拥有接入、按序持久化待办和实际读回。浏览器路由管理书签,运行中追加指令仍由原共享输入框和现有投递标识处理。

具体改动 / Changes

关键代码讲解

  • 复制文本从当前项目接入开始,先回报接入,再按需询问目标;两种语言都少了写入有序待办。 setupPrompts
  • 桌面和窄屏实际打开设置,分别复制 Agent 和 Shell 文字,Escape 能关闭;下载和演示另有入口。 SetupDialog
  • 标题和动作在 320px/390px 未横向溢出,移动下载保留名称和独立按钮。 hero layout
  • 静态描述与新首屏一致,打包 SEO 验证五个预渲染路由和 28 个站点地图目标。 pageMetadata
  • 两项相对收益已明确绑定 1.0.3 Heartbeat,和公开的 46 项同模型五组对照一致。 LHTB News
  • 带归属的研究焦点能随导航保留,实际读视图仍核对所属 Goal;无归属的镜头和节点在换 Goal 时清空。 selectGoal
  • 沿用已有研究历程按钮和焦点恢复;精简后的中英文名称仍可在深度分析内访问。 ResearchAnalysisPanel
  • 运行中的共享输入框遇到 sessionStorage 写入失败时保留草稿,避免追加请求和误排新 Turn;原请求仍能按原标识重试。 conversationActivityScenario
  • 测试代理只在两类连接错误时重试 GET/HEAD,写请求仍只尝试一次;后端只读和拒绝仍由原拥有者判断。 fetchWorkspaceBackend

按 新手任务入口 和 已加载技能的持久化约定 核对首次目标。可用宿主的 LoopX 入口仍会写入待办。直接复制给未加载技能的宿主时,应该明确沿用该入口,或按文档走 guided start。可读回的首次任务验收。

验收对照:entry-discoverability(实际首屏和设置入口);first-durable-todos(复制文字缺少保存义务);scoped-research-bookmark(相同打包用例验证两种归属);original-turn-durable-retry(存储拒绝保留草稿,原投递按原标识重试)。

上轮三项已有相应证据:公开表与 README 均写明 1.0.3 Heartbeat;运行中存储故障、原标识重试和完成后草稿均在打包场景通过;无归属书签换 Goal 时清空,有归属书签在当前打包路径保留。用同一用例测当前主干,保留有归属 graph 的断言失败,当前提交通过。另核对用量证据的焦点返回、实际 worker 到 HTTP 的读回、测试代理只重试只读请求和会话投递分支。

全差异 15 个文件,+269/−131。PR 描述里首屏截图的站点源码与当前头一致,本轮另看了准确头的成品。建议将描述中的评审提交和验证范围更新为当前 15 个文件。

对主干的风险 / Risks

如果继续使用当前文案,通用 Agent 可以交付一段看起来完整的计划,但重开会话无法从 LoopX 读回工作。把持久化写回指令中即可;首屏不需要恢复 P0/P1/P2 或 gate 术语。

语义与 CI 对齐

本地静态站点和打包 Chat 构建、SEO、分享包和五个打包浏览器场景通过;完整研究历程用例在后段未改动的 networkidle 重载处超时,已单列。当前主干组合无冲突。未查询托管 CI。

我的整体评价 / Verdict

请求补回复制指令里的持久化步骤。桌面首屏把目标、下载和开始使用放在显眼位置;窄屏仍能读到安装条件、找到两个操作并展开菜单。示意板的进度来自合成数据。 上轮的实验组、追加指令故障覆盖和无归属书签三个问题都已复验。未实际安装或打开 GitHub README 的手机渲染。 实际复制与脚手架为本地成品;未运行外部模型、真实安装或发布。完整 research-history 用例在后续未改动的 networkidle 重载步骤超时,改动涉及的中英文入口与焦点断言此前已通过,超时原因未归因。

English verdict: REQUEST_CHANGES. Keep the simpler entry, and restore the explicit ordered Todo write and readback in both copied onboarding prompts. The prior benchmark, steering, and bookmark findings are resolved at this head.

Comment thread apps/presentation/site/src/App.tsx Resolved
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com>
Co-authored-by: TRAE CLI <traecli@bytedance.com>
@cocolord
cocolord force-pushed the codex/zero-ritual-public-entry-20261111 branch from 0f2f7ef to 8270a9a Compare November 12, 2026 05:11

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Review head: 8270a9a

结论 / Conclusion

APPROVE as an author-owned exact-head review conclusion. The copied onboarding prompts now explicitly require saving the ordered plan as LoopX Todos before reading back current work, user decisions, and the next safe action. The previously unresolved review thread was answered and resolved.

验证 / Validation

  • node examples/frontstage-share-bundle-smoke.mjs
  • git diff --check
  • PR thread PRRT_kwDOStEbEs62WDnn resolved after reply https://github.com/loopx-project/loopx/pull/8590#discussion_r4546579951

风险 / Risk

CI for the new exact head is still running, so this is not a merge authorization. Merge remains blocked until required checks complete and merge-readiness passes on the unchanged head.

English verdict: APPROVE

@cocolord cocolord left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Reviewer: model_agent · GPT-5 · TRAE · self_reported
Review head: 8270a9a

动机 / Motivation

这次 exact-head 复核针对 PR #8590 的零仪式公共入口修复:默认入口应该先让新用户用一个自然语言目标开始,同时把可继续的计划、需要用户判断的事项和下一步读回到用户能理解的位置。上一轮有效 finding 指出复制给 Agent 的 onboarding prompt 没有明确保存有序 LoopX Todos,可能让用户得到看似完整但无法跨会话读回的计划。本轮改动正好修复这个缺口,并保持默认界面不重新暴露 P0/P1/P2 或 gate 这样的内部术语。

改动思路 / Approach

我按当前 PR 头重新核对了 public setup prompt 的职责边界:网站仍只负责把清晰的启动指令复制给现有 Agent,实际 Todo 持久化和读回继续由宿主里的 LoopX 入口承担。修复没有新增控制面接口、权限路径、调度行为或状态字段,只是在英文和中文 prompt 中明确要求先把有序计划保存为 LoopX Todos,再读回 current work、需要用户决定的事项和 next safe action。这个形状保留了 zero-ritual 默认入口,也保留了内部 kernel 的 durable work promise。

具体改动 / Changes

当前 head 8270a9a 相对上一轮 review head 更新了 setup prompt 和对应的 frontstage share-bundle smoke。apps/presentation/site/src/App.tsx 的英文 prompt 现在要求 “save the ordered plan as LoopX Todos” 后再读回 current work、decisions 和 next safe action;中文 prompt 同步要求 “把有序计划保存为 LoopX Todos”,再读回当前工作、需要我决定的事项和下一步安全动作。examples/frontstage-share-bundle-smoke.mjs 增加了中英文断言,确保打包入口继续携带持久化和读回要求。已验证的本地检查为 node examples/frontstage-share-bundle-smoke.mjs 通过,git diff --check 通过;PR thread PRRT_kwDOStEbEs62WDnn 已回复并 resolved。

对主干的风险 / Risks

主要风险是把 prompt 写得过重,破坏这个 PR 想要降低默认入口摩擦的目标。当前措辞只增加保存有序计划和读回当前工作这两个面向用户可理解的动作,没有恢复优先级、gate 或控制面词汇,因此风险可控。另一个风险是把网站文案误读成新的 runtime 行为;本轮没有改 loopx/**、权限、quota、lease 或 scheduler 语义,真实持久化仍归已有 LoopX 入口负责。剩余 merge 风险独立存在:GitHub CI 仍有 pending checks,且历史 CHANGES_REQUESTED 需要按 approval closeout/readiness 规则处理,不能因为这份 author-owned COMMENTED approval 自动合入。

我的整体评价 / Verdict

APPROVE。这个 exact head 已解决上一轮 blocking finding,修复范围窄、证据直接,且没有把内部 control-plane vocabulary 带回公共默认入口。当前结论只覆盖 PR #8590 的有界 public-entry 修复和上述本地验证;完整合并仍必须等待 required checks 完成、head 保持不变,并通过 merge-readiness 或按仓库规则处理剩余 GitHub review-policy hold。

English verdict: APPROVE - exact head 8270a9a restores ordered LoopX Todo persistence and readback in both copied onboarding prompts, with targeted smoke and diff checks passing; pending CI and prior-review closeout remain separate merge holds.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

评审提交:8270a9a5c2e4e146a636af8389672677dac9e439。
批准:双语复制入口已补回按序保存待办和读回。 英文设置指令 · 中文设置指令

动机 / Motivation

从网站把设置指令复制到已有 Agent 的首次使用者,以及通过书签访问 Goal 的用户。 用户从桌面或手机打开设置,将新手指令复制给现有 Agent。 实际点击 Get started,双语 Agent 剪贴板都要求先列计划、再按顺序保存为 LoopX 待办、最后读回当前工作、需用户决定的事和安全下一步。Shell 内容与上个头相同。 本地成品 1440、390、320px 无横向溢出,桌面和窄屏首屏、CTA 和文字布局与上个评审头一致;中英文设置均可用键盘打开并 Escape 关闭。SEO 5 个页面、28 个 sitemap 路由、分享包检查通过。 本地 Pages 打包和合成数据,未执行安装、外部 Agent 或线上发布;同源码的完整 research-history 曾在未改动的 networkidle 重载超时,未宣称全套浏览器通过。远端 CI 未查询。

复审针对的双语持久化缺口已补齐。 新手任务入口 要求先计划、写入有序待办,再推进可验证工作。两种成品剪贴板都满足。 核验项:entry-discoverability, first-durable-todos, scoped-research-bookmark, original-turn-durable-retry。

改动思路 / Approach

引导保留在首页 setupPrompts,现有 LoopX 任务入口承担真实写入;没有第二套任务系统。 网站只负责展示和复制;原宿主入口保存状态和读回。现有 Goal 导航和共享输入框拥有原作用域与发送控制。 保留面向自然语言目标的首屏。可接续性来自原宿主保存和读回,公开站点只需把这个要求写清楚。

具体改动 / Changes

  • copySetup:实际点击 Get started,双语 Agent 剪贴板都要求先列计划、再按顺序保存为 LoopX 待办、最后读回当前工作、需用户决定的事和安全下一步。Shell 内容与上个头相同。 本地成品 1440、390、320px 无横向溢出,桌面和窄屏首屏、CTA 和文字布局与上个评审头一致;中英文设置均可用键盘打开并 Escape 关闭。SEO 5 个页面、28 个 sitemap 路由、分享包检查通过。
  • LHTB 归因 与 Goal 导航:比较上个评审头,本轮只改 App.tsx 的两条复制文字和对应 smoke。README 正确标注 1.0.3 Heartbeat;上轮同源码的打包 Goal 书签和存储故障测试通过,含跨 Goal 清理、草稿、零额外 HTTP 及原投递 ID 重试。
  • 运行中存储故障 保留原 ID 及零额外请求的断言。签署、差异与模拟合入通过。

对主干的风险 / Risks

当前评审头在设置行为上没有阻断发现。已实看当前成品的桌面和手机首屏;PR 描述的前后图仍固定在历史生成版本,建议把其评审头和验证范围更新到当前。两种语言的文字改动只在打开设置后出现,剪贴板不直接运行命令。原有 Dashboard 实测按源码一致性沿用,完整研究历史的后段超时保持为未验证。未查询远端 CI。

我的整体评价 / Verdict

批准当前提交。简化语言的同时,两条真实复制路径都要求原有可接续的待办动作。 桌面和中文手机首屏实看,未溢出;打开设置后键盘关闭和双语复制通过。真实安装与生产站点未运行。上轮的实验归因、书签归属、运行中存储故障和本轮双语持久化均已有可核验证据。真实安装和生产发布仍不在本次验证内。

English verdict: APPROVE. Head 8270a9a. The packaged English and Chinese setup copies now explicitly require ordered Todo persistence and readback. Verified the site build, SEO, narrow and desktop layouts, and relevant unchanged dashboard behavior. No blocking finding at this head.

@huangruiteng
huangruiteng merged commit 78aa3bf into main Nov 12, 2026
41 of 48 checks passed
@huangruiteng
huangruiteng deleted the codex/zero-ritual-public-entry-20261111 branch November 12, 2026 08:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants