[Feature] Windows 支持 — bb-browser daemon + bb-viewer 编译与运行

[yan5xu]

背景

bb-browser 是 npm 包，理论上跨平台，但 Windows 上存在已知问题（#201 MCP 模式立即退出，#205 WSL2 连 Chrome，#217 端口冲突）。同时 bb-viewer（streamer）是 CGo 二进制，依赖 libvpx + libjpeg-turbo，没有 Windows 构建流程。

本 issue 统一跟踪让 bb-browser + bb-viewer 在 Windows 上完整可用。

目标

Windows 用户可以：

1. npm install -g bb-browser 安装 daemon
2. bb-browser daemon 正常启动，连接本地 Chrome
3. bb-viewer（stream）能编译运行，WebRTC 视频流正常
4. 通过 Pinix Hub 或 MCP 模式正常使用

bb-browser daemon（TypeScript）

已知问题

• [Bug] MCP mode exits immediately on Windows (Cursor shows Connection closed -32000) #201: MCP 模式在 Windows 上立即退出（Connection closed -32000）
• Feature request: Support connecting to Windows Chrome from WSL2 #205: WSL2 中的 bb-browser 连接 Windows 侧 Chrome
• daemon: default port 19824 conflicts with Windows IP Helper (iphlpsvc) #217: 默认端口 19824 与 Windows IP Helper 服务冲突

需要排查/修复

位置	问题
packages/daemon/src/hub-bridge.ts	findStreamerBinary() 查找 bb-viewer 缺 .exe 后缀
packages/daemon/src/hub-bridge.ts	~/.bb-browser/bin/bb-viewer 路径在 Windows 上的处理
端口选择	默认端口 19824 与 Windows iphlpsvc 冲突（#217），需要换默认端口或自动检测
Chrome 路径检测	确保能找到 Windows 上的 Chrome 安装路径
进程管理	子进程生命周期管理（spawn/kill）在 Windows 上的行为差异

bb-viewer / streamer（Go + CGo）

编译阻塞

bb-viewer 依赖两个 C 库：

库	用途	Windows 可用性
libvpx	VP8 视频编码	vcpkg 有（vcpkg install libvpx）
libjpeg-turbo	JPEG 解码	vcpkg 有（vcpkg install libjpeg-turbo）

当前构建命令是 macOS-specific（brew --prefix）：

CGO_CFLAGS="-I$(brew --prefix)/include -I$(brew --prefix libjpeg-turbo)/include" \
CGO_LDFLAGS="-L$(brew --prefix)/lib -L$(brew --prefix libjpeg-turbo)/lib" \
go build -o bb-viewer .

需要做的

1. Windows 构建文档：用 vcpkg 或 MSYS2 提供 libvpx + libjpeg-turbo
2. CGo 构建配置：encoder.go 和 decoder.go 的 #cgo 指令需要支持 Windows 路径
3. 预编译二进制分发：提供 bb-viewer-windows-amd64.exe（+ 对应 DLL）
4. Docker 替代方案：Windows 用户也可以用 Docker Desktop（WSL2 backend）运行现有 Linux 镜像

Pion WebRTC

纯 Go 实现，Windows 上无问题。

具体改动

Phase 1: bb-browser daemon

• 修复 [Bug] MCP mode exits immediately on Windows (Cursor shows Connection closed -32000) #201（MCP 模式退出）
• 修复 daemon: default port 19824 conflicts with Windows IP Helper (iphlpsvc) #217（端口冲突）
• findStreamerBinary() 加 .exe 后缀检测
• Chrome 路径检测支持 Windows 默认安装位置
• 文档：Windows 安装和使用说明

Phase 2: bb-viewer

• 提供 Windows 构建说明（vcpkg + Go）
• 调整 CGo 构建配置支持 Windows
• CI 加 Windows 构建 / 预编译二进制

验证

• Windows 上 npm install -g bb-browser 后 bb-browser --mcp 正常运行
• bb-browser daemon 能连接并控制 Windows Chrome
• bb-viewer 在 Windows 上编译成功
• WebRTC stream 功能端到端验证
• Pinix Hub 模式正常（pinix hub add bb-browser）

关联

• [Bug] MCP mode exits immediately on Windows (Cursor shows Connection closed -32000) #201 [Bug] MCP mode exits immediately on Windows
• Feature request: Support connecting to Windows Chrome from WSL2 #205 Support connecting to Windows Chrome from WSL2
• daemon: default port 19824 conflicts with Windows IP Helper (iphlpsvc) #217 daemon: default port 19824 conflicts with Windows IP Helper
• [Feature] Windows 支持 — pinixd + pinix CLI 编译与运行 pinix#132 — pinixd + pinix CLI 的 Windows 支持

[yan5xu]

Windows 实测结果

在 Windows Server 2022 上测试了 bb-browser 0.12.2。

环境

• Windows Server 2022 Datacenter (10.0.20348)
• Node.js v22.16.0
• Chrome 已安装

测试结果

测试项	结果	备注
npm install -g bb-browser	pass	从 npmmirror 安装，3s
bb-browser --version	pass	0.12.2
bb-browser daemon start	pass	CDP connected，检测到 Chrome
bb-browser daemon status	pass	在同一 session 内正常
bb-browser site list	pass	正常运行
daemon 在 SSH 断开后存活	fail	与 pinix 同样的问题：OpenSSH Job Object kill

关键问题

bb-browser daemon 在 SSH session 结束后被杀，原因与 pinix#132 相同：Win32-OpenSSH 的 Job Object 会在 session 关闭时终止所有子进程（PowerShell/Win32-OpenSSH#1032）。

pinix 的解决方案是用 schtasks 启动 daemon。bb-browser daemon 如果也需要独立于 SSH session 运行，需要类似的处理。

其他发现

• bb-browser site update 需要 git，Windows Server 不自带
• MCP 模式在 cmd.exe 的 stdin 管道下未正确接收 JSON-RPC（可能是 [Bug] MCP mode exits immediately on Windows (Cursor shows Connection closed -32000) #201 的原因）
• Chrome 路径检测正常工作