@goodandready/dsh-model-sync 0.4.3 → 0.4.4

package/README.md

@@ -39,7 +39,7 @@
 
 **`dsh-model-sync`** keeps your **DeepSeek Harness** model catalog up-to-date with upstream AI providers. 
 
-Instead of manually editing YAML configs whenever a provider launches a new model, adjusts context window limits, or changes pricing, `dsh-model-sync` automatically discovers new releases, updates capability metadata (`vision`, `tools`, `reasoning`, `embeddings`), tracks account balances, and reconciles models on the fly without server restarts.
+Instead of manually editing YAML configs whenever a provider launches a new model, adjusts context window limits, or changes pricing, `dsh-model-sync` automatically discovers new releases, updates capability metadata (`vision`, `tools`, `reasoning`, `embeddings`), tracks account balances, manages model selection visibility, and reconciles models on the fly without server restarts.
 
 ```mermaid
 graph LR
@@ -54,6 +54,8 @@ graph LR
         Registry -->|x-api-key Auth| P2[Anthropic Claude / Custom Gateways]
         Registry -->|query-key Auth| P3[Google Gemini]
         Registry -->|Local Probe| P4[Local Ollama / vLLM / SGLang]
+        Registry -->|CommandCode API| P5[Command Code / visibleModels]
+        Registry -->|Plan Discovery| P6[ClineBot Subscription Plan]
     end
 
     subgraph Reconcile [Catalog Reconciler & Auditing]
@@ -61,8 +63,10 @@ graph LR
         P2 --> Normalizer
         P3 --> Normalizer
         P4 --> Normalizer
+        P5 --> Normalizer
+        P6 --> Normalizer
         Normalizer --> Diff[Sync Diff Tracker: Added / Deprecated]
-        Diff --> Catalog[Active DSH Models Catalog]
+        Diff --> Catalog[Active DSH Models Catalog & visibleModels]
     end
 
     style Trigger fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
@@ -75,21 +79,24 @@ graph LR
 ## ✨ Key Features
 
 * 🔄 **Automated Catalog Discovery**: Syncs model lists, aliases, context windows, and capability flags (`vision`, `tools`, `reasoning`, `embeddings`) across 25+ providers.
-* 🛡️ **Minijinja Chat Template & Role Compatibility**: Automatically sets `compat.supportsDeveloperRole: false` for Groq open-source models (Qwen, Llama, Mistral, Gemma, DeepSeek) and DeepSeek API, preventing 400 `Unexpected message role` errors with reasoning models while preserving user overrides. Syncs model lists, aliases, context windows, and capability flags (`vision`, `tools`, `reasoning`, `embeddings`) across 25+ providers.
-* 🌐 **25+ Built-in Provider Adapters**: Pre-configured discovery for OpenAI, Anthropic, Google, DeepSeek, xAI, OpenRouter, Groq, Mistral, Cerebras, Fireworks, HuggingFace, Moonshot, NVIDIA, Qwen, Together, Xiaomi MiMo, SiliconFlow, and local Ollama.
+* 🛡️ **Minijinja Chat Template & Role Compatibility**: Automatically sets `compat.supportsDeveloperRole: false` for Groq open-source models (Qwen, Llama, Mistral, Gemma, DeepSeek) and DeepSeek API, preventing 400 `Unexpected message role` errors with reasoning models while preserving user overrides.
+* 🌐 **25+ Built-in Provider Adapters**: Pre-configured discovery for OpenAI, Anthropic, Google, DeepSeek, xAI, OpenRouter, Groq, Mistral, Cerebras, Fireworks, HuggingFace, Moonshot, NVIDIA, Qwen, Together, Xiaomi MiMo, SiliconFlow, Command Code, ClineBot, and local Ollama.
+* 🎛️ **Command Code Model Selection**: Full discovery of Command Code models with granular checkbox selection in the UI, automatically syncing `visibleModels` to `llm-commandcode` settings.
+* 🎯 **ClineBot Subscription Plan Sync**: Dedicated adapter querying `GET /users/me/plan` to discover only active subscription-included models, eliminating catalog clutter from out-of-plan endpoints.
 * 🔌 **Generic / Custom Adapter Support**: Connect arbitrary OpenAI-compatible `/v1/models` endpoints with configurable auth (`bearer`, `x-api-key`, `query-key`, `none`).
 * 📊 **Balance & Quota Monitoring**: Queries upstream billing endpoints (where supported) to report account credit balances and prevent unexpected exhaustion.
 * 📜 **Sync History & Diff Auditing**: Tracks all newly discovered models, deprecated IDs, and modified capabilities with timestamped diff logs in the Web UI.
 * 🖥️ **Full Web GUI Panel (**Settings → Model Synchronization**)**:
   * Live status cards per provider with active model counters;
   * Instant "Sync Now" button for on-demand catalog refreshes;
+  * Granular model checkboxes for selection and visibility management;
   * Provider enable/disable toggles and custom endpoint inputs.
 
 ---
 
 ## 🛠️ Supported Discovery Providers
 
-| Provider Identifier | Authentication Format | Capabilities Auto-Detection |
+| Provider Identifier | Authentication Format | Capabilities Auto-Detection & Notes |
 |---|---|---|
 | `openai` | Bearer Token | `vision`, `tools`, `reasoning`, `embeddings` |
 | `anthropic` | `x-api-key` header | `vision`, `tools`, `reasoning` |
@@ -99,6 +106,8 @@ graph LR
 | `openrouter` | Bearer Token | Multi-vendor model catalog with pricing & context limits |
 | `groq` | Bearer Token | `tools`, `reasoning`, `vision`, `supportsDeveloperRole: false` |
 | `mistral` | Bearer Token | `tools`, `reasoning`, `vision` |
+| `commandcode` | Bearer Token | `https://api.commandcode.ai/provider/v1/models` catalog with `visibleModels` selection syncing to `llm-commandcode` |
+| `clinebot` | Bearer Token | Active subscription plan discovery (`/users/me/plan`), restricting sync strictly to plan-included models |
 | `fireworks` | Bearer Token | Open-weights inference endpoints |
 | `huggingface` | Bearer Token | Serverless Inference API catalog |
 | `together` | Bearer Token | Open-source model catalog |
