@goodandready/dsh-cost-meter 0.8.0 → 0.8.2

package/README.md

@@ -18,10 +18,20 @@
 
 <p align="center">
   <a href="README.md"><b>🇬🇧 English</b></a> •
-  <a href="docs/README.ru.md"><b>🇷🇺 Русский</b></a> •
-  <a href="docs/README.zh.md"><b>🇨🇳 中文说明</b></a>
+  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
+  <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>
 
 ---
@@ -138,3 +148,16 @@ npm test
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### Performance & Smart Cost Features (v0.8.1)
+- **O(K) Rate Change Calculation**: Next schedule transition is resolved in $O(K)$ boundary hops instead of full-day iterations.
+- **Server Cache & ETag**: High-throughput state polling with `304 Not Modified` support and internal tariff LRU cache.
+- **Manual Catalog Sync**: On-demand catalog fetch via `POST /dsh-cost-meter/refresh` or UI "Sync Now" button.
+- **Savings Advice & Budget Threshold**: Popover hints on impending off-peak discounts (50% off) and optional warning thresholds (`budgetThreshold`).
+- **Quick Summary Export**: Instant markdown/text summary copy to clipboard.
+
+### UI Refinements & Language Standards (v0.8.2)
+- **Native Dot Status Indicator**: Header chip uses a refined status dot (green for off-peak, amber for peak, pulsing red for budget overrun, neutral for flat/idle) rather than full-fill backgrounds.
+- **Context Cache Savings**: Automatically calculates and highlights financial savings gained from prompt caching (e.g. `Cache saved: ≈ $0.14 (-68%)`).
+- **Multi-Model Accordion**: Clean collapsible list when 3 or more models are used in a single session.
+- **DSH Locale Standards**: Full English (`en`) and Chinese (`zh`) locale dictionaries registered directly in the client bundle. Russian translations are provided externally via `@goodandready/dsh-russian-lang`.

package/README.ru.md

