dsh-cline-pass 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 dsh-cline-pass contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The Cline Pass routing behavior implemented here (the two routing pipelines, the
+pin encoding for each, upstream channel enumeration, and the failover
+semantics) follows findings published by the MIT-licensed cline-pass-switcher
+project: https://github.com/munmunjaklin458-afk/cline-pass-switcher

package/README.en.md

@@ -0,0 +1,124 @@
+# dsh-cline-pass
+
+Connect [Cline Pass](https://cline.bot/cline-pass) subscription models to the [DeepSeek Harness](https://github.com/deepseek-ai). Install it as a dsh plugin and the models appear in the model list without running a proxy service.
+
+## Features
+
+- Use Cline Pass subscription models from dsh
+- Streaming, tool calls, image input, and reasoning
+- Multiple accounts with optional round-robin rotation
+- Probe, test, pin, or exclude upstream channels
+- Automatic failover before the first token
+- Web settings panel and `cline_pass_*` tools
+
+## Requirements
+
+- dsh `>= 0.1.2-alpha.3 < 0.2.0`
+- Node.js `>= 20.3`
+- A Cline Pass API key
+
+## Install
+
+```bash
+dsh plugin --profile web add dsh-cline-pass
+```
+
+You can also install a local directory or tarball:
+
+```bash
+dsh plugin --profile web add /path/to/dsh-cline-pass
+dsh plugin --profile web add ./dsh-cline-pass-0.1.0.tgz
+```
+
+Restart dsh after installation.
+
+## Configure
+
+With the Web profile, open **Settings → Cline Pass** to save and test a key. Keys are stored in the dsh credential store and shown only in masked form.
+
+You can also set an environment variable before starting dsh:
+
+```bash
+export CLINE_PASS_API_KEY=sk_xxx
+dsh --profile web
+```
+
+### Multiple accounts
+
+Add accounts in the settings panel and select single-account or round-robin mode. You can also use the tool interface:
+
+```text
+cline_pass_accounts action=add name=main key=sk_xxx
+cline_pass_accounts action=add name=backup key=sk_yyy
+cline_pass_accounts action=mode mode=roundrobin
+```
+
+### Configuration file
+
+To override defaults, add a `cline-pass` section to your profile's `$DSH_HOME/profiles/<name>/cordis.patch.yml`:
+
+```yaml
+- id: cline-pass
+  config:
+    accountMode: roundrobin
+    accounts:
+      main:
+        apiKeyEnv: CLINE_PASS_MAIN_KEY
+      backup:
+        apiKeyEnv: CLINE_PASS_BACKUP_KEY
+```
+
+Common settings include `baseURL`, `knownModels`, `models`, `perModel`, `exposeCatalog`, and `historyLimit`. The default gateway is `https://api.cline.bot/api/v1`.
+
+## Upstream channels
+
+For a new model, click **Auto-configure** in the panel to probe, validate, and configure channels. Expand a model row to adjust channel order or exclude a channel.
+
+You can also run the tools in this order:
+
+```text
+cline_pass_probe    model=cline-pass/glm-5.2
+cline_pass_validate model=cline-pass/glm-5.2
+cline_pass_pin      model=cline-pass/glm-5.2 upstreams=["alibaba","baseten"] pinMode=preferred
+```
+
+`pinMode` supports `strict` and `preferred`. `preferred` tries channels in order and fails over before the first token when needed. Use `exclude` to block specific channels.
+
+## Tools
+
+| Tool | Purpose |
+| --- | --- |
+| `cline_pass_status` | Show route and account status |
+| `cline_pass_models` | List models and channels |
+| `cline_pass_probe` | Probe channels |
+| `cline_pass_validate` | Test each channel |
+| `cline_pass_test` | Verify the current settings |
+| `cline_pass_pin` | Save channel settings |
+| `cline_pass_accounts` | Manage accounts |
+| `cline_pass_history` | Read request history |
+
+## Development
+
+```bash
+npm test
+npm run test:client
+npm run test:mount
+```
+
+Live gateway checks are also available:
+
+```bash
+npm run test:live
+npm run test:live:image
+npm run test:live:reasoning
+```
+
+These commands need a valid Cline Pass key and make a small number of paid requests.
+
+## Acknowledgements
+
+Upstream channel and failover behavior was informed by the MIT-licensed [`cline-pass-switcher`](https://github.com/munmunjaklin458-afk/cline-pass-switcher).
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,124 @@
+# dsh-cline-pass
+
+将 [Cline Pass](https://cline.bot/cline-pass) 订阅模型接入 [DeepSeek Harness](https://github.com/deepseek-ai)。安装为 dsh 插件后，模型会直接出现在模型列表中，无需运行代理服务。
+
+## 功能
+
+- 使用 Cline Pass 订阅模型
+- 支持流式输出、工具调用、图片和 reasoning
+- 管理多个账号并轮询使用
+- 探测、测试、钉住或排除上游渠道
+- 在首个 token 前自动故障转移
+- 提供 Web 设置面板和 `cline_pass_*` 工具
+
+## 要求
+
+- dsh `>= 0.1.2-alpha.3`
+- Node.js `>= 20.3`
+- Cline Pass API Key
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-cline-pass
+```
+
+也可以安装本地目录或 tarball：
+
+```bash
+dsh plugin --profile web add /path/to/dsh-cline-pass
+dsh plugin --profile web add ./dsh-cline-pass-0.1.0.tgz
+```
+
+安装后重启 dsh。
+
+## 配置
+
+Web profile 可以在 **设置 → Cline Pass** 中保存和测试 Key。Key 会存入 dsh 凭据库，界面只显示掩码。
+
+也可以在启动 dsh 前设置环境变量：
+
+```bash
+export CLINE_PASS_API_KEY=sk_xxx
+dsh --profile web
+```
+
+### 多账号
+
+在设置面板中添加账号，并选择单账号或轮询模式。也可以调用工具：
+
+```text
+cline_pass_accounts action=add name=main key=sk_xxx
+cline_pass_accounts action=add name=backup key=sk_yyy
+cline_pass_accounts action=mode mode=roundrobin
+```
+
+### 配置文件
+
+需要覆盖默认值时，在 profile 的 `$DSH_HOME/profiles/<name>/cordis.patch.yml` 中添加：
+
+```yaml
+- id: cline-pass
+  config:
+    accountMode: roundrobin
+    accounts:
+      main:
+        apiKeyEnv: CLINE_PASS_MAIN_KEY
+      backup:
+        apiKeyEnv: CLINE_PASS_BACKUP_KEY
+```
+
+常用设置包括 `baseURL`、`knownModels`、`models`、`perModel`、`exposeCatalog` 和 `historyLimit`。默认网关地址为 `https://api.cline.bot/api/v1`。
+
+## 上游渠道
+
+首次使用模型时，可以在面板点击 **一键配置**，自动探测、校验和配置渠道。展开模型行可调整渠道顺序或排除渠道。
+
+也可以按以下顺序调用工具：
+
+```text
+cline_pass_probe    model=cline-pass/glm-5.2
+cline_pass_validate model=cline-pass/glm-5.2
+cline_pass_pin      model=cline-pass/glm-5.2 upstreams=["alibaba","baseten"] pinMode=preferred
+```
+
+`pinMode` 支持 `strict` 和 `preferred`。`preferred` 会按顺序尝试渠道，并在首个 token 前失败时自动切换。`exclude` 可排除指定渠道。
+
+## 工具
+
+| 工具 | 用途 |
+| --- | --- |
+| `cline_pass_status` | 查看路由和账号状态 |
+| `cline_pass_models` | 查看模型和渠道 |
+| `cline_pass_probe` | 探测渠道 |
+| `cline_pass_validate` | 测试每个渠道 |
+| `cline_pass_test` | 验证当前设置 |
+| `cline_pass_pin` | 保存渠道设置 |
+| `cline_pass_accounts` | 管理账号 |
+| `cline_pass_history` | 查看请求历史 |
+
+## 开发
+
+```bash
+npm test
+npm run test:client
+npm run test:mount
+```
+
+访问真实网关的测试还包括：
+
+```bash
+npm run test:live
+npm run test:live:image
+npm run test:live:reasoning
+```
+
+这些命令需要有效的 Cline Pass Key，并会产生少量请求费用。
+
+## 致谢
+
+上游渠道和故障转移行为参考了 MIT 许可的 [`cline-pass-switcher`](https://github.com/munmunjaklin458-afk/cline-pass-switcher)。
+
+## License
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,27 @@
+# dsh bundle patch: mounts the self-contained Cline Pass provider.
+#
+# The row is host-plane: it registers an LLM provider route on the harness LLM
+# seam (so `cline-pass/*` models appear to every agent and to the model picker)
+# and registers the `cline_pass_*` management tools in the host tool registry.
+#
+# Defaults are ready to use: base URL https://api.cline.bot/api/v1, one route
+# named `cline-pass`, and the API key read from the CLINE_PASS_API_KEY
+# credential/env. Override any of it in your profile's own
+# $DSH_HOME/profiles/<name>/cordis.patch.yml, which is applied after every
+# bundle layer:
+#
+# - id: cline-pass
+#   config:
+#     apiKeyEnv: CLINE_PASS_API_KEY
+#     accounts:
+#       main:
+#         displayName: Main account
+#         apiKeyEnv: CLINE_PASS_API_KEY
+#       backup:
+#         displayName: Backup account
+#         apiKeyEnv: CLINE_PASS_BACKUP_KEY
+#     accountMode: roundrobin
+
+- insert:
+    - id: cline-pass
+      name: dsh-cline-pass