browser-store

npm i -g @bysking/browser-store   # 全局安装
# 或
npx -y @bysking/browser-store     # 免安装直接使用

git clone https://github.com/bysking/browser-store.git
cd browser-store
pnpm install
pnpm build                       # 产出 dist/cli.cjs + dist/public
node dist/cli.cjs --version      # 验证

# 1. 探测本机已安装浏览器
bs discover

# 2. 新增实例
bs add work --engine chrome
bs add edge1 --engine edge --headless --urls https://example.com,https://github.com

# 3. 启动 / 停止 / 重启 / 重置
bs start work
bs stop work
bs restart work
bs reset work --yes          # 清空 profile 还原（自定义目录需 --force）

# 4. 即开即用：实例不存在自动创建，命令退出后浏览器保持运行
bs open work https://example.com

# 5. 查看状态 / 日志
bs ls
bs info work
bs logs work --follow

# 6. 启动常驻服务（API + 管理台 + HTTP MCP）
bs serve
# 浏览器打开 http://localhost:3210 进入管理台

# 7. 让 AI 操控浏览器（MCP）
bs mcp-register work          # 拿到 Claude Desktop 配置片段

$ bs --help

用法: bs [options] [command]

浏览器多开管理 CLI — 独立 profile / 独立 CDP 端口 / 每实例 MCP Server

选项:
  -v, --version              输出版本号
  -h, --help                 display help for command

命令:
  serve [options]            启动常驻服务（HTTP API + umijs 管理台 + 实例生命周期 + HTTP MCP）
  open [options] <name> [url] 即开即用：打开（必要时创建）实例并导航到 URL，命令退出后浏览器保持运行
  add [options] <name>       新增浏览器实例
  ls|list [options]          列出所有实例及状态
  start <name>               启动实例
  stop <name>                停止实例
  restart <name>             重启实例
  reset [options] <name>     重置实例：停止 + 清空 profile 还原（默认需确认）
  prune [options] [name]     清理实例的可再生缓存/指标目录（需先停止，不影响会话数据）
  rename <name> <newName>    重命名实例
  rm|remove [options] <name> 删除实例（需先停止）。默认保留 profile，--purge 连带删除
  mcp <name>                 为实例启动 stdio MCP server（供 Claude Desktop 等 AI 客户端接入）
  mcp-register <name>        打印/写入该实例的 Claude Desktop mcpServers 配置片段
  discover                   探测本机已安装浏览器
  doctor                     诊断：node 版本、浏览器、端口、CDP 可达性
  logs [options] <name>      查看实例日志
  info <name>                查看实例完整配置 + 状态 + CDP/MCP 地址

~/.browser-store/
├── instances.json   # 实例配置（用户可编辑）
├── state.json       # 运行时状态（daemon 独占写）
├── daemon.json      # daemon 发现信息（CLI 路由用）
├── profiles/<id>/   # 受管 profile 目录
└── logs/<id>.log    # 实例日志

browser-store/
├── bin/bs.ts           # CLI 入口（esbuild bundle）
├── src/
│   ├── cli.ts          # commander 命令定义
│   ├── commands.ts     # 命令实现
│   ├── serve.ts        # 常驻服务 + daemon.json + 孤儿收养
│   ├── config/         # instances.json / state.json / 路径
│   ├── engines/        # BrowserEngine 可插拔（chrome / edge）
│   ├── instance/       # 端口分配 / spawn / 状态机 / 进程管理
│   ├── cdp/session.ts  # chrome-remote-interface 封装
│   ├── mcp/            # MCP 工具 + stdio + Streamable HTTP
│   └── api/            # REST + SSE 事件流
├── web/                # umijs 管理台（构建产物嵌入 dist/public）
└── docs/

pnpm install
pnpm exec tsx bin/bs.ts --help     # dev 运行
pnpm typecheck                     # 类型检查
pnpm lint                          # 代码规范检查
pnpm build                         # esbuild bundle + web 构建 + 静态拷贝
node dist/cli.cjs --version        # 产物运行
pnpm test                          # 单元测试