Deep 调查：简单、组合、复杂性
调查日期：2026-09-26。这轮基于既有 docs，继续研究 Raycast、Warp、Zed、Grok Build，并以 PI-Desktop 和 Yuuki Box 的实际代码作对照。主题从“用了什么技术”推进到三个问题：什么变简单了，什么可以组合，剩下的复杂性由谁承担。
核心判断：这些造物值得学习的地方，是让少数稳定的操作单位承载丰富能力，并持续维护这些单位之间的契约。 接口统一只是起点；状态归属、时间顺序、取消、副作用和资源寿命决定组合能否可靠工作。这个判断来自以下案例分析，不是各产品共同发表的设计宣言。
| 文档 | 重点 |
|---|---|
| 01 · 分析框架 | 简单与容易、四种组合、复杂性的来源、为什么用变化实验而不打总分 |
| 02 · Raycast 与 Warp | 条目与动作、Shell 与 Block、受控交互、审阅反馈，以及启动和完成的区别 |
| 03 · Zed 与 Grok Build | 片段与坐标、会话与工具、宿主与协议、扩展边界、终端源码与 Web 产品的区别 |
| 04 · 回到 Yuuki | 新增工具、取消、切换语音后端、原生桥扩展的实际变化链与七个探针 |
想先看造物，直接读 02、03；想把研究用于自己的项目，接着读 04，再回查 01 的判断方法。上一轮 Zed / Rust / PI 调查保留完整 crate 导航与调用链，本轮引用其证据，不重复生成相同清单。
四个产品，四种值得保留的单位
Section titled “四个产品，四种值得保留的单位”下表是本轮归纳；每项的源码、API 与适用边界在对应章节就近列出。
| 造物 | 本轮关注的组合单位 | 用户少承担什么 | 实现继续承担什么 |
|---|---|---|---|
| Raycast | 命令、结果条目、上下文动作 | 重学交互、寻找当前能做的操作 | 受控组件语义、运行时、桥接、provider 差异 |
| Warp Terminal | 一次执行的 Block，以及关联的工作区变化 | 找日志边界、搬运命令背景与审阅意见 | Shell/PTY 兼容、输出存储、可见性、Agent 差异 |
| Zed | Buffer、excerpt、Editor、工作区 Item | 在多种文本呈现中切换操作方式 | 坐标、版本、增量同步、任务与平台生命周期 |
| Grok Build | 定义、会话、工具调用、进度与终态 | 手动衔接模型、工具和不同操作入口 | 资源归属、权限、取消、扩展配置、协议；Web 平台另承担托管工作 |
四者没有一套相同架构，也没有共同证明“更多模块”“全用 Rust”或“功能更多”自然更简单。它们给出的共同研究线索，是选择能保留真实身份与语义的对象，再让高频操作围绕它组合。Raycast / Warp 证据 · Zed / Grok 证据
比上一轮多挖到什么
Section titled “比上一轮多挖到什么”- 组合有层次。 呈现组合、能力复用、可靠任务衔接和跨进程部署，分别需要不同保证。Warp 的共同滚动区域不能证明所有执行对象同构；Raycast 的
launchCommand启动确认不能当作完成结果。 - 抽象有失效点。 Zed 的内部 Agent crate 仍绑定应用体系；Grok 可复用定义与 Builder，但构建后的 Agent 有会话上下文；同名接口和独立目录都不能证明可随意抽走。
- 复杂性可以减少。 去掉重复权威、缩小并发范围、延后不需要的通用性，会减少实际状态与同步关系；把部署或桥接交给平台，则主要改变承担者。两种情况应分开写。
- 极简要保留关键事实。 Whisper 的转写阶段、工具写入后再取消的副作用、流的终态，都影响下一步行动，不能为减少界面状态而抹掉。
- 本地项目在变化。 本轮期间共享 Swift Agent runtime、工具循环、持久会话与 Whisper 扩展已经出现实现，文档入口也同步更新。它们还没有真实 API/录音与端到端验收，不能继续用“只有 UI 样例”概括，也不能写成运行验证完成。
第 1 项详见 02/01，第 2 项详见 03，第 3 项是 01 的研究归纳，第 4/5 项详见 04。这里没有新增技术栈决策、改写应用代码或要求先建设完整平台。
版本与证据范围
Section titled “版本与证据范围”| 对象 | 证据基线 | 本轮能确认的范围 |
|---|---|---|
| Raycast | 2023-05-31 v1 工程文；2026-05-14 v2 工程文；读取时的官方 API | 公开实现说明和 API 契约；没有完整私有源码或独立运行验证 |
| Warp | 5af88f49f84e70025f9c19e13f6b9ae64b624627，提交时间 2026-09-25T22:26:47Z | Terminal 客户端、Shell/Block/存储的定点源码；不能外推全部云产品 |
| Zed | 本地 7ea077c78b865d17854cee812bb775dbe64a925a | 承接上轮源码链与清单，重新分析组合与复杂性 |
| Grok Build | f0e3be1100ef5252488e3be8bb0e91cf68d8c305，提交时间 2026-09-23T16:52:41Z | 公开 Rust Agent/TUI 的定点源码与官方协议；Web/mobile 另依据产品公告 |
| PI-Desktop | 上轮工作树，HEAD e0d142ba56ced0c1d76eba8ab2a96c07959ad4e6，包含当时暂存变动 | 沿用上轮责任、协议与取消分析，没有宣称纯 HEAD 可重建当时全部内容 |
| Yuuki Box | 2026-09-26 调查时 docs/examples，无 Git 快照，且实现并行更新 | 当前静态代码与文档描述；关键引用文件的内容指纹见 evidence.json |
固定提交入口：Warp、Zed、Grok Build。网页 API 可能继续变化；事实引用以本轮读取状态为准。
**证据用语：**源码或 API 支持的内容是事实；官网功能说明是官方自述；收益、代价和 Yuuki 适用性是分析或建议；未运行的行为与没有公开实现的部分保留为待验证。定点读过一个取消分支，不代表审计了整个安全或恢复体系。
本轮只写研究与导航资料。没有运行四款产品、调用模型、录音、构建参考仓库或新增性能测量。Grok 官方源码仅按固定提交读取选定文件，没有执行其中的安装或构建命令。本地绝对路径便于这台机器跳转，后续代码变化时应结合 symbol 与内容指纹重新定位。
evidence.json记录本轮最终文档检查、引用到的本地文件指纹，以及下载到临时目录的 Grok 固定源码文件指纹。它不是参考项目的完整快照，也不包含密钥、用户会话内容或模型输出。
链接存在、行号有效、围栏配对是文档检查；正文的重要解释另经定点源码与官方资料复核。这些检查不等同于真实任务、权限、取消竞态、语音或性能验收。Mermaid 图表达已标注的职责关系，本轮不声称运行了图形渲染器。