jiesou/dsh-cline-free-provider

Plugin插件 Native原生 ⭐ 11 MIT Models & Routing模型与路由

Cline 免费模型接入 DeepSeek Harness

Project Overview项目介绍

This is a native DSH model routing plugin that enables DSH to access free large language models provided by Cline. It supports all free models available through Cline, including popular options like DeepSeek V4 Flash, GLM 5.3 Flash, and Muse Spark 1.3, alongside all free models hosted on OpenRouter. Users who have an active Cline Pass subscription do not need this plugin, as they can configure the official Cline API directly in DSH without additional extensions.

Installing this plugin is straightforward through DSH's built-in plugin manager. The recommended method is to install the pre-built package from npm, by running the command dsh plugin --profile web add @jiesou/dsh-cline-free-provider in your terminal. You can also install the plugin directly from the GitHub repository by using the alternate dsh plugin --profile web add github:jiesou/dsh-cline-free-provider command. After installation, you need to generate a Cline API key from the official Cline bot dashboard, then save it to DSH's credential service.

All configuration options for this plugin are optional, and it works out of the box with default values. The plugin only fetches the free model directory once when it starts up, and does not poll for updates periodically, since Cline’s model list changes very slowly. If the upstream Cline service is unreachable at startup, the plugin simply loads an empty model list instead of crashing the plugin or the DSH interface. All upstream errors are passed through directly, so you can easily diagnose issues, and this plugin is released under the open-source MIT license.

这是一个专为DeepSeek Harness(DSH)开发的原生模型路由插件,核心功能是将Cline提供的免费大语言模型接入DSH使用。Cline提供了OpenRouter平台可用的多款免费模型,还包括DeepSeek V4 Flash、GLM 5.3 Flash、Muse Spark 1.3这些热门模型。如果用户已经订阅Cline Pass计划,按照官方文档直接配置官方接口和API Key即可,不需要安装本插件。

本插件面向希望在DSH中使用免费大语言模型的用户,安装流程非常简便。推荐从npm安装预构建产物,执行命令dsh plugin --profile web add @jiesou/dsh-cline-free-provider即可,也可以直接从GitHub源码安装,执行对应命令即可。安装完成后,用户需要先从Cline官方仪表盘获取API Key,再将其存入DSH的凭证服务,变量名设置为CLINE_API_KEY,随后就可以在模型页面选择使用了。

本插件所有配置项均为可选,使用默认配置即可直接运行,仅在需要自定义时才需要修改。插件仅在启动时拉取一次免费模型列表,不会后续轮询更新,因为上游模型变动频率很低。启动时如果上游服务不可达,只会暂时加载空列表,不会拖垮插件或DSH界面,上游错误也会原样透传,方便排查问题。本插件采用MIT许可协议开源。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 11 stars - an early-stage project星标 11,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 jiesou/dsh-cline-free-provider 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-cline-free-provider

Cline Free provider for dsh.

English

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

截图 2026-08-17 10-39-41

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
配置项 类型 默认值 说明
apiKeyEnv string "CLINE_API_KEY" 读取 API Key 的环境变量名(或 credential ref)
baseURL string "https://api.cline.bot/api/v1" Cline 网关 base URL
defaultMaxTokens number 32768 模型无精确 maxTokens 时的兜底值
defaultContextWindow number 262144 模型无精确 contextWindow 时的兜底值
maxRequestImageBytes number 2097152(2 MiB) 单次请求允许内联的 base64 图片字节上限
requestImageMaxBytes number 1048576(1 MiB) 单张图片重编码后的字节上限

图片

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

← 上一个 Prev dsh-global-rules 下一个 Next dsh-usage-stats →