ClinePass 模型接入 kolawong/dsh-plugin-clinepass

dsh-plugin-clinepass

把 ClinePass 作为模型服务商接入 DeepSeek Harness：装好之后，只要在「设置 → 模型」里填一个 API key 就能用。

ClinePass 是 Cline 的低价订阅档（$9.99/月，热门开源编程模型可用量 2–5 倍）。它走标准 Cline API（https://api.cline.bot/api/v1，OpenAI Chat Completions），模型 slug 形如 cline-pass/。DSH 的服务商目录里没有这个名字，所以这个小包把它注册成一条一等公民的 llm-pi-ai 路由。

你能得到什么

一切都走 DSH 原生路径：

- 设置 → 模型里一张 ClinePass 卡片，主字段只有 API key（折叠起来的自定义设置区域仍可改 endpoint、协议和模型列表）；
- 模型选择器里列出当前 ClinePass 订阅模型（cline-pass/glm-5.3、cline-pass/kimi-k3、cline-pass/deepseek-v4-pro 等）——实时拉取，绝不写死；
- 卡片上的拉取可用模型返回订阅源此刻公布的内容，而不是 endpoint 那份按用量计费的清单（见下文）。

为什么「添加服务商」下拉里没有 ClinePass？ 那个下拉只列未配置的目录服务商（一个领养入口）。插件已经把 ClinePass 预置成一张已配置的服务商卡片，所以它不在下拉里，也永远不需要从下拉里选——打开「设置 → 模型」，卡片已经在那儿了，跟任何手动声明的路由一样。

安装

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 设置的用户层——就是「模型」页面自己执行的那次写入，持久化在配置档的 cordis.patch.yml 里——之后只剩一步：

设置 → 模型 → ClinePass → 粘贴 API key（app.cline.bot → Settings → API Keys）→ 应用

它做什么 / 不做什么

| 做 | 不做 |
| 幂等地写入 clinepass 路由（endpoint、协议、显示名、凭据引用、实时拉取的模型） | 碰 dsh 源码或任何其他路由 |
| 把「拉取可用模型」限定在 cline-pass/ slug | 管 key 存储（原生凭据服务负责） |
| 之后把一切交给原生「模型」页面 / 凭据 / 流式适配器 | 覆盖你已有的配置 |

写入是幂等且非破坏性的：路由键一旦能解析出来（在「模型」页面手调过，或已写进 cordis.patch.yml），插件就不再写它。在插件配置里设 seed: false 可完全关闭写入。

路由键冲突：如果 routeKey 已经在 llm 运行时的目录里指向某个服务商——已安装的目录占用了它，或者另一个插件注册了它——播种会被拒绝，只给一条警告，而不是去遮蔽那条路由的 endpoint、protocol 和凭据引用（那也会在 llm-pi-ai 的目录提交里撞车）。挑一个空闲的 key，或者设 allowReservedRouteKey: true 主动接管这个 key。警告按每次播种运行触发，不是按每次激活：改一次插件配置就会重跑播种，所以没变的坏 key 会再警告一次——这正是新挑的保留 key 暴露出来的方式。这道防护是尽力而为：如果目录完全读不到，播种照常进行，只在日志里记一笔，而不是阻塞，因为目录读不到不是让路由不播种的理由。

移除语义：卡片可以在 Models 页面移除（路由只存在于用户层）。移除立即生效，并在本次会话余下时间被尊重；下一次激活（重启或热重载）发现路由不见了，会重新播种。要永久下线这张卡片，设 seed: false，而不是删掉它。

探测事实表（用于修正，不是目录）

模型列表本身始终实时拉取（见下一节）。插件附带的是探测事实表，只对认识的 id 修正拉取到的行：input（text/image）是探测事实——2026-09-29 对实时 API 每个模型发一次图片请求和一次文本请求：

| 模型 | id | 上下文 | 最大输出 | 图片 |
| GLM-5.3 | cline-pass/glm-5.3 | 1,000,000 | 131,072 | ✅ |
| GLM-5.3 Flash | cline-pass/glm-5.3-flash | 1,000,000 | 131,072 | ✅ |
| Kimi K3 | cline-pass/kimi-k3 | 1,048,576 | 131,072 | ✅ |
| DeepSeek V4 Pro | cline-pass/deepseek-v4-pro | 1,000,000 | 384,000 | ✅ |
| DeepSeek V4.1 Flash | cline-pass/deepseek-v4.1-flash | —（保守默认值） | —（保守默认值） | ✅ |
| MiMo-V2.5 | cline-pass/mimo-v2.5 | 1,048,576 | 131,072 | ✅ |
| MiMo-V2.5-Pro | cline-pass/mimo-v2.5-pro | 1,048,576 | 131,072 | ❌ 拒绝图片输入 |
| MiniMax M3 | cline-pass/minimax-m3 | 1,048,576 | 512,000 | ✅ |
| Muse Spark 1.3 Contributor | cline-pass/muse-spark-1.3-contributor | 1,048,576 | 131,072 | ⚠️ 目录共识；区域锁定，未探测 |
| Qwen3.8 Max | cline-pass/qwen3.8-max | 1,000,000 | 131,072 | ✅ |
| Qwen3.7 Max | cline-pass/qwen3.7-max | 1,000,000 | 131,072 | ❌ 拒绝图片输入 |
| Qwen3.7 Plus | cline-pass/qwen3.7-plus | 1,000,000 | 65,536 | ✅ |

