前言¶
在 DeepSeek Harness（DSH）裏做多模型、多賬號切換時，常見做法是在覈心外再掛一層代理網關，或把各家 Provider 的 OAuth、額度讀取和請求適配硬寫進業務代碼。賬號一多，登錄態、模型目錄和額度狀態就容易各管各的，和 DSH 本身的命令、模型選擇也對不齊。
Dockyard DSH 走另一條路：作爲 DSH 的原生 bundle/plugin，把多個官方 OAuth 與本機會話接到同一個賬號池和 runtime 上，命令、模型選擇和 LLM 生成都讀同一套狀態，不必另起網關，也不把 Provider 邏輯塞進 DSH 核心。下面介紹它是什麼、能做什麼，以及怎樣安裝和使用。
這是什麼¶
Dockyard DSH（aitabby/dockyard-dsh）由 AITabby 維護，在 SkillHub 社區目錄中歸類爲 admin-security。倉庫描述爲：面向 DeepSeek Harness 的原生賬號池與 Provider 插件；package.json 中標註爲 macOS-only native account-pool and provider plugin，當前版本 0.1.1，許可證 MIT。
它解決的核心問題是：在 DSH 內統一管理多家 Provider 的賬號、即時模型目錄、額度狀態，並通過 provider-native 請求鏈路發起調用。若對應官方客戶端、CLI 或 OAuth 源未安裝、未登錄，Dockyard 會返回明確的 unavailable/degraded 狀態，不會用硬編碼賬號、模型或額度僞造可用結果。
當前包含的 Provider 模塊（據 GitHub README）：
- Codex — 官方瀏覽器 OAuth、CLI fallback、原生 Responses 請求鏈路
- Antigravity — Google 官方瀏覽器 OAuth、本機會話、即時模型目錄、額度/credits、原生 Gemini SSE
- Grok — xAI 官方瀏覽器 OAuth、CLI fallback、即時模型目錄、官方 Build credits 週期、provider-native streaming
- Claude — 官方瀏覽器 OAuth（支持帶 state 的手動回調）、CLI fallback、原生請求適配
- Cursor — 官方瀏覽器登錄輪詢、CLI fallback、原生請求適配
核心功能¶
賬號池與 Provider 管理¶
在運行中的 DSH profile 裏，通過 /dockyard 命令管理賬號和 Provider。點擊「登錄添加賬號」會打開對應 Provider 的官方瀏覽器授權頁，選擇賬號後安全導入賬號池；Provider 不可用時保留 CLI fallback。
掃描本機已有官方登錄態與新增賬號是兩個獨立操作：已有賬號不會被「新增」靜默重複導入。
賬號池策略與即時狀態¶
支持手動選擇、sticky session、round-robin 和 failover 等賬號池策略。模型目錄、推理檔位、套餐和額度窗口均從 Provider 即時讀取；所有命令、模型選擇和 LLM 生成都走同一個 Dockyard runtime，不維護第二套賬號池或額度緩存。
平臺與發佈狀態¶
README 寫明當前爲 Developer preview。macOS 已提供通用 DMG 下載；Windows EXE 已完成構建，正在上傳到 v0.1.1 Release。
macOS 完整功能依賴 Keychain 憑據存儲、DSH GUI 打開的瀏覽器 OAuth（PKCE、state 校驗、loopback/manual-code 回調），以及掃描 Cursor、Antigravity 等桌面端或本機 CLI 會話。非 macOS 默認 credential store 會 fail closed，不會靜默退回不安全的內存存儲。
安裝與啓用¶
插件以當前 dsh 進程權限運行，安裝前應查看倉庫源碼與 MIT 許可證，並閱讀 SECURITY.md，勿向 issue 提交 token 或敏感日誌。
方式一：安裝到已有 DSH Web profile（推薦）¶
需先安裝 DSH CLI，並確認 dsh 可用。上游要求 Node 22.19+ 的 22.x，或 Node 24+；當前 bundle 已按 @deepseek-ai/dsh@0.1.0-rc.6 驗證。
npm install --global @deepseek-ai/dsh
npm install --global pnpm
dsh --version
pnpm --version
web 是 DSH 自帶的完整 Web profile；不要新建只含 Dockyard bundle 的空 profile，否則不會啓動 Web GUI。
dsh plugin --profile web add github:AITabby/dockyard-dsh
dsh web
默認訪問 http://127.0.0.1:3080。首次啓動可先檢查組合配置：
dsh web --dump-config
如需固定版本，可 pin 到已驗證的 commit：
dsh plugin --profile web add github:AITabby/dockyard-dsh#<commit-sha>
方式二：macOS 獨立 DMG¶
若不想手動安裝 Node.js、pnpm 或 DSH，可下載自帶完整運行時的 macOS 通用 DMG（Apple Silicon 與 Intel）。DMG 內置 Node.js、DSH CLI、完整 web profile 和 Dockyard 插件；OAuth 授權頁由系統默認瀏覽器打開。當前爲本地 ad-hoc 簽名的開發預覽。
下載地址見 GitHub Releases。
方式三：克隆後本地安裝¶
需要改源碼時使用：
git clone https://github.com/AITabby/dockyard-dsh.git
cd dockyard-dsh
npm install
npm test # 可選
npm run build # 修改 source 或 bundle 過期時需要
dsh plugin --profile web add .
dsh web
隔離測試、不影響默認 DSH home：
DSH_HOME=/tmp/dockyard-dsh-home dsh plugin --profile web add .
DSH_HOME=/tmp/dockyard-dsh-home dsh web
典型用法¶
DSH 內命令¶
在運行中的 DSH profile 中：
/dockyard status
/dockyard scan [provider]
/dockyard add [provider] [candidateId]
/dockyard login <provider>
/dockyard refresh [provider]
/dockyard models <provider>
/dockyard policy <provider> <manual|sticky_session|round_robin|failover> [accountId]
/dockyard use <provider> <accountId>
/dockyard remove <provider> <accountId>
新增與導入賬號¶
先做瀏覽器 OAuth 新增：執行 /dockyard login <provider>，在官方授權頁完成登錄。若要導入本機已有登錄態，則先 /dockyard scan <provider>，再 /dockyard add <provider>，最後用 /dockyard status 和 /dockyard models <provider> 覈對即時狀態。
Codex、Antigravity、Grok、Claude、Cursor 的「登錄添加賬號」默認由 DSH 打開官方瀏覽器授權頁，不要求本機先裝 CLI；CLI 僅作兼容性 fallback。Antigravity 的 Google OAuth 需在啓動 DSH 的 shell 中設置 DOCKYARD_ANTIGRAVITY_CLIENT_ID 與 DOCKYARD_ANTIGRAVITY_CLIENT_SECRET，倉庫不內置憑據。
適用場景與注意¶
適合誰： 已在用或準備用 DSH 做智能體/Web 對話，且需要在同一界面管理 Codex、Antigravity、Grok、Claude、Cursor 等多家官方賬號與模型的開發者。尤其適合 macOS 用戶：Keychain、瀏覽器 OAuth 與桌面端會話掃描是完整體驗的前提。
安全邊界： 原始 OAuth/token 不寫入 Git、賬號池快照或頁面狀態；refresh token 持久化在安全憑據存儲中，支持 refresh 的 Provider 會在重啓後自動刷新短期 access token。額度、模型、套餐在 Provider 不返回時保持 unknown/null。
已知限制：
- DSH 仍處於 developer preview，上游可能有 breaking changes
- Provider 的 CLI 路徑、OAuth 字段和額度接口可能變化；Dockyard 對缺失字段保持未知
- Windows EXE 上傳與驗證完成前，不宜用於 Windows 生產環境
- Antigravity 瀏覽器授權需自行配置官方 OAuth client 信息
SkillHub 社區目錄與 DeepSeek / 幻方無官方從屬關係，屬於 DSH「一切皆插件」生態下的獨立收錄站點。
結尾¶
Dockyard DSH 把多 Provider 的官方 OAuth、本機會話和原生請求收進 DSH 內的一個賬號池與 runtime，用 /dockyard 完成登錄、掃描、策略與模型查看，避免再維護一套代理或重複緩存。macOS 用戶可直接用 DMG 或 dsh plugin --profile web add 接入；使用前請對照 README 覈對平臺與發佈狀態。
