前言¶
在 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 倉庫。
