Sidekick CLI: инструмент для замены кода Клода с открытым исходным кодом

Последние ресурсы по искусственному интеллектуОпубликовано 4 месяца назад Круг обмена ИИ

9.5K 00

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

Sidekick CLI - это инструмент командной строки с открытым исходным кодом, предназначенный для упрощения процесса разработки и развертывания проектов для разработчиков с помощью искусственного интеллекта. Он поддерживается Клод Код, второй пилот и Курсор Sidekick CLI вдохновлен языковой моделью Sidekick и обеспечивает аналогичную функциональность, но позволяет пользователям свободно выбирать поставщика Large Language Model (LLM), чтобы избежать блокировки производителя.Sidekick CLI был разработан по принципу "CLI-first" и поддерживает серверы Model Context Protocol (MCP) для расширения возможностей взаимодействия с ИИ.Sidekick CLI был разработан по принципу "CLI-first" и поддерживает серверы Model Context Protocol (MCP). Sidekick CLI имеет дизайн "CLI-first" и поддерживает серверы Model Context Protocol (MCP), расширяя возможности взаимодействия ИИ. Он идеально подходит для независимых разработчиков или небольших команд для быстрой настройки проектов, развертывания на VPS и обеспечения поддержки генерации и отладки кода с помощью ИИ. Проект находится в стадии бета-версии, размещен на GitHub, поддерживается разработчиком Гэвином Викери (geekforbrains) под лицензией MIT и приветствует вклад сообщества и обратную связь.

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

Разработка с помощью искусственного интеллекта: Генерируйте код, отлаживайте проблемы или запрашивайте документацию с помощью подсказок на естественном языке и поддержки нескольких провайдеров LLM.
Гибкое переключение моделей: Беспрепятственное переключение между различными моделями ИИ в одной сессии для адаптации к различным требованиям задачи.
Поддержка сервера MCPПодключение к внешним инструментам и источникам данных для расширения возможностей искусственного интеллекта, например, для поиска кода на GitHub.
Руководящий документ по проекту: через SIDEKICK.md Настройте технологический стек проекта и предпочтения разработчиков.
Развертывание VPS в один клик: Автоматическая настройка среды VPS, установка Docker и Traefik, а также поддержка HTTPS-доменов.
Функция отмены: Использование /undo Быстрая отмена неправильных изменений, вызванных искусственным интеллектом.
Отслеживание стоимости и жетонов: Отслеживайте расходы на использование LLM и расход токенов, устанавливайте бюджетные ограничения.
контроль телеметрии: через --no-telemetry Отключите отслеживание ошибок Sentry и анализ использования.
Управление подтверждением команд: Поддержка /yolo Режим Пропустить подтверждение, или нажмите Настройка сеанса, чтобы подтвердить настройку.

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

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

Sidekick CLI легко установить, и он поддерживает использование pip или установки исходного кода. Ниже приведены подробные шаги:

Проверка системных требований
Убедитесь, что Python 3.8+ и pipПользователям Windows рекомендуется установить Git Bash или WSL для более удобной работы с терминалом. Пользователям macOS и Linux дополнительная настройка не требуется.
Установка через pip
Выполните следующую команду, чтобы установить Sidekick CLI:
```
pip install sidekick-cli
```

После завершения установки проверьте версию:

sidekick --version

Установка из источника(для разработчиков)
Клонируйте репозиторий GitHub:
```
git clone https://github.com/geekforbrains/sidekick-cli.git
cd sidekick-cli
```
Установите зависимость:
```
pip install .
```
Если требуется режим разработки (изменения кода вступают в силу в реальном времени), запустите его:
```
pip install -e .
```
начальная конфигурация
Запустите Sidekick CLI в первый раз:
```
sidekick
```
Система предлагает настроить провайдера LLM (например, OpenAI, Anthropic). Информация о конфигурации хранится в файле ~/.config/sidekick.json. Пример конфигурации:
```
{
"llm_providers": {
"openai": {
"api_key": "<你的API密钥>",
"model": "gpt-4"
}
},
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
```
Вы можете вручную отредактировать файл, чтобы добавить больше провайдеров LLM или MCP Сервер.
Проверка установки
Выполните следующую команду, чтобы убедиться, что Sidekick CLI работает правильно:
```
sidekick --version
```
Если возвращается номер версии (например. 0.1.0), установка прошла успешно.

Руководство по эксплуатации функций

1. Разработка с помощью ИИ

Основная функция Sidekick CLI - разработка с помощью искусственного интеллекта. Выполните следующую команду, чтобы сгенерировать код:

sidekick generate --prompt "编写一个 Flask REST API"

ИИ генерирует код при появлении запроса и сохраняет его в указанном файле. Вы также можете отладить код:

sidekick debug --file app.py

Эта команда анализирует код, указывает на ошибки и предлагает исправления. Если модификации AI вызывают проблемы, можно воспользоваться функцией отмены:

sidekick /undo

Отмена восстанавливает последние изменения и подходит для быстрого исправления ошибок.

