Плагин GigaChat для DeepSeek Harness: OAuth2-прокси
dsh-llm-gigachat
Плагин для DeepSeek Harness добавляет модели Сбера GigaChat в обычный выбор моделей: встроенный OAuth2-прокси и автоматическая настройка провайдера
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хранит ключ GigaChat в профиле и передает его в OAuth-обмен с Сбером
- Локальный прокси на порту 8787 принимает запросы без отдельной защиты
Установка
- Сервисы
Ручная установка
dsh plugin --profile web add dsh-llm-gigachatКоманда из README, затем добавьте плагин в `dsh.profile.bundles` профиля и перезапустите `dsh web`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хранит ключ GigaChat в профиле и передает его в OAuth-обмен с Сбером
- Локальный прокси на порту 8787 принимает запросы без отдельной защиты
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин npm для DeepSeek Harness (`dsh`) подключает модели Сбера GigaChat так, что провайдер появляется на странице Settings, Models и доступен в обычном выборе модели. Сам по себе harness с GigaChat не дружит: Сбер выдает токен по схеме OAuth 2.0 Client Credentials, а встроенные шлюзы, совместимые с OpenAI, такого обмена не знают. Плагин берет это на себя: меняет ключ на токен, кеширует токен на 30 минут, выстраивает запросы в очередь, потому что личный тариф допускает примерно один параллельный запрос, повторяет вырожденные ответы `<` и переводит вызовы инструментов в формат `functions` и `function_call`. Агентный режим с инструментами надежно держат только `GigaChat-3-Ultra` и `GigaChat-3-Pro`, более легкие модели работают без инструментов.
Для кого. Разработчикам, которые запускают DeepSeek Harness и хотят вести агента на российской модели GigaChat по ключу из кабинета Сбера.
Подходит, если
- Агентный harness должен работать на GigaChat, а встроенные шлюзы дают ошибку 401 из-за OAuth2
- Нужен выбор GigaChat в обычном списке моделей, без отдельного внешнего прокси
- Личный тариф допускает один параллельный запрос, и нужна очередь вместо ответов 429
- Перед запуском надо проверить конфигурацию без старта сервера флагом `--dump-config`
Не подходит, если
- Агент не DeepSeek Harness: плагин написан под его профили и список `bundles`
- Нужны инструменты на легких моделях GigaChat: они выдают выдуманные вызовы, и плагин отключает им инструменты
- Нужна работа без Node.js и pnpm: установка идет через них
Пример запроса к агенту
Переключи модель на GigaChat-3-Pro и прочитай файл README проекта, затем перечисли открытые вопросыОграничения
Плагин рассчитан только на DeepSeek Harness и подключается через `dsh.profile.bundles` в `package.json` профиля, после чего `dsh web` нужно перезапустить. Ключ GigaChat вставляется вручную в настройках, ключ хранится у пользователя в профиле. Лимит личного тарифа около одного параллельного запроса, запросы идут по очереди, и параллельная работа нескольких агентов замедляется. Легкие модели `GigaChat-3-Lightning` и `GigaChat-2*` по умолчанию работают без инструментов через `stripToolsFor`. Звезд нет, автор один, версия ранняя.
Как отключить. Уберите `dsh-llm-gigachat` из `dsh.profile.bundles`, выполните откат по разделу Rollback в README и перезапустите `dsh web`.
Частые вопросы
Зачем нужен плагин, если есть шлюзы OpenAI?
Встроенные шлюзы harness не умеют двухшаговый обмен ключа на токен OAuth2 Сбера, поэтому прямое подключение дает ошибку 401. Плагин содержит этот обмен.
Какие модели работают с инструментами?
`GigaChat-3-Ultra` и `GigaChat-3-Pro`. Более легкие модели путают схемы или выдумывают вызовы, поэтому по умолчанию идут без инструментов.
Как проверить настройку безопасно?
Флаг `--dump-config` печатает конфигурацию и не запускает сервер, README называет эту проверку обязательной перед первым запуском.
Что делать с ключом?
Вставить значение `base64(client_id:client_secret)` в поле API key у строки Sber GigaChat на странице Settings, Models и нажать Apply.
Можно ли обойтись без плагина?
Да, поднимите внешний `gigachat-proxy.mjs` на порту 8787 и добавьте кастомного провайдера с адресом `http://127.0.0.1:8787/v1`, но плагин проще.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
GigaChat — все инструментыЛокальный прокси, который отдает GigaChat через OpenAI- и Anthropic-совместимый API, чтобы подключать его к Claude Code, aider и другим агентам
Прокси от ai-forever, который отдает GigaChat через API OpenAI, Anthropic и Gemini, чтобы запускать на нем Claude Code, Codex и Gemini CLI
Скиллы GigaChat
GigaChat Skills
Восемь скиллов для кода на GigaChat API: выбор слоя интеграции, настройка доступа, SDK, LangChain, gpt2giga и Deep Agents
MCP-сервер для API GigaChat
GigaChat API
Небольшой Python MCP-сервер для API GigaChat от Сбера: авторизация по Basic-ключу и обращение к моделям прямо из агента, проверялся на OpenCode под Windows
Неофициальное расширение Chrome добавляет в чат giga.chat кнопку MCP: серверы по адресу, OAuth 2.1, локальные программы и подтверждение каждого вызова
GigaCode Proxy для редакторов: Cline, Roo Code, Continue
GigacodeOpenaiProxy
Прокси без зависимостей подключает GigaCode к Cline, Roo Code, Continue и Open WebUI, чинит обрывы вызовов инструментов и входит через SberID
Коротко о README
README на английском и русском: оглавление, три способа установки (npm, репозиторий GitHub, локальная копия), проверка через `--dump-config`, добавление провайдера по шагам, объяснение OAuth2 и таблица настроек. В конце откат, удаление и разбор неполадок. Примеры настроек лежат в `examples/settings.yaml`.