@goodandready/dsh-ollama-cloud-provider 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.4 — 2026-10-21
+
+- Model list rows now use the reference three-column grid: badges live inside
+  the name cell, so rows no longer stretch, wrap into empty gaps or truncate the
+  model id to a single character (#20).
+- The sidebar quota card uses the reference 16px ring and no longer appends the
+  internal `default` account label. An optional `planLabel` (for example `PRO`)
+  can be shown next to the provider name instead (#21).
+
+## 0.1.3 — 2026-10-21
+
+- Aligned README documentation trio with dsh-documentation-standard: added standardized Hero headers, goodandready.app hub badges, support tables, and Mermaid architecture diagrams across English, Russian, and Chinese documentations.
+- Updated installation instructions and package version parity.
+
 ## 0.1.2 — 2026-10-21
 
 - Test connection falls back to the reasoning text when a thinking model returns

package/README.md

@@ -5,11 +5,23 @@
 <h3>Ollama Cloud LLM Provider for DeepSeek Harness</h3>
 
 <p>
+  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/🌐_DSH_Hub-goodandready.app-ff4500.svg?style=for-the-badge&labelColor=1a1a2e" alt="GoodAndReady Showcase"></a>
   <a href="https://www.npmjs.com/package/@goodandready/dsh-ollama-cloud-provider"><img src="https://img.shields.io/npm/v/@goodandready/dsh-ollama-cloud-provider?style=for-the-badge&color=crimson&logo=npm" alt="npm version"></a>
+  <a href="https://github.com/GooDAnDReaDY/dsh-ollama-cloud-provider/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="License"></a>
 </p>
 
 </div>
 
+<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>
+
 ---
 
 Ollama Cloud provider plugin for [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) (dsh).
@@ -72,7 +84,7 @@ graph LR
 - **Price estimates** from the published Ollama pricing table, including off-peak rates, with per-model overrides.
 - **Browser UI**:
   - **Settings → Ollama Cloud**: key, balance, accounts, rules, model allowlist, per-model transport, connection settings.
-  - **Sidebar quota card** (off by default, and it does not poll `/state` while disabled): a ring with the highest used window and rows with remaining credits or legacy windows.
+  - **Sidebar quota card** (off by default, and it does not poll `/state` while disabled): a ring with the highest used window and rows with remaining credits or legacy windows; an optional `planLabel` is shown next to the provider name.
   - **Center quota panel**: spend windows, spend by model, accounts, routing trace, usage analytics and a request heatmap.
 - **`/ollama` command** for status, usage, balance, accounts, models, rules and `test [model]`.
 - **TUI settings section** for terminal profiles.
@@ -88,12 +100,20 @@ npm run build
 npm pack
 ```
 
-Install the packed tarball into a profile:
+Install the published package:
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.4
+# DSH Desktop:
+dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.4
+```
+
+Or install the packed tarball into a profile:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.0.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.4.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.0.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.4.tgz
 ```
 
 Restart dsh (or DSH Desktop), then pick **Ollama Cloud** in the model picker.
@@ -114,7 +134,7 @@ Restart dsh (or DSH Desktop), then pick **Ollama Cloud** in the model picker.
     streamIdleTimeoutMs: 300000
     visibleModels: []
     modelTransports: {}
-    # contextWindowOverrides: { "gpt-oss:120b": 131072 }
+    # contextWindowOverrides: { "model-id": 131072 }
     # maxOutputTokens: 32768
     accounts:
       - label: Work
@@ -122,6 +142,7 @@ Restart dsh (or DSH Desktop), then pick **Ollama Cloud** in the model picker.
     activeAccount: ''              # label or credential name to pin
     stickySession: true
     showSidebarQuota: false
+    planLabel: ''                  # optional, e.g. PRO
 ```
 
 Every field except `apiKey` is volatile and appears in dsh settings.
@@ -170,7 +191,7 @@ Open **Settings → Ollama Cloud**:
 - **Routing** — sticky session per conversation.
 - **Models** — search, refresh the live catalog, hide models, override the wire transport per model, see price, context and capabilities.
 - **Connection** — native and OpenAI bases, usage and balance endpoints, transport, timeouts, output cap and context override.
-- **Sidebar** — show or hide the quota card.
+- **Sidebar** — show or hide the quota card, and an optional plan label (for example `PRO`) shown next to the provider name.
 - **Plugin update** — current/latest version and **Update now**.
 
 The Host serves `/dsh-ollama/state`, `/health`, `/analytics`, `/usage`, `/balance`, `/config`, `/key`, `/key/clear`, `/refresh`, `/models/refresh`, `/test` and `/update`. Writes require JSON, are refused for cross-origin requests, and are restricted to loopback (`127.0.0.1` / `::1`).
@@ -184,7 +205,7 @@ The Host serves `/dsh-ollama/state`, `/health`, `/analytics`, `/usage`, `/balanc
 /ollama accounts          # labels, source, active/cooling, 7-day spend
 /ollama models            # ids, price, context, capabilities
 /ollama rules             # model → account rules
-/ollama test [model]      # minimal real request, default gpt-oss:120b
+/ollama test [model]      # minimal real request
 ```
 
 ## Verified API facts
@@ -213,8 +234,7 @@ node scripts/probe.mjs
 
 ## Visual verification
 
-The Ollama Cloud settings page in DSH Desktop (dark theme): configured
-credential, balance and usage, and the connection probe.
+The Ollama Cloud settings page in DSH Desktop (dark theme): configured credential, balance and usage, and the connection probe.
 
 ![Ollama Cloud settings](media/visual-verification.png)
 

package/README.ru.md

@@ -1,76 +1,162 @@
 # 📦 @goodandready/dsh-ollama-cloud-provider
 
-Провайдер **Ollama Cloud** для DeepSeek Harness (dsh).
+<div align="center">
 
-Плагин регистрирует один маршрут `ollama-cloud` (`https://ollama.com`) и два протокола:
+<h3>Плагин-провайдер Ollama Cloud для DeepSeek Harness</h3>
 
-| Транспорт | Endpoint | Когда используется |
-|---|---|---|
-| `native` (по умолчанию) | `POST /api/chat` | thinking, вызовы инструментов, счётчики usage |
-| `openai-chat` | `POST /v1/chat/completions` | OpenAI-совместимые развёртывания и запасной путь |
+<p>
+  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/🌐_DSH_Hub-goodandready.app-ff4500.svg?style=for-the-badge&labelColor=1a1a2e" alt="Витрина GoodAndReady"></a>
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-ollama-cloud-provider"><img src="https://img.shields.io/npm/v/@goodandready/dsh-ollama-cloud-provider?style=for-the-badge&color=crimson&logo=npm" alt="npm версия"></a>
+  <a href="https://github.com/GooDAnDReaDY/dsh-ollama-cloud-provider/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="Лицензия"></a>
+</p>
+
+</div>
+
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему Star на GitHub</strong> — это покажет мне, что плагин полезен, и добавит мотивации продолжать его развитие.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новую функцию</strong>, создайте Issue на GitHub на любом языке — я рассмотрю предложение и реализую полезные улучшения в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
+---
 
-Ключ разрешается на каждый запрос, поэтому смена credential применяется без перезапуска.
+Плагин-провайдер **Ollama Cloud** для [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) (dsh).
 
-## Возможности
+Плагин регистрирует один нативный LLM-маршрут `ollama-cloud` (`https://ollama.com`) и поддерживает два протокола передачи данных:
+
+| Транспорт | Эндпоинт | Назначение |
+|---|---|---|
+| `native` (по умолчанию) | `POST /api/chat` | thinking, вызовы инструментов (tool calls), счётчики usage (NDJSON) |
+| `openai-chat` | `POST /v1/chat/completions` | Совместимость с OpenAI API и резервный транспорт (SSE) |
+
+Ключи разрешаются динамически на каждый вызов: смена credential применяется мгновенно без перезапуска сервера.
+
+## Архитектура
+
+```mermaid
+graph LR
+    subgraph DSH["Ядро DeepSeek Harness"]
+        Agent["DSH Агент / Чат"]
+        Creds["Сервис учетных данных / окружение"]
+    end
+
+    subgraph Plugin["dsh-ollama-cloud-provider"]
+        Router{"Маршрут: ollama-cloud"}
+        Pool["Пул аккаунтов<br/>ротация, cooldown, sticky"]
+        Catalog["Живой каталог<br/>/v1/models + /api/tags"]
+        Usage["Баланс и расход<br/>/api/balance + /api/usage"]
+
+        subgraph Transports["Протоколы передачи"]
+            T1["Native /api/chat (NDJSON)"]
+            T2["OpenAI /v1/chat/completions (SSE)"]
+        end
+    end
+
+    subgraph Ollama["Ollama Cloud"]
+        Chat["ollama.com/api/chat"]
+        OpenAI["ollama.com/v1/chat/completions"]
+        Billing["/api/balance, /api/usage"]
+    end
+
+    Agent --> Router
+    Creds -.-> Pool
+    Router --> Pool
+    Pool --> Transports
+    T1 --> Chat
+    T2 --> OpenAI
+    Catalog --> Router
+    Usage --> Billing
+```
 
-- Два транспорта, выбираемые по модели.
-- Текст, reasoning/thinking, tool calls, изображения, usage и finish reasons.
-- Живой каталог из `GET /v1/models`, дополненный `capabilities` из `GET /api/tags`.
-- Точные метаданные для picker: контекст, модальности, уровни reasoning и уровень по умолчанию, поддержка инструментов, видимость в API.
-- Баланс и расход из официальных `/api/balance` и `/api/usage`: включённые и купленные кредиты, расход за 24 часа / 7 дней / 30 дней, расход по моделям.
-- Мультиаккаунт с ротацией **до первого токена** на 401/403/429 и исчерпанную квоту; cooldown'ы сохраняются между перезапусками.
-- Липкий аккаунт на диалог и правила `модель → аккаунт` по glob.
-- Оценка стоимости по published-тарифу Ollama, включая off-peak, с ручными overrides.
-- UI: страница **Настройки → Ollama Cloud**, карточка квоты в сайдбаре (по умолчанию выключена и не опрашивает `/state`, пока выключена), панель с расходом, аналитикой и heatmap.
-- Команда `/ollama`, секция TUI и обновление плагина в один клик.
+## Полный обзор возможностей
+
+- **Два транспорта**, выбираемые индивидуально для каждой модели: нативный протокол Ollama API (NDJSON) и совместимый шлюз OpenAI (SSE).
+- **Поддержка всех режимов**: текст, reasoning/thinking, вызовы функций/инструментов, изображения (vision), подсчёт токенов и finish reasons на обоих транспортах.
+- **Живой каталог моделей**: автоматическое чтение `GET /v1/models`, дополненное флагами возможностей `capabilities` (`tools`, `thinking`, `vision`) из `GET /api/tags`.
+- **Точные лимиты и метаданные**: контекстное окно, входные модальности, уровни reasoning и значение по умолчанию, статус поддержки инструментов и видимость в API.
+- **Баланс и аналитика расхода**: интеграция с официальными облачными эндпоинтами `/api/balance` и `/api/usage` — включённые и купленные кредиты, расход за 24 часа / 7 дней / 30 дней, а также группировка по моделям.
+- **Пул аккаунтов с авто-ротацией до первого токена**: при получении 401, 403, 429 или ответа об исчерпании квоты ключ переводится в cooldown, а запрос автоматически перенаправляется на следующий доступный аккаунт. Состояния cooldown сохраняются между перезапусками по SHA-256 fingerprint.
+- **Sticky sessions**: закрепление одного аккаунта за конкретным диалогом, плюс гибкие правила `модель ➔ аккаунт` по glob-паттернам.
+- **Оценка стоимости**: тарификация по официальному прайс-листу Ollama Cloud, включая ночные скидки (off-peak rates) и возможность ручного переопределения цен на модель.
+- **Интерфейс в браузере (Web UI)**:
+  - **Настройки → Ollama Cloud**: управление ключами, отображение баланса, пул аккаунтов, правила маршрутизации, allowlist моделей, выбор транспорта.
+  - **Карточка квоты в сайдбаре**: кольцевой индикатор с наиболее загруженным окном и детализацией остатка кредитов (по умолчанию выключена и не нагружает сеть фоновыми опросами; рядом с названием можно показать `planLabel`, например `PRO`).
+  - **Центральная панель квот**: окна расходов, разбивка по моделям, трейс маршрутизации, аналитика токенов и интерактивный heatmap запросов.
+- **Команда `/ollama`**: статус провайдера, квоты, баланс, список аккаунтов, моделей, правил и запуск тестового запроса `test [model]`.
+- **Интеграция с терминалом (TUI)**: специальная секция настроек в терминальном режиме.
+- **One-Click обновление плагина**: прямая проверка npm registry и кнопка обновления в Web UI.
 
 ## Установка
 
+Сборка и упаковка из исходного кода:
+
 ```bash
 npm install
 npm run build
 npm pack
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.0.tgz
+```
+
+Установка опубликованного пакета из npm:
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.4
+# DSH Desktop:
+dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.4
+```
+
+Либо установка из упакованного tarball:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.4.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.0.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.4.tgz
 ```
 
-После установки перезапустите dsh и выберите **Ollama Cloud** в списке моделей.
+После установки перезапустите dsh (или DSH Desktop) и выберите **Ollama Cloud** в списке моделей.
 
-## Настройка
+## Конфигурация
 
 ```yaml
 - id: llm-ollama-cloud
   name: "@goodandready/dsh-ollama-cloud-provider"
   config:
-    apiKeyEnv: OLLAMA_API_KEY
-    transport: native            # native | openai-chat
+    apiKeyEnv: OLLAMA_API_KEY      # имя переменной или credential
+    # apiKey: ...                  # только в composition, не коммитить в git
+    transport: native              # native | openai-chat
     requestTimeoutMs: 300000
     streamIdleTimeoutMs: 300000
     visibleModels: []
+    modelTransports: {}
     accounts:
       - label: Work
         apiKeyEnv: OLLAMA_API_KEY_2
-    activeAccount: ''
+    activeAccount: ''              # метка для принудительного закрепления
     stickySession: true
     showSidebarQuota: false
+    planLabel: ''                  # необязательно, например PRO
 ```
 
-Все поля, кроме `apiKey`, доступны в настройках DSH.
+Все поля, кроме `apiKey`, доступны для изменения в интерфейсе настроек DSH.
 
-### Ключи
+### Получение и хранение ключей
 
-1. `config.apiKey` — только в composition, `role('secret')`.
-2. Credential-сервис по имени `apiKeyEnv` (по умолчанию `OLLAMA_API_KEY`).
-3. Переменные окружения запуска.
+1. `config.apiKey` в файле конфигурации (`role('secret')`).
+2. Системный сервис учетных данных DSH по имени `apiKeyEnv` (по умолчанию `OLLAMA_API_KEY`).
+3. Переменные окружения процесса, `.env` проекта или `$DSH_HOME/.env`.
 
-Ключ создаётся на <https://ollama.com/settings/keys>, не истекает. Принимается только `Authorization: Bearer`; `x-api-key` cloud отклоняет.
+Ключ создается в личном кабинете: <https://ollama.com/settings/keys>. Ключи бессрочные; облачный API принимает только заголовок `Authorization: Bearer`.
 
-### Аккаунты и ротация
+### Пул аккаунтов и ротация
 
-Дополнительный аккаунт добавляется в **Настройки → Ollama Cloud → Аккаунты**: имя + ссылка на credential (например `OLLAMA_API_KEY_2`), затем ключ и «Сохранить». Ротация происходит до стриминга: отклонённый ключ получает cooldown, запрос повторяется следующим ключом. Cooldown'ы лежат в `~/.dsh/storages/dsh-ollama/cooldowns.json` и хранятся по SHA-256 fingerprint — сырые ключи не пишутся.
+Дополнительный аккаунт добавляется в **Настройки → Ollama Cloud → Аккаунты**: укажите имя метки и credential reference (например, `OLLAMA_API_KEY_2`), вставьте токен и сохраните. Ротация происходит **строго до начала генерации потока**: отклонённый ключ получает cooldown, а запрос повторяется со следующим готовым аккаунтом.
 
-### Правила модель → аккаунт
+Состояния cooldown сохраняются в `~/.dsh/storages/dsh-ollama/cooldowns.json` по SHA-256 хешу ключа.
+
+### Правила привязки «модель ➔ аккаунт»
 
 ```yaml
 modelAccountRules:
@@ -78,53 +164,57 @@ modelAccountRules:
     account: "Work"
 ```
 
-Первый совпавший glob ставит аккаунт первым; остальные остаются fallback.
+Первый совпавший glob-паттерн направляет модель на указанный аккаунт, остальные аккаунты остаются в резерве.
 
-## Баланс и расход
+## Баланс и мониторинг расхода
 
-- `GET /api/balance` — новый формат (`included.balance_usd`, `allowance_usd`, `period`, `purchased.balance_usd`) и legacy-формат (`session` / `weekly` с `remaining_percent`). Поддерживаются оба.
-- `GET /api/usage?range=24h|7d|30d&group_by=model` — totals и группы по моделям.
+- `GET /api/balance` — поддерживает новый формат (`included.balance_usd`, `allowance_usd`, `period`, `purchased.balance_usd`) и legacy-формат (`session` / `weekly` с `remaining_percent`).
+- `GET /api/usage?range=24h|7d|30d&group_by=model` — суммарные показатели и разбивка по моделям.
 
-У `/api/usage` лимит **10 запросов в минуту на пользователя**, поэтому баланс кэшируется на 60 с, usage — на 120 с, ошибки — на 30 с. Фонового опроса нет. Недоступность квот не блокирует чат.
+Эндпоинт `/api/usage` ограничен лимитом в **10 запросов в минуту**, поэтому баланс кэшируется на 60 секунд, статистика расхода — на 120 секунд. Фоновых опросов нет; временная недоступность квот не прерывает работу чата.
 
-## Команда
+## Страница настроек Web UI
 
-```
-/ollama status
-/ollama usage
-/ollama balance
-/ollama accounts
-/ollama models
-/ollama rules
-/ollama test [model]
-```
+В разделе **Настройки → Ollama Cloud**:
+- **Key**: статус ключа, вставка, очистка, кнопка **Test connection**.
+- **Balance & Usage**: шкалы кредитов, окна расходов, предупреждения при 80% и 95%.
+- **Accounts**: управление пулом дополнительных учетных записей.
+- **Model rules**: настройка правил ротации по моделям.
+- **Models**: поиск, принудительное обновление каталога моделей, allowlist, переопределение транспорта.
+- **Connection**: базовые адреса, таймауты, лимиты токенов.
+- **Plugin update**: проверка обновлений и кнопка **Update now**.
 
-## Проверенные факты API (2026-10-21)
+## Визуальная верификация
+
+Настройки и баланс Ollama Cloud в интерфейсе DSH Desktop (темная тема):
 
-- `GET https://ollama.com/v1/models` публичный и, кроме стандартного `data[]`, отдаёт нестандартный `models[]` с контекстом, модальностями, уровнями reasoning, `visibility` и `supported_in_api`.
-- `GET https://ollama.com/api/tags` публичный и единственный источник `capabilities` по моделям.
-- Live-каталог вернул 23 облачные модели.
-- Нативный `/api/chat` — NDJSON, счётчики и `done_reason` в финальной строке.
-- OpenAI `/v1/chat/completions` поддерживает стриминг, tools, vision, `reasoning_effort` и `include_usage`.
-- Anthropic-совместимость (`/v1/messages`) частичная и плагином не используется.
+![Настройки Ollama Cloud](media/visual-verification.png)
 
-## Разработка
+## Команды CLI
 
 ```bash
-npm run typecheck
-npm test
-npm run build
-npm run check
-node scripts/probe.mjs
+/ollama status            # статус провайдера, квоты, модели
+/ollama usage             # окна расходов и статистика по моделям
+/ollama balance           # баланс кредитов
+/ollama accounts          # список аккаунтов и их расход
+/ollama models            # каталог моделей и параметры
+/ollama rules             # правила модель ➔ аккаунт
+/ollama test [model]      # проверочный запрос к модели
 ```
 
+## Проверенные факты API (2026-10-21)
+
+- `GET https://ollama.com/v1/models` возвращает стандартный `data[]` и расширенный массив `models[]` с метаданными контекста и модальностей.
+- `GET https://ollama.com/api/tags` служит источником флагов `capabilities` по моделям.
+- Нативный `/api/chat` передает NDJSON с подробной статистикой токенов в финальном объекте.
+- Совместимый эндпоинт OpenAI `/v1/chat/completions` поддерживает стриминг, инструменты, зрение (vision) и `reasoning_effort`.
+
 ## Ограничения
 
-- Только Ollama Cloud; локальный `http://localhost:11434` не регистрируется.
-- Embeddings не поддерживаются: ни одна облачная модель не объявляет capability `embedding`.
-- Файловые вложения передаются текстовыми handle-заглушками, не байтами.
-- Стоимость — оценка по опубликованному тарифу; финальным авторитетом остаётся gateway.
-- UI требует web-профиль; в TUI остаются команда `/ollama` и маршрут модели.
+- Только Ollama Cloud; локальный сервис `http://localhost:11434` данным плагином не регистрируется.
+- Эмбеддинги (embeddings) в облачном API не предоставляются.
+- Файловые вложения передаются текстовыми дескрипторами (handle), а не бинарными байтами.
+- Интерфейс требует web-профиль; в терминальном TUI доступны команда `/ollama` и маршрут модели.
 
 ## Лицензия
 

package/README.zh.md

@@ -1,76 +1,155 @@
 # 📦 @goodandready/dsh-ollama-cloud-provider
 
-DeepSeek Harness（dsh）的 **Ollama Cloud** 模型提供方插件。
+<div align="center">
 
-插件注册一个路由 `ollama-cloud`（`https://ollama.com`），支持两种传输协议：
+<h3>面向 DeepSeek Harness 的 Ollama Cloud 模型提供商插件</h3>
 
-| 传输 | 端点 | 用途 |
+<p>
+  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/🌐_DSH_Hub-goodandready.app-ff4500.svg?style=for-the-badge&labelColor=1a1a2e" alt="GoodAndReady 展厅"></a>
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-ollama-cloud-provider"><img src="https://img.shields.io/npm/v/@goodandready/dsh-ollama-cloud-provider?style=for-the-badge&color=crimson&logo=npm" alt="npm 版本"></a>
+  <a href="https://github.com/GooDAnDReaDY/dsh-ollama-cloud-provider/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="许可证"></a>
+</p>
+
+</div>
+
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
+---
+
+面向 [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)（dsh）的 **Ollama Cloud** 模型提供商插件。
+
+插件注册一个原生 LLM 路由 `ollama-cloud`（`https://ollama.com`），支持两种底层传输协议：
+
+| 传输协议 | 端点 | 用途 |
 |---|---|---|
-| `native`（默认） | `POST /api/chat` | thinking、工具调用、usage 计数 |
-| `openai-chat` | `POST /v1/chat/completions` | OpenAI 兼容部署与回退 |
+| `native`（默认） | `POST /api/chat` | thinking、工具调用、usage 计数（NDJSON） |
+| `openai-chat` | `POST /v1/chat/completions` | OpenAI 兼容部署与备用网关（SSE） |
+
+密钥在每次请求时动态解析：在设置中更换凭据无需重启即可立即生效。
+
+## 架构示意
+
+```mermaid
+graph LR
+    subgraph DSH["DeepSeek Harness 核心"]
+        Agent["DSH 智能体 / 聊天"]
+        Creds["凭据服务 / 环境变量"]
+    end
+
+    subgraph Plugin["dsh-ollama-cloud-provider"]
+        Router{"路由: ollama-cloud"}
+        Pool["多账号连接池<br/>轮换、冷却、粘性会话"]
+        Catalog["实时模型目录<br/>/v1/models + /api/tags"]
+        Usage["余额与用量监控<br/>/api/balance + /api/usage"]
+
+        subgraph Transports["底层传输协议"]
+            T1["Native /api/chat (NDJSON)"]
+            T2["OpenAI /v1/chat/completions (SSE)"]
+        end
+    end
+
+    subgraph Ollama["Ollama Cloud 云端网关"]
+        Chat["ollama.com/api/chat"]
+        OpenAI["ollama.com/v1/chat/completions"]
+        Billing["/api/balance, /api/usage"]
+    end
+
+    Agent --> Router
+    Creds -.-> Pool
+    Router --> Pool
+    Pool --> Transports
+    T1 --> Chat
+    T2 --> OpenAI
+    Catalog --> Router
+    Usage --> Billing
+```
 
-密钥在每次请求时解析，更换凭据无需重启。
+## 功能全貌
 
-## 功能
+- **两种底层传输协议**：按模型选择 Ollama 原生协议（NDJSON）或 OpenAI 兼容协议（SSE）。
+- **全要素流式交互**：文本、深度思考（thinking）、工具调用、多模态图像、Token 统计与 finish reasons。
+- **实时模型目录**：自动从 `GET /v1/models` 获取模型列表，并结合 `GET /api/tags` 补全能力标记（`tools`、`thinking`、`vision`）。
+- **精准模型元数据**：上下文长度、输入模态、推理等级与默认配置、工具支持状态及 API 开放性。
+- **官方余额与用量分析**：集成官方 `/api/balance` 与 `/api/usage`，呈现可用额度、已购额度、24小时/7天/30天支出及按模型细分报表。
+- **多账号智能轮换**：在输出首个 Token 之前，遇到 401/403/429 或额度耗尽自动切换至备用账号。冷却时间通过 SHA-256 哈希安全持久化。
+- **会话粘性与路由规则**：支持单会话锁定同一账号，以及基于 Glob 通配符的 `模型 → 账号` 绑定规则。
+- **成本透明估算**：依据官方发布的价目表（包含闲时优惠折扣）进行费用估算，支持按模型覆盖价格。
+- **Web UI 与交互卡片**：
+  - **设置 → Ollama Cloud**：密钥配置、余额显示、账号池管理、模型白名单与协议切换。
+  - **侧边栏配额指示卡片**：环形展示最高额度窗口（默认关闭且不产生后台轮询；可在名称旁显示 `planLabel`，例如 `PRO`）。
+  - **中央用量分析面板**：支出窗口、请求热力图与用量走势。
+- **`/ollama` 快捷指令**：快速查询状态、额度、余额、账号列表与执行联通性测试。
+- **一键热更新**：在 DSH 设置页直接检测 npm 最新版本并快速安装更新。
 
-- 按模型选择两种传输协议。
-- 文本、thinking、工具调用、图像、usage 和结束原因。
-- 从 `GET /v1/models` 读取实时模型目录，并用 `GET /api/tags` 的 `capabilities` 补充能力。
-- 模型选择器中的准确元数据：上下文窗口、输入模态、推理等级及默认值、工具支持、API 可见性。
-- 从官方 `/api/balance` 和 `/api/usage` 读取余额与用量：包含额度、购买额度、24 小时 / 7 天 / 30 天支出、按模型支出。
-- 多账号轮换在**首个 token 之前**完成：401/403/429 与配额耗尽会标记密钥并切换到下一个。冷却状态重启后保留。
-- 每个会话的粘性账号，以及 `模型 → 账号` 的 glob 规则。
-- 按 Ollama 公开价目表估算费用，包含 off-peak 价格，并支持按模型覆盖。
-- 浏览器界面：**设置 → Ollama Cloud**、侧边栏配额卡片（默认关闭，关闭时不会轮询 `/state`）、含用量分析、热力图和路由记录的中央面板。
-- `/ollama` 命令、TUI 设置区、一键插件更新。
+## 安装指南
 
-## 安装
+从源码构建与打包：
 
 ```bash
 npm install
 npm run build
 npm pack
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.0.tgz
-# DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.0.tgz
 ```
 
-重启 dsh，然后在模型列表中选择 **Ollama Cloud**。
+从 npm 安装已发布版本：
 
-## 配置
+```bash
+dsh plugin --profile web add @goodandready/dsh-ollama-cloud-provider@0.1.4
+# DSH 桌面端：
+dsh plugin --profile desktop add @goodandready/dsh-ollama-cloud-provider@0.1.4
+```
+
+或通过打包文件安装：
+
+```bash
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.4.tgz
+# DSH 桌面端：
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-ollama-cloud-provider-0.1.4.tgz
+```
+
+安装完成后重启 dsh 或 DSH 桌面端，在模型列表中选择 **Ollama Cloud** 即可。
+
+## 配置示例
 
 ```yaml
 - id: llm-ollama-cloud
   name: "@goodandready/dsh-ollama-cloud-provider"
   config:
-    apiKeyEnv: OLLAMA_API_KEY
-    transport: native            # native | openai-chat
+    apiKeyEnv: OLLAMA_API_KEY      # 环境变量名或 DSH 凭据名
+    # apiKey: ...                  # 仅本地调试，严禁提交代码库
+    transport: native              # native | openai-chat
     requestTimeoutMs: 300000
     streamIdleTimeoutMs: 300000
     visibleModels: []
+    modelTransports: {}
     accounts:
       - label: Work
         apiKeyEnv: OLLAMA_API_KEY_2
-    activeAccount: ''
+    activeAccount: ''              # 固定指定活跃账号
     stickySession: true
     showSidebarQuota: false
+    planLabel: ''                  # 可选，例如 PRO
 ```
 
-除 `apiKey` 外的所有字段都是 volatile，可直接在 dsh 设置中编辑。
-
-### 密钥
+除 `apiKey` 外的所有配置项均可在 DSH 设置页直接修改。
 
-1. `config.apiKey`：仅用于 composition，`role('secret')`。
-2. dsh 凭据服务中的 `apiKeyEnv`（默认 `OLLAMA_API_KEY`）。
-3. 启动环境变量。
+### 密钥配置
 
-在 <https://ollama.com/settings/keys> 创建密钥，密钥不会过期。云端只接受 `Authorization: Bearer`，不接受 `x-api-key`。
+1. DSH 配置中的 `config.apiKey`。
+2. DSH 凭据服务中的 `apiKeyEnv`（默认 `OLLAMA_API_KEY`）。
+3. 环境变量或 `$DSH_HOME/.env`。
 
-### 账号与轮换
+密钥可在官方后台生成：<https://ollama.com/settings/keys>。云端网关仅接受 `Authorization: Bearer` 请求头。
 
-在 **设置 → Ollama Cloud → 账号** 中添加账号：填写名称与凭据引用（如 `OLLAMA_API_KEY_2`），粘贴密钥并保存。轮换发生在流式输出之前；被拒绝的密钥进入冷却，请求由下一个可用密钥继续。冷却信息保存在 `~/.dsh/storages/dsh-ollama/cooldowns.json`，仅使用 SHA-256 指纹，不写入原始密钥。
-
-### 模型 → 账号规则
+### 模型到账号路由规则
 
 ```yaml
 modelAccountRules:
@@ -78,54 +157,32 @@ modelAccountRules:
     account: "Work"
 ```
 
-第一个匹配的 glob 优先使用指定账号，其余账号仍作后备。
-
-## 余额与用量
-
-- `GET /api/balance`：新格式（`included.balance_usd`、`allowance_usd`、`period`、`purchased.balance_usd`）与旧格式（`session` / `weekly` 的 `remaining_percent`）均支持。
-- `GET /api/usage?range=24h|7d|30d&group_by=model`：总计与按模型分组。
+## 界面与视觉验收
 
-`/api/usage` 限制为**每位用户每分钟 10 次请求**，因此余额缓存 60 秒、用量缓存 120 秒、失败缓存 30 秒，不做后台轮询。配额不可用不影响聊天。
+DSH Desktop（暗黑主题）中的 Ollama Cloud 设置与用量面板：
 
-## 命令
+![Ollama Cloud 设置](media/visual-verification.png)
 
-```
-/ollama status
-/ollama usage
-/ollama balance
-/ollama accounts
-/ollama models
-/ollama rules
-/ollama test [model]
-```
-
-## 已验证的 API 事实（2026-10-21）
-
-- `GET https://ollama.com/v1/models` 公开，除标准 `data[]` 外还返回非标准 `models[]`，包含上下文、模态、推理等级、`visibility` 和 `supported_in_api`。
-- `GET https://ollama.com/api/tags` 公开，是按模型获取 `capabilities` 的唯一来源。
-- 实时目录返回 23 个云端模型。
-- 原生 `/api/chat` 使用 NDJSON，最后一行包含计数与 `done_reason`。
-- OpenAI `/v1/chat/completions` 支持流式、工具、图像、`reasoning_effort` 与 `include_usage`。
-- Anthropic 兼容接口（`/v1/messages`）仅部分支持，本插件未使用。
-
-## 开发
+## 常用指令
 
 ```bash
-npm run typecheck
-npm test
-npm run build
-npm run check
-node scripts/probe.mjs
+/ollama status            # 查看服务商状态、配额与模型数
+/ollama usage             # 7 天支出与按模型细分
+/ollama balance           # 包含额度与充值额度
+/ollama accounts          # 账号池健康与支出
+/ollama models            # 模型目录与参数能力
+/ollama rules             # 模型到账号规则
+/ollama test [model]      # 发送连通性测试请求
 ```
 
-## 限制
+## 限制与注意事项
 
-- 仅支持 Ollama Cloud；不注册本地 `http://localhost:11434`。
-- 不支持 embeddings：实时目录中没有模型声明 `embedding` 能力。
-- 文件附件以确定的文本句柄传递，而不是内联字节。
-- 费用为公开价目表的估算值，最终以网关为准。
-- UI 需要 web profile；TUI 保留 `/ollama` 命令与模型路由。
+- 仅支持 Ollama Cloud 云端模型；不会注册本地 `http://localhost:11434` 路由。
+- 云端 API 暂不提供向量嵌入（Embeddings）模型。
+- 文件附件以文本句柄（handle）形式转发。
+- `/api/usage` 限制为每分钟 10 次请求，插件已内置本地缓存以确保顺畅使用。
+- 完整功能需要 Web 配置文件；TUI 终端环境保留 `/ollama` 命令与模型推理。
 
 ## 许可证
 
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)。参见 [LICENSE](./LICENSE) 与 [NOTICE](./NOTICE)。
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)。详见 [LICENSE](./LICENSE) 与 [NOTICE](./NOTICE)。

