Pace

项目简介

Pace 是专为 Pi Coding Agent 打造的桌面 GUI 工作台，基于 Electron + React 构建，已进入 0.y.z 早期迭代阶段。它不是简单的 API 套壳，而是把 Pi 作为后端独立引擎驱动，提供可视化的执行轨迹（Trajectory）、Diff 审查、Token 成本透视以及子代理观测能力。macOS 用户只需下载 DMG 安装，无需单独安装 Pi 运行时（已内置）。

核心功能

完整执行轨迹可视化：完整的 Tool Call 轨迹流，细化到每一步的入参、返回结果、耗时，以及每轮对话的真实 Token 消耗和费用账单，告别终端日志黑盒。

Session Dock 侧边栏：集成 Changes（Diff 审查）、Files、Terminal、Browser 四个面板，审代码和看终端输出不需要反复切换窗口。

子代理链路观测：支持关联到子会话回放（Subagent），多 Agent 协作或并发长任务不再是一团黑盒。

实时 + 回放双模式：可以观看 Agent 执行过程直播，也可以随时打开历史会话回放，查看每一步具体发生了什么、吃了多少 context。

插件扩展体系：专设插件面板接口，Pi 扩展可以贡献自定义可视化窗口（如子代理树状拓扑、自定义工作流检查器、测试结果仪表盘等），不局限于终端里打日志。

成本透明度：Token 消耗、缓存命中情况、每步费用全部可见，帮助开发者评估和优化 Agent 使用成本。

技术实现

Pace 整体是一条单向事件管道加两个持久化轨迹，采用以下核心技术方案：

Electron 多进程架构：主进程 + utilityProcess 独立运行后端（避免日志解析或 Driver 崩溃导致 GUI 卡顿）+ React 渲染层，三者通过 MessagePort 隔离通信。

事件标准化：Pi 运行时发出的原始事件统一经过 Normalizer 转换为标准 AgentRuntimeEvent，附加 phase、target surface 和全局确定性消息 ID，存入 Session Event Journal。Pace 界面所有状态均投影自该 Journal，而非来自易失的渲染层状态。

Runtime Gateway 协议：渲染层只与 Runtime Gateway 通信，控制命令上行，事件信封下行。Gateway 动态公告当前运行时能力（模型切换、Thinking 控制、排队和转向），UI 跟随运行时实际支持情况而非静态假设。

Pi 为唯一引擎：Pace 不是 Pi 的分叉或独立运行时，Pi 的本地 session log（~/.pi）是唯一上下文真相。卸载 Pace 不会删除 Pi 会话数据，Pace 共享 ~/.pi/agent 下的会话、认证和扩展配置。

前端技术栈：React 19 + TypeScript + Astryx 设计系统（StyleX 编译成原子 CSS）。

快速上手

1. 下载安装：前往 GitHub Releases 下载签名并公证过的 DMG 文件，拖入 Applications 完成安装（仅支持 Apple Silicon Mac，macOS 12+）
2. 首次启动：启动时 Pace 检查内置 Pi 运行时、数据目录和模型供应商登录状态，如未登录需通过终端运行 pi 完成配置
3. 创建会话：Preflight 检查通过后，选择项目目录并创建新会话
4. 发送指令：发送第一条消息，如让 Agent 解释代码库结构
5. 查看轨迹：在 Live Chat 阅读对话，在 Trajectory 中检查思维链和工具调用，在状态栏查看 Token 用量和费用

适用人群

• 高强度使用 Pi Coding Agent、想摆脱终端滚屏混乱的开发者
• 需要可视化 Diff 审查和 Token 成本分析的 Agent 使用者
• 多 Agent 协作场景下需要追踪子代理执行链路的团队
• 希望通过 GUI 工作台提升 Agent 使用效率的开发者

官方链接

GitHub：https://github.com/BubblePtr/pace Pi 官网：https://pi.dev