@@ -117,3 +126,32 @@ dsh plugin --profile web add @goodandready/dsh-model-sync
 > Restart DSH Web UI after installation (`systemctl --user restart dsh-web`) to activate background catalog synchronization.
 
 ---
+
+## ⚙️ Configuration (`settings.yaml`)
+
+```yaml
+dsh-model-sync:
+  enabled: true
+  syncIntervalMinutes: 60
+  autoReconcile: true
+  enableBalanceChecks: true
+  providers:
+    commandcode:
+      enabled: true
+    clinebot:
+      enabled: true
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `enabled` | `boolean` | `true` | Master switch for background synchronization |
+| `syncIntervalMinutes` | `number` | `60` | Polling frequency for catalog refreshes |
+| `autoReconcile` | `boolean` | `true` | Automatically apply discovered models to active catalog |
+| `enableBalanceChecks` | `boolean` | `true` | Query billing endpoints where supported |
+| `providers.<id>.enabled`| `boolean` | `true` | Enable or disable discovery for specific provider |
+
+---
+
+## 📄 License
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/README.ru.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-<h3>Динамическая синхронизация каталогов моделей и автоматический мониторинг баланса для DeepSeek Harness</h3>
+<h3>Динамическая синхронизация каталогов LLM-моделей и автоматический мониторинг баланса для DeepSeek Harness</h3>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-model-sync"><img src="https://img.shields.io/npm/v/@goodandready/dsh-model-sync.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
@@ -24,9 +24,9 @@
 <table align="center">
   <tr>
     <td align="center">
-      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему Star на GitHub</strong> — это покажет мне, что плагин полезен, и добавит мотивации продолжать его развитие.
       <br><br>
-      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+      🐛 <strong>Если вы нашли баг или хотите предложить новую функцию</strong>, создайте Issue на GitHub на любом языке — я рассмотрю предложение и реализую полезные улучшения в одной из следующих версий плагина.
     </td>
   </tr>
 </table>
@@ -37,32 +37,36 @@
 
 ## ⚡ Обзор
 
-**`dsh-model-sync`** обеспечивает автоматическую актуализацию каталога моделей **DeepSeek Harness** напрямую от подключенных провайдеров.
+**`dsh-model-sync`** поддерживает каталог моделей **DeepSeek Harness** в актуальном состоянии с апстрим AI-провайдерами.
 
-Вместо ручного редактирования YAML-файлов при выходе новых моделей, смене лимитов контекста или цен, плагин автоматически обнаруживает релизы, обновляет флаги возможностей (`vision`, `tools`, `reasoning`, `embeddings`), отслеживает остатки баланса и обновляет каталог на лету без перезапуска сервера.
+Вместо ручного редактирования YAML-файлов при выпуске провайдером новой модели, изменении размера контекста или цен, `dsh-model-sync` автоматически обнаруживает новые релизы, обновляет метаданные возможностей (`vision`, `tools`, `reasoning`, `embeddings`), отслеживает баланс аккаунтов, управляет видимостью моделей в интерфейсе и синхронизирует модели на лету без перезапуска сервера.
 
 ```mermaid
 graph LR
-    subgraph Trigger [Планировщик и ручной запуск]
+    subgraph Trigger [Расписание и ручной запуск]
         Cron[⏰ Фоновый планировщик опроса] --> Engine[Ядро dsh-model-sync]
-        WebUI[🖥️ Кнопка «Синхронизировать сейчас»] --> Engine
+        WebUI[🖥️ Настройки: Кнопка Sync Now] --> Engine
     end
 
-    subgraph Providers [25+ Внешних провайдеров]
+    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]
+        Registry -->|Bearer Auth| P1[OpenAI / DeepSeek / OpenRouter / Groq]
+        Registry -->|x-api-key Auth| P2[Anthropic Claude / Пользовательские шлюзы]
+        Registry -->|query-key Auth| P3[Google Gemini]
+        Registry -->|Локальный опрос| P4[Локальные Ollama / vLLM / SGLang]
+        Registry -->|CommandCode API| P5[Command Code / visibleModels]
+        Registry -->|Опрос подписки| P6[План подписки ClineBot]
     end
 
     subgraph Reconcile [Сверка каталога и аудит]
