专为大型任务和真实世界项目设计的 AI 编程助手。

💻  Plandex 是一个基于终端的 AI 开发工具，能够规划和执行涉及多个步骤、触及数十个文件的大型编码任务。它可以直接处理高达 200 万 token 的上下文（约每个文件 10 万 token），并且可以使用 tree-sitter 项目映射来索引包含 2000 万或更多 token 的目录。

🔬  累积差异审查沙箱将 AI 生成的更改与您的项目文件隔离开来，直到它们准备就绪。命令执行受到控制，因此您可以轻松回滚和调试。Plandex 帮助您充分利用 AI，而不会在项目中留下混乱。

🧠  结合 Anthropic、OpenAI、Google 和开源提供商的最佳模型，通过强大的基于终端的工作流来构建完整的功能和应用程序。

🚀  Plandex 能够实现完全自主——它可以加载相关文件、规划和实施更改、执行命令并自动调试——但它也高度灵活和可配置，在需要时为开发人员提供细粒度控制和逐步审查流程。

💪  Plandex 旨在能够应对大型项目和文件。如果您发现其他工具一旦项目超过一定规模或更改过于复杂就会力不从心，不妨试试 Plandex。

适用于大型项目的智能上下文管理

• 🐘 200 万 token 的有效上下文窗口（使用默认模型包）。Plandex 仅为每个步骤加载所需内容。
• 🗄️ 在大型项目和文件中表现可靠。 轻松生成、审查、修改和应用跨越数十个文件的更改。
• 🗺️ 快速生成项目映射并使用 tree-sitter 进行语法验证。支持 30 多种语言。
• 💰 全面使用上下文缓存（适用于 OpenAI、Anthropic 和 Google 模型），以降低成本和延迟。

精细控制或完全自主——由您决定

• 🚦 可配置的自主性： 根据任务需求，从全自动模式切换到精细控制。
• 🐞 自动化调试终端命令（如构建、linter、测试、部署和脚本）。如果您安装了 Chrome，还可以自动调试浏览器应用程序。

助您获得生产就绪结果的工具

• 💬 具备项目感知的聊天模式，帮助您在进入实施阶段前完善想法。也适用于提问和了解代码库。
• 🧠 轻松尝试并组合来自多个提供商的模型。精选的模型包提供了能力、成本、速度以及开源和特定提供商包之间的不同权衡。
• 🛡️ 可靠的文件编辑，优先考虑正确性。虽然大多数编辑快速且廉价，但 Plandex 会根据需要验证语法和逻辑，并在出现问题时提供多层回退机制。
• 🔀 完整的版本控制，涵盖计划的每次更新，包括用于探索多种路径或比较不同模型的分支。
• 📂 Git 集成，支持生成提交消息和可选的自动提交。

开发者友好，易于安装

• 🧑‍💻 REPL 模式，支持命令和文件加载的模糊自动补全。只需在任何项目中运行 plandex 即可开始。
• 🛠️ CLI 接口，用于脚本编写或将数据通过管道输入上下文。
• 📦 一行命令、零依赖的 CLI 安装。 提供 Docker 化的本地模式，便于自托管服务器。云托管选项提供额外的可靠性和便利性。

工作流程  🔄

示例  🎥

安装  📥

curl -sL https://plandex.ai/install.sh | bash

注意： Windows 通过 WSL 支持。Plandex 仅在 WSL shell 中才能在 Windows 上正常工作。在 Windows CMD 提示符或 PowerShell 中无法工作。

更多安装选项。

托管方式  ⚖️

提供商密钥  🔑

export OPENROUTER_API_KEY=... # 如果使用 OpenRouter.ai

Claude Pro/Max 订阅  🖇️

如果您拥有 Claude Pro 或 Max 订阅，Plandex 在调用 Anthropic 模型时可以使用它。您第一次运行 Plandex 时，系统会询问您是否要连接订阅。

快速开始  🚀

首先，cd 进入一个项目目录，您想在那里完成某项工作或讨论该项目。如果是新项目，可以先使用 mkdir your-project-dir 创建一个新目录。

cd your-project-dir

对于新项目，您可能还需要初始化一个 git 仓库。Plandex 不要求您的项目必须在 git 仓库中，但如果您使用 git，它能很好地集成。

git init

现在在您的项目中启动 Plandex REPL：

plandex

或者简写：

pdx

文档  🛠️

👉  完整文档。

讨论与 Discord  💬

欢迎随时提供反馈、提问、报告错误或只是来聊聊天：

• Discord
• 讨论区
• 问题反馈

关注与订阅

• 关注 @PlandexAI
• 关注 @Danenania (Plandex 的创建者)
• 在 YouTube 上订阅

贡献者  👥

⭐️  请为 Plandex 点赞、分叉、探索和贡献。还有很多工作要做，也有许多可以改进的地方。

这是设置开发环境的概述。