Open Codex: инструмент ИИ с открытым исходным кодом для преобразования естественного языка в команды оболочки

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

Open Codex - это инструмент ИИ командной строки с открытым исходным кодом, предназначенный для разработчиков, чтобы преобразовывать инструкции на естественном языке в точные команды оболочки. Он использует родную языковую модель (например, phi-4-mini) и не требует подключения к сети или ключей API, все операции выполняются локально. Пользователи могут генерировать shell-команды или код с помощью простого описания, что делает его подходящим для быстрого программирования. Проект размещен на GitHub, прост в установке и поддерживает macOS, Linux и Windows. open Codex уделяет особое внимание безопасности и требует подтверждения пользователя перед выполнением команд для защиты системы.

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

• Переход от естественного языка к командам оболочки: Преобразование естественного языка, вводимого пользователем, в исполняемые команды оболочки.
• Прогоны локальных моделей: Поддержка локальных моделей, таких как phi-4-mini, без необходимости подключения к Интернету и с защитой конфиденциальности.
• генерация кода: Генерируйте фрагменты кода на нескольких языках программирования на основе описаний.
• Механизм подтверждения заказа: Для предотвращения злоупотреблений требуется подтверждение пользователя после генерации команд.
• История эксплуатации: сохранение истории команд, поддержка функций просмотра и частичной отмены.
• Расширения для плагинов: Поддержка разработчиков для создания плагинов, расширяющих функциональность инструмента.
• Поддержка кросс-платформыСовместим с macOS, Linux и Windows и подходит для нескольких терминалов.

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

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

Open Codex поддерживает несколько способов установки для различных операционных систем и привычек пользователей. Ниже приведены подробные шаги для быстрого запуска.

Установка через Homebrew (macOS/Linux)

1. Добавьте источник Homebrew для Open Codex:

   brew tap codingmoh/open-codex
   

2. Инструменты для установки:

   brew install open-codex
   

3. Проверьте установку и проверьте версию:

   open-codex --version
   

Установка с помощью pipx (кроссплатформенная)

1. Убедитесь, что установлены Python (3.8 или выше) и pipx.
2. Установите Open Codex глобально:

   pipx install open-codex
   

3. Проверьте установку:

   open-codex --version
   

Установка через исходный код

1. Клонируйте репозиторий GitHub:

   git clone https://github.com/codingmoh/open-codex.git
   

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

   cd open-codex
   

3. Установите зависимость:

   pip install .
   

4. Проверьте установку:

   open-codex --version
   

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

После установки Open Codex может быть вызван из командной строки. Ниже приведены инструкции по работе с основными функциями.

Переход от естественного языка к командам оболочки

Основная функция Open Codex - преобразование естественного языка в команды оболочки. Процедура выглядит следующим образом:

1. Вводите команды на естественном языке в терминале, например:

   open-codex "列出当前目录下所有Python文件"
   

2. Инструмент генерирует соответствующие команды оболочки, например:

   ls *.py
   

3. Система предложит пользователю выбрать:
   • y: Выполнить команду.
   • c: Копирование команды в буфер обмена.
   • n: Отмена операции.
4. опция yКоманда выполняется локально и выводит результаты, например, список всех .py Документация.

Генерация сложных команд оболочки

Для сложных задач Open Codex также может генерировать многошаговые команды. Например:

1. Вход:

   open-codex "查找所有txt文件并统计行数"
   

2. могут быть созданы инструменты:

   find . -name "*.txt" -exec wc -l {} \;
   

3. После подтверждения пользователем команда выполняется, отображая количество строк и общее количество каждого txt-файла.

Сгенерировать код

В дополнение к командам оболочки Open Codex поддерживает генерацию кода:

1. Вход:

   open-codex "用 Bash 写一个备份文件夹的脚本"
   

2. Инструмент возвращает код, например:

   #!/bin/bash
   tar -czf backup_$(date +%F).tar.gz /path/to/folder
   

3. Возможность выбора пользователем:
   • Сохранить в файл: Enter open-codex --save backup.sh.
   • Копирование в буфер обмена: выберите c.
   • Прямое выполнение: выберите y(Необходимо убедиться, что скрипт является исполняемым).

