dsh-chrome-use 0.1.11 → 0.1.12

package/README.md

@@ -2,13 +2,41 @@
 
 让 DeepSeek Harness 读取、操作和调试本机 Google Chrome。
 
-**安装**：[在 Chrome 应用商店安装扩展](https://chromewebstore.google.com/detail/anobmlnjdeahldefeikjdmmnckphpdhc)，再在 Harness 添加本插件，最后在扩展弹窗输入配对码。
-
 ## 安装
 
-1. **Chrome 扩展**：打开 [Chrome 应用商店](https://chromewebstore.google.com/detail/anobmlnjdeahldefeikjdmmnckphpdhc)，点击“添加至 Chrome”。以后扩展由 Chrome 自动更新，不用下载文件，也不用手动加载文件夹。
-2. **Harness 插件**：下载或克隆本仓库，在 Harness 的插件管理里添加仓库的本地绝对路径。命令行版在仓库根目录运行 `dsh plugin --profile headless add "$PWD"`；平时用哪个 profile，就装到哪个 profile。
-3. **连接**：在 Harness 设置 → dsh-chrome-use 点击“生成配对码”，再到 Chrome 工具栏打开 dsh-chrome-use 扩展，输入 8 位配对码并点击“连接”。也可以在对话里说：“请用 chrome_pair 连接浏览器。”
+> **先装 Harness 插件，再装 Chrome 扩展，最后配对。** 插件有三种装法，选一种，命令直接复制。
+
+### 1. 安装 Harness 插件
+
+**npm（推荐）**
+
+```sh
+dsh plugin --profile desktop add dsh-chrome-use
+```
+
+**GitHub 仓库**
+
+```sh
+dsh plugin --profile desktop add github:tao1020/dsh-chrome-use
+```
+
+**让 Agent 安装**：把下面这句话发给你正在用的 Agent：
+
+```text
+请安装 DSH 插件 dsh-chrome-use，仓库是 https://github.com/tao1020/dsh-chrome-use
+```
+
+> 命令里的 `desktop` 是桌面版的默认 profile；如果你用别的 profile，把它换成你的名字（例如 `web`）。桌面版也可以直接在「设置 → 插件」里安装，不用命令行。
+
+### 2. 安装 Chrome 扩展
+
+扩展在 Chrome 应用商店。点下面的链接，再点“添加至 Chrome”：
+
+**https://chromewebstore.google.com/detail/anobmlnjdeahldefeikjdmmnckphpdhc**
+
+### 3. 配对连接
+
+在 Harness 设置 → dsh-chrome-use 点“生成配对码”；在 Chrome 工具栏打开 dsh-chrome-use 扩展，输入 8 位配对码，点“连接”。也可以在对话里说：“请用 chrome_pair 连接浏览器。”
 
 需要 Google Chrome 120 或更新版本、DeepSeek Harness 0.2.1-rc.2 或更新版本。开发和测试使用 Node.js 22 或 24。
 

package/extension/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "dsh-chrome-use",
   "description": "Let DeepSeek Harness read, control and debug your Google Chrome tabs after pairing.",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "minimum_chrome_version": "120",
   "permissions": [
     "debugger",

package/extension/popup-state.js

@@ -0,0 +1,13 @@
+// Visibility of the popup's pairing controls for each connection state.
+// Kept separate from the DOM code so the three states are testable.
+export function popupState({ connected, paired }) {
+  const pairedOnly = Boolean(paired) && !connected;
+  return {
+    formHidden: Boolean(connected),
+    labelHidden: pairedOnly,
+    codeHidden: pairedOnly,
+    permissionHidden: pairedOnly,
+    helpHidden: pairedOnly,
+    pairedHintHidden: !pairedOnly,
+  };
+}

package/extension/popup.html

@@ -11,9 +11,10 @@
     <p id="status" role="status">正在检查连接…</p>
     <form id="pair-form">
       <label for="code" id="pair-label">首次连接：输入 Harness 给出的配对码</label>
-      <p class="help permission">连接后，Harness 可以读取和操作此 Chrome 中的所有普通网页，包括已经登录的网站。网页内容、截图和调试信息可能发送给你配置的模型服务。</p>
+      <p class="help" id="paired-hint" hidden>已保存配对，点下面的“连接”即可。</p>
+      <p class="help permission" id="permission-help">连接后，Harness 可以读取和操作此 Chrome 中的所有普通网页，包括已经登录的网站。网页内容、截图和调试信息可能发送给你配置的模型服务。</p>
       <div class="pair-row"><input id="code" inputmode="numeric" autocomplete="off" maxlength="8" placeholder="8 位配对码"><button type="submit">连接</button></div>
-      <p class="help">只需首次配对，成功后自动重连。临时码 2 分钟内有效，已保存的配对不会定时过期。</p>
+      <p class="help" id="pair-help">只需首次配对，成功后自动重连。临时码 2 分钟内有效，已保存的配对不会定时过期。</p>
     </form>
     <section>
       <p class="help">连接后，AI 自动选择网页，无需逐页授权。点击“断开连接”可以停止全部操作。</p>

package/extension/popup.js

@@ -1,3 +1,5 @@
+import { popupState } from './popup-state.js';
+
 const $ = id => document.getElementById(id);
 async function act(action, extra = {}) {
   $('error').textContent = '';
@@ -5,10 +7,14 @@ async function act(action, extra = {}) {
     const result = await chrome.runtime.sendMessage({ action, ...extra });
     if (!result?.ok) throw new Error(result?.error ?? '扩展没有响应，请重新打开。');
     $('status').textContent = result.connected ? '已连接到本机 Harness' : result.reconnecting ? '已配对，正在等待本机 Harness' : result.paired ? '已配对，点击连接即可' : '尚未配对';
-    $('pair-label').textContent = result.paired ? '已保存配对：留空即可连接' : '首次连接：输入 Harness 给出的配对码';
-    $('code').placeholder = result.paired ? '无需再次输入配对码' : '8 位配对码';
     $('status').classList.toggle('connected', result.connected);
-    $('pair-form').hidden = result.connected;
+    const show = popupState(result);
+    $('pair-form').hidden = show.formHidden;
+    $('pair-label').hidden = show.labelHidden;
+    $('code').hidden = show.codeHidden;
+    $('permission-help').hidden = show.permissionHidden;
+    $('pair-help').hidden = show.helpHidden;
+    $('paired-hint').hidden = show.pairedHintHidden;
     $('tabs').replaceChildren();
     for (const tab of result.tabs.length ? result.tabs : [{ title: '当前没有调试中的标签页' }]) {
       const li = document.createElement('li');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-chrome-use",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Control Google Chrome tabs from DeepSeek Harness.",
   "type": "module",
   "main": "./src/index.js",

package/src/client.js

@@ -58,7 +58,7 @@ async function checkRelease(current, fetcher = fetch) {
   } finally { clearTimeout(timer); }
 }
 
-const packageVersion = "0.1.11";
+const packageVersion = "0.1.12";
 // Wrapped by scripts/build-client.mjs for the Harness browser module loader.
 const React = require('react');
 const { createElement: h, useState, useEffect, useRef } = React;