sweven-tears / 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