Repository navigation
docs(research): link retained benchmark trajectories - #8235
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)
动机 / Motivation
查看 Grid、Ad 和 Schemathesis 历史样例的研究读者,需要知道当前记录来自哪份公开档案。
以前能打开三个 Explore 样例,但要另找原生档案并判断是否对应。现在可沿指南进入固定版本,并用样例所附摘要核对下载内容。
已核对三个公开 ZIP、清单和摘要。档案里的 382 条 Explore 记录逐字节对应原有样例,预览仍使用这些记录。
本次只交付来源追溯。真实运行采纳、评分和成本比较属于独立的实验验收。
这些档案仍只提供可追溯的记录。完整时间线的产品接入、原始材料的脱敏复验和有效实验结论各需自己的证据。
改动思路 / Approach
把固定版本的链接和摘要放在现有 fixture 的 provenance 内,能让读者沿原案例找到档案。
保留现有 Explore 预览和档案各自的读取路径。本次只为三个已捕获案例增加来源引用。
三个 ZIP 的 SHA-256 与固定清单一致,内嵌清单和四个压缩原生轨迹成员的摘要也一致。三份档案分别保留了 33、255 和 94 条已有 Explore 记录。归档完整度和试验有效性继续分开记录。 固定公开档案
具体改动 / Changes
依据改动前的 examples/personal-workspace-browser/research-history.md,版本 ac62962255322cd80a5b701a4187c6f47bc17d8c。fixture-source 的来源指针和原记录已逐字节核对。recorded-coverage 保留捕获边界和状态。whole-run-adoption 属于单独的产品与实验验证。 已有样例契约
关键代码讲解
- 指南的
Captured session archives区段列出固定版本、每个案例的档案和审计范围。 新增指南 provenance.trajectory_archive为三个现有样例补充地址、摘要、清单和审计引用。去掉这一字段后,三个 fixture 与基线完全一致。 Grid 样例- 已有预览仍按样例选择 fixture 并读取原 Explore 记录。现有失败或取消状态与
score_countable=false均保持。 现有样例读取
四个文件新增 48 行,覆盖三份 fixture 的溯源字段和一段指南。当前 main 在该基线之后的变更未触及这四个路径。
对主干的风险 / Risks
独立复核下载了三个固定版本 ZIP,比较了档案、清单和记录摘要。将一个指针改为错误摘要,或换成另一案例的完整指针,都会在读取内容前触发校验。七项固定 fixture 检查、八项 Explore 历史测试和本地 quick premerge 的四项直接检查与四项 catalog 均通过。远端 CI 未核验。
公开审计的 4,835 行都指向 encrypted_content,行数与对应清单一致。核验范围为公开元数据、压缩成员摘要与 Explore 原记录。原始私有内容的脱敏覆盖、Schemathesis 较短原生档案的字节对照和真实实验效果未验证。检查范围是公开研究指南、fixture 和已有 Explore 历史读取入口。没有渲染或首屏布局改动。未核验安装版界面。
我的整体评价 / Verdict
这项变更让读者能从原样例找到并核对同一份档案,现有预览和试验状态沿用原记录。证据支持提交这一范围的溯源变更。后续导入整段原生历史时仍需另验来源覆盖和读回。
English verdict: APPROVE
Goal And Delivered Outcome
The existing Grid, Ad placement, and Schemathesis research fixtures preserve native Explore records but had no pinned link to their matching captured solver sessions. Each now records an immutable archive URL and SHA-256. The research history guide links the capture set, manifest, and redaction audit.
The three archives contain four retained native session files and 382 byte-identical Explore records. The longer Schema worker capture preserves 56 records absent from the shorter receiver copy. The manifest identifies the two captures and their prefix relationship. The earlier checkpoint release remains available at its original revision.
main.Author Declaration
Implemented against
provenance.trajectory_archive,examples/personal-workspace-browser/research-history.mdScope And Continuation
Validation
97956d9e4d2193675bc53eef75cd48f1c7bfa2ce.unitpasseduv run --extra test python -m pytest tests/presentation/test_explore_history.py::test_checkpoint_fixture_reconstructs_original_captured_log_bytes -q(7 cases).regression_paritypassedmanualpassedstaticpassedFrontend / Visual Evidence
Type of Change
LoopX Area
Technical Direction
Shared-authority RFC fixture impact
N/A. No shared authority behavior or fixture contract changed.
Boundary Checklist
none.Signed-off-bytrailer.