@goodandready/dsh-clinebot 0.2.0 → 0.2.1

package/README.md

@@ -13,13 +13,13 @@
 
 <!-- Author Showcase Link -->
 <p align="center">
-  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/All_Author_Projects-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="All Projects"></a>
+  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/All_Author_Projects-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="GoodAndReady Showcase"></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>
+  <a href="docs/README.ru.md"><b>🇷🇺 Русский</b></a> •
+  <a href="docs/README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
 </div>
@@ -109,27 +109,31 @@ graph LR
 dsh plugin --profile web add @goodandready/dsh-clinebot
 ```
 
+Restart your DeepSeek Harness instance and refresh the browser.
+
 ---
 
 ## 💬 Slash-Command `/cline`
 
-From any DSH chat session, type `/cline` to inspect quota:
+From any DSH chat session, type `/cline` to inspect quota and status:
 
 ```text
 ### 🤖 ClinePass Status (ClinePass ($9.99/mo))
-* Пинг хоста: ✅ 210 мс
-* Активный ключ: CLINEBOT_API_KEY (credentials)
-* Модель по умолчанию: `cline-pass/deepseek-v4-flash`
+* Latency: ✅ 210 ms
+* Active Key: CLINEBOT_API_KEY (credentials)
+* Default Model: `cline-pass/deepseek-v4-flash`
 
-⏱ 5-часовое окно: [████░░░░░░] 42% (сброс: 18:00)
-📅 Недельное окно: [██████░░░░] 60% (сброс: 08.09)
-* Аккаунт: `developer@example.com`
+⏱ 5-Hour Window: [████░░░░░░] 42% (resets: 18:00)
+📅 Weekly Window: [██████░░░░] 60% (resets: Sep 8)
+* Account: `developer@example.com`
 ```
 
 ---
 
 ## ⚙️ Configuration Reference (`settings.yaml`)
 
+Configure options in `settings.yaml` or directly inside the Web UI:
+
 ```yaml
 dsh-clinebot:
   enabled: true
@@ -146,6 +150,29 @@ dsh-clinebot:
   customModels: []
 ```
 
+### Configuration Parameters
+
+| Parameter | Type | Default | Description |
+|:---|:---|:---|:---|
+| `enabled` | `boolean` | `true` | Enable or disable the ClineBot provider bridge |
+| `baseUrl` | `string` | `"https://api.cline.bot/api/v1"` | ClinePass OpenAI-compatible base URL |
+| `apiKeyEnv` | `string` | `"CLINEBOT_API_KEY"` | Environment variable / credentials key name |
+| `defaultModel` | `string` | `"cline-pass/deepseek-v4-flash"` | Default selected model ID |
+| `timeoutMs` | `number` | `15000` | HTTP request timeout in milliseconds |
+| `smokeTimeoutMs` | `number` | `25000` | Smoke test latency ping timeout |
+| `enabledModels` | `array` | `[...]` | List of models exposed in the DSH chat picker |
+| `customModels` | `array` | `[]` | User-defined custom model entries |
+
+---
+
+## 🧪 Testing
+
+Run the automated test suite:
+
+```bash
+npm test
+```
+
 ---
 
 ## 📄 License

package/{README.ru.md → docs/README.ru.md}

@@ -6,7 +6,7 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-clinebot"><img src="https://img.shields.io/npm/v/@goodandready/dsh-clinebot.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-clinebot.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
+  <a href="../LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-clinebot.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>
@@ -17,7 +17,7 @@
 </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>
@@ -30,7 +30,13 @@
 
 **ClinePass** (`https://cline.bot`) — сервис единой фиксированной подписки (\$9.99/мес), предоставляющий разработчикам повышенные лимиты (в 2–5 раз выше стандартных) на передовые open-weights модели программирования и рассуждений через единый OpenAI-совместимый интерфейс (`https://api.cline.bot/api/v1`).
 
