前言¶
在 DeepSeek Harness(DSH)里接第三方模型,常见做法是自己在 Settings → Models 里填 endpoint、协议、模型列表和凭据。Cline 的 ClinePass 订阅走的是常规 Cline API(https://api.cline.bot/api/v1,OpenAI Chat Completions 协议),模型 id 使用 cline-pass/* 命名空间;而 DSH 自带的提供商目录里并没有这个名字下的路由。若手工逐项对齐,还要处理「拉取可用模型」时 endpoint 返回的是按量计费目录、与订阅 slug 不一致等问题。
下面介绍社区插件 dsh-plugin-clinepass(维护者 kolawong,分类:模型推理):在激活时向 llm-pi-ai 的用户层幂等地写入 clinepass 路由(endpoint、协议、展示名、凭据引用、实时拉取的模型列表),之后你只需在模型设置页粘贴 API Key。
这是什么¶
dsh-plugin-clinepass 是一个 DSH bundle,把 ClinePass 注册为 llm-pi-ai 的一条已配置路由。ClinePass 是 Cline 的低价订阅档(README 写明约 $9.99/月,在常用开源编码模型上约有 2–5 倍用量),底层仍走 https://api.cline.bot/api/v1。
插件不改动 DSH 源码,也不接管其他路由;凭据由 DSH 原生凭据服务保存。当前 package 版本为 1.1.0,许可证 MIT,要求 Node.js >= 18,peer 依赖 @deepseek-ai/cordis(>=4.0.0)与 @deepseek-ai/schemastery(>=3.18.5)。
核心功能¶
安装并激活后,能力都走 DSH 原生路径:
- Settings → Models 上出现 ClinePass 卡片,主字段只有 API Key;折叠的「自定义设置」仍可改 endpoint、协议和模型列表。
- 模型选择器里出现当前 ClinePass 订阅模型(如
cline-pass/glm-5.3、cline-pass/kimi-k3、cline-pass/deepseek-v4-pro等),列表实时拉取,插件不内置硬编码模型表作为唯一来源。 - 卡片上的 fetch available models 只返回订阅相关的
cline-pass/*id,而不是 endpointGET /api/v1/models上的按量计费目录(该列表在 2026-10-06 复验时约 464 条,且不含cline-pass/*)。
为何不在「添加提供商」下拉框里? 该下拉只列尚未配置的目录项;本插件在激活时就把 ClinePass 预置为已配置卡片,因此无需从下拉挑选,打开 Settings → Models 即可看到。
插件还提供探测规格表:对已知模型 id 补全 context、max output、是否支持 image 等字段(Cline 的 API Key 可访问端点不暴露完整 per-model 规格)。规格仅在激活时填充路由上缺失的字段,不会覆盖你已在页面上改过的值。模型列表本身仍来自 models.dev 的 cline-pass 提供商目录与 endpoint 探测的合并(约六小时缓存);若所有来源不可达,列表为空并打 warn 日志,而不是回落到过时内置表。
幂等与边界:
| 会做 | 不会做 |
|---|---|
幂等地 seed clinepass 路由(endpoint、协议、展示名、凭据引用、实时模型) |
修改 dsh 源码或其它路由 |
将「拉取可用模型」限定在 cline-pass/* |
自行存储 API Key |
| 交给原生 Models 页、凭据与流式适配层 | 覆盖你已写好的配置 |
路由 key 若与运行时目录中已有提供商冲突,默认拒绝 seed 并警告一次,避免 shadow 别人的 endpoint;可改 routeKey 或设 allowReservedRouteKey: true 故意接管。在插件配置里设 seed: false 可完全关闭 seeding。在 Models 页删除卡片仅对本会话有效,下次激活会重新 seed;若要永久去掉卡片,应设 seed: false 而非只删 UI。
安装与启用¶
README 给出的安装方式如下(无 dsh plugin add github:... 一类命令,请按原文操作):
# Option A: hot-assemble with the dev injector (no restart; also records the
# bundle in the profile's bundle list)
# dev_install_package /path/to/dsh-plugin-clinepass --profile web
# Option B: manual
# 1) add this directory to the profile dependencies (link or file) and to
# dsh.profile.bundles;
# 2) restart DSH.
激活后,插件把路由写入 llm-pi-ai 设置的用户层(与 Models 页自行保存相同,持久化在 profile 的 cordis.patch.yml)。之后:
Settings → Models → ClinePass → 粘贴 API Key(在 app.cline.bot → Settings → API Keys 创建)→ Apply
插件以当前 DSH 进程权限运行;安装前请自行查看 GitHub 仓库 源码与 MIT 许可证,确认符合你的环境与合规要求。
典型用法¶
- 按上一节完成 Option A 或 Option B,确保 bundle 出现在 profile 的 bundle 列表中。
- 打开 Settings → Models,找到已预置的 ClinePass 卡片。
- 填入 ClinePass API Key 并 Apply。
- 在对话或 Agent 的模型选择器里选用
cline-pass/*模型;需要刷新列表时使用卡片上的 fetch available models。
若你已在 Models 页手工调好 routeKey 或 endpoint,seed 在 key 已解析后不会再次写入。升级插件版本后,一般无需额外操作:下次激活只会补全新版本中探测表带来的空缺规格字段。
适用场景与注意¶
适合: 已订阅或打算使用 ClinePass、希望在 DSH 里用同一套 Models 设置与凭据管理接 cline-pass/* 模型的开发者;不想手工对齐 OpenAI Chat Completions endpoint,也不希望模型发现误采纳按量计费 slug 的场景。
注意:
- ClinePass 订阅与定价以 Cline 官方文档为准;插件只负责 DSH 侧路由与发现逻辑。
MiMo-V2.5-Pro、Qwen3.7 Max等模型在探测表中标记为不接受 image 输入;Muse Spark 1.3 Contributor等为目录共识、区域限制且未探测,选用前请自行验证。- 社区目录 SkillHub 插件页 与 GitHub 仓库由维护者 kolawong 发布,与 DeepSeek / 幻方无官方从属关系;DSH 生态强调「一切皆插件」,安装第三方 bundle 前请审查代码与权限。
结尾¶
dsh-plugin-clinepass 把 ClinePass 收成 DSH 里一张只需填 API Key 的模型卡片,并约束模型发现范围在 cline-pass/*,避免与按量计费目录混淆。需要细节、配置项与探测规格表时,以 README 为准。