前言¶
在 DeepSeek Harness（DSH）里做联网任务时，助手往往需要打开网页、读正文、截图，或在可控前提下完成输入和点击。社区里已有多种浏览器控制方案：有的会改 DSH 安装目录里的桥接文件，更新桌面版后要重装；有的依赖 Chrome/Firefox 扩展去管已有标签。若你只想给 DSH 桌面版自带的右侧栏浏览器加一套小工具、且不 patch 桌面程序，可以看看维护者 ruodongyu 发布的第三方插件 dsh-sidebar-browser-control（分类：联网工具）。它通过 Cordis 插件机制注入客户端，配合本机桥接服务，让助手在「当前可见标签」上完成打开、读取、导航和受控交互。
这是什么¶
DSH Sidebar Browser Control 的定位是：轻量、受控的原生侧栏浏览器插件。只安装插件，不修改 DSH 桌面程序文件；外部网页默认只读，需要输入或点击时须由用户在界面里逐页授权。
- 维护者：ruodongyu
- 当前版本（资料记载）：0.3.0
- 许可证：MIT
- 目录页：https://www.skillhub.cn/plugins/ruodongyu/dsh-sidebar-browser-control
- 源码与文档：https://github.com/ruodongyu/dsh-sidebar-browser-control
已验证环境为 Windows 11、DSH 0.2.0-rc.2；依赖 DSH 内部服务与 Electron webview。其他 DSH 版本、macOS、Linux 及纯网页版在 README 中标注为尚未实测。
核心功能¶
工具名均以 sidebar_browser_ 为前缀，需先选中一个 DSH 会话；除 open 外，其余工具要指定 tabId，且目标页必须在侧栏中可见。暂不支持隐藏标签切换、复杂拖拽、跨 iframe 元素、密码框与文件选择框。
| 工具前缀 | 作用 |
|---|---|
open |
自动展开侧栏，新建标签并打开 HTTP(S) 网址 |
tabs |
获取当前可见网页及 tabId |
read / screenshot |
读取可见文字与元素编号 / 保存 PNG |
navigate / back / forward / reload |
导航、后退、前进、刷新 |
fill / click / scroll |
文本框输入、元素点击、滚动 |
与同类方案的差异（据项目 README 对 2026-10-04 文档的对比，非第三方安装实测）：wqty123/dsh-browser 工具面更广但桌面桥接会改安装文件；omdsh-dev/dsh-browser 走浏览器扩展；DSH-better-sidebar 侧重侧栏工作台框架。本项目强调「仅插件、较小工具集、逐页交互授权」。
安装与启用¶
安装前建议备份当前 DSH profile 下的 package.json、cordis.patch.yml、pnpm-lock.yaml 和 pnpm-workspace.yaml。
1、从 GitHub Release 下载 .tgz 安装包；若自行从源码打包，在源码目录执行 npm pack 得到本地归档。
2、用 DSH 桌面携带的官方 CLI 以离线方式加入插件。Windows PowerShell 示例（路径按你本机 .tgz 文件名调整）：
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add './dsh-sidebar-browser-control-local-0.3.0.tgz' --offline
3、完全退出并重新打开 DSH，避免旧模块缓存；运行中的任务可能中断，请先确认。界面右下角出现「侧栏控制：已连接」表示客户端已连上桥接。
@deepseek-ai/dsh-tools 由 DSH 运行时提供。部分 profile 的包管理器可能提示缺少 peer dependency；README 建议不要为消提示另装一整套 DSH 核心包，而应确认实际 DSH 版本与 package.json 中 peerDependencies（0.2.0-rc.2）一致。插件以当前 DSH 进程权限运行，安装前请自行审阅源码与 MIT 许可证。
典型用法¶
可直接对助手下达自然语言，并点名工具。README 示例：
使用 sidebar_browser_open，在你的侧栏打开 https://www.bing.com，然后读取页面。
交互流程要点：
1、其他站点默认只读；要允许输入与点击，需点右下角「侧栏控制」并对当前网址授权，导航或刷新后授权失效。
2、先调用 read 拿到元素 ref，每次 fill / click 后应重新 read。
3、网页内容视为不可信数据；发送、购买、删除等仍须用户明确授权。
连接、存储与安全¶
桥接只监听 127.0.0.1，使用 port: 0 由系统分配端口。客户端通过 DSH 已鉴权的 /api/sidebar-browser-control/bootstrap 获取端口与随机令牌，不扫描端口，也无固定端口兜底。
运行数据在当前 profile 的 .sidebar-browser-control 子目录。截图目录 screenshots 最多保留 20 张且合计不超过 50 MiB；单张 PNG 不超过 8 MiB。control.json 含本地诊断令牌，勿上传或分享。详见仓库 SECURITY.md。
验证与停用¶
无需安装 DSH 核心依赖即可跑单元测试：
node --test tests/*.test.mjs
桌面实测可用仓库内 PowerShell 脚本 verify-open.ps1、verify-live.ps1（默认 desktop profile）。停用可在 DSH 插件管理中关闭本插件；完整回滚需退出 DSH 后恢复安装前的 profile 配置备份。
适用场景与注意¶
适合需要在 DSH 桌面原生侧栏 内做自动化读页、截图，并在用户逐页授权下做简单表单交互的场景。不适合依赖隐藏标签、iframe 内控件或文件/密码控件的流程。
路线图（README 摘要）包括等待页面/元素就绪、隐藏标签切换、下拉与复选框等；不计划提供任意 JavaScript 执行工具。具体见 ROADMAP.md。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本插件亦不属于 DeepSeek 官方项目。
链接¶
- 社区目录：https://www.skillhub.cn/plugins/ruodongyu/dsh-sidebar-browser-control
- GitHub：https://github.com/ruodongyu/dsh-sidebar-browser-control
