https://blog.ohtly.com/tags/pi-web/ Recent content in Pi-Web on OHTLY Blog Hugo zh-cn Mon, 13 Jul 2026 09:44:56 +0800 https://blog.ohtly.com/posts/2026-07-13-pi-web-deepseek-custom-tools/ Mon, 13 Jul 2026 09:44:05 +0800 https://blog.ohtly.com/posts/2026-07-13-pi-web-deepseek-custom-tools/ <h2 id="背景"> 背景 <a class="heading-link" href="#%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><a href="https://github.com/earendil-works/pi" class="external-link" target="_blank" rel="noopener">Pi Coding Agent</a> 是一个开源的 AI 编程助手，69K+ Stars，MIT 协议。它的架构分三层：</p> <ul> <li><strong><a href="https://www.npmjs.com/package/@earendil-works/pi-ai" class="external-link" target="_blank" rel="noopener">@earendil-works/pi-ai</a></strong> — 统一多 Provider LLM API</li> <li><strong><a href="https://www.npmjs.com/package/@earendil-works/pi-agent-core" class="external-link" target="_blank" rel="noopener">@earendil-works/pi-agent-core</a></strong> — Agent 运行时（Tool calling、状态管理）</li> <li><strong><a href="https://www.npmjs.com/package/@earendil-works/pi-coding-agent" class="external-link" target="_blank" rel="noopener">@earendil-works/pi-coding-agent</a></strong> — CLI + SDK</li> </ul> <p><a href="https://github.com/agegr/pi-web" class="external-link" target="_blank" rel="noopener">Pi Web</a> 是社区开发的 Web UI，1.1K Stars。它通过 Pi SDK 直接创建 AgentSession，通过 SSE 推送流式事件到浏览器，不跑 CLI 子进程。</p> <p>同类项目还有 <a href="https://github.com/jmfederico/pi-web" class="external-link" target="_blank" rel="noopener">jmfederico/pi-web</a>（支持远程 Machine/Fleet）和 <a href="https://github.com/minghinmatthewlam/pi-gui" class="external-link" target="_blank" rel="noopener">pi-gui</a>（Electron 桌面版）。</p> <h2 id="部署"> 部署 <a class="heading-link" href="#%e9%83%a8%e7%bd%b2"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>环境要求：Node.js 22+。</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>git clone https://github.com/agegr/pi-web.git </span></span><span style="display:flex;"><span>cd pi-web </span></span><span style="display:flex;"><span>npm install </span></span><span style="display:flex;"><span>npm run dev </span></span></code></pre></div><p>默认运行在 <code>http://localhost:30141</code>。</p> <h2 id="配置-deepseek-模型"> 配置 DeepSeek 模型 <a class="heading-link" href="#%e9%85%8d%e7%bd%ae-deepseek-%e6%a8%a1%e5%9e%8b"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>Pi 内置了 DeepSeek Provider，模型定义在 <a href="https://github.com/earendil-works/pi/blob/main/packages/ai/src/providers/deepseek.models.ts" class="external-link" target="_blank" rel="noopener">deepseek.models.ts</a>，包含 <code>deepseek-v4-flash</code> 和 <code>deepseek-v4-pro</code>。</p>