pi.dev 域名由 exe.dev 慷慨捐赠新贡献者提交的新问题和拉取请求PR默认会自动关闭。维护者会每天审核自动关闭的问题详情请参阅 CONTRIBUTING.md。Pi Agent Harness 单仓库这里是 pi agent harness 项目的主页其中包含我们可自我扩展的编码代理。earendil-works/pi-coding-agent交互式编码代理命令行界面CLIearendil-works/pi-agent-core具备工具调用和状态管理功能的代理运行时earendil-works/pi-ai统一的多供应商大语言模型LLMAPI支持 OpenAI、Anthropic、Google 等了解更多关于 pi 的信息访问项目网站 pi.dev上面有演示内容。阅读文档你也可以让代理自行解释。分享你的开源编码代理会话如果你在开源工作中使用 pi 或其他编码代理请分享你的会话。公开的开源会话数据有助于基于实际任务、工具使用、失败情况和修复方法来改进编码代理而不是依赖简单的基准测试。详细解释请参阅 X 上的这篇文章。若要发布会话请使用 badlogic/pi-share-hf阅读其 README.md 获取设置说明。你只需要一个 Hugging Face 账号、Hugging Face CLI 和 pi-share-hf。你还可以观看这个视频我在其中展示了如何发布我的 pi-mono 会话。我会定期在 Hugging Face 的 badlogicgames/pi-mono 上发布自己的 pi-mono 工作会话。所有包包名描述earendil-works/pi-ai统一的多供应商 LLM API支持 OpenAI、Anthropic、Google 等earendil-works/pi-agent-core具备工具调用和状态管理功能的代理运行时earendil-works/pi-coding-agent交互式编码代理 CLIearendil-works/pi-tui支持差异渲染的终端用户界面TUI库如需进行 Slack/聊天自动化和工作流操作请查看 earendil-works/pi-chat。贡献请参阅 CONTRIBUTING.md 获取贡献指南参阅 AGENTS.md 获取项目特定规则适用于人类和代理。开发npm install --ignore-scripts安装所有依赖项不运行生命周期脚本。npm run build构建所有包。npm run check进行代码检查、格式化和类型检查。./test.sh运行测试若无 API 密钥则跳过依赖 LLM 的测试。./pi-test.sh从源代码运行 pi可在任何目录运行。供应链加固我们将 npm 依赖项的更改视为经过审核的代码更改。直接外部依赖项会固定到精确版本内部工作区包则保持版本范围。.npmrc 设置 save-exacttrue 和 min-release-age2以避免在 npm 解析期间出现当日依赖项发布情况。package-lock.json 是依赖项的真实记录。预提交会阻止意外的锁定文件提交除非设置 PI_ALLOW_LOCKFILE_CHANGE1。npm run check 会验证固定的直接依赖项、原生 TypeScript 导入兼容性以及生成的编码代理收缩包装文件。发布的 CLI 包包含从根锁定文件生成的 packages/coding-agent/npm-shrinkwrap.json用于为 npm 用户固定传递依赖项。发布冒烟测试使用 npm run release:local 在发布前进行构建、打包并在仓库外创建隔离的 npm 和 Bun 安装。本地发布安装、文档化的 npm 安装以及 pi update --self 在支持的情况下使用 --ignore-scripts。持续集成CI使用 npm ci --ignore-scripts 进行安装并且有一个预定的 GitHub 工作流会运行 npm audit --omitdev 以及 npm audit signatures --omitdev。收缩包装文件生成有一个明确的依赖项生命周期脚本白名单新的生命周期脚本依赖项在审核前会导致检查失败。许可证本项目采用 MIT 许可证。
