# 📦 @goodandready/dsh-model-search

Быстрый живой поиск и фильтрация моделей в селекторе DeepSeek Harness WebUI

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

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

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

--- ## ⚡ Обзор и решаемая проблема По мере масштабирования конфигураций в **DeepSeek Harness** и подключения десятков моделей от разных провайдеров (OpenAI, Anthropic, OpenRouter, Ollama, DeepSeek), стандартное выпадающее меню селектора моделей становится перегруженным. Поиск нужной нейросети превращается в утомительную прокрутку длинных списков. **`@goodandready/dsh-model-search`** встраивает в выпадающее меню выбора модели мгновенный, быстрый и доступный с клавиатуры живой поиск: * **Мгновенная фильтрация**: поиск по названию модели, техническому идентификатору (`provider/model-id`) и группе провайдера. * **Умный нечёткий поиск и акронимы**: поддержка поиска по аббревиатурам (например, `dsr1` мгновенно находит `deepseek-reasoner-1`). * **Синтаксис `@provider`**: быстрая фильтрация моделей конкретного поставщика (например, `@ollama`, `@openrouter`). * **Нулевая нагрузка на CPU**: селективный MutationObserver гарантирует нулевую нагрузку во время стриминга токенов в чате. * **Полная поддержка клавиатуры**: строгая циклическая навигация стрелками по найденным элементам, выбор по `Enter` и сброс по `Escape`. --- ## 🏗️ Архитектура ```mermaid graph LR A[DSH WebUI Меню моделей] --> B[lib/client.js] B --> C[Монтирование поля поиска] C --> D{Парсер запроса} D -->|Текст / Акроним| E[Нечёткий матчер подпоследовательностей] D -->|@provider| F[Фильтр групп провайдеров] E --> G[Управление видимостью DOM] F --> G G --> H[Клавиатурная навигация] H --> I[Хранилище недавних моделей] ``` --- ## ✨ Ключевые возможности ### 1. Многословный поиск с разделителями Поддерживает составные поисковые запросы, разделённые пробелами, запятыми, слэшами или точками с запятой: * Запрос: `openrouter/claude-3-5` * Запрос: `reasoner; 32b` * Запрос: `@ollama llama3` ### 2. Поиск по аббревиатурам и сокращениям Находит модели по неполным подпоследовательностям символов: * Ввод `dsr` находит `deepseek-reasoner` * Ввод `gpt4o` находит `openai/gpt-4o-mini` ### 3. Специальный синтаксис `@provider` Символ `@` в начале запроса фильтрует модели по конкретному провайдеру: * `@openai` отображает только модели провайдера OpenAI. * `@ollama qwen` находит модели семейства Qwen на локальном сервере Ollama. ### 4. Управление с клавиатуры | Клавиша | Действие | |:---|:---| | `ArrowDown` | Переход к следующей видимой отфильтрованной модели | | `ArrowUp` | Переход к предыдущей модели; на первой позиции возвращает фокус в поле ввода | | `Enter` | Мгновенный выбор текущей подсвеченной или первой видимой модели | | `Escape` | Очистка поля поиска; закрытие выпадающего меню, если поле уже пустое | ### 5. Надёжность и интеграция с ядром * **Неинвазивная работа с DOM**: плагин только переключает видимость элементов (`display: none` / visible), не переставляя React Virtual DOM-узлы. * **Устойчивость к обновлениям ядра**: не зависит от сгенерированных хэшей CSS-модулей DSH. * **Нативная тема**: использует официальные системные CSS-переменные DSH для светлой и тёмной тем. * **Мультиязычность**: ядро содержит встроенные английский (`en`) и китайский (`zh`) языки; русский (`ru`) автоматически подключается при установленном плагине `@goodandready/dsh-russian-lang`. --- ### 6. Встроенное обновление в один клик и карточка настроек * **Нативная карточка настроек**: регистрируется во вкладке «Настройки → Плагины → Настройки плагинов» (settings.plugin.item) для пространства dsh-model-search. * **One-Click обновление**: проверяет наличие свежих релизов в реестре npm, корректно распознаёт SemVer и пререлизы, обновляет плагин по клику с защитой от параллельных запросов и строгой fail-closed проверкой источника. * **100% поддержка дизайн-токенов темы**: использует исключительно семантические CSS-переменные ядра DSH (--dsw-*) без захардкоженных hex или rgba цветов, идеально вписываясь в светлую и тёмную темы. ## 📦 Установка Установка в Web-профиль DeepSeek Harness: ```bash dsh plugin --profile web add @goodandready/dsh-model-search ``` Перезапустите DSH или обновите страницу браузера для активации живого поиска. --- ## 🧪 Тестирование Запуск проверок синтаксиса и автоматических тестов: ```bash # Проверка синтаксиса JavaScript npm run check # Запуск тестов npm test ``` --- ## 📄 Лицензия MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)