$ cat ~/map/pion.md

Pion

RPC 驱动的 Electron 桌面端：流式对话、会话分叉与有界多代理流程。

tools✓ 9月9日

事实速查

安装

./dev.sh

## 速览

本地 Electron 加 React 桌面 GUI，以 RPC 子进程方式驱动 pi 编码代理：流式对话、带分叉点的会话历史、git worktree 审查闭环、自动验证的构建命令，以及权限有界的多代理工作流。

$由 Electron 主进程以 --mode rpc 子进程方式驱动 pi 编码代理，每个会话一个 RpcClient；凭据留在 ~/.pi/agent/auth.json，不会进入渲染进程。
$流式对话带思考过程折叠、GFM Markdown 与代码高亮，支持剪贴板贴图与 @ 引用；斜杠命令兼容 pi 内置命令与 Pion 自有的 /plan、/verify、/agents、/yolo。
$会话历史从 ~/.pi/agent/sessions/ 懒加载，支持收藏与悬停预览；对话可从任意用户消息分叉，git 分支以 worktree 树呈现。
$审查闭环：hunk/行级暂存、带 hooks 的提交、merge/rebase/cherry-pick 冲突解决、快照守卫的操作，以及自动发现的 typecheck/lint/test/build 命令——失败诊断可回填给 agent 修复。
$有界多代理流程：/agents 依次运行 Planner → Implementer → Reviewer → Tester，Planner 与 Reviewer 只读，Implementer 被限制在候选 worktree 内，仅在评审与验证通过后允许 ff-only 合并。
$内嵌官方 pi.dev 插件商店管理扩展与技能，项目级工具策略支持允许/询问/拒绝（未信任项目先以 --no-approve 运行），并逐轮记录 token、费用、时长与压缩指标。

Q Pion 是 pi 的官方客户端吗？

不是——它是社区维护的 Electron 应用，以 --mode rpc 子进程方式启动 pi；模型凭据与默认 provider、模型仍来自 pi 自己的 auth.json 与 settings.json。

Q 系统要求是什么？

Node 22.12 及以上（项目在 Node 24 上开发）加本地安装的 pi；若 shell 设置了 NODE_ENV=production，首次安装需用 NODE_ENV=development npm install --include=dev。