@dunghoitao/dsh-cline-free-provider

Readme

# dsh-cline-free-provider

Plugin tích hợp các mô hình miễn phí của Cline cho DeepSeek Harness (DSH).

[English](README.en.md)

Plugin này giúp bạn kết nối và sử dụng các mô hình miễn phí từ Cline trực tiếp trên giao diện DSH.

---

## 🌟 Các mô hình hỗ trợ

Plugin cung cấp 3 mô hình miễn phí hàng đầu:

1. **`z-ai/glm-5.3-flash`**:
   - **Tên hiển thị**: `Z.ai: GLM 5.3 Flash (free)`
   - **Dung lượng ngữ cảnh (Context Window)**: 1,310,720 tokens (~1.3M)
   - **Max Output**: 131,072 tokens (128K)
   - **Tính năng**: Đa phương thức (Text + Hình ảnh/Vision), Hỗ trợ suy nghĩ (Thinking: `low`, `high`, `max`)
   - **Alias**: `glm-5.3-flash`, `z-ai/glm-5.3-flash`

2. **`deepseek/deepseek-v4-flash`**:
   - **Tên hiển thị**: `DeepSeek V4 Flash (free)`
   - **Dung lượng ngữ cảnh**: 1,048,576 tokens (~1M)
   - **Max Output**: 64,000 tokens
   - **Tính năng**: Hỗ trợ suy nghĩ (Thinking: `high`, `max`)
   - **Alias**: `deepseek-v4-flash`, `deepseek/deepseek-v4-flash`

3. **`poolside/laguna-s-2.1:free`**:
   - **Tên hiển thị**: `Poolside: Laguna S 2.1 (free)`
   - **Dung lượng ngữ cảnh**: 1,048,576 tokens (~1M)
   - **Max Output**: 32,768 tokens
   - **Alias**: `laguna-s-2.1`, `poolside/laguna-s-2.1`

---

## 🔑 Xác thực & API Key

- **Tự động đọc & làm mới Token từ Cline CLI**: Nếu bạn đã đăng nhập tài khoản trên tiện ích mở rộng Cline, plugin sẽ tự động đọc token từ `~/.cline/data/settings/providers.json` và tự động làm mới token (Auto-Refresh qua WorkOS) khi hết hạn.
- **Dùng API Key vĩnh viễn (Khuyên dùng)**: Bạn có thể lấy API Key tại [app.cline.bot](https://app.cline.bot/dashboard/account?tab=api-keys) và điền vào trang cài đặt của plugin.

---

## 📦 Cài đặt

Cài đặt trực tiếp từ GitHub:

```sh
dsh plugin --profile web add github:khanhdeptraivaicachuong/dsh-cline-free-provider
```

---

## ⚙️ Sau khi cài đặt

- Trong giao diện Web GUI DSH, bạn sẽ thấy trang cài đặt **`Cline (Free)`** tại menu **Settings (⚙️)**.
- Bạn có thể cấu hình API Key, Gateway URL, Timeouts, và xem các thông số model trực tiếp trên Web.

### Cấu hình tùy chọn trong `cordis.patch.yml`

```yaml
- id: cline-free-provider
  name: '@jiesou/dsh-cline-free-provider'
  config:
    apiKeyEnv: CLINE_API_KEY
    baseURL: https://api.cline.bot/api/v1
    modelsUrl: https://api.cline.bot/api/v1/ai/cline/models
    modelsCachePath: ~/.cline/models-cache.json
    requestTimeoutMs: 60000
    streamIdleTimeoutMs: 300000
    defaultMaxTokens: 32768
    defaultContextWindow: 262144
```

| Tùy chọn | Kiểu | Mặc định | Mô tả |
| --- | --- | --- | --- |
| `apiKeyEnv` | `string` | `"CLINE_API_KEY"` | Tên biến môi trường / credential lưu trữ API Key |
| `baseURL` | `string` | `"https://api.cline.bot/api/v1"` | Địa chỉ Gateway của Cline |
| `modelsUrl` | `string` | `"https://api.cline.bot/api/v1/ai/cline/models"` | URL API danh mục model |
| `modelsCachePath` | `string` | `"~/.cline/models-cache.json"` | Đường dẫn file cache model trên máy |
| `requestTimeoutMs` | `number` | `60000` | Thời gian chờ phản hồi đầu tiên (ms) |
| `streamIdleTimeoutMs` | `number` | `300000` | Thời gian chờ luồng rảnh (ms) |
| `defaultMaxTokens` | `number` | `32768` | Giới hạn token xuất ra dự phòng |
| `defaultContextWindow` | `number` | `262144` | Dung lượng ngữ cảnh dự phòng |

---

## 📄 Giấy phép

[MIT](LICENSE)