dsh-cline-free-provider

Cline Free provider for dsh.

English

本插件可以将 Cline 的免费模型，接入 dsh 使用。

Cline 提供 OpenRouter 上可用的各种免费模型，以及 DeepSeek V4 Flash、GLM 5.3 Flash、Muse Spark 1.3。

如果你使用的是 Cline Pass 订阅计划，可以直接按照 Cline Pass 官方文档配置官方接口和 API Key，不需要本插件。

获取 API Key：https://app.cline.bot/dashboard/account?tab=api-keys

安装

从 npm 安装（预构建产物，推荐）：

dsh plugin --profile web add @jiesou/dsh-cline-free-provider

或从 GitHub 安装：

dsh plugin --profile web add github:jiesou/dsh-cline-free-provider

安装之后

Cline 的 API Key 通过 DSH credentials 服务保存（变量名为 CLINE_API_KEY，可在 Web Models 页面填写）。

模型列表无需任何配置，插件启动时会自动从远程同步并过滤所有免费模型。在 Web Models 页面选择 Cline provider 和模型后即可开始使用。

配置项

全部可选，默认即可用：

- id: cline-free-provider
  name: '@jiesou/dsh-cline-free-provider'
  config:
    apiKeyEnv: CLINE_API_KEY
    baseURL: https://api.cline.bot/api/v1
    defaultMaxTokens: 32768
    defaultContextWindow: 262144
    maxRequestImageBytes: 2097152
    requestImageMaxBytes: 1048576

图片

Cline 这条线是无状态的：每轮请求都要把历史重新发一遍，所以留在上下文里的图片每轮都会再传一次。

• 每张图片先归一化：2048×2048 像素总预算，再重编码到 requestImageMaxBytes（默认 1 MiB）以内。
• 一轮请求内联的 base64 图片总量超过 maxRequestImageBytes（默认 2 MiB）时，不发请求，而是抛出 IMAGE_OFFLOAD_REQUIRED 并报出需要 offload 的张数。DSH 据此把最旧的图片记入 image/offload 事件并重试；之后每轮都用占位文本代替这些图片的字节，模型仍能从占位文本里读到图片身份和可读路径。
• 已经 offload 的图片不再读取字节、不再编码、不再上传。

两个值都是 base64 口径（比原图字节大约 4/3）。默认组合约等于"1 张整尺寸图 + 1 张半尺寸图"；想更省流量就一起调小，但 maxRequestImageBytes 必须大于 requestImageMaxBytes 的 base64 长度（1 MiB 图约 1.4 MB），否则一张图也放不下。

模型目录与推理档位

插件在启动时拉一次免费模型目录，不轮循。上游轮换慢，一次抓取足矣。挂载时上游不可达也不挂——目录暂时为空、不会拖垮插件或模型界面。

Reasoning effort：模型只暴露上游接受的档位，不造档位。Default 表示"不发送 reasoning_effort"字段，由上游自行决定深度。Off 是真开关——发送上游的关闭字面值（none、off 等）。上游标记为 mandatory 的模型干脆不显示 Off 选项，插件不替它伪造一个。

错误提示：上游拒绝（已结束的免费推广、区域限制等）在终端错误事件里保留真实原因，不会被 harness 当 AUTH 吞掉。真正的鉴权失败仍按 AUTH 走，无法解析的内容原样透传。

License

MIT