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 复用"

层	实际是什么	打包还是复用
chromium 内核	共享缓存 %LOCALAPPDATA%\ms-playwright（约 400MB）	永远复用共享缓存，不塞进插件、不重复下载；缺失时 browser_install 一键补
playwright 驱动（JS 包）	playwright npm 依赖	插件本地 node_modules 优先，缺省回退全局 npm
opencli（纯 Node CLI）	@jackwener/opencli npm 依赖	同上，本地优先 / 全局复用

服务：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 个）

工具	作用
browser_open	打开 URL，返回标题/可读文本/全页截图路径（持久页会话）
browser_click	按 CSS 选择器点击
browser_type	向 input/textarea 输入
browser_scroll	纵向滚动（触发懒加载）
browser_read	读当前页 URL/标题/文本（不截图）
browser_screenshot	当前页全页截图
browser_close	关闭当前页（下次 open 全新）
browser_status	运行时状态（channel/headless/chromium 是否就绪/opencli 是否启用/当前页）
browser_install	安装 playwright chromium（browser_status 报缺失时执行一次）

配置（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 自动排序，无需手动控制挂载顺序）。