-        P1 --> Normalizer[Нормализация и разметка возможностей]
+        P1 --> Normalizer[Нормализатор моделей и тегирование возможностей]
         P2 --> Normalizer
         P3 --> Normalizer
         P4 --> Normalizer
-        Normalizer --> Diff[Журнал изменений: Добавлено / Устарело]
-        Diff --> Catalog[Активный каталог моделей DSH]
+        P5 --> Normalizer
+        P6 --> Normalizer
+        Normalizer --> Diff[Трекер изменений: Добавлено / Устарело]
+        Diff --> Catalog[Активный каталог моделей DSH и visibleModels]
     end
 
     style Trigger fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
@@ -74,15 +78,41 @@ graph LR
 
 ## ✨ Ключевые возможности
 
-* 🔄 **Автоматическое обнаружение моделей**: синхронизация списков моделей, контекстных окон и возможностей (`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 (**Настройки → Синхронизация моделей**)**:
-  * Статус-карточки со счетчиками активных моделей по каждому провайдеру;
-  * Кнопка «Синхронизировать сейчас» для мгновенного обновления;
-  * Переключатели провайдеров и ввод пользовательских адресов.
+* 🔄 **Автоматическое обнаружение каталога**: синхронизация списков моделей, алиасов, контекстных окон и флагов возможностей (`vision`, `tools`, `reasoning`, `embeddings`) для 25+ провайдеров.
+* 🛡️ **Совместимость шаблонов чата и ролей Minijinja**: автоматическая установка `compat.supportsDeveloperRole: false` для открытых моделей Groq (Qwen, Llama, Mistral, Gemma, DeepSeek) и DeepSeek API, предотвращая ошибки 400 `Unexpected message role` для reasoning-моделей с сохранением пользовательских настроек.
+* 🌐 **25+ встроенных адаптеров провайдеров**: готовая поддержка OpenAI, Anthropic, Google, DeepSeek, xAI, OpenRouter, Groq, Mistral, Cerebras, Fireworks, HuggingFace, Moonshot, NVIDIA, Qwen, Together, Xiaomi MiMo, SiliconFlow, Command Code, ClineBot и локальной Ollama.
+* 🎛️ **Управление моделями Command Code**: полное обнаружение моделей Command Code с возможностью выбора чекбоксами в UI и автоматической синхронизацией `visibleModels` в настройках `llm-commandcode`.
+* 🎯 **Синхронизация тарифного плана ClineBot**: выделенный адаптер, опрашивающий `GET /users/me/plan`, который получает исключительно модели, входящие в активную подписку, исключая появление сотен недоступных моделей.
+* 🔌 **Поддержка универсальных и кастомных адаптеров**: подключение произвольных OpenAI-совместимых эндпоинтов `/v1/models` с настраиваемой авторизацией (`bearer`, `x-api-key`, `query-key`, `none`).
+* 📊 **Мониторинг баланса и квот**: опрос биллинговых эндпоинтов провайдеров (где поддерживается) для предотвращения неожиданного исчерпания средств.
+* 📜 **История синхронизации и аудит диффов**: отслеживание всех добавленных моделей, устаревших ID и изменённых возможностей с журналом изменений во времени.
+* 🖥️ **Полноценная панель Web UI (**Настройки → Синхронизация моделей**)**:
+  * Карточки статуса по каждому провайдеру со счётчиками активных моделей;
+  * Кнопка мгновенной синхронизации «Sync Now»;
+  * Выбор и скрытие моделей чекбоксами;
+  * Переключатели включения/отключения провайдеров и ввод кастомных эндпоинтов.
+
+---
+
+## 🛠️ Поддерживаемые провайдеры
+
+| Идентификатор провайдера | Формат авторизации | Автоопределение возможностей и примечания |
+|---|---|---|
+| `openai` | Bearer Token | `vision`, `tools`, `reasoning`, `embeddings` |
+| `anthropic` | Заголовок `x-api-key` | `vision`, `tools`, `reasoning` |
+| `google` | Query-параметр / Ключ | `vision`, `tools`, `reasoning`, `embeddings` |
+| `deepseek` | Bearer Token | `tools`, `reasoning` |
+| `xai` | Bearer Token | `vision`, `tools`, `reasoning` |
+| `openrouter` | Bearer Token | Мультипровайдерный каталог с ценами и контекстными лимитами |
+| `groq` | Bearer Token | `tools`, `reasoning`, `vision`, `supportsDeveloperRole: false` |
+| `mistral` | Bearer Token | `tools`, `reasoning`, `vision` |
+| `commandcode` | Bearer Token | Каталог `https://api.commandcode.ai/provider/v1/models` с сохранением выбора в `visibleModels` для `llm-commandcode` |
+| `clinebot` | Bearer Token | Опрос активного тарифного плана (`/users/me/plan`), синхронизация строго включённых в подписку моделей |
+| `fireworks` | Bearer Token | Эндпоинты открытых весов |
+| `huggingface` | Bearer Token | Каталог Serverless Inference API |
+| `together` | Bearer Token | Каталог моделей Open-Source |
+| `ollama` | Локальный HTTP (`none`) | Локальное обнаружение офлайн-моделей (`/api/tags`) |
+| `custom` | Настраиваемый | Любой кастомный шлюз, совместимый с OpenAI или Google |
 
 ---
 
@@ -92,27 +122,36 @@ graph LR
 dsh plugin --profile web add @goodandready/dsh-model-sync
 ```
 
+> [!IMPORTANT]
+> Перезапустите Web UI DSH после установки (`systemctl --user restart dsh-web`), чтобы активировать фоновую синхронизацию каталогов.
+
 ---
 
-## 🚀 Улучшения в версии 0.4.0
+## ⚙️ Конфигурация (`settings.yaml`)
+
+```yaml
+dsh-model-sync:
+  enabled: true
+  syncIntervalMinutes: 60
+  autoReconcile: true
+  enableBalanceChecks: true
+  providers:
+    commandcode:
+      enabled: true
+    clinebot:
+      enabled: true
+```
 
-- **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.
+| Параметр | Тип | По умолчанию | Описание |
+|---|---|---|---|
+| `enabled` | `boolean` | `true` | Главный переключатель фоновой синхронизации |
+| `syncIntervalMinutes` | `number` | `60` | Периодичность опроса провайдеров (в минутах) |
+| `autoReconcile` | `boolean` | `true` | Автоматически применять обнаруженные модели к активному каталогу |
+| `enableBalanceChecks` | `boolean` | `true` | Опрашивать биллинговые эндпоинты при наличии поддержки |
+| `providers.<id>.enabled`| `boolean` | `true` | Включение или отключение обнаружения для конкретного провайдера |
 
-## 🚀 Улучшения в 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 провайдеров.
+## 📄 Лицензия
 
----
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/README.zh.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-<h3>DeepSeek Harness 服务商模型目录动态同步与账户余额监控插件</h3>
+<h3>面向 DeepSeek Harness 的动态大模型目录同步与自动化余额监控插件</h3>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-model-sync"><img src="https://img.shields.io/npm/v/@goodandready/dsh-model-sync.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
@@ -12,7 +12,7 @@
 </p>
 
 <p align="center">
-  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/作者全部项目-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="作者全部项目"></a>
+  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/作者所有项目-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="作者所有项目"></a>
 </p>
 
 <p align="center">
@@ -35,49 +35,38 @@
 
 ---
 
-## 🚀 v0.3.13 性能与质量优化
-
-* ⚡ **ETag / 304 Not Modified 状态缓存**:
-  * 为 `GET /dsh-model-sync/status` 提供弱 ETag 支持。UI 定时 15 秒轮询时直接返回 `304 Not Modified`，避免多余 JSON 序列化与流量损耗。
-* 🌐 **上游条件请求 (Upstream Conditional Requests)**:
-  * 向提供商 API 发送 `If-None-Match` / `If-Modified-Since`。当提供商返回 304 时直接命中缓存，无需重复解析。
-* 🎯 **模型搜索防抖与 useMemo 优化**:
-  * 模型选择器搜索框加入 150ms debounce 与 `React.useMemo` 缓存，大幅提升大模型列表下的筛选与排序流畅度。
-* 🧠 **扩展模型能力检测**:
-  * 支持现代推理/思考模型（DeepSeek-R1、o1/o3-mini）及代码专用模型（`code`）的能力标记与策略过滤。
-* 🛡️ **带抖动的指数退避重试 (Exponential Jitter)**:
-  * 在 API 失败重试时加入随机抖动系数，有效防止高并发下的惊群效应。
-
----
-
 ## ⚡ 插件概览
 
-**`dsh-model-sync`** 保持 **DeepSeek Harness** 模型选单与上游大模型服务商实时同步。
+**`dsh-model-sync`** 保持您的 **DeepSeek Harness** 模型目录与上游各大 AI 服务商最新发布完全同步。
 
-每当服务商上线新模型、扩充上下文长度或调整定价时，插件自动拉取最新清单，同步模型能力标签（`vision` 视觉、`tools` 工具调用、`reasoning` 深度思考、`embeddings` 嵌入），并在无需重启服务的前提下热重载目录。
+每当服务商推出新模型、调整上下文窗口上限或变更费率时，不再需要手动逐项编辑 YAML 配置文件。`dsh-model-sync` 能够自动发现新版本、更新模型能力元数据（`vision`、`tools`、`reasoning`、`embeddings`）、监控账户余额并在无需重启服务的情况下即时对齐模型目录。
 
 ```mermaid
 graph LR
     subgraph Trigger [调度与手动触发]
-        Cron[⏰ 后台定时轮询调度器] --> Engine[dsh-model-sync 核心引擎]
+        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]
+        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]
+        Registry -->|CommandCode 接口| P5[Command Code / visibleModels]
+        Registry -->|套餐检测| P6[ClineBot 订阅套餐]
     end
 
