kimi-webbridge-dsh 1.4.0 → 1.4.1

package/README.md

@@ -2,16 +2,26 @@
 
 Kimi WebBridge 的 dsh 插件：通过本机 kimi-webbridge 守护进程（`127.0.0.1:10086`）驱动用户的真实浏览器（保留登录态与 Cookie）。注册一个模型工具 `kimi_webbridge`，覆盖导航、点击、输入、读取页面（accessibility tree + @e 引用）、截图、JS 求值、CDP、网络、上传、PDF 导出、标签页与会话管理。
 
-## 功能
+## 安装（一次性，零手工配置）
 
-| 能力 | 说明 |
-|---|---|
-| 浏览真实页面 | 在用户已登录的浏览器中导航、点击、填表、滚动 |
-| 读页面 | `snapshot` 返回 accessibility tree 与 `@e` 元素引用 |
-| 截图 / 导出 PDF | 结果写入本地文件，返回路径 |
-| JS 求值 / CDP | `evaluate`（页面上下文）、`cdp`（chrome.debugger 直通） |
-| 网络 / 上传 | 请求捕获与文件上传 |
-| 会话分组 | 一个任务 = 一个 session = 一个标签页组，可一键清理 |
+```powershell
+dsh plugin --profile web add kimi-webbridge-dsh
+```
+
+本包声明了 `dsh.bundle.patch`：`dsh plugin add` 会自动把它登记进 profile 的 bundle 层（`dsh.profile.bundles`），**无需手动编辑任何 cordis.patch.yml**。安装后重启一次 dsh web 即生效（bundle 在启动时加载）：
+
+```powershell
+dsh web
+```
+
+## 用法
+
+模型在新会话中可直接调用 `kimi_webbridge` 工具。核心规则：
+
+- **一个任务 = 一个 session = 一个标签页组**：任务开始时选一个 session 名，之后每次调用都带上（如 `camping-research`）。
+- **读页面用 snapshot**：返回 accessibility tree 和 `@e` 引用，点击/输入优先用 `@e` 引用而非手写 CSS。
+- **截图返回文件路径**：用 read 工具打开查看。
+- **守护进程不可达**：工具会自动启动；二进制缺失时自动从官方 CDN 下载安装。
 
 ## 依赖
 
@@ -32,26 +42,27 @@ Kimi WebBridge 的 dsh 插件：通过本机 kimi-webbridge 守护进程（`127.
 
 不支持的平台组合会明确报错并提示手动安装。
 
-## 安装（一次性，零手工配置）
+### 守护进程二进制位置
 
-```powershell
-dsh plugin --profile web add kimi-webbridge-dsh
-```
-
-本包声明了 `dsh.bundle.patch`：`dsh plugin add` 会自动把它登记进 profile 的 bundle 层（`dsh.profile.bundles`），**无需手动编辑任何 cordis.patch.yml**。安装后重启一次 dsh web 即生效（bundle 在启动时加载）：
+下载到用户目录（与官方安装器路径一致，无需管理员权限；按用户隔离）：
 
-```powershell
-dsh web
-```
+| 平台 | 最终路径 |
+|---|---|
+| Windows | `%USERPROFILE%\.kimi-webbridge\bin\kimi-webbridge.exe` |
+| macOS / Linux | `~/.kimi-webbridge/bin/kimi-webbridge`（自动 `chmod 755`） |
 
-## 用法
+下载流程：先落盘为临时文件（`kimi-webbridge(.exe).tmp-{pid}-{时间戳}`）→ SHA-256 与官方清单核对 → 匹配才重命名为最终路径；不匹配则删除临时文件并中止，任何未验证的二进制都不会留在磁盘。该路径与官方安装器 / `kimi-webbridge upgrade` 命令完全一致，插件、官方工具共用同一份守护进程。
 
-模型在新会话中可直接调用 `kimi_webbridge` 工具。核心规则：
+## 功能
 
-- **一个任务 = 一个 session = 一个标签页组**：任务开始时选一个 session 名，之后每次调用都带上（如 `camping-research`）。
-- **读页面用 snapshot**：返回 accessibility tree 和 `@e` 引用，点击/输入优先用 `@e` 引用而非手写 CSS。
-- **截图返回文件路径**：用 read 工具打开查看。
-- **守护进程不可达**：工具会自动启动；二进制缺失时自动从官方 CDN 下载安装。
+| 能力 | 说明 |
+|---|---|
+| 浏览真实页面 | 在用户已登录的浏览器中导航、点击、填表、滚动 |
+| 读页面 | `snapshot` 返回 accessibility tree 与 `@e` 元素引用 |
+| 截图 / 导出 PDF | 结果写入本地文件，返回路径 |
+| JS 求值 / CDP | `evaluate`（页面上下文）、`cdp`（chrome.debugger 直通） |
+| 网络 / 上传 | 请求捕获与文件上传 |
+| 会话分组 | 一个任务 = 一个 session = 一个标签页组，可一键清理 |
 
 ## 配置（可选）
 
@@ -69,7 +80,7 @@ dsh web
 | `baseUrl` | `http://127.0.0.1:10086` | 守护进程地址 |
 | `requestTimeoutMs` | `120000` | 单次请求超时（毫秒） |
 | `autoStartDaemon` | `true` | 守护进程未运行时自动启动 |
