@goodandready/dsh-opencode-provider 0.0.0-stage → 0.5.1

package/README.ru.md

@@ -0,0 +1,203 @@
+# 📦 @goodandready/dsh-opencode-provider
+
+<div align="center">
+
+<h3>Плагин-провайдер OpenCode Console и OpenCode Go для 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"></a>
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-opencode-provider"><img src="https://img.shields.io/npm/v/@goodandready/dsh-opencode-provider?style=for-the-badge&color=crimson&logo=npm" alt="npm версия"></a>
+  <a href="https://github.com/GooDAnDReaDY/dsh-opencode-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>
+
+---
+
+Плагин-провайдер OpenCode / OpenCode Go для [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) (dsh).
+
+Плагин регистрирует два нативных LLM-маршрута:
+
+| Маршрут | Продукт / Тариф | Базовый эндпоинт | Назначение |
+|---|---|---|---|
+| `opencode` | OpenCode Console / Zen | `https://opencode.ai/inference` | Поминутная тарификация (pay-as-you-go) |
+| `opencode-go` | OpenCode Go / Go Plus | `https://opencode.ai/inference/go` | Фиксированная подписка с лимитами 5h / недели / месяца |
+
+Ключи разрешаются динамически на каждый вызов: смена токена в настройках или в файле окружения вступает в силу мгновенно без перезапуска сервера.
+
+## Архитектура
+
+```mermaid
+graph LR
+    subgraph DSH["Ядро DeepSeek Harness"]
+        Agent["DSH Агент / Чат"]
+        Creds["Сервис учетных записей / auth.json"]
+    end
+
+    subgraph Plugin["dsh-opencode-provider"]
+        Router{"Выбор маршрута"}
+        Pool["Пул аккаунтов<br/>(Авто-ротация и Cooldown)"]
+        Heatmap["Телеметрия и Heatmap<br/>(5h / Неделя / Месяц)"]
+        
+        subgraph Transports["4 Протокола передачи (Wire Transports)"]
+            T1["OpenAI Chat"]
+            T2["Anthropic Messages<br/>(Thinking Signatures)"]
+            T3["OpenAI Responses"]
+            T4["Google GenAI<br/>(thoughtSignature Replay)"]
+        end
+    end
+
+    subgraph OpenCode["Шлюз OpenCode Gateway"]
+        Console["opencode (Console / Zen)"]
+        Go["opencode-go (Go / Go Plus)"]
+    end
+
+    Agent --> Router
+    Creds -.-> Pool
+    Router -->|opencode| Pool
+    Router -->|opencode-go| Pool
+    Pool --> Heatmap
+    Pool --> Transports
+    T1 & T2 & T3 & T4 --> Console & Go
+```
+
+## Полный обзор возможностей
+
+- **Четыре нативных транспорта**, выбираемых автоматически под каждую модель:
+  - OpenAI Chat Completions (DeepSeek, GLM, Kimi, MiMo, LongCat, Hy3, Step и др.).
+  - Anthropic Messages (Claude, MiniMax, Qwen).
+  - OpenAI Responses (GPT, Grok, Muse).
+  - Google Generative AI (Gemini).
+- **Полноценная поддержка всех типов данных**: текст, рассуждения (reasoning), стриминг вызовов инструментов (tool calls), статистика токенов (usage), корректные finish reasons.
+- **Обработка изображений** через встроенный сервис attachments с нативным рендерингом под протокол конкретного транспорта.
+- **Воспроизведение метаданных провайдеров** при строгих требованиях API:
+  - Подписи рассуждений Anthropic (`thinking signatures`).
+  - Google `thoughtSignature` в истории вызовов функций.
+- **Пул аккаунтов с интеллектуальной авто-ротацией** до старта генерации:
+  - Автоматический переход на следующий аккаунт при 401/403/429 или ответах о превышении квот (400/402/403/429).
+  - Недействительный ключ охлаждается 24 часа, превышение квоты — 10 минут (или по заголовку `Retry-After`), rate limit — 60 секунд (или по `Retry-After`).
+  - Если запрос уже начал стриминг, он не переключается посреди ответа; следующий запрос берёт следующий готовый ключ.
+- **Квоты по каждому аккаунту**: отображение индивидуального расхода за 5 часов, неделю и месяц; активный аккаунт управляет сайдбаром и панелью.
+- **Правила «модель ➔ аккаунт»**: сопоставление по glob-паттернам закрепляет предпочтительный аккаунт за моделью; остальные аккаунты остаются в резерве.
+- **Почасовой Heatmap запросов**: сетка «день недели × час» в локальном времени плюс суточная полоса агрегации. Фильтр переключает отображение между всеми запросами и конкретной моделью. Лог `~/.dsh/storages/dsh-opencode/requests.jsonl` хранит только метаданные `{at, provider, model, purpose}` (промпты и ответы не сохраняются).
+- **Стабильный заголовок `x-opencode-session`**: вычисляется из устойчивого ID сессии DSH, обеспечивая одинаковый ключ маршрутизации при повторах и диалоге.
+- **Живой каталог моделей**: автоматическое чтение `/v1/models` с резервным fallback из `models.dev`.
+- **Оценки лимитов подписки OpenCode Go**: долларовый лимит и расчетное число запросов для окон 5h, недели и месяца для планов Go и Go Plus.
+- **Команда `/opencode`**: быстрый просмотр статуса, квот, аккаунтов, моделей, правил и запуск теста связи `test [model]`.
+- **Настройки в терминале (TUI)**: раздел `/settings → OpenCode` для профиля terminal с ключом, эндпоинтами, allowlist, активным аккаунтом и таймаутами.
+- **Интеграция с Settings → Models**: карточка ключа в стандартном списке моделей DSH.
+- **One-Click обновление плагина**: кнопка **Update now** в настройках проверяет npm registry, ставит точную версию через DSH CLI и запрашивает перезапуск.
+- **Plan-aware Go picker**: фильтрация моделей вне тарифной сетки Go с бейджами `Go`, `Console` или `FREE`.
+- **Защита лимита MCP-инструментов**: сохраняет системные инструменты DSH (`read`, `write`, `edit`, `bash`, `glob`, `grep`) при сокращении сторонних инструментов под лимит 128.
+- **Панель аналитики использования**: карточки KPI (запросы, токены, успешность, reasoning, кэш, TTFT, задержка), фильтр 7/30/90 дней и таблицы Models / Days / Sessions.
+
+## Установка
+
+Сборка и упаковка из исходников:
+
+```bash
+npm install
+npm run build
+npm pack
+```
+
+Установка из **упакованного tarball**:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.1.tgz
+# DSH Desktop:
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.1.tgz
+
+# Либо установка опубликованного пакета из npm:
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.1
+```
+
+После установки перезапустите dsh (или DSH Desktop) и выберите **OpenCode** или **OpenCode Go** в списке моделей.
+
+## Конфигурация
+
+Пример файла конфигурации:
+
+```yaml
+- id: llm-opencode
+  name: "@goodandready/dsh-opencode-provider"
+  config:
+    apiKeyEnv: OPENCODE_API_KEY   # переменная окружения или имя credential
+    # apiKey: oc_sk_...           # только для локальной сборки, не коммитить!
+    openCodeAuthEntry: opencode-go
+    requestTimeoutMs: 300000
+    streamIdleTimeoutMs: 300000
+    visibleModels: []
+    modelTransports: {}
+    accounts:
+      - label: Go #2
+        apiKeyEnv: OPENCODE_API_KEY_2
+    activeAccount: ''            # метка аккаунта для принудительного закрепления
+```
+
+### Источники ключей
+
+1. `config.apiKey` в конфигурации DSH (`role('secret')`).
+2. Системные учетные данные DSH по имени `apiKeyEnv`.
+3. Авто-импорт из `~/.local/share/opencode/auth.json` (по ключу `openCodeAuthEntry`, по умолчанию `opencode-go`), записанный CLI-утилитой OpenCode.
+4. Переменные окружения процесса, проекта `.env` или `$DSH_HOME/.env`.
+
+### Настройка пула аккаунтов и ротации
+
+Добавьте второй аккаунт в **Настройки → OpenCode → Accounts**: укажите метку (например, `Go #2`) и имя переменной/credential (`OPENCODE_API_KEY_2`), вставьте ключ и сохраните. Аккаунт по умолчанию (`default`) всегда обслуживает запросы первым, если не закреплен другой.
+
+При ошибке авторизации, исчерпании лимита или rate limit адаптер помечает ключ периодом охлаждения (cooldown) и немедленно повторяет запрос со следующим доступным аккаунтом. Состояния cooldown сохраняются между перезапусками в `~/.dsh/storages/dsh-opencode/cooldowns.json` по SHA-256 хешу ключа — сырые токены на диск не записываются.
+
+### Правила привязки «модель ➔ аккаунт»
+
+С помощью glob-паттернов можно закрепить определенные модели за выделенными аккаунтами:
+
+```yaml
+modelAccountRules:
+  - pattern: "*free*"
+    account: "free"
+  - pattern: "your-provider-*"
+    account: "go"
+```
+
+## Страница настроек Web UI
+
+В разделе **Настройки → OpenCode**:
+- **Key**: статус ключа, вставка, импорт из OpenCode CLI, очистка и кнопка **Test connection** с замером задержки.
+- **Quota**: шкалы расхода за 5 часов, неделю и месяц с датами сброса и предупреждениями при 80% и 95%.
+- **Accounts**: управление пулом дополнительных учетных записей.
+- **Models**: поиск, обновление каталога, фильтрация allowlist, переопределение транспорта и просмотр стоимости токенов.
+- **Connection**: таймауты, базовые URL и переключатель карточки сайдбара.
+- **Plugin update**: статус версии и кнопка **Update now**.
+
+## Команды CLI
+
+```bash
+/opencode status            # статус аккаунтов, квоты и правила
+/opencode usage             # текущие окна квот
+/opencode accounts          # список меток, статус и расход 5h/wk/mo
+/opencode models            # список моделей и лимиты Go
+/opencode rules             # правила модель ➔ аккаунт
+/opencode test [model]      # проверочный запрос к модели
+```
+
+## Безопасность и надежность
+
+- Запросы на изменение настроек и ключей разрешены только с loopback (`127.0.0.1` / `::1`) с обязательной проверкой same-origin для защиты от DNS-rebinding атак.
+- Тексты запросов и ответов пользователей никогда не записываются в файлы журнала.
+- При исчерпании квоты на одном ключе диалог пользователя не прерывается благодаря бесшовной ротации.
+
+## Лицензия
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY). См. [LICENSE](./LICENSE) и [NOTICE](./NOTICE).
+

