anweat/dsh-browser

dsh-browser

自包含的浏览器运行时插件 for DeepSeek Harness（DSH）。

把 Playwright（chromium 内核） 与 OpenCLI 作为插件自身的 npm 依赖打包（优先插件本地，缺省回退全局复用），对外提供一个 browser 服务 + 一组交互式浏览器工具。dsh-web-search-pro 通过 inject: ['browser'] 注入该服务，驱动它的 playwright / opencli 后端——不再依赖全局 CLI。

安装

dsh plugin --profile web add @anweat/dsh-browser
# 或本地目录 / tarball：
dsh plugin --profile web add ./dsh-browser
# 重启（web profile 关闭了 HMR）：
dsh --profile web

依赖 @deepseek-ai/* 已发布到 npm（^0.1.0-rc.6）。 若你的 harness 是本地源码 checkout（如 0.1.0-rc.5），版本号可能有出入——用 dsh plugin --profile web add ./<path> 并在 profile 的 pnpm-workspace.yaml 里对齐版本后重装即可。

内核与依赖的”打包 vs 复用”

服务：browser

dsh-browser 在 apply() 里 ctx.provide('browser', service)。任何插件声明 inject: ['browser'] 即可消费：

export const inject = ['tools', 'browser']
export function apply(ctx: Context) {
  const browser = ctx.get('browser') as BrowserService
  // browser.render / snapshot / searchResults / opencli / open / click / type / scroll / read / screenshot / close
}

服务接口（结构性，无需共享类型包）见 src/browser-service.ts。

工具（9 个）

配置（cordis.yml / patch config）

- insert:
    - id: browser
      name: '@anweat/dsh-browser'
      config:
        channel: chromium        # 'chromium'（打包内核）| 'msedge'（系统 Edge）
        headless: true
        opencliEnabled: true
        storageStatePath: ''     # Playwright 登录态 JSON（复用已登录会话）
        autoInstall: false       # 缺内核时是否自动 install chromium
        verbose: false

登录态复用

• channel: chromium + storageStatePath 指向一份 storageState JSON，即可用你已登录的身份抓受限页面。
• 生成登录态：npx playwright codegen --save-storage=storageState.json（或复用 dsh-web-search-pro 的 scripts/save-login.mjs），把产物路径填进 storageStatePath。
• opencli 的社交平台后端（小红书/推特/Reddit/IG/FB）仍需浏览器扩展 + 登录态在线，即使 opencli 已打包为依赖也绕不开扩展。

发布 / 构建

pnpm install          # 装依赖（playwright / opencli / @deepseek-ai/*）
pnpm run build        # tsc → lib/
node scripts/install-browser.mjs   # 安装 chromium 内核（发布前验证，可选）

与 dsh-web-search-pro 的关系

dsh-web-search-pro 现在 inject: ['browser']，其 web_snapshot / web_fetch_pro(playwright 后端) / web_platform_search(中文社区 playwright + 社交平台 opencli) 全部走本插件的 browser 服务。 两者可独立安装，但 web-search-pro 的浏览器类能力依赖 dsh-browser 先行提供 browser 服务（Cordis inject 自动排序，无需手动控制挂载顺序）。