前言¶
在 DeepSeek Harness（DSH）里接第三方模型，常见做法是配好 API Key、选 provider，模型就会出现在列表里。Cline 网关对外既有 ClinePass 订阅模型（cline-pass/*），也在推荐接口里列出免费模型（cline-free/*）。但若只带 Authorization 去调 POST https://api.cline.bot/api/v1/chat/completions，免费模型会返回 403，提示仅能在 Cline IDE 扩展与 CLI 等产品面使用。
社区插件 dsh-cline-connect（维护者 gongstudent，分类：模型推理）把上述两族模型注册到 DSH 的 LLM seam：用户只需一个 Cline API Key，无需单独跑代理进程；每个请求会自动带上网关要求的 x-client-type 头。本文介绍它的定位、能力与安装配置，并说明合规与配额方面的实测结论。
这是什么¶
dsh-cline-connect 是自包含的 Cline provider：在 Harness 中暴露 cline-free/* 与 cline-pass/*，并为请求附带 x-client-type: cline-cli（README 写明：DSH 自带的 attributionHeaders() 只返回 user-agent，不会加这个头）。插件当前版本为 0.2.1，MIT 许可；实现以 dsh-cline-pass 为蓝本，目标是同时覆盖免费与订阅两族并替代仅 ClinePass 的旧方案。
- 目录页：https://www.skillhub.cn/plugins/gongstudent/dsh-cline-connect
- 源码：https://github.com/gongstudent/dsh-cline-connect
它解决什么问题¶
Cline 官方文档写明：免费模型不支持通过 Cline API 使用，仅在 Cline IDE Extension 与 CLI 中提供。服务端对免费模型的校验体现为缺少产品面标识时直接 403。README 记录 2026-10-19 实测：网关主要校验 x-client-type 是否存在，而不校验具体取值；带上该头后，免费模型请求可正常返回。本插件的全部核心意义，就是在 DSH 发往 Cline 的请求上补上这一头，并把两族模型发现、参数与用量展示接到 Harness 里。
核心功能¶
以下能力均来自项目 README 与 package.json 描述：
- 模型发现：自动拉取并暴露
cline-free/*与cline-pass/*；免费列表会轮换，插件在激活与手动刷新时重新请求recommended-models，无需等插件发版即可跟上新免费模型。 - 请求行为：每个请求附带
x-client-type: cline-cli；支持流式输出、工具调用、图片与 reasoning。 - 模型元数据：除
recommended-models外，扫描无需鉴权的GET /ai/cline/models目录，按本地名与上游 id 对齐，自动同步上下文窗口、输出上限、输入模态等；免费模型在列表中带 FREE 标记。 - 账号与用量：展示账号配额（5 小时 / 每周 / 每月窗口，免费与订阅共用）；展示免费模型用量（今日 / 近 7 天 / 按模型分解）。
- 界面与工具：提供 Web 设置面板；可选注册
cline_connect_*管理工具（默认关闭，避免每次对话携带工具定义开销）。
环境要求：dsh（README 本机实测 0.2.1-rc.2）、Node.js >= 20.3、一个 Cline API Key。
安装与启用¶
安装命令以 README 为准：
dsh plugin --profile desktop add -w github:gongstudent/dsh-cline-connect
安装后需要重启 dsh，模型才会出现在模型列表中。
插件以 github: 方式安装时，依赖会钉在 profile 的 pnpm-lock.yaml 某一 commit 上；装或更新其他插件可能按锁文件把本插件回退到旧 commit。需要升级时，README 建议显式执行 pnpm update dsh-cline-connect，并在设置面板的「版本与更新」区块查看状态与可复制命令（优先使用 dsh 自带的 pnpm）。
配置 API Key 与 profile¶
Key 在 app.cline.bot → Settings → API Keys 创建。
两种方式任选其一：
- 在 DSH 设置 → Cline Connect 面板填写（存入 dsh 凭据库，界面仅显示掩码）。
- 启动前设置环境变量：
export CLINE_API_KEY=sk_xxx
默认凭据名为 CLINE_API_KEY，可在 profile 配置里改成其他环境变量名。
在 $DSH_HOME/profiles/<name>/cordis.patch.yml 中可覆盖默认项，例如：
- id: cline-connect
config:
apiKeyEnv: CLINE_API_KEY
exposeTools: true
cline_connect_* 工具默认不注册。需要时在设置里勾选「开启工具注入（重启后生效）」，或将 exposeTools 设为 true。设置面板不依赖工具注册，工具关闭时仍可使用。
典型用法¶
- 按上一节安装插件并重启 dsh。
- 配置
CLINE_API_KEY或面板中的 Key。 - 在模型选择器中选择 provider cline-connect 下的目标模型（免费项带 FREE 标记）。
- 正常发起对话即可；流式、工具调用、图片与 reasoning 由插件按模型能力路由。
若你从 dsh-cline-pass 迁移：两插件 provider 路由名不同（本插件为 cline-connect），可并存，但选择器里可能出现两个 provider 下的同名 cline-pass/* 模型；切换后需在 DSH 中重新选择会话模型（按 provider+model 记录）。本插件不提供多账号池与 probe/validate/pin 等能力，为有意的取舍。
模型参数与附件¶
插件通过扫描网关目录自动跟上新模型的窗口与模态；扫描值在窗口、输出、模态上优先于内置表。当前 dsh 模态词汇表仅 text 与 image，附件系统接受 image/png、image/jpeg、image/webp、image/gif，上游报的 video/audio/file 会在 seam 层裁剪。README 注明已知差异：cline-free/solar-mini4 不支持图片输入，对其发图上游可能 500，插件会按模态提前拦截并给出可读错误。
配额与「免费用量」怎么理解¶
README 的实测结论值得单独记住：
GET /users/me/plan/usage-limits的三个窗口是账号级的，免费模型与 ClinePass 共用；加?modelType=cline-free不改变数值。- 不存在单独的「免费专属额度」端点；免费额度在撞到限制前不可见；Cline SDK 通过响应文案识别
free limit reached on model。 - 面板上的免费模型 token 统计来自
GET /users/{id}/usages/daily，按aiModelTypeName（如cline-free）区分族别，不能仅靠aiModelName前缀判断。
因此：免费模型仍会消耗同一套账号配额，并非无限；敏感内容不宜走免费模型（官方写明免费用量可能用于改进模型）。
适用场景与注意¶
适合谁：已在 DSH 中开发智能体或日常对话，希望用单一 Cline Key 同时使用 cline-free/* 与 cline-pass/*，且接受在 Harness 内完成配置、不想自建代理的开发者。
运行与信任边界：插件与当前 dsh 进程同权限运行；安装前应在 GitHub 阅读源码与 MIT 许可证，自行判断是否满足合规与安全要求。
合规与风险（README 原文要点）：
- 官方不鼓励通过 API 使用免费模型；本插件借助
x-client-type: cline-cli产品面标识，存在账号被限制的风险。 - 免费模型列表与可用性随时可能变化，未列出的模型可能直接 404。
- 与 pi-ai 中已注册的
clineprovider 可能因路由名冲突导致DUPLICATE_ADAPTER；本插件路由名刻意使用cline-connect以避免与临时方案撞名。
结尾¶
dsh-cline-connect 把 Cline 网关的免费与 ClinePass 模型接到 DeepSeek Harness：补全 x-client-type、自动发现模型并同步窗口与模态，用一块设置面板和可选管理工具完成 Key 与用量查看。若你要在 DSH 里试 Cline 两族模型，可从社区目录与仓库 README 对照安装命令与配置项。
