@axiaohungry/dsh-llm-workbuddy

WebUI 配置

打开 设置 → 模型，添加或编辑 WorkBuddy 中国区。认证区域有两个模式按钮：

• API Key：只显示 API Key 来源和新增 Key 功能；
• 令牌登录：只显示令牌账号、登录、切换以及账号用量信息。

切换模式后，另一种模式的账号或 Key 控件会隐藏，不会同时占用页面空间。

可选：会话级账号/API Key

认证区域提供“会话级账号/API Key”开关：

• 关闭（默认）：保持旧版行为。所有会话共用模型设置中当前选中的全局账号或 API Key； 不会改变已有配置和调用方式。
• 打开：每个会话可以在输入框底部单独选择“令牌 / API Key”以及对应账号或 Key。切换 当前会话的凭证不会修改其他会话，也不会中断已有会话上下文。

会话级绑定只保存会话 ID 与账号 ID/API Key 引用，不会把令牌或 API Key 写入会话路由配置。 关闭开关后，已保存的绑定会暂时停用；重新打开后会继续生效。新增或删除账号、Key 时， 对应的无效绑定会自动清理。

开启后，点击“新会话”时会在输入框上方显示“新会话默认凭证”，可以在发送第一条消息前 选择令牌账号或 API Key。此时 DSH 还没有 sessionId，插件会先保存最近一次选择；会话创建 后自动用于该会话。已经有明确会话绑定的会话优先使用自己的绑定，未绑定的会话则显示并使用 最近一次绑定的账号或 Key。

模型目录仍由 DSH 统一管理，模型选择本身按会话保存。更换会话凭证后，如果该账号的模型 权限不同，请在模型设置中重新获取一次在线模型目录。

方式一：WorkBuddy API Key

使用环境变量中的 Key

插件会自动检测：

WORKBUDDY_API_KEY

如果这个环境变量存在，API Key 来源下拉列表会显示“环境变量 WORKBUDDY_API_KEY”。 选择它即可使用；密钥值不会显示在页面中，也不会写入 settings.yaml。

旧版插件使用的 CODEBUDDY_API_KEY 仍会作为兼容环境变量自动识别，但新配置建议统一使用 WORKBUDDY_API_KEY。

在 DSH 中保存新的 Key

1. 选择 API Key 模式；
2. 在“新增 API Key”输入框粘贴 WorkBuddy Key；
3. 可填写一个名称，例如“工作账号”或“测试账号”；
4. 点击“添加并使用”；
5. 新 Key 会出现在“当前 API Key”下拉列表中，并立即切换为当前 Key。

DSH 保存的 Key 存放在 DSH 凭据服务中。可以保存多个 Key 并随时切换；环境变量 Key 和 DSH 保存的 Key 互不覆盖。删除操作只允许删除 DSH 保存的 Key，不会删除环境变量。

方式二：WorkBuddy 账号令牌

1. 选择 令牌登录 模式；
2. 点击“登录 WorkBuddy”，插件会打开 WorkBuddy 中国站；
3. 在浏览器完成账号登录；
4. 返回 DSH 后，账号会保存到本地凭据并自动启用。

再次打开页面时，可以在“令牌账号”下拉列表中切换账号。点击“添加账号”可以登录 另一个账号，点击“删除账号”会移除当前账号的本地令牌。令牌登录不需要安装 本机 WorkBuddy 命令行工具。

令牌模式下，插件会尝试显示：

• 剩余积分或企业账号的“不限量”；
• 今日请求次数；
• 今日请求消耗的积分。

积分接口属于 WorkBuddy 中国站的账号服务，仅令牌模式使用；API Key 模式不会调用该 接口。如果服务暂时不可用，页面会保留账号登录状态并显示“暂不可用”。