Pi Coding Agent on OHTLY Blog

给 Pi Coding Agent 项目配置 HTTP 代理

Tue, 14 Jul 2026 14:32:55 +0800

背景链接到标题

Pi Coding Agent 统一通过 HTTP_PROXY 环境变量控制所有 fetch 请求（LLM API 调用 + 工具层请求）是否走代理。代理服务器自身配置例外规则（如国内地址直连），deepseek 等国内服务实际不绕路。

配置方式：在 config.json 中写入代理地址，项目持久化，重启后自动生效。

SDK 网络层链接到标题

Pi Coding Agent 用 undici.setGlobalDispatcher() 替换全局 fetch，底层由 undici.EnvHttpProxyAgent 控制。该 dispatcher 同时服务于 LLM API 请求和工具 execute 中的 fetch，HTTP_PROXY / HTTPS_PROXY 环境变量同时影响两端。

AgentSession
    ├── LLM API 请求（OpenAI / Anthropic / DeepSeek）
    └── 工具 execute fetch（search / fetch / curl 等）
              │
              ▼
        undici 全局 dispatcher
              │
              ▼
        EnvHttpProxyAgent（读取 HTTP_PROXY）
              │
              ▼
            代理服务器
          （自己做例外规则）

配置方式链接到标题

config.json 新增 `httpProxy` 链接到标题

{
  "provider": "deepseek",
  "model": "deepseek-v4-flash",
  "apiKey": "sk-xxx",
  "cwd": "~/project",
  "httpProxy": "http://127.0.0.1:7890",
  "windmillUrl": "http://ape:3900",
  "windmillToken": ""
}

留空则不设代理。

为 Pi Coding Agent 编写扩展命令

Tue, 14 Jul 2026 14:32:55 +0800

背景链接到标题

Pi Coding Agent 内置斜杠命令机制，用户输入 /cmd 时优先匹配已注册的命令，不发给 LLM。命令由扩展通过 pi.registerCommand() 注册，handler 接收 ctx 参数，可调用 ctx.newSession()、ctx.reload()、ctx.ui 等方法。

SDK 示例自带 /commands 命令（列出所有可用命令），但直接在项目中引用时没有输出——因为默认环境未注入 UI Context。

注册命令链接到标题

Extension 文件中通过 pi.registerCommand() 注册：

import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";

export default function (pi: ExtensionAPI) {
  pi.registerCommand("mycmd", {
    description: "命令简短描述",
    handler: async (args, ctx) => {
      // args: 命令后面的参数字符串
      // ctx: ExtensionCommandContext
    },
  });
}

registerCommand 的 options 字段：

字段	类型	说明
`description`	`string`	命令描述，/commands 列表展示
`getArgumentCompletions`	`function`	可选，参数自动补全
`handler`	`function`	命令执行函数

handler 的 ctx（ExtensionCommandContext）常用方法：

为 Pi Coding Agent 编写自定义工具

Tue, 14 Jul 2026 10:30:00 +0800

背景链接到标题

Pi Coding Agent 的扩展机制允许向 AgentSession 注册自定义 Tool，LLM 在对话中可以直接调用这些工具。扩展是 ESM 模块，通过 pi.registerTool() 注册，自动加载到当前 Session。

注册 Tool 链接到标题

Extension 文件导出一个默认函数，接收 pi: ExtensionAPI 作为参数：

import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
import { Type } from "typebox";

export default function (pi: ExtensionAPI) {
  pi.registerTool({ /* ... */ });
}

pi.registerTool() 接收一个对象，关键字段如下：

字段	类型	说明
`name`	`string`	工具唯一标识，LLM 据此调用
`label`	`string`	显示名称，UI 中展示
`description`	`string`	工具描述，LLM 据此判断何时调用
`promptSnippet`	`string`	简短提示，注入系统提示词
`promptGuidelines`	`string[]`	调用 guideline，LLM 参考
`parameters`	`TypeBox Schema`	参数 Schema，LLM 据此生成参数
`execute`	`function`	工具执行函数

TypeBox Schema 链接到标题

parameters 用 TypeBox 定义：

Electron 集成 PI SDK 桌面聊天实践

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

项目背景链接到标题

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

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

源码：MarshalW/electron-pi

架构链接到标题

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 }：

Pi Web 配置 DeepSeek 与自定义工具

Mon, 13 Jul 2026 09:44:05 +0800

背景链接到标题

Pi Coding Agent 是一个开源的 AI 编程助手，69K+ Stars，MIT 协议。它的架构分三层：

@earendil-works/pi-ai — 统一多 Provider LLM API
@earendil-works/pi-agent-core — Agent 运行时（Tool calling、状态管理）
@earendil-works/pi-coding-agent — CLI + SDK

Pi Web 是社区开发的 Web UI，1.1K Stars。它通过 Pi SDK 直接创建 AgentSession，通过 SSE 推送流式事件到浏览器，不跑 CLI 子进程。

同类项目还有 jmfederico/pi-web（支持远程 Machine/Fleet）和 pi-gui（Electron 桌面版）。

部署链接到标题

环境要求：Node.js 22+。

git clone https://github.com/agegr/pi-web.git
cd pi-web
npm install
npm run dev

默认运行在 http://localhost:30141。

配置 DeepSeek 模型链接到标题

Pi Coding Agent 内置了 DeepSeek Provider，模型定义在 deepseek.models.ts，包含 deepseek-v4-flash 和 deepseek-v4-pro。

Pi Coding Agent on OHTLY Blog

给 Pi Coding Agent 项目配置 HTTP 代理

背景 链接到标题

SDK 网络层 链接到标题

配置方式 链接到标题

config.json 新增 httpProxy 链接到标题

为 Pi Coding Agent 编写扩展命令

背景 链接到标题

注册命令 链接到标题

为 Pi Coding Agent 编写自定义工具

背景 链接到标题

注册 Tool 链接到标题

TypeBox Schema 链接到标题

Electron 集成 PI SDK 桌面聊天实践

项目背景 链接到标题

架构 链接到标题

PI SDK 集成 链接到标题

模型解析 链接到标题

Pi Web 配置 DeepSeek 与自定义工具

背景 链接到标题

部署 链接到标题

配置 DeepSeek 模型 链接到标题

背景链接到标题

SDK 网络层链接到标题

配置方式链接到标题

config.json 新增 `httpProxy` 链接到标题

背景链接到标题

注册命令链接到标题

背景链接到标题

项目背景链接到标题

架构链接到标题

PI SDK 集成链接到标题

模型解析链接到标题

背景链接到标题

部署链接到标题

配置 DeepSeek 模型链接到标题