# 📦 @goodandready/dsh-model-sync

Динамическая синхронизация каталогов моделей и автоматический мониторинг баланса для DeepSeek Harness

🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明

⭐ Если вам нравится этот плагин, поставьте ему звезду на GitHub — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.

🐛 Если вы нашли баг или хотите предложить новый функционал, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.

--- ## ⚡ Обзор **`dsh-model-sync`** обеспечивает автоматическую актуализацию каталога моделей **DeepSeek Harness** напрямую от подключенных провайдеров. Вместо ручного редактирования YAML-файлов при выходе новых моделей, смене лимитов контекста или цен, плагин автоматически обнаруживает релизы, обновляет флаги возможностей (`vision`, `tools`, `reasoning`, `embeddings`), отслеживает остатки баланса и обновляет каталог на лету без перезапуска сервера. ```mermaid graph LR subgraph Trigger [Планировщик и ручной запуск] Cron[⏰ Фоновый планировщик опроса] --> Engine[Ядро dsh-model-sync] WebUI[🖥️ Кнопка «Синхронизировать сейчас»] --> Engine end subgraph Providers [25+ Внешних провайдеров] Engine --> Registry{Реестр адаптеров} Registry -->|Авторизация Bearer| P1[OpenAI / DeepSeek / OpenRouter / Groq] Registry -->|Заголовок x-api-key| P2[Anthropic Claude / Кастомные шлюзы] Registry -->|Ключ query-key| P3[Google Gemini] Registry -->|Локальный опрос| P4[Локальная Ollama / vLLM / SGLang] end subgraph Reconcile [Сверка каталога и аудит] P1 --> Normalizer[Нормализация и разметка возможностей] P2 --> Normalizer P3 --> Normalizer P4 --> Normalizer Normalizer --> Diff[Журнал изменений: Добавлено / Устарело] Diff --> Catalog[Активный каталог моделей DSH] end style Trigger fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4 style Providers fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4 style Reconcile fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4 ``` --- ## ✨ Ключевые возможности * 🔄 **Автоматическое обнаружение моделей**: синхронизация списков моделей, контекстных окон и возможностей (`vision`, `tools`, `reasoning`, `embeddings`) для 25+ провайдеров. * 🌐 **25+ встроенных адаптеров**: готовая поддержка OpenAI, Anthropic, Google, DeepSeek, xAI, OpenRouter, Groq, Mistral, Cerebras, Fireworks, HuggingFace, Moonshot, NVIDIA, Qwen, Together, Xiaomi MiMo, SiliconFlow и локальной Ollama. * 🔌 **Универсальные кастомные адаптеры**: подключение любых сторонних OpenAI-совместимых эндпоинтов `/v1/models` (`bearer`, `x-api-key`, `query-key`, `none`). * 📊 **Мониторинг баланса и квот**: опрос биллинга провайдеров (где доступно) для контроля остатка кредитов. * 📜 **Журнал изменений (Diff Log)**: фиксация добавленных, удаленных и обновленных моделей с отметками времени. * 🖥️ **Панель управления в Web GUI (**Настройки → Синхронизация моделей**)**: * Статус-карточки со счетчиками активных моделей по каждому провайдеру; * Кнопка «Синхронизировать сейчас» для мгновенного обновления; * Переключатели провайдеров и ввод пользовательских адресов. --- ## 📦 Быстрая установка ```bash dsh plugin --profile web add @goodandready/dsh-model-sync ``` --- ## 🚀 Улучшения в версии 0.4.0 - **One-Click обновление плагина из настроек**: В карточку настроек плагина добавлен блок обновления с проверкой актуальной версии в npm, цветовым бейджем статуса и кнопкой обновления в один клик. - **Защита write-эндпоинтов по Loopback**: Все мутирующие HTTP-маршруты (`/apply`, `/policy`, `/clear-cache`, `/updater/update`) строго проверяют адрес источника (`127.0.0.1`, `::1`, `::ffff:127.0.0.1`) и заголовок Origin/Host для предотвращения несанкционированного доступа. - **Полная поддержка темы DSH (0 rgba / 0 hex)**: Все стили интерфейса переведены на официальные токены дизайн-системы DSH (`--dsw-alias-*`), обеспечивая нативную интеграцию со светлой и тёмной темами оформления. - **Модульная архитектура синхронизатора**: Монолитная логика синхронизации разделена на специализированные модули (`synchronizer-helpers.js`, `synchronizer-transfer.js`, `synchronizer-prober.js`), что упрощает поддержку и снижает размер основного файла ниже 600 строк. - **Чистый дистрибутив пакета**: Исключены внутренние файлы планирования и отладки; размер сжатого npm-пакета составляет менее 70 KiB, все файлы укладываются в лимит 256 KiB. ## 🚀 Улучшения в v0.3.13 * ⚡ **ETag / 304 Not Modified для фонового опроса UI**: * Реализована генерация слабого ETag для маршрута `GET /dsh-model-sync/status`. При 15-секундном опросе UI возвращается пустой ответ `304 Not Modified`, исключающий холостую сериализацию JSON и сетевой оверхед. * 🌐 **Условные запросы к API провайдеров (Upstream Conditional Requests)**: * Передача заголовков `If-None-Match` и `If-Modified-Since` в generic и declarative адаптерах. При ответе `304` от апстрим-провайдера мгновенно возвращается кэш без повторного парсинга моделей. * 🎯 **Debounce поиска и useMemo в веб-интерфейсе**: * Добавлен debounce (150 мс) на ввод в строку поиска и мемоизация `React.useMemo` для фильтрации и сортировки моделей в пикере, обеспечивая плавный отклик без микрофризов. * 🧠 **Расширенное распознавание возможностей моделей**: * Распознавание современных reasoning/thinking моделей (`DeepSeek-R1`, `o1`, `o3-mini`, CoT) и моделей для кода (`code`), поддержка тега `code` в политиках фильтрации. * 🛡️ **Экспоненциальный джиттер при повторах**: * Защита от thundering herd с помощью случайного коэффициента джиттера (`0.5 - 1.0`) при повторных запросах к API провайдеров. ---