前言¶
DeepSeek Harness (DSH) 的插件体系允许开发者扩展能力。在开发或使用 Agent 处理网页时，频繁切换浏览器窗口会打断工作流。deep-browser 插件将 HTTP(S) 页面嵌入到对话窗口的右侧边栏中，实现上下文与网页的无缝衔接。
插件定位¶
这是 DeepSeek Harness 的一个插件，旨在在对话窗口的右侧边栏中打开和浏览网页。由用户 temidayoxyz 维护，遵循 MIT 许可证。它解决了在 DSH 环境中直接查看实时网页的需求，而不是依赖截图或外部浏览器。
核心功能¶
插件提供了一套基于当前 Web Profile 能力的浏览功能：
- 基础操作：支持新建标签页、地址栏输入、刷新页面以及通过链接在系统浏览器中打开。
- 布局控制：提供宽度预设（Fit / 390 / 768）。注意，这是针对 iframe 的 CSS 布局调整，并非设备 UA 模拟。
- 交互逻辑：在 UI 中点击 HTTP(S) 链接（无需修饰键）即可在侧边栏打开；本地 localhost / loopback 地址会自动转换为 http:// 访问。
安装与启用¶
使用官方安装命令即可：
dsh plugin --profile web add github:temidayoxyz/deep-browser
注意：从 git 安装会拉取源代码而非构建产物。插件通过 pnpm 的 prepare 脚本构建 lib/ 目录。如果你的环境使用 pnpm ≥ 10，首次添加可能会因构建限制而失败。此时，请将 pnpm 报错的包密钥复制到配置文件 pnpm-workspace.yaml 中：
allowBuilds:
dsh-deep-browser: true
重新运行添加命令。请确保只信任来源，或考虑固定到特定 commit（如 github:temidayoxyz/deep-browser#<sha>）。
典型用法¶
在本地开发或调试插件时，先拉取源码并构建：
pnpm install
pnpm build
在 Harness 仓库中运行调试命令：
pnpm dsh web --patch D:/Codebase/deep-browser/overlay.yml --no-open
打开打印出的 URL，展开右侧边栏，选择 Browser 标签页。在 DSH 的 Plugins 标签页下，你可以配置默认页面宽度（Fit / 390 / 768）以及是否默认在侧边栏打开链接。
适用场景与限制¶
- 适用场景：需要将网页内容与对话上下文紧密关联的开发或使用场景。
- 重要限制：插件仅利用当前 Web profile 的能力，不模拟 Chromium 的高级特性，如缩放、Cookies 管理、缓存、高亮注释、颜色模式偏好或 Agent 驱动。这些功能需要 Desktop 级别的浏览器上下文。此外，工作区文件内容显示在 Document Preview 面板，该插件仅用于处理实时 URL。
插件旨在提供轻量级的侧边栏浏览体验，适合需要快速对照网页与对话内容的开发者。更多详情与源码，请访问 GitHub 仓库。
