@goodandready/dsh-model-sync 0.3.12 → 0.3.14

package/README.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
+      <br><br>
+      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -107,6 +117,30 @@ dsh plugin --profile web add @goodandready/dsh-model-sync
 
 ---
 
+## 🚀 Enhancements in v0.3.14
+
+- **Language Standard**: Canonical plugin in `en` and `zh`. Runtime Russian translations decoupled into `goodandready/dsh-russian-lang` (#191).
+- **Packaging Isolation**: Dedicated `.npmignore` excludes tests, plans, and documentation to maintain a minimal < 256 KiB npm release bundle.
+- **Batch Health Check**: Probe multiple selected models in parallel via `POST /dsh-model-sync/batch-try` with latency badges and one-click removal of unreachable models.
+- **Cost & Context Policies**: Set maximum price per million tokens and minimum context window thresholds in provider policies.
+- **Catalog Export & Import**: Backup and restore full plugin configuration (policies, selections, aliases, scheduler) via `GET /export` and `POST /import`.
+- **Model Alias Mapping**: Assign friendly aliases to provider/model pairs with `GET /aliases` and `POST /aliases` with interactive UI card.
+
+## 🚀 Enhancements in v0.3.13
+
+* ⚡ **Zero-Overhead Polling via HTTP ETag / 304 Not Modified**:
+  * Implemented weak ETag generation for `GET /dsh-model-sync/status`. When the Web UI polls every 15 seconds, unchanged catalogs receive an empty `304 Not Modified` response, eliminating redundant JSON serialization and network traffic.
+* 🌐 **Upstream Conditional HTTP Requests**:
+  * Added `If-None-Match` and `If-Modified-Since` headers to upstream provider discovery. Catalogs that return `304 Not Modified` resolve instantly from memory cache without re-parsing or diff re-computation.
+* 🎯 **Debounced Search & Memoized Sorting in UI**:
+  * Introduced 150ms input debouncing and `React.useMemo` for model filtering/sorting in the model picker, ensuring fluid search responsiveness on catalogs with hundreds of models.
+* 🧠 **Expanded Capability Detection**:
+  * Added detection for modern reasoning models (`DeepSeek-R1`, `o1`, `o3-mini`, `thinking`) and specialized code generation models (`code`), plus support for the `code` capability filter in policy matching and UI picker.
+* 🛡️ **Exponential Retry Jitter**:
+  * Enhanced `retryWithBackoff` with randomized jitter (`0.5 - 1.0` multiplier) to prevent thundering-herd effects on provider APIs during network hiccups or rate limits.
+
+---
+
 ## 🛠️ Enhancements & Fixes in v0.3.11
 
 * 🗂️ **Streamlined Settings UI Surface**:

package/README.ru.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -84,6 +94,21 @@ dsh plugin --profile web add @goodandready/dsh-model-sync
 
 ---
 
+## 🚀 Улучшения в 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 провайдеров.
+
+---
+
 ## 🛠️ Улучшения и исправления в v0.3.11
 
 * 🗂️ **Чистый интерфейс настроек (DSH Design Contract)**:
@@ -196,6 +221,15 @@ dsh-model-sync:
 
 ---
 
+## 🚀 Улучшения в версии 0.3.14
+
+- **Языковой стандарт**: Каноническая поддержка `en` и `zh` в кодовой базе плагина; русскоязычная локализация вынесена в пакет `goodandready/dsh-russian-lang` (#191).
+- **Изоляция релиза**: Настроен `.npmignore` для исключения тестов, планов и документации из npm-пакета.
+- **Пакетная проверка моделей (Batch Try)**: Эндпоинт `POST /dsh-model-sync/batch-try`, бейджи задержки и мгновенная деселекция недоступных моделей.
+- **Политики по цене и контексту**: Опциональные фильтры `maxPricePerMillion` и `minContextTokens` в настройках провайдера.
+- **Экспорт и импорт конфигурации**: JSON-бэкап и перенос настроек через `GET /export` и `POST /import`.
+- **Пользовательские алиасы моделей**: Управление алиасами моделей через `GET/POST /aliases` и UI-карточку.
+
 ## 📄 Лицензия
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/README.zh.md

@@ -21,10 +21,35 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
 
+## 🚀 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** 模型选单与上游大模型服务商实时同步。
@@ -70,6 +95,15 @@ dsh plugin --profile web add @goodandready/dsh-model-sync
 
 ---
 
+## 🚀 v0.3.14 新特性与增强
+
+- **语言标准**: 插件原生支持 `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` 为特定服务商与模型组合设置便于调用的简短别名。
+
 ## 📄 开源协议
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/lib/adapter-registry.js

@@ -5,7 +5,7 @@ import { normalizeModels } 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 CAPABILITIES = new Set(['vision', 'tools', 'reasoning', 'embeddings'])
+const CAPABILITIES = new Set(['vision', 'tools', 'reasoning', 'embeddings', 'code'])
 const BLOCKED_HEADERS = /authorization|api[_-]?key|token|secret|cookie/i
 
 const PROVIDER_ADAPTERS = Object.freeze({
@@ -120,7 +120,7 @@ export function normalizeAdapterConfig(config, profile = {}) {
   return { endpoint: endpoint.toString(), auth, parse, headers, modelsPath, capabilityMap, fields }
 }
 
-async function requestSpecific(profile, descriptor, { resolveCredential, fetchImpl, signal }) {
+async function requestSpecific(profile, descriptor, { resolveCredential, fetchImpl, signal, etag, lastModified }) {
   const keyRef = profile.apiKeyEnv || profile.credentialRef || profile.apiKeyRef
   const apiKey = keyRef ? await resolveCredential(keyRef) : ''
   const url = new URL(descriptor.endpoint)
@@ -128,11 +128,14 @@ async function requestSpecific(profile, descriptor, { resolveCredential, fetchIm
   if (descriptor.auth === 'bearer' && apiKey) headers.Authorization = 'Bearer ' + apiKey
   if (descriptor.auth === 'x-api-key' && apiKey) headers['x-api-key'] = apiKey
   if (descriptor.auth === 'query-key' && apiKey) url.searchParams.set('key', apiKey)
+  if (etag) headers['If-None-Match'] = etag
+  if (lastModified) headers['If-Modified-Since'] = lastModified
   let response
   try { response = await fetchImpl(url, { headers, signal }) } catch (error) {
     if (error && typeof error === 'object') error.adapterCode = 'endpoint'
     throw error
   }
+  if (response.status === 304) return response
   if (!response.ok) {
     const error = catalogRequestError(response.status, response)
     error.adapterCode = [401, 403].includes(response.status) ? 'auth' : response.status === 429 ? 'rate-limit' : 'http'
@@ -145,6 +148,11 @@ async function fetchSpecific(profile, descriptor, options) {
   let payload
   try {
     const response = await requestSpecific(profile, descriptor, options)
+    if (response.status === 304) {
+      return { notModified: true, etag: response.headers?.get?.('etag') || options.etag, lastModified: response.headers?.get?.('last-modified') || options.lastModified }
+    }
+    const respEtag = response.headers?.get?.('etag') || undefined
+    const respLastMod = response.headers?.get?.('last-modified') || undefined
     const declared = Number(response.headers?.get?.('content-length') ?? NaN)
     if (Number.isFinite(declared) && declared > MAX_RESPONSE_BYTES) {
       const error = new Error('model catalog response is too large')
@@ -163,7 +171,16 @@ async function fetchSpecific(profile, descriptor, options) {
       throw error
     }
     const rows = parseRows(profile.provider, payload, descriptor)
-    if (Array.isArray(rows) && rows.length > 0) return rows
+    if (Array.isArray(rows) && rows.length > 0) {
+      if (respEtag || respLastMod) {
+        Object.defineProperty(rows, '__httpMeta', {
+          value: { etag: respEtag, lastModified: respLastMod },
+          enumerable: false,
+          configurable: true,
+        })
+      }
+      return rows
+    }
   } catch (error) {
     if (descriptor.defaultModels && Array.isArray(descriptor.defaultModels) && descriptor.defaultModels.length > 0) {
       return normalizeModels(profile.provider, descriptor.defaultModels.map((id) => ({ id })))