-Плагин **`@goodandready/dsh-clinebot`** обеспечивает полноценную интеграцию подписки в DeepSeek Harness:
+Интеграция ClinePass в DeepSeek Harness (DSH) напрямую сопряжена со следующими сложностями:
+1. **Отсутствие эндпоинта `/v1/models`**: запрос `GET /v1/models` к `api.cline.bot` возвращает `404 Not Found`, из-за чего динамический поиск моделей в DSH падает или оставляет список пустым.
+2. **Специфический формат идентификаторов**: моделям требуется обязательный префикс `cline-pass/` (например, `cline-pass/deepseek-v4-flash`, `cline-pass/kimi-k3`).
+3. **Отслеживание лимитов**: 5-часовые и недельные скользящие окна расхода токенов требуют прозрачной визуализации в интерфейсе.
+4. **Безопасность ключей**: хранение API-токенов в открытых конфигурациях небезопасно.
+
+Плагин **`@goodandready/dsh-clinebot`** решает эти задачи «из коробки»:
 * 🖥️ **Отдельная страница в Настройках**: собственная полноэкранная страница в меню Настроек DSH (`Настройки → ClineBot`).
 * 📊 **Дашборд лимитов подписки (Usage)**: наглядные прогресс-бары расхода 5-часового и недельного скользящего окна из официального API `GET /users/me/plan/usage-limits` с таймером сброса.
 * 🔑 **Сохранение ключа прямо из UI**: поле ввода ключа с маскировкой; сохранение напрямую в системный сервис `credentials` (`~/.dsh/.credentials.yaml`) без ручной правки файлов на сервере.
@@ -81,12 +87,27 @@ graph LR
 
 ---
 
-## 📦 Быстрая установка
+## ✨ Структура модулей и возможности
+
+* **`lib/models.js`**: каталог встроенных моделей ClinePass (11 моделей) и управление пользовательскими моделями (`getAllModels`, `validateCustomModel`).
+* **`lib/cline-client.js`**:
+  * `fetchUsageLimits`: опрос `GET /users/me/plan/usage-limits` и `GET /users/me` с кэшированием в памяти.
+  * `saveCredentialKey`: атомарная запись ключей в `~/.dsh/.credentials.yaml`.
+  * `smokeChat`: замер задержки и тестовый пинг.
+  * `buildPiAiProvider`: генерация конфигурации провайдера для `llm-pi-ai` (`api: 'openai-completions'`).
+* **`lib/index.js`**: сервис Cordis, регистрация системных маршрутов и слэш-команды `/cline`.
+* **`lib/client.js`**: полнофункциональный раздел настроек (`settings.section`, order 28) и аккордеон плагина (`settings.plugin.item`).
+
+---
+
+## 📦 Установка
 
 ```bash
 dsh plugin --profile web add @goodandready/dsh-clinebot
 ```
 
+Перезапустите экземпляр DeepSeek Harness и обновите вкладку в браузере.
+
 ---
 
 ## 💬 Слэш-команда `/cline` в чате
