Chuyển đến nội dung chính

dsh-cline-pass

Đã xác minh

dsh-cline-pass · v0.2.8 · MIT · Giao diện web

Self-contained Cline Pass provider for dsh: register Cline Pass subscription models on the harness LLM seam, enumerate and validate the upstream channels behind each model, pin or exclude them with failover, and drive an account pool. No proxy process and

Cài đặt

dsh plugin add dsh-cline-pass

Xác nhận layer đã áp bằng dsh --profile default --dump-config — xem hướng dẫn cài plugin.

Mã nguồn

Phát hành lên npm mà không có repository công khai. Hãy kiểm tra nội dung package trước khi cài.

Thẻ

Tác giả

Readme

dsh-cline-pass

将 Cline Pass 订阅模型接入 DeepSeek Harness。安装为 dsh 插件后,模型会直接出现在模型列表中,无需运行代理服务。

功能

  • 使用 Cline Pass 订阅模型
  • 支持流式输出、工具调用、图片和 reasoning
  • 管理多个账号并轮询使用
  • 探测、测试、钉住或排除上游渠道
  • 在首个 token 前自动故障转移
  • 提供 Web 设置面板和 cline_pass_* 工具

要求

  • dsh >= 0.1.2-alpha.3 < 0.3.0
  • Node.js >= 20.3
  • Cline Pass API Key

安装

dsh plugin --profile web add dsh-cline-pass

也可以安装本地目录或 tarball:

dsh plugin --profile web add /path/to/dsh-cline-pass
dsh plugin --profile web add ./dsh-cline-pass-<version>.tgz

安装后重启 dsh。

配置

Web profile 可以在 设置 → Cline Pass 中保存和测试 Key。Key 会存入 dsh 凭据库,界面只显示掩码。

也可以在启动 dsh 前设置环境变量:

export CLINE_PASS_API_KEY=sk_xxx
dsh --profile web

多账号

在设置面板中添加账号,并选择单账号或轮询模式。也可以调用工具:

cline_pass_accounts action=add name=main key=sk_xxx
cline_pass_accounts action=add name=backup key=sk_yyy
cline_pass_accounts action=mode mode=roundrobin

配置文件

需要覆盖默认值时,在 profile 的 $DSH_HOME/profiles/<name>/cordis.patch.yml 中添加:

- id: cline-pass
  config:
    accountMode: roundrobin
    accounts:
      main:
        apiKeyEnv: CLINE_PASS_MAIN_KEY
      backup:
        apiKeyEnv: CLINE_PASS_BACKUP_KEY

管理工具

cline_pass_* 工具默认不注册。8 个工具定义合计约 5.5k 字符,会出现在每次请求的工具列表里,而管理路由只是偶尔需要,所以默认让所有对话都不必付这份开销。

需要时在设置 → Cline Pass 中勾选「开启工具注入(重启后生效)」,或在 profile 配置里打开:

- id: cline-pass
  config:
    exposeTools: true

该值在插件激活时读取,改动后需重启 dsh 才生效 —— 已经注册的工具无法从进行中的对话里撤回。

提供商路由和设置面板不受影响 —— 面板是浏览器页面而非工具,工具关闭时仍然可用。

从 0.2.1 及更早版本升级的 profile 里没有 exposeTools 键,因此会采用新的默认值 false:升级后 cline_pass_* 工具将不再注册。面板会提示,勾选该复选框并在重启后恢复。

常用设置包括 baseURL、knownModels、models、perModel、exposeCatalog 和 historyLimit。默认网关地址为 https://api.cline.bot/api/v1。maxConcurrentRequests 限制每个账号同时发往网关的流数,默认 16,超出的请求排队等待空位,设为 0 表示不限。

上游渠道

首次使用模型时,展开面板中的模型行,先点击 探测 获取渠道,再点击 校验 检查各渠道是否确实采用了钉住规则,最后按需要选择渠道顺序或排除渠道。校验会向每个渠道发出一次真实请求,不会自动修改钉住配置;测试 可验证已保存的钉住规则。

也可以按以下顺序调用工具:

cline_pass_probe    model=cline-pass/glm-5.2
cline_pass_validate model=cline-pass/glm-5.2
cline_pass_pin      model=cline-pass/glm-5.2 upstreams=["alibaba","baseten"] pinMode=preferred

pinMode 支持 strict 和 preferred。preferred 会按顺序尝试渠道,并在首个 token 前失败时自动切换。exclude 可排除指定渠道。

工具

工具 用途
cline_pass_status 查看路由和账号状态
cline_pass_models 查看模型和渠道
cline_pass_probe 探测渠道
cline_pass_validate 测试每个渠道
cline_pass_test 验证当前设置
cline_pass_pin 保存渠道设置
cline_pass_accounts 管理账号
cline_pass_history 查看请求历史

开发

npm test
npm run test:client
npm run test:mount

访问真实网关的测试还包括:

npm run test:live
npm run test:live:image
npm run test:live:reasoning

这些命令需要有效的 Cline Pass Key,并会产生少量请求费用。

致谢

上游渠道和故障转移行为参考了 MIT 许可的 cline-pass-switcher。

友情链接

LinuxDo — 真诚、友善、团结、专业,你的品质开源与技术社区

License

MIT