-    subgraph Reconcile [目录对齐与审计]
-        P1 --> Normalizer[模型归一化与能力特征打标]
+    subgraph Reconcile [目录对齐与审计追踪]
+        P1 --> Normalizer[模型标准化器与能力打标]
         P2 --> Normalizer
         P3 --> Normalizer
         P4 --> Normalizer
-        Normalizer --> Diff[差异审计流: 新增 / 废弃模型]
-        Diff --> Catalog[DSH 当前生效模型选单]
+        P5 --> Normalizer
+        P6 --> Normalizer
+        Normalizer --> Diff[差异跟踪: 新增 / 已废弃]
+        Diff --> Catalog[当前可用 DSH 模型目录与 visibleModels]
     end
 
     style Trigger fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
@@ -87,30 +76,81 @@ graph LR
 
 ---
 
-## 📦 安装指南
+## ✨ 核心特性
+
+* 🔄 **自动化目录同步**：自动对齐 25+ 服务商的模型清单、别名、上下文窗口及能力标签（`vision`、`tools`、`reasoning`、`embeddings`）。
+* 🛡️ **Minijinja 聊天模板与角色兼容性保障**：自动为 Groq 开源模型（Qwen、Llama、Mistral、Gemma、DeepSeek）及 DeepSeek API 注入 `compat.supportsDeveloperRole: false`，避免推理模型报 400 `Unexpected message role` 错误，同时保留用户自定义配置。
+* 🌐 **内置 25+ 服务商适配器**：预置支持 OpenAI、Anthropic、Google、DeepSeek、xAI、OpenRouter、Groq、Mistral、Cerebras、Fireworks、HuggingFace、Moonshot、NVIDIA、Qwen、Together、Xiaomi MiMo、SiliconFlow、Command Code、ClineBot 以及本地 Ollama。
+* 🎛️ **Command Code 模型精细管理**：完整发现 Command Code 模型目录，在 Web 界面提供勾选过滤，自动同步 `visibleModels` 至 `llm-commandcode` 设置中。
+* 🎯 **ClineBot 订阅套餐精准匹配**：专属适配器直接调用 `GET /users/me/plan`，只拉取当前有效订阅套餐包含的模型，彻底解决全量拉取 400+ 外部模型导致的混淆。
+* 🔌 **通用与自定义适配器扩展**：支持接入任意兼容 OpenAI `/v1/models` 规范的网关，支持多种认证方式（`bearer`、`x-api-key`、`query-key`、`none`）。
+* 📊 **余额与用量监控**：实时查询上游计费端点，精准反馈账户额度并防止因欠费导致任务中断。
+* 📜 **同步历史与变更审计**：完整记录新模型上线、旧模型废弃及能力变更的时间线与详细差异。
+* 🖥️ **全功能 Web 管理面板 (**设置 → 模型同步**)**：
+  * 每个服务商的卡片化状态展示与模型计数；
+  * 一键即时同步（Sync Now）；
+  * 模型勾选过滤与显示控制；
+  * 服务商启用开关及自定义 Endpoint 地址输入。
+
+---
+
+## 🛠️ 支持的服务商列表
+
+| 服务商标识符 | 认证机制 | 能力自检与特性说明 |
+|---|---|---|
+| `openai` | Bearer Token | `vision`, `tools`, `reasoning`, `embeddings` |
+| `anthropic` | `x-api-key` 请求头 | `vision`, `tools`, `reasoning` |
+| `google` | Query 参数 / 密钥 | `vision`, `tools`, `reasoning`, `embeddings` |
+| `deepseek` | Bearer Token | `tools`, `reasoning` |
+| `xai` | Bearer Token | `vision`, `tools`, `reasoning` |
+| `openrouter` | Bearer Token | 多厂商汇聚模型目录，包含计费与上下文规格 |
+| `groq` | Bearer Token | `tools`, `reasoning`, `vision`, `supportsDeveloperRole: false` |
+| `mistral` | Bearer Token | `tools`, `reasoning`, `vision` |
+| `commandcode` | Bearer Token | 对接 `https://api.commandcode.ai/provider/v1/models`，同步勾选至 `llm-commandcode` 的 `visibleModels` |
+| `clinebot` | Bearer Token | 仅同步有效订阅套餐 (`/users/me/plan`) 包含的模型 |
+| `fireworks` | Bearer Token | 开源权重推理节点 |
+| `huggingface` | Bearer Token | Serverless Inference API 目录 |
+| `together` | Bearer Token | 开源大模型服务网络 |
+| `ollama` | 本地 HTTP (`none`) | 本地离线模型实时发现 (`/api/tags`) |
+| `custom` | 自定义配置 | 任意兼容 OpenAI 或 Google 规范的 API 网关 |
+
+---
+
+## 📦 快速安装
 
 ```bash
 dsh plugin --profile web add @goodandready/dsh-model-sync
 ```
 
