dsh-web-browse

dsh-web-browse · 网页浏览

DSH 的通用网页浏览插件：在 DshDesktop 桌面壳与 Edge/Chrome 等通用浏览器 中，
都能把网页以独立标签页打开。

• DshDesktop：打开的是桌面网页标签页，网页顶部由 WebView2 扩展注入地址/搜索栏，
  不再使用 iframe，彻底解决站点禁止内嵌的问题；
• 通用浏览器：没有 window.dshDesktop 桥，直接 window.open 新开浏览器标签页，
  仅保留「新标签页打开」能力。

功能特性

功能	说明
侧边栏快速入口	侧边栏「🌐 网页浏览」按钮：左键打开默认网址；右键弹出悬浮搜索框
悬浮搜索框	输入网址直接访问；输入文字按所选引擎搜索；确认后在新标签页打开；Esc 或点击框外关闭
选中文本搜索	页面选中文本后右键，原生菜单「复制」下方出现「🔍 搜索选中文本」，点击即搜（仅 DshDesktop）
新标签页打开	DshDesktop 中为桌面网页标签页；通用浏览器中为浏览器新标签页
网页顶部栏	WebView2 扩展为网页标签页注入顶部地址/搜索栏（仅 DshDesktop）
网页浏览设置	默认网址、启动自动打开、搜索引擎（内置 + 自定义）

架构

dsh-web-browse/
├── lib/          harness 插件：侧边栏按钮、悬浮搜索框、「网页浏览设置」（localStorage）
├── extension/    WebView2 扩展（MV3 内容脚本）：网页顶部地址/搜索栏（仅 DshDesktop）
├── dsh.plugin.json
├── cordis.patch.yml
└── package.json

harness 插件（lib/）

• 侧边栏按钮
  • 左键：打开默认网址——DshDesktop 调用 window.dshDesktop.openWebTab(url)
    新开/激活一个桌面网页标签页（不占用聊天区）；通用浏览器直接
    window.open(url, '_blank') 新开浏览器标签页；
  • 右键：弹出悬浮搜索框——输入网址回车直接访问；输入普通文字用所选
    搜索引擎（内置/自定义）搜索；确认后在新标签页打开；Esc 或点击框外关闭。
• 右键菜单搜索（不重写右键）：DshDesktop 宿主在 WebView2 原生右键菜单
  「复制」正下方追加「🔍 搜索选中文本」项（见宿主 Form1.OnContextMenuRequested），
  点击即以选中文本打开悬浮搜索框（可换引擎后再确认）；无选中文本等其余情况原生菜单
  原样保留。通用浏览器中宿主菜单不可用——原生菜单不可由页面修改。
• 网页浏览设置（harness 设置 →「网页浏览设置」）：默认网址（默认
  https://chat.deepseek.com）、启动时自动打开、搜索引擎（内置 Bing / 百度 /
  Google，可自定义含 {q} 的 URL 模板）。设置保存在本机 localStorage；DshDesktop
  中经 window.dshDesktop.setWebSettings() 同步给桌面宿主，由宿主分发给所有网页
  标签页的顶部栏；通用浏览器中该同步为 no-op。

WebView2 扩展（extension/）

• 自动加载：DshDesktop 启动时（及每 30 秒）自动扫描 harness 的 plugins
  目录，识别其中的 WebView2 扩展（插件目录本身含 manifest.json，或含
  extension/ / web-extension/ / ext/ 子目录）并加载；
• 顶部栏：在非 harness 页面（排除 127.0.0.1:3080 与本地设置页）注入固定
  顶部栏——后退/前进/刷新、地址栏（输入网址直接访问；输入文字用所选引擎搜索，
  回车前显示将访问的网址/引擎与查询词）、搜索引擎下拉、新标签页、最小化（隐藏、
  切回主页、页面保活）、关闭（关闭标签页）；
• 与宿主通信：内容脚本运行在隔离世界，经 window.postMessage 把命令转发给
  宿主注入的主世界桥 window.dshDesktop，再经 chrome.webview.postMessage 到达
  宿主；宿主回执按原路返回。无 background/service worker，不依赖 chrome.storage，
  设置全部来自宿主缓存。

使用说明

• DshDesktop：完整能力——侧边栏入口、桌面网页标签页、顶部地址/搜索栏、
  右键菜单搜索、设置同步到所有网页标签页；
• 通用浏览器（Edge / Chrome 等）：所有「打开标签页」操作（左键 / 右键搜索 /
  选中文本搜索 / 设置页「立即打开」/ 启动自动打开）都回退为
  window.open(url, '_blank') 直接新开浏览器标签页；顶部栏注入与右键菜单搜索
  不可用。非用户手势触发的打开（如启动自动打开）可能被浏览器弹窗拦截，失败时
  以轻提示告知。

DshDesktop 配套接口

类别	接口	说明
桥接脚本	openWebTab(url) / newWebTab(url) / setWebSettings(settings)	打开/新建网页标签页、同步设置；对每个标签页（含网页标签页）注入
右键菜单	Form1.AddSearchSelectionMenuItem	「复制」下方追加「🔍 搜索选中文本」，经 ExecuteScriptAsync 调用页面 __dshWebBrowseSearch(text) 打开悬浮搜索框（__dshChatWebSearch 保留为兼容别名）；插件侧不再接管右键菜单
宿主命令	tab.open / tab.new / tab.switch{main} / ext.ping / ext.getSettings / ext.settings	顶部栏所需；网页标签页允许外部站点导航，「新窗口」请求转为新标签页
扩展发现	扫描 harnessDir/plugins	识别插件内含 manifest.json 的扩展目录并加载，与配置目录 %LOCALAPPDATA%\DshDesktop\Extensions 合并生效

已知限制

• 通用浏览器：无 window.dshDesktop 桥，顶部地址/搜索栏注入与右键菜单搜索
  不可用（原生菜单不可由页面修改）；
• 个别站点（如 Google）禁止第三方注入或被反爬限制时，顶部栏按钮可能不可用，
  可改用侧边栏按钮、标签条或「新标签页」按钮操作；
• 扩展经 WebView2 扩展机制加载（CoreWebView2Profile.AddBrowserExtensionAsync），
  所有标签页共享，需 WebView2 Runtime 支持 MV3 扩展（新版 Evergreen 均可）。

License

MIT