dsh-wb-credit-fallback

WorkBuddy 积分耗尽时，自动把会话切到 DeepSeek，并把默认模型永久回落到 DeepSeek——这一轮照常答完，之后新开的会话也不再撞额度墙。

DSH（DeepSeek Harness）本身没有跨 provider 的回退链：

• WorkBuddy 插件在积分不足时让本地 shim 返回 402 / hard_credit；
• DSH 的 pi-ai 适配器会把 402 归到 PI_AI_ERROR（不是 QUOTA）；
• 内置 dsh-llm-retry 只会用同一个模型重试。

所以这里用一个 host 侧小插件补上缺口。它只用 DSH 0.2.0-rc.2 公开的扩展点，宿主代码零运行时依赖。

行为

1. 监听 agent/request-error：失败 provider 是 from（默认 workbuddy）且错误文本命中积分不足标记（hard_credit、insufficient credit、402、积分不足、额度不足、余额不足 等）时：
   • 用 sessionController.agents.selectForNextRequest 把当前会话切到 to（默认 deepseek-account / deepseek-flash）；
   • 用 agentDefaultModel.saveSelection 把它写成 profile 默认模型（走官方配置编辑器写回 cordis.patch.yml，不手改 YAML），此后新会话直接走 DeepSeek；
   • 返回 { kind: "retry" }，让这一轮重试一次。
2. 监听 agent/request：切换尚未落盘时直接重写这次请求的 provider/model，因为同一步的重试不会重新组装系统提示。
3. 保护：每个 turn 最多自动切换一次；内置重试策略已决定重试时让内置优先；非积分类失败（400/401/网络错误）不触发；监听器内部异常全部吞掉，不影响正常请求。

不做的事：DeepSeek 也失败时不再切；积分恢复后不会自动切回 WorkBuddy（在模型选择器里重选一次即可）；不处理 WorkBuddy 登录失效（401 session_dead）。

安装

桌面客户端的 profile 由 App 独占管理，CLI 不能装，用 App 内入口：

1. 左侧栏「插件」→「添加插件」；
2. 输入本目录的绝对路径（安装向导接受绝对路径）；
3. 安装 → 立即启用 → 完全退出客户端（含托盘）再打开。

卸载在插件页里完成，本插件不写任何用户数据。

dsh web / dsh tui 这类命令行 profile 可以直接从 GitHub 源码安装（桌面客户端的 desktop profile 仍只能用 App 内入口）：

dsh plugin --profile web add github:Yikeqm/dsh-wb-credit-fallback

装完重启对应 profile，再刷新页面即可。用 GitHub 源安装时插件会跟随仓库 main 分支更新，需要重新 dsh plugin remove + add 才会取到新提交。

配置

bundle 的 cordis.patch.yml 里给了默认值，可在 profile 的 cordis.patch.yml 里按行 id wb-credit-fallback 覆盖：

config:
  from: workbuddy            # 触发条件：哪个 provider 报额度不足
  to:                        # 切到哪个 provider/model
    provider: deepseek-account
    model: deepseek-flash
    reasoningEffort: high
  persistDefault: true       # 同时写回默认模型；false = 只救当前会话

验证

逻辑层：node tests/smoke.mjs（用假 ctx 模拟瀑布调用，覆盖触发 / 不触发 / 只切一次 / 默认写回）。

集成层：在独立的 headless profile 里挂两个手工声明的 pi-ai 路由（一个返回 402 hard_credit，一个正常流式返回），跑真实 agent loop：

• 第一次运行：BAD → GOOD，会话里 request/header 从故障 provider 换成回退 provider，turn/end 为 completed，profile 的 agent-default-model 被改写；
• 第二次运行（新会话）：只有 GOOD，直接走回退后的默认模型；
• 负向用例：非积分错误（400）不触发切换；回退目标也失败时不会在两个 provider 之间打转。

已知限制

• 依赖 DSH 0.2.0-rc.2 的 agent/request / agent/request-error 瀑布与 sessionController、agentDefaultModel 服务；升级 DSH 大版本后需复核。
• 积分不足靠错误文本匹配；WorkBuddy 若更换措辞需要补标记。
• 插件在宿主进程内运行，如遇异常行为先在插件页禁用它。

License

MIT