配置参考

{
  // --- 隧道（见 ../guides/tunnels-and-remote-access.md） ---
  "tunnel": {
    "provider": "none",              // none | ngrok | localtunnel | cloudflare
    "ngrok":      { "auth_token": "…", "domain": "…" },
    "cloudflare": { "tunnel_token": "…", "hostname": "…" }
  },
  "preview_base_url": null,          // 覆盖预览链接的公开 base URL

  // --- 工具链 ---
  "toolchain_mode": "system",        // system | managed

  // --- Workspace ---
  "default_workspace": "~/…",        // 新 Agent 会话的根目录
  "workspaces": ["~/dev/app-a"],     // 额外注册的项目目录

  // --- Agent ---
  "default_agent": "claude",
  "enabled_agents": ["claude", "codex"],  // 省略则启用所有已知 Agent
  "integrations": {
    "mcp_auto_install": true,        // 把 VibeAround MCP 配置写进 Agent 配置
    "skill_auto_install": true      // 把 VibeAround 技能写进 Agent 技能目录
  },

  // --- 网络 ---
  "proxy": { "enabled": true, "http_proxy": "http://…", "no_proxy": "…" },

  // --- Bridge 行为（见 ../architecture/local-api-and-bridge.md） ---
  "api_bridge": {
    "replace_provider_web_search": false
  },
  "local_agent_api": { "enabled": true },

  // --- 宿主侧网页搜索 ---
  "search_tool": {
    "enabled": false,
    "max_results": 5,
    "sources": {
      "tavily": { "enabled": true, "api_key": "…" },   // 还有：brave、exa、grok
      "brave":  { "enabled": false, "api_key_env": "BRAVE_KEY", "base_url": null }
    }
  },

  // --- 按渠道默认值（见 ../guides/connect-channels.md） ---
  "remote": {
    "channels": { "telegram": { "agent_id": "claude", "profile_id": "moonshot" } }
  },

  // --- 渠道插件配置：原样透传给插件 ---
  // 各渠道字段见 guides/channels/。每个渠道都接受可选的
  // verbose 对象（两个开关默认都是 false）。
  "channels": {
    "telegram": { "bot_token": "…", "verbose": { "show_thinking": true, "show_tool_use": true } },
    "feishu":   { "app_id": "…", "app_secret": "…" }
  },

  // --- Web 终端 ---
  "tmux": { "detach_others": true }
}

{
  "selected_agent": "claude",        // Launch 页当前显示的 Agent（UI 状态）
  "default_agent": "claude",         // VibeAround 全局默认：托盘快速启动、IM Thread 创建
  "default_profile_id": "moonshot",  // 该默认值的 Profile 快照
  "agents": {
    "codex": {
      "profile_id": "deepseek",      // 按 Agent 的默认 Profile
      "workspace": "~/dev/app",      // 按 Agent 的默认 Workspace
      "executable": {                 // 解析出的 CLI —— 由 va-launch 发现后写回
        "path": "/opt/homebrew/bin/codex",
        "version": "…", "source": "path-scan", "rank": 0
      },
      "launch_args": {
        "terminal": ["--flag-for-your-own-terminal"],  // 仅原生启动
        "acp": ["--flag-for-hosted-spawns"]            // 仅 IM/web 托管拉起
      }
    }
  }
}

{
  "schemaVersion": 1,
  "id": "openai-codex",              // 配置名
  "agent": "codex",                  // 注册表 Agent id
  "profileId": "openai",             // 仅元数据 —— va-launch 从不读供应商存储
  "launchTarget": "codex",
  "workspace": "/Users/example/project",
  "terminal": "terminal",            // 终端 id；按 OS 的列表见启动内幕
  "command": "codex",                // 命令行（按引号感知分词）
  "executablePath": null,            // 显式 CLI 覆盖（跳过 agents.json + PATH）
  "windowsExecutablePath": null,     // Windows 应用启动变体
  "windowLabel": "OpenAI Codex",
  "env": { "OPENAI_API_KEY": "…" },  // 由生成的启动脚本导出
  "args": { "native": ["--model", "gpt-5"] },
  "cleanupPaths": [],                // 命令退出后删除的临时文件
  "macosAppProbe": null,             // "已在运行"osascript 检查用的应用名
  "windowsProcessProbe": null
}

~/.vibearound/
├── settings.json           # 配置（本页）
├── auth.json               # 控制台 token，每次守护进程启动重写
├── agents.json             # 解析出的 Agent 可执行文件（va-launch 缓存）
├── plugins/<kind>/         # 已安装的渠道插件
├── launch/profiles/        # 保存的启动配置 JSON（schema v1）
├── workspaces/             # 新建 Workspace 的默认根
├── .cache/                 # 渠道附件缓存
└── workspace-threads.jsonl # + workspace/attachment 事件日志