Electron 集成 PI SDK 桌面聊天实践

Mon, 13 Jul 2026 19:41:23 +0800

项目背景链接到标题

用 Electron 封装 PI Coding Agent SDK，做一个轻量桌面 AI 聊天客户端。目标是：

提供 GUI 界面替代终端交互
跨平台（macOS + Windows）
集成 PI SDK 的 tool calling、流式回复能力

架构链接到标题

Renderer (index.html)
    ↕ contextBridge (preload.js)
Main Process (main.js)
    ↕ @earendil-works/pi-coding-agent
AgentSession (Tool calling, LLM 通信)

三进程架构：

Renderer：纯前端 HTML/CSS/JS，显示聊天界面
Preload：contextBridge 暴露 window.pi.* API
Main：Electron 主进程，管理窗口、PI SDK、IPC 通道

IPC 通道设计：

Channel	方向	说明
`config:get`	Renderer → Main	读取配置
`config:save`	Renderer → Main	保存配置
`session:create`	Renderer → Main	创建 AgentSession
`session:send`	Renderer → Main	发送 prompt
`session:abort`	Renderer → Main	中止回复
`pi:event`	Main → Renderer	推送流式事件

PI SDK 集成链接到标题

模型解析链接到标题

createAgentSession 需要完整的模型对象（含 baseUrl、api 等字段），不能只传 { provider, model }：

Electron 项目 macOS 构建配置

Mon, 13 Jul 2026 10:46:12 +0800

背景链接到标题

Electron 是用 Web 技术构建跨平台桌面应用的主流方案。本文记录从零搭建 Electron 项目并通过 electron-builder 构建 macOS 安装包的过程。无需 Apple Developer 账号，构建出的 .dmg 可在本机安装运行。

项目结构链接到标题

electron-proto/
├── package.json
├── src/
│   ├── main.js          # 主进程
│   └── index.html       # 渲染页面
└── release/             # 构建产物

配置链接到标题

package.json 链接到标题

{
  "name": "electron-proto",
  "version": "1.0.0",
  "main": "src/main.js",
  "scripts": {
    "start": "electron .",
    "build:mac": "electron-builder --mac"
  },
  "devDependencies": {
    "electron": "^33.0.0",
    "electron-builder": "^25.1.0"
  },
  "build": {
    "appId": "com.electron.proto",
    "productName": "ElectronProto",
    "directories": {
      "output": "release"
    },
    "mac": {
      "category": "public.app-category.utilities",
      "target": ["dmg"],
      "identity": null
    }
  }
}

identity: null 是关键——告诉 electron-builder 跳过代码签名，否则没有开发者证书时会构建失败。

Electron on OHTLY Blog

Electron 集成 PI SDK 桌面聊天实践

项目背景 链接到标题

架构 链接到标题

PI SDK 集成 链接到标题

模型解析 链接到标题