前言¶
在 DeepSeek Harness（DSH）里做高频模型调用、多 Agent 并发或自动化流水线时，往往只绑一个 DeepSeek 账号：配额消耗快、容易撞上 API 频率限制（HTTP 429），或出现短暂服务降级。手工换 Token、重启进程来切账号，会打断正在跑的任务，也不利于凭据集中管理。
下面介绍社区插件 dsh-account-switcher（包名 @local/account-switcher），由维护者 keerzzz 发布，分类为 admin-security。它以 SRE / 运维视角，在 DSH 内提供多账号凭据治理、零停机热切换、探针与配额可观测等能力。插件信息可在 SkillHub 目录页 与 GitHub 仓库 核对；DSH 生态强调「一切皆插件」，社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
DeepSeek Harness Account Switcher 是面向运维与 SRE 场景的 DSH 插件：在宿主机本地维护多账号凭据库，支持高可用主备切换、任务并发保护、延迟与余额探针，以及批量导入导出。当前仓库在 GitHub 上约 2 stars，许可证为 MIT（package.json 版本 1.0.0）。
核心功能¶
设计思路是把凭据、切换与可观测性放在 DSH 运行时一侧，并与 DeepSeek 云平台接口对接。README 中列出的能力如下（仅作能力说明，非独立产品承诺）。
高可用热切换与任务互斥¶
- 通过重写底层 Platform Grant，在不重启 DSH 进程的情况下切换账号；下一次模型调用即使用新凭据。
- 切换前检查
agents.list()中正在执行的任务数；若当前账号仍有并发任务，拒绝切换，避免会话漂移导致任务状态损坏。
延迟与可用性探针¶
- 主动探测：平台用户状态（
/auth-api/v0/users/current）与模型能力（/models）。 - 展示各账号端到端往返延迟（RTT，毫秒），便于在多账号间做路由或选型参考。
配额与余额可观测¶
- 调用官方资金相关接口（文档中写作
/user/balance，英文说明中为api.deepseek.com/user/balance），展示总余额、赠金（Granted）、充值金（Topped-up）及币种（如 CNY / USD）。 - 支持在界面中刷新余额，便于观察配额水位。
凭据生命周期与本地安全¶
- 登录自愈：监听
credentials/record-updated，将新登录凭据自动写入本地 Vault。 - 测活与清理：可并发检测库内全部账号健康度并标记失效凭据；支持一键清理（Prune）失效账号。
- 零信任本地隔离：凭据仅存于宿主机受保护凭据库（文档说明为 0600 权限），不上云、不外发第三方。
批量导入与备份迁移¶
支持的输入形态包括（README 原文表述）：
- 制表符分隔行（
账号\tToken）或phone:token等形式； - 纯 Token 列表；
- 对象数组 JSON、字典映射等。
导出支持 TSV、JSON、纯 Token 列表，便于多机或多环境镜像同步。
安装与启用¶
安装步骤以仓库 README 为准：将插件放到 DSH Web profiles 的本地模块路径，并在 cordis.yml 中声明加载，然后重启 Web 服务。
# 1. 克隆本插件到 DSH profiles 模块目录
git clone https://github.com/keerzzz/dsh-account-switcher.git ~/.dsh/profiles/web/node_modules/@local/account-switcher
# 2. 在 DSH 配置文件 cordis.yml 中确认加载:
# - id: account-switcher
# name: '@local/account-switcher'
# 3. 重启 DSH 服务即可在设置面板中体验
pnpm dsh web
package.json 中 dsh.client 声明了 Web 端注入 @deepseek-ai/dsh-client-locale 与 @deepseek-ai/dsh-client-ui-settings，并带有 cordis.patch.yml 补丁；具体 UI 入口以你本地 DSH 设置面板为准。
典型用法（基于文档描述）¶
README 未逐步截图操作，但可归纳如下可复现思路：
- 完成安装与启用后，在 DSH 设置面板中打开账号切换相关界面（文档称「设置面板中体验」）。
- 新增账号：在 DSH 中正常登录 DeepSeek，插件监听
credentials/record-updated后会把凭据写入本地 Vault；也可按上文格式批量导入。 - 切换前：确认无绑定当前凭据的并发 Agent 任务；再执行切换，使下一次调用走新账号。
- 运维巡检：对全部账号做健康检测，查看 RTT 与余额；对失效账号执行 Prune，必要时 导出 TSV / JSON / Token 列表做备份或迁移。
涉及的具体按钮文案以你安装的 1.0.0 包内 locale 与客户端为准。
适用场景与注意¶
适合谁：需要在一台 DSH 宿主机上管理多个 DeepSeek 账号、希望在 429 / 配额紧张时平滑切换、并要做余额与探针巡检的运维、SRE 或重度自动化开发者。
使用前请注意：
- 插件以当前 DSH 进程权限运行，凭据落在本机 Vault；安装前请自行审阅 源码 与 MIT 许可证，确认符合你的安全基线。
- 切换受任务互斥约束：有活跃任务时不能切账号，这是刻意设计，不是故障。
- 社区插件与目录页信息可能滞后于仓库 README，冲突时以你克隆的仓库文档为准。
结尾¶
dsh-account-switcher 把多账号凭据、热切换、并发保护与余额 / 延迟探针收进 DSH 设置与运行时，减少「单账号打满配额就只能停服换号」的运维摩擦。进一步了解可访问 SkillHub 插件页 与 GitHub：keerzzz/dsh-account-switcher。
