前言¶
在 DeepSeek Harness（DSH）里接模型，常见做法是：各家 coding agent 各自占一条登录与调用链，再另开一组官方 API Key 或中转地址。换工具、换 IDE 插件时，base_url、模型 id、账号状态往往要对好几遍。dsh-credit-hub（积分汇通）是维护者 Alex663028 发布的 DSH 插件，归类为模型推理；目标是把 WorkBuddy、Raccoon、Qoder、ZCode、MiniMax 等积分渠道，以及自填的官方 API / 中转，收成一条「积分汇通」模型目录，并在本机提供 OpenAI 与 Anthropic 兼容网关，供本地工具统一接入。
这是什么¶
插件全名 dsh-credit-hub，仓库 Alex663028/dsh-credit-hub，目录页见 SkillHub。当前 package.json 标注版本为 0.2.2，许可证 MIT。它在 DSH 设置里以「积分汇通」呈现，不负责替代各平台官方客户端，而是做账号管理、模型汇目录、降级链与本地网关。
设置面板结构¶
启用后进入 DSH 设置 → 积分汇通，README 给出的结构如下：
DSH 设置 → 积分汇通
├─ 总览 汇通模型清单 / 各来源状态 / 开关
├─ WorkBuddy 腾讯 CodeBuddy·WorkBuddy 原生渠道：设备流登录 / Token 导入 / 账号池 / 积分 / 签到
├─ API 中转 预设 + 自定义上游（OpenAI 兼容 / Anthropic 兼容），填 Key 即接入
├─ 降级链 把汇通目录里的模型串成链（fallback / round-robin），提交前失败自动换下一跳
├─ 网关 127.0.0.1:8330（可改端口），/v1/chat/completions + /v1/messages + /v1/models
└─ 日志 逐条运行日志
下面分块说明各来源在资料中的实现方式。
渠道来源¶
| 来源 | 实现方式 | 说明 |
|---|---|---|
| WorkBuddy / CodeBuddy（腾讯） | 本插件原生移植，协议对齐开源 workbuddy2api（MIT） | 设备授权流登录、OpenAI 直通与出站修正、refresh 单飞、错误分类、积分余额与签到；README 标明仅个人自用 |
| Raccoon、Qoder、Qoder CN、ZCode、MiniMax、TRAE、Cline、Loomy、LobsterAI、Gemini 等 | vendored channel-pack（MIT，上游见 vendor/channel-pack/NOTICE.md） |
登录、账号池、积分领取；模型经 pk/<provider>/<model> 并入目录；accountPack: auto 时若已装 dsh-our-free-model 可自动跳过同源渠道包 |
| 官方 API / 任意中转 | 本插件原生（openai-chat / anthropic-messages） | 内置预设含 DeepSeek、Z.ai、Kimi、MiniMax、SiliconFlow、OpenRouter、百炼、阶跃、Anthropic、SenseNova 等，也支持任意 OpenAI 兼容中转 |
汇通目录中的模型 id 带前缀：wb/（WorkBuddy）、up/（自填上游）、pk/（渠道包桥接）、combo/（降级链）。
本地网关接入¶
网关默认监听回环地址，端口 8330（可在设置中修改）。Key 落在 {DSH_HOME}/credit-hub/gateway/api-key，权限 0600；Windows 下会 best-effort 用 icacls 收紧 ACL。
OpenAI 兼容示例：
base_url = http://127.0.0.1:8330/v1 api_key = 网关页显示的 Key
POST /v1/chat/completions · GET /v1/models
Anthropic 兼容示例（供 Claude Code、Codex 等）：
ANTHROPIC_BASE_URL = http://127.0.0.1:8330
POST /v1/messages
网关 Key 只应放在请求头：Authorization: Bearer <Key> 或 x-api-key。查询参数 ?key=<Key> 默认关闭；旧客户端需要时可在设置里开启 allowQueryKey。管理面 /api/credit-hub 仅接受回环 Host 与同源/回环 Origin。若设置 adminKey，非 GET 请求需带 x-credit-hub-admin。
数据目录与凭据¶
运行数据在 {DSH_HOME}/credit-hub/，包含 settings.json、routes.json、accounts.json、usage.json、gateway/、channel-pack/、logs.jsonl 等。WorkBuddy token 与上游 API Key 写入 accounts.json（原子写 + fsync）；管理接口只返回 hasKey 与指纹，不回传明文 Key。
日志侧：网关记录 method、模型、字节数、消息条数，不记录请求体；历史读出时 body=... 会替换为 [redacted]。超过 1MB 的日志轮转为 .old。v0.2.1 起 channel-pack 路径兼容两层目录，旧账号数据无需迁移。
安装与启用¶
资料中的安装方式是基于仓库本地 link，而非 SkillHub 上的 dsh plugin add 拼装命令。步骤如下。
- 按 README 克隆仓库（路径自定）：
git clone https://github.com/Alex663028/dsh-credit-hub.git
- 在桌面端配置
{DSH_HOME}/profiles/desktop/package.json的dependencies增加：
"dsh-credit-hub": "link:<克隆路径>/dsh-credit-hub"
- 将
"dsh-credit-hub"加入dsh.profile.bundles，重启 DSH，再打开设置 → 积分汇通。
说明：link: 便于改源码即时生效；pnpm 可能对 linked 依赖提示 peer 未解析，README 称插件运行态主要依赖宿主 ctx 服务。client.js 带幂等守卫，重复注入只注册一次。发布到插件市场时 README 建议改用 file: 协议。运行要求 Node ^22.19.0 || >=24.0.0。
典型用法¶
- 在「总览」确认各来源开关与汇通模型列表。
- 在 WorkBuddy 或 channel-pack 对应页完成登录 / Token 导入，必要时配置账号池与签到。
- 在「API 中转」填入官方或中转 Key，选用预设或自定义上游。
- 如需容灾，在「降级链」把目录内模型串成 fallback 或 round-robin。
- 在「网关」页复制 Key，把本地 IDE 或 CLI 的
base_url指到http://127.0.0.1:8330/v1（或 Anthropic 的 base URL 形式），模型名使用带前缀的汇通 id。
适用场景与注意¶
适合已在用 DSH、且手头有多家 agent 积分账号或若干 API 中转、希望本地只维护一个兼容端口的开发者。插件以当前 DSH 进程权限运行，安装前应自行审阅源码与 MIT 许可证（含 vendor/channel-pack 再分发说明）。
README 中的使用声明需必读：仅供管理自己的账号与本地统一入口；不支持批量小号、额度转卖等行为。各渠道为非官方接入，平台策略变化可能导致风控；WorkBuddy 上游 README 提到 2026-10 起收紧识别，workbuddy2api 相关项目已停更。WorkBuddy refreshToken 上游反重放，并发 refresh 会使整条链作废（错误码 12153），插件按账号串行化 refresh，勿对同一账号同时跑多份网关实例。
结尾¶
积分汇通把分散的积分渠道与自填 API 收成一条模型车道，并用 127.0.0.1 上的 OpenAI/Anthropic 兼容网关对接本地工具。进一步了解可看 SkillHub 目录页 与 GitHub 仓库。
