本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-llm-codebuddy

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-llm-codebuddy

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• WebUI 中直接添加 CodeBuddy 中国区；
• 支持从 WorkBuddy 获取的 API Key；
• API Key 输入框旁可显式切换 API Key / 令牌登录；
• 支持从 WebUI 拉起浏览器登录 CodeBuddy 中国站，并自动复用、刷新登录令牌；
• 自动获取 CodeBuddy 当前可用模型；

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装完成后 WebUI 里看不到 CodeBuddy 中国区选项？

安装或更新后必须重启 DSH，已经在运行的进程不会自动加载新插件。重启后再打开"设置 → 模型"。

获取模型失败怎么办？

先确认 API Key 来自 WorkBuddy 且仍然有效，重新输入 Key 后再点"获取可用模型"。如果 CodeBuddy 接口临时不可用，插件会回退到内置模型目录，仍然能正常使用。

为什么别人能看到某个模型我这里看不到？

模型权限与当前 API Key 绑定。插件只导入当前 Key 在 CodeBuddy 授权的模型；更换 Key 后需要重新点"获取可用模型"。

调用时报 500 status code (no body) 怎么办？

升级到最新版并重启 DSH。早期版本可能被 DSH 覆盖 CodeBuddy 请求的 User-Agent 标识导致服务端拒绝，最新版已在请求层恢复官方标识。

卸载后 WebUI 还显示旧页面？

关闭正在运行的 DSH 进程再重新启动。运行时进程不会自动卸载已加载的插件代码。

WebUI 无法自动打开浏览器登录怎么办？

在终端执行 npx dsh-llm-codebuddy@latest login，插件会调用 CodeBuddy 官方认证流程，完成后会自动把 Provider 切换为令牌模式。

需要 WorkBuddy 账号才能用吗？

WorkBuddy API Key 模式需要 WorkBuddy 账号获取 Key；如果选择 CodeBuddy 中国站账号令牌登录则不依赖 WorkBuddy，但仍需要在 CodeBuddy 中国站拥有可用账号。

卸载插件会丢失凭据吗？

不会。卸载只删除 settings.yaml 里的 Provider 配置，DSH 凭据服务中的 API Key 和登录令牌会保留，方便以后重新安装。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6
• Node: >=22.19.0
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则