规格从哪来（为什么没法从 ClinePass 拉取）：Cline 在任何可用 API key 访问的 endpoint 上都不发布逐模型规格——GET /api/v1/models 只带 id/object/created/owned_by，模型详情 endpoint 需要 app 的账号会话，文档表格没有参数字段。上面的上下文/输出值继承自 pi-ai 内置目录（2026-09-29；优先厂商官方条目——moonshotai、deepseek、 xiaomi、minimax、qwen-token-plan，然后是编码计划聚合器 opencode-go），而图片列是针对每个模型向实时 ClinePass API 探测得到的结果（比目录更准确，目录声明 GLM-5.3 和 DeepSeek V4 Pro 仅支持文本，尽管 Cline 的部署实际提供图片）。deepseek-v4.1-flash 在任何地方都没有目录条目，因此沿用 llm-pi-ai 的保守默认值（262144/32768）：少报只会更早触发压缩，绝不会让上下文溢出。

规格自动填充：每次激活时，插件只填充现有路由上缺失的规格字段——任何人设置的值、任何人添加或删除的模型都不会被改动。填充来源是这张探测表（或你固定的 models 列表），绝不是注册表的声明。升级插件无需任何操作：下次激活时会填充新版本带来的所有新规格。

为什么「获取可用模型」被包装

Cline 的 GET /api/v1/models 枚举的是用量计费目录（厂商 slug 如 zai/glm-5.3，464 个条目，2026-10-06 重新验证确认不含 cline-pass/ id）。订阅模型使用 cline-pass/ 别名命名空间（已验证：cline-pass/glm-5.3 底层路由到 zai/glm-5.3）。直接透传该列表会让用户采用不计入订阅的 slug，因此卡片的发现结果被限定为 cline-pass/ id。

模型列表是获取来的，从不随包发布。 事实来源是 models.dev cline-pass 服务商的计划目录——截至 2026-10-06 共 18 个模型，包括 mimo-v2.6-pro、mimo-v2.6-flash、kimi-k2.6、kimi-k2.7-code、glm-5.2 和 deepseek-v4-flash——再与端点探测返回的任何 cline-pass/ id 合并。同一次获取在播种时填充路由的模型列表。Cline 新增的模型无需插件发版：下次「获取可用模型」时就会出现（六小时缓存）。这里刻意没有内置回退列表：如果所有来源都不可达，结果为空（并记录一条警告日志），而不是用陈旧目录声称计划可能已不再提供的模型——唯一例外是运维人员固定的 models 列表，那是明确意图，始终优先作为结果。

探测到的事实仍然优先于目录声明。 探测表认识某个 id 时，其逐模型图片支持结果会替换注册表的声明（models.dev 声称 qwen3.7-max 支持图片输入；实时路由拒绝），而缺失的上下文/输出上限只会被填充。探测表不认识的新 id 会带着注册表自己的声明直接通过。

即使探测不贡献任何 cline-pass/ id，仍然会执行：它是路由的实时凭据检查。

被拒绝的密钥不会被掩盖：提供过但被拒绝的密钥——格式错误或为空的存储值（INVALID_CREDENTIAL），或端点返回 401/403（DISCOVERY_FAILED，附带 harness 的「检查 API key」提示）——在卡片上直接暴露 harness 自身的错误，而不是返回模型列表。其他所有失败（卡片未配置、端点不可达或无法解析、注册表故障）都只是把答案收窄到那些确实有响应的来源。

配置

插件配置放在配置档的 cordis.patch.yml 里（条目 id 为 clinepass），可在插件设置页编辑：

| 字段 | 默认值 | 含义 |
| seed | true | 路由不存在时写入种子；false 关闭 |
| routeKey | clinepass | llm-pi-ai 路由键（Models 页的卡片键） |
| allowReservedRouteKey | false | 即使 routeKey 已在 llm 运行时的目录中指向某个服务商，也照样写入种子（这次写入会遮蔽目录路由的端点、协议、凭据引用，或与另一个插件的路由冲突）；需主动开启 |
| displayName | ClinePass | 选择器中显示的名称 |
| apiKeyEnv | CLINEPASS_API_KEY | 凭据引用；设为 CLINE_API_KEY 即可复用已有的 Cline 凭据，无需手动输入 |
| baseURL | https://api.cline.bot/api/v1 | Cline API 端点 |
| api | openai-completions | 传输协议 |
| models | （空——实时拉取）* | 运维方固定的模型列表；为空时，种子会拉取 models.dev 的 cline-pass 命名空间，发现流程只从实时来源取答案 |

要求

- llm-pi-ai（随 DSH 发布）——路由的宿主命名空间。缺少它时，插件只记一条警告，不写入任何内容。
- settings 服务。
- 共享的 @deepseek-ai/schemastery ≥3.18.5（harness 自带的副本）——Config.meta.volatile 需要 volatile 支持才能实时编辑配置；peerDependencies 声明了同样的下限。
- llm 运行时的服务商目录（listConfigurableProviders，由 dsh-llm 提供），用于 routeKey 冲突防护。没有 llm 服务时种子仍会运行，只是没有防护。

许可证

MIT