问豆包就行。Pi-Agent 极简教程（macOS，PHP项目开发｜搭配API中转站）

Pi 是终端AI编程Agent，自带 read/write/edit/bash 工具，可直接读写项目文件、执行命令，无需手动编写工具调用逻辑
前置环境：macOS，Node.js v20+

1. 安装 Pi CLI（终端版）

二选一执行

macOS推荐一键脚本

curl -fsSL https://pi.dev/install.sh | sh

npm安装方式

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

验证安装
pi --version

2. 配置模型（接入中转站，兼容OpenAI协议）

进入你的PHP项目目录
cd /你的php项目目录
pi

进入pi交互界面，输入命令添加服务商：
/connect

选择 OpenAI API key，依次填写：

• API Key：你的中转站密钥
• Base URL：中转站地址，示例 https://xxx.xxx/v1
• Model：模型名称（deepseek/gpt系列等，支持OpenAI协议即可）

可选：环境变量永久配置（mac zsh）

写入配置文件 ~/.zshrc

export OPENAI_API_KEY="sk-xxx"
export OPENAI_BASE_URL="https://xxx/v1"

保存后执行生效：source ~/.zshrc

3. 上手第一个任务（PHP项目测试）

pi交互窗口直接输入指令示例：
读取项目所有php文件，检查语法错误，给出代码优化建议

Pi会自动读取、分析代码，修改文件前会弹窗确认，不会直接覆盖源码。

Pi交互内常用命令
/model # 切换模型
/connect # 添加/修改API服务商
/clear # 清空当前会话
/quit # 退出pi

快捷键：

• Ctrl+P：快速切换模型
• Ctrl+L：打开模型选择面板

4. pi-web-ui 轻量网页版（低内存方案）

pi-web-ui：轻量网页界面，资源占用更低；pi-web：完整版，消耗资源更高

安装pi-web-ui

npm install -g @earendil-works/pi-web-ui

启动服务

pi-web-ui

浏览器访问：http://127.0.0.1:8787，网页端操作，复用CLI的模型配置。

5. 整套工作流：CC-Switch中转站 + Pi + DSH
6. CC-Switch：API中转站，统一转发模型请求
7. Pi-Agent：本地编码Agent，负责PHP项目读写、开发改代码
8. DSH：负责harness、自动化评估测试

分工：Pi写代码；DSH做测试评估，两者可协同调度。

6. 重要注意事项
7. Pi可执行bash命令，不要在生产目录随意运行，优先本地开发目录；文件修改前会询问确认。
8. 模型通过中转站转发，兼容 /v1/chat/completions 和 /v1/responses 接口。
9. 卸载命令

npm uninstall -g @earendil-works/pi-coding-agent

7. 常见问题排查

• 模型调用失败：用curl先测试中转站连通；/connect核对baseurl、密钥
• 读取文件失败：确认终端当前目录是项目根目录
• 内存占用高：改用pi-web-ui，不要同时开启多个pi会话