Посмотреть историю

1. Просмотр истории созданных и выполненных команд:

   open-codex --history
   

2. История сортируется по времени, показывая команды и статус их выполнения.
3. Операция отмены (если поддерживается):

   open-codex --undo
   

Пользовательские модели

В Open Codex по умолчанию используется модель phi-4-mini. Переключение моделей происходит постепенно:

1. Отредактируйте файл конфигурации (находится в папке ~/.open-codex/config.yaml):

   model: phi-4-mini
   

2. модификации model поля - другие поддерживаемые локальные модели.
3. Сохраните и перезагрузите терминал, чтобы переключатель вступил в силу.

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

Механизм подтверждения безопасности

Для предотвращения злоупотреблений все команды требуют подтверждения пользователя перед выполнением:

1. После ввода команд на естественном языке инструмент отображает предлагаемые команды.
2. Пользователям предоставляется y(Реализация),c(Воспроизведение) или n(Отменено) Выбор.
3. опция y Если команда выполняется в среде "песочницы", это обеспечивает безопасность системы.

Локальная операция гарантирует конфиденциальность

Open Codex работает локально и не требует подключения к Интернету. Пользовательские данные и генерируемый контент не загружаются в облако, что подходит для сценариев с высокими требованиями к конфиденциальности. Например:

• Создавайте команды или код в автономной среде.
• Избегайте утечки данных при работе с конфиденциальными проектами.

Расширения для плагинов

Разработчики могут создавать дополнения к плагинам:

1. В корневом каталоге проекта создайте файл plugins Папка.
2. Напишите плагин в соответствии с документацией (обратитесь к репозиторию GitHub для CONTRIBUTING.md).
3. Перезапустите Open Codex, и плагин загрузится автоматически.

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

• Убедитесь, что установлен Python 3.8 или выше.
• Для установки Homebrew или pipx требуется стабильная сеть.
• Установку исходного кода необходимо обновлять вручную, поэтому рекомендуется запускать ее регулярно. git pull.
• Инструмент находится на стадии разработки и может иметь недоработанные функции, поэтому мы рекомендуем следить за GitHub Issues.
• Создание сложных команд может быть ограничено возможностями модели, что требует от пользователя проверки точности команд.

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

1. Быстрая генерация команд
   Разработчик забывает о конкретной команде оболочки (например, unzip tar.gz) и набирает open-codex "解压 tar.gz 文件"Получить tar -xzf file.tar.gz и реализации.
2. Развитие офлайн
   Разработчики используют Open Codex для создания сценариев оболочки или кода на Python в условиях отсутствия сети, защищая конфиденциальность проекта.
3. управление системой
   Ввод данных администратором open-codex "查找占用磁盘空间最大的文件"Получить du -ah | sort -rh | headбыстро обнаружить проблему.
4. Изучение сценариев оболочки
   Вход для начинающих open-codex "用 Bash 写一个监控CPU的脚本"Получайте примеры кода и изучайте скриптинг.
5. Общественное развитие
   Разработчики вносят новые функции через GitHub, например, добавляют поддержку новых моделей или оптимизируют логику генерации команд.

QA

1. Насколько точно естественный язык соответствует командам оболочки?
   Точность зависит от возможностей модели. phi-4-mini справляется с обычными задачами, а сложные команды предлагают пользователю проверить сгенерированные результаты.
2. Поддерживаются ли другие команды терминала?
   В основном поддерживаются команды оболочки (bash/zsh), в будущем возможны расширения для PowerShell и т. д. Подробности смотрите в дорожной карте GitHub.
3. Как работать с командой Generate Error?
   После проверки команды выберите n отмена исполнения, или путем open-codex --history Проверьте историю и при необходимости отмените действие.
4. Поддерживает ли он многоязычный ввод?
   В настоящее время оптимизирован для ввода на китайском и английском языках, для других языков могут потребоваться более точные описания.
5. Как оставить отзыв о проблеме?
   Посетите репозиторий GitHub (https://github.com/codingmoh/open-codex), чтобы отправить вопросы или Pull Requests.