dsh-browser-ops
Browser Ops for DeepSeek Harness：让代理驱动真实浏览器（托管的 Chrome 或通过 CDP 连接的日常 Chrome），对页面进行快照和读取，将手动操作录制为带变量插槽的可复用流程，并重放流程以按需创建测试数据。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lirui1024k/dsh-browser-ops#bdd5ccbc000cb33d759d10a213e5239b9e9621a4Browser Ops 以 dsh-browser-ops 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Browser Ops for DeepSeek Harness — 让 DSH 的 agent 直接操作真实浏览器、录制手动操作流程并按参数自动重放造测试数据。
English: a DeepSeek Harness plugin that drives a real browser (managed Chrome with an isolated persistent profile, or your daily Chrome over CDP), lets the agent snapshot/read/click/fill/query pages, records your manual operations into reusable flows with variable slots, and replays them to create test data on demand. Ships 27 browser_* tools + a Settings panel.
非官方插件，非 DSH 官方出品；按 MIT 许可使用。
browser_launch / browser_open / browser_snapshot / browser_click / browser_fill / browser_select / browser_read_text / browser_read_table / browser_eval / browser_screenshot / browser_diagnostics … —— 让它"打开系统查订单、填表提交、排查页面 console/网络报错"都行。browser_record_start 后你在浏览器窗口手动点一遍 → browser_record_stop 保存为 JSON 流程（存于数据目录 flows/）。browser_flow_edit（或设置页面板）把输入步骤标为变量 → browser_run_flow 填参数重放并校验（可带 verifyText，如校验"创建成功"）。| 模式 | 说明 | 适用 |
|---|---|---|
managed（默认） | 插件启动独立 Chrome（专用档案目录，登录态持久，不触碰日常浏览器数据） | 造测试数据；推荐 |
connect | 附加你日常在用的 Chrome（先跑 scripts/connect-chrome-mac.command 带调试端口重启，再 browser_launch {mode:'connect'}） | 必须用日常会话/登录态时 |
需要 DSH Desktop / DeepSeek Harness（node ≥ 20）。
# 方式一：npm（推荐）
dsh plugin --profile dsh-desktop add dsh-browser-ops
# 方式二：GitHub
dsh plugin --profile dsh-desktop add git+https://github.com/<you>/dsh-browser-ops.git
# 方式三：本地开发（link 到源码目录，改动重启即生效）
dsh plugin --profile dsh-desktop add link:/path/to/dsh-browser-ops
装完重启 DSH Desktop，新会话即可使用 browser_* 工具；或打开 设置 → 浏览器操作 查看面板。
启动浏览器，打开测试系统 https://test.example.com（需要登录就先在弹窗里登录一次）。
开始录制流程"创建订单"：browser_record_start → [你手动操作] → browser_record_stop
把第 3 步(客户名称)设为变量：browser_flow_edit
执行 browser_run_flow《创建订单》，params {"客户名称":"张三"}，verifyText "创建成功"。
| 环境变量 | 作用 |
|---|---|
DSH_BROWSER_OPS_DATA | 数据根目录（浏览器档案 / flows / 截图）。默认 ~/.dsh/data/browser-ops |
DSH_BROWSER_CHROME | 指定 Chrome/Edge/Chromium 可执行文件路径（默认自动探测 macOS 常见路径） |
~/.dsh/data/browser-ops/
├── chrome-profiles/managed # managed 模式浏览器档案（登录态持久）
├── flows/ # 录制的流程 JSON + index.json
└── screenshots/ # browser_screenshot 输出
# 端到端冒烟（真实 Chrome：录制→变量→重放→校验），无需 DSH：
ELECTRON_RUN_AS_NODE=1 "<DSH Desktop>" smoke/smoke.mjs
# 重新构建 Web 客户端面板（需要 esbuild，见 scripts/build-client.mjs 说明）
ELECTRON_RUN_AS_NODE=1 "<DSH Desktop>" scripts/build-client.mjs
目录：lib/core/* 为框架无关引擎（bridge/record/replay/locator/snapshot…），lib/tools.js 注册 browser_*，lib/http.js 提供面板 JSON 接口，lib/client-src/ 是面板源码。
connect 模式当前仅提供 macOS 一键脚本；managed 模式的 Chrome 自动探测以 macOS 为主，其他平台可用 DSH_BROWSER_CHROME 指定。MIT © 2026 lirui