yunti-browser-runtime 0.1.1 → 0.1.2

package/README.md

@@ -79,6 +79,30 @@ npm run doctor
 npm run doctor:json
 ```
 
+## 复制给 Agent 的安装引导
+
+把下面这段话复制给你正在使用的 Agent，让它一步步引导你安装和验证：
+
+```text
+请帮我安装并接入 Yunti Browser Runtime。它是一个本地浏览器运行时，让你通过 MCP 操作我本机 Chrome/Edge 页面。
+
+请按步骤引导我完成，不要跳步：
+
+1. 确认我本机有 Node.js 22+。
+2. 执行：npm install -g yunti-browser-runtime
+3. 执行：yunti-browser-runtime print-config -- --agent 当前Agent名称 --human
+4. 根据输出，把 MCP server 配置加入当前 Agent 的 MCP 配置。
+5. 执行：yunti-browser-runtime bridge
+6. 引导我打开 Chrome/Edge 的扩展管理页，开启开发者模式，手动加载扩展目录：
+   $(npm root -g)/yunti-browser-runtime/extension
+7. 告诉我扩展里默认 bridge URL 是 http://127.0.0.1:48887，本地默认不需要 token，也不需要保存设置。
+8. 打开任意 http/https 页面并刷新。
+9. 执行：yunti-browser-runtime doctor
+10. 如果 doctor 正常，再调用 yunti_list_browser_targets 或 yunti_get_tool_usage_hints 验证你能看到浏览器页面。
+
+注意：Chrome 扩展不能由 npm 静默安装，必须由我手动在浏览器扩展页加载。你要一步步告诉我点哪里、复制什么、检查什么。
+```
+
 ## 安装浏览器扩展
 
 开发加载方式：
@@ -88,10 +112,11 @@ npm run doctor:json
 3. 点击“加载已解压的扩展程序”。
 4. 选择本项目的 `extension/` 目录。
 5. 打开任意 `http` 或 `https` 页面。
-6. 点击扩展图标，确认 bridge 地址为 `http://127.0.0.1:48887`，保存设置。
-7. 刷新目标页面，确认页面已连接。
+6. 刷新目标页面，确认页面已连接。
 
-扩展只负责把页面注册到本地 bridge，并执行 Agent 发来的浏览器动作。
+扩展默认使用 `http://127.0.0.1:48887`，本地安装不需要 token，也不需要保存设置。
+扩展 popup 只用于自定义 bridge URL、页面匹配或可选 token。扩展只负责把页面注册到
+本地 bridge，并执行 Agent 发来的浏览器动作。
 
 也可以生成 zip 包用于分发或归档：
 
@@ -255,7 +280,7 @@ token。
 
 ## 发布状态与后续事项
 
-- `yunti-browser-runtime@0.1.1` 已发布到官方 npm registry。
-- `0.1.1` 将本地默认使用路径改为免 bridge token。
+- `yunti-browser-runtime@0.1.2` 已发布到官方 npm registry。
+- `0.1.2` 将扩展 popup 的 token 移入高级设置，并补充可复制给 Agent 的安装引导。
 - 发布后验证命令：`npm run release:verify-published`。
 - 如要上架浏览器扩展商店，需要再次审查 broad host permissions。

package/docs/EXECUTION_PLAN.md

@@ -56,6 +56,7 @@
 | P4.18 | 已完成 | npm 发布后验证命令 |
 | P4.19 | 已完成 | npm 正式发布执行 |
 | P5.1 | 已完成 | 本地默认免 bridge token |
+| P5.2 | 已完成 | 扩展 popup 与安装引导简化 |
 
 ## P0.1 bridge token + CORS 收紧
 
@@ -1297,6 +1298,43 @@ metadata 与当前 `package.json` 一致。
 - `npm run release:publish` 成功发布 `yunti-browser-runtime@0.1.1`。
 - `npm run release:verify-published` 返回 0。
 