package/lib/client.js

@@ -120,6 +120,8 @@ window.__ModuleLoader__.load({
 				sidebar: "Sidebar",
 				showSidebarQuota: "Show the quota card in the sidebar",
 				showSidebarQuotaHint: "The card appears above Settings and opens this panel.",
+				planLabel: "Plan label",
+				planLabelHint: "Optional label shown on the sidebar card, for example PRO. Ollama does not expose the plan name via API.",
 				usageAnalytics: "Usage analytics",
 				analyticsEmpty: "No Ollama Cloud sessions in this window.",
 				analyticsHint: "Aggregated from the local session projection cache: numeric metadata only, no prompt text.",
@@ -277,6 +279,8 @@ window.__ModuleLoader__.load({
 				sidebar: "侧边栏",
 				showSidebarQuota: "在侧边栏显示配额卡片",
 				showSidebarQuotaHint: "卡片显示在设置上方，点击可打开此面板。",
+				planLabel: "套餐标签",
+				planLabelHint: "侧边栏卡片上显示的可选标签，例如 PRO。Ollama API 不提供套餐名称。",
 				usageAnalytics: "用量分析",
 				analyticsEmpty: "此窗口内没有 Ollama Cloud 会话。",
 				analyticsHint: "来自本地会话投影缓存，仅包含数值元数据，不读取提示词。",
@@ -1005,8 +1009,8 @@ window.__ModuleLoader__.load({
 			};
 		}
 		function MiniRing(props) {
-			const size = props.size ?? 34;
-			const radius = 14;
+			const size = props.size ?? 16;
+			const radius = 7;
 			const circumference = 2 * Math.PI * radius;
 			const filled = Math.max(0, Math.min(100, props.percent)) / 100;
 			const stroke = props.percent >= 90 ? "var(--ocl-danger)" : props.percent >= 75 ? "var(--ocl-warning)" : "var(--ocl-accent)";
@@ -1014,24 +1018,24 @@ window.__ModuleLoader__.load({
 				className: "ocl-ring",
 				width: size,
 				height: size,
-				viewBox: "0 0 34 34",
+				viewBox: "0 0 20 20",
 				fill: "none",
 				"aria-hidden": "true",
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
-					cx: "17",
-					cy: "17",
+					cx: "10",
+					cy: "10",
 					r: radius,
 					stroke: "var(--ocl-border-strong)",
-					strokeWidth: "3"
+					strokeWidth: "2.5"
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
-					cx: "17",
-					cy: "17",
+					cx: "10",
+					cy: "10",
 					r: radius,
 					stroke,
-					strokeWidth: "3",
+					strokeWidth: "2.5",
 					strokeLinecap: "round",
 					strokeDasharray: `${circumference * filled} ${circumference}`,
-					transform: "rotate(-90 17 17)"
+					transform: "rotate(-90 10 10)"
 				})]
 			});
 		}
@@ -1076,8 +1080,8 @@ window.__ModuleLoader__.load({
 			const report = state?.usage?.report;
 			const bars = quotaBars(report);
 			const worst = worstUsedPercent(report);
-			const active = state?.accounts.find((account) => account.active);
-			const name = active === void 0 ? t("quotaCardName") : `${t("quotaCardName")} · ${active.label}`;
+			const plan = state?.config.planLabel?.trim() ?? "";
+			const name = plan === "" ? t("quotaCardName") : `${t("quotaCardName")} · ${plan}`;
 			const detail = bars.map((entry) => `${entry.label}: ${entry.remainingPercent.toFixed(0)}% ${t("remaining")}`).join(" · ");
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 				type: "button",
@@ -1441,6 +1445,7 @@ window.__ModuleLoader__.load({
 				maxOutputTokens: state.config.maxOutputTokens === null ? "" : String(state.config.maxOutputTokens),
 				contextWindow: state.config.contextWindow === null ? "" : String(state.config.contextWindow),
 				showSidebarQuota: state.config.showSidebarQuota,
+				planLabel: state.config.planLabel,
 				activeAccount: state.config.activeAccount,
 				accounts: state.config.accounts.map((account) => ({ ...account })),
 				modelAccountRules: state.config.modelAccountRules.map((rule) => ({ ...rule })),
@@ -1471,6 +1476,7 @@ window.__ModuleLoader__.load({
 				maxOutputTokens: numberOrNull(draft.maxOutputTokens),
 				contextWindow: numberOrNull(draft.contextWindow),
 				showSidebarQuota: draft.showSidebarQuota,
+				planLabel: draft.planLabel.trim(),
 				activeAccount: draft.activeAccount.trim(),
 				accounts: draft.accounts.map((account) => ({
 					label: account.label.trim(),
@@ -1587,63 +1593,67 @@ window.__ModuleLoader__.load({
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "ocl-model",
 				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
-						className: "ocl-row",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-							type: "checkbox",
-							checked: visible,
-							onChange: (event) => onVisible(event.target.checked)
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: "ocl-model-name",
-							title: `${model.name} · ${model.description}`,
-							children: model.id
-						})]
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+						type: "checkbox",
+						checked: visible,
+						onChange: (event) => onVisible(event.target.checked)
 					}),
-					model.free ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: "ocl-badge",
-						title: t("legendFree"),
-						children: t("free")
-					}) : null,
-					!model.free && model.cost.priced ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-						className: "ocl-badge",
-						title: t("legendPrice"),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+						className: "ocl-model-name",
+						title: `${model.name} · ${model.description}`,
 						children: [
-							"$",
-							model.cost.input,
-							"/$",
-							model.cost.output
+							model.id,
+							model.free ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge",
+								title: t("legendFree"),
+								children: [" ", t("free")]
+							}) : null,
+							!model.free && model.cost.priced ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge",
+								title: t("legendPrice"),
+								children: [
+									" $",
+									model.cost.input,
+									"/$",
+									model.cost.output
+								]
+							}) : null,
+							!model.free && !model.cost.priced ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge",
+								title: t("legendUnknownPrice"),
+								children: [" ", t("priceUnknown")]
+							}) : null,
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge",
+								title: t("legendContext"),
+								children: [
+									" ",
+									Math.round(model.contextWindow / 1024),
+									"K"
+								]
+							}),
+							model.tools ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge",
+								title: t("legendTools"),
+								children: [" ", t("tools")]
+							}) : null,
+							model.input.includes("image") ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge",
+								children: [" ", t("vision")]
+							}) : null,
+							model.reasoning.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge",
+								title: model.reasoning.join(", "),
+								children: [" ", t("reasoning")]
+							}) : null,
+							model.available ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "ocl-badge ocl-badge-warn",
+								children: [" ", t("unavailable")]
+							})
 						]
