Repository navigation
RFC: unify distribution split and small-kernel runtime composition - #7672
Conversation
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>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent | OpenAI gpt-6.1-sol | reasoning_effort=max | runtime_reported
本次重审精确提交 bffb6b5cc52506be4b6fb3f65fb81e5e77ae2f99,完整读取双语 RFC,并重新核对最后一次提交的全部差异;没有发现本提案自身的阻断 finding。
动机 / Motivation
受影响的是维护包边界、CLI 启动和 managed 任务装配的贡献者,以及需要轻量本地使用和原产品路径兼容的用户。 原 RFC 主要约束目录与发行物;本提案把安装、加载、激活和模型上下文分开,并把最小受治理任务及恢复、产品结果返回和冷安装复验纳入同一计划。
一个稳定文件名和 #5072 下已有的设计,现已同时说明职责、装配、未决选择与可验证的阶段出口;本 PR 交付的是双语设计,未交付新的运行时或安装物。 不新增模型 loop、调度器、authority 存储、设备框架或强制 daemon;不批准新默认值、benchmark 运行、设备操作或宿主晋级。
独立依据是变更前已接受的规范:spec_ref=docs/architecture/rfcs/monorepo-distribution-split-v0.md;spec_revision=f2990e3de49d6aa7441e0e0b739f49bfc84aae38。本次核对 I1、I2、I3、I4、I5、I6 的原有单仓库、唯一 authority、公开 import 兼容、off-state、Node 缺失诊断与公开/私有/schema/许可证约束均保留。M0、M1、M2、M3、M4、M5 仍是原发行计划的未来实施;D1、D2、D3、D4 仍未被本提案批准。新增 V/R 条目及 D5–D7 是本次待接受的设计,不能作为自身运行交付已合格的证明。
改动思路 / Approach
安装、加载、激活和模型上下文分别约束,minimal/standard 复用同一治理实现。已有 typed TS owner 保留 work、lease、budget、stop、effect、receipt 与 recovery;宿主保留模型/工具执行;capability 选择策略;前端和 connector 继续使用既有命令及投影。
| 阶段 | 可独立交付的价值 | 保留的边界 |
|---|---|---|
| R0 | 一个真实 selected CLI 路由的加载/兼容与开销基线 | 可以先于目录、打包;不等于内核运行合格 |
| R1 / R2 | 源码装配的 managed 任务、恢复及一个产品工作流 | 可以先于 M3;源码验证不替代发行安装资格 |
| M3 | 干净拆包安装后复验已合格的 R1/R2 旅程 | 保留 M1/M2、Node 和组合选择门槛 |
| R3 / R4 | 另行授权的匹配实验或具体外部操作 | 不阻塞已合格 CLI/managed 切片,不授予运行权限 |
表格是设计路径说明,不是执行证据。本轮相邻简化已应用:沿用既有 RFC、文件名和 #5072,避免平行“小内核”设计与任务账本;没有要求先完成全部结构迁移才交付有用加载接缝,也没有预建无调用方的框架。
具体改动 / Changes
最终范围是五个 Markdown/索引路径,+551/-32,没有生产源码变更。README 与双语 STATUS 指向同一现行标题;controller/executor 台账计数修正为实际四条,没有因此宣称新 runtime 阶段完成。
关键内容讲解
- §2 / §5:用户旅程、职责与 preset 分层;一个 minimal 任务必须可执行和恢复,安装 standard 也不自动激活服务或授予权限。
- §5 / §7 / §8:按需加载与完整上下文,unknown effect 的核对、停机边界、fallback 退役条件,以及切换 binding 前静止/核对;不能让两个 writer 同写一个 binding,也不把模型停止当成设备确认停止。
- §9 / §11 / §12:V1–V10 分开语义、真实任务、安装、性能和实验资格;候选 p95 数值仍是 D6 建议。R1/R2 可先验证源码,但 M3 前后不能混淆冷安装资格。原 M0–M5 和 D1–D4 的身份、owner 与历史证据继续保留。
固定版本 DSH minimal/standard preset 确为同一 agent-preset 的不同 plugin 列表,SDK minimal 是自包含装配;Pi 的 transformContext / convertToLlm / prepareRequest / finishTurn 接缝也与所引一手源码一致。这些只支持装配设计,不证明 LoopX 宿主、权限或性能已合格。当前 CLI 的 selected dispatcher/fallback 与 performance-diagnosis 所述接缝已核对,未把源码审计写成实测加速。
完整中英文语义对照、committed bilingual check、生成索引检查通过;原生 premerge 的 4 项 direct + 18 项 selected 技术检查及公开/私有边界通过。没有查询、轮询或等待 GitHub CI。
对主干的风险 / Risks
补跑架构两套测试得到 27 passed / 2 failed。不可变 f2990e3de49d6aa7441e0e0b739f49bfc84aae38 和本次精确 head 的失败身份及细节一致:Lark projection 的 request_control_api → extensions.lark.manager_routing,以及 loopx-codex-provider-routing → loopx.runtime_activation。测试及两处实际原因源码逐字节相同,PR 只有五个文档路径;它们属于既有导入债务,未被本提案修复。
CQR 如实保留该 required validation 失败,外层 premerge 为 quality_invalid_receipt。本次设计审阅可以批准,完整验证、merge readiness 和 maintainer authority 仍是独立门槛,不能把技术子项通过或这份评审当成豁免。未来实现最需要防止的是:把 help 加速、源码 smoke 或文件数减少当作有用 managed 任务、恢复或安装已经通过。
我的整体评价 / Verdict
APPROVE,本次设计提案没有阻断 finding。 它给出了统一、可分段验证且可回滚的下一步,保留原兼容与 authority 契约;更大阶段仍由既有 #5072 及相关 owner 验收,不另造平行计划。
本 PR 仅改 RFC 正文与索引,没有改变渲染布局或产品首屏;已检查完整中英文文档、相对链接和实际调用边界。 未验证 minimal/standard 的运行实现、冷安装、真实模型采纳或性能收益;这些是后续资格条件。 没有执行合并、设备操作、付费模型实验或默认值变更。
English verdict: APPROVE
The monorepo distribution RFC needs to define what executes as well as where code is installed. This change extends that canonical English/Chinese pair into one design for directory ownership, distribution tiers and minimal/standard runtime composition over a single governance implementation.
The existing filename, tracking issue #5072, M0–M5 distribution milestones, D1–D4 decisions, public-import compatibility, host integration seam and historical evidence are retained. The design adds demand loading, explicit activation, context continuity, managed-task recovery, product/benchmark parity and provider-owned external-effect reconciliation. Runtime qualification is connected to the same delivery plan; selected CLI loading and minimal/standard source composition can qualify before packaging work, while split-package delivery must repeat the qualified journeys on a clean install. Full-parser retirement requires every supported command to migrate with help/diagnostic parity; no mandatory daemon is introduced. No runtime, installation default, schema or permission behavior changes in this PR.
Validation: staged and committed bilingual checks, generated RFC index, local links, table/reference consistency, private-material scan and diff whitespace checks passed. The supported host integration and historical ledger were compared against the prior document and remain unchanged. The five-file
loopx checkpublic-boundary scan passed; aggregate checking still reports unrelated local registry diagnostics. No benchmark or device operation was run. Generated indexes also refresh an existing controller/executor ledger count.Future-facing review: consolidates ownership and acceptance into the existing RFC instead of adding another normative entry. Typed authority and extension lifecycle are reused; runtime extraction remains a characterized implementation slice. Host/composition selection and performance budgets remain explicit open decisions.