Chrome Host
基于 Tauri + Rust 的 Chrome 浏览器多环境管理工具：为每个环境启动完全隔离的 Chrome 实例（独立 Profile、进程级 hosts 映射、CDP 可自动化），并支持登录态自动保存（实例即登录源）——在任一实例里登录一次，之后每个新实例免登录（含 session cookie）。
📖 在线文档：https://augustVino.github.io/chrome-host/
核心能力
- 环境与实例：环境 = 一份配置（可选 hosts 配置源 + keepAlive）；实例 = 该环境的一次隔离运行（独立 user-data-dir + CDP 端口）
- 页面操控（page 命令族）：内置
chrome-host page 命令族——snap @eN 引用、原生输入点击（含遮挡拦截）、表单填写、按键、元素等待、弹窗自动接管、任意 CDP 透传；本地/远程同用，无需脚本或端口凭证
- 登录态自动保存（实例即登录源）：在实例里登录 → 关闭实例 → 登录态（文件快照 + 含 session cookie 的保险库）自动保存为环境身份；之后创建的实例自动注入。环境可配回写策略（first-login 默认 / always / off），保险库保留最近 5 代可回滚
- hosts 注入：实例启动时从 hosts 配置源现拉最新配置，经
--host-resolver-rules 进程级注入，不改系统 hosts
- 多入口共享服务层：GUI / Agent API（REST）/ MCP / CLI 四个入口，同一套业务契约，专为 AI Agent 与自动化设计
- keepAlive：环境级开关；实例异常退出自动重启，60s 窗口内连续崩溃 3 次自动熔断
快速开始
pnpm install
pnpm tauri dev
首次启动自动下载 Chrome for Testing 131（pinned，双镜像）；内核状态见 Settings 页。
命令行工具（CLI）
CLI 内置于桌面应用（v0.1.7 起），不随安装自动可用，需在应用内开启一次：
- 打开 chrome-host → 设置 → 命令行工具 → 安装
- 应用在
/usr/local/bin 创建指向应用内 CLI 的 chrome-host 链接（需要管理员授权）
使用前提：chrome-host 桌面应用需处于运行状态（含托盘常驻）——CLI 是 Agent API 的薄客户端，应用未运行时所有命令返回 exit 8。AI Agent / CI 接入请先跑 chrome-host status 探活。
开发者从源码安装：cargo install --path crates/cli
📖 完整接入指南（命令参考 / Exit Code 契约 / AI Agent 与 CI 接入范式 / 故障排查）：CLI.md
远程接入（云桌面 / CI）
设置页「远程接入」一键开启：应用自动守护 SSH 隧道（仅转发 17890）+ Bearer 令牌鉴权 +
CDP 会话代理（实例端口零暴露）。远程机器 export CHROME_HOST_TOKEN=… 后 CLI / MCP /
CDP 全部可用，详见 AGENT-API.md 的「远程接入」章节。
AI 接入（Agent API / MCP）
REST 与 MCP 均只绑定 127.0.0.1:17890，随应用启动：
- Agent API：
http://127.0.0.1:17890/api/v1 → 📖 AGENT-API.md（全部端点请求/响应形状 / 错误码总表）
- MCP：
http://127.0.0.1:17890/mcp → 📖 MCP.md（工具清单 / 各客户端配置），Claude Code 一行接入：
claude mcp add --transport http chrome-host http://127.0.0.1:17890/mcp
已知边界（FAQ）
- 单 session 互踢：内部系统若为单 session 策略，多个实例共用同一登录态可能互相踢下线
- CfT 蓝条："仅适用于自动测试"提示为 Chrome for Testing 构建硬编码，无官方开关
- 旧数据迁移：
node scripts/migrate-legacy.js <旧 chrome-host.db>（按 name 幂等；hosts 映射 JSON 不迁移，实例启动时现拉）
开发
pnpm tauri dev # 开发（beforeDevCommand 自动构建 CLI sidecar 到 src-tauri/binaries/）
cd src-tauri && cargo test # Rust 单测
bash scripts/smoke.sh # 冒烟（需应用运行中；可选 HOSTS_SOURCE=<hosts 源 URL> 验证 hosts 注入）
License
MIT
