|
1 | 1 | # Rust Agent Runtime 剥离计划 |
2 | 2 |
|
3 | | -> 状态:r5。r2 的计划稿之上,**已拆除 Rust runtime 并恢复 `/model`(r3);r4 补了阶段 0 的 Linux CI 与基线工具、清掉 leader 的 UI 状态残留、完成 1.R3 的命名;r5 在 Linux CI 上跑通并启用了基线,执行入口审计(0.6)并完成阶段 A(A.3、A.4)——又删了约 23 万行 Rust、8 个 crate,消费者构建 0 告警**。分支已 push,draft PR [#7](https://github.com/zy1233/pi-python/pull/7);执行记录见 §10。§1–§9 保留 r2 原文作为决策依据,与 §10 冲突处以 §10 和 ADR3(r3)为准。负责人:待指派。 |
| 3 | +> 状态:r6。r2 的计划稿之上,**已拆除 Rust runtime 并恢复 `/model`(r3);r4 补了阶段 0 的 Linux CI 与基线工具、清掉 leader 的 UI 状态残留、完成 1.R3 的命名;r5 在 Linux CI 上跑通并启用了基线,执行入口审计(0.6)并完成阶段 A(A.3、A.4)——又删了约 23 万行 Rust、8 个 crate,消费者构建 0 告警**。分支已 push,PR [#7](https://github.com/zy1233/pi-python/pull/7) 已转 ready for review;**r6 清理了品牌残留(把还写着 Grok、或指向不存在的命令 / 目录的提示改成真的东西,见 §10.8),在叠加分支 `codex/branding-cleanup` 上**;执行记录见 §10。§1–§9 保留 r2 原文作为决策依据,与 §10 冲突处以 §10 和 ADR3(r3)为准。负责人:待指派。 |
4 | 4 | > 基线:分支 `codex/rust-agent-runtime-removal-plan`;r2 / r3 的比较基线是 HEAD `07a3574`,r4 / r5 的提交见 §10。 |
5 | 5 | > 验证方式:r2 为静态分析(源码阅读、`Cargo.toml` 解析、模块级引用统计,复现方法见附录 B);r3 起拆除结果由 `cargo check`(macOS 本机,消费者构建 `pi-pager-bin` / `pi-pager-minimal` / `pi-update` 及 `pi-shell` / `pi-pager` 的 `--tests` 类型检查)、`cargo test`(触及的 crate)、Python 侧 pytest,以及伪终端里 `zypi` ↔ `pi_agent_cli` ↔ OpenRouter 的真实会话(含 `/model` 切换)验证。标「需实测」的其余结论仍是静态推断;Linux / Windows 的 `cfg` 代码本机无法编译,见 §10.4。 |
6 | 6 | > 与既有文档的关系:承接 [Phase 4 设计](../specs/2026-08-25-phase4-coding-agent-cli-design.md) §3「第一轮允许 pager 继续链接 `xai-grok-shell`……变瘦不是迁入前提」和 [`AUDIT-PHASE4-PHASE5.md`](../AUDIT/AUDIT-PHASE4-PHASE5.md) 的「TUI 瘦身长期里程碑」,是 Phase 4 的第二轮。与既有决定的张力见 §3。 |
@@ -247,9 +247,9 @@ Rust(pager): |
247 | 247 | - 新增 TUI 功能(MCP、queue、subagent UI 等)——另立计划并过 P2 准入。(`/model` 不在此列:r3 已按 ADR3 经 Session Config Options 恢复。) |
248 | 248 | - 多会话共享进程(leader 的替代方案)。 |
249 | 249 |
|
250 | | -## 10. 执行记录(r3、r4、r5) |
| 250 | +## 10. 执行记录(r3、r4、r5、r6) |
251 | 251 |
|
252 | | -r3 执行了「拆除 Rust runtime + 恢复 `/model`」;r4 在其上补了阶段 0 的 CI / 基线、清理 leader 的 UI 残留和生命周期命名;r5 把分支推上远端、在 Linux 上启用基线,执行入口审计并完成阶段 A(§10.7)。下表是 r3、r4 的提交,按当时的状态保留(当时都是本地提交、**未 push**),分支是 `codex/rust-agent-runtime-removal-plan`: |
| 252 | +r3 执行了「拆除 Rust runtime + 恢复 `/model`」;r4 在其上补了阶段 0 的 CI / 基线、清理 leader 的 UI 残留和生命周期命名;r5 把分支推上远端、在 Linux 上启用基线,执行入口审计并完成阶段 A(§10.7);r6 清理品牌残留(§10.8)。下表是 r3、r4 的提交,按当时的状态保留(当时都是本地提交、**未 push**),分支是 `codex/rust-agent-runtime-removal-plan`: |
253 | 253 |
|
254 | 254 | | 提交 | 内容 | |
255 | 255 | |---|---| |
@@ -496,7 +496,47 @@ r3 执行了「拆除 Rust runtime + 恢复 `/model`」;r4 在其上补了阶 |
496 | 496 | 3. **A.3 的尾巴**(可选,同样的折叠器办法):3d-6 CLI 旗标瘦身——欢迎页与选择器里的 worktree 入口已在 `ac1d3ff` 删掉,但 `-w/--worktree`、`--worktree-ref`、`--restore-code`、`/new` 的 worktree 模式(`new_session_worktree_mode`、`Action::NewWorktreeSession`、`Action::ChooseNewSessionMode`)和 `allow_remote_restore` / `suppress_code_restore` 的「远端恢复」世界仍在,标准 ACP 下 `Effect::CreateWorktreeSession` 恒返回 `WorktreeSessionFailed`,这些路径恒假;它们归 1.P6 的旗标契约一起定。欢迎页隐私横幅(`views/privacy_banner.rs`,「Help improve Grok」数据共享广告)按代码读只有设了环境变量 `GROK_PRIVACY_NOTICE_ROLLOUT` 或远端设置才会出现(没有实测),同属「靠数据恒假」的世界,约 1k 行、15 个文件。3f plan 审批 / btw / cta;3d-4 认证 / 计费界面归阶段 D.3。 |
497 | 497 | 4. **A.4 的尾巴**(可选):`pi-shell-base` 等其余 crate 的 `pub` 瘦身(没做过);`pi-shell-base/src/env.rs` 里死掉的 gateway-bridge 常量;约 25 处局部 `#[allow(dead_code | unused*)]`(有的是平台门控,要看 Linux);`pi-shell/src/session/storage` 的 `relocation`(`#[allow(dead_code)]`,归 D.2)。 |
498 | 498 | 5. **阶段 1 才开了个头**:做了 1.P1 的一半(标题与 `updated_at`)、1.P5 的一个 bug(`session/close` / `resume` 的路由)、0.3 / 1.P7 的 Python 一侧(stdio 契约套件)。余下的需要拍板:① 优雅退出(1.P2、1.R3 ②)**已做**(`f14e321`、`e8557e5`),宽限取了 3 s(`AGENT_EOF_GRACE`,一个常量,要换数字由用户定);还剩 `stderr` 去向(1.R3 ①)、zypi 不是会话首进程时被 `kill -9` 的端到端情形、Linux / Windows 上的退出行为;② pager 跟 `nextCursor`(才能在 Python 端分页);③ 1.R1 ADR1(`--continue` / `--resume` 的磁盘读取);④ 1.P6 旗标契约。阶段 0 的 0.3 的 Rust 一侧、0.5、0.7–0.9 仍未做。 |
499 | | -6. **文档与声明**:C.2 内嵌 user-guide;C.3 `tui/NOTICE` 与 `THIRD-PARTY-NOTICES`(依赖已少了 28 个包,需要重新生成;对外发布二进制前由用户定措辞)。还有**品牌残留**:用户看得见的有 `/theme` 里的「Grok Night / Grok Day」、桌面通知标题「Grok」(审批请求、会话就绪、回合结束)、`zypi doctor` 的「Grok Doctor」、`zypi disk-usage` 提示里的 `grok worktree gc`;代码里还有 `grok-pager` 之类的客户端标识。是否改名、改成什么,由用户定。 |
| 499 | +6. **文档与声明**:C.2 内嵌 user-guide;C.3 `tui/NOTICE` 与 `THIRD-PARTY-NOTICES`(依赖已少了 28 个包,需要重新生成;对外发布二进制前由用户定措辞)。**品牌残留**:~~用户看得见的~~ r6 已清理(§10.8;用户没给新名字,沿用 zypi)。没清的是用户看不见的标识,列在 §10.8 的「有意没动的」。 |
| 500 | + |
| 501 | +### 10.8 r6 追加:品牌残留清理 |
| 502 | + |
| 503 | +**起点与决定。** §10.7 遗留第 6 项把品牌残留留给用户定名字。用户选了「清理 Grok 品牌残留」,没有给新名字;r6 沿用产品里本来就有的名字 **zypi**(`brand.rs` 的 `PRODUCT_TITLE`、终端标题、英雄区、`--help` 早就是它)。要换名字,改 `brand.rs` 的常量和下面两个主题 id 即可。工作在分支 `codex/branding-cleanup` 上,作为叠在 PR #7 之上的 PR(base 是 `codex/rust-agent-runtime-removal-plan`),不动 #7。 |
| 504 | + |
| 505 | +**改了什么。** 只改用户看得见的。其中三处不只是名字问题,而是提示指向了不存在的东西: |
| 506 | + |
| 507 | +1. **`zypi doctor fix ssh-wrap` 会写出坏掉的 alias。** 受管块里写的是 `alias ssh='grok wrap ssh'`,`grok` 这个命令不存在,用户一执行 fix,之后每次 `ssh` 都会失败。现在写 `alias ssh='zypi wrap ssh'`,块标记从 `# >>> grok doctor >>>` 改为 `# >>> zypi doctor >>>`(以前跑过 fix 的人要手动删掉旧块;旧块不会被新版识别)。 |
| 508 | +2. **路径提示指向不存在的目录。** 配置目录在消息里叫 `~/.grok` / `$GROK_HOME`,实际是 `~/.pi-python` / `$PI_HOME`(`pi-home` crate)。设置页脚、复制提示里的备份文件路径、doctor 对 `config.toml` / `sandbox.toml` 的指引,都会让用户去打开一个不存在的文件。现在 `display_grok_home_prefix_for` 返回 `~/.pi-python` / `$PI_HOME`。 |
| 509 | +3. **提示里的命令不存在。** 内置斜杠命令里没有 `/doctor`、`/minimal`、`/fullscreen`、`/copy`;CLI 里没有 `grok wrap`、`grok worktree gc|rm|db rebuild`。改成真有的:`zypi doctor`、`zypi wrap ssh <host>`、`zypi --minimal` / `--fullscreen`;`zypi du` 里指向 `worktree gc / rm / db rebuild` 的提示删掉,只留「删掉上面列出的、不再需要的 worktree」。 |
| 510 | + |
| 511 | +| 位置 | 之前 | 之后 | |
| 512 | +|---|---|---| |
| 513 | +| `/theme`、设置里的主题 | `Grok Night` / `Grok Day`,落盘 id `groknight` / `grokday` | `zypi Night` / `zypi Day`,落盘 id `zypinight` / `zypiday`。旧 id 与别名(`groknight`、`grok-night`、`GrokNight`、`grokday`、`grok-day`、`dark`、`light`、`day`)仍可解析,读到旧值会规范成新 id,已有的 `config.toml` 不用改 | |
| 514 | +| 桌面通知标题 | `Grok`(审批请求、会话就绪、回合结束) | `zypi`(`brand::PRODUCT_TITLE`);通知命令模板的注释同改 | |
| 515 | +| `zypi doctor` | 标题 `Grok Doctor`,结尾指向不存在的 `/doctor` | `zypi Doctor`,说明某些检查只在运行中的 zypi 会话里做 | |
| 516 | +| 启动提示、SSH 提示 | 「Run /doctor for details and fixes.」 | 「Run zypi doctor for details and fixes.」 | |
| 517 | +| 设置页 | 「Switch this session only with /minimal or /fullscreen」「Show a /doctor tip…」「(Grok STT)」 | 「…by starting zypi with --minimal or --fullscreen」「Show a zypi doctor tip…」,去掉 Grok STT | |
| 518 | +| 复制提示 | 「use grok wrap or /minimal」「Try /doctor or /minimal」 | 「use zypi wrap or --minimal」「Try zypi doctor or --minimal」 | |
| 519 | +| `--minimal` 模式 | 欢迎页标题 `Grok Build`;信任提示「Grok Build may run or modify…」 | `zypi` | |
| 520 | +| 其他 | 启动超时「Couldn't start Grok」、语音「Restart Grok」、状态栏脚本「encode Grok's payload」、`zypi wrap` 的报错前缀 `grok wrap:` | `zypi` | |
| 521 | + |
| 522 | +**提交**(都在 `codex/branding-cleanup`,叠在 `ea5a60d` 之上):`dbc8d7d` 路径标签与复制提示;`a08f12f` 主题改名与设置页文案;`1f3006b` doctor 与 ssh-wrap fix;`111d46d` 通知标题;`665b539` `zypi du`;`0f05f83` 其余字符串。每个提交带自己的测试,改动里没有重排或格式化。 |
| 523 | + |
| 524 | +**有意没动的。** |
| 525 | + |
| 526 | +- 用户设置的接口:428 个 `GROK_*` 环境变量名(`GROK_HOME`、`GROK_SANDBOX`、`GROK_THEME`、`GROK_MESSAGE` 等,`--help` 里还看得到)、项目级路径 `.grok/sandbox.toml`、`zypi du --json` 的 `grok_home` 字段(机器可读,改了要升 schema 版本)。改名是破坏性变更,要用户另行决定。 |
| 527 | +- 内部标识:`grok_*` crate 名、`ThemeKind::GrokNight`、`Theme::groknight()`、`groknight.rs`、`grok-night.tmTheme`、HTTP 头 `x-grok-*`、上游 URL 与包名。 |
| 528 | +- 死世界里的字符串:计费 / SuperGrok、tutorial、隐私横幅、feedback 问题、`pi-update`(`grok update`、版本策略)、`pi-shell` 的认证错误(`grok login`)、给模型看的工具描述、ACP 的 auth method「Grok」。它们归 A.3 的尾巴 / 阶段 D;现在改只会和之后的删除互相冲突。 |
| 529 | +- `tui/crates/codegen/pi-pager/docs/user-guide/`:整套是上游文档(C.2),主题表里还写着 `GrokNight`。旧名字仍是有效别名,文档不会误导,只是旧。 |
| 530 | + |
| 531 | +**验证。** |
| 532 | + |
| 533 | +- **编译**:`cargo check -p pi-pager-render -p pi-pager -p pi-pager-minimal --all-targets` 0 错误 0 告警;debug `zypi` 构建 0 告警。 |
| 534 | +- **单测**(macOS 本机,`--test-threads=2`,只跑相关过滤):pi-pager-render 的 theme / util / clipboard 265 通过;pi-pager-minimal 79;pi-pager `--lib` 的 theme / settings / doctor / diagnostics / disk_usage / notifications / startup / tips / wrap / status_line 1,068;`settings_e2e` 251;`grok_home_paths` 2;`doctor_early_dispatch`(真二进制,`--ignored`)13,其中包括往 rc 里写 alias 的那一条。 |
| 535 | +- **新增的回归测试**:旧主题 id 与别名仍可解析、主题的落盘 id 与显示名不含 grok(`pre_rename_theme_names_still_resolve`、`house_themes_are_named_after_the_product`、`current_value_for_theme_reads_pre_rename_ids`);路径标签指向真实目录(`home_labels_name_the_real_home_directory`);fix 命令与 alias 用 `brand::CLI_NAME`(`fix_commands_and_alias_name_this_binary`);`DOCTOR_ACTION` 不带斜杠;复制提示、设置页文案、剪贴板修复提示不含 grok 和不存在的斜杠命令;`zypi du` 不再提示 `worktree gc|rm`、`db rebuild`。 |
| 536 | +- **PTY**(debug `zypi` + mock agent):全屏模式扫了欢迎页、命令面板、`/help`、`/theme`、`/settings`(逐行走完整个列表,共 16 屏)、`/model`、一个回合、`/resume`、Ctrl+C 提示;`--minimal` 扫了欢迎页、`/help`、一个回合——含 `grok` 或不存在的斜杠命令的行:0。`config.toml` 里写旧值 `theme = "grokday"`,`/theme` 把 `zypiday` 标成 active;默认家目录时设置页脚写 `~/.pi-python/config.toml`,`PI_HOME` 指到别处时写 `$PI_HOME/config.toml`。 |
| 537 | +- **CLI**:`zypi doctor`、`du`、`--help`、`version`、`wrap` 的输出里只剩 `--help` 的 `[env: GROK_SANDBOX=]`(环境变量名,有意不动)。 |
| 538 | +- **已知的本机波动**:有一次过滤运行里 `session_startup::tests::remote_miss_restore_code_with_worktree_defers` 失败。它在 macOS 上读真实的 `~/.pi-python/sessions/<临时仓库路径>`(`/var` 与 `/private/var` 的差别),目录不存在就报错,跟本次改动无关;之后的运行里通过。 |
| 539 | +- **Linux CI**:见 PR。 |
500 | 540 |
|
501 | 541 | ## 附录 A:能力矩阵(阶段 0.8 的初稿) |
502 | 542 |
|
@@ -760,3 +800,4 @@ LoC 用 `python3` 递归统计 `*.rs` 行数(沙箱内 `xargs wc -l` 可能失 |
760 | 800 | - r3:在工作区执行 Rust runtime 拆除并恢复 `/model`(当时未提交,现已本地提交,见 §10)。主要变化:新增 §10 执行记录;ADR3 推翻 r2 的「`/model` 从白名单移除」,改为经 ACP Session Config Options 恢复(Python 公布 `configOptions` 并路由 `session/set_config_option`,pager 读 `configOptions`、无该配置项时退回旧 `session/set_model`);P1 增补「任何 runtime(含将来的 pi-rust)都必须作为独立 ACP agent 位于 ACP 之后」;§7 勾选 A.1、A.2(主体)、B.1、B.5、B.6,A.3、A.4、B.3 未做,B.2、B.4 换了做法或只做了一部分;§4.4 关于「出站 `x.ai/*` 被 `channel.rs` 丢弃」的判断被实测推翻(§10.4)。验证以消费者构建、单测、PTY 真机 `/model` 切换与 OpenRouter 真实会话为准,没有 Linux / Windows 结果,阶段 0(CI、基线、契约 / e2e)仍未做。 |
761 | 801 | - r4:把 r3 的工作区改动提交到本地分支(**未 push**),并补三件事:① 阶段 0 的 0.1 / 0.2 / 0.4——Linux CI workflow、基线执行器与清单、基线报告 `docs/baselines/tui.md`(0.4 勾选;0.1 / 0.2 因为 workflow 没在 Linux 上跑过而不勾选);② 清掉 leader 的 UI 状态残留(A.2 的尾巴),生产行为不变,测试夹具改用生产默认值;③ 1.R3 的命名与提示语(行为不变,`stderr` 去向、优雅退出、残留进程实测仍未做)。同时把 §10.4 的 leader 残留改写为四类「不是 UI 残留」的剩余(273 行 / 80 个文件),新增 §10.6,并更正测试基线(清理 leader 时随被删代码删掉 18 个测试,10,857 → 10,839)。验证仍是 macOS 一台机器:门禁、`--workspace --tests`、8 个 suite、PTY 烟测;没有 Linux / Windows 结果。 |
762 | 802 | - r5:推送分支、开 draft PR [#7](https://github.com/zy1233/pi-python/pull/7),并完成阶段 A 与阶段 0 的 0.1 / 0.6。① 第一次 Linux `TUI CI` 全绿后把基线转为阻塞,依赖图上限 995 → 980、告警上限 20 → 0、各 suite 设 `min_passed`;② 入口审计(0.6)按附录 A 的默认执行,A.3 删除 dashboard、白名单外的斜杠命令、agents / extensions / persona 模态、tasks / 后台 / 定时任务、subagents / workflows / goals、共享 prompt 队列、MCP / hooks / plugins / marketplace 入口、rewind / fork / jump、recap / feedback / consent、changelog、`--chat` 世界、session rename 的死链路;③ A.4 去掉各 crate 根的 `#![allow]`(消费者构建 0 告警)、`pi-shell` 的 `pub mod` 降级、删未用依赖与 8 个无人依赖的 crate、删 `cfg(feature = "local-workspace")` 代码;④ `-p` 无沙箱时拒绝运行(ADR7 的最小版本)。净效果:`tui/crates` 的 `.rs` 从 1,252,374 行降到 1,019,041 行,`Cargo.lock` 1,285 → 1,257 个包,Linux 依赖图 995 → 980。新增 §10.7 与附录 A 的 r5 结果。⑤ 收尾:PTY 烟测发现并删掉欢迎页与选择器里的死 worktree 入口(`ac1d3ff`);手动 `release_baseline` 回填了 release 数(`zypi` 422,034,120 B,−10.3 %;冷缓存构建 1,155 s,−29.9 %;0.2 勾选);阶段 1 开了头——`session/list` 的标题与 `updated_at`(1.P1 一半)、stdio 契约套件并修了 `session/close` / `resume` 的路由(0.3 / 1.P7 的 Python 一侧、1.P5 的一个 bug)、优雅退出(1.P2 完成,1.R3 ② 完成:退出 zypi 时 bash 工具进程不再残留——双击 Ctrl+Q、`kill -9 zypi`、SIGTERM、关终端都量过,前因后果见 §10.7)。验证:Linux CI(`0e71894`、`cca48b0`、`ac1d3ff`)、macOS 本机、PTY。阶段 1 的其余部分和 0.5 / 0.7–0.9 未做,见 §10.7 的遗留。 |
| 803 | +- r6:清理品牌残留(用户选了「清理 Grok 品牌残留」,没给新名字,沿用 zypi),分支 `codex/branding-cleanup`,叠在 PR #7 之上;PR #7 同时转为 ready for review。改动:主题改名为 `zypi Night` / `zypi Day`(落盘 id `zypinight` / `zypiday`,旧 id 与别名仍可解析)、桌面通知标题、`zypi doctor` 的标题与全部提示、启动 / SSH 提示、设置页描述、复制提示、`--minimal` 欢迎页与信任提示、`zypi wrap` 报错前缀。顺带修了三处「提示指向不存在的东西」:`zypi doctor fix ssh-wrap` 写进 shell rc 的是 `alias ssh='grok wrap ssh'`(`grok` 不存在);配置目录在消息里叫 `~/.grok` / `$GROK_HOME`(实际是 `~/.pi-python` / `$PI_HOME`);`/doctor`、`/minimal`、`/copy`、`grok worktree gc|rm|db rebuild` 都不存在。有意没动的见 §10.8。验证见 §10.8。 |
0 commit comments