开发者为 Pi Coding Agent 打造开源桌面控制台 Pi-Harness

V2EX，V2EX，Livid 创建的中国知名技术创意社区，关于技术、产品与生活的分享与讨论。关注
显示原文

当 AI 编码助手真正投入项目开发后，一个聊天窗口很快就不够用了。

你需要选择模型，配置提供商，查看上下文占用情况，了解助手调用了哪些工具；你还要在多个会话之间切换，浏览文件、检查 Git 差异、管理技能，必要时处理压缩、引导和后续跟进。

这些功能并不缺乏，但它们往往分散在命令行、配置文件和不同的工具中。

所以我打造了 Pi-Harness：一个面向 Pi编码代理 的开源桌面控制台与管理中心。

用一句话概括它：

Pi 负责运行助手，Pi‑Harness 则让你看清并掌控它的运行状态。
Work.jpg

它不是另一个套壳聊天客户端

Pi 编码助手本身已经具备完整的助手控制台：助手循环、工具、上下文、压缩、队列和会话等核心能力，均由 Pi 自身负责。

Pi‑Harness 既不取代 Pi，也不重新实现一套助手运行时。它所做的，是把原本分散在 Pi 周围的各项操作，整合为一个可见、可控、可管理的原生桌面工作区。

你可以直接使用原生 Pi，并继续兼容 Pi CLI 的会话；也可以在同一应用内完成模型配置、能力管理、项目浏览和 Git 操作。

这并不是把终端藏进窗口里，而是为 Pi 增设了一个真正围绕开发工作流设计的桌面控制平面。

从“与助手对话”，到“观察助手的工作”

在 Pi‑Harness 的工作区内，你可以新建或延续 Pi 会话，实时查看流式回复、思考过程、工具调用、上下文使用量以及会话统计信息。

模型、思考层级和工具预设可直接切换；必要时，可以触发上下文压缩，发送引导指令或后续跟进，还能分叉并导航会话历史。

这带来的变化十分直观：助手不再只是一个不断输出文字的黑盒。

你能清楚地知道它当前使用的是什么模型、剩余多少上下文、调用了哪些工具、会话处于何种状态，也能在任务进行中及时调整方向。

Work.jpg

项目、文件和 Git，就在助手身旁

写代码时，真正耗费注意力的往往不是某一次问答，而是在项目、终端、编辑器和 Git 工具之间反复切换。

Pi‑Harness 将这些高频操作收纳进同一个工作区：

  • 浏览项目文件，并对可读文本进行轻量编辑；
  • 显式保存文件，提示未保存状态，并处理外部修改冲突；
  • 查看 Git 状态和差异，配合工作树管理并行任务；
  • 打开多份 .code-workspace 文件，在多个项目目录间搜索与切换；
  • 让会话、文件和版本变更始终处于同一项目上下文中。
Git.jpg

Pi‑Harness 对编辑器的定位也很明确：它提供的是紧贴助手工作流的轻量文本编辑能力，而非再造一个 IDE。它不会用 LSP、调试器或复杂的插件系统把桌面端变成另一个庞然大物。

需要深度编码时，你仍然可以使用熟悉的 IDE；需要观察和控制助手时，Pi‑Harness 保持足够专注、足够轻量。

提供商和模型配置，不必再手动改 JSON

多模型开发的麻烦，通常不在于“模型不够多”，而在于提供商、协议、基础 URL、鉴权方式和模型参数很容易混淆。

Pi‑Harness 提供了完整的提供商与模型管理界面。你可以搜索预设，也可以接入兼容服务或自建网关；可以选择协议、填写密钥、测试连接，并设置当前使用的模型。

对于需要同时使用 OpenAI 兼容接口、Anthropic、Google、NVIDIA NIM、Ollama 或其他自定义服务的开发者，这比频繁打开配置文件、核对字段、排查格式问题要方便得多。

APIs.jpg
Model.jpg

技能与能力包，有了统一入口

v1.3.0 新增了统一的能力中心。

内置与本地技能、已安装的能力包、精选增强功能，以及 Pi 的实时能力包市场，都可以在这里集中查看和管理。市场支持搜索、筛选、排序、分页、查看详情、安装与更新。

Pi‑Harness 保留原生 Pi 作为内置默认能力。Superpowers、Odai 等方法论属于可选增强项，仅在用户主动确认后才会安装或启用。

也就是说，你既可以保持一套干净、原生的 Pi 工作流，也可以根据项目需求逐步组合自己的能力栈。

Caps.jpg

工具可以专业，也可以有点个性

开发工具不一定只能是千篇一律的深色面板。

Pi‑Harness 提供明暗主题、界面密度及多种外观风格。v1.3.0 还完整重制了古风桌面主题，从全窗口场景、人物、装饰边框，到按钮、标题栏、菜单、下拉框以及控制台界面，均采用统一的视觉语言。

如果你更偏爱克制的生产力界面，可以继续使用默认主题；如果想让每天打开的开发工具更有辨识度，也可以一键切换另一种氛围。

Caps.jpg

目前界面已支持英语、简体中文、繁体中文、日语、韩语、俄语、法语和德语。

谁适合使用 Pi‑Harness？

如果你符合以下任一情况，Pi‑Harness 可能会非常顺手：

  • 已经在使用 Pi 编码助手，希望获得更直观的桌面工作区；
  • 经常切换不同提供商、模型和思考层级；
  • 希望清晰看到助手的上下文、工具调用和会话状态；
  • 需要统一管理技能、能力包和可选开发方法论；
  • 想把助手、项目文件与 Git 变更放在同一个界面中；
  • 喜欢 Pi 的轻量化与可组合性，但希望减少手动修改配置和频繁切换命令行操作。

三步开始使用

Pi‑Harness 已提供适用于 macOS Apple Silicon、macOS Intel、Windows x64 和 Linux x64 的安装包。

使用流程很简单：

  1. 安装并启动 Pi‑Harness，检查 Node.js、npm、PATH 以及 Pi 环境；
  2. 配置提供商，选择模型；
  3. 打开项目，新建或延续一个 Pi 会话。

安装包用户无需克隆仓库，也不需要安装 pnpm。在支持的环境中，Pi‑Harness 可以检测、安装并修复 Node.js、npm、PATH 以及 Pi 编码助手的相关依赖。

当前版本：v1.3.0

macOS 社区构建可能未签名。若首次启动被系统拦截，可前往“系统设置 → 隐私与安全性 → 仍要打开”，具体说明请参阅发布说明。

写在最后

我打造 Pi‑Harness，并非为了给 Pi 换一个聊天窗口。

我更想解决的问题是：当助手开始承担真正的项目任务时，我们如何看清它的状态，如何控制它的行为，又如何让模型、上下文、工具、会话、技能、文件和 Git 回到同一个工作现场。

Pi‑Harness 仍在持续完善。下一阶段，我会进一步打磨控制台，使运行时、上下文、工具、压缩与会话之间的关系更加直观。

如果这一方向也解决了你的痛点，欢迎下载体验，也欢迎在 GitHub 上为该项目点个 Star。你的反馈，将帮助 Pi‑Harness 变得更加成熟、更加好用的 Pi 桌面工作区。

Pi 周边的一切，尽在此处。
添加评论
点赞收藏
点踩分享查看原文
评论
?
参与讨论