↓ 跳过正文

Pi AI Agent配置

·856 字
目录

Pi - 超级简洁轻量自定义的AI Agent
#

目前最好用的 AI Agent CLI ! 教程来源：

安装
#

npm 安装
#

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

手动配置
#

目前修改的两个文件：

  • ~/.pi/agent/models.json
  • ~/.pi/agent/settings.json

models.json
#

这里记录模型供应商的信息、apikey、模型输入输出配置

{
  "providers": {
    "my-provider-1": {
      "baseUrl": "https://api.url/v1",
      "api": "openai-completions",
      "apiKey": "sk_****************",
      "headers": {
        "User-Agent": "claude-cli/2.1.217"
      },
      "compat": {
        "sendSessionAffinityHeaders": true
      },
      "models": [
        {
          "id": "deepseek-v4-flash-0731",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 384000
        },
        {
          "id": "deepseek-v4-pro-0813",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 384000
        },
        {
          "id": "kimi-k2.5",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 256000,
          "maxTokens": 64000
        }
      ]
    }
  }
}

settings.json
#

  • retry 关键字用来修改 Pi 的模型重试延迟时间，这里修改为5次，每次间隔15s
  • 后面扩展包标识也会添加在这里，而且顺序就是包的加载顺序
{
  "lastChangelogVersion": "0.84.3",
  "theme": "dark",
  "retry": {
    "enabled": true,
    "maxRetries": 5,
    "baseDelayMs": 15000
  }
}

插件安装&推荐
#

扩展包请按需安装，过多的扩展可能导致启动缓慢。

pi-cometix-footer#

这里尝试使用一个更好看的这个：

pi install npm:pi-cometix-footer

pi-slopchop
#

添加 /slopchop 和 /diff 命令，方便代码审查。

pi install npm:pi-slopchop

pi-goal
#

添加 /goal 命令。

pi install npm:@narumitw/pi-goal

pi-plan-mode
#

添加 /plan 命令。

pi install npm:@narumitw/pi-plan-mode

pi-subagents
#

添加 subagent 工具，支持主 Agent 自主决定。

pi install npm:@narumitw/pi-subagents

pi-rtk-optimizer
#

自动调用 rtk 来压缩工具调用的输出，降低 Token 消耗。

pi install npm:pi-rtk-optimizer

可能告警，提示禁止第三方包后台运行脚本，可用该命令允许。这里忽略也可以不用管他，他执行的脚本似乎仅用于判断自己是不是 以插件形式启动

npm approve-scripts pi-rtk-optimizer

Tip

该插件似乎有点问题，提示 Warning: pi-rtk-optimizer: rtk binary unavailable, command rewrite bypassed ((exit 1)). 该问题已经被提交为bug，目前暂时作卸载处理，不再使用🤔(26-08-26)

pi-workspace-history
#

添加 /undo 来撤销

pi install npm:pi-workspace-history

这里可能需要配置一下history的存储路径，可以写入 settings.json 中，详见官方文档中的Configuration：

pi-raw-paste
#

添加 /paste 来粘贴大段文字

pi install npm:@tmustier/pi-raw-paste

pi-observational-memory
#

pi 的自动压缩上下文实际是有问题的，它只会在agent执行结束时触发压缩，如果是超长的任务，执行中上下文就满了，就卡死了，不会压缩。pi-observational-memory 这个包可以触发自动压缩。不过我也刚开始用，不确定稳定性。- Linux.Do

pi install npm:pi-observational-memory

@narumitw/pi-btw
#

pi install npm:@narumitw/pi-btw

增加一个 /btw 指令

skills 安装
#

以 playright/cli 为例子：

  • 安装
pnpm install -g @playwright/cli@latest
  • 添加到 usr/.agent/skill 文件夹
  • 在 pi 中 /reload

一些必要操作
#

TUI Mode
#

位于 /settings ，选择 TUI Mode ，选择 Fullscreen

退出
#

双击 ctrl+C

完成
#

Enjoy it ! ☕

Haley
作者
Haley