-					}) : null,
-					!model.free && !model.cost.priced ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: "ocl-badge",
-						title: t("legendUnknownPrice"),
-						children: t("priceUnknown")
-					}) : null,
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-						className: "ocl-badge",
-						title: t("legendContext"),
-						children: [Math.round(model.contextWindow / 1024), "K"]
-					}),
-					model.tools ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: "ocl-badge",
-						title: t("legendTools"),
-						children: t("tools")
-					}) : null,
-					model.input.includes("image") ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: "ocl-badge",
-						children: t("vision")
-					}) : null,
-					model.reasoning.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: "ocl-badge",
-						title: model.reasoning.join(", "),
-						children: t("reasoning")
-					}) : null,
-					model.available ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: "ocl-badge ocl-badge-warn",
-						children: t("unavailable")
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
-						className: "ocl-select ocl-model-transport",
+						className: "ocl-select",
 						value: transport === "" ? model.transport : transport,
 						"aria-label": t("transport"),
 						onChange: (event) => onTransport(event.target.value),
@@ -2415,6 +2425,12 @@ window.__ModuleLoader__.load({
 									type: "number",
 									value: draft.contextWindow,
 									onChange: (value) => update({ contextWindow: value })
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+									label: t("planLabel"),
+									hint: t("planLabelHint"),
+									value: draft.planLabel,
+									onChange: (value) => update({ planLabel: value })
 								})
 							]
 						})]

