Plandex: помощник по кодированию с открытым исходным кодом и поддержкой сверхдлинных контекстов

Общее введение

Plandex - это сквозной помощник по кодированию с искусственным интеллектом с открытым исходным кодом, предназначенный для больших и сложных программных проектов. Он может планировать и выполнять многоэтапные задачи и обрабатывать до двух миллионов жетон Plandex - это изолированная среда, позволяющая изолировать изменения кода, генерируемые искусственным интеллектом, которые разработчики могут просмотреть перед применением для обеспечения безопасности проекта. Он поддерживает OpenAI, Anthropic, Google и многие другие модели, позволяя пользователям гибко переключаться, чтобы оптимизировать производительность и стоимость. Plandex предлагает полностью автоматизированные режимы и тонкий контроль, подходящий как для начинающих, так и для профессиональных разработчиков. Он прост в установке, поддерживает интеграцию с Git и контроль версий и подходит как для индивидуальной, так и для командной разработки. Plandex предлагает варианты облачного хостинга и локального развертывания для удовлетворения различных потребностей.

Список функций

• Управление крупномасштабными проектами: Поддерживает 2 миллиона контекстов токенов и индексированные каталоги до 20 миллионов токенов, что подходит для очень больших кодовых баз.
• Поддержка нескольких моделей: Интеграция моделей от OpenAI, Anthropic, Google и т.д., позволяющая оптимизировать производительность и стоимость.
• Обзор песочницыИзменения кода, генерируемые искусственным интеллектом, хранятся в "песочнице", где разработчики могут просматривать их пофайлово, прежде чем применить, что позволяет избежать прямых изменений в проекте.
• автоматическая отладка: Автоматически обнаруживает и исправляет ошибки команд терминала, поддерживает сборку, тестирование и развертывание, а также совместим с отладкой браузерных приложений (требуется Chrome).
• Создание карты проекта: Быстрое создание карт проектов с поддержкой древовидных ситтеров на более чем 30 языках и проверка синтаксической точности.
• контроль версий: Поддержка управления ветвями, изучение нескольких путей реализации и интеграция с Git для автоматической генерации сообщений о фиксации.
• Гибкость и самостоятельностьПолностью автоматический режим или пошаговое управление позволяют учитывать сложность задач и предпочтения разработчиков.
• управление контекстом (вычислительная техника): Точная загрузка файлов или каталогов через терминал, автоматическое обновление контекста и обеспечение того, чтобы модель получала самый свежий код.
• Модель взаимодействия с REPL: Поддержка нечеткого автозаполнения командной строки для быстрой загрузки файлов и выполнения задач.
• Локальное развертывание: Поддерживает развертывание Docker на локальных серверах, защищает конфиденциальность данных и подходит для самостоятельного хостинга.
• Режим чата: Функция чата, ориентированная на проект, подходящая для обсуждения кода, изучения технологий или планирования задач.

Использование помощи

Процесс установки

Plandex предлагает простой метод установки и поддерживает Mac, Linux, FreeBSD и Windows (через WSL). Вот подробные шаги:

1. Установка CLI::
   • Запустите команду установки одним щелчком мыши без дополнительных зависимостей:

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

   • После установкиplandex возможно pdx команда доступна.
   • Проверка установки: Выполнить plandex --versionПроверьте номер версии.
2. Локальный сервер развертывания (необязательно)::
   • Необходимо установить Git, Docker и Docker Compose.
   • Клонируйте репозиторий и запустите сервер:

     git clone https://github.com/plandex-ai/plandex.git
     cd plandex/app
     ./start_local.sh
     

   • Запуск в новом терминале plandex sign-inЕсли вы используете опцию "Local mode host", выберите "Local mode host" (по умолчанию). http://localhost:8099).
   • Установите ключ API:

     export OPENROUTER_API_KEY=<your-openrouter-api-key>
     export OPENAI_API_KEY=<your-openai-api-key>
     

3. Пользователь Windows::
   • Поддерживается только среда WSL, команды необходимо выполнять в терминале WSL, Windows CMD или PowerShell не поддерживаются.
4. Варианты облачного хостинга::
   • Plandex Cloud (интегрированная модель)Не требует API-ключа, поддерживает несколько устройств, включает ежемесячный кредит в размере 20 долларов и отлично подходит для быстрого начала работы.
   • Plandex Cloud (поставляется с ключом API): Использование OpenAI и OpenRouter ключ для пользователей с существующими учетными записями.
   • Посетите сайт https://app.plandex.ai/start, чтобы зарегистрироваться и начать работу.

Использование

Plandex работает с помощью команд терминала, а основные функции включают планирование задач, генерацию кода, просмотр и отладку. Ниже приводится подробное описание процесса:

Проект инициализации

• Перейдите в каталог проектов:

  cd your-project-dir
  

• (Необязательно) Инициализируйте ваш Git-репозиторий:

  git init
  

• Запустите программу Plandex REPL:

  plandex
  

  или используйте короткую команду:

  pdx
  

Режим чата

• Перейдите в режим чата, подходящий для обсуждения проектов или изучения кодовой базы:

  \chat 探索现有代码库中的认证逻辑
  

• Plandex анализирует контекст и отвечает на вопросы, а разработчики могут пошагово разъяснять задачи.

Создайте план

• Переключитесь в режим рассказа, чтобы создать план:

  \tell 添加用户认证功能，包括登录和注册
  