@@ -124,6 +145,29 @@ dsh-clinebot:
   customModels: []
 ```
 
+### Параметры конфигурации
+
+| Параметр | Тип | По умолчанию | Описание |
+|:---|:---|:---|:---|
+| `enabled` | `boolean` | `true` | Включение моста провайдера ClineBot |
+| `baseUrl` | `string` | `"https://api.cline.bot/api/v1"` | Базовый URL OpenAI-совместимого API ClinePass |
+| `apiKeyEnv` | `string` | `"CLINEBOT_API_KEY"` | Имя переменной / ключа в хранилище credentials |
+| `defaultModel` | `string` | `"cline-pass/deepseek-v4-flash"` | Модель, выбираемая по умолчанию |
+| `timeoutMs` | `number` | `15000` | Таймаут HTTP-запросов (мс) |
+| `smokeTimeoutMs` | `number` | `25000` | Таймаут тестового пинга (мс) |
+| `enabledModels` | `array` | `[...]` | Список моделей, активных в селекторе чата |
+| `customModels` | `array` | `[]` | Пользовательские модели, добавленные через интерфейс |
+
+---
+
+## 🧪 Тестирование
+
+Запуск автоматического набора тестов:
+
+```bash
+npm test
+```
+
 ---
 
 ## 📄 Лицензия

package/docs/README.zh.md

@@ -0,0 +1,177 @@
+# 📦 @goodandready/dsh-clinebot
+
+<div align="center">
+
+<h3>适用于 DeepSeek Harness 的 ClineBot / ClinePass 原生模型提供商伴侣插件</h3>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-clinebot"><img src="https://img.shields.io/npm/v/@goodandready/dsh-clinebot.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-clinebot.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>
+
+</div>
+
+---
+
+## ⚡ 概述与解决的核心痛点
+
+**ClinePass** (`https://cline.bot`) 是一项固定月费（\$9.99/月）的高性价比订阅服务，为开发者提供主流开源代码模型与推理模型 2–5 倍的高并发调用限额，统一通过 OpenAI 兼容接口 (`https://api.cline.bot/api/v1`) 提供服务。
+
+在将 ClinePass 接入 DeepSeek Harness (DSH) 时存在以下挑战：
+1. **缺失 `/v1/models` 接口**：`api.cline.bot` 的 `GET /v1/models` 会直接返回 `404 Not Found`，导致动态模型同步失败或模型列表为空。
+2. **专属模型前缀**：所有模型 ID 均需前缀 `cline-pass/`（如 `cline-pass/deepseek-v4-flash`, `cline-pass/kimi-k3`）。
+3. **用量额度监控**：5 小时滑动窗口与每周限额需要清晰直观的可视化进度监控。
+4. **安全凭据隔离**：禁止在明文配置中直接填写密钥。
+
+**`@goodandready/dsh-clinebot`** 完美解决以上痛点：
+* 🖥️ **专属设置大页**：在 DSH 设置中提供全宽独立页面（`设置 → ClineBot`）。
+* 📊 **实时用量仪表盘**：调用官方 `GET /users/me/plan/usage-limits` API，实时渲染 5 小时与每周额度进度条及重置倒计时。
+* 🔑 **界面直存密钥**：在 UI 中直接粘贴 API 密钥，通过 `ctx.credentials.set()` 自动安全保存至 `~/.dsh/.credentials.yaml`。
+* 🎯 **模型选择器管理**：支持勾选开启/关闭特定模型在聊天选择器中的显示。
+* ➕ **自定义新模型**：支持直接在界面新增官方新推出的模型（ID、名称、上下文、Vision），无需等待插件发版。
+* 💬 **聊天斜杠指令 `/cline`**：在任意聊天框快速查询当前配额、网络延迟与活跃模型。
+
+---
+
+## 🏛️ 架构设计
+
+```mermaid
+graph LR
+    subgraph UI [DSH Web 前端界面]
+        Page["独立配置页 (设置 -> ClineBot)"]
+        QuotaBar["5小时与每周额度进度条"]
+        KeyInput["API 密钥直填与安全保存"]
+        ModelPick["模型选择器管控与自定义模型"]
+    end
+
+    subgraph PluginHost [dsh-clinebot 宿主运行环境]
+        HttpEndpoints["API 路由: /api/plugins/dsh-clinebot/*"]
+        ClientCore["lib/cline-client.js"]
+        ModelCatalog["lib/models.js (内置精选 + 用户自定义)"]
+        SlashCmd["斜杠指令: /cline"]
+    end
+
+    subgraph DSHCore [DSH 核心系统服务]
+        Credentials["凭据存储服务 (~/.dsh/.credentials.yaml)"]
+        PiAi["模型注册: llm-pi-ai.providers.clinebot"]
+    end
+
+    subgraph Upstream [Cline 官方云端]
+        ClinePass["api.cline.bot/api/v1/chat/completions"]
+        ClineQuota["api.cline.bot/api/v1/users/me/plan/usage-limits"]
+    end
+
+    Page -->|GET /status & /usage| HttpEndpoints
+    KeyInput -->|POST /save-key| HttpEndpoints
+    ModelPick -->|POST /register & /models| HttpEndpoints
+    HttpEndpoints --> Credentials
+    HttpEndpoints --> ClientCore
+    ClientCore --> ModelCatalog
+    HttpEndpoints -->|原子级写入| PiAi
+    ClientCore -->|模型对话| ClinePass
+    ClientCore -->|额度查询| ClineQuota
+```
+
+---
+
+## ✨ 核心模块与功能
+
+* **`lib/models.js`**：管理 11 款官方精选内置模型以及用户自定义模型（`getAllModels`, `validateCustomModel`）。
+* **`lib/cline-client.js`**：
+  * `fetchUsageLimits`：高效轮询 `GET /users/me/plan/usage-limits` 与 `GET /users/me` 并进行内存缓存。
+  * `saveCredentialKey`：将密钥安全写入 `~/.dsh/.credentials.yaml`。
+  * `smokeChat`：毫秒级网络探活与非流式延迟测试。
+  * `buildPiAiProvider`：构建 DSH `llm-pi-ai` 兼容的服务商定义 (`api: 'openai-completions'`)。
+* **`lib/index.js`**：Cordis 插件主生命周期服务，注册后端 REST API 路由与 `/cline` 聊天斜杠指令。
+* **`lib/client.js`**：前端设置面板（`settings.section` 序号 28）与插件折叠卡片。
+
+---
+
+## 📦 快速安装
+
+在 DeepSeek Harness Web 配置中安装：
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-clinebot
+```
+
+重启 DeepSeek Harness 实例并刷新浏览器页面。
+
+---
+
+## 💬 聊天斜杠指令 `/cline`
+
+在任何聊天会话中输入 `/cline` 即可即时检查配额：
+
+```text
+### 🤖 ClinePass Status (ClinePass ($9.99/mo))
+* 响应延迟: ✅ 210 ms
+* 活跃密钥: CLINEBOT_API_KEY (credentials)
+* 默认模型: `cline-pass/deepseek-v4-flash`
+
+⏱ 5 小时窗口: [████░░░░░░] 42% (重置时间: 18:00)
+📅 每周窗口:   [██████░░░░] 60% (重置时间: 09月08日)
+* 绑定账号: `developer@example.com`
+```
+
+---
+
+## ⚙️ 配置项参考 (`settings.yaml`)
+
+```yaml
+dsh-clinebot:
+  enabled: true
+  baseUrl: https://api.cline.bot/api/v1
+  apiKeyEnv: CLINEBOT_API_KEY
+  defaultModel: cline-pass/deepseek-v4-flash
+  timeoutMs: 15000
+  smokeTimeoutMs: 25000
+  enabledModels:
+    - cline-pass/deepseek-v4-flash
+    - cline-pass/deepseek-v4-pro
+    - cline-pass/kimi-k3
+    - cline-pass/qwen3.7-max
+  customModels: []
+```
+
+### 配置参数说明
+
+| 参数项 | 类型 | 默认值 | 说明 |
+|:---|:---|:---|:---|
+| `enabled` | `boolean` | `true` | 是否启用 ClineBot 桥接插件 |
+| `baseUrl` | `string` | `"https://api.cline.bot/api/v1"` | ClinePass OpenAI 兼容接口地址 |
+| `apiKeyEnv` | `string` | `"CLINEBOT_API_KEY"` | 凭据管理系统中的密钥名称 |
+| `defaultModel` | `string` | `"cline-pass/deepseek-v4-flash"` | 默认选中的模型 ID |
+| `timeoutMs` | `number` | `15000` | HTTP 请求超时时间（毫秒） |
+| `smokeTimeoutMs` | `number` | `25000` | 探活测试超时时间（毫秒） |
+| `enabledModels` | `array` | `[...]` | 允许在聊天下拉框中显示的可用模型列表 |
+| `customModels` | `array` | `[]` | 用户在界面中自定义新增的模型定义列表 |
+
+---
+
+## 🧪 测试
+
+运行自动化测试套件：
+
+```bash
+npm test
+```
+
+---
+
+## 📄 许可证
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/docs/design/DESIGN.md

@@ -0,0 +1,60 @@
+# Design Contract: `@goodandready/dsh-clinebot`
+
+## 1. Executive Summary
+`@goodandready/dsh-clinebot` is a companion plugin for DeepSeek Harness (DSH) enabling native integration of the **ClineBot / ClinePass** subscription provider. Because ClinePass is an OpenAI-compatible endpoint whose `GET /v1/models` returns `404 Not Found`, dynamic discovery is impossible. This plugin acts as the bridge: delivering a curated catalog of open-weights models, securely resolving credentials, exposing health and smoke tests, and mutating the DSH `llm-pi-ai` provider registry.
+
+## 2. Architecture & Cordis Lifecycles
+The plugin consists of two runtime boundaries conforming to DSH authoring standards:
+
+### 2.1 Host Runtime (`lib/index.js`, `lib/cline-client.js`, `lib/models.js`, `lib/http.js`)
+* **Cordis Service Registration**: Injects `['settings', 'webServer', 'credentials']`.
+* **Credential Isolation**: The plugin NEVER stores plain API keys in its configuration. The setting `apiKeyEnv` holds the credential identifier (default: `CLINEBOT_API_KEY`), resolved via `ctx.credentials.resolve()` or `process.env`.
+* **State Synchronization**: Mutates the core `llm-pi-ai` settings space (`op: 'set', path: ['providers', 'clinebot']`) when enabled or registered.
+
+### 2.2 Client Runtime (`lib/client.js`)
+* Self-registering module via `window.__ModuleLoader__.load({ id: '@goodandready/dsh-clinebot', factory })`.
+* Slots into `settings.plugin.item` (primary) and `settings.section` (fallback).
+* Uses native design tokens (`--dsw-alias-...`) with full dark/light theme support.
+
+```mermaid
+graph LR
+    subgraph Client [DSH Web Interface]
+        UI[Settings Card: ClineBot]
+        SmokeBtn[Smoke Test Button]
+        RegBtn[Register in DSH Models]
+    end
+
+    subgraph Host [DSH Node.js Runtime]
+        API["HTTP API: /api/plugins/dsh-clinebot/*"]
+        ClientHelper["lib/cline-client.js"]
+        Catalog["lib/models.js (Static 11 Models)"]
+        CredService[DSH Credentials Service]
+        PiAiSettings["DSH Settings: llm-pi-ai"]
+    end
+
+    subgraph Remote [Cline Service]
+        ClineAPI["api.cline.bot/api/v1"]
+    end
+
+    UI -->|GET /status| API
+    SmokeBtn -->|POST /smoke| API
+    RegBtn -->|POST /register| API
+    API --> CredService
+    API --> ClientHelper
+    ClientHelper --> Catalog
+    API -->|Mutate| PiAiSettings
+    ClientHelper -->|POST /chat/completions| ClineAPI
+```
+
+## 3. UI/UX Contract
+* **Badges**:
+  * Host connectivity: `Host online (<ms>)` (green) / `Host unreachable` (red).
+  * Credential presence: `Key ✓ (credentials|env)` (green) / `Key missing` (amber).
+  * Registration status: `DSH Registered` (green) / `Not Registered` (amber).
+* **Model Picker**: Interactive checklist of all 11 official models with multi-select and vision capability indicators.
+* **Non-destructive actions**: Unregister cleanly removes the provider entry from DSH without touching other providers or configurations.
+
+## 4. Security & Isolation
+* CSRF / Cross-site protection: All mutating routes (`/register`, `/unregister`, `/smoke`, `/models`) validate `isTrustedSettingsRequest(req)` (`Sec-Fetch-Site !== 'cross-site'`).
+* Body size limits: Request payloads are strictly capped at 256 KB.
+* Sensitive credential data is never returned across the HTTP API (only `{ present: boolean, source: string, envName: string }`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-clinebot",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "DeepSeek Harness companion for ClineBot / ClinePass: dedicated settings page, live quota usage limits dashboard, in-UI credentials saving, static & custom models catalog, model picker control, and /cline slash-command.",
   "license": "MIT",
   "type": "module",
@@ -15,8 +15,7 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
-    "README.ru.md",
-    "README.zh.md",
+    "docs/",
     "CHANGELOG.md",
     "LICENSE"
   ],

package/README.zh.md

@@ -1,68 +0,0 @@
-# 📦 @goodandready/dsh-clinebot
-
-<div align="center">
-
-<h3>适用于 DeepSeek Harness 的 ClineBot / ClinePass 原生模型提供商伴侣插件</h3>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@goodandready/dsh-clinebot"><img src="https://img.shields.io/npm/v/@goodandready/dsh-clinebot.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-clinebot.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>
-
-</div>
-
----
-
-## ⚡ 概述与解决的问题
-
-**ClinePass** (`https://cline.bot`) 是一项固定月费（\$9.99/月）的高性价比订阅服务，为开发者提供主流开源代码模型与推理模型 2–5 倍的高并发调用限额，统一通过 OpenAI 兼容接口 (`https://api.cline.bot/api/v1`) 提供服务。
-
-在将 ClinePass 接入 DeepSeek Harness (DSH) 时存在以下挑战：
-1. **缺失 `/v1/models` 接口**：`api.cline.bot` 的 `GET /v1/models` 会直接返回 `404 Not Found`，导致动态模型同步失败。
-2. **专属模型前缀**：所有模型 ID 均需前缀 `cline-pass/`（如 `cline-pass/deepseek-v4-flash`, `cline-pass/kimi-k3`）。
-3. **安全凭据隔离**：禁止在明文配置中直接填写密钥。
-
-**`@goodandready/dsh-clinebot`** 完美解决以上痛点：
-* 🎯 内置包含全部 11 款官方 ClinePass 模型的静态精选目录。
-* 🔐 深度集成 DSH `credentials` 服务 (`~/.dsh/.credentials.yaml`)，凭据隔离无泄漏。
-* 🔄 一键写入 DSH `llm-pi-ai` 模型注册表。
-* 🩺 设置面板内置毫秒级延迟探测与 Smoke Test 测试生成。
-
----
-
-## 📦 快速安装
-
-在活动的 DeepSeek Harness 配置中安装：
-
-```bash
-dsh plugin --profile web add @goodandready/dsh-clinebot
-```
-
----
-
-## 🔑 凭据配置
-
-在 DSH 凭据文件 (`~/.dsh/.credentials.yaml`) 中添加 ClinePass 密钥：
-
-```yaml
-CLINEBOT_API_KEY: "your-clinepass-api-key"
-```
-
----
-
-## 📄 许可证
-
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)