+## P5.2 扩展 popup 与安装引导简化
+
+状态：已完成（2026-07-03）
+
+实现摘要：
+
+- 扩展 popup 首屏不再展示 Bridge Token 输入框，避免用户误以为本地默认安装需要填写
+  token。
+- Bridge Token 移入“高级设置”，并标注为可选；如果用户已有 token 配置，高级设置会
+  自动展开。
+- popup 默认状态文案改为“默认无需设置，打开或刷新 http/https 页面即可”。
+- README 增加“复制给 Agent 的安装引导”，让用户可以把一段话交给 Agent，由 Agent
+  分步骤带用户完成 npm 安装、MCP 配置、扩展加载和 doctor 验证。
+- README / INSTALL 明确：加载扩展后默认不需要保存设置，不需要 token。
+- package 和 extension 版本同步提升到 `0.1.2`。
+
+### 目标
+
+让用户在安装扩展后尽量立即可用：默认无需填写 token、无需保存 popup 设置；需要
+自定义 bridge URL、页面匹配或 token 时再进入高级/设置路径。
+
+### 验收标准
+
+- popup 首屏不出现 Bridge Token 输入框。
+- popup 仍保留可选 token 配置能力。
+- README 包含可复制给 Agent 的安装引导词。
+- README / INSTALL 不再要求默认本地安装时点击 popup 保存 token 或保存设置。
+- `npm run release:check` 通过。
+- `npm run release:publish` 发布 `yunti-browser-runtime@0.1.2`，并通过
+  `npm run release:verify-published` 验证。
+
+### 验收记录
+
+- `npm run release:check` 通过。
+- `npm run release:publish` 成功发布 `yunti-browser-runtime@0.1.2`。
+- `npm run release:verify-published` 返回 0。
+
 ## 每阶段完成后的固定检查
 
 ```bash
@@ -1318,10 +1356,11 @@ rg "/U[s]ers|C[o]deg|x[y]y|y[b]m100" README.md docs skills package.json
 
 ## 当前下一步
 
-P0.1-P5.1 已完成，`yunti-browser-runtime@0.1.1` 已发布到官方 npm registry。
+P0.1-P5.2 已完成，`yunti-browser-runtime@0.1.2` 已发布到官方 npm registry。
 
 - 发布后验证已通过：`npm run release:verify-published`。
 - 本地默认使用不再需要 bridge token；需要加固时可显式设置
   `YUNTI_BROWSER_BRIDGE_TOKEN`。
+- 扩展 popup 默认不需要用户保存设置；token 已移入高级可选项。
 - 后续如要上架浏览器扩展商店，发布前还需重新审查 broad host permissions。
 - 后续版本开发前，先在本文档新增下一阶段目标、范围和验收标准。

package/docs/INSTALL.md

@@ -54,12 +54,14 @@ Development loading:
 2. Enable developer mode.
 3. Choose "Load unpacked".
 4. Select the project `extension/` directory.
-5. Click the extension icon and confirm the bridge URL is `http://127.0.0.1:48887`.
-6. Open any `http` or `https` page and click the extension icon to confirm the
-   page is connected.
-
-The extension registers browser pages with the local bridge. It does not create
-agent conversations or depend on a remote workspace.
+5. Open or refresh any `http` or `https` page.
+6. Click the extension icon only if you want to confirm status or customize
+   settings.
+
+The extension defaults to `http://127.0.0.1:48887`. Local installs do not need a
+token and do not require saving popup settings. The extension registers browser
+pages with the local bridge. It does not create agent conversations or depend on
+a remote workspace.
 
 To create a distributable zip:
 

package/docs/PROJECT_STATUS.md

@@ -2,9 +2,10 @@
 
 ## Current Phase
 
-Patch release `yunti-browser-runtime@0.1.1` is complete. The local loopback
-bridge no longer requires a token by default, and the published package is
-verified with `npm run release:verify-published`.
+Patch release `yunti-browser-runtime@0.1.2` is complete. The local loopback
+bridge no longer requires a token by default, the extension popup no longer
+shows token as a first-run field, and the published package is verified with
+`npm run release:verify-published`.
 
 ## Current State
 
@@ -42,7 +43,9 @@ verified with `npm run release:verify-published`.
 - `npm run release:dry-run` and `npm run release:publish` pin the official npm
   registry at `https://registry.npmjs.org/`, avoiding accidental publication to
   a locally configured mirror registry.
-- `yunti-browser-runtime@0.1.1` is published on the official npm registry.
+- `yunti-browser-runtime@0.1.2` is published on the official npm registry.
+- Extension popup keeps Bridge Token under optional advanced settings; default
+  local installs do not require saving popup settings.
 - `npm run test:e2e` provides an opt-in real-browser Playwright smoke test for
   extension loading, page registration, MCP target listing, snapshot, click/fill,
   and CDP `Runtime.evaluate`.