• Plandex генерирует подробный план с перечислением этапов и необходимых документов, предлагая пользователю подтвердить или скорректировать его.

Контекст загрузки

• Добавляет файл или каталог в контекст:

  plandex load path/to/file
  plandex load path/to/directory
  

• Plandex автоматически обновляет контекст, чтобы убедиться, что модель использует самый последний код.

Обзор изменений

• Просмотр изменений кода, созданных искусственным интеллектом:

  plandex changes
  

• Просмотр различий в пользовательском интерфейсе терминала поддерживает проверку каждого документа. Принимает изменения:

  plandex apply
  

• Его можно вручную изменить и перезагрузить после отказа.

автоматическая отладка

• Выполнение команд терминала (например, build или test):

  plandex run npm test
  

• Если команда не выполняется, Plandex анализирует ошибку и генерирует рекомендации по ее устранению. Для отладки в браузере требуется Chrome:

  plandex run --browser
  

контроль версий

• Создавайте ответвления, чтобы попробовать разные варианты реализации:

  plandex branch feature-auth
  

• Возврат к предыдущему состоянию:

  plandex rewind
  

• Зафиксируйте изменения в Git:

  plandex commit
  

• Plandex автоматически генерирует информацию для отправки.

Переключение моделей

• Измените модель, чтобы оптимизировать производительность или стоимость:

  plandex --model gemini-exp
  

• или в режиме REPL:

  \set-model deepseek-v3
  

Функциональное управление

1. Поддержка крупномасштабных проектов::
   • Plandex использует tree-sitter для разбора структуры кода и создания карты проекта. Запустите plandex Автоматически индексирует проекты и поддерживает более 30 языков, таких как Python, JavaScript, Go и другие.
   • Пример: Plandex загружает файлы по требованию, чтобы сократить расход токенов при обработке базы кода в 2 миллиона токенов.
2. Обзор песочницы::
   • Изменения сохраняются в "песочнице", запустите plandex changes Просмотр несоответствий. Поддерживает построчную проверку, чтобы предотвратить попадание ошибочного кода в проект.
   • Пример: сгенерировав 50 изменений файлов, вы можете проверить каждый из них в пользовательском интерфейсе, чтобы убедиться в правильности логики и синтаксиса.
3. автоматическая отладка::
   • При выполнении тестовых команд Plandex фиксирует ошибки и генерирует предложения по их устранению. Например:

     plandex run pytest
     

   • Поддержка отладки в браузере Chrome для автоматического анализа ошибок на фронтенде.
4. Многомодельная оптимизация::
   • Переключитесь на недорогие модели (например, DeepSeek):

     \set-model deepseek-v3
     

   • Переключение моделей без потери контекста подходит для долгосрочных задач.
5. Режим чата::
   • Для изучения кодовой базы или изучения техник. Пример:

     \chat 解释项目中的 OAuth 实现
     

   • Plandex предоставляет подробные ответы с примерами кода.

предостережение

• Ключ API: Ключи OpenAI и OpenRouter должны быть настроены для облачного режима (с собственным ключом) или локального развертывания.
• управление затратами: Включите кэширование контекста (OpenAI и Anthropic поддерживаются по умолчанию), выбирайте недорогие модели и загружайте контекст точно, чтобы снизить затраты.
• Поддержка общества: Присоединяйтесь к Discord (https://discord.gg/plandex-ai) или GitHub Discussions (https://github.com/plandex-ai/plandex/discussions) для получения помощи.

сценарий применения

1. Обслуживание большой базы кода
   Поскольку разработчики поддерживают кодовую базу из более чем 2 миллионов токенов, Plandex быстро индексирует проекты и генерирует карты проектов. Пользователи могут загружать модули, создавать новые функции или исправлять ошибки, а проверка в песочнице обеспечивает безопасность кода.
2. Быстрое создание прототипов новых проектов
   Когда команды стартапов разрабатывают приложения, Plandex планирует REST API, модели баз данных и другие функции. Полностью автоматизированный режим ускоряет создание прототипов, а управление ветвями поддерживает множество архитектурных попыток.
3. Обучение в рамках всего технологического стека
   Когда разработчики изучают новый язык, например Rust, в режиме чата Plandex отвечает на вопросы и генерирует примеры кода для быстрого начала работы.
4. Автоматизированная генерация тестов
   При добавлении тестов в проект Plandex анализирует код и генерирует модульные тесты. Проверки в песочнице обеспечивают покрытие, а автоматическая отладка устраняет неудачные сценарии использования.

QA

1. Какие языки программирования поддерживает Plandex?
   Plandex использует поддержку древовидных ситтеров для более чем 30 языков, включая Python, JavaScript, Go, Java, C++ и другие, а также генерацию карт проектов для обеспечения синтаксической точности.
2. Как снизить стоимость использования?
   Включите кэширование контекста, выберите недорогую модель (например, DeepSeek) и точно загружайте файлы контекста, чтобы снизить потребление токенов.
3. Можно ли запустить Plandex локально?
   Да, поддерживается Docker для развертывания локальных серверов, используются ключи OpenAI и OpenRouter, а данные не загружаются в облако для защиты конфиденциальности.
4. Чем Plandex отличается от других инструментов для кодирования ИИ?
   Plandex специализируется на крупных проектах, поддерживает 2 миллиона контекстов токенов, обеспечивает рецензирование в песочнице и автоматическую отладку, а также превосходит инструменты, которые обеспечивают только завершение кода.