抓虾 Browser v0.3.0 · API 优先与可复用浏览器工作流

抓虾 Browser v0.3.0 将 API 优先的浏览器任务整理成可执行、可核验、可复用的流程，所有网页能力继续放在同一个独立插件中，无需抓虾后端。

• 页面 DOM/框架/模块与端点线索探查、PageModel 和策略 bundle。
• 页面客户端 JS、同源登录态 API 请求和有界网络证据；默认元数据，凭证脱敏。
• 工作区上传、隐藏 file input、file chooser、同源 Cookie 直链及点击/blob 下载；MIME、大小、签名和 SHA-256 回执。
• DOM、API 业务字段与文件核验，session journal，成功 workflow 沉淀及本次下载回执绑定。
• Adapter 草稿、隔离测试、原样本地发布；phase/page/shared、reload/abort 与受控文件/网络动作。
• 保留实际网页预览、顶部多标签、人工接管和只读脚本画面，并修复接管成功后的待处理状态清理。

页面写操作与 DSH 原生权限、人工接管锁保持一致；完全权限自动执行，其他组合继续原生审批。写请求超时返回结果未知及 attemptId，要求先读回，不自动重放。

验证：72 项测试通过，含真实 Chrome、原生 DSH ToolRuntime/SkillRegistry、文件与网络边界、会话隔离、二次导出复用及实际 DSH Web 中文输入/点击/归还控制。截图使用本地合成商品数据；真实商家业务仍需在授权账号中核验。

适配 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

中文 README · Harness 能力对照

v0.2.1 — 抓虾官方图标与中文优先文档

将抓虾浏览器插件的图标统一为抓虾 Harness 官方图标，并将仓库与安装包首页改为中文优先。

• 同包封装应用图标的原生 256×256 PNG；DSH 插件卡片、实时浏览器标签和引导入口复用同一文件。
• 校验原生元数据与 Web 客户端图标保持一致；无需外部图片地址或抓虾后端。
• 默认 README 提供中文功能说明、安装入口与使用场景，完整英文文档保留在 README.en.md。
• 保留 v0.2.0 的浏览器工具、内置 Skill、实时预览和原生权限行为。

安装到 DSH Web profile：

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

验证：图标同步/语法检查、4 项客户端测试、安装包内容比对、原生 DSH 图标元数据、实际 DSH Web 插件卡片与实时浏览器界面，以及中英文文档链接检查。适配 DSH 0.2.1-alpha.4。

English: Bundles the official Crawshrimp app icon across native metadata and the Live Browser UI, with asset consistency checks and Chinese-first documentation. Full English documentation remains included.

v0.2.0 — Live Browser, bundled skill and script workflows

dsh-crawshrimp-browser v0.2.0

All webpage work now lives in one independent Browser plugin: 14 tools cover interactive page actions, explicit login state, portable scripts, parameter validation and bounded pagination.

• Added owned-page listing/navigation, select, press, wait, and private storage-state loading.
• Merged Scripts into Browser; interactive sessions and script runs share one browser connection and use separate isolated contexts.
• Added offline adapter/parameter validation, Crawshrimp-compatible params/PAGE/PHASE/SHARED globals, and a hard pagination limit with truthful failures.
• Added same-package live browser preview: CDP Page.startScreencast JPEG frames with bounded screenshot fallback, per-page ACK/throttling, and an authenticated DSH WebSocket at /crawshrimp-browser/preview.
• Added the DSH web client/right-sidebar panel with session/page/run ownership filtering, page switching, follow-latest, bounded pointer/wheel/keyboard/paste/IME input, explicit takeover/return, and release cleanup on blur, hide, disconnect, or page close.
• Script-run pages are registered for live observation but are explicitly read-only; their temporary pages are removed when the run completes or is cancelled.
• Included examples, a login-state helper, a functional roadmap and a migration guide. No standalone Scripts 0.2.0 package is needed.

Validation completed for this candidate: 35/35 browser package tests; npm run check; real local Chrome with DSH 0.2.1-alpha.4, Cordis ToolRuntime, native approval audit, authenticated preview transport, session isolation, takeover/release, script-page lifecycle, and artifact readback through the independent Data/Office packages. Chrome/Chromium must be installed separately. The formal DSH Web UI screenshot and interaction acceptance is tracked separately and is not implied by the package/native checks. No Crawshrimp backend, real merchant workflow or model-driven completion is required or claimed. Probe/network/download tools remain roadmap items.

中文：全部网页操作、脚本和实时网页预览统一进入浏览器插件；新增页面管理、参数校验、有界翻页、登录态、CDP 画面流和显式人工接管。脚本页面只读，原 Scripts 用户请按迁移指南升级。页面探查、网络证据和下载/导出证据仍属于后续路线图，不计入本版本已实现范围。

• Bundle the crawshrimp-browser Skill through DSH's native registry: observe, ref-based actions, verification, human login handoff and portable-script reuse.
• Honor the native Full Access preset (danger-full-access + never) as standing permission; retain native approval for other combinations.
• Move web pages into a horizontal tab strip, remove the duplicate heading row, and fix the DSH pane focus race during repeated manual clicks.
• Verified with the real logged-in DSH Web Agent: native skill load, page/ref actions, and script run produced 3 rows and a JSON artifact with no repeated approval prompts in Full Access. Synthetic local data only.
• Final browser suite: 37 tests, syntax checks, package contents, and actual Web UI keyboard/mouse/scroll/control handoff verified.

v0.1.0 — Independent Chrome browser tools

Standalone browser tools for DeepSeek Harness 0.2.1-alpha.4. Uses Playwright directly; requires a local Chrome/Chromium or an explicitly configured CDP endpoint. No Crawshrimp backend or companion plugin is required.

• Six tools: open, observe, click, fill, screenshot and close.
• Session-isolated contexts, native DSH approval, cancellation and lifecycle cleanup.
• Nine tests pass, including real headless Chrome and preservation of a separate external CDP browser/page after plugin unload.

Install the attached prebuilt tarball with dsh plugin --profile ecommerce add -w ./dsh-crawshrimp-browser-0.1.0.tgz, or use github:howtimeschange/dsh-crawshrimp-browser#v0.1.0.

Tests use synthetic local pages; no real merchant account or model API is used.