GDD (Giggly-Dazzling-Duckling)

# Run (headless, port 9700)
docker run -p 9700:9700 ghcr.io/cap-of-tea/gdd

# Or build locally
docker build -t gdd .
docker run -p 9700:9700 gdd

Docker 镜像以无头模式运行，并已预装所有 Chromium 依赖项。

全局配置和项目配置会合并，两者中的服务都可同时使用。只有重启 AI 客户端会话后，配置更改才会生效。

基于 VS Code 的 IDE 使用的配置格式与 Claude Code / Cursor 不同。

项目配置 — .vscode/mcp.json：

{
  "servers": {
    "gdd": {
      "type": "http",
      "url": "http://localhost:9700/mcp"
    }
  }
}

全局配置 — 通过 Cmd+Shift+P → “Open User Settings (JSON)”打开：

{
  "mcp": {
    "servers": {
      "gdd": {
        "type": "http",
        "url": "http://localhost:9700/mcp"
      }
    }
  }
}

全局 settings.json 的位置：macOS — ~/Library/Application Support/<IDE>/User/settings.json，Linux — ~/.config/<IDE>/User/settings.json，Windows — %APPDATA%/<IDE>/User/settings.json。将 <IDE> 替换为你的编辑器名称（Code、Windsurf、Antigravity 等）。

stdio-proxy 替代方案（.vscode/mcp.json）：

{
  "servers": {
    "gdd": {
      "type": "stdio",
      "command": "bash",
      "args": ["/absolute/path/to/Scripts/mcp-proxy.sh"]
    }
  }
}

默认情况下，Claude Code 每次调用 MCP 工具时都会请求确认。如需允许 GDD 工具运行而不弹出提示，请添加到 ~/.claude/settings.json：

{
  "permissions": {
    "allow": [
      "mcp__gdd__*"
    ]
  }
}

这个通配符即可涵盖全部 39 个 GDD 工具。编辑后重启 Claude Code。

当 AI 客户端连接时，代理脚本会自动启动 GDD：

Windows：

{
  "mcpServers": {
    "gdd": {
      "command": "powershell",
      "args": ["-ExecutionPolicy", "Bypass", "-File", "C:/path/to/Scripts/mcp-proxy.ps1"]
    }
  }
}

Linux / macOS：

{
  "mcpServers": {
    "gdd": {
      "command": "bash",
      "args": ["/path/to/Scripts/mcp-proxy.sh"]
    }
  }
}

在 args 数组中添加 "--headless"，以用于 CI/CD。

**提示：**首次启动时，GDD 会下载 Chromium（约 80 MB）。如果 AI 客户端超时，请先手动运行 GDD，然后重新连接。

macOS（launchd）：

bash Scripts/install-launchd.sh            # headed (default)
bash Scripts/install-launchd.sh --headless  # for CI/CD

管理：launchctl list | grep gdd / bash Scripts/install-launchd.sh --uninstall

Linux（systemd）：

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/gdd.service << 'EOF'
[Unit]
Description=GDD Multi-Browser Testing Server
[Service]
ExecStart=/path/to/GDD.Headless
WorkingDirectory=/path/to/gdd-directory
Restart=on-failure
[Install]
WantedBy=default.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now gdd

curl -X POST http://localhost:9700/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gdd_add_players","arguments":{"count":1}}}'

GDD 使用标准 JSON-RPC 2.0，可与 curl、Python、Node.js 或任何 HTTP 客户端配合使用。

手机（11）

平板（6）

桌面设备（5）

BrowserXn.sln
├── src/
│   ├── GDD.Core/              ← Shared library (net8.0)
│   │   ├── Abstractions/      ← IBrowserEngine, IPlayerManager, ...
│   │   ├── Mcp/               ← MCP server, tools, protocol
│   │   ├── Models/            ← Device, Location, Network presets
│   │   ├── Services/          ← CDP, Emulation, Monitoring services
│   │   └── Collections/       ← RingBuffer
│   ├── BrowserXn/             ← Windows GUI (WPF + WebView2)
│   │   ├── Engines/           ← WebView2ControlAdapter
│   │   ├── ViewModels/        ← MVVM (MainViewModel : IPlayerManager)
│   │   ├── Views/             ← XAML + VideoWallPanel
│   │   └── ...
│   ├── GDD.Desktop/           ← Linux/macOS GUI (Avalonia + Playwright)
│   │   ├── Engines/           ← PlaywrightHeadedEngine (headed, parked off-screen)
│   │   ├── ViewModels/        ← MainViewModel (DesktopPlayerManager)
│   │   ├── Views/             ← AXAML + VideoWallPanel
│   │   └── Scripts/           ← mcp-proxy.sh, setup-macos.sh, install-deps.sh
│   └── GDD.Headless/          ← Cross-platform server (Playwright)
│       ├── Engines/           ← PlaywrightEngine
│       ├── Platform/          ← HeadlessPlayerManager
│       └── Scripts/           ← mcp-proxy.sh, mcp-proxy.ps1
└── .github/workflows/         ← CI/CD (8 build targets + auto-release)

可执行文件旁的 appsettings.json：

{
  "GDD": {
    "FrontendUrl": "about:blank",
    "BackendUrl": "http://localhost:8080/api/v1",
    "BotToken": "",
    "McpPort": 9700,
    "DataFolderRoot": "",
    "Stealth": false
  }
}

命令行标志

环境变量

适用于 Docker 和 CI，在这些场景中使用 appsettings.json 文件不太方便：

需要 .NET 8 SDK。

# Windows GUI (requires Windows 10/11 + WebView2)
dotnet publish src/BrowserXn/BrowserXn.csproj -c Release -p:PublishSingleFile=true -o ./publish/win-gui

# Cross-platform headless
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r linux-x64 --self-contained -o ./publish/linux-x64
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r osx-arm64 --self-contained -o ./publish/osx-arm64
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r win-x64 --self-contained -o ./publish/win-x64

Chromium 会在首次运行时自动安装。

GDD 完全在您的本地计算机上运行。不进行遥测、分析或数据收集。

• 数据不会离开您的计算机 — 所有浏览器配置文件、屏幕截图、日志和 Cookie 均保存在本地存储中
• 浏览器配置文件 — 存储在 %LOCALAPPDATA%\GDD\Profiles（Windows）或 ~/.local/share/GDD/Profiles（Linux/macOS）
• 无第三方服务 — 除了用于可选更新检查的 GitHub Releases，GDD 不会联系任何外部 API
• 更新检查 — gdd_check_update 会向 api.github.com 发送一次只读请求。您可以不调用该工具以选择退出，或在 appsettings.json 中设置 CheckForUpdates: false
• MCP 服务 — 仅监听 localhost（默认端口为 9700），绝不会暴露到网络

联系方式：[email protected]