-| `autoInstallDaemon` | `true` | 二进制缺失时自动从官方 CDN 下载安装（关闭后需手动运行 `irm https://cdn.kimi.com/webbridge/install.ps1 | iex`） |
+| `autoInstallDaemon` | `true` | 二进制缺失时自动从官方 CDN 下载安装（关闭后需手动[从官方安装](https://www.kimi.ai/products/kimi-webbridge)） |
 | `daemonVersion` | `latest` | 自动安装时的版本（可固定如 `0.3.0`） |
 
 ## 移除

package/lib/index.js

@@ -91,6 +91,19 @@ function releasePlatform() {
   return null;
 }
 
+/**
+ * Platform-aware manual-install hint shown when auto-install is disabled or fails.
+ * Windows users get the PowerShell one-liner; macOS/Linux users get the bash one-liner.
+ * @returns a short human-readable install instruction.
+ */
+function manualInstallHint() {
+  const page = "https://www.kimi.ai/products/kimi-webbridge";
+  if (process.platform === "win32") {
+    return `run \"irm https://cdn.kimi.com/webbridge/install.ps1 | iex\" in PowerShell (or install from ${page})`;
+  }
+  return `run \"curl -fsSL https://cdn.kimi.com/webbridge/install.sh | bash\" (or install from ${page})`;
+}
+
 /**
  * One HTTP JSON round-trip with a timeout and caller-abort support.
  * @param url - absolute URL.
@@ -355,13 +368,13 @@ function apply(ctx, config = {}) {
         const notes = [];
         if (!existsSync(daemonBinPath())) {
           if (!autoInstallDaemon) {
-            throw new Error(`kimi-webbridge: daemon binary not found at ${daemonBinPath()} and autoInstallDaemon is disabled. Install it with: irm https://cdn.kimi.com/webbridge/install.ps1 | iex`);
+            throw new Error(`kimi-webbridge: daemon binary not found at ${daemonBinPath()} and autoInstallDaemon is disabled. Install it manually: ${manualInstallHint()}`);
           }
           try {
             const { url } = await installDaemonBinary({ version: daemonVersion, timeoutMs: requestTimeoutMs });
             notes.push(`installed daemon from ${url}`);
           } catch (installError) {
-            throw new Error(`kimi-webbridge: daemon binary missing and auto-install failed: ${installError?.message ?? installError}. Install it manually: irm https://cdn.kimi.com/webbridge/install.ps1 | iex`);
+            throw new Error(`kimi-webbridge: daemon binary missing and auto-install failed: ${installError?.message ?? installError}. Install it manually: ${manualInstallHint()}`);
           }
         }
         if (autoStartDaemon) {
@@ -370,7 +383,7 @@ function apply(ctx, config = {}) {
             result = await attempt();
           } catch (retryError) {
             const hint = notes.length > 0 ? " " + notes.join("; ") + "." : "";
-            throw new Error(`kimi-webbridge: daemon at ${baseUrl} still unreachable after starting it.${hint} Check ~/.kimi-webbridge/logs/daemon.log or reinstall: irm https://cdn.kimi.com/webbridge/install.ps1 | iex`);
+            throw new Error(`kimi-webbridge: daemon at ${baseUrl} still unreachable after starting it.${hint} Check ~/.kimi-webbridge/logs/daemon.log, or reinstall: ${manualInstallHint()}`);
           }
         } else {
           throw new Error(`kimi-webbridge: daemon at ${baseUrl} is not running and autoStartDaemon is disabled. Start it with: ${daemonBinPath()} start`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kimi-webbridge-dsh",
   "description": "Kimi WebBridge plugin for dsh: drive the user's real browser (their login sessions) through the local kimi-webbridge daemon at 127.0.0.1:10086. Registers a single kimi_webbridge tool covering navigate, click, fill, snapshot, screenshot, evaluate, cdp, network, upload, save_as_pdf, tab and session management.",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "license": "MIT",
   "type": "module",
   "keywords": [