----
+> [!IMPORTANT]
+> 安装后请重启 DSH Web 界面 (`systemctl --user restart dsh-web`)，以激活后台目录自动同步。
 
-## 🚀 v0.4.0 新特性与增强
+---
 
-- **设置卡片一键更新**: 在 DSH 设置卡片中集成自动版本检查，展示当前与最新版本对比徽标，支持一键安全升级并在更新后提示重启。
-- **严格本地环回 (Loopback) 安全保护**: 所有修改状态的 HTTP 路由 (`/apply`, `/policy`, `/clear-cache`, `/updater/update`) 均强制校验本地环回 IP (`127.0.0.1`, `::1`, `::ffff:127.0.0.1`) 及请求来源，杜绝外部恶意调用。
-- **100% 原生主题变量适配**: 客户端 UI 全面移除硬编码颜色与 `rgba()` 样式，完全切换至 DSH 官方 CSS 设计令牌 (`--dsw-alias-*`)，无缝适配深色与浅色主题。
-- **同步引擎模块化拆分**: 核心同步逻辑已解耦拆分为专项子模块 (`synchronizer-helpers.js`, `synchronizer-transfer.js`, `synchronizer-prober.js`)，大幅提升代码可读性与维护性。
-- **轻量分发包清理**: 彻底排除内部计划与调试文件，精简 npm 发布体积至 70 KiB 以下，所有文件均完全符合 256 KiB 上限规范。
+## ⚙️ 配置说明 (`settings.yaml`)
+
+```yaml
+dsh-model-sync:
+  enabled: true
+  syncIntervalMinutes: 60
+  autoReconcile: true
+  enableBalanceChecks: true
+  providers:
+    commandcode:
+      enabled: true
+    clinebot:
+      enabled: true
+```
 
