Skip to main content
A

dsh-workbuddy-websearch

arnen7000/dsh-workbuddy-websearch

将 WorkBuddy 桌面 App 的网络搜索接入 DeepSeek Harness 的 web_search 工具（零配置、零硬依赖）

Install

dsh plugin --profile web add github:arnen7000/dsh-workbuddy-websearch

README

dsh-workbuddy-websearch

将 WorkBuddy 桌面 App 的网络搜索接入 DeepSeek Harness 的 web_search 工具（零配置、零硬依赖）

装上本插件后，dsh 内置的 web_search 会改用你 WorkBuddy 账号的登录态（积分套餐）调用云端 agentic 检索，返回带引用来源的综述文本。不需要任何 API Key，也不用改 dsh 的模型配置。

  • 零配置 —— 复用 WorkBuddy 桌面端登录态，不填任何 Key、不改账号设置。
  • 零硬依赖 —— 不装其他 dsh 插件也能完整工作；平台定位、5.6+ 加密凭据解密、 国内版/国际版双版本读取均自带。
  • 对凭据文件只读 —— token 续期只在内存中完成，不回写磁盘，与其他插件零冲突。
  • 纯 ESM，无构建步骤，无第三方依赖 —— clone 下来即可用。
  • 不锁版本上限 —— dsh 与 WorkBuddy 出了更新版本照样能装，只声明「已验证到哪」。

目录

安全

  • 本插件对 WorkBuddy 桌面端的凭据文件只读；token 续期只在内存中完成，不回写磁盘。
  • 所有请求只发往 WorkBuddy 官方网关（国内 https://copilot.tencent.com、 国际 https://www.workbuddy.ai），不经过任何第三方中转，也不会把你的凭据发往别处。
  • 发现安全问题请不要开公开 Issue，按 SECURITY.md 的渠道私下反馈。

安装

前置只有一条：本机已安装并登录 WorkBuddy 桌面 App（国内版 WorkBuddy 或国际版 WorkBuddy AI 任一）。

快速开始

从 DSH 插件市场装（最省事） —— 在 DSH 里打开插件市场，搜索 workbuddy-websearch，点安装即可。安装、升级、卸载都在界面里完成， 不用记命令、不用碰配置文件。

从 npm 装（命令行） —— 本插件已发布到 npm，不必 clone：

dsh plugin --profile web add dsh-workbuddy-websearch

⚠️ 请固定版本号，或直接用市场安装。 pnpm 11 起内置了 24 小时的「新版本冷静期」（minimum-release-age）： 刚发布不久的版本会被静默降级到上一个满 24 小时的版本， 而 @latest 标签也绕不过它。想要立刻用上最新版就显式指定：

dsh plugin --profile web add dsh-workbuddy-websearch@0.3.4

DSH 插件市场自带这个问题的处理（安装前先把目标固定到注册表的最新版）， 所以走市场安装不会有这个困扰。

从源码装 —— 想改代码、或想固定到某个提交时：

# <本插件目录>：你 clone 下来的仓库路径
dsh plugin --profile web add <本插件目录>

对每一份 dsh 副本各执行一次，用你平时启动 dsh 的方式调用它的 CLI。 重启 dsh 即生效 —— web_search 走 WorkBuddy 搜索，模型回答里会带来源链接。

核验（应看到 searchProvider: workbuddy-agentic 与 id: web-workbuddy-websearch）：

dsh --profile web --dump-config | grep -i "workbuddy-websearch\|searchProvider"

若 dsh 不在 PATH 上，直接用它的绝对入口调用，效果相同：

"<node>" "<dsh 安装根>/node_modules/@deepseek-ai/dsh/lib/bin.js" plugin --profile web add dsh-workbuddy-websearch

升级（plugin 子命令就是 dsh 官方的插件管理入口）：

dsh plugin --profile web add dsh-workbuddy-websearch@latest   # 升到最新版
dsh plugin --profile web add dsh-workbuddy-websearch@0.3.3    # 或固定到某一版

遇到问题

add 报错、或核验不通过时，见 DEVELOPING.md → 安装排障： 那里覆盖两个已知坑（pnpm 不落地 link: 依赖、add 的「半状态」陷阱）、 配套的修复脚本 tools/ensure-installed.mjs，以及「开发态 vs 发布态」的说明。

dsh-workbuddy-connect 是可选增强，不是前置。 装了会更稳（复用其久经验证的凭据 store）， 不装也能完整工作。详见适用范围。

