dsh-browser：给 DeepSeek Harness 每段对话配一个真实浏览器

它是做什么的？

CJYLZS/dsh-browser 是 DeepSeek Harness（DSH）的浏览器插件，为每一段对话配一个真实的本地浏览器。它解决的是 Agent 只能读文本、无法真正操作网页的问题：Chrome 或 Edge 以独立进程运行，拥有自己的配置目录与 CDP 端口，Agent 通过六个工具驱动它，右侧边栏同步显示同一批页面。对话之间不共享标签页、Cookie 或端口，关闭 Harness 也不会留下伪装成应用一部分的浏览器进程。

核心功能

• 一会话一浏览器：侧边栏面板按会话名连接，工具调用按来源会话解析浏览器，两个对话互相看不到对方的标签页与登录状态。
• 双向可信输入：侧边栏里的点击与输入会转发到真实页面，Agent 的点击与输入工具在元素自身位置派发真实鼠标与文本事件，忽略合成点击的站点同样接受。
• 可外部附着：每个浏览器监听对外 CDP 端口，浏览器自带的调试入口、其他 Playwright 实例或仓库附带的脚本都能连上同一个浏览器。
• 免选择器读页面：快照工具打印页面的无障碍树，并为每个节点标注引用名，Agent 借此阅读从未见过的页面并指名要点击的元素。
• 精简工具集：只提供六个工具而非几十个，通用求值工具承担大部分工作，其余覆盖代码无法表达的能力。

怎么使用这个插件？

在 DSH 对话的右侧边栏选择新建标签页中的浏览器，该会话的浏览器随即启动并显示画面，地址栏回车即可导航，在画面上点击、滚动、输入都会作用到真实页面。之后直接用自然语言提要求即可，例如让它打开文档并说明安装章节写了什么，工具会操作面板正在展示的同一个浏览器，你能看着它干活。需要时可用浏览器调试入口、其他 Playwright 或仓库脚本附着到同一浏览器；关闭标签页不会停止浏览器，重新打开页面仍在，停止浏览器需要在面板状态行里显式操作。使用前需本机已安装 Chrome 或 Edge，插件依赖的 Playwright 核心不会自行下载浏览器。

报错怎么排查？

浏览器无法启动时，先确认本机已安装 Chrome 或 Edge，因为插件依赖的 Playwright 核心不会自带浏览器。若侧边栏画面空白或工具操作的不是同一页面，检查该会话的浏览器是否已被显式停止，重新打开标签页通常即可恢复。若外部工具无法附着，确认对应浏览器的 CDP 端口未被其他进程占用，并按官方说明处理已知限制与待办事项。