账号切换器 keerzzz/dsh-account-switcher

DeepSeek Harness 账号切换器（@local/account-switcher）

面向 SRE / 运维人员的 DeepSeek Harness 运维级多账号高可用平滑切换与凭据治理插件。
DevOps & SRE-grade multi-account high-availability failover and credential governance plugin for DeepSeek Harness (DSH).

中文说明

高频调用大模型、多智能体并发或自动化开发时，单个 DeepSeek 账号常遇到配额消耗过快、触发 API 频率限制（Rate Limit / 429）或突发服务降级。

本插件以 SRE / 运维可观测性与高可用容灾思维 为核心设计理念，为 DeepSeek Harness 提供零停机热切换、任务并发保护、端到端延迟探测、实时配额监控与自动化凭据治理能力。

🛠️ 运维与 SRE 设计特性

flowchart LR
subgraph DSH_Runtime["DSH Host Runtime"]
Vault[("0600 本地凭据库\nVault")]
Watcher["凭据监听器\nrecord-updated"]
Switcher["热重载交换机\nHot-Swap Dispatcher"]
Mutex["任务互斥锁\nTask Mutex Guard"]
end

subgraph Observability["可观测性与探针"]
Probe["网络往返探针\nRTT Latency (ms)"]
Balance["配额监控\nBalance & Quota"]
end

subgraph DeepSeek_API["DeepSeek Cloud"]
Platform["/auth-api/users/current"]
Models["/models"]
BalAPI["/user/balance"]
end

Watcher -->|自动捕获持久化| Vault
Switcher -->|热重载| Mutex
Mutex -->|无运行中任务时安全交换| DeepSeek_API
Probe -->|健康探测| Models
Balance -->|额度感知| BalAPI

1. 高可用主备故障转移与零停机热重载 (HA & Zero-Downtime Hot-Swapping)
- 重写底层 Platform Grant，实现毫秒级会话切换。
- 下一次模型调用即刻生效，无需重启 DSH 进程，保障大模型任务流的持续性。

2. 会话互斥安全保护锁 (Session Mutex & Task Concurrency Guard)
- 切换前主动检查 agents.list() 中正在执行的任务数。
- 若当前账号仍有并发工作任务，拒绝切换，严防会话漂移导致任务状态损坏。

3. 端到端网络延迟与可用性探针 (Active Latency Probing)
- 双向主动探针校验：平台用户状态（/auth-api/v0/users/current）+ 模型能力握手（/models）。
- 实时测量各账号端到端网络往返延迟（RTT ms），为多账号最优路由提供量化指标。

4. 资源容量与配额可观测性 (Quota & Balance Observability)
- 直连官方资金接口（/user/balance），展示总余额、赠金（Granted）、充值金（Topped-up）及货币种类。
- 支持单卡片一键「刷新余额」，及时掌握配额水位，防患额度耗尽突发故障。

5. 凭据生命周期与健康自愈 (Credential Hygiene & Self-Healing)
- 登录自愈：全自动捕获新登录凭据，热写入 Vault，杜绝人工误操作导致凭据遗失。
- 一键全量测活：并发测试库内全部账号健康度，自动标记失效凭据。
- 故障熔断剔除：一键清理（Prune）全部失效账号，保持凭据池的高可用与整洁。

6. 零信任本地隔离与合规 (Zero-Trust Local Security)
- 凭据仅存储于宿主机受保护的凭据库（0600 权限），绝不上云、不外发任何第三方，符合企业级安全基线。

7. 运维批处理与多环境镜像导入/导出 (Batch Operations)
- 批量导入：支持标准制表符行（账号\tToken）、纯 Token 列表、对象数组 JSON、字典映射等全形态输入。
- 备份与迁移：支持导出为 TSV、JSON、Tokens 纯列表，方便集群化多机镜像同步。

密集开发大模型智能体、跑自动化 CI/CD 工作流时，只靠单个 DeepSeek 账号，常会遇到配额耗尽、触发频率限制（HTTP 429）或服务降级。
这个插件从 SRE 与运维韧性视角 设计，把零停机热切换、并发任务守卫、实时延迟探测、配额可观测性、凭据自动清理引入 DeepSeek Harness。

🛠️ DevOps 与 SRE 亮点

1. 零停机凭据热切换
- 在内存中替换已存的平台授权，无需重启 DSH 进程。
- 下一轮模型调用立即使用新凭据。

2. 任务并发守卫（会话互斥锁）
- 执行切换前先检查正在运行的智能体任务。
- 若有任务正绑定当前凭据，则拒绝切换，避免会话竞态。

3. 主动延迟与可用性探测
- 通过 /auth-api/v0/users/current 和 /models 做双向主动探测。
- 显示实时往返网络延迟（RTT，单位 ms），运维团队可据此选用最快的凭据转发请求。

4. 资源配额与余额可观测性
- 直接对接官方端点（api.deepseek.com/user/balance）。
- 按币种（CNY/USD）跟踪总额、赠送额与充值额。

5. 凭据自动清理与修剪
- 自动持久化：监听 credentials/record-updated，把新登录的账号自动写入本地保险库。
- 并发健康检查：并行探测全部凭据，给出通过/失败指标。
- 修剪熔断：一键清理过期/失效账号。

6. 零信任本地安全
- 凭据只存放在本地加密保险库（文件权限 0600）。凭据绝不离开你的主机。

7. 多格式批量导入与备份
- 支持分隔文本（name\ttoken、phone:token）、裸 token 和标准 JSON 格式。
- 一键导出为 TSV、JSON 或 token 列表，方便跨机器迁移。

📦 安装与启用 (Installation)

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

📄 License

MIT License © 2026 keerzzz