Show HN: Plandex v2 – open source AI coding agent for large projects and tasks
Show HN: Plandex v2 - 用于大型项目和任务的开源 AI 编码 Agent
plandex-ai / **plandex ** Public
开源 AI 编码 agent。专为大型项目和实际任务设计。 plandex.ai
License
MIT license 11.6k stars 786 forks
30 秒安装 · 网站 · 文档 · 示例 · 本地自托管模式
一个专为大型任务和实际项目设计的 AI 编码 Agent。
💻 Plandex 是一个基于终端的 AI 开发工具，可以计划和执行大型编码任务，这些任务跨越多个步骤并涉及数十个文件。它可以直接处理高达 200 万个 token 的上下文（每个文件约 10 万个），并且可以使用 tree-sitter 项目映射索引具有 2000 万个或更多 token 的目录。
🔬 累积的 diff 审查沙箱 使 AI 生成的更改与您的项目文件分开，直到它们准备好为止。命令执行受到控制，因此您可以轻松回滚和调试。Plandex 帮助您充分利用 AI，而不会在项目中留下混乱。
🧠 结合来自 Anthropic、OpenAI、Google 和开源提供商的最佳模型，以使用强大的基于终端的工作流程构建整个功能和应用程序。
🚀 Plandex 能够实现完全自主 - 它可以加载相关文件，计划和实施更改，执行命令并自动调试 - 但它也非常灵活和可配置，在需要时为开发人员提供细粒度的控制和逐步审查流程。
💪 Plandex 旨在能够胜任大型项目和文件。如果您发现其他工具在您的项目超过一定规模或更改过于复杂时会遇到困难，请尝试一下 Plandex。
适用于大型项目的智能上下文管理
- 🐘 200 万 token 的有效上下文窗口，带有默认模型包。
Plandex仅加载每个步骤所需的资源。 - 🗄️ 在大型项目和文件中可靠。 轻松生成、审查、修订和应用跨越数十个文件的更改。
- 🗺️ 快速项目地图生成 以及使用
tree-sitter进行语法验证。支持 30 多种语言。 - 💰 上下文缓存 被广泛用于
OpenAI和Anthropic模型，从而降低了成本和延迟。
严格控制或完全自主 - 由您决定
- 🚦 **可配置的自主性：**根据任务从完全自动模式到细粒度控制。
- 🐞 自动调试 终端命令（例如构建、linter、测试、部署和脚本）。如果您安装了
Chrome，您还可以自动调试浏览器应用程序。
帮助您获得可用于生产的结果的工具
- 💬 项目感知聊天模式 帮助您在转移到实施之前充实想法。也非常适合提出问题和了解代码库。
- 🧠 轻松尝试 + 组合 来自多个提供商的模型。精选的模型包提供功能、成本和速度的不同权衡，以及开源和特定于提供商的包。
- 🛡️ 可靠的文件编辑 优先考虑正确性。虽然大多数编辑都是快速且便宜的，但
Plandex会根据需要验证语法和逻辑，并在出现问题时提供多个备用层。 - 🔀 全面的版本控制 适用于计划的每次更新，包括用于探索多个路径或比较不同模型的分支。
- 📂 Git 集成 具有提交消息生成和可选的自动提交。
对开发者友好，易于安装
- 🧑💻 REPL 模式 具有命令和文件加载的模糊自动完成功能。只需在任何项目中运行
plandex即可开始。 - 🛠️ 用于将脚本或管道数据导入上下文的 CLI 界面。
- 📦 一键式，零依赖的 CLI 安装。
Dockerized本地模式，便于自托管服务器。云托管选项可提供额外的可靠性和便利性。
工作流程 🔄
示例 🎥
安装 📥
curl -sL https://plandex.ai/install.sh | bash
注意： 通过 WSL 支持 Windows。 Plandex 仅在 WSL shell 中才能在 Windows 上正常工作。它在 Windows CMD 提示符或 PowerShell 中不起作用。
更多安装选项。
托管 ⚖️
选项 | 描述
---|---
Plandex Cloud (集成模型) | • 无需单独的帐户或 API 密钥。• 易于多设备使用。• 集中式计费、预算、使用情况跟踪和成本报告。• 最快的方式 开始。
Plandex Cloud (自带 API 密钥) | • 将 Plandex Cloud 与您自己的 OpenRouter.ai 和 OpenAI 密钥一起使用。• 开始
自托管/本地模式 | • 在本地使用 Docker 运行 Plandex 或在您自己的服务器上托管。• 使用您自己的 OpenRouter.ai 和 OpenAI 密钥。• 按照 本地模式快速入门 开始。
提供者密钥 🔑
如果您选择上述“自带 API 密钥”选项（无论是云托管还是自托管），您需要在继续之前设置 OPENROUTER_API_KEY 和 OPENAI_API_KEY 环境变量：
export OPENROUTER_API_KEY=...
export OPENAI_API_KEY=...
快速开始 🚀
首先，cd 进入要完成某些操作或聊天的项目目录。如果要在新项目上启动，请先使用 mkdir your-project-dir 创建一个新目录。
cd your-project-dir
对于一个新项目，您可能还想初始化一个 git 存储库。 Plandex 并不要求您的项目位于 git 存储库中，但如果您使用它，它确实与 git 很好地集成。
git init
现在在您的项目中启动 Plandex REPL：
plandex
或者简短地说：
pdx
☁️ 如果您使用的是 Plandex Cloud，系统会在此处提示您开始试用。
然后快速阅读 REPL 帮助文本，您就可以开始了。 REPL 默认以 chat mode 启动，这有利于在转移到实施之前充实想法。一旦任务明确，Plandex 将提示您切换到 tell mode 以制定详细计划并开始编写代码。
文档 🛠️
👉 完整文档。
讨论和 Discord 💬
请随时提供您的反馈、提出问题、报告错误或只是闲逛：
关注和订阅
- Follow @PlandexAI
- Follow @Danenania (Plandex's creator)
- Subscribe on YouTube
贡献者 👥
⭐️ 请为 Plandex 加注星标、fork、探索和贡献。有很多工作要做，并且有很多可以改进的地方。
这是关于设置开发环境的概述。
关于
开源 AI 编码 agent。专为大型项目和实际任务设计。 plandex.ai
Topics
git cli golang terminal ai command-line openai developer-tools terminal-based ai-agents terminal-ui polyglot-programming ai-tools gpt-4 llm ai-developer-tools