🔴 同一个搜索 provider id 只能有一个插件注册。 本插件注册 workbuddy-agentic； 若你还装着注册了同一 id 的其他插件（本插件的旧版本 / 前身版本、改过 id 的 fork 等）， dsh 的 ctx.web 会按 id 去重 —— 同时装只会有一个生效，另一个静默不激活 （日志里只有一行 1 entry did not activate）。撞上这个坑时，插件会直接告诉你 怎么把占用者查出来、怎么卸。 详见 COMPATIBILITY.md §7.1。

⚠️ 装之前先确认 dsh 用的是哪个数据目录。 dsh 未设 DSH_HOME 时会回落到默认 数据目录（~/.dsh）。若你平时是用某个包装脚本 / 固定数据目录启动 dsh 的， 请让安装时的 DSH_HOME 与它保持一致，否则插件会被装进另一个你并不会启动的环境。 用各发行版自带的 dsh / dsh.bat 启动可避免此问题。

依赖

依赖要求说明
Node>= 20实测 v22 / v24；真实下界是 AbortSignal.any（20.3+）
WorkBuddy 桌面 App已安装并登录国内版或国际版任一
Python不需要本插件不调用 Python（dsh 自带的 Python 是给它自己用的）
git运行时不依赖只在 npm install 装 git 依赖、或 git clone 做开发时需要
原生构建工具链不需要零运行时依赖，没有需要编译的模块
其他 dsh 插件不需要零硬依赖，独立工作

逐项实测依据见 COMPATIBILITY.md §5。

卸载

dsh plugin --profile web remove dsh-workbuddy-websearch

remove 会同时移除 dependencies 与 bundles 登记；bundle patch 随包消失，web 行自动回到 dsh-base 默认（searchProvider: deepseek-official），无需手动改配置。 若 remove 后 node_modules 里仍残留空目录，手动删掉即可。

⚠️ 若你曾在 profile 的 cordis.patch.yml 里写过 - id: web-workbuddy-websearch 传 config， 卸载后需手动删掉该行，否则 dsh 启动会报 entry not found（仅告警）。

使用

安装并重启 dsh 后无需任何额外操作 —— 模型调用 web_search 时自动走 WorkBuddy：

你：帮我搜一下最近的 XX 进展
  └─ 模型内部调用 web_search
       └─ WorkBuddy 云端多步 agentic 检索
            └─ 返回带引用来源的综述文本

CLI

headless profile 同样可用：

dsh headless "帮我搜一下最近的 XX 进展"

注意 headless profile 的默认模型走 deepseek-official（需 DeepSeek API Key）； 想让它也复用 WorkBuddy 登录态，需在该 profile 的 cordis.patch.yml 里把 agent-default-model 的 provider 改为 workbuddy。 详见 COMPATIBILITY.md §7。模型配置与搜索插件是两件事，别混淆。

配置

全部为环境变量，都有默认值，不设也能用：

环境变量默认说明
WORKBUDDY_SEARCH_REGIONauto用哪一版账号：auto（选实际可用的那一版）/ global（国际版 WorkBuddy AI）/ cn（国内版 WorkBuddy）
WORKBUDDY_SEARCH_MODE2云端 search_mode（2 = PRO，桌面 App 同款）
WORKBUDDY_SEARCH_MAX_CONTENT_CHARS30000综述回传上限字符，0 = 不截断
WORKBUDDY_SEARCH_ENDPOINT按区域自动覆盖网关地址
WORKBUDDY_AUTH_FILE自动探测显式指定国内版凭据 JSON 路径
WORKBUDDY_AI_AUTH_FILE自动探测显式指定国际版凭据 JSON 路径
WORKBUDDY_ELECTRON_BIN自动探测国内版 App 的 Electron 二进制（解密 5.6+ 凭据用）
WORKBUDDY_AI_ELECTRON_BIN自动探测国际版 App 的 Electron 二进制（装在自选盘符/自定义路径时必填）

两版账号不会混用。 国内版（WorkBuddy）与国际版（WorkBuddy AI）是两套账号、 两套积分。插件在首次用到时绑定其中一版，整个会话不再切换；被绑定的那一版 没登录就如实报错，不会悄悄改用另一版去扣费。

auto（默认）选实际可用的那一版，只装了一版的人无需任何配置；两版都可用时 取国际版（保持 0.2.x 的额度归属），想固定用国内版就写 region: cn。 详见 COMPATIBILITY.md §4.2。

