Repository navigation
docs: start LoopX onboarding in your AI assistant - #8842
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
第一次在本机尝试 LoopX 的开发者,需要用一项真能检查的小任务理解中断后如何接续。原有验收题描述了预期答案,读者要在多个指南中拼出 SQLite、领取租约和提交结果的命令。现在运行一个入门示例就能完成整条路径。在发布版 2.3.0 和当前源码上,两份入门页的同一脚本都从 SQLite 读回已完成的 Todo、标题检查证据和结束的租约。
此次交付是社区参考资料和可运行示例,群内助手的正式准出由现有验收流程判定。文档合入后,社区助手仍需同步公开版本,并通过原有的真实宿主、群路由和权限验收。
改动思路 / Approach
新手指南和社区验收题都引到同一份双语入门。示例用临时项目与独立运行目录,在线下核对一个标题。CLI 通过原有 Goal、Todo、租约和回执接口完成状态转换,下一次 CLI 进程能读回结果。FAQ 继续引用原来的存储、时效和权限契约。仅补几个分散链接不足以让读者按同一个例子走完。
具体改动 / Changes
关键内容讲解
以 docs/product/use-cases/community/golden-queries.md 在 f38fae05bb9a1c2cc54a2641359224cc253d32ac 的口径评估。CQ01、CQ02、CQ03 由真实 CLI 示例覆盖。CQ05、CQ08、CQ11、CQ14 的答复分别保留版本、原操作、时效范围和实验反例。CQ15、CQ20 由共享授权说明和可被后续答复引用的 FAQ 覆盖。Release decision and evidence 留给已安装助手的真实群验收。
两份入门页执行同一段命令。SQLite 路径可以看到领取成功、狭义的标题检查、完成状态和租约结束。FAQ 的 3.0% 只对应 112 次同周期续跑的首读正文,含 JSON 为 5.0%。十题结果按快照描述,保留 Portfolio、Codec、OpenTTD 以及 Rust 的原始精度。远程任务服务按候选能力描述,#8747 按权限设计描述。 入门页 · FAQ
对主干的风险 / Risks
文档如果暗示七题领先来自一次严格控制变量的实验,链接和 CLI 检查都发现不了。我按公开 JSON 复算了 374,449 和 630,550 字节以及十题各自的胜负方向,并核对了时长和来源缺口。两个 CLI 构建都拒绝了缺少领取凭证的完成操作。34 个相关链接和锚点、公开边界、双语配对及预合并检查通过。初次预合并要求补同一 diff 的质量凭证,补齐并读回有效后通过。按本 Goal 配置使用本地验证。
我的整体评价 / Verdict
持续执行的语义保留,证据从新的进程按同一个 Todo 读回。对新用户,原来分散在几个文档的入门步骤现在可以一次跑完。仓库 Markdown 文档和链接支持上述检查,未涉及产品页面或界面布局。群内实际采用和回复质量仍由已安装助手的试运行验收。
English verdict: APPROVE aee08e8. The bilingual SQLite walkthrough returns a checked result and the FAQ preserves the public evidence and permission boundaries.
…uickstart-20261116 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
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; reasoning effort max; runtime_reported.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
第一次尝试 LoopX 的用户,需要在常用助手里交代任务并检查结果。旧版社区入门要求先手工创建 Goal、注册 Agent 和领取租约;修订后用户安装受支持入口,在同一条消息交代失败测试任务,再检查实际 diff 和测试。两语页面、发布版入口安装、只读任务预览与可选 SQLite 正反例均符合文档边界。这次交付是入门与 FAQ 文档,不宣称真实模型已修复项目、自动续跑或社区助手已上线。真实助手的模型执行、自动续跑、社区路由和合入后的公开采用仍由既有工作继续验收。
改动思路 / Approach
默认主路径只保留安装入口、提交任务、检查结果三步。助手继续负责已有项目连接和内部工作管理,用户可以在原对话中继续或调整;缺入口时回到安装及重新打开宿主,无法启用续跑时明确询问缺失步骤。这里没有用“无需准备”掩盖安装,也没有增加确认轮次。
原 SQLite 命令块完整移入可选开发者参考,FAQ 则承担存储、模型探索与重放、Context Delivery 和共享 PostgreSQL 四类技术问答。把原演示直接删除会丢掉可复现的权限负例;把它留在默认首屏又会继续要求新手先理解内部协议。当前的链接分层保留了两类读者各自需要的路径,不需要新增 runtime、安装器或第二套任务 owner。
具体改动 / Changes
完整评审 head 为 5177f78ea0897dfb183f1183c90191743fd3057d,九个 Markdown 文件 +479/-8,没有产品代码变更。旧 aee08e8d9419 的评审只覆盖旧的开发者入门,不作为本次批准依据。
关键内容讲解
- 双语普通入门 先给一个失败测试任务,明确 Codex App 的
$loopx和 Claude Code 的/loopx,并要求查看实际改动和运行过的测试。没有把创建 Goal、领取租约或jq设为前置。 - 可选手动参考 保留原命令块,英中版本与旧入门的 shell 内容逐字相同;新进程读回完成状态、证据和已退休租约,缺 claim 的完成操作须先被拒绝。
- FAQ 保留比较口径与反例:首读字节比例不是整轮 token、成本或成果提升;7/10 是指定快照的方向,四组近18小时配对和其余六组历史/未完整验证分开。当前 PG 源码候选与 #8747 的更广提案也保持分开。
规格依据为 c3e3ac56586fbbc686e3e2d01b979fe59a62dd19 的 docs/guides/newcomer-command-path.md。Reference Boundary 已实现:命令目录处于产品路径之后,可选参考不抢占首次任务。Choose The Loop Driver 已实现:沿真实支持的宿主入口与续跑 driver,LoopX 不冒充宿主执行器。用例索引、新手指南、FAQ 回链和 golden queries 的 CQ01 同步指向这条路径;未把任意问答都变成新建 Goal。
对主干的风险 / Risks
未发现阻塞 finding。最应防范的是文档预览通过后宣称模型已实际工作,或用小段字节测量宣称整个任务收益。本轮下载公开 2.3.0 wheel 并对照发布版 SHA256SUMS,在隔离目录安装 Codex/Claude 入口;发布版与本 head 的四次 guided preview 均保留完整任务和指定宿主,且不连接项目、不启动模型。这证明所引用的入口和任务传递可用,不能证明真实宿主已经完成任务。
可选 shell 原文在两版本上执行成功;额外缺 claim 的操作均以 lease_fence_required 拒绝,Todo 保持 open,再使用原领取凭证完成并从独立 CLI 进程读回证据及租约结束。八项隔离入口、预览、正常演示和拒绝后恢复检查通过。严格 MkDocs 构建通过,原生标准 premerge 的4项直接检查与13项选中检查通过。未查询或等待 CI。
我对版本固定的公开聚合重新求和:213次总唤醒含101次基线、112次周期内续跑,首读正文374,449字节、含CLI封装630,550字节,对约12.53 MB 的分母分别约3.0%和5.0%。按各题原始指标方向重算为7/10;Rust 的微小领先和 ANN OFF 的来源/时长缺口仍保留。这里复核了公开聚合及其引用口径,没有重跑实验,也没有独立审计原始轨迹。
页面检查使用本 head 的实际 MkDocs 输出。两语1440×900与390×844首屏均先呈现任务和三步路径,窄屏英文的第三步延续到下一屏;FAQ 的长段落、表格与下方 PG/审批边界继续可读,可选手动参考可从浏览器进入。英文桌面 FAQ 和中文390px下半部也已查看。没有用“无横向溢出”代替视觉判断。预览服务曾因本轮工具中断停止,在同一浏览器 TaskSpace 恢复后继续检查;这不是站点或文档的回归。
我的整体评价 / Verdict
APPROVE,作为完整的文档修订增量。普通用户的默认准备从手工生命周期变为已有助手入口与一个任务;底层权限检查和只读预览边界保留。长程工作仍由原宿主和状态 owner 接续,文档没有重建调度权威或承诺未验证的自动恢复。实际两语首屏在桌面和390px窄屏以任务为主;FAQ及可选参考保留技术细节与恢复路径。真实宿主模型执行、续跑和部署后的社区采用未验证。合入与实际社区采用保持各自的验收,当前精确版本的文档通过不替代这些结果。
English verdict: APPROVE — the assistant-first quickstart matches released entries and preserves the optional technical evidence and limits.
Goal and delivered outcome
Try LoopX by giving the assistant you already use one failing-test task. The bilingual quickstart now opens with installation, the Codex App or Claude Code entry, and what to inspect in the returned patch and tests. Move the existing SQLite, Todo and lease walkthrough to a separate developer reference. Keep the four-topic FAQ and connect its links to the revised guides and evaluation questions.
Use the current stable 2.3.0 entry contracts. The FAQ links to the corrected EdgeBench snapshot and distinguishes observed scores and packet bytes from causal or cost claims. It separates the source-checkout PostgreSQL scoped-read candidate from the broader proposal in #8747.
Validation
Tested head:
5177f78ea0897dfb183f1183c90191743fd3057d.First viewport
Local MkDocs build from the actual documentation sources, with public example text. Both languages were checked at 1440×900 and 390×844. The first viewport shows the task rather than the terminology table; the manual exercise opens from the optional link. This is a rendered documentation preview, not a deployed site or a running host.
aee08e8d945177f78ea0Scope and continuation
Author: model_agent, OpenAI GPT-6 family. Documentation only. The live assistant, group permissions, and published community sources can be qualified after normal review and merge. No runtime, deployment, or group setting changes.