抓虾 Browser v0.3.0：API 优先的浏览器自动化，支持实时预览、人工接管与流程复用

[howtimeschange]

大家好，分享一下 抓虾 Browser：一个可以独立运行的 DeepSeek Harness 浏览器插件，把 API 优先、真实网页预览和可复用脚本放在同一个包里，不需要抓虾后端。

这次 v0.3.0 完整参考了抓虾 Harness 的浏览器实现，并补上从“理解页面”到“执行、核验、复用”的浏览器工作流。

能做出什么效果

你可以让 Agent 读取商品页面、筛选表格、填表和翻页；在明确业务接口及授权范围后，通过当前页面的客户端或同源 API 执行任务，再读回实际业务状态。导入文件、点击导出和下载 CSV 也在同一个浏览器插件内完成，返回文件大小、类型和 SHA-256 回执。

在 DSH 右侧可以一直看到 Agent 实际操作的网页。网页标签横向排列在顶部；需要人工登录或调整页面时，点击“接管操作”，完成后“恢复 Agent”。脚本执行页也可实时观看，并保持只读。

API First 不是只写在提示词里

内置 crawshrimp-browser Skill 采用以下顺序：

1. 观察业务页面，探查 DOM、框架、页面模块/client 名和资源端点线索。
2. 优先使用已经理解的页面客户端/API；接口不明确时，捕获真实请求的方法、参数和响应证据。
3. 在当前页面登录上下文发送同源请求，或调用页面自己的模块；API 不适合时回退到 DOM 操作。
4. 用页面读回、API 业务字段或文件检查核验结果，再保存脱敏证据。

任意 JS、API 请求和文件动作接入 DSH 原生权限，并与人工接管互斥。原生“完全权限”下自动执行，其他权限组合继续使用原生审批。写请求出现不确定结果时先读回业务状态，不自动重放。

从一次操作到可重复执行

• 核验与日志：固定结构的 verify 检查 DOM、数量、页面、API 回执和文件；journal 保存当前会话证据。
• 流程沉淀：从已经验证成功的稳定步骤生成 workflow；重跑后重新核验，下载检查绑定本次文件回执。
• 便携脚本：支持参数、分页、多阶段、共享状态、reload/abort，以及受控上传下载和网络捕获动作。
• Adapter 草稿 → 测试 → 发布：每个任务在隔离上下文测试，全部通过后才将原样测试过的文件发布到本地工作区，供后续复用。

安装与独立运行

适配 DSH 0.2.1-alpha.4，需要 Node.js ^22.19.0 || >=24.0.0 以及 Chrome/Chromium。

dsh plugin --profile web add -w github:howtimeschange/dsh-crawshrimp-browser#v0.3.0
dsh --profile web

在会话里加载 crawshrimp-browser Skill，再打开目标页面；右侧新增面板中选择“实时浏览器”。具体配置和工具示例见中文 README。

• Browser 仓库与中文说明
• v0.3.0 Release
• Harness 浏览器能力对照
• 抓虾 Harness 官网与插件入口

网页自动化统一放在 Browser。需要清洗数据、导出 Excel/CSV 时可组合 Data；制作 Word/PowerPoint 可组合 Office。这些插件各自独立运行。

截图使用本地合成商品页。72 项测试通过；我们已用真实 Chrome、原生 DSH 工具链和独立 Web 环境验证 API 请求、业务读回、文件传输、隔离与流程复用；真实商家网站的业务规则和登录方式仍需在授权账号中逐项核验。插件迁移的是浏览器工作流，不包含 Harness 全部后端系统、模型链和全局调度。

欢迎在仓库提兼容性问题，也欢迎分享你希望沉淀的电商或其他网页工作流。