@@ -248,6 +251,13 @@ verified with `npm run release:verify-published`.
   real-browser smoke skipped by configuration; `npm run check` and
   `npm run release:check` passed; `npm run release:publish` published
   `yunti-browser-runtime@0.1.1`; `npm run release:verify-published` returned 0.
+- P5.2 extension popup and onboarding simplification is complete: Bridge Token
+  is now optional under advanced settings, README contains a copyable Agent
+  installation prompt, and default extension loading no longer asks users to
+  save popup settings.
+- Latest P5.2 validation: `npm run release:check` passed; `npm run
+  release:publish` published `yunti-browser-runtime@0.1.2`; `npm run
+  release:verify-published` returned 0.
 
 ## Known Risks
 

package/docs/PUBLISHING_BLOCKERS.md

@@ -7,7 +7,7 @@ publishing `yunti-browser-runtime`.
 
 No active npm publish blockers as of 2026-07-03.
 
-`yunti-browser-runtime@0.1.0` is published on the official npm registry and
+`yunti-browser-runtime@0.1.2` is published on the official npm registry and
 verified with `npm run release:verify-published`.
 
 ## Resolved Blocker: npm 2FA Publish Token

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Yunti Browser Runtime",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Local browser runtime for AI agents through MCP.",
   "permissions": [
     "activeTab",

package/extension/popup.css

@@ -34,6 +34,22 @@ label {
   font-size: 12px;
 }
 
+details {
+  display: grid;
+  gap: 6px;
+  color: #334155;
+  font-size: 12px;
+}
+
+summary {
+  cursor: pointer;
+  font-weight: 600;
+}
+
+details label {
+  margin-top: 6px;
+}
+
 input,
 textarea {
   width: 100%;

package/extension/popup.html

@@ -14,14 +14,17 @@
         Bridge URL
         <input id="bridgeUrl" autocomplete="off" />
       </label>
-      <label>
-        Bridge Token
-        <input id="bridgeToken" autocomplete="off" type="password" />
-      </label>
       <label>
         页面匹配
         <textarea id="platformMatches" rows="3"></textarea>
       </label>
+      <details id="advancedSettings">
+        <summary>高级设置</summary>
+        <label>
+          Bridge Token（可选）
+          <input id="bridgeToken" autocomplete="off" type="password" />
+        </label>
+      </details>
       <button id="save">保存设置</button>
       <button id="refresh">刷新状态</button>
     </main>

package/extension/popup.js

@@ -2,6 +2,7 @@ const statusEl = document.querySelector("#status")
 const bridgeUrlEl = document.querySelector("#bridgeUrl")
 const bridgeTokenEl = document.querySelector("#bridgeToken")
 const platformMatchesEl = document.querySelector("#platformMatches")
+const advancedSettingsEl = document.querySelector("#advancedSettings")
 document.querySelector("#save").addEventListener("click", save)
 document.querySelector("#refresh").addEventListener("click", refresh)
 
@@ -17,7 +18,7 @@ async function refresh() {
   setStatus(
     state.activeSession
       ? `页面已连接\n${state.activeSession.title || state.activeSession.url}`
-      : "请打开任意 http/https 页面，并确认本地 bridge 已启动。"
+      : "默认无需设置。请打开或刷新任意 http/https 页面。"
   )
 }
 
@@ -35,12 +36,13 @@ async function save() {
     return
   }
   renderSettings(state.settings || {})
-  setStatus("设置已保存，请刷新目标页面完成重新注册。")
+  setStatus("设置已保存。请刷新目标页面完成重新注册。")
 }
 
 function renderSettings(settings) {
   bridgeUrlEl.value = settings.bridgeUrl || "http://127.0.0.1:48887"
   bridgeTokenEl.value = settings.bridgeToken || ""
+  advancedSettingsEl.open = Boolean(settings.bridgeToken)
   platformMatchesEl.value = Array.isArray(settings.platformMatches)
     ? settings.platformMatches.join("\n")
     : "*"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yunti-browser-runtime",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "Local browser runtime and MCP tools for AI agents.",
   "license": "MIT",