@@ -0,0 +1,156 @@
+# 📦 @goodandready/dsh-cost-meter
+
+<div align="center">
+
+<h3>Чип стоимости сессии, переключатель пиковых тарифов и мониторинг расходов токенов для DeepSeek Harness</h3>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-cost-meter"><img src="https://img.shields.io/npm/v/@goodandready/dsh-cost-meter.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
+  <a href="../LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-cost-meter.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
+  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
+</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>
+</p>
+
+<p align="center">
+  <a href="README.md"><b>🇬🇧 English</b></a> •
+  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
+  <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>
+
+---
+
+## ⚡ Обзор и решаемая проблема
+
+Разработка с помощью ИИ-агентов и генерация кода требуют активного потребления токенов (промпты, рассуждения, контекстный кэш). Без непрерывного финансового контроля разработчики рискуют столкнуться с перерасходом бюджета или упустить окна 50% скидок внепикового тарифа.
+
+**`@goodandready/dsh-cost-meter`** встраивает компактный высокоточный телеметрический чип прямо в заголовок диалога DeepSeek Harness (`conversation.session.header.utilities`):
+
+```text
+● ≈ ₽8.55  0:17     ← Чип стоимости сессии в шапке с обратным отсчётом тарифа
+```
+
+По клику открывается интерактивная панель: тарифная сетка за 1M токенов (не-пик / пик с подсветкой активного режима), статус окон в UTC и детальная разбивка расходов текущей сессии по моделям.
+
+---
+
+## 🏛️ Архитектура
+
+```mermaid
+graph TD
+    subgraph StreamTelemetry ["Рантайм DeepSeek Harness"]
+        Req["Запрос LLM / Заголовок<br/>(provider, model)"]
+        StreamHook["Потоковые инкрементальные чанки"]
+        Proj["Проекция costByModel<br/>(30-минутные слоты UTC)"]
+    end
+
+    subgraph PricingCatalog ["Движок тарификации"]
+        Manual["Пользовательские цены<br/>(settings.yaml: prices)"]
+        DeepSeekTier["Сетка DeepSeek<br/>(Пик / 50% скидка не-пик)"]
+        OpenRouterTier["Каталог OpenRouter<br/>(Ежедневный кэш)"]
+    end
+
+    subgraph UI ["Интерфейс пользователя"]
+        Chip["Чип стоимости в шапке<br/>(Тариф + таймер смены)"]
+        Modal["Модальное окно разбивки<br/>(Ставки за 1M, окна UTC, модели)"]
+        Settings["Карточка настроек<br/>(Валюта, курс USD, таймзона)"]
+    end
+
+    Req --> Proj
+    StreamHook --> Proj
+    Proj --> Chip
+    PricingCatalog --> Proj
+    Manual --> PricingCatalog
+    DeepSeekTier --> PricingCatalog
+    OpenRouterTier --> PricingCatalog
+    Chip --> Modal
+```
+
+---
+
+## ✨ Ключевые возможности
+
+1. **Живой расчёт во время стриминга**: расчёт стоимости инкрементально обновляется в реальном времени прямо во время генерации ответа.
+2. **Двухуровневая сетка тарифов**: официальные пиковые окна DeepSeek (01:00–04:00 и 06:00–10:00 UTC) со скидкой 50% во внепиковое время.
+3. **Иммутабельность получасовых слотов UTC**: исторические расходы сессии фиксируются по ставке слота и не пересчитываются задним числом при смене тарифа.
+4. **Provider-aware тарификация**: раздельный учёт для прямых подключений DeepSeek и шлюзов OpenRouter.
+5. **Гибкая настройка валюты**: поддержка пользовательских символов валют (`₽`, `$`, `€`, `¥`), курсов конвертации и таймзон.
+
+---
+
+## 📦 Установка
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-cost-meter
+```
+
+Перезапустите экземпляр DeepSeek Harness и обновите страницу в браузере.
+
+---
+
+## ⚙️ Таблица конфигурации (`settings.yaml`)
+
+```yaml
+dsh-cost-meter:
+  currency: "₽"
+  usdRate: 90.0
+  displayTimeZone: "Europe/Moscow"
+  useOpenRouter: true
+  prices: {}
+  modelMap: {}
+```
+
+### Параметры конфигурации
+
+| Параметр | Доступность | Тип | По умолчанию | Описание |
+|:---|:---|:---|:---|:---|
+| `currency` | GUI / `settings.yaml` | `string` | `"₽"` | Символ валюты в интерфейсе (например, `₽`, `$`, `€`) |
+| `usdRate` | GUI / `settings.yaml` | `number` | `80.0` | Курс обмена: единиц валюты за 1 USD |
+| `displayTimeZone` | GUI / `settings.yaml` | `string` | `"Europe/Moscow"` | IANA часовой пояс для отображения окон пика и не-пика |
+| `useOpenRouter` | GUI / `settings.yaml` | `boolean` | `true` | Загружать ли каталог тарифов и скидочных окон OpenRouter |
+| `refreshHours` | GUI / `settings.yaml` | `number` | `24` | Частота обновления каталога OpenRouter (в часах) |
+| `deepseekPeakPrices` | Только `settings.yaml` | `object` | `{}` | Переопределение встроенных пиковых ставок DeepSeek по id модели |
+| `prices` | Только `settings.yaml` | `object` | `{}` | Ручные ставки за 1M токенов `{ input, output, cacheHit?, cacheWrite? }` |
+| `modelMap` | Только `settings.yaml` | `object` | `{}` | Сопоставление маршрута `"provider/model"` на id в OpenRouter |
+| `manualPeakWindowsUtc` | Только `settings.yaml` | `array` | `[]` | Ручные окна пика HH:MM-HH:MM UTC для ручных ставок |
+| `manualOffPeakMultiplier` | Только `settings.yaml` | `number` | `1.0` | Коэффициент тарифа вне ручных окон пика |
+
+> **Интерфейс настроек (GUI) vs settings.yaml**: Основные параметры (`currency`, `usdRate`, `displayTimeZone`, `useOpenRouter`, `refreshHours`) настраиваются прямо в карточке интерфейса DSH (**Настройки → Плагины → Настройки плагинов → Cost Meter**). Расширенные структурированные правила сопоставления и ручных тарифов задаются через `settings.yaml` из-за сложной древовидной структуры.
+
+---
+
+## 🧪 Тестирование
+
+Запуск набора юнит-тестов:
+
+```bash
+npm test
+```
+
+---
+
+## 📄 Лицензия
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### Производительность и интеллектуальные подсказки (v0.8.1)
+- **Алгоритм O(K)**: Моментальный расчёт границ смены тарифов и мемоизация экстремумов без лишних циклов в браузере.
+- **Серверный кэш и ETag**: Поддержка заголовка `304 Not Modified` для маршрута `/state` и кэширование сопоставлений моделей.
+- **Ручная синхронизация**: Кнопка «Синхронизировать сейчас» в настройках с защитой от флуда (`POST /dsh-cost-meter/refresh`).
+- **Подсказки экономии и порог бюджета**: Отсчёт времени до льготного окна (скидка 50%), порог сессии (`budgetThreshold`) и экспорт сводки в буфер обмена.

package/README.zh.md

@@ -0,0 +1,144 @@
+# 📦 @goodandready/dsh-cost-meter
+
+<div align="center">
+
+<h3>面向 DeepSeek Harness 的会话实时花费计费芯片、波峰/波谷阶梯电价与 Token 监控插件</h3>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-cost-meter"><img src="https://img.shields.io/npm/v/@goodandready/dsh-cost-meter.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
+  <a href="../LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-cost-meter.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
+  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
+</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>
+</p>
+
+<p align="center">
+  <a href="README.md"><b>🇬🇧 English</b></a> •
+  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
+  <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>
+
+---
+
+## ⚡ 概述与核心痛点
+
+在使用智能体与大语言模型编程时，模型推理、长上下文以及缓存读写会产生大量 Token 消耗。如果缺乏实时的财务监控，开发者容易错过官方 50% 闲时折扣窗口，或因死循环导致账单超出预算。
+
+**`@goodandready/dsh-cost-meter`** 在 DeepSeek Harness 会话顶部工具栏（`conversation.session.header.utilities`）无缝嵌入高精度花费微件芯片：
+
+```text
+● ≈ ¥0.85  0:17     ← 会话顶部实时花费芯片与换价倒计时
+```
+
+点击芯片可展开交互式详情面板：按每 1M Token 展示峰谷两档费率表格（高亮显示当前激活档位）、UTC 优惠时间段状态以及各模型在当前会话中的累计消费明细。
+
+---
+
+## 🏛️ 架构设计
+
+```mermaid
+graph TD
+    subgraph StreamTelemetry ["DSH 流式遥测运行时"]
+        Req["LLM 请求 / 报头<br/>(provider, model)"]
+        StreamHook["增量流式分片 Hook"]
+        Proj["costByModel 会话投影<br/>(半小时 UTC 时隙)"]
+    end
+
+    subgraph PricingCatalog ["费率解析引擎"]
+        Manual["自定义费率配置<br/>(settings.yaml: prices)"]
+        DeepSeekTier["DeepSeek 官方费率<br/>(高峰 / 闲时 50% 折扣)"]
+        OpenRouterTier["OpenRouter 公开目录<br/>(每日自动缓存)"]
+    end
+
+    subgraph UI ["用户交互界面"]
+        Chip["顶部花费芯片<br/>(实时计费 + 换价倒计时)"]
+        Modal["消费明细抽屉面板<br/>(1M 单价表, UTC 时段, 模型清单)"]
+        Settings["设置卡片<br/>(币种符号, 汇率, 时区)"]
+    end
+
+    Req --> Proj
+    StreamHook --> Proj
+    Proj --> Chip
+    PricingCatalog --> Proj
+    Manual --> PricingCatalog
+    DeepSeekTier --> PricingCatalog
+    OpenRouterTier --> PricingCatalog
+    Chip --> Modal
+```
+
+---
+
+## ✨ 核心特性
+
+1. **增量流式实时计算**：在模型打字生成过程中毫秒级更新 Prompt、Completion 和 Cache 费用，无轮询无卡顿。
+2. **两级阶梯电价引擎**：支持 DeepSeek 官方高峰时段（UTC 01:00–04:00 与 06:00–10:00）及闲时 50% 优惠折扣自动匹配。
+3. **UTC 半小时时隙不可变性**：历史消费严格锁定在消耗发生时刻的时隙费率，切换费率不溯及既往。
+4. **服务商智能路由**：精准区分直连 DeepSeek 服务商与 OpenRouter 等代理网关。
+5. **多币种与本地化**：支持自定义货币符号（`¥`, `$`, `€`, `₽`）、汇率换算与显示时区。
+
+---
+
+## 📦 快速安装
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-cost-meter
+```
+
+重启 DeepSeek Harness 实例并刷新浏览器页面。
+
+---
+
+## ⚙️ 配置项说明 (`settings.yaml`)
+
+```yaml
+dsh-cost-meter:
+  currency: "¥"
+  usdRate: 7.2
+  displayTimeZone: "Asia/Shanghai"
+  useOpenRouter: true
+  prices: {}
+  modelMap: {}
+```
+
+### 配置参数列表
+
+| 参数项 | 类型 | 默认值 | 说明 |
+|:---|:---|:---|:---|
+| `currency` | `string` | `"¥"` | 显示的货币符号或代码 |
+| `usdRate` | `number` | `7.2` | 美元到目标货币的换算汇率 |
+| `displayTimeZone` | `string` | `"Asia/Shanghai"` | 界面中优惠时间段显示的参考时区 |
+| `useOpenRouter` | `boolean` | `true` | 是否加载 OpenRouter 价格表作为备用 |
+| `prices` | `object` | `{}` | 自定义每 1M Token 的费率覆盖 |
+| `modelMap` | `object` | `{}` | 模型别名映射表 |
+
+---
+
+## 🧪 自动化测试
+
+运行单元测试套件：
+
+```bash
+npm test
+```
+
+---
+
+## 📄 许可证
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/docs/README.ru.md