自动探测顺序：① 上面的环境变量 → ② 平台默认布局 （Windows 国内版 %LOCALAPPDATA%\Programs\WorkBuddy\；macOS /Applications/*.app） → ③ macOS Spotlight 发现（按 bundle id 反查 → plutil 校验 → 可执行性检查； 装在 /Applications 之外也能找到） → ④ Windows 常见安装根的一层有界扫描（%LOCALAPPDATA%\Programs、%ProgramFiles%* 下 目录名以 WorkBuddy 开头的；不枚举盘符、不做全盘遍历） → ⑤ Windows 卸载注册表（Uninstall 三处根；DisplayName 形状匹配后取 DisplayIcon / InstallLocation，每个候选都要通过「exe 名相符 + 同级 version + resources/app.asar」三道布局校验；多于一个就报歧义，绝不猜）。

❗ 官方安装器允许把 App 装到自选盘符或自定义目录（macOS 上则是 /Applications 之外）。 第 ③ ⑤ 步分别覆盖了这两种情形；万一仍找不到，请用环境变量显式指定。 找不到时插件抛出的错误里已包含可直接粘贴的设置命令。 详见 COMPATIBILITY.md §4.1。

适用范围

项要求
操作系统Windows x64（稳定）· macOS（🧪 实验性，未在真机验证）
CPUx64 / arm64（32 位 Windows 不支持：WorkBuddy 桌面端无 32 位构建）
dsh>= 0.1.5-rc.2（实测 0.1.5-rc.2 / 0.1.7-rc.1 / 0.2.0-rc.2 全通过）
Node>= 20（实测 v22 / v24）
WorkBuddy 桌面 App已安装并登录（国内版 / 国际版任一）
dsh profile任意：web / headless / tui / desktop 均可

不支持的平台：32 位 Windows、Linux / WSL、鸿蒙（WorkBuddy 鸿蒙版是手机 App，非桌面端）。

版本策略：允许更新版本安装，只声明「已验证到哪」

本插件不锁版本上限 —— dsh 或 WorkBuddy 出了更新版本，照样能装、能用。 我们只在文档里说清楚「验证过哪些版本」，把判断权留给你。

组件已验证是否阻止安装
dsh0.1.5-rc.2 / 0.1.7-rc.1 / 0.2.0-rc.2❌ 不阻止（含未来的 1.x / 2.x）
WorkBuddy 桌面端国内版 + 国际版；明文与 $wbEncrypted 加密两种凭据格式均实测❌ 不阻止
Nodev22.22.2 / v24.21.0❌ 不阻止（仅 engines 提示）

之所以能做到「不锁上限」，是因为本插件只依赖一个极窄的接缝 （ctx.web.registerSearchProvider），且刻意不声明 @deepseek-ai/dsh* 的 peerDependencies 版本区间 —— 那会主动引入「被拒装」的风险。 实现细节与护栏见 DEVELOPING.md 的「版本策略」与 NORM-COMPLIANCE.md §2.5。

装了更新版本后搜索失效怎么办？ 按顺序排查：

  1. dsh --profile web --dump-config | grep -A6 "id: web" —— 看 searchProvider 还是不是 workbuddy-agentic（不是 → patch 层没套上）；
  2. 看桌面端是否还登着（登出会导致 WEB_PROVIDER_CONFIGURED_UNAVAILABLE，见注意事项）；
  3. 若接缝变了，带着你的 dsh 版本号提 Issue，我们会补验证并更新上表。

dsh-workbuddy-connect 是可选增强，不是前置：装了它 → 复用其久经验证的凭据 store （对罕见落盘形态与刷新时序兼容更完整）；不装它 → 一切照常工作，即便它加载失败或内部报错， 也会静默降级，不会让搜索失效。

完整兼容矩阵、实测依据与边界清单见 COMPATIBILITY.md。

注意事项

  • ⚠️ 只管搜索，不管抓取。 这是最容易误解的一点：

    工具谁提供是否用 WorkBuddy 登录态
    web_search（联网搜索）本插件✅ 是（你的 WorkBuddy 账号）
    web_fetch（抓取指定 URL）dsh 内置 web-fetch-http❌ 否（直连目标站点）

    想换抓取后端请另行配置 fetchProvider，与本插件无关。

  • ⚠️ 未登录时 web_search 会整体报错，不降级。 本插件把 searchProvider 写死为 workbuddy-agentic，而 dsh 的 provider 选择是「配置了就认死」：一旦桌面端登出 （或 token 过期且 refresh 失败），会抛出 WEB_PROVIDER_CONFIGURED_UNAVAILABLE， 不会悄悄退回 DeepSeek 搜索。 排查口诀：报这个 code → 先看桌面端还登着吗。

  • ⚠️ 桌面端装在自选盘符 / 自定义路径时需手动指定二进制。 插件不猜、不枚举盘符， 需设 WORKBUDDY_ELECTRON_BIN / WORKBUDDY_AI_ELECTRON_BIN。未设时会回落到另一版的 明文凭据（若存在）而不是整体失败。

  • 一次查询 = 云端一次多步 agentic 检索，实测 10~60 秒；dsh 的 web_search 允许模型一次发 1-4 个查询并发跑，开销较大属服务特性，不是 bug。中途 abort 有效（实测 100ms 内即中止）。

  • 综述里的引用由搜索服务自行选取；不提供 snippet（云端不下发原文摘录）。

  • 凭据过期且 refresh 也失效时，需回 WorkBuddy 桌面 App 重新登录。

  • 想用回 dsh 官方搜索：把 web 行 searchProvider 改回 deepseek-official，或直接卸载本插件。

  • 📋 失败态可自查：node tools/scenarios.mjs <插件目录> 会离线验证 52 项异常路径 （空查询、断网、401、流畸形、凭据损坏、并发、abort、接管范围、connect 装了但坏掉等）。

变更记录

只列对外可读的要点。每个版本的完整说明见 Releases； 机器可读的全量摘要见 package.json 的 versionNote。

版本要点
0.3.4修四个影响真实使用的缺陷：中文正文被吞进 URL（裸链漏排汉字主体，中文不用空格分词 → 必须把汉字当定界符）、URL 收尾漏剥反引号与 markdown 强调记号、truncated 硬编码为 false（前端因此不显示「来源列表已截断」）、未知加密算法版本被误报成「未登录」（WorkBuddy 升级加密算法后，明明登录着的用户会被告知去重新登录，而重登无效）。新增 38 条回归用例（T11/T12/T13）并用变异测试验证护栏非恒真
0.3.3macOS 补齐 Spotlight 发现链（mdfind 按 bundle id 反查 → plutil 校验 → 可执行性检查 → 去重 → 多命中报歧义），对齐官方 connect 的定位策略；此前 macOS 只有 /Applications/*.app 一条默认路径，装在别处就发现不了。Windows 行为完全不变
0.3.2新增 screenshots.json 与两张界面截图，供插件市场的详情页展示。运行时行为与 0.3.1 相同
0.3.1发布链路改走 npm 可信发布（Trusted Publishing / OIDC）：在 GitHub 上发 Release 即自动发布，不再依赖长期 npm token，发布物附带 provenance 签名；修正 package.json 的仓库地址大小写（npm 要求与仓库完全一致）。运行时行为与 0.3.0 相同
0.3.0区域绑定：region 默认 auto（选实际可用的那一版），首次用到时绑定一版、整会话不切换；取消跨版静默回落（不再悄悄改用另一版扣费）；新增 Windows 卸载注册表发现，覆盖「两版装在同一目录」「装在自选盘符」
0.2.6文档按读者分层：安装拆成「快速开始」与「遇到问题」，开发态细节移入 DEVELOPING.md；新增本变更记录
0.2.5冲突提示改为通用表述（不再点名具体插件）；安装文档去本机化；修正测试降级判据（环境差异不再误判为缺陷）
0.2.4修复三个真实缺陷：5.6+ 加密凭据解不开、Windows 缺 Electron 自动发现、connect 可能复用过期凭据
0.2.3版本策略改为「允许更新版本安装，只声明已验证到哪」；精简 CREDITS；补齐测试与社区档案文档
0.2.2新增异常路径测试套件；修两个健壮性缺陷；补「只管搜索、不管抓取」等用户场景说明
0.2.1转为零硬依赖：自带平台定位与凭据解密，不装 dsh-workbuddy-connect 也能完整工作；扩展到 macOS（实验性）
0.2.0委托 connect 的凭据 store；支持国际版与加密凭据
0.1.0首版

致谢

本插件站在他人成果之上，尤其感谢 dsh-workbuddy-connect 的作者 Corrine Hu —— WorkBuddy 5.6+ 的 $wbEncrypted 凭据解密算法、平台路径规则、 Electron 二进制定位策略，都源自该项目的逆向与验证工作（MIT 许可）。

我们把这部分能力重写为零依赖的自带模块，并在代码注释中逐处标注来源。 完整的借鉴清单、来源项目、许可证与各自的贡献边界，见 CREDITS.md。

若你是被借鉴项目的作者，认为标注不足或使用方式不当，请提 Issue —— 我们会补正或重写。

参与贡献

欢迎提 Issue 与 PR。三条最短规则：

  • 报告 Bug / 提需求：请用仓库的 Issue 模板（Bug 报告 / 功能请求）， 模板会把必要信息（dsh 版本、平台、是否已登录、错误码）一次问全，省去来回。
  • 安全问题请勿走公开 Issue，见 SECURITY.md。
  • 参与本项目即表示你同意遵守 CODE_OF_CONDUCT.md。

完整的贡献流程、提交规范与不能碰的红线，见 CONTRIBUTING.md。 动手改代码前，建议按这个顺序读文档：

文档用途
TESTING.md测试体系与发布回环：场景地图、三层套件（T1–T13 / S1–S9 / G1–G9）、发布流程。改代码前先读它。
DEVELOPING.md本地联调环境（junction 挂载、--dump-config 核验）、实现要点与安装排障。
COMPATIBILITY.md兼容矩阵与逐条实测依据。
NORM-COMPLIANCE.md与 dsh 官方规范的符合性审计（源码级证据），以及「哪些要改、哪些故意不改」。
GITHUB-SETUP.mdGitHub 侧要求对照：社区档案清单、工作流安全加固、仓库网页端设置清单。

维护者：改一处代码并发布（最短路径）

# 1) 改代码（lib/ 下三个模块：index=搜索流程、credentials=凭据、platform=平台定位）
#    纯 ESM、无构建步骤，改完直接生效。

# 2) 跑三套检查 —— 必须全绿才能发
node tools/regression.mjs "$PWD"        # 174 项：契约、凭据、区域、平台、提取边界
node tools/scenarios.mjs  "$PWD"        #  52 项：异常路径（断网/401/abort/凭据损坏/换行形态…）
node tools/check-github-meta.mjs "$PWD" #  仓库元信息与「不夹带本机信息」红线

# 3) 改版本号（package.json 的 version 与 versionNote）
#    versionNote 是给人和给机器看的一句话全量说明，请一并更新。

# 4) 提交并推到**默认分支**（main）
git commit -am "fix: ..." && git push origin HEAD:main

# 5) 打 tag 并**发布成 Release** —— 这一步才触发发布
git tag -a v0.3.5 -m "Release v0.3.5" && git push origin v0.3.5
#    然后 GitHub 上 Releases → Draft a new release → 选 tag v0.3.5 → Publish release

⚠️ 必须推到默认分支（main），不能只推 feature 分支。 市场 CI 是从 raw.githubusercontent.com/<默认分支>/package.json 读 dsh.bundle 的 —— 默认分支没更新，市场和用户看到的就还是旧版。

⚠️ 推 tag 不会触发发布。 .github/workflows/publish.yml 的触发条件是 release: types: [published]（外加手动 workflow_dispatch），没有 push: tags。 必须把 tag 发布成 Release，CI 才会跑。

本机可直接用 bash contrib/publish.sh 走完 4–5 步：它会自动注入代理、 跑完三套检查、把当前分支快进推送到默认分支（分叉则明确报错，绝不强推）、 校验 tag 与 package.json 版本一致，并在装了 gh 时自动创建 Release。 建议先 bash contrib/publish.sh --dry-run 看一眼会做什么。

为什么发布这么省事：.github/workflows/publish.yml 用 npm 可信发布（OIDC）， 不需要任何长期 npm token；工作流里还有一道版本一致性闸门，tag 与 package.json 不一致会直接拒绝发布，避免「tag 写 0.4.0、实际发出去 0.3.9」这种不可逆错误。 0.3.3 即以此链路发布，npm 上可查到 SLSA provenance 签名（来源仓库 = 本仓库、 来源工作流 = .github/workflows/publish.yml、触发 = refs/tags/v0.3.3）。

用户怎么升级：市场里点「升级」，或 dsh plugin --profile web add dsh-workbuddy-websearch@<新版本号> （见快速开始里关于 pnpm 24 小时冷静期的说明）。

想加一条回归用例：在 tools/regression.mjs 里找 T12/T13 段照抄格式即可 （check("T12.15", 条件, "说明")）。请顺手做一次变异测试 —— 把修复点改回旧行为， 确认新用例真的会失败；否则那条用例只是恒真的装饰。

维护者：插件市场上架材料

上架到 DSH 插件市场的提交物在 contrib/ —— 一个 YAML 条目 加一个 PR 即可；流程、门槛与「描述怎么写过审」都写在那个 README 里。 （contrib/ 不进 npm 包，只用于对外提交。）

许可证

MIT © 2026 XingLang & WorkBuddy (小研)

Related plugins

T

archify (deepseek-harness)

tt-a1i/archify

77.3k8 days agoTools & CapabilitiesMIT
T

WeKnora (dsh-weknora)

tencent/weknora

33.5k11 hours agoTools & Capabilities
T

weknora

tencent/weknora

20.2k2 months agoTools & Capabilities
T

BrowserSkill (dsh-plugin-browserskill)

tencent/browserskill

8.7k16 hours agoTools & CapabilitiesMIT