dsh-workbuddy-fetch
Manifest validRoutes the dsh web_fetch tool through the WorkBuddy desktop app gateway using its existing sign-in, with a configurable fallback to the built-in HTTP fetcher.
dsh-workbuddy-fetch
把 DeepSeek Harness 的 web_fetch(抓取) 接到 WorkBuddy 的网页抓取网关,
并一并提供 web_search —— 两个工具都用你已经登录的 WorkBuddy 账号,不需要任何 API Key。
背景:dsh-workbuddy-websearch 接管了 web_search,
但明确把 web_fetch 留给了 dsh 内置的 web-fetch-http(直连目标站点)。
本插件补上抓取这一半;同时为了装一个包就两个工具都能用,它会在启动时委托上游插件
注册搜索 provider(调它自己的 apply(),不复制实现)。
| 工具 | 谁实现 | 装本插件后 |
|---|---|---|
web_search | 上游 dsh-workbuddy-websearch 的实现 | ✅ 可用(本插件委托注册) |
web_fetch | 本插件自己的 provider | ✅ 可用(云网关 + 本地回落) |
💡 只装本插件就够了:上游作为
peerDependency会被一起装上。 若你也单独装了上游插件,两个不会打架 —— 本插件发现搜索已注册就静默跳过。
目录
它做什么
装上之后,模型调用 web_fetch 的路径变成:
web_fetch
└─ ctx.web.fetch()
└─ workbuddy-fetch provider
├─ ① POST {WorkBuddy 网关}/agenttool/v1/webfetch ← 用你的登录态
│ 成功 → 返回云端抽取好的 markdown 正文
└─ ② 网关拒绝 / 不可用 → 回落 @deepseek-ai/dsh-web-fetch-http
(就是装本插件之前 web_fetch 用的那个后端)
为什么要第 ② 步。 实测(2026-11,国内版账号)该网关不是全站可用:
| 站点 | 网关结果 |
|---|---|
github.com / zhihu.com / csdn.net / juejin.cn / docs.python.org / gov.cn / baidu.com | ✅ 正常 |
en.wikipedia.org / medium.com / bbc.com / news.ycombinator.com | ❌ 15021 domain rejected by via routing policy |
如果严格只用网关,这些站点会从「能抓」变成「抓不了」—— 插件反而让能力倒退。
所以默认开启回落:能走网关的走网关,走不通的走原来的路,web_fetch 的能力只增不减。
💡 反过来也成立:在本机不能直连外网的环境(研发网 / 隔离网)里, dsh 原来的
web_fetch一直是TypeError: fetch failed;装本插件后, 那些网关支持的站点第一次变得可抓。
web_search 是怎么来的
本插件不复制上游的搜索实现。启动时它调用上游包导出的 apply(ctx),
让上游自己把 workbuddy-agentic 注册进同一个 ctx.web —— 效果与上游被单独挂载完全相同。
这样做的好处是:SSE 解析、综述清理、来源提取、双版本凭据、令牌续期只有一条维护线,
上游修 bug 你自动受益。
安装
前置只有一条:本机已安装并登录 WorkBuddy 桌面端(国内版或国际版任一)。
上游 dsh-workbuddy-websearch
是 peerDependency。注意它不会被自动装上(dsh 的 profile 关掉了
autoInstallPeers),所以:
# ① 装上游(提供凭据能力 + 搜索实现)
dsh plugin --profile <你的 profile> add dsh-workbuddy-websearch
# ② 装本插件
dsh plugin --profile <你的 profile> add <本插件目录的绝对路径>
⚠️ 顺序最好别反。 若先装本插件,上游会以「未声明 dsh.bundle 的普通依赖」
身份被 pnpm 链进来,而不会进入 profile 的 bundles 列表。本插件仍能正常
委托它注册搜索(它是个普通包,能 import 到就行),但上游自己的
web-workbuddy-websearch 那一行不会挂载 —— 少一层显式来源,排查时更难看清。
先装上游、再装本插件,两层 bundles 都在,--dump-config 里一目了然。
重启 dsh 后生效。核验(应同时看到两个 provider):
dsh --profile <你的 profile> --dump-config | grep -A4 "id: web"
# searchProvider: workbuddy-agentic
# fetchProvider: workbuddy-fetch
⚠️ 同一个 provider id 只能由一个插件注册。 若你还装着注册了
workbuddy-fetch或workbuddy-agentic的其他插件(旧版、fork),ctx.web会按 id 去重。本插件对这两种撞车都做了处理: 搜索撞车时静默认领(别人已经注册好了,等于成功), 抓取撞车时才报错并给出排查步骤。
配置
全部可写在 profile 的 cordis.patch.yml 里(config 优先),或用环境变量。
都有默认值,不设也能用。
- id: web-workbuddy-fetch
name: dsh-workbuddy-fetch
config:
fallback: true # 网关走不通时回落本地抓取
timeoutMs: 20000 # 云端抓取预算
fallbackTimeoutMs: 15000 # 回落后的本地抓取预算
maxLength: 100000 # 回传正文字符上限;0 = 不截断
# endpoint: https://copilot.tencent.com # 覆盖网关地址(默认按凭据区域自动选)
| 环境变量 | 默认 | 说明 |
|---|---|---|
WORKBUDDY_FETCH_FALLBACK | true | 是否回落本地抓取。设 0 变成「严格只用 WorkBuddy」 |
WORKBUDDY_FETCH_TIMEOUT_MS | 20000 | 云端抓取预算(毫秒),会换算成网关的 timeout 秒 |
WORKBUDDY_FETCH_FALLBACK_TIMEOUT_MS | 15000 | 回落抓取预算(毫秒) |
WORKBUDDY_FETCH_MAX_LENGTH | 100000 | 回传正文字符上限 |
WORKBUDDY_FETCH_ENDPOINT | 按区域自动 | 覆盖网关地址 |
账号区域(国内版 / 国际版)不在本插件里单独配置 —— 它跟着
dsh-workbuddy-websearch 的 region 设置走,保证搜索与抓取扣同一个账号。
行为细节
-
返回形态:云端已把正文抽成 markdown,这里按
text交给dsh-tool-web原样渲染(就是Fetched <url> (HTTP <status>)那段)。不做云端 AI 摘要 —— 摘要会丢原文细节,而且每次抓取多花一次云端模型调用。 -
正文优先级:同一份
web_fetch调用只走一条路径,不会「两边都抓一遍再挑」。 -
哪些失败会回落:
云端失败原因 是否回落 出口路由策略拒绝( 15021)✅ 回落 网络错误 / 上游 5xx / 正文为空 / 非文本资源 ✅ 回落 凭据失效( 401)先强制续期重试一次,仍失败则回落 URL 安全裁决( 15018SSRF、WEB_INVALID_URL)❌ 不回落 上游标记 decisive的拒绝❌ 不回落 调用方 abort ❌ 不回落 原则:「这一条路径走不通」才回落,「这个 URL 危险」不回落 —— 后者回落等于绕过安全裁决。
-
两条路径都失败时,错误信息会把两边的原因都列出来,不会只留一句
TypeError: fetch failed让人误以为是插件坏了。 -
同源重定向:本地回落后端只跟随同源重定向(跨源会明确报错),这是它原有的安全策略。
和搜索插件的 patch 会互相覆盖吗
会 —— 而且装错顺序会让抓取静默失效。 这是本插件最需要注意的一条。
web 行的 patch 语义是「按 id 整行替换 config」,不是深合并。谁后装,
谁的 config 就是最终生效的那一份:
| 安装顺序 | 最终 web 行 | 结果 |
|---|---|---|
| 只装本插件 | search=workbuddy-agentic / fetch=workbuddy-fetch | ✅ 搜索、抓取都走 WorkBuddy |
| 上游先、本插件后 | search=workbuddy-agentic / fetch=workbuddy-fetch | ✅ 正确 |
| 本插件先、上游后 | search=workbuddy-agentic / fetch=http | ⚠️ 抓取被打回 dsh 原生 |
最后一行是真实存在的坑:上游的 patch 里写着 fetchProvider: http(它当初假设
没人会接管抓取),后装它就会把本插件的 workbuddy-fetch 覆盖掉。
本插件不会报错,抓取只是悄悄变回直连 —— 这正是最难发现的一类故障。
怎么避免:装的时候先装上游,再装本插件。装完用这条命令核验:
dsh --profile <你的 profile> --dump-config | grep -A4 "id: web"
# 两个字段都必须是 workbuddy-* 才算对
万一顺序反了:重装一次本插件(remove 后再 add)即可把 patch 层顶回最后。
💡 上游作者已在它的 README 里写明「只管搜索,不管抓取」, 所以这个覆盖不是 bug,是两个插件各自合理、组合起来才出现的层叠问题。 本插件选择在文档里明说,而不是偷偷改别人的配置。
已知边界
- 网关的域名覆盖由腾讯侧决定,本插件无法扩展。被
15021拒绝的站点只能靠回落路径, 而回落路径需要本机能直连外网。两头都不满足的站点(例如隔离网里的medium.com)仍然抓不到 —— 此时错误信息会明确说明是哪一条路径拒绝的。 401的处理:网关对无效凭据回的是 HTML 401 页面而不是 JSON,本插件按鉴权失败处理 (强制续期 + 重试一次)。凭据长期失效需回 WorkBuddy 桌面端重新登录。- 只解析 markdown:本插件请求
format: "markdown"。网关另外支持html/screenshot, 但screenshot无法映射到 dsh 的WebFetchBody(只接受html/text),故不暴露。 - 非文本资源(PDF / 图片)网关会回空正文,本插件据此回落到本地抓取 ——
由本地那条路给出 dsh 原本那套
WEB_UNSUPPORTED_CONTENT_TYPE之类的明确错误。
安全
- 对 WorkBuddy 的凭据文件只读;令牌续期只在内存中完成,不回写磁盘。
- 所有云端请求只发往 WorkBuddy 官方网关(国内
https://copilot.tencent.com、 国际https://www.workbuddy.ai),不经过任何第三方中转。 - 回落路径不会放宽安全边界:它用的就是 dsh 自带的
HttpFetchProvider, 保留仅公共地址、DNS 结果全量校验、连接固定到已校验地址、字节/字符上限、 同源重定向等全部约束。回落后不会比装插件之前更宽松。 - 发现安全问题请不要开公开 Issue。
卸载
dsh plugin --profile <你的 profile> remove dsh-workbuddy-fetch
bundle patch 随包消失,web 行的 fetchProvider 自动回到上一层
(dsh-base 的 http,即 dsh 原生的本地抓取),无需手动改配置。
⚠️ 若你曾在 profile 的
cordis.patch.yml里写过- id: web-workbuddy-fetch传 config, 卸载后需手动删掉那段,否则 dsh 启动会报entry not found(仅告警)。
致谢与来源
本插件不打包、不修改、不分发 WorkBuddy 桌面端的任何代码。 端点与请求形状来自对
本机已安装 App 的只读检查(resources/app.asar.unpacked/cli 中的 WebFetchTool),
相关权利归腾讯 / WorkBuddy 所有。
凭据、平台定位、区域绑定与令牌续期复用自
dsh-workbuddy-websearch(MIT,
XingLang & WorkBuddy 小研)—— 通过运行时调用其导出实现,而非复制其代码。
完整的来源清单、各来源许可、哪些是原创、哪些是参考重写(含 buildFallbackBridge()
的说明),见 CREDITS.md。
许可证
MIT © 2026 RomanticMysteryLH
本项目建立在他人成果之上,按 MIT 要求已在 LICENSE 末尾保留全部上游版权声明。
Comments
Loading…