2. гибкое переключение моделей

Sidekick CLI позволяет переключать модели ИИ в рамках сессии. Просмотр доступных моделей:

sidekick /model

Пример вывода:

0: gpt-4 (OpenAI)
1: claude-3 (Anthropic)

Переключитесь на конкретную модель:

sidekick /model 0

Эта функция позволяет выбрать более подходящую модель в соответствии с требованиями задачи.

3. поддержка сервера MCP

Сервер MCP расширяет возможности Sidekick CLI. Например, настройте MCP-сервер GitHub для получения кода:

{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<你的GitHub令牌>"
}
}
}
}

После сохранения выполните следующую команду для проверки функции MCP:

sidekick fetch --repo <GitHub仓库地址>

Сервер MCP предоставляет ИИ прямой доступ к внешним источникам данных, улучшая генерацию и анализ кода.

4. Руководящий документ по проекту

Sidekick CLI поддерживает создание SIDEKICK.md файл, определяющий технологический стек проекта и предпочтения разработчиков. Пример SIDEKICK.md::

# Sidekick Guide
- Tech Stack: Python, Flask, PostgreSQL
- Coding Style: PEP 8
- Project Structure: MVC
- Preferred LLM: gpt-4

После создания Sidekick CLI настраивает поведение ИИ на основе этого файла. Выполните следующую команду, чтобы применить руководство:

sidekick init

5. развертывание VPS одним щелчком мыши

Sidekick CLI упрощает развертывание VPS для систем Ubuntu 20.04+. Выполните следующую команду:

sidekick deploy --vps <VPS_IP地址>

Sidekick CLI откроется автоматически:

Настройте SSH и права доступа пользователей.
Установите Docker и Traefik.
Установите HTTPS (используется по умолчанию) sslip.io (бесплатное доменное имя).
Проверьте состояние развертывания:

sidekick status

Обновите приложение:

sidekick deploy --update

Эта функция поддерживает развертывание без простоев и подходит для проектов с быстрым запуском.

6. отслеживание стоимости и жетонов

Sidekick CLI обеспечивает мониторинг использования LLM. Просмотр текущего потребления:

sidekick cost

Выходные данные включают в себя количество токенов и смету расходов. Установите бюджет:

sidekick cost --set-budget 20.0

Sidekick CLI предупреждает, когда расходы приближаются к бюджету.

7. контроль телеметрии

По умолчанию Sidekick CLI включает телеметрию Sentry для сбора данных об ошибках и использовании. Отключите телеметрию:

sidekick --no-telemetry

Эта команда гарантирует, что чувствительные к конфиденциальности пользователи смогут полностью отключить сбор данных.

8. управление подтверждением команд

Чтобы ускорить работу, включите режим "йоло", чтобы пропустить подтверждение:

sidekick /yolo

Подтверждение восстановления:

sidekick /yolo off

Вы также можете задать поведение по умолчанию с помощью файла конфигурации:

{
"skip_confirm": true
}

Общие команды

/help: Отображает все команды.
/clear: Очистка истории сообщений.
/compact: Обобщение истории сообщений и очистка старых записей.
/dump: Отображает текущую историю сообщений (для отладки).
exit: Выход из Sidekick CLI.

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

Безопасность ключей API: Чтобы обеспечить ~/.config/sidekick.json Ключ не скомпрометирован в
Требования к VPS: Для развертывания требуются открытые порты SSH (по умолчанию 22) и публичные IP-адреса.
Предел бета-фазы: В текущей версии могут быть ошибки, поэтому следите за обновлениями в репозитории GitHub.

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

Быстрое прототипирование
Разработчикам необходимо быстро создавать прототипы веб-приложений. Sidekick CLI генерирует код и автоматизирует настройку с помощью искусственного интеллекта, позволяя пройти путь от идеи до развертывания за несколько дней.
Недорогое развертывание VPS
Для небольших команд, которые хотят запускать приложения на бюджетных VPS, Sidekick CLI обеспечивает развертывание одним щелчком мыши и отслеживание затрат для эффективного использования ресурсов.
Обучение на основе искусственного интеллекта
Начинающие изучают новые фреймворки с помощью функций искусственного интеллекта в Sidekick CLI. Введите подсказки на естественном языке, чтобы сгенерировать пример кода и отладить его, чтобы понять логику.

QA

Должен ли Sidekick CLI быть постоянно подключен?
Да, функциональность AI зависит от API провайдера LLM и требует подключения к сети. Развертывание серверов MCP и VPS также требует подключения к сети.
Как отключить телеметрию?
быть в движении sidekick --no-telemetry или в sidekick.json устанавливать "telemetry": false.
Какие программы LLM поддерживаются?
В настоящее время поддерживает OpenAI, Anthropic и т.д., и будет добавлена в будущем. Оллама и другие локальные модели (см. "Дорожную карту").
Как внести свой код?
Клонируйте репозиторий и установите зависимости для разработки (make install), отправьте Pull Request на GitHub.