前言¶

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