前言¶
DSH 的插件生態允許圍繞它補充 Provider 接入、賬號管理和本地路由能力。dsh-codex-shared-pool 是一個社區 DeepSeek Harness（DSH）擴展包，主要用於在 DSH 中管理多個 Codex 賬號：把多個 Codex 賬號放進同一個本地賬號池，並在每次請求前根據所選模型的上游額度選擇可用賬號。
這樣做可以減少手動切換賬號的工作量，也避免把正在使用的 auth.json 複製到不同環境。
這是什麼¶
dsh-codex-shared-pool 是一個面向 Codex 賬號池集成的社區 DSH bundle，GitHub 倉庫爲 https://github.com/502399493zjw-lgtm/dsh-codex-shared-pool，許可證爲 MIT。
它通過公開 Cordis/DSH 擴展點安裝，不修改或 fork DSH 核心。
核心能力¶
多賬號添加¶
在 DSH 設置中添加多個 Codex 賬號，不復制正在使用的 auth.json。
點擊“添加賬號”會發起一條獨立 OAuth 授權鏈。
請求前賬號選擇¶
每次請求前，插件讀取所選模型的上游額度。
- 當前賬號明確耗盡時，自動選擇仍有額度的賬號。
- 多個候選賬號都可用時，優先選擇上游重置時間更早的賬號。
- 自動切換後，新賬號會成爲全局“使用中”賬號，也可以手動切換。
這裏的賬號選擇發生在請求發往 Provider 之前，不是先讓已耗盡賬號失敗一次再重試。
最近請求流水¶
設置頁可以查看最近請求走了哪個賬號、爲什麼切換、使用的模型以及成功/失敗狀態。
該流水是進程內觀察數據，不是持久化賬本，最多在 Host 進程內保留 100 條，Host 重啓後清空。它不會記錄 prompt、response、文件、OAuth token 或會話正文。
Codex 客戶端能力¶
模型菜單沿用 Codex 客戶端的中文模式名稱和說明，包括“標準/快速”以及五檔推理等級。
插件保留 Codex Responses、搜索、圖片生成、read_image、TUI 管理等原有能力。
Team 共享與自託管說明¶
README 描述了第二期 Team 共享與自託管，包括邀請制 Team、成員額度共享、Team 請求路由和自託管部署。
相關自託管模板使用 deploy/self-hosted/init-secrets.mjs 和 deploy/self-hosted/compose.yml。已覈實資料無法確認這些第二期能力是否已完整包含在當前 npm 包版本中。
安裝與啓用¶
下面在 DSH Web profile 中安裝固定版本插件：
dsh plugin --profile web add dsh-codex-shared-pool@0.1.0
安裝完成後，啓動同一個 Web profile，進入：
設置 → OpenAI Codex
在設置頁點擊“添加賬號”，會發起一條獨立 OAuth 授權鏈。
TUI 管理¶
本地 TUI 賬號池管理命令包括：
/codex status
/codex login
/codex add
/codex activate <profile-id>
/codex remove <profile-id>
/codex usage
這些命令用於在本地 TUI 中查看狀態、登錄、添加賬號、激活指定 profile、移除賬號和查看 usage。
自託管命令示例¶
README 的自託管部署說明給出了以下命令：
node deploy/self-hosted/init-secrets.mjs
docker compose -f deploy/self-hosted/compose.yml up --build -d
第一條用於初始化自託管模板的 secrets，第二條用於構建並啓動自託管服務。
開發與驗證¶
開發與打包驗證可以使用以下命令：
pnpm test
pnpm run build
pnpm run verify:package
pnpm pack
其中 verify:package 只驗證 npm 包結構，不等於真實 DSH 安裝驗證。
當前固定驗證基線爲：
- DSH
0.1.0-rc.8 - Cordis
4.0.1 - Node.js
^22.19.0或>=24.0.0
更換 DSH 或 Cordis 版本前，需要重新執行 stock 安裝驗證。
安全邊界¶
- OAuth credential、refresh token、認證文件、Codex 子進程和文件系統訪問只屬於 Host。
- Browser 僅通過插件自己的 same-origin 路由讀取經過類型約束的最小脫敏數據。
- 不提供憑據導出接口，也不要求上傳或複製正在使用的
auth.json。 - 最近請求流水不會記錄 prompt、response、文件、OAuth token 或會話正文。
- 本項目通過公開 Cordis/DSH 擴展點安裝，不修改或 fork DSH 核心。
適用場景與注意¶
這個插件適合在 DSH 中使用多個 Codex 賬號、希望減少手動切換、並希望保留 Codex 原有能力的開發者。
由於 OAuth credential、refresh token、認證文件、Codex 子進程和文件系統訪問都依賴 Host 側權限，安裝前應檢查源碼、確認 MIT 許可證，並理解其將以當前 dsh 進程權限運行。
需要注意：
- 上游額度取決於 Provider 當前可觀測信號，插件不虛構精確 token 或訂閱成本。
- 額度讀取暫時失敗時會 fail-open；只有明確讀取到模型額度耗盡纔會在請求前跳過賬號。
- 本地最近請求流水是進程內觀察數據，不是持久化賬本。
verify:package只驗證 npm 包結構，不等於真實 DSH 安裝驗證。
鏈接¶
目錄頁：https://www.skillhub.cn/plugins/502399493zjw-lgtm/dsh-codex-shared-pool
GitHub：https://github.com/502399493zjw-lgtm/dsh-codex-shared-pool
