为什么必须走商店:实测 Chrome 149 在非企业托管的 Mac 上,会把"非 Web Store"的 force-install 扩展直接标成 `[BLOCKED]`。商店扩展不受此限。这也是 codex / claude 扩展都发商店的原因。

评审风险(务必知道): 本扩展用了 `debugger` 权限,这是 Chrome Web Store 审核最严的权限之一。理由必须写清楚"只在用户本机、用户主动发指令时驱动用户自己的标签页,无远程服务器"。类似工具(如 claude-in-chrome)能过审,但可能被多问一轮、审核时间偏长(几天到一两周)。

## 一、前置(你来做,一次性)

1. 用一个 Google 账号登录 `https://chrome.google.com/webstore/devconsole`
2. 首次需付 $5 一次性开发者注册费
3. (隐私政策需要一个公开 URL,见第四节 —— 我可以帮你开 GitHub Pages 托管 `privacy.html`)

## 二、上传(更新现有条目,纯改名)

你已经有一个上架条目(原名 agent-browser-stealth,Item ID `knfcmbamhjmaonkfnjhldjedeobeafmk`)。这次只是把它改名成 chrome-use,所以走 更新版本,不要 New item —— 这样老用户自动更新、评分/安装量都保留。

1. devconsole → 打开 现有的 agent-browser-stealth 条目(id `knfcmbamhjmaonkfnjhldjedeobeafmk`)→ Package → Upload new package。
2. 上传 key 已删 的包 `chrome-use-store-vX.Y.Z.zip`(必须删掉 manifest 的 `key` 字段,否则商店报"key 字段不符";仓库里 `ab-connect/manifest.json` 带 key 是给本地 Load-unpacked 用的,别直接传那个)。上传后 Item ID 保持 `knfcmbam…` 不变;用户看到的扩展名变成 chrome-use。
3. native messaging 的 `allowed_origins` 同时放行 `knfcmbam…` 和 `ciiljdl…` 两个 id,所以改名后 relay 照常连得上,不会断现有用户。
4. 不要在这次发布里改 `background.js` 的 native host 名(保持 `com.agent_browser.connect`);`com.leeguoo.chrome_use` 是给将来真迁移用的。

若你确实想另开一个全新的 "chrome-use" 条目(新 id、评分清零、用户需重装):那才用保留 key 的包,id 会锁成 `ciiljdlhdpfckdcfkphgmfalanpdejep`。仅在你想彻底脱离旧 stealth 品牌时才这么做 —— 默认按上面"更新现有条目"走。

## 三、商店信息(直接复制以下文案)

### 名称 / Name

    chrome-use

### 简介 / Summary（≤132 字符）

    Let your own chrome-use CLI drive your logged-in Chrome — a local automation bridge. No remote server, no token.

### 详细描述 / Description

    chrome-use is the in-browser half of the open-source chrome-use CLI. It lets the
    command-line tool you installed on this same computer automate the Chrome you're already logged
    into — opening pages, clicking, filling forms, reading the DOM — driven entirely by you.

    How it works
    - The extension talks ONLY to the local chrome-use CLI over Chrome native messaging (a local
      inter-process channel — no network socket, no token, no remote server).
    - When you run an automation command, the extension relays Chrome DevTools Protocol operations to
      the tab you target, then returns the result to the CLI.

    Privacy
    - No analytics, no trackers, no data collection.
    - Nothing is sent to any remote server. The only message peer is the local CLI.
    - Source is open (Apache-2.0): https://github.com/leeguooooo/chrome-use

    You need the chrome-use CLI installed and paired (run: chrome-use extension install) for this
    extension to do anything.

### 类别 / Category

    Developer Tools

### 语言 / Language

    English

## 四、隐私实践（Privacy practices 标签页 —— 必填）

### Single purpose（单一用途）

    Bridge the user's locally-installed chrome-use CLI to their own logged-in Chrome so the CLI can
    automate pages the user is working with, entirely on the user's machine and at the user's command.

### 各权限理由 / Permission justifications

权限 | 理由（复制到对应输入框）
--- | ---
debugger | Attaches the Chrome DevTools Protocol to the user's own active tab so the paired local chrome-use CLI can automate it (navigate, click, read DOM) only while the user is running a command. Commands arrive solely from the local CLI via native messaging; there is no remote endpoint.
tabs | Enumerate and target the correct open tab to attach automation to.
tabGroups | Organizes the tabs the local chrome-use CLI drives into a labeled, colored Chrome tab group per automation session, so the user can see at a glance which tabs are under automation and they stay visually separated from the user's own tabs.
nativeMessaging | The sole communication channel: a local native-messaging connection to the chrome-use CLI installed on the same machine. No network is used.
storage | Persist small local pairing/configuration state for the extension.
alarms | Keep the MV3 service worker alive during longer automation sessions.
webNavigation | Detect page loads/navigations so automation can wait for the right moment before acting.
host permissions（若被问） | The extension declares none; tab access is mediated through the debugger attach the user initiates.

### 数据用途勾选 / Data usage

- 不勾选任何"collects user data"类别。
- 三个合规声明全部勾选可以为真:不卖数据 / 不挪作无关用途 / 不用于判断信用资质。
- Privacy policy URL:填 `privacy.html` 的公开地址(见下)。

## 五、隐私政策 URL

商店要求一个公开可访问的隐私政策地址。GitHub Pages 已开启,直接填这个(渲染好看):

    https://leeguooooo.github.io/chrome-use/extensions/store/privacy.html

(部署需 1–2 分钟生效。raw 备用直链:`https://raw.githubusercontent.com/leeguooooo/chrome-use/main/extensions/store/privacy.html`。)

## 六、图标 + 截图 / Icon & Screenshots

已生成,涂鸦风(和 cookie-use README 同一套)。上传到对应字段即可:

- Store icon(128×128):`chrome-use-store-icon-128.png`
- Screenshots(每张正好 1280×800):`chrome-use-store-shot1-1280x800.png`(CMD 牵线操控已登录浏览器)、`shot2`(机械臂抓浏览器方向盘)、`shot3`(浏览器插线连终端 CONNECTED)。

## 七、提交后

1. 提交审核 → 等几天。审核通过且状态变 Published 后告诉我。
2. 我会把 `extension install` 的 force-install `update_url` 切到商店地址并发布新 fork;之后用户 `extension install` → 批准一次描述文件 → 静默装好(商店扩展不再 `[BLOCKED]`);或者用户在商店页一键 Add to Chrome。

今天的临时可用方案: 在你这台 Mac 上 `chrome://extensions` → 打开开发者模式 → Load unpacked → 选 `extensions/ab-connect`,30 秒手动装一次,native messaging + `extension connect` 立即可用。等商店过审再切静默路径。