# GrokBoy 環境變數範本
#
# 用法：
#   cp .env.example .env
#   填 GROKBOY_API_KEY 後 `make start`（會載入整個檔）
#
# 也可放在 ~/.grokboy/.env 或 ~/.grokboy/env。
# 已在 shell 裡 export 的值優先，檔案不會覆蓋。
# 以 # 開頭的行是註解。不要把填好金鑰的 .env 提交進 git。

# =============================================================================
# 必填：模型
# =============================================================================

# xAI / OpenAI 相容 API 金鑰。也可改用 XAI_API_KEY 或 OPENAI_API_KEY。
# 沒設的話會試 ~/.grok/auth.json（Grok CLI 登入）。
GROKBOY_API_KEY=

# 模型 HTTP 根網址。官方 xAI 預設如下；自架代理改這裡。
# 也可改用 OPENAI_BASE_URL。
# GROKBOY_BASE_URL=https://api.x.ai/v1

# 聊天與工具用的模型 id。
# GROKBOY_MODEL=grok-4.6

# =============================================================================
# 網頁 UI / API（make start → grokboy serve）
# =============================================================================

# HTTP 綁定位址。0.0.0.0 才能用同一 Wi-Fi 的手機開。
# GROKBOY_WEB_HOST=0.0.0.0

# JSON API + 若有 web/dist 時的 UI 埠。Vite 開發前端仍是 5173，會把 /api 代理到這裡。
# GROKBOY_WEB_PORT=8787

# 選填。設了之後瀏覽器要帶 Authorization: Bearer <token> 或 x-grokboy-token。
# GROKBOY_WEB_TOKEN=

# 正式 UI：先 `cd web && npm run build`，再指到編譯結果。開發用 Vite 時不必設。
# GROKBOY_WEB_DIST=web/dist

# =============================================================================
# 公開搜尋 / 抓頁
# =============================================================================

# web_search：官方 xAI 會直接用上面的 API key 打 /responses + web_search。
# 若 BASE_URL 不是 api.x.ai，又要走 xAI 原生搜尋，設：
# GROKBOY_WEB_PROVIDER=xai

# 改走 Cursor 風格 AiService gateway（只要 RunWebSearch，web_fetch 仍是本機 GET）。
# GROKBOY_WEB_BACKEND_URL=https://your-gateway.example
# 該 gateway 若要驗證，與網頁 token 共用這個名字：
# GROKBOY_WEB_TOKEN=

# web_fetch 預設：網站擋匿名 GET 或只剩 JS 殼時立刻回 blocked_plain_http（快）。
# 設成 xai 會改走模型遠端瀏覽，一頁大約 12 秒以上、會計費。
# GROKBOY_WEB_FETCH_FALLBACK=xai

# =============================================================================
# 資料目錄
# =============================================================================

# 多 agent 守護行程：SQLite、socket、記憶。預設 ~/.grokboy/team
# GROKBOY_DATA_DIR=

# 舊版單次 session JSON。預設 ~/.grokboy/sessions
# GROKBOY_SESSIONS_DIR=

# MCP 設定檔。預設 ~/.grokboy/mcp.json，工作區還可加 .grokboy/mcp.json
# GROKBOY_MCP_CONFIG=

# Docker 電腦映像的 build 目錄。預設用編譯時的 crate 路徑推 box/
# GROKBOY_BOX_DIR=

# =============================================================================
# 模型預算（愈小愈快停，愈不容易「查十分鐘」）
# =============================================================================

# 一個使用者回合最多幾次模型請求。預設 5000。背景任務樹也吃這個上限。
# GROKBOY_MAX_ROUNDS_TOTAL=48

# 只影響 stderr 進度頻率，不額外打模型。預設 12。
# GROKBOY_MAX_ROUNDS=12

# 對話大約能留多少 UTF-8 bytes。超了會壓縮。預設 100000。
# GROKBOY_CONTEXT_CHARS=100000

# spawn_subagent 子代理自己的回合上限。預設 128。
# GROKBOY_SUBAGENT_MAX_ROUNDS=128

# =============================================================================
# 瀏覽器 / 我的電腦
# =============================================================================

# 預設 Docker 裡的 Chromium（跟 noVNC 桌面同一份 profile）。
# local = 舊的本機 Playwright，不跟 Docker 共用登入。
# GROKBOY_BROWSER_SURFACE=local

# 只對 local 模式有意義：1 = 跳出看得見的 Chromium，方便手登入。
# GROKBOY_BROWSER_HEADED=1

# =============================================================================
# 除錯（一般不要開）
# =============================================================================

# 1 = stderr 印各階段毫秒（模型排隊、工具、整回合）。不含 prompt 或金鑰。
# GROKBOY_TIMING=1

# 0 = 不要在 stderr 刷「思考中／工具」。問你的問題仍會顯示。
# GROKBOY_PROGRESS=0

# 測試專用。1 = 自動同意確認；abort = 自動拒絕。
# GROKBOY_CONFIRM_AUTO=1

# 測試專用。1 = 自動結束手操瀏覽器等待；abort = 當成放棄。
# GROKBOY_HANDOFF_AUTO=1