@@ -17,11 +17,21 @@
 </p>
 
 <p align="center">
-  <a href="../README.md"><b>🇬🇧 English</b></a> •
+  <a href="README.md"><b>🇬🇧 English</b></a> •
   <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
   <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>
 
 ---
@@ -138,3 +148,15 @@ npm test
 ## 📄 Лицензия
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### Производительность и интеллектуальные подсказки (v0.8.1)
+- **Алгоритм O(K)**: Моментальный расчёт границ смены тарифов и мемоизация экстремумов без лишних циклов в браузере.
+- **Серверный кэш и ETag**: Поддержка заголовка `304 Not Modified` для маршрута `/state` и кэширование сопоставлений моделей.
+- **Ручная синхронизация**: Кнопка «Синхронизировать сейчас» в настройках с защитой от флуда (`POST /dsh-cost-meter/refresh`).
+- **Подсказки экономии и порог бюджета**: Отсчёт времени до льготного окна (скидка 50%), порог сессии (`budgetThreshold`) и экспорт сводки в буфер обмена.
+
+### Визуальные улучшения и языковой стандарт (v0.8.2)
+- **Нативный точечный индикатор**: В шапке используется аккуратная статусная точка (зелёная — скидка 50%, янтарная — пик, красная пульсирующая — превышен бюджет).
+- **Строка экономии кэша**: Отображение сэкономленных средств за счёт кэша контекста (например: `Кэш сэкономил: ≈ $0.14 (-68%)`).
+- **Компактный список моделей**: Аккордеон со сворачиванием списка при использовании 3+ моделей в сессии.
+- **Стандарт локализации DSH**: Встроенные словари `en` и `zh`. Русский язык предоставляется через `dsh-russian-lang`.

