前言¶
DeepSeek Harness（DSH）对 API Key 类模型提供商已经有较完整的接入方式。另一类常见情况是：开发者已经在 WorkBuddy CN、Qoder CN 或 Trae CN 上持有订阅或账号权益，希望通过官方登录流程在 DSH 里选模型、发请求，而不是把密钥散落在多处工具里各自配置。
dsh-hitchfin 面向后者：把上述三个渠道的订阅模型作为原生 DSH 模型提供商接入，并在此基础上提供多账号故障转移、按账号 HTTP(S) 代理、免费模型过滤与模型可见性管理。下文介绍其定位、能力、安装步骤与使用注意。
这是什么¶
dsh-hitchfin 由维护者 LuckyOneTwoThree 发布，当前版本为 0.4.0，许可证 MIT，在 SkillHub 等社区目录中归类为模型推理类 DSH 插件。
插件不试图绕过厂商限额、不做账号共享或自动签到；凭证保存在本机 DSH 的凭证存储中，请求经各渠道官方适配包走向厂商端点（可按账号配置代理）。
核心功能¶
以下能力均来自项目 README 与 package.json 说明。
官方渠道与登录¶
- 支持 WorkBuddy CN、Qoder CN、Trae CN，使用官方图标与官方登录流程。
- 一键浏览器登录：点击浏览器登录会通过系统默认浏览器打开官方授权 URL（macOS / Windows / Linux 分别对应
open、rundll32、xdg-open）；部分渠道还支持 API Key 或 PAT。 - 设置页为原生 DSH 体验：渠道 Tab、内联额度进度、账号菜单、按账号代理编辑、模型管理、暗色模式等。
多账号与自动故障转移¶
- 同一渠道可绑定多个账号，增删或重新认证互不影响。
- 路由键为 provider + model + session；某账号在一次会话内成功使用后会成为该键的优先账号，有利于 prompt cache 局部性。
- 若在首个流式分片发出之前失败（认证、额度、限流、服务端或传输错误等），适配器会尝试其他已登录账号；一旦已有内容输出，不会在流中间切换账号，避免重复文本。
- 失败账号进入冷却；全部账号都在冷却时，DSH 会收到明确的重试时间，而不是持续重试厂商。
冷却窗口（节选）：
| 失败类型 | 冷却时间 |
|---|---|
| AUTH | 10 分钟 |
| QUOTA | 15 分钟 |
| RATE_LIMIT | 60 秒，或厂商提供的 Retry-After |
| SERVER | 60 秒 |
| TRANSPORT | 30 秒 |
| MODEL_NOT_FOUND | 30 分钟（限定该账号与该模型） |
重新认证、修改代理或移除账号会清除对应路由状态。
按账号 HTTP(S) 代理¶
代理仅作用于该账号的登录、模型列表、用量与对话请求；其他账号仍直连。界面中对代理凭据做掩码，且不写入日志。
免费模型过滤与模型可见性¶
- 仅免费模型默认开启；有免费/付费元数据的渠道会按此过滤；Trae CN 目前无该元数据，因此展示完整模型列表而非全部隐藏。
- 可搜索目录、隐藏单个模型，或一键隐藏付费模型；可见性设置作用于整个渠道。
隐私与范围¶
- 凭证经 DSH 凭证服务存储；插件不把 token 写入自有配置，也不在设置页渲染进程中暴露明文。
- 设置页仅接收模型列表、额度摘要、掩码后的账号标签与掩码后的代理 URL。
- 插件不运行遥测，除各渠道包设计的厂商端点外不上传账号数据。
渠道支持现状¶
厂商目录、额度与免费档规则可能随时变化；下表为 README 中的维护状态摘要。
| 渠道 | 状态 | 登录方式 | 免费/付费元数据 |
|---|---|---|---|
| WorkBuddy CN | Stable | 浏览器、API Key | 有 |
| Qoder CN | Stable | 浏览器、PAT | 有 |
| Trae CN | Experimental | 浏览器 | 无（展示全部模型） |
安装与启用¶
环境要求¶
- DSH >= 0.2.2-rc.1
- Node.js >= 20.18.1（当前 DSH Desktop 内置运行时通常已满足）
- macOS、Windows 或 Linux
安装方式¶
从 DSH 插件市场（上架后）：打开 Plugins → Discover，搜索 dsh-hitchfin，在卡片上安装；若宿主提示则重启 DSH。
从 npm（Web / CLI profile，包发布后）：
dsh plugin --profile web add dsh-hitchfin
从本地构建：
npm install
npm run build
npm pack
dsh plugin --profile web add ./dsh-hitchfin-0.4.0.tgz
DSH Desktop profile 由 Electron 应用管理，宜通过应用内 Plugins 页或插件市场安装，而非手改 desktop profile。
安装完成后，在 DSH 中打开 Settings → 订阅接入。
典型用法¶
- 打开 Settings → 订阅接入，选择 WorkBuddy CN、Qoder CN 或 Trae CN 之一。
- 选择登录方式：浏览器登录会自动调起默认浏览器；若渠道提供 API Key / PAT，也可选用。
- 除非明确需要付费模型，保持 Free models only（仅免费模型） 开启。
- 该渠道的模型会出现在 DSH 模型选择器中；可随时添加第二账号或为某账号配置代理。
经过上述步骤，对话请求会按多账号路由与冷却策略在已登录账号间调度；模型可见性可在同一设置流程中调整。
适用场景与注意¶
适合谁：已在 WorkBuddy / Qoder / Trae 拥有合规个人账号或订阅，希望在 DSH 统一选型与对话，并需要多账号容灾或按账号走代理的开发者。
运行权限：插件以当前 DSH 进程权限运行，可访问其声明的网络与凭证接口；安装前建议在 GitHub 查看源码与 MIT 许可证，确认与自身合规要求一致。
生态说明：DSH 采用「一切皆插件」思路；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系，不宜理解为官方应用商店。
免费档位由厂商提供，可能调整或下线；请遵守各厂商服务条款。
结尾¶
dsh-hitchfin 填补的是「订阅制官方登录渠道」接入 DSH 的空位：多账号故障转移、按账号代理与模型可见性，均在设置页 订阅接入 内完成。进一步了解可从社区目录页与仓库 README 核对版本与渠道状态。
- 目录页：https://www.skillhub.cn/plugins/LuckyOneTwoThree/dsh-hitchfin
- GitHub：https://github.com/LuckyOneTwoThree/dsh-hitchfin
