{
  "mcpServers": {
    "bulu-browser": {
      "command": "npx",
      "args": ["-y", "bulu-browser-mcp"]
    }
  }
}

bulu-browser/
├── install.ps1              一键安装（复制程序 + 注册 MCP + 自检）
├── uninstall.ps1            卸载（可选保留浏览器数据）
├── create-shortcut.ps1      在桌面创建「WorkBuddy 浏览器」快捷方式
├── package.json
├── src/                     ── 核心程序，4 个文件共 42KB
│   ├── index.mjs              MCP server（stdio JSON-RPC，15 个工具）
│   ├── driver.mjs             浏览器驾驶层（会话、标签、动作、网络）
│   ├── snapshot.mjs           页面快照与 ref 机制
│   └── chrome.mjs             Chrome 启动、CDP 探测、锁清理、端口复用
├── skill/SKILL.md           技能说明（教模型什么时候用、怎么用）
├── connector-plugin/        ── 带图标的连接器插件包（见「启用步骤 · 方式 A」）
│   ├── install.mjs             注册到本地连接器市场 / --uninstall 回滚
│   └── connectors/bulu-browser/ai.workbuddy/assets/icon.png   ← 连接器图标
├── assets/
│   ├── icons/
│   │   ├── bulu-browser.ico      多尺寸图标（16~256 共 7 档，54KB）
│   │   └── icon-16…512.png       各尺寸 PNG
│   ├── bulu-browser-icon-1024.png   主图标（白底圆角）
│   ├── bulu-browser-transparent-1024.png  透明底版
│   ├── showcase.png          图标效果总览
│   ├── bulu-mascot-upper.png 布噜半身素材（图标用）
│   ├── icon-preview.html     图标源文件（改设计从这里改）
│   └── showcase.html
├── node_modules/playwright-core/   唯一运行时依赖（12MB）
└── dev/                      开发辅助脚本（生成图标、跑测试）

%LOCALAPPDATA%\bulu-browser\
├── app\                    ← 程序本体（12MB，含 playwright-core）
│   ├── src\index.mjs       ← MCP server
│   ├── src\driver.mjs      ← 浏览器驾驶层
│   ├── src\snapshot.mjs    ← 页面快照 + ref 机制
│   └── src\chrome.mjs      ← Chrome 启动与 CDP 探测
└── profile\                ← 浏览器数据（登录态存在这里）

%USERPROFILE%\.workbuddy\
├── skills\bulu-browser\SKILL.md   ← 技能说明（教模型怎么用）
├── mcp.json                        ← 方式 B：裸 MCP 注册
└── plugins\marketplaces\bulu-local\  ← 方式 A：带图标的连接器插件包（本机当前用这个）

connector-plugin/
├── .codebuddy-plugin/marketplace.json       本地市场索引
├── connectors/bulu-browser/
│   ├── .codebuddy-plugin/plugin.json        中文名「布噜浏览器」+ 示例指令
│   ├── mcp.json                             stdio 服务定义
│   ├── ai.workbuddy/assets/icon.png         512×512 ← 图标在这里
│   └── skills/bulu-browser/SKILL.md
└── install.mjs                              注册 / 回滚

node "D:\network shared\bulu-browser\connector-plugin\install.mjs"               # 注册
node "D:\network shared\bulu-browser\connector-plugin\install.mjs" --uninstall  # 回滚

WorkBuddy ──stdio JSON-RPC──> index.mjs
                                │
                                ├─ 启动真实 Chrome：--remote-debugging-port + 独立 --user-data-dir
                                ├─ playwright-core connectOverCDP 接管
                                └─ 给可交互元素打 data-bulu-ref 标记

模型看到：页面文本 + refs 列表（ref / tag / label / placeholder / value / checked）
模型操作：browser_act { ref: "5:12", interaction: "type", text: "..." }

# 打开浏览器（可选带网址）
node "$env:LOCALAPPDATA\bulu-browser\app\src\index.mjs" --open https://www.bing.com

# 查看它是否正在运行
node "$env:LOCALAPPDATA\bulu-browser\app\src\index.mjs" --status

powershell -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\bulu-browser\app\create-shortcut.ps1"

# 自检：启动一次浏览器并访问 example.com
node "$env:LOCALAPPDATA\bulu-browser\app\src\index.mjs" --check

# 指定浏览器
$env:BULU_CHROME_PATH = "D:\Chrome\chrome.exe"

# 指定 profile 目录
$env:BULU_PROFILE_DIR = "D:\my-profile"

node dev/render-final.mjs      # 输出两张 1024 主图
node dev/export-icons.mjs      # 输出全套 PNG + 打包 ico
powershell -ExecutionPolicy Bypass -File .\install.ps1         # 同步到 AppData
powershell -ExecutionPolicy Bypass -File .\create-shortcut.ps1 # 刷新快捷方式图标

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1