Percho 几何构造字标与立体金字塔

Percho

高度自定义的 Pi coding agent 桌面端 GUI —— 与 Pi CLI 同源同引擎，干净清爽的视觉界面。多会话聊天、可视化工具审批、内置子代理、UI 插件、自定义主题。

--- ## 演示 ![Percho 新会话页](docs/assets/img/chat_001.png) ![Percho 项目与会话侧栏](docs/assets/img/chat_002.png) ![Percho 逐轮改动侧栏](docs/assets/img/chat_003.png) ![设置 —— UI 插件管理，内置鲸鱼娘桌宠](docs/assets/img/percho_ui_plugins.png) **聊天页** ![聊天页演示](docs/assets/img/demo-chat.gif) **自定义背景 + 深色主题** ![深色主题下带自定义背景的聊天页](docs/assets/img/chat_img_bg_show_img.png) ## 为什么选择 Percho？ Percho 把官方 Pi SDK（`@earendil-works/pi-coding-agent`）跑在 Electron 主进程里。**不是 fork，也不是重新实现** —— 它和 Pi CLI 用的是同一套引擎，完整继承 Pi 的原生优势： - **可扩展性** —— 支持 Pi 的 TypeScript 扩展、Skills 和 Prompt 模板。用户级资源由 Percho 独立管理，项目级资源继续兼容，加载前会有信任确认。让 Pi 适应你的工作流，无需 fork。 - **独立用户数据** —— 会话、账号和模型配置保存在 `~/.percho/agent/`，与 Pi CLI 分离；首次启动可选择复制旧目录中的数据并保留原目录，也可全新开始。项目级 `.pi/` 继续兼容，详见[迁移与恢复](docs/local-agent-storage.md)。 - **模型来源** —— 支持订阅（Claude Pro/Max、ChatGPT Plus/Pro Codex、GitHub Copilot，应用内 OAuth 登录）以及 Anthropic、OpenAI、Gemini、DeepSeek、Bedrock 等 API key；还支持自定义 provider 与 base URL 覆写（中转站场景）。同时，为更喜欢图形界面的用户提供： - 高度自定义界面 —— UI 插件可替换工具调用卡、添加桌宠浮层（内置鲸鱼娘 + Q 版两只）、扩展设置面板 - 可视化权限审批 —— 在底部审批坞里逐个批准/拒绝工具调用，背后是逐工具的规则引擎 - 可折叠的项目/会话侧栏、可拖拽排序的顶部置顶会话、逐会话输入草稿、可撤销的跟进消息队列 - 内置子代理 —— 自带 scout 与自定义 agent 定义、并行任务拆分，点开运行卡片即可只读检视子会话 - 上下文蒸发（默认开启）—— 到龄的工具输出自动蒸发为紧凑 stub，长会话不超预算 - 统一报错系统 —— 对话内错误卡一键重试、自动重试状态行、渲染进程全屏崩溃恢复 - 扎实的会话工作台 —— 从助手回复或选中的上下文分叉、撤回自己的消息回输入框、todo 面板、逐轮 diff 侧栏、斜杠命令面板、@ 文件补全 - 流式 Markdown 渲染、图片预览、消息复制 - Agent 主动发图 —— 内置 `show_image` 工具让 agent 在需要时把图片（单张或成组）直接显示到对话区，而不是把所有工具结果都变成噪音 - 自定义背景图与遮罩透明度，浅色/深色/跟随系统主题 - 跨设备互联 —— 手机/平板浏览器扫码查看会话；可选开启远程发送、停止生成，以及允许一次/拒绝权限请求 ## 下载预编译安装包发布在 [Releases](https://github.com/Jaxton07/percho/releases) 页面。 | 平台 | 下载 | | --- | --- | | macOS (Apple Silicon) | `percho-mac-arm64.dmg` | | macOS (Intel) | `percho-mac-x64.dmg` | | Windows | `percho-windows-x64.exe`（安装器）或 `percho-windows-x64.zip` | | Linux (x64) | `percho-linux-x86_64.AppImage` | > 构建为 adhoc 临时签名（无 Developer ID 证书）。macOS 下载后首次打开可能提示**「Apple 无法验证 Percho 是否包含危害 Mac 安全或泄漏隐私的恶意软件」**—— 这是 Gatekeeper 拦截未公证的 App。按以下方式放行： > > 1. **系统设置 → 隐私与安全性** → 滚动到底部 → 在 Percho 条目旁点**「仍要打开」**，然后输入密码或 Touch ID 确认（推荐）。 > > ![macOS「仍要打开」](docs/assets/img/percho_mac_permission.png) > > 2. 或在终端执行：`xattr -cr "/Applications/Percho.app"`。 > > 更新在应用内检查。Windows 上也在应用内下载安装（点下载，再点重启）；macOS 上 adhoc 签名的构建无法自动安装，点击会跳到 Releases 页 —— 新下载的版本首次打开还会再被 Gatekeeper 拦一次。Windows 上 SmartScreen 提示时点「更多信息」→「仍要运行」。 > > Linux：首次运行前给 AppImage 加执行位（`chmod +x percho-linux-x86_64.AppImage`）；Ubuntu 22.04+/24.04+ 及衍生发行版需先安装 `libfuse2`（AppImage 依赖 FUSE 2 挂载，新版系统默认未装）。Linux 版在应用内下载并安装更新。 ## 开发前置要求：**Node.js >= 22.19**。 ```bash npm install npm run dev ``` npm workspaces monorepo，三个包：`packages/shared`（IPC 契约）、`packages/backend`（唯一 import Pi SDK 的地方）、`packages/desktop`（Electron + React 19 + Tailwind 4 + Zustand）。常用命令：`npm run typecheck` / `test` / `lint` / `build` / `dist`。完整指南见 [CONTRIBUTING.md](CONTRIBUTING.md)。国内下载 Electron 二进制太慢的话，先设置 `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/`。 ## 声明 Percho 是社区项目，**并非** Pi 团队（earendil-works）官方出品，也与其无任何隶属关系。 ## License [MIT](LICENSE)