给 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 on OHTLY Blog

给 Pi Coding Agent 项目配置 HTTP 代理

背景 链接到标题

SDK 网络层 链接到标题

配置方式 链接到标题

config.json 新增 httpProxy 链接到标题

为 Pi Coding Agent 编写扩展命令

背景 链接到标题

注册命令 链接到标题

背景链接到标题

SDK 网络层链接到标题

配置方式链接到标题

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

背景链接到标题

注册命令链接到标题