-## 🚀 v0.3.14 新特性与增强
+| 参数名称 | 类型 | 默认值 | 功能说明 |
+|---|---|---|---|
+| `enabled` | `boolean` | `true` | 后台自动同步主开关 |
+| `syncIntervalMinutes` | `number` | `60` | 目录更新轮询间隔（分钟） |
+| `autoReconcile` | `boolean` | `true` | 是否自动将新发现的模型生效至可用列表 |
+| `enableBalanceChecks` | `boolean` | `true` | 在受支持的服务商处查询余额 |
+| `providers.<id>.enabled`| `boolean` | `true` | 单独开启或关闭指定服务商的同步 |
 
-- **语言标准**: 插件原生支持 `en` 与 `zh` 双语，俄语本地化已独立解耦至 `goodandready/dsh-russian-lang` 翻译包 (#191)。
-- **发布隔离**: 通过 `.npmignore` 严格过滤测试、规划和文档文件，保证 npm 发布包体积小于 256 KiB。
-- **模型批量可用性测试**: 支持通过 `POST /dsh-model-sync/batch-try` 并发批量测试所选模型，展示延迟徽标并一键取消选中不可用模型。
-- **价格与上下文窗口过滤**: 支持按每百万 Token 最高价格及最小上下文长度过滤候选模型。
-- **配置导入与导出**: 支持通过 `GET /export` 与 `POST /import` 导出及恢复全部策略、模型选择、别名和定时计划。
-- **自定义模型别名映射**: 支持通过 `GET/POST /aliases` 为特定服务商与模型组合设置便于调用的简短别名。
+---
 
 ## 📄 开源协议
 

package/lib/adapter-registry.js

@@ -1,14 +1,51 @@
 import { catalogRequestError } from './reliability.js'
 import { canUseGenericAdapter, createGenericAdapter } from './generic-adapter.js'
-import { normalizeModels } from './models.js'
+import { normalizeModels, parseClinePassModels } from './models.js'
 
 const MAX_RESPONSE_BYTES = 4 * 1024 * 1024
 const SAFE_AUTH = new Set(['bearer', 'x-api-key', 'query-key', 'none'])
-const SAFE_PARSERS = new Set(['openai', 'google'])
+const SAFE_PARSERS = new Set(['openai', 'google', 'clinebot-plan'])
 const CAPABILITIES = new Set(['vision', 'tools', 'reasoning', 'embeddings', 'code'])
 const BLOCKED_HEADERS = /authorization|api[_-]?key|token|secret|cookie/i
 
 const PROVIDER_ADAPTERS = Object.freeze({
+  clinebot: {
+    endpoint: 'https://api.cline.bot/api/v1/users/me/plan',
+    auth: 'bearer',
+    parser: 'clinebot-plan',
+    defaultModels: [
+      'cline-pass/deepseek-v4-flash',
+      'cline-pass/deepseek-v4-pro',
+      'cline-pass/glm-5.2',
+      'cline-pass/kimi-k3',
+      'cline-pass/kimi-k2.7-code',
+      'cline-pass/kimi-k2.6',
+      'cline-pass/qwen3.7-max',
+      'cline-pass/qwen3.7-plus',
+      'cline-pass/minimax-m3',
+      'cline-pass/mimo-v2.5',
+      'cline-pass/mimo-v2.5-pro',
+    ],
+  },
+  commandcode: {
+    endpoint: 'https://api.commandcode.ai/provider/v1/models',
+    auth: 'bearer',
+    fields: {
+      id: 'id',
+      name: 'name',
+      contextWindow: 'context_length',
+    },
+    defaultModels: [
+      'deepseek/deepseek-v4.1-flash',
+      'deepseek/deepseek-v4-flash',
+      'qwen/qwen3.8-flash',
+      'google/gemini-3.8-flash',
+      'meta/muse-spark-1.3-contributor',
+      'zai-org/glm-5.1',
+      'xiaomi/mimo-v2.5-pro',
+      'minimaxai/minimax-m3',
+    ],
+  },
   anthropic: { endpoint: 'https://api.anthropic.com/v1/models', auth: 'x-api-key', headers: { 'anthropic-version': '2023-06-01' } },
   google: { endpoint: 'https://generativelanguage.googleapis.com/v1beta/models', auth: 'query-key', parse: 'google' },
   openai: { endpoint: 'https://api.openai.com/v1/models', auth: 'bearer' },
@@ -62,6 +99,11 @@ function mappedRows(provider, rows, descriptor) {
 }
 
 function parseRows(provider, payload, descriptor) {
+  if (descriptor.parse === 'clinebot-plan') {
+    const plan = payload?.data?.plan || payload?.data || payload?.plan || payload
+    const included = plan?.features?.included || plan?.includedModels || []
+    return parseClinePassModels(included)
+  }
   if (descriptor.parse === 'google') {
     const rows = Array.isArray(payload?.models) ? payload.models : []
     return normalizeModels(provider, rows.map((row) => ({

package/lib/inventory.js

@@ -5,6 +5,7 @@ export const API_KEY_PROVIDER_IDS = Object.freeze([
   'ant-ling',
   'azure-openai-responses',
   'cerebras',
+  'commandcode',
   'cloudflare-ai-gateway',
   'cloudflare-workers-ai',
   'deepseek',
@@ -63,7 +64,18 @@ export function listApiKeyProviders(llm, settings) {
   const out = []
   const seen = new Set()
   for (const entry of directory) {
-    const profile = profiles[entry.provider] ?? {}
+    let profile = profiles[entry.provider]
+    if (!profile && (entry.provider === 'commandcode' || entry.settingsNs === 'llm-commandcode')) {
+      const cc = settings?.get?.('llm-commandcode')
+      profile = {
+        apiKeyEnv: cc?.apiKeyEnv ?? 'COMMANDCODE_API_KEY',
+        credentialRef: cc?.apiKeyEnv ?? 'COMMANDCODE_API_KEY',
+        baseURL: cc?.apiBase ?? 'https://api.commandcode.ai',
+        models: cc?.visibleModels ?? [],
+      }
+    } else {
+      profile = profile ?? {}
+    }
     if (!isApiKeyProvider(entry, profile) || seen.has(entry.provider)) continue
     seen.add(entry.provider)
     out.push({

package/lib/models.js

@@ -380,3 +380,153 @@ export function diffModels(previous, next) {
     hasChanges: added.length > 0 || removed.length > 0 || renamed.length > 0 || changed.length > 0,
   }
 }
+
+export const CLINEPASS_MODELS = Object.freeze([
+  {
+    id: 'cline-pass/deepseek-v4-flash',
+    name: 'DeepSeek V4 Flash',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { vision: true, code: true, reasoning: true },
+    input: ['text', 'image'],
+  },
+  {
+    id: 'cline-pass/deepseek-v4-pro',
+    name: 'DeepSeek V4 Pro',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { vision: true, code: true, reasoning: true },
+    input: ['text', 'image'],
+  },
+  {
+    id: 'cline-pass/glm-5.2',
+    name: 'GLM 5.2',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { code: true },
+    input: ['text'],
+  },
+  {
+    id: 'cline-pass/kimi-k3',
+    name: 'Kimi K3',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { reasoning: true },
+    input: ['text'],
+  },
+  {
+    id: 'cline-pass/kimi-k2.7-code',
+    name: 'Kimi K2.7 Code',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { code: true, tools: true },
+    input: ['text'],
+  },
+  {
+    id: 'cline-pass/kimi-k2.6',
+    name: 'Kimi K2.6',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { code: true },
+    input: ['text'],
+  },
+  {
+    id: 'cline-pass/qwen3.7-max',
+    name: 'Qwen 3.7 Max',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { vision: true },
+    input: ['text', 'image'],
+  },
+  {
+    id: 'cline-pass/qwen3.7-plus',
+    name: 'Qwen 3.7 Plus',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { vision: true },
+    input: ['text', 'image'],
+  },
+  {
+    id: 'cline-pass/minimax-m3',
+    name: 'MiniMax M3',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { reasoning: true },
+    input: ['text'],
+  },
+  {
+    id: 'cline-pass/mimo-v2.5',
+    name: 'MiMo V2.5',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { code: true },
+    input: ['text'],
+  },
+  {
+    id: 'cline-pass/mimo-v2.5-pro',
+    name: 'MiMo V2.5 Pro',
+    contextWindow: 200000,
+    maxTokens: 8192,
+    capabilities: { code: true, reasoning: true },
+    input: ['text'],
+  },
+])
+
+export function parseClinePassModels(includedInput) {
+  if (!includedInput) return [...CLINEPASS_MODELS]
+  let includedText = ''
+  if (Array.isArray(includedInput)) {
+    const foundStr = includedInput.find((item) => typeof item === 'string' && /includes\s+/i.test(item))
+    if (foundStr) {
+      includedText = foundStr
+    } else {
+      includedText = includedInput.filter((x) => typeof x === 'string').join(', ')
+    }
+  } else if (typeof includedInput === 'string') {
+    includedText = includedInput
+  } else {
+    return [...CLINEPASS_MODELS]
+  }
+
+  const clean = includedText
+    .replace(/^includes\s+/i, '')
+    .replace(/\band\b/gi, ',')
+    .replace(/\./g, '')
+    .trim()
+
+  const parts = clean
+    .split(',')
+    .map((p) => p.trim())
+    .filter(Boolean)
+
+  if (!parts.length) return [...CLINEPASS_MODELS]
+
+  const normalize = (s) =>
+    String(s || '')
+      .toLowerCase()
+      .replace(/[\s._-]+/g, '')
+
+  const matched = []
+  for (const name of parts) {
+    const targetNorm = normalize(name)
+    const found = CLINEPASS_MODELS.find(
+      (m) =>
+        normalize(m.name) === targetNorm ||
+        normalize(m.id.replace(/^cline-pass\//, '')) === targetNorm
+    )
+    if (found) {
+      matched.push(found)
+    } else {
+      const idPart = name.toLowerCase().replace(/[\s_]+/g, '-')
+      matched.push({
+        id: `cline-pass/${idPart}`,
+        name,
+        contextWindow: 200000,
+        maxTokens: 8192,
+        capabilities: {},
+        input: ['text'],
+      })
+    }
+  }
+  return normalizeModels('clinebot', matched.length ? matched : [...CLINEPASS_MODELS])
+}

package/lib/synchronizer-helpers.js

@@ -53,7 +53,20 @@ export function descriptorOf(settings, ns) {
 }
 
 export function profileOf(settings, provider) {
-  try { return settings?.get(PIAI_NS)?.providers?.[provider] ?? {} }
+  try {
+    const piai = settings?.get(PIAI_NS)?.providers?.[provider]
+    if (piai) return piai
+    if (provider === 'commandcode') {
+      const cc = settings?.get?.('llm-commandcode')
+      return {
+        apiKeyEnv: cc?.apiKeyEnv ?? 'COMMANDCODE_API_KEY',
+        credentialRef: cc?.apiKeyEnv ?? 'COMMANDCODE_API_KEY',
+        baseURL: cc?.apiBase ?? 'https://api.commandcode.ai',
+        models: cc?.visibleModels ?? [],
+      }
+    }
+    return {}
+  }
   catch { return {} }
 }
 

package/lib/synchronizer.js

@@ -369,13 +369,24 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
       const resultsToApply = results.filter((row) => row.status === 'ok' && row.changed && (!dryRun || providerAutoApply(row.provider)))
       if (resultsToApply.length > 0) {
         const settings = settingsOf(ctx)
-        await replaceWithRetry(settings, PIAI_NS, (section) => {
-          let next = section
-          for (const row of resultsToApply) {
-            next = catalogPatch(next, row.provider, row.next)
+        const piaiRows = resultsToApply.filter((r) => r.provider !== 'commandcode')
+        const ccRows = resultsToApply.filter((r) => r.provider === 'commandcode')
+        if (piaiRows.length > 0) {
+          await replaceWithRetry(settings, PIAI_NS, (section) => {
+            let next = section
+            for (const row of piaiRows) {
+              next = catalogPatch(next, row.provider, row.next)
+            }
+            return next
+          })
+        }
+        for (const row of ccRows) {
+          if (typeof settings?.mutate === 'function') {
+            await settings.mutate('llm-commandcode', [
+              { op: 'set', path: ['visibleModels'], value: row.selectedModels?.length ? row.selectedModels : row.next.map(m => m.id) }
+            ])
           }
-          return next
-        })
+        }
         result.applied = true
       }
       if (!dryRun || resultsToApply.length > 0) {
@@ -500,9 +511,6 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
     const settings = settingsOf(ctx)
     const section = settings?.get?.(PIAI_NS)
     const descriptor = descriptorOf(settings, PIAI_NS)
-    if (!section || !descriptor || typeof settings.replace !== 'function') {
-      throw Object.assign(new Error('llm-pi-ai settings are not writable'), { code: 'SETTINGS_UNAVAILABLE' })
-    }
     const current = normalizeModels(provider, profileOf(settings, provider).models ?? row.models)
     const nextModels = selectedModels.length
       ? selectedModels.map((id) => availableById.get(id))
@@ -510,11 +518,24 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
     const previousModelSelections = structuredClone(config.modelSelections ?? {})
     const modelSelections = { ...previousModelSelections, [provider]: selectedModels }
 
-    // Persist the allowlist first. If the LLM catalog write fails, roll the
-    // allowlist back so the two namespaces cannot be left disagreeing.
+    // Persist the allowlist first.
     await saveConfig({ modelSelections })
     try {
-      await replaceWithRetry(settings, PIAI_NS, (section) => catalogPatch(section, provider, nextModels))
+      if (provider === 'commandcode') {
+        if (typeof settings?.mutate === 'function') {
+          await settings.mutate('llm-commandcode', [
+            { op: 'set', path: ['visibleModels'], value: selectedModels }
+          ])
+        }
+        if (section?.providers?.commandcode && typeof settings?.replace === 'function') {
+          await replaceWithRetry(settings, PIAI_NS, (sec) => catalogPatch(sec, provider, nextModels))
+        }
+      } else {
+        if (!section || !descriptor || typeof settings.replace !== 'function') {
+          throw Object.assign(new Error('llm-pi-ai settings are not writable'), { code: 'SETTINGS_UNAVAILABLE' })
+        }
+        await replaceWithRetry(settings, PIAI_NS, (sec) => catalogPatch(sec, provider, nextModels))
+      }
     } catch (error) {
       try {
         await saveConfig({ modelSelections: previousModelSelections })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-model-sync",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Automatic model catalog synchronization for API-key DeepSeek Harness providers.",
   "keywords": [
     "deepseek-harness",