Pi Workbench

pi-workbench

**pi-workbench** —— Windows 原生桌面工作台，围绕 [pi coding agent](https://github.com/earendil-works/pi)（`@earendil-works/pi-coding-agent`）的多供应商聚合路由而建。A native Windows desktop workbench for the pi coding agent, with multi-provider primary/backup routing.

不 fork、不改 pi。工作台以子进程方式运行 `pi --mode rpc`（stdin/stdout JSONL）驱动 pi 本体：会话文件是 pi 原生格式（`~/.pi/agent/sessions`），自定义模型在 `~/.pi/agent/models.json`，与 pi CLI 及其它工具完全互通。另有可选浏览器版（`server.mjs`），功能同一套 RPC 协议。


*上图为自检生成的示例截图，实际界面随主题与模型而异。*

---

功能特性

• Codex / ZCode 桌面风格原生 UI：PySide6 / Qt6 实现，浅色 / 深色主题；多项目工作区；pi 会话恢复与历史回放
• 完整思维链：流式显示模型 thinking 全文（默认展开，不打码不折叠）；工具调用卡片展示参数、输出与状态
• 每轮统计：输入 / 输出 tokens、缓存读 / 缓存写、缓存命中率、费用、耗时、上下文占用百分比
• 多供应商主从路由：providers 表直接来自 models.json；可手动启用 / 停用、按优先级排序、设置并发数限制；对每个 upstream 做按协议的健康探测，失败自动进入冷却。当前供应商请求失败时，按优先级自动 failover 到下一个可用配置并重试
• 多协议不绊脚：每个供应商可指定 api 协议 openai-completions / openai-responses / anthropic-messages / google-generative-ai，支持 compat 兼容开关与自定义 headers（含 User-Agent）。OpenAI / Claude / Grok(xAI) / Gemini / GLM / Kimi 等协议差异由 pi 原生协议层处理，界面上一键换模型
• 模型列表自动同步：从上游拉取 OpenAI 兼容 GET /v1/models，合并进本地 models.json
• 周边能力：Codex / Claude 本地历史会话只读导入浏览；git diff 面板；图片粘贴 / 附件发送

安装

方式一：安装包（推荐）

从 [GitHub Releases](../../releases) 下载 `PiWorkbench-x.y.z-setup.exe`（Inno Setup 打包），双击安装：

• 安装到 Program Files
• 创建开始菜单 / 桌面快捷方式
• 自带卸载器

安装包内已包含 pi 运行时与 Node.js，无需另装环境。

方式二：从源码构建

一键脚本（自动安装 Python 依赖、拉取 pi 运行时、PyInstaller 出 exe、Inno Setup 出安装器）：

scripts\build-windows.cmd

前置条件：Node.js ≥ 22、Python 3.13（pip）、Inno Setup 6（`ISCC.exe` 在 PATH 上；缺失时跳过安装器，仅产出 `dist\PiWorkbench` 载荷）。

也可手动运行源码版：

pip install -r desktop\requirements.txt
npm install
pythonw desktop\main.py

浏览器版：`node server.mjs` 后访问 `http://127.0.0.1:32123`（端口可用 `PIWB_PORT` 覆盖）。

供应商配置

供应商写在 `~/.pi/agent/models.json`。示例（内置 `juhe-150`）：

{
  "providers": {
    "juhe-150": {
      "baseUrl": "http://192.168.3.150:10088/v1",