BlackBeltTechnology/pi-agent-dashboard

PI Dashboard – 快速概览

它是什么：一个基于网页的控制面板，让您可以运行、观察并与多个 pi 编程代理实例（来自 Bad Logic 的开源 AI 驱动代码助手 pi）进行交互。该仪表板作为 Node.js 服务器（或 Electron 桌面应用程序）运行，并提供一个单一浏览器标签页，您可以在其中启动新代理、查看其实时推理过程、附加 OpenSpec 变更并管理成本。

主要功能

• 实时会话镜像 – 每个活跃的 pi 会话都会立即出现在 UI 中，并提供实时流式聊天、Token 使用量、模型信息和进度条。
• 双向交互 – 您可以直接从浏览器发送提示、运行工具指令或回答 ask_user 对话框。
• 工作区组织 – 会话按文件夹/分支分组，并可通过拖放进行重新排序。
• 集成终端与差异查看器 – 内置浏览器终端 (xterm.js + node-pty) 以及用于文件变更的并排差异工具。
• OpenSpec 与流程集成 – 从同一个 UI 浏览规格变更、运行 pi-flows 并查看流程图。
• 供应商管理 – 添加 Anthropic、OpenAI、Gemini 等的 API 密钥；支持自定义 LLM 端点并实时生效。
• 扩展系统 – 插件可以公开由斜线指令触发的模态 UI，无需编写 React 代码。
• 网络功能 – 自动 mDNS 发现、选配的 Zrok 公共通道，以及供 Claude Desktop 等外部客户端使用的 MCP 端点 (POST /mcp)。
• 移动设备友好 – 具备触摸目标和滑动抽屉的响应式布局。

如何获取

1. Electron 应用程序 – 从 GitHub Releases 页面下载预先构建的安装程序 (macOS, Linux, Windows)。无需 Node.js 或终端；安装向导会在 ~/.pi-dashboard/ 中设置 pi 和仪表板。
2. npm 软件包 – 运行 npm i -g @blackbelt-technology/pi-agent-dashboard 然后运行 pi-dashboard (或 pi install npm:@blackbelt-technology/pi-agent-dashboard)。在 http://localhost:8000 打开。
3. 从源代码安装 – 克隆仓库，使用 corepack enable 启用 pnpm，运行 pnpm install && pnpm run build，然后使用 pi install … 安装。
4. Docker – 在 docker 文件夹中运行 docker compose up -d --build，即可在容器中运行整个堆栈（服务器、pi 代理、code-server、Zrok、tmux）。

典型工作流程

• 启动仪表板（桌面应用程序或浏览器）。
• 使用 Settings 面板添加您的 LLM 供应商密钥。
• 点击 New Session → 选择文件夹/分支和启动策略（无头模式或 tmux）。
• 实时观看代理的推理流；回答任何出现的 ask_user 提示。
• 从侧边栏附加 OpenSpec 变更或运行 pi-flow。
• 完成后，停止会话（软中止 → 强制终止）或让其完成并导出日志。

适用对象

• 已经使用 pi 编程代理并希望以可视化方式管理多个并发代理的开发者。
• 需要监控 Token 花费、按项目组织会话或通过 Zrok 将仪表板公开给远程协作者的团队。
• 希望通过自定义模态对话框扩展 UI 的插件作者。

更多信息

• 演示网站：https://blackbelttechnology.github.io/pi-agent-dashboard
• Discord 社区：https://discord.gg/uQsJgsejb
• 完整文档位于仓库 (docs/ 文件夹) 中，涵盖安装、配置、扩展开发和故障排除。

---

总结：PI Dashboard 是一个真正可投入生产的 UI，用于编排多个 pi AI 编程代理，提供实时监控、会话控制和扩展性——所有功能皆可通过单一浏览器标签页或封装好的 Electron 应用程序访问。