Aurora-Lucas/dsh-chrome-browser ↗★ 0

@local/dsh-chrome-browser

Model-facing Google Chrome tool: drives the installed Chrome over the DevTools protocol so front-end work can navigate, screenshot, inspect, and interact without per-call shell approval. 允许模型免去逐次Shell授权直接进行网页导航、截图和交互,适合前端及自动化任务。

Package
@local/dsh-chrome-browser
Compatibility
Unverified
Version
1.0.3
License
MIT
Last updated
Oct 10, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Aurora-Lucas/dsh-chrome-browser

Configuration

The bundle patch sets these; apply merges them over its own defaults and validates them.

KeyDefaultMeaning
chromePath'' (auto-detect)Chrome executable.
headlesstrueRun without a window.
noSandboxtruePass --no-sandbox (required when the Host runs as root).
defaultWidth / defaultHeight1280 / 900Default viewport.
maxOutputChars100000Default cap for dom/text/eval output.
navigationTimeoutMs30000Navigation and wait_for budget.
artifactDir'' (system temp)Where screenshots and PDFs go when no path is given.

How Chrome is located

The tool schema has no path parameter: the model never needs to know where the browser lives. resolveChromePath resolves in this order and fails with an actionable message naming the config key when nothing matches:

  1. the row's chromePath config;
  2. the DSH_CHROME_PATH environment variable;
  3. a probe list — /usr/bin/google-chrome, google-chrome-stable, google-chrome-beta, /usr/bin/chromium, chromium-browser, /opt/google/chrome/chrome, /snap/bin/chromium, plus the usual macOS and Windows locations.

For an unusual installation, set DSH_CHROME_PATH for the Host or edit the row's chromePath — no code change is needed.