dsh-browser-ops
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 许可使用。
✨ Features
- Agent 直接操作浏览器：
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，如校验"创建成功"）。
- Web GUI 面板：DSH 设置 →「浏览器操作」页签：启动/连接浏览器、●录制/■停止、流程列表、变量编辑、参数一键重放。
- 两种浏览器模式：
| 模式 | 说明 | 适用 |
|---|
managed（默认） | 插件启动独立 Chrome（专用档案目录，登录态持久，不触碰日常浏览器数据） | 造测试数据；推荐 |
connect | 附加你日常在用的 Chrome（先跑 scripts/connect-chrome-mac.command 带调试端口重启，再 browser_launch {mode:'connect'}） | 必须用日常会话/登录态时 |
🚀 Install
需要 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_* 工具；或打开 设置 → 浏览器操作 查看面板。
🧭 Typical usage
启动浏览器，打开测试系统 https://test.example.com（需要登录就先在弹窗里登录一次）。
开始录制流程"创建订单"：browser_record_start → [你手动操作] → browser_record_stop
把第 3 步(客户名称)设为变量：browser_flow_edit
执行 browser_run_flow《创建订单》，params {"客户名称":"张三"}，verifyText "创建成功"。
⚙️ Configuration
| 环境变量 | 作用 |
|---|
DSH_BROWSER_OPS_DATA | 数据根目录（浏览器档案 / flows / 截图）。默认 ~/.dsh/data/browser-ops |
DSH_BROWSER_CHROME | 指定 Chrome/Edge/Chromium 可执行文件路径（默认自动探测 macOS 常见路径） |
📁 Data layout
~/.dsh/data/browser-ops/
├── chrome-profiles/managed # managed 模式浏览器档案（登录态持久）
├── flows/ # 录制的流程 JSON + index.json
└── screenshots/ # browser_screenshot 输出
🧪 Development
# 端到端冒烟（真实 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/ 是面板源码。
📝 Known limitations (v1)
- 录制覆盖：点击、文本输入（合并）、原生下拉、checkbox/radio、回车、SPA/整页跳转等待。不含文件上传、拖拽、iframe 内、跨标签序列。
- 定位"语义优先"（label/placeholder/text/testid/id → 兜底结构路径）；页面结构大变时建议重新录制。
connect 模式当前仅提供 macOS 一键脚本；managed 模式的 Chrome 自动探测以 macOS 为主，其他平台可用 DSH_BROWSER_CHROME 指定。- 无官方"UP主/作者"类排行等三方数据接口——纯浏览器自动化，数据来自你打开的真实页面。
📄 License
MIT © 2026 lirui
