前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话，模型来源往往分散：WorkBuddy 桌面端一套账号与目录，Qoder CN 又需要单独维护 PAT 与 jobToken。若只靠各自 provider 或手工改配置，模型选择器里很难并列看到多平台目录，多账号轮换、失败重试和请求观测也缺少统一入口。DSH 社区采用「一切皆插件」的扩展方式；DSH Model Hub（仓库 lifeiyu-44/dsh-model-hub）面向「模型推理」场景，把 WorkBuddy（国际/国内）与 Qoder CN 的模型注册到宿主模型选择器，并在面板里完成账号池、凭据接管与请求记录。
下面介绍插件定位、能力、安装步骤与典型用法；事实以 GitHub README 为准。
这是什么¶
DSH Model Hub 由维护者 lifeiyu-44 发布，MIT 许可，当前 package 版本为 0.1.0。它通过本机回环 shim 向上游转发请求，在 DSH 内提供：
- 多平台模型并列展示（id 带
hub-前缀，如hub-workbuddy-global/…、hub-qoder-cn/…）； - 多账号池（手动优先、故障切换、熔断）；
- WorkBuddy 桌面端加密登录态的内置解密与 Qoder PAT 换 token；
- 请求记录与诊断界面。
面板内「?」按钮附有与 README 一致的使用说明，日常配置可不依赖仓库文档。
核心功能¶
多平台接入¶
WorkBuddy 侧约 25 个模型与 Qoder CN 约 10 个模型会出现在 DSH 模型选择器里。渠道可在面板关闭：关闭后该渠道模型从选择器彻底消失，凭据仍保留。
账号管理与多账号池¶
面板支持增删账号、启用/禁用、设为当前、单账号测试；同一账号按 uid 去重，不会重复出现。
池策略要点（README 表格与正文）：
- 手动优先：「设为当前」的账号作为池头，请求优先使用。
- 故障切换：遇到 401/402/403/429/5xx 等失败时自动换池中下一个账号重试，单请求内重试上限为
min(池大小, 3)。 - 熔断：连续 3 次凭据类失败后冷却 10 分钟，到期自动解冻；全池冷却时仍按序兜底。
凭据自动接管¶
| 来源 | 说明 |
|---|---|
| WorkBuddy 桌面端 | 读取 %LOCALAPPDATA%\CodeBuddyExtension\Data\Public\auth\workbuddy-desktop-ai.info 中的加密信封；插件通过 App 的 native binding 取密钥，AES-256-GCM 解密；解密结果写入 %USERPROFILE%\.dsh\model-hub\workbuddy-tokens\（0600） |
| Qoder CN | 面板粘贴 pt- 开头的 PAT，插件换 jobToken 并写入 model-hub/qoder-pats/ |
| 历史 vault | %USERPROFILE%\.dsh\workbuddy-vault\ 只读，可扫描导入 |
插件数据库只存凭据引用（文件路径），不存明文；日志隐去 token/PAT 全文。
请求记录与诊断¶
每次上游尝试记一行：token 数、TTFT、tok/s、状态码、归属账号；故障切换时失败与成功两次尝试均可见。记录弹层支持筛选与导出 CSV。诊断栏提供凭据路径、token 有效期、shim 地址、上游错误原文（便于贴 issue）。
思考档位¶
WorkBuddy 目录未逐模型标注 reasoning，插件对 25 个模型统一声明支持 reasoning_effort（上游不支持的会忽略）。Qoder 按目录 is_reasoning 声明。选中支持思考的 hub 模型后，DSH 输入框模型选择器会出现「思考强度」（off/minimal/low/medium/high），并按模型记忆。
安装与启用¶
前置条件：Node.js ^22.19.0 || >=24，以及已安装的 DSH 本体（插件通过 peerDependencies 使用宿主 @deepseek-ai/dsh-* 包）。
构建产物 lib/、client.js 已随仓库提交，普通用户无需本地构建。
从 GitHub 安装：
dsh plugin add github:lifeiyu-44/dsh-model-hub
也可在 GUI：侧边栏 插件 → 添加插件 → 粘贴 github:lifeiyu-44/dsh-model-hub。
指定 tag 安装：
dsh plugin add github:lifeiyu-44/dsh-model-hub#v0.1.0
npm 包名安装（包发布后）：
dsh plugin add dsh-model-hub
装完重启 DSH，打开 设置 → 插件 → DSH Model Hub 配置账号。
插件配置项（Config，改完即生效）：
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true | 总开关；关闭需重载插件 |
recordEnabled |
true | 是否写入请求记录 |
retentionDays |
90 | 明细保留天数；聚合永久保留 |
典型用法¶
WorkBuddy：换号后一键认证¶
- 在 WorkBuddy 桌面端登录目标账号。
- 打开 DSH Model Hub 面板，使用 一键认证：插件读取桌面端加密登录态、解密、验活，按 uid 去重后新增或刷新账号行。
- 需要优先使用的账号点 设为当前。
同一账号重复认证只刷新该行，不会 duplicate。
Qoder：粘贴 PAT¶
- 在 https://qoder.com.cn/account/integrations 创建 PAT（
pt-开头）。 - 面板 + 添加账号 → 粘贴 PAT；备注留空则使用 userinfo 真名。
- 验活通过后账号进入池，渠道 runtime 启动。
观测与排错¶
- 记录 栏看今日摘要与最近明细；需要完整表时用「查看全部 →」。
- 诊断 栏核对 shim、凭据路径与上游错误原文。
- 读
%USERPROFILE%\.dsh\model-hub\status.json中的ok、modelCount与失败原因（部署自检亦用此文件）。
常见写接口错误：origin_not_allowed / host_not_allowed（非本机请求）、bad_request、payload_too_large（body 超过 64KB）。
适用场景与注意¶
适合谁：已在 WorkBuddy 桌面端或 Qoder CN 有可用凭据、希望在 DSH 单一界面选模型、并需要多账号轮换与请求可观测的开发者。
安装前建议：插件以当前 DSH 进程权限运行，会读取本机 WorkBuddy auth 文件、写入 .dsh/model-hub/ 下的 token/PAT 文件，并起本机回环 shim。安装前应阅读 仓库源码与 MIT 许可证，确认凭据边界与安全说明符合你的环境策略。
已知限制（README）：WorkBuddy 渠道校验可能随上游变化；目录拉取失败时渠道暂无 runtime，需下次写操作或重启重试；5xx 触发的请求内换号对非幂等上游存在理论上的重复副作用（重试上限 min(池, 3)）；记录明细上限 2000 行。
社区插件目录见 SkillHub 条目，与 DeepSeek / 幻方无官方从属关系。
结尾¶
经过上面的步骤，DSH Model Hub 把 WorkBuddy 与 Qoder CN 的模型目录、账号池与请求诊断收拢到 DSH 插件面板，减少在多套客户端与配置文件之间切换的成本。进一步细节与开发结构见 GitHub：lifeiyu-44/dsh-model-hub。
