https://blog.ohtly.com/tags/pi-coding-agent/ Recent content in Pi-Coding-Agent on OHTLY Blog Hugo zh-cn Mon, 13 Jul 2026 19:42:06 +0800 https://blog.ohtly.com/posts/2026-07-13-electron-pi-coding-agent/ Mon, 13 Jul 2026 19:41:23 +0800 https://blog.ohtly.com/posts/2026-07-13-electron-pi-coding-agent/ <h2 id="项目背景"> 项目背景 <a class="heading-link" href="#%e9%a1%b9%e7%9b%ae%e8%83%8c%e6%99%af"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>用 Electron 封装 PI Coding Agent SDK，做一个轻量桌面 AI 聊天客户端。目标是：</p> <ul> <li>提供 GUI 界面替代终端交互</li> <li>跨平台（macOS + Windows）</li> <li>集成 PI SDK 的 tool calling、流式回复能力</li> </ul> <p>源码：<a href="https://github.com/MarshalW/electron-pi" class="external-link" target="_blank" rel="noopener">MarshalW/electron-pi</a></p> <h2 id="架构"> 架构 <a class="heading-link" href="#%e6%9e%b6%e6%9e%84"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <pre tabindex="0"><code>Renderer (index.html) ↕ contextBridge (preload.js) Main Process (main.js) ↕ @earendil-works/pi-coding-agent AgentSession (Tool calling, LLM 通信) </code></pre><p>三进程架构：</p> <ul> <li><strong>Renderer</strong>：纯前端 HTML/CSS/JS，显示聊天界面</li> <li><strong>Preload</strong>：contextBridge 暴露 <code>window.pi.*</code> API</li> <li><strong>Main</strong>：Electron 主进程，管理窗口、PI SDK、IPC 通道</li> </ul> <p>IPC 通道设计：</p> <table> <thead> <tr> <th>Channel</th> <th>方向</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td><code>config:get</code></td> <td>Renderer → Main</td> <td>读取配置</td> </tr> <tr> <td><code>config:save</code></td> <td>Renderer → Main</td> <td>保存配置</td> </tr> <tr> <td><code>session:create</code></td> <td>Renderer → Main</td> <td>创建 AgentSession</td> </tr> <tr> <td><code>session:send</code></td> <td>Renderer → Main</td> <td>发送 prompt</td> </tr> <tr> <td><code>session:abort</code></td> <td>Renderer → Main</td> <td>中止回复</td> </tr> <tr> <td><code>pi:event</code></td> <td>Main → Renderer</td> <td>推送流式事件</td> </tr> </tbody> </table> <h2 id="pi-sdk-集成"> PI SDK 集成 <a class="heading-link" href="#pi-sdk-%e9%9b%86%e6%88%90"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <h3 id="模型解析"> 模型解析 <a class="heading-link" href="#%e6%a8%a1%e5%9e%8b%e8%a7%a3%e6%9e%90"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h3> <p><code>createAgentSession</code> 需要完整的模型对象（含 <code>baseUrl</code>、<code>api</code> 等字段），不能只传 <code>{ provider, model }</code>：</p>