package/lib/index.d.ts

@@ -66,6 +66,8 @@ interface Config {
   activeAccount?: string;
   /** Show the quota card in the sidebar. */
   showSidebarQuota?: boolean;
+  /** Optional plan label shown on the sidebar card, for example PRO. */
+  planLabel?: string;
   /** Per-model price overrides in USD per 1M tokens. */
   priceOverrides?: Record<string, ModelPriceOverride>;
   /** Product user agent sent to Ollama Cloud. */
@@ -94,6 +96,7 @@ interface ResolvedConfig {
   stickySession: boolean;
   activeAccount: string;
   showSidebarQuota: boolean;
+  planLabel: string;
   priceOverrides: Readonly<Record<string, ModelPriceOverride>>;
   userAgent: string;
 }

package/lib/index.js

@@ -51,7 +51,7 @@ const DEFAULT_API_BASE = "https://ollama.com";
 const DEFAULT_OPENAI_BASE = "https://ollama.com/v1";
 const DEFAULT_USAGE_URL = "https://ollama.com/api/usage";
 const DEFAULT_BALANCE_URL = "https://ollama.com/api/balance";
-const DEFAULT_USER_AGENT = "dsh-ollama-cloud-provider/0.1.2";
+const DEFAULT_USER_AGENT = "dsh-ollama-cloud-provider/0.1.4";
 const DEFAULT_CONTEXT_WINDOW = 131072;
 const DEFAULT_MAX_TOKENS = 32768;
 const DEFAULT_GENERATE_MAX_TOKENS = 131072;
@@ -88,6 +88,7 @@ const Config = z.object({
 	stickySession: markVolatile(z.boolean().default(true)),
 	activeAccount: markVolatile(z.string().default("")),
 	showSidebarQuota: markVolatile(z.boolean().default(false)),
+	planLabel: markVolatile(z.string().default("")),
 	priceOverrides: markVolatile(z.dict(z.object({
 		input: z.number().min(0),
 		output: z.number().min(0),
@@ -178,6 +179,7 @@ function resolveConfig(config) {
 		stickySession: config.stickySession !== false,
 		activeAccount: typeof config.activeAccount === "string" ? config.activeAccount : "",
 		showSidebarQuota: config.showSidebarQuota === true,
+		planLabel: typeof config.planLabel === "string" ? config.planLabel.trim() : "",
 		priceOverrides: priceRecord(config.priceOverrides),
 		userAgent: typeof config.userAgent === "string" && config.userAgent !== "" ? config.userAgent : DEFAULT_USER_AGENT
 	};
@@ -3573,6 +3575,7 @@ function publicConfig(config) {
 		stickySession: config.stickySession,
 		activeAccount: config.activeAccount,
 		showSidebarQuota: config.showSidebarQuota,
+		planLabel: config.planLabel,
 		priceOverrides: config.priceOverrides,
 		userAgent: config.userAgent
 	};
@@ -3777,6 +3780,7 @@ function configOps(patch) {
 	if ("stickySession" in patch) set("stickySession", patch.stickySession === true);
 	if ("activeAccount" in patch) set("activeAccount", patch.activeAccount);
 	if ("showSidebarQuota" in patch) set("showSidebarQuota", patch.showSidebarQuota === true);
+	if ("planLabel" in patch) set("planLabel", patch.planLabel);
 	if ("priceOverrides" in patch) set("priceOverrides", cleanPrices(patch.priceOverrides));
 	if ("userAgent" in patch) set("userAgent", patch.userAgent);
 	return ops;
@@ -4258,6 +4262,18 @@ function buildOllamaTuiSection(deps) {
 					value: text.trim() === "true"
 				})
 			},
+			{
+				path: ["planLabel"],
+				group: "sidebar",
+				kind: "text",
+				label: "Plan label",
+				hint: "Optional label shown on the sidebar card, for example PRO.",
+				format: (value) => String(value === void 0 ? deps.planLabel() : value),
+				parse: (text) => text.trim() === "" ? { kind: "clear" } : {
+					kind: "set",
+					value: text.trim()
+				}
+			},
 			{
 				path: ["activeAccount"],
 				group: "advanced",
@@ -4328,7 +4344,8 @@ function applyOllamaTuiSettings(ctx, deps) {
 		visibleModels: deps.visibleModels(),
 		activeAccount: deps.activeAccount(),
 		stickySession: deps.stickySession(),
-		showSidebarQuota: deps.showSidebarQuota()
+		showSidebarQuota: deps.showSidebarQuota(),
+		planLabel: deps.planLabel()
 	});
 	let lastSignature = signature();
 	const refresh = () => {
@@ -4626,7 +4643,8 @@ function apply(ctx, config) {
 			visibleModels: () => current().visibleModels,
 			activeAccount: () => current().activeAccount,
 			stickySession: () => current().stickySession,
-			showSidebarQuota: () => current().showSidebarQuota
+			showSidebarQuota: () => current().showSidebarQuota,
+			planLabel: () => current().planLabel
 		});
 	});
 	ctx.inject(["webServer"], (webCtx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-ollama-cloud-provider",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Ollama Cloud LLM provider plugin for DeepSeek Harness (dsh).",
   "license": "MIT",
   "type": "module",