package/docs/README.zh.md

@@ -17,11 +17,21 @@
 </p>
 
 <p align="center">
-  <a href="../README.md"><b>🇬🇧 English</b></a> •
+  <a href="README.md"><b>🇬🇧 English</b></a> •
   <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
   <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>
 
 ---
@@ -132,3 +142,9 @@ npm test
 ## 📄 许可证
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### 界面优化与语言规范 (v0.8.2)
+- **原生状态圆点指示器**：顶部芯片采用更精简的原生状态圆点（绿色代表低谷优惠，琥珀色代表高峰，红色脉冲代表超出预算上限，灰色代表平价/空闲）。
+- **上下文缓存节省提示**：自动计算并高亮显示命中提示词缓存所节省的费用（例如：`上下文缓存节省：≈ $0.14 (-68%)`）。
+- **多模型折叠列表**：当单次会话中使用 3 个或更多模型时，提供紧凑的可折叠模型明细展示。
+- **DSH 规范双语支持**：插件内置完整的英文（`en`）与中文（`zh`）语言字典。

package/docs/design/DESIGN.md

@@ -86,6 +86,21 @@
   - Не допускать утечек локальных путей и инфраструктурных данных в коде или документации.
 
 ## History & Decisions
+- 2026-09-13 (v0.8.2):
+  - Приведение к стандарту локализации DSH (dsh-plugin-authoring): английский (en) — исходный и fallback-язык, китайский (zh) — обязательная пользовательская локаль. Русский словарь вынесен из плагина; все строки для русского интерфейса переданы в goodandready/dsh-russian-lang.
+  - Нативный точечный dot-индикатор статуса чипа в шапке (.dcm-dot): зеленый (off-peak), янтарный (peak), красный пульсирующий (budget exceeded), серый (idle/unknown).
+  - Адаптивное скрытие таймера чипа на экранах < 680px при сохранении суммы расхода.
+  - Расчёт и отображение выгоды от контекстного кэша (Cache Savings): строка 'Cache saved: ≈ $X.XX (-Y%)' при наличии cacheReadTokens.
+  - Компактный список моделей с аккордеоном при 3+ задействованных моделях сессии.
+- 2026-09-12 (v0.8.1):
+  - Оптимизация производительности расчёта тарифов: замена 1440-минутного цикла на алгоритм O(K) по точкам перехода и мемоизация экстремумов через WeakMap.
+  - Серверный кэш разрешения тарифов resolveTariffCache (Map) с автоматической очисткой при обновлении каталога.
+  - Поддержка ETag и ответа 304 Not Modified на эндпоинте /dsh-cost-meter/state.
+  - Кнопка ручной синхронизации каталога цен в секции OpenRouter с защитой от флуда (cooldown 30 сек).
+  - Интеллектуальные подсказки экономии: плашка скорого наступления льготного тарифа (скидка 50%) и отсчёт времени.
+  - Поддержка настраиваемого порога бюджета сессии (budgetThreshold) с предупреждающей подсветкой чипа.
+  - Кнопка быстрого копирования текстового отчёта о расходах в буфер обмена.
+  - Таблица нормализации алиасов вендоров (z-ai -> zai, deepseek-official -> deepseek, gemini -> google).
 - 2026-09-05 (v0.7.9):
   - Hotfix: исправлен ReferenceError (t is not defined) в объекте словаря ru (lib/client.js) (#15).
   - Добавлен автоматический тест на чистое исполнение фабрики client loader (`test/public-route.test.mjs`).

package/docs/plans/findings.md

@@ -1,13 +1,13 @@
-# Findings: Issue #23
+# Findings: Issue #27 (v0.8.2)
 
-## Архитектурные паттерны dsh-clinebot
-- Изолированный тег `<style id="dsh-cost-meter-unified-css" data-dsh-plugin="dsh-cost-meter">` с переменными `--dsw-alias-...`.
-- `createErrorBoundary()` защищает слоты от падений при сбоях рендеринга.
-- `refreshMirrorUntilVisible(ctx)` обеспечивает доступность зеркала настроек в `settingsScope`.
-- Бейджи статуса (`cb-badge-ok`, `cb-badge-warn`, `cb-badge-bad`) позволяют пользователю моментально оценить состояние плагина.
+## 1. Точечный индикатор статуса
+- Сплошной яркий фон чипа в тулбаре DSH перетягивает на себя внимание от основного чата.
+- Нативный паттерн DSH: нейтральный полупрозрачный фон с цветной точкой (dot indicator 6x6px) и моноширинным текстом `tabular-nums`.
 
-## Найденные баги в dsh-cost-meter
-1. Строка 427 `lib/index.js`: `catalog = { index: { byId: {}, bySuffix: {} }, fetchedAt: 0, error: null }` не содержала `byLowerId`. При обращении к `matchModel` до первой загрузки каталога вызывался `index.byLowerId[lower]`, что приводило к `TypeError`.
-2. `slotOf(event.time)`: при `undefined` возвращал `NaN`, повреждая ключи слотов в проекции.
-3. `fetch(CATALOG_URL)`: без таймаута мог блокировать цикл обновлений при сетевых лагах.
-4. `splitRoute`: отбрасывал модели без слэша.
+## 2. Экономия кэша (Cache Savings)
+- При использовании кэша провайдера (DeepSeek, Claude, Gemini) стоимость `cacheReadTokens` значительно ниже `uncachedInputTokens` (у DeepSeek: $0.014 vs $0.14-$0.44 за 1M токенов).
+- Разница между стоимостью токенов без кэша (`cacheReadTokens * inputRate`) и фактической стоимостью (`cacheReadTokens * cacheHitRate`) наглядно демонстрирует реальную экономию пользователя прямо в поповере.
+
+## 3. Стандарт локализации
+- По стандарту DSH (`dsh-plugin-authoring`, `dhs-plugin-release-workflow`), плагин обязан иметь `en` как канонический исходный и `zh` как обязательную локаль.
+- Русский перевод не зашивается в плагин, а поставляется через отдельный плагин `dsh-russian-lang`. Для синхронизации перевода открывается issue в репозитории `goodandready/dsh-russian-lang`.

package/docs/plans/progress.md

@@ -1,25 +1,12 @@
-<!-- id: issue-23-progress -->
-# Progress: Issue #23 — Стабилизация кода и редизайн UI по стандарту dsh-clinebot
+# Progress: Issue #27 (v0.8.2)
 
-- [x] Создана Issue #23 в Gitea
-- [x] Создан worktree `.worktrees/issue-23` на ветке `feat/stability-and-ui-clinebot`
-- [x] Инициализированы файлы планирования (`task_plan.md`, `findings.md`, `progress.md`)
-- [x] Применены серверные исправления (`lib/index.js`):
-  - [x] Инициализация `byLowerId` в начальном состоянии `catalog.index` (устранён крах холодного старта)
-  - [x] Защита `slotOf(timeMs)` от `NaN` при невалидных временных метках
-  - [x] Добавлен таймаут (15с) для внешних запросов к OpenRouter
-  - [x] Расширен `splitRoute` для поддержки моделей без слэша (`deepseek-chat`)
-  - [x] Экспорт `catalogModelsCount` в ответе `/dsh-cost-meter/state`
-- [x] Применён визуальный редизайн по стандарту `dsh-clinebot` (`lib/client.js`):
-  - [x] Внедрён `createErrorBoundary()` для защиты слотов от падений
-  - [x] Внедрён `refreshMirrorUntilVisible(ctx)` для синхронизации настроек
-  - [x] Внедрена нативная CSS-система дизайн-токенов (`--dsw-alias-*`)
-  - [x] Шапка карточки снабжена бейджами статуса каталога, тарифа и таймзоны
-  - [x] Настройки структурированы по 3 секциям (`Основные параметры`, `Каталог OpenRouter`, `Диагностика`)
-  - [x] Модернизирован поповер шапки сессии
-- [x] Обновлена документация (`DESIGN.md`, `README.md`, `docs/README.ru.md`)
-- [x] Поднята версия до `0.7.10` в `package.json`
-- [x] Написаны и успешно пройдены 16 тестов в `test/stability-and-visual.test.mjs` (`npm test` 16/16 pass)
-- [ ] Оформление коммита, push ветки и создание PR #24
-- [ ] Merge PR в `main` и сборка тарбола
-- [ ] Тестирование на проде, публикация релиза v0.7.10 и закрытие Issue #23
+- **2026-09-13 15:06**:
+  - Создана Gitea Issue #27.
+  - Развернут worktree `.worktrees/issue-27` на ветке `feat/issue-27-ui-and-locales`.
+  - Зафиксированы планы и стандарты в `docs/plans/`.
+
+- **2026-09-13 15:08**:
+  - Реализованы улучшения в `lib/client.js` (dot status indicator, cache savings display, multi-model accordion, en/zh locales).
+  - Добавлены тесты в `test/v082-ui-locales.test.mjs` (все 22 теста успешно пройдены).
+  - Версия обновлена до `0.8.2`.
+  - Документация актуализирована на en, zh, ru.

package/docs/plans/task_plan.md

@@ -1,25 +1,31 @@
-# Task Plan: Issue #23 — Стабилизация кода и редизайн UI карточки настроек по стандарту dsh-clinebot
+# Task Plan: Issue #27 (v0.8.2) — Визуальная индикация шапки/поповера и стандарт локализации en/zh
 
-## Цель
-Устранить дефекты стабильности (холодный старт, event.time, таймаут OpenRouter, модели без слэша) и обновить UI плагина до единого стандарта dsh-clinebot (ErrorBoundary, дизайн-токены, бейджи, секции, адаптивная сетка, поповер).
+## Цели
+1. **Визуальные улучшения шапки и поповера**:
+   - Чип в шапке: точечный dot-индикатор (зеленый/янтарный/красный/серый) вместо сплошного фона, аккуратная интеграция с тулбаром DSH.
+   - Адаптивное скрытие таймера на узких экранах, сохранение суммы.
+   - Индикация экономии контекстного кэша (Cache Savings): строка `Cache saved: ≈ $X.XX (-Y%)`.
+   - Компактный список/аккордеон при нескольких моделях сессии (3+ модели).
+   - Точные нативные токены тем DSH.
+2. **Стандарт локализации DSH**:
+   - Исходный и fallback язык: `en`.
+   - Обязательная локаль: `zh` (полный набор эквивалентных ключей).
+   - Исключение зашитого `ru` словаря из плагина.
+   - Создание Issue в `goodandready/dsh-russian-lang` со всеми строками для русского перевода.
+3. **Документация и релиз**:
+   - Версия `0.8.2` (инкремент только `z`).
+   - Актуализация `docs/design/DESIGN.md`, `README.md` (en), `docs/README.zh.md` (zh), `docs/README.ru.md` (ru).
+   - 100% покрытие unit-тестами без внешних зависимостей.
+   - Валидация на test server (`:3082`) и на production (`:3080`).
+   - Запрос подтверждения -> публикация v0.8.2.
 
-## Задачи
-- [ ] 1. Исправление серверной части (`lib/index.js`):
-  - [ ] Инициализация `byLowerId` в начальном состоянии каталога
-  - [ ] Валидация `timeMs` в `slotOf(timeMs)`
-  - [ ] Добавление таймаута (15с) для запросов к `openrouter.ai`
-  - [ ] Поддержка моделей без префикса в `splitRoute`
-  - [ ] Экспорт диагностических метаданных (`catalogModelsCount`, `fetchedAt`, `error`) в `/dsh-cost-meter/state`
-- [ ] 2. Обновление клиентской части (`lib/client.js`):
-  - [ ] Внедрение `createErrorBoundary()` и обёртка карточки и поповера
-  - [ ] Внедрение `refreshMirrorUntilVisible(ctx)`
-  - [ ] Единая CSS-система дизайн-токенов (`.dcm-section-card`, `.dcm-badge`, `.dcm-grid-2`, `.dcm-btn`, `.dcm-alert-*`)
-  - [ ] Структурирование настроек по 3 логическим секциям с бейджами статуса в шапке
-  - [ ] Модернизация поповера шапки на классы дизайн-системы
-  - [ ] Локализация новых ключей (`ru`, `en`)
-- [ ] 3. Обновление документации:
-  - [ ] Актуализация `docs/design/DESIGN.md`, `README.md`, `docs/README.ru.md`
-- [ ] 4. Тестирование:
-  - [ ] Написание юнит-тестов `test/stability-and-visual.test.mjs`
-  - [ ] Прогон всех тестов (`npm test`)
-- [ ] 5. Сборка, PR, релиз v0.7.10, верификация на MiniAI и закрытие Issue #23
+## Статус выполнения
+- [x] Issue #27 создана
+- [x] Worktree `.worktrees/issue-27` развернут
+- [x] Реализация `lib/client.js` (UI шапки/поповера, расчет cache savings, словари en/zh)
+- [x] Обновление тестов в `test/`
+- [x] Обновление документации (`DESIGN.md`, `README.md`, `README.zh.md`, `README.ru.md`)
+- [ ] Регистрация Issue в `goodandready/dsh-russian-lang`
+- [ ] Сборка и приёмка кандидата (:3082, :3080)
+- [ ] Публикация релиза v0.8.2
+- [ ] Закрытие Issue #27 и cleanup worktree