HeadlessX

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Node.js 22+ 与 pnpm 10.32.1+（开发者模式，应用跑在宿主机上）
• Git
• Docker 与 Docker Compose v2（开发者模式与生产模式均必需）
• Python/uv（用于 yt-engine）
• Go（用于 HTML 转 Markdown sidecar，v2.1.2）

安装与启动步骤

1. 1检查运行依赖

   确认本机已装 Node.js 22+、Git、Docker + Compose v2，以及 yt-engine 需要的 Python/uv 和 sidecar 需要的 Go。PostgreSQL 和 Redis 无需单独安装。

2. 2启用 corepack

   若本机未使用 README 指定的 pnpm 版本，先启用 corepack 以便由 corepack 管理 pnpm。

   corepack enable

   复制

3. 3锁定 pnpm 版本

   把 pnpm 对齐到 README 指定的 10.32.1，避免版本不一致导致依赖安装失败。

   corepack use pnpm@10.32.1

   复制

4. 4用 Docker 启动平台

   README 明确开发和生产的运行都依赖 Docker + Compose v2，但未给出具体启动命令，请按官方 Setup Guide 的说明完成拉取与启动。

5. 5首次构建 Google Cookie

   打开 /playground/operators/google/ai-search，点击 Build Cookies，让共享浏览器打开 Google。

6. 6人工过一次验证

   在打开的共享浏览器里正常浏览，遇到 Google 或 reCAPTCHA 验证时手动完成一次；之后再次搜索会复用该共享 profile。

7. 7保存浏览器配置

   点击 Stop Browser 保存 profile，后续 Google 搜索会自动复用已保存的共享配置。

如何确认成功

Docker 容器正常运行、能打开 Dashboard，并成功访问 /playground/operators/google/ai-search 完成一次 Build Cookies 与 Stop Browser。

常见问题

注意事项

• Docker + Compose v2 是开发者和生产模式的必需依赖，不能省略。
• 当前可运行版本是 v2.1.2，README 中的 v2.5 内容属于开发计划，不要按 v2.5 的方案部署。
• PostgreSQL 与 Redis 由 Docker 提供，无需另行安装。
• README 未给出完整的仓库拉取与启动命令，完整安装步骤请参考官方 Setup Guide。