package/README.zh.md

@@ -0,0 +1,178 @@
+# 📦 @goodandready/dsh-opencode-provider
+
+<div align="center">
+
+<h3>面向 DeepSeek Harness 的 OpenCode Console 与 OpenCode Go 提供商插件</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-opencode-provider"><img src="https://img.shields.io/npm/v/@goodandready/dsh-opencode-provider?style=for-the-badge&color=crimson&logo=npm" alt="npm 版本"></a>
+  <a href="https://github.com/GooDAnDReaDY/dsh-opencode-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）的 OpenCode / OpenCode Go 提供商插件。
+
+插件注册两个原生 LLM 路由：
+
+| 路由 | 产品 / 方案 | 基础接口 | 特性说明 |
+|---|---|---|---|
+| `opencode` | OpenCode Console / Zen | `https://opencode.ai/inference` | 按量计费（pay-as-you-go） |
+| `opencode-go` | OpenCode Go / Go Plus | `https://opencode.ai/inference/go` | 订阅专属，含 5小时/每周/每月配额估算 |
+
+密钥在每次调用时动态解析：在设置中或环境文件中更换凭据无需重启服务器即可立即生效。
+
+## 架构示意
+
+```mermaid
+graph LR
+    subgraph DSH["DeepSeek Harness 核心"]
+        Agent["DSH 智能体 / 聊天"]
+        Creds["凭据服务 / auth.json"]
+    end
+
+    subgraph Plugin["dsh-opencode-provider"]
+        Router{"路由选择器"}
+        Pool["多账户连接池<br/>(智能轮换与冷却)"]
+        Heatmap["遥测与请求热力图<br/>(5小时 / 周 / 月)"]
+        
+        subgraph Transports["4 种底层传输协议 (Wire Transports)"]
+            T1["OpenAI Chat"]
+            T2["Anthropic Messages<br/>(Thinking Signatures)"]
+            T3["OpenAI Responses"]
+            T4["Google GenAI<br/>(thoughtSignature 重放)"]
+        end
+    end
+
+    subgraph OpenCode["OpenCode 网关"]
+        Console["opencode (Console / Zen)"]
+        Go["opencode-go (Go / Go Plus)"]
+    end
+
+    Agent --> Router
+    Creds -.-> Pool
+    Router -->|opencode| Pool
+    Router -->|opencode-go| Pool
+    Pool --> Heatmap
+    Pool --> Transports
+    T1 & T2 & T3 & T4 --> Console & Go
+```
+
+## 功能全貌
+
+- **4 种原生传输协议**，按模型自动优选：
+  - OpenAI Chat Completions（DeepSeek、GLM、Kimi、MiMo、LongCat、Hy3、Step 等）。
+  - Anthropic Messages（Claude、MiniMax、Qwen）。
+  - OpenAI Responses（GPT、Grok、Muse）。
+  - Google Generative AI（Gemini）。
+- **完整数据类型流式支持**：文本、思考推理（reasoning）、流式工具调用（tool calls）、用量统计与 finish reasons。
+- **多模态图像传输**：通过持久化附件服务，按协议原生转换与传输。
+- **协议特定元数据重放**：
+  - Anthropic 思考签名（`thinking signatures`）。
+  - Google 历史函数调用中的 `thoughtSignature`。
+- **多账户智能无缝轮换**：
+  - 在生成流开始前，遇到 401/403/429 或配额用尽响应（400/402/403/429）自动重试下一个账户。
+  - 无效密钥冷却 24 小时，超额冷却 10 分钟（或遵循 `Retry-After`），速率限制冷却 60 秒。
+  - 正在流式传输中的请求不会被打断，下一个请求会自动使用下一个可用密钥。
+- **多账户额度与健康监控**：每行独立展示 5 小时、每周与每月使用情况，活跃账户驱动侧边栏与配额面板。
+- **模型 ➔ 账户路由规则**：支持 Glob 通配符（如 `*free*`、`deepseek-*`）将模型优先绑定至特定账户，其他账户保留为备用。
+- **本地时间请求热力图**：星期×小时交互式热力图，排除系统心跳与重复记录，仅保存 `{at, provider, model, purpose}` 元数据，不保存任何提示词与回复。
+- **稳定的 `x-opencode-session` 标头**：根据 DSH 会话 ID 派生，确保重试与连续对话复用相同的网关路由键。
+- **实时模型目录**：自动从 `/v1/models` 同步，并以 `models.dev` 生成文件作为回退。
+- **Go 订阅额度估算**：每月美元额度以及 5 小时、每周和每月的估算请求次数。
+- **`/opencode` 斜杠指令**：快速查询状态、配额、账户、模型及执行联通性测试。
+- **Web UI 一键更新**：设置页集成版本比对与一键热更新按钮。
+- **MCP 工具上限防护**：在大规模 MCP 工具集达到 128 工具限制时，优先保留 DSH 核心系统工具。
+
+## 安装指南
+
+从源码构建与打包：
+
+```bash
+npm install
+npm run build
+npm pack
+```
+
+通过**打包文件 (.tgz)**安装：
+
+```bash
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.1.tgz
+# DSH 桌面端：
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.1.tgz
+
+# 或从 npm 安装已发布版本：
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.1
+```
+
+安装完成后重启 dsh 或 DSH 桌面端，在模型选择器中选择 **OpenCode** 或 **OpenCode Go** 即可。
+
+## 配置示例
+
+```yaml
+- id: llm-opencode
+  name: "@goodandready/dsh-opencode-provider"
+  config:
+    apiKeyEnv: OPENCODE_API_KEY   # 环境变量或 DSH 凭据名
+    # apiKey: oc_sk_...           # 仅本地调试，严禁提交代码库
+    openCodeAuthEntry: opencode-go
+    requestTimeoutMs: 300000
+    streamIdleTimeoutMs: 300000
+    visibleModels: []
+    modelTransports: {}
+    accounts:
+      - label: Go #2
+        apiKeyEnv: OPENCODE_API_KEY_2
+    activeAccount: ''            # 固定指定活跃账户名称
+```
+
+### 密钥解析顺序
+
+1. DSH 配置中的 `config.apiKey`。
+2. DSH 凭据服务中由 `apiKeyEnv` 指定的凭据。
+3. `~/.local/share/opencode/auth.json` 中的 `openCodeAuthEntry` 项（默认 `opencode-go`）。
+4. 进程环境变量或 `$DSH_HOME/.env`。
+
+### 模型到账户路由规则
+
+```yaml
+modelAccountRules:
+  - pattern: "*free*"
+    account: "free"
+  - pattern: "your-provider-*"
+    account: "go"
+```
+
+## 常用指令
+
+```bash
+/opencode status            # 查看账户健康状态、配额与路由规则
+/opencode usage             # 查看当前配额窗口
+/opencode accounts          # 账户列表与 5h/周/月消耗
+/opencode models            # 模型列表与 Go 方案限制
+/opencode rules             # 模型到账户规则
+/opencode test [model]      # 发送最小化测试请求
+```
+
+## 安全规范
+
+- 写入与配置路由均要求 Loopback（`127.0.0.1` / `::1`）与同源检查，防御 DNS 重新绑定。
+- 密钥冷却状态通过 SHA-256 哈希指纹持久化，本地日志不保存提示词与明文密钥。
+
+## 许可证
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)。详见 [LICENSE](./LICENSE) 与 [NOTICE](./NOTICE)。
+

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# dsh-opencode-provider bundle layer.
+# Registers the `opencode` (Console/Zen) and `opencode-go` (Go subscription)
+# provider routes. All fields are optional — schema defaults apply.
+#
+# `name` must be the FULL package specifier as installed in the profile's
+# node_modules. Quote it: an unquoted YAML scalar starting with `@` fails.
+- insert:
+    - id: llm-opencode
+      name: "@goodandready/dsh-opencode-provider"
+      config:
+        apiKeyEnv: OPENCODE_API_KEY