# @axiaohungry/dsh-llm-workbuddy 中文文档 规范地址：https://npmcn.com/package/%40axiaohungry/dsh-llm-workbuddy/ 版本：1\.3\.27 npm 元数据更新时间：2026-10-28T01:30:36.076Z 中文译文更新时间：2026-11-07T18:11:35.255Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40axiaohungry/dsh-llm-workbuddy 原文对照：https://npmcn.com/package/%40axiaohungry/dsh-llm-workbuddy/?lang=original 项目主页：https://github.com/Axiaohungry/dsh-llm-workbuddy#readme 源码仓库：https://github.com/Axiaohungry/dsh-llm-workbuddy ## 关键信息（来自 npm 元数据） - 包体积（解压后）：238 kB，13 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.19\.0 - 运行依赖：3 个 - peer 依赖：react ^18\.2\.0，@deepseek-ai/dsh-llm \>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0，@deepseek-ai/dsh-settings \>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0，@deepseek-ai/dsh-llm-pi-ai \>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0，@deepseek-ai/dsh-credentials \>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0，@deepseek-ai/dsh-launch-environment \>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0 - 首次发布：2026-09-03T08:38:24.373Z - 最新版本发布：2026-10-28T01:30:35.907Z - 近 30 天下载量：3262（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：16（近 12 个月 16 个） ## 中文简介 \+ 工作巴迪 API 密钥 + 工作巴迪 + 深搜索机 → 工作巴迪 → ## 安装 ```sh npm install @axiaohungry/dsh-llm-workbuddy ``` 也可以使用：`pnpm add @axiaohungry/dsh-llm-workbuddy`、`yarn add @axiaohungry/dsh-llm-workbuddy`、`bun add @axiaohungry/dsh-llm-workbuddy` ## README # DSH WorkBuddy Provider 在 DeepSeek Harness（DSH）桌面端和 WebUI 中使用 WorkBuddy 中国区模型，支持 API Key 和账号登录。 > 本插件是第三方适配工具，不属于 WorkBuddy 或 DSH 官方项目。使用前需准备有效账号或 API Key。 ## 功能 | 功能 | 说明 | | --- | --- | | 两种认证方式 | 支持 API Key、浏览器账号登录，可随时切换 | | 多凭据管理 | 添加、切换和删除多个 API Key 或登录账号 | | 会话独立选择 | 可为不同会话分别指定账号或 API Key | | 模型管理 | 获取可用模型，添加、编辑、删除模型或恢复在线目录 | | 模型参数 | 按模型配置上下文窗口、最大输出 Token 和思考档位 | | 账号用量 | 令牌模式下查看剩余积分、今日请求次数和积分用量 | | 多端支持 | 支持桌面、Web 和 Headless 使用方式，兼容 ModLens 包装模型 | 不需要安装本机 WorkBuddy CLI。模型可用范围及用量以当前账号权限和服务返回结果为准。 ## 环境要求 - 已安装 DSH，支持已声明兼容的旧版和 `0.2.x` 系列。 - Node.js `>= 22.19.0`。 - 支持 Windows、Linux、macOS。 DSH 升级到新版本系列后，请先确认插件兼容性。 ## 安装与更新 ### 桌面端 在 **设置 → 插件 → 添加插件** 中安装： ```text @axiaohungry/dsh-llm-workbuddy ``` 也可以在终端执行，更新时使用同一条命令： ```powershell dsh plugin --profile desktop add @axiaohungry/dsh-llm-workbuddy@latest ``` ### Web / Headless 一键安装或更新这两个 Profile： ```powershell npx --yes @axiaohungry/dsh-llm-workbuddy@latest install ``` 仅安装 Web Profile： ```powershell dsh plugin --profile web add @axiaohungry/dsh-llm-workbuddy@latest ``` **安装或更新后，完整退出并重新启动 DSH。** 只刷新页面不会完成更新。 更新可保留已有模型、账号和 Key 配置。 ## 使用方法 ### 1\. 打开配置 桌面端进入 **设置 → 插件 → WorkBuddy 插件详情**。 WebUI 进入 **设置 → 模型**，添加或编辑 **WorkBuddy 中国区**。 具体入口可能随 DSH 版本略有不同。 ### 2\. 选择认证方式 **API Key** 1. 选择 `API Key` 模式。 2. 在“新增 API Key”中粘贴 Key，可填写便于识别的名称。 3. 点击“添加并使用”，或从下拉列表中选择已有 Key。 也可选择环境变量 `WORKBUDDY_API_KEY`；兼容已有的 `CODEBUDDY_API_KEY`。 API Key 模式不显示账号令牌积分。 **令牌登录** 1. 选择 `令牌登录`。 2. 点击登录或添加账号，在浏览器中完成登录。 3. 返回 DSH，选择要使用的账号。 支持保存多个账号。删除账号会移除该账号的本地登录凭据。 ### 3\. 选择模型 点击“获取可用模型”，选择需要的模型，再点击“保存模型”。 可按需修改模型名称、上下文窗口、最大输出 Token 和思考档位。 更换账号或 Key 后，建议重新获取可用模型。手动添加模型时，请确认模型 ID 和账号权限。 “恢复在线目录”会取消手工覆盖的模型列表。 ### 4\. 可选：为会话单独选择凭据 打开“会话级账号/API Key”开关后，可在新会话或输入框附近选择凭据。 - 未绑定会话首次调用时，使用当前默认选择。 - 已绑定会话继续使用自己的选择，不随全局默认值变化。 - 可单独切换或解除当前会话绑定。 - 关闭开关后使用全局选择；重新开启后恢复已有绑定。 账号模型权限不同时，还需选择该账号可用的模型。 ## 近期解决的问题 `1.3.27` 主要改善： - 继续修复特定历史会话出现 `400 / 11128`、无法继续调用的问题。 - 更新客户端兼容标识，增加不含凭据和消息正文的请求诊断摘要。 - 新旧 DSH 版本下系统指令、工具调用的兼容性。 - API Key 和令牌两种方式的调用一致性。 - 模型频率受限时显示重置时间，避免默认反复重试，并提示手动选择其他可用模型。 已完成自动化检查，并验证两种认证方式均可获取模型、发送请求及接收回复。 上游服务或 DSH 发生变化时，仍可能需要更新插件。 ## 常见问题 | 问题 | 处理方法 | | --- | --- | | 找不到 WorkBuddy 提供方或设置入口 | 确认安装到正在使用的 Profile，完整重启 DSH 后再查看插件详情或模型设置 | | 更新后仍是旧版本或旧界面 | 重新执行对应 Profile 的更新命令，完整退出并重新打开 DSH | | API Key 下拉列表没有新 Key | 在插件自己的“新增 API Key”区域提交，点击“添加并使用” | | 登录成功但调用使用了其他账号 | 检查是否启用了会话级凭据，并核对当前会话的绑定 | | 获取模型失败或找不到模型 | 核对当前账号或 Key，重新获取目录；手动添加时检查模型 ID 和账号权限 | | 返回 `429 / 6004` | 当前模型触及服务端频率限制；按提示等待重置，或手动选择同一账号下的其他可用模型。不会自动切换模型或账号 | | 返回 `401 / 403` | 检查 Key 是否有效、账号是否过期，以及是否具有目标模型权限；必要时重新登录 | | 返回 `400 / 11128` | 更新到最新版本并完整重启；仍失败时记录业务码、插件版本和使用的模型后反馈 | | 返回 `500`、空响应或请求长时间无结果 | 更新并重启，检查网络；使用包装模型时，也检查相应服务状态 | | 不显示积分，或显示“暂不可用” | 确认使用令牌模式；积分服务暂时不可用不一定影响模型调用 | | 思考档位选项与其他模型不同 | 属于正常情况，按该模型显示的可用选项选择 | | ModLens 模型慢、超时或返回 `429` | 检查 ModLens 视觉引擎的登录、网络和额度；纯文本任务可先切换 WorkBuddy 直连验证 | 查看桌面 Profile 的安装版本： ```powershell dsh plugin --profile desktop list --depth 0 ``` Web 用户将 `desktop` 改为 `web`。ModLens 用户也可运行： ```powershell modlens doctor --json ``` 反馈问题时，请提供插件版本、DSH 版本、模型名称、认证方式和脱敏后的错误信息。 **不要公开 API Key、登录令牌或未经脱敏的完整日志。** ## 卸载 桌面 Profile： ```powershell dsh plugin --profile desktop remove @axiaohungry/dsh-llm-workbuddy ``` Web / Headless 安装器： ```powershell npx --yes @axiaohungry/dsh-llm-workbuddy@latest uninstall ``` 卸载后重启 DSH。安装器默认保留凭据，便于后续重新安装。 ## License [MIT](https://npmcn.com/package/%40axiaohungry/dsh-llm-workbuddy/LICENSE) ## 常见问题 ### @axiaohungry/dsh-llm-workbuddy 是什么？ \+ 工作巴迪 API 密钥 \+ 工作巴迪 \+ 深搜索机 → 工作巴迪 → ### 如何安装 @axiaohungry/dsh-llm-workbuddy？ 在项目目录运行 npm install @axiaohungry/dsh-llm-workbuddy，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0）、@deepseek-ai/dsh-llm（\>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0）、@deepseek-ai/dsh-settings（\>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0）、@deepseek-ai/dsh-llm-pi-ai（\>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0）、@deepseek-ai/dsh-credentials（\>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0）、@deepseek-ai/dsh-launch-environment（\>=0\.1\.2-alpha\.2 \<0\.2\.0 \|\| \>=0\.1\.5-rc\.3 \<0\.1\.5 \|\| \>=0\.1\.7-rc\.1 \<0\.1\.7 \|\| \>=0\.2\.0-0 \<0\.3\.0-0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 dsh-llm-workbuddy，可以用 npx dsh-llm-workbuddy 直接运行。 ### @axiaohungry/dsh-llm-workbuddy 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/axiaohungry\_\_dsh-llm-workbuddy 是否存在。 ### @axiaohungry/dsh-llm-workbuddy 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @axiaohungry/dsh-llm-workbuddy 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @axiaohungry/dsh-llm-workbuddy 可以商用吗？ @axiaohungry/dsh-llm-workbuddy 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @axiaohungry/dsh-llm-workbuddy 的下载量有多少？ 根据 npm 官方下载统计，@axiaohungry/dsh-llm-workbuddy 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,262 次，日均约 109 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @axiaohungry/dsh-llm-workbuddy 还在维护吗？ 最新版本 1\.3\.27 发布于 2026/10/28（10 天前）；至今共发布 16 个版本，其中过去 12 个月发布了 16 个；首次发布于 2026/09/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。