@goodandready/dsh-cost-meter 0.8.2 → 0.8.4

package/lib/updater.js

@@ -0,0 +1,270 @@
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { basename, dirname, isAbsolute, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const UPDATE_HEADER = 'x-dsh-plugin-update'
+const UPDATE_TIMEOUT_MS = 10 * 60_000
+const VERSION_CACHE_MS = 5 * 60_000
+let latestCache = undefined
+
+function header(request, name) {
+  const value = request?.headers?.[name]
+  return Array.isArray(value) ? value[0] : value
+}
+
+function isLoopback(value) {
+  const address = value?.toLowerCase().replace(/^\[|\]$/g, '')
+  return address === 'localhost' || address === 'localhost.' || address === '::1'
+    || address?.startsWith('127.') === true
+    || address?.startsWith('::ffff:127.') === true
+}
+
+export function isTrustedUpdateRequest(request) {
+  if (header(request, UPDATE_HEADER) !== '1') return false
+  if (!isLoopback(request?.socket?.remoteAddress)) return false
+  const site = header(request, 'sec-fetch-site')
+  if (site !== undefined && site !== 'same-origin') return false
+  const origin = header(request, 'origin')
+  const host = header(request, 'host')
+  if (origin === undefined || host === undefined) return false
+  try {
+    const url = new URL(origin)
+    return (url.protocol === 'http:' || url.protocol === 'https:')
+      && isLoopback(url.hostname) && url.host === host
+  } catch (e) {
+    return false
+  }
+}
+
+function validProfileName(value) {
+  return typeof value === 'string' && value !== '' && value !== '.' && value !== '..'
+    && !value.includes('/') && !value.includes('\\') && !/[\0-\x1f\x7f]/.test(value)
+}
+
+function profileNameFromArgv(argv) {
+  if (!Array.isArray(argv)) return undefined
+  for (let index = 2; index < argv.length; index += 1) {
+    if (argv[index] === '--profile') return argv[index + 1]
+    if (argv[index]?.startsWith('--profile=')) return argv[index].slice('--profile='.length)
+  }
+  return argv[2] === 'web' ? 'web' : undefined
+}
+
+function findDshCliEntry() {
+  const value = process.argv[1]
+  if (typeof value !== 'string' || value.length === 0) return undefined
+  const entry = value.startsWith('file:') ? fileURLToPath(value) : resolve(process.cwd(), value)
+  if (!existsSync(entry)) return undefined
+  for (let directory = dirname(entry); ; directory = dirname(directory)) {
+    const manifestPath = resolve(directory, 'package.json')
+    if (existsSync(manifestPath)) {
+      try {
+        const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
+        const bin = typeof manifest.bin === 'string'
+          ? manifest.bin
+          : typeof manifest.bin === 'object' && manifest.bin !== null
+            ? manifest.bin.dsh
+            : undefined
+        if (manifest.name === '@deepseek-ai/dsh' && typeof bin === 'string'
+          && !isAbsolute(bin) && resolve(directory, bin) === resolve(entry)) return entry
+      } catch (e) {
+        /* continue */
+      }
+    }
+    const parent = dirname(directory)
+    if (parent === directory) return undefined
+  }
+}
+
+function detectRuntime() {
+  const profileDir = resolve(process.env.DSH_PROFILE_DIR
+    ?? resolve(homedir(), '.dsh', 'profiles', 'web'))
+  const selected = profileNameFromArgv(process.argv)
+  const profileName = validProfileName(selected)
+    ? selected
+    : validProfileName(basename(profileDir)) ? basename(profileDir) : 'web'
+  const cliEntry = findDshCliEntry()
+  return cliEntry === undefined ? { profileName, profileDir } : { profileName, profileDir, cliEntry }
+}
+
+function parseSemver(value) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(String(value || ''))
+  if (match === null) return undefined
+  return {
+    core: [Number(match[1]), Number(match[2]), Number(match[3])],
+    prerelease: match[4]?.split('.') ?? [],
+  }
+}
+
+function comparePrerelease(candidateParts, currentParts) {
+  if (candidateParts.length === 0 && currentParts.length > 0) return 1
+  if (candidateParts.length > 0 && currentParts.length === 0) return -1
+  if (candidateParts.length === 0 && currentParts.length === 0) return 0
+
+  const len = Math.max(candidateParts.length, currentParts.length)
+  for (let i = 0; i < len; i += 1) {
+    const a = candidateParts[i]
+    const b = currentParts[i]
+    if (a === undefined) return -1
+    if (b === undefined) return 1
+    if (a === b) continue
+
+    const aNum = /^\d+$/.test(a) ? Number(a) : undefined
+    const bNum = /^\d+$/.test(b) ? Number(b) : undefined
+
+    if (aNum !== undefined && bNum !== undefined) {
+      return aNum > bNum ? 1 : -1
+    }
+    if (aNum !== undefined && bNum === undefined) {
+      return -1
+    }
+    if (aNum === undefined && bNum !== undefined) {
+      return 1
+    }
+    return a.localeCompare(b) > 0 ? 1 : -1
+  }
+  return 0
+}
+
+export function isNewerVersion(currentValue, candidateValue) {
+  const current = parseSemver(currentValue)
+  const candidate = parseSemver(candidateValue)
+  if (current === undefined || candidate === undefined) return false
+  for (let index = 0; index < 3; index += 1) {
+    if (candidate.core[index] !== current.core[index]) return candidate.core[index] > current.core[index]
+  }
+  return comparePrerelease(candidate.prerelease, current.prerelease) > 0
+}
+
+async function fetchLatestVersion(packageName, registry) {
+  if (latestCache?.packageName === packageName && latestCache.registry === registry && Date.now() < latestCache.expiresAt) {
+    return latestCache.version
+  }
+  try {
+    const reg = registry.replace(/\/+$/, '')
+    const response = await fetch(`${reg}/${encodeURIComponent(packageName)}/latest`, {
+      signal: AbortSignal.timeout(6000),
+    })
+    if (!response.ok) return undefined
+    const value = await response.json()
+    if (typeof value?.version !== 'string' || !value.version) return undefined
+    latestCache = { packageName, registry, version: value.version, expiresAt: Date.now() + VERSION_CACHE_MS }
+    return value.version
+  } catch (e) {
+    return undefined
+  }
+}
+
+async function readCurrentVersion(manifestUrl) {
+  const value = JSON.parse(await readFile(manifestUrl, 'utf8'))
+  if (typeof value?.version !== 'string' || !value.version) throw new Error('Cannot read current plugin version.')
+  return value.version
+}
+
+export async function checkUpdateStatus(options, target = detectRuntime()) {
+  const current = await readCurrentVersion(options.manifestUrl)
+  const latest = await fetchLatestVersion(options.packageName, options.registry || 'https://registry.npmjs.org')
+  return {
+    packageName: options.packageName,
+    currentVersion: current,
+    ...(latest === undefined ? {} : { latestVersion: latest }),
+    latestCheckFailed: latest === undefined,
+    updateAvailable: latest !== undefined && isNewerVersion(current, latest),
+    profileName: target.profileName,
+    canAutoUpdate: target.cliEntry !== undefined,
+  }
+}
+
+async function installExact(target, packageSpec, options) {
+  if (target.cliEntry === undefined) throw new Error('Automatic update is unavailable in this runtime.')
+  await new Promise((resolvePromise, reject) => {
+    const child = spawn(process.execPath, [
+      target.cliEntry, 'plugin', '--profile', target.profileName, 'add',
+      packageSpec,
+      `--registry=${options.registry || 'https://registry.npmjs.org/'}`,
+    ], {
+      cwd: target.profileDir,
+      windowsHide: true,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: { ...process.env, NO_COLOR: '1' },
+    })
+    let detail = ''
+    child.stdout?.on('data', (chunk) => { detail = (detail + String(chunk)).slice(-4000) })
+    child.stderr?.on('data', (chunk) => { detail = (detail + String(chunk)).slice(-4000) })
+    const timer = setTimeout(() => {
+      child.kill()
+      reject(new Error('Update timed out.'))
+    }, UPDATE_TIMEOUT_MS)
+    child.once('error', (error) => { clearTimeout(timer); reject(error) })
+    child.once('exit', (code) => {
+      clearTimeout(timer)
+      if (code === 0) resolvePromise()
+      else reject(new Error(detail.trim() || `Update exited with code ${String(code)}.`))
+    })
+  })
+}
+
+function writeResponseJson(response, statusCode, value) {
+  response.writeHead(statusCode, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+  })
+  response.end(JSON.stringify(value))
+}
+
+export function registerPluginUpdater(ctx, options) {
+  if (!ctx?.webServer?.register) return () => {}
+  let installing = false
+  return ctx.webServer.register({
+    kind: 'exact',
+    path: options.endpoint,
+    handler: async (request, response) => {
+      try {
+        const target = detectRuntime()
+        if (request.method === 'GET' || request.method === 'HEAD') {
+          const payload = await checkUpdateStatus(options, target)
+          writeResponseJson(response, 200, payload)
+          return
+        }
+        if (request.method !== 'POST') {
+          response.writeHead(405, { allow: 'GET, HEAD, POST' })
+          response.end()
+          return
+        }
+        if (!isTrustedUpdateRequest(request)) {
+          writeResponseJson(response, 403, { ok: false, error: 'Rejected non-local or cross-origin update request.' })
+          return
+        }
+        if (installing) {
+          writeResponseJson(response, 409, { ok: false, error: 'This plugin is already updating.' })
+          return
+        }
+        installing = true
+        try {
+          const before = await checkUpdateStatus(options, target)
+          if (before.latestVersion === undefined) {
+            writeResponseJson(response, 503, { ok: false, error: 'The latest version is temporarily unavailable.' })
+            return
+          }
+          if (!before.updateAvailable) {
+            writeResponseJson(response, 200, before)
+            return
+          }
+          await installExact(target, `${options.packageName}@${before.latestVersion}`, options)
+          writeResponseJson(response, 200, {
+            ...before,
+            updatedVersion: before.latestVersion,
+            restartRequired: true,
+          })
+        } finally {
+          installing = false
+        }
+      } catch (error) {
+        writeResponseJson(response, 500, { ok: false, error: String(error?.message || error) })
+      }
+    },
+  })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-cost-meter",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "DeepSeek Harness plugin: a session cost chip in the conversation header - live token usage by bucket, peak/off-peak tariff, and a countdown to the next tariff switch.",
   "type": "module",
   "main": "lib/index.js",
@@ -11,10 +11,11 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "lib",
+    "lib/",
     "cordis.patch.yml",
     "README.md",
-    "docs",
+    "README.ru.md",
+    "README.zh.md",
     "LICENSE"
   ],
   "publishConfig": {
@@ -26,7 +27,9 @@
     },
     "client": {
       "platform": "web",
-      "inject": []
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
     }
   },
   "keywords": [

package/docs/README.ru.md

@@ -1,162 +0,0 @@
-# 📦 @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`) и экспорт сводки в буфер обмена.
-
-### Визуальные улучшения и языковой стандарт (v0.8.2)
-- **Нативный точечный индикатор**: В шапке используется аккуратная статусная точка (зелёная — скидка 50%, янтарная — пик, красная пульсирующая — превышен бюджет).
-- **Строка экономии кэша**: Отображение сэкономленных средств за счёт кэша контекста (например: `Кэш сэкономил: ≈ $0.14 (-68%)`).
-- **Компактный список моделей**: Аккордеон со сворачиванием списка при использовании 3+ моделей в сессии.
-- **Стандарт локализации DSH**: Встроенные словари `en` и `zh`. Русский язык предоставляется через `dsh-russian-lang`.

package/docs/README.zh.md

@@ -1,150 +0,0 @@
-# 📦 @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)
-
-### 界面优化与语言规范 (v0.8.2)
-- **原生状态圆点指示器**：顶部芯片采用更精简的原生状态圆点（绿色代表低谷优惠，琥珀色代表高峰，红色脉冲代表超出预算上限，灰色代表平价/空闲）。
-- **上下文缓存节省提示**：自动计算并高亮显示命中提示词缓存所节省的费用（例如：`上下文缓存节省：≈ $0.14 (-68%)`）。
-- **多模型折叠列表**：当单次会话中使用 3 个或更多模型时，提供紧凑的可折叠模型明细展示。
-- **DSH 规范双语支持**：插件内置完整的英文（`en`）与中文（`zh`）语言字典。

package/docs/deployment/public-release.md

@@ -1,9 +0,0 @@
-# Публичный релиз и deployment
-
-Релизная версия повышается patch-изменением (v0.7.6). После merge в `main`
-создаются annotated tag, пакет в npm (`@goodandready/dsh-cost-meter`) и
-публичный GitHub release в `GooDAnDReaDY/dsh-cost-meter`.
-
-Production должен содержать exact package version из npm и не должен иметь
-локальной зависимости на исходный checkout. После restart проверяются
-service health, browser loader и `GET /dsh-cost-meter/state`.