前言¶
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
