dsh-builtin-browser 0.1.3 → 0.1.5

package/README.en.md

@@ -16,7 +16,22 @@ This plugin provides the **host-side capability** (browser seam, Electron CDP pr
 ## Requirements
 
 - DeepSeek Harness (dsh) with the `web` profile
-- A host that provides `ctx.electronViewHost` (a machine holding real Electron `WebContentsView`s, e.g. dsh's desktop shell). Without one, the plugin mounts the seam but the provider and tools stay disabled — plain `dsh web` is unaffected.
+- **Electron runtime** (optional peer dependency): the desktop shell carries it; on plain `dsh web` the plugin must be able to locate an Electron binary (see below)
+- With a desktop shell (`ctx.electronViewHost`) the shell's embedded view is used; without one the plugin **self-hosts**: it spawns its own Electron window and the `browser_*` tools still work
+
+**Electron lookup order**: ① `require('electron')` (peer installed) → ② DSH install anchors → ③ `node_modules/.pnpm` virtual store → ④ `ELECTRON_PATH` env var. A clear error tells you when none is found.
+
+### Verified versions
+
+| Component | Version |
+|---|---|
+| DeepSeek Harness (dsh) | `0.1.0-rc.5` |
+| Electron | `43.4.0` |
+| Node.js | `22.20.0` |
+| dsh-builtin-browser | `0.1.3` |
+| OS | Windows 10 (10.0.26200) |
+
+> The plugin declares `electron >= 30`; other platforms (macOS/Linux) run the same protocol but were only verified on the Windows environment above.
 
 ## Install
 

package/README.md

@@ -16,7 +16,22 @@
 ## 环境要求
 
 - DeepSeek Harness(dsh)且安装了 `web` profile
-- 提供 `ctx.electronViewHost` 的宿主(持有真实 Electron `WebContentsView` 的主机,如 dsh 的桌面外壳)。没有它时,插件只挂载 seam,provider 与工具保持禁用——纯 `dsh web` 不受影响。
+- **Electron 运行时**(可选 peer 依赖):桌面外壳自带;纯 `dsh web` 下需要能定位到 Electron 二进制(见下)
+- 有桌面外壳(`ctx.electronViewHost`)时用外壳嵌入视图;没有时插件**自托管**:自己拉起一个 Electron 窗口,`browser_*` 工具照常可用
+
+**Electron 定位顺序**:① `require('electron')`(peer 依赖已装)→ ② DSH 安装锚点 → ③ `node_modules/.pnpm` 虚拟仓库 → ④ `ELECTRON_PATH` 环境变量。找不到时工具会报清晰的错误提示。
+
+### 验证过的版本
+
+| 组件 | 版本 |
+|---|---|
+| DeepSeek Harness(dsh) | `0.1.0-rc.5` |
+| Electron | `43.4.0` |
+| Node.js | `22.20.0` |
+| dsh-builtin-browser | `0.1.3` |
+| 操作系统 | Windows 10 (10.0.26200) |
+
+> 插件声明 `electron >= 30`;其他平台(如 macOS/Linux)按同一协议运行,但仅在上表 Windows 环境实测。
 
 ## 安装
 

package/lib/browser-electron/provider.js

@@ -149,7 +149,13 @@ export class ElectronBrowserProvider {
             }
         }
         signal?.throwIfAborted();
-        await handle.sendCommand(CDP_PAGE_NAVIGATE, { url });
+        const result = await handle.sendCommand(CDP_PAGE_NAVIGATE, { url });
+        // Page.navigate resolves even when the navigation fails; surface the
+        // failure instead of leaving a silent white screen.
+        const errorText = result.errorText;
+        if (typeof errorText === 'string' && errorText !== '') {
+            throw new BrowserError(`browser: navigation to "${url}" failed: ${errorText}`, 'BROWSER_NAVIGATION_FAILED');
+        }
     }
     /** Execute JS in the active tab's page context. */
     async execute(session, request, signal) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-builtin-browser",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Shared real browser capability for DeepSeek Harness: a visible browser the human watches and can take over, driven by the agent over CDP (snapshot/execute/content/tab management); host-side seam, provider, and browser_* tools",
   "type": "module",
   "main": "lib/index.js",