Deekseek harness GUI app for elegant pi coding agent with pi-opendesign
🧭 双引擎,同一版本号 / Dual engine, one version: Electron
v2.6.9(全平台:macOS / Windows / Linux)与 Tauriv2.6.9(macOS arm64,体积更小)同步发布,版本号统一为2.6.9。日常使用推荐 Electron 版;追求更小体积可选 Tauri 版。 Electronv2.6.9(all platforms) and Tauriv2.6.9(macOS arm64, smaller footprint) ship together under one version number. Electron is recommended for daily use; Tauri is the lighter alternative.
🆕 v2.6.9 新增 / What's new: 包管理 Packages:「扩展」面板新增 npm / git / 本地包的安装、更新与移除。 系统提示词补充 System-prompt additions:可视化编辑项目级
.pi/APPEND_SYSTEM.md与全局APPEND_SYSTEM.md,自定义内容自动追加到系统提示词(项目优先,新建 / 重载会话生效)。 Packages management (install / update / remove npm · git · local packages) and a visual editor for project & globalAPPEND_SYSTEM.mdsystem-prompt additions, both in the Extensions panel.
💡 macOS:下载
.dmg双击挂载,将Pi-Deepseek.app拖入/Applications。 Windows:Setup.exe为安装版(推荐),Portable.exe为绿色免安装版。 Linux:Ubuntu/Debian/Deepin/UOS 用sudo dpkg -i xxx.deb安装;其他发行版用chmod +x xxx.AppImage && ./xxx.AppImage运行。 首次启动自动弹出设置引导,填入 DeepSeek API Key 即可开始。
💡 macOS: Download
.dmg, double-click, dragPi-Deepseek.appto/Applications. Windows:Setup.exeis the installer (recommended),Portable.exeruns directly. Linux:sudo dpkg -i xxx.debfor Ubuntu/Debian;chmod +x xxx.AppImage && ./xxx.AppImagefor other distros. First launch auto-opens Settings for DeepSeek API key setup.
Pi-Deepseek 利用 Pi coding agent 充分发挥 DeepSeek V4 Pro 的性价比(体验接近 Claude Opus 4.7,成本仅为其 N 分之一),一个面向本地 AI 编程工作流的桌面客户端。现已支持 macOS / Windows / Linux 三平台,为 pi 会话提供深推理、无提示词的 Codex 级工程自动交互体验。
本项目在 pi-gui 的基础上持续开发,并通过 @earendil-works/pi-coding-agent 接入上游 pi 运行时。
- 桌面客户端中打开本地工作区,按工作区管理
pi会话 - 创建新会话,通过
pi运行时发送提示词 - 持久保存界面状态(工作区、会话、输入框草稿)
- Codex 风格的时间线与会话交互
- 内置 DeepSeek V4 Pro 1M / Flash 1M 模型,一键配置 API Key
- 中文简体 / 中文繁體 / 日文 UI,Settings → Appearance 即时切换
- 40+ 提供商品牌图标,余额显示,紧凑布局
- Open Design MCP 集成(扩展 → Open Design → 查看 daemon 状态)
- Cmd/Ctrl+Tab 快速切换会话
- 自动更新(Settings → Notifications → Auto Update)
- 双列布局:同项目多会话并排显示,
Cmd+D分列 /Cmd+W关列 /Cmd+[Cmd+]切换 / 拖拽调整比例 - 包管理(Packages) 🆕:在「扩展」面板为工作区安装 / 更新 / 移除 npm / git / 本地包
- 系统提示词补充 🆕:在「扩展」面板编辑项目级
.pi/APPEND_SYSTEM.md与全局APPEND_SYSTEM.md,将自定义内容追加到 agent 系统提示词(项目文件优先于全局,对新建 / 重新加载的会话生效) - Dual-engine 统一版本:Electron + Tauri 同步发版,版本号对齐
# 安装 Open Design MCP(在终端执行一次)
cd ~/Sites/Github/open-design
pnpm install && pnpm rebuild better-sqlite3
# 启动 daemon
od --port 7456 --no-open
# 注册为 Pi MCP server
od mcp install pi安装后在 Pi 对话中直接使用:
- "用 OD 做一个登录页"
- "生成一个 pitch deck"
- "把这个按钮改成蓝色"
Pi 会自动调用 OD 工具并在对话流中显示进度。
corepack enable
pnpm install
pnpm dev# macOS 双架构
pnpm --filter @pi-gui/desktop run package
# Windows x64
pnpm --filter @pi-gui/desktop run package:win
# Linux x64 (AppImage + deb)
pnpm --filter @pi-gui/desktop run package:linuxapps/desktop— Electron 桌面应用packages/session-driver— 会话驱动类型packages/catalogs— 工作区与会话目录packages/pi-sdk-driver— pi-coding-agent 适配层
- 原始项目:
minghinmatthewlam/pi-gui - 上游运行时:
earendil-works/pi - 编程智能体包:
@earendil-works/pi-coding-agent
MIT · Yiding by HKEZ · Copyright 2026

