pi hehe

pi hehe 是 pi coding agent 的桌面客户端，基于 pi-web 构建。双击图标即可使用，无需命令行操作。

下载安装 · 功能特性 · 从源码构建 · 致谢

---

下载安装

从 GitHub Releases 下载

1. 前往 Releases 页面
2. 下载最新的 pi-hehe-*-win-x64.exe 安装包
3. 运行安装程序，按提示完成安装
4. 从桌面快捷方式或开始菜单启动 "pi hehe"

便携版

如果不想安装，可以下载 pi-hehe-*-portable.exe 便携版，双击即可运行。

前置要求

• Windows 10/11 (64-bit)
• 已安装 pi coding agent (npm install -g @earendil-works/pi-coding-agent)
• 已配置 API 密钥（参考 pi 的文档）

---

功能特性

• 🖥️ 桌面应用 — 双击图标即可使用，无需打开浏览器
• 💬 实时对话 — SSE 流式输出，实时查看 agent 响应
• 📁 会话管理 — 按项目目录分组，支持会话搜索
• 🔄 会话分叉 — 从任意消息创建新会话分支
• 🌿 分支导航 — 可视化切换同一会话内的不同分支
• 🛠️ 工具面板 — 控制 agent 可使用的工具
• 🎨 主题切换 — 深色/浅色主题，支持 View Transition 动画
• 📊 Token 统计 — 实时显示 token 使用量和上下文占用

---

快捷键

快捷键	功能
F12	打开/关闭开发者工具
Ctrl+Shift+I	打开/关闭开发者工具
Ctrl+Enter	发送消息
Escape	中断当前操作

---

从源码构建

环境准备

• Node.js 20+
• npm
• 已全局安装 pi-web: npm install -g @agegr/pi-web

构建步骤

# 克隆仓库
git clone https://github.com/Tang-hz/pi-hehe.git
cd pi-hehe

# 启动应用
npx electron .

---

项目结构

pi-hehe/
├── main.js              # Electron 主进程（启动 pi-web 服务器 + 创建窗口）
├── preload.js           # 预加载脚本
├── icon.png             # 应用图标 (PNG)
├── icon.ico             # 应用图标 (Windows ICO)
├── start.bat            # 启动脚本（双击即可运行）
├── package.json         # 项目配置
└── README.md            # 本文件

---

技术栈

组件	技术
桌面框架	Electron
Web UI	pi-web (Next.js 16 + React 19)
Agent 引擎	pi coding agent

---

工作原理

双击图标
    ↓
Electron 启动
    ↓
查找已安装的 pi-web (全局 npm 模块)
    ↓
在随机端口启动 Next.js 服务器
    ↓
创建 Electron 窗口 → 加载 http://127.0.0.1:{port}
    ↓
用户通过浏览器界面与 pi agent 交互
    ↓
关闭窗口 → 自动停止服务器

---

致谢

本项目基于以下优秀的开源项目构建：

项目	作者	说明
pi-web	Alex Yang (@agegr) 等	Web UI 界面，提供完整的会话管理和交互体验
pi coding agent	Mario Zechner (@badlogic)	核心 Agent 引擎，提供代码理解和生成能力

pi-web 贡献者

感谢 pi-web 的所有贡献者：

贡献者	贡献
Alex Yang (@agegr)	pi-web 作者，125 次提交
@slibean	2 次提交
@lc-git	1 次提交

---

许可证

MIT License