#Development（开发）

本页面是 Pi 官方文档 的中文翻译。仅供学习参考。

#设置

git clone https://github.com/earendil-works/pi-mono
cd pi-mono
npm install
npm run build

从源码运行使用 /path/to/pi-mono/pi-test.sh。该脚本可从任何目录运行，Pi 保留调用者的当前工作目录。

#Forking / Rebranding

通过 package.json 配置：

{
  "piConfig": {
    "name": "pi",
    "configDir": ".pi"
  }
}

更改 name、configDir 和 bin 字段会影响 CLI 横幅、配置路径和环境变量名。

#路径解析

有三种执行模式：npm install、独立二进制和 tsx（从源码）。开发者应始终使用 src/config.ts 访问包资源：

import { getPackageDir, getThemeDir } from "./config.js";

#Debug 命令

/debug（隐藏命令）将调试日志写入 ~/.pi/agent/pi-debug.log，捕获：

• 带 ANSI 码的已渲染 TUI 行
• 发送给 LLM 的最后消息

#测试

./test.sh                    # 运行非 LLM 测试（不需要 API Key）
npm test                     # 运行所有测试
npm test -- test/specific.test.ts  # 运行特定测试文件

#项目结构

packages/
  ai/           # LLM Provider 抽象
  agent/        # Agent 循环和消息类型
  tui/          # 终端 UI 组件
  coding-agent/ # CLI 和交互模式

法律声明：本页面是 pi.dev 官方文档的中文翻译版本，仅供学习参考。本网站与 pi.dev 及 Earendil Inc. 无任何法律关系。