zen-gitsync 2.18.23 → 2.18.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-gitsync",
-  "version": "2.18.23",
+  "version": "2.18.24",
   "description": "Auto commit, scheduled sync, and visual GUI for Git. Run `g` in any repo for one-key commit & push, AI commit messages, scheduled background sync, and a drag-and-drop workflow builder.",
   "main": "index.js",
   "type": "module",
@@ -132,6 +132,8 @@
     "verify:instance-close-hover": "node scripts/verify-instance-close-hover.cjs",
     "verify:instance-close-hover:reverse": "node scripts/verify-instance-close-hover.cjs --reverse",
     "verify:schedule": "node scripts/verify-schedule.cjs",
+    "verify:web-search": "node scripts/verify-web-search.mjs",
+    "verify:web-search:reverse": "node scripts/verify-web-search.mjs --reverse",
     "e2e": "cd src/ui/client && npx playwright test",
     "e2e:headed": "cd src/ui/client && npx playwright test --headed",
     "e2e:install": "cd src/ui/client && npx playwright install chromium",
@@ -246,7 +248,8 @@
     "pdf-parse": "^2.4.5",
     "socket.io": "^4.8.1",
     "socket.io-client": "^4.8.1",
-    "string-width": "^7.2.0"
+    "string-width": "^7.2.0",
+    "undici": "^7.30.1"
   },
   "devDependencies": {
     "concurrently": "^10.0.3",

package/src/cli/ai/tools.js

@@ -44,6 +44,10 @@ import { checkImageFile, imageToDataUrl, formatBytes, isImagePath, SUPPORTED_IMA
 // 本工具只负责登记/管理，真正的到点执行由 g ui 服务端的调度器完成。
 import { createTask, loadTasks, deleteTask, updateTask } from '../../utils/scheduleStore.js'
 import { nextFireAfter } from '../../utils/scheduleCron.js'
+// 联网搜索 / 网页抓取：provider 抽象在 webSearch.js，配置（全局键 webSearch）走 configManager。
+// 两者都读 config.json 顶层 —— CLI `g ai` 与 Web 智能体共用同一份，无需按端注入 ctx。
+import configManager from '../../config.js'
+import { runWebSearch, runWebFetch } from './webSearch.js'
 
 // ──────────────────────────────────────────────
 // 常量
@@ -106,6 +110,8 @@ const BINARY_EXTS = new Set([
 // 用白名单而不是黑名单:漏加一个只读工具只是慢,错加一个写工具会改错文件。
 export const PARALLEL_SAFE_TOOLS = new Set([
   'read_file', 'read_image', 'list_files', 'search_text', 'list_projects',
+  // 只读的联网工具：彼此无先后依赖，可以和本地只读工具一起并发
+  'web_search', 'web_fetch',
 ])
 
 /**
@@ -465,6 +471,49 @@ export const TOOL_DEFINITIONS = [
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'web_search',
+      description: '联网搜索网页，返回每条结果的标题、URL 和摘要片段。'
+        + '需要看某个结果的**完整正文**时，再对它的 URL 调用 web_fetch —— 这一步由你自己判断要不要做，别一次性抓一大堆。'
+        + '适用于查最新资料、文档、版本号、公告等你不确定或可能已经过时的信息；纯本地文件/代码问题不要用它。',
+      parameters: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: '搜索关键词，像人在搜索引擎里输入的那样。' },
+          max_results: { type: 'number', description: '返回条数，默认 5，最大 10。' },
+          provider: {
+            type: 'string',
+            enum: ['firecrawl', 'tavily', 'exa'],
+            description: '临时指定搜索引擎，不传就用设置里的默认（见 设置 → AI 模型配置 → 联网搜索）。',
+          },
+        },
+        required: ['query'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'web_fetch',
+      description: '抓取一个网页的正文（转成 markdown）。用在 web_search 之后、需要深读某条结果时；也可直接抓用户给出的 URL。'
+        + '正文很长时会被截断，优先抓真正相关的那几页，不要滥抓。',
+      parameters: {
+        type: 'object',
+        properties: {
+          url: { type: 'string', description: '要抓取的网页地址（http / https）。' },
+          max_chars: { type: 'number', description: '正文最多返回多少字符，默认 20000，最大 50000。' },
+          provider: {
+            type: 'string',
+            enum: ['firecrawl', 'tavily', 'exa'],
+            description: '临时指定抓取用的 provider，不传就用设置里的默认。',
+          },
+        },
+        required: ['url'],
+      },
+    },
+  },
 ]
 
 // ──────────────────────────────────────────────
@@ -1397,6 +1446,68 @@ async function toolScheduleTask(args, ctx) {
   }
 }
 
+// 联网搜索 / 网页抓取。两个工具读同一份配置（config.json 的全局键 webSearch）：
+//   · web_search —— 回摘要（标题/URL/片段），模型据此判断要不要深读某条；
+//   · web_fetch  —— 抓某个 URL 的正文（markdown），供模型在 web_search 之后按需调用。
+// 配置读取走 configManager.loadConfig()（CLI 与 GUI 共享同一份 config.json）；
+// 用户在设置里关掉后工具仍会注册，但返回一句"已关闭"的说明 —— 让模型知道这不是故障，
+// 也避免它反复重试。读取失败（配置损坏）时不阻断：按默认配置继续尝试。
+async function loadWebSearchSettings() {
+  try {
+    const cfg = await configManager.loadConfig()
+    return cfg?.webSearch || null
+  } catch {
+    return null
+  }
+}
+
+function formatWebSearchResults(query, provider, results) {
+  if (!results.length) {
+    return `联网搜索「${query}」没有返回结果（provider: ${provider}）。换个说法或换关键词再试一次。`
+  }
+  const lines = results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.snippet || '（无摘要）'}`)
+  return `联网搜索「${query}」（provider: ${provider}，共 ${results.length} 条）：\n${lines.join('\n')}`
+    + '\n\n以上只是摘要；需要看某条的完整正文时，对它的 URL 调用 web_fetch。'
+}
+
+async function toolWebSearch(args) {
+  const query = String(args.query || '').trim()
+  if (!query) return '错误: web_search 需要非空的 query。'
+  const settings = await loadWebSearchSettings()
+  if (settings && settings.enabled === false) {
+    return '联网搜索已在设置里关闭（设置 → AI 模型配置 → 联网搜索）。请基于已知信息回答；'
+      + '如果确实需要联网，提醒用户先在那里开启。'
+  }
+  try {
+    const { provider, results } = await runWebSearch({
+      query,
+      maxResults: args.max_results,
+      provider: args.provider,
+      config: settings || undefined,
+    })
+    return formatWebSearchResults(query, provider, results)
+  } catch (err) {
+    return `错误: 联网搜索失败（${err?.message || String(err)}）。可稍后重试；`
+      + '若一直失败，检查设置里的 provider / API Key / 代理是否配置正确。'
+  }
+}
+
+async function toolWebFetch(args) {
+  const url = String(args.url || '').trim()
+  if (!/^https?:\/\//i.test(url)) return '错误: web_fetch 需要以 http:// 或 https:// 开头的 url。'
+  const settings = await loadWebSearchSettings()
+  if (settings && settings.enabled === false) {
+    return '联网搜索已在设置里关闭（设置 → AI 模型配置 → 联网搜索），无法抓取网页。'
+  }
+  try {
+    const out = await runWebFetch({ url, provider: args.provider, config: settings || undefined, maxChars: args.max_chars })
+    const head = `网页正文（provider: ${out.provider}）：${out.title}\n${out.url}\n\n`
+    return out.text ? head + out.text : head + '（没有取到正文 —— 可能是纯图片页、反爬拦截，或需要登录。）'
+  } catch (err) {
+    return `错误: 抓取网页失败（${err?.message || String(err)}）。可换一个来源，或稍后重试。`
+  }
+}
+
 // ──────────────────────────────────────────────
 // 工具分发
 // ──────────────────────────────────────────────
@@ -1415,6 +1526,8 @@ const TOOL_HANDLERS = {
   ask_user: toolAskUser,
   dispatch_task: toolDispatchTask,
   schedule_task: toolScheduleTask,
+  web_search: toolWebSearch,
+  web_fetch: toolWebFetch,
 }
 
 /**

package/src/cli/ai/webSearch.js

@@ -0,0 +1,260 @@
+// Copyright 2026 xz333221
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// g ai 的联网搜索 / 网页抓取 —— provider 抽象层。
+//
+// 设计约定：
+//   · web_search **只回摘要**（标题 / URL / 摘要片段），不抓正文 —— 让模型自己判断
+//     哪几条值得深读，再对那个 URL 调 web_fetch。token 花在"真的要看的那页"上。
+//   · provider 可切换（firecrawl / tavily / exa），配置来自 config.json 的全局键
+//     `webSearch`（形状与归一化见 src/config.js 的 normalizeWebSearch）。
+//   · 代理走 undici 的 ProxyAgent：Node 内置 fetch **不认** HTTPS_PROXY（除非进程
+//     启动时带 --use-env-proxy），所以配了代理就用 undici 自己的 fetch + ProxyAgent，
+//     两者同源、版本自洽。undici 是可选依赖：没配代理时零影响。
+//   · CA 补齐（enableSystemCAs）与远程 MCP 同一手法：Node 只认内置根证书，
+//     企业/自签代理环境下会 UNABLE_TO_VERIFY_LEAF_SIGNATURE。
+//
+// 与 tools.js 的边界：本文件只负责"发请求 + 把各家返回裁成统一形状"；
+// 工具 schema、结果格式化、给模型的错误话术都在 tools.js 的 handler 里。
+
+import { enableSystemCAs } from './systemCa.js'
+
+const DEFAULT_TIMEOUT_MS = 20000
+const DEFAULT_MAX_RESULTS = 5
+const MAX_RESULTS_LIMIT = 10
+const MAX_SNIPPET_CHARS = 500
+const DEFAULT_FETCH_CHARS = 20000
+const MAX_FETCH_CHARS = 50000
+
+// provider 白名单 —— 与 src/config.js 的 WEB_SEARCH_PROVIDERS 必须一致。
+export const WEB_SEARCH_PROVIDERS = ['firecrawl', 'tavily', 'exa']
+
+function str(v) {
+  return typeof v === 'string' ? v : (v === undefined || v === null ? '' : String(v))
+}
+
+function clip(text, max = MAX_SNIPPET_CHARS) {
+  const s = str(text).replace(/\s+/g, ' ').trim()
+  return s.length > max ? `${s.slice(0, max)}…` : s
+}
+
+function clampResults(n) {
+  const num = Number(n)
+  const base = Number.isFinite(num) && num > 0 ? Math.floor(num) : DEFAULT_MAX_RESULTS
+  return Math.max(1, Math.min(MAX_RESULTS_LIMIT, base))
+}
+
+// CA 补齐（幂等、只做一次）。Node < 24 或异常静默跳过，不影响主流程。
+let caReady = false
+function ensureCa() {
+  if (caReady) return
+  caReady = true
+  try { enableSystemCAs() } catch { /* 低版本 Node 没有该 API，忽略 */ }
+}
+
+// undici 是**可选**依赖：只在配了代理时才需要，动态 import（没装也不影响直连）。
+let undiciModule = null
+let undiciTried = false
+async function loadUndici() {
+  if (undiciTried) return undiciModule
+  undiciTried = true
+  try {
+    undiciModule = await import('undici')
+  } catch {
+    undiciModule = null
+  }
+  return undiciModule
+}
+
+/**
+ * 构造一个 http 函数：(url, init) => Promise<解析后的 JSON>。
+ * 直连走全局 fetch；配了代理则换用 undici 的 fetch + ProxyAgent（同源自洽）。
+ * 每次调用都新建 AbortController 超时，异常一律翻译成人话再抛。
+ */
+async function makeHttp(proxy) {
+  const proxyUrl = str(proxy).trim()
+  let fetchFn = fetch
+  let dispatcher
+  if (proxyUrl) {
+    const undici = await loadUndici()
+    if (!undici || typeof undici.fetch !== 'function' || typeof undici.ProxyAgent !== 'function') {
+      throw new Error(`已配置代理 ${proxyUrl}，但缺少 undici 依赖，无法走代理。请安装 undici，或清空设置里的代理地址改用直连。`)
+    }
+    fetchFn = undici.fetch
+    try {
+      dispatcher = new undici.ProxyAgent(proxyUrl)
+    } catch (err) {
+      throw new Error(`代理地址无法解析：${proxyUrl}（${err.message}）`)
+    }
+  }
+
+  return async function http(url, { method = 'GET', headers = {}, body, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+    ensureCa()
+    const controller = new AbortController()
+    const timer = setTimeout(() => controller.abort(), timeoutMs)
+    let resp
+    try {
+      resp = await fetchFn(url, {
+        method,
+        headers,
+        body: body === undefined ? undefined : JSON.stringify(body),
+        signal: controller.signal,
+        ...(dispatcher ? { dispatcher } : {}),
+      })
+    } catch (err) {
+      if (err?.name === 'AbortError') throw new Error(`请求超时（${timeoutMs / 1000}s）：${url}`)
+      throw new Error(`请求失败：${err.message}`)
+    } finally {
+      clearTimeout(timer)
+    }
+    const text = await resp.text()
+    if (!resp.ok) {
+      throw new Error(`HTTP ${resp.status}${text ? ` ${clip(text, 300)}` : ''}`)
+    }
+    try {
+      return JSON.parse(text)
+    } catch {
+      throw new Error(`返回不是合法 JSON：${clip(text, 200)}`)
+    }
+  }
+}
+
+function normalizeResults(list) {
+  const out = []
+  for (const it of Array.isArray(list) ? list : []) {
+    if (!it || typeof it !== 'object') continue
+    const url = str(it.url || it.link).trim()
+    if (!/^https?:\/\//i.test(url)) continue
+    out.push({
+      title: clip(str(it.title), 200) || url,
+      url,
+      snippet: clip(str(it.description ?? it.snippet ?? it.content ?? it.text ?? it.summary)),
+    })
+    if (out.length >= MAX_RESULTS_LIMIT) break
+  }
+  return out
+}
+
+// 各 provider 的 search / fetch 实现。http 是上面 makeHttp 造的函数。
+const PROVIDERS = {
+  firecrawl: {
+    // 无 key 也能用（按 IP 限流）；有 key 时带上 Bearer。
+    authHeaders: (apiKey) => (apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
+    async search({ query, maxResults, apiKey, http }) {
+      const data = await http('https://api.firecrawl.dev/v2/search', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...PROVIDERS.firecrawl.authHeaders(apiKey) },
+        body: { query, limit: maxResults },
+      })
+      const list = Array.isArray(data?.data) ? data.data
+        : Array.isArray(data?.data?.web) ? data.data.web
+          : Array.isArray(data?.web) ? data.web : []
+      return normalizeResults(list)
+    },
+    async fetch({ url, apiKey, http }) {
+      const data = await http('https://api.firecrawl.dev/v2/scrape', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...PROVIDERS.firecrawl.authHeaders(apiKey) },
+        body: { url, formats: ['markdown'] },
+      })
+      const md = data?.data?.markdown ?? data?.markdown ?? ''
+      return { title: clip(str(data?.data?.metadata?.title), 200), url, text: str(md) }
+    },
+  },
+  tavily: {
+    async search({ query, maxResults, apiKey, http }) {
+      if (!apiKey) throw new Error('未配置 Tavily API Key（设置 → AI 模型配置 → 联网搜索）')
+      const data = await http('https://api.tavily.com/search', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: { api_key: apiKey, query, max_results: maxResults, search_depth: 'basic' },
+      })
+      return normalizeResults(data?.results)
+    },
+    async fetch({ url, apiKey, http }) {
+      if (!apiKey) throw new Error('未配置 Tavily API Key（设置 → AI 模型配置 → 联网搜索）')
+      const data = await http('https://api.tavily.com/extract', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: { api_key: apiKey, urls: [url] },
+      })
+      const item = Array.isArray(data?.results) ? data.results[0] : null
+      return { title: clip(str(item?.title), 200), url, text: str(item?.raw_content) }
+    },
+  },
+  exa: {
+    async search({ query, maxResults, apiKey, http }) {
+      if (!apiKey) throw new Error('未配置 Exa API Key（设置 → AI 模型配置 → 联网搜索）')
+      const data = await http('https://api.exa.ai/search', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
+        body: { query, numResults: maxResults, contents: { text: { maxCharacters: MAX_SNIPPET_CHARS } } },
+      })
+      return normalizeResults(data?.results)
+    },
+    async fetch({ url, apiKey, http }) {
+      if (!apiKey) throw new Error('未配置 Exa API Key（设置 → AI 模型配置 → 联网搜索）')
+      const data = await http('https://api.exa.ai/contents', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
+        body: { urls: [url], text: true },
+      })
+      const item = Array.isArray(data?.results) ? data.results[0] : null
+      return { title: clip(str(item?.title), 200), url, text: str(item?.text) }
+    },
+  },
+}
+
+/**
+ * 选 provider：显式传入的（工具参数）优先，其次配置里的，最后兜底 firecrawl。
+ * 不在白名单里的值一律忽略 —— 免得模型瞎传一个不存在的名字把请求打到未知端点。
+ */
+function pickProvider(explicit, configProvider) {
+  const a = str(explicit).trim().toLowerCase()
+  if (WEB_SEARCH_PROVIDERS.includes(a)) return a
+  const b = str(configProvider).trim().toLowerCase()
+  if (WEB_SEARCH_PROVIDERS.includes(b)) return b
+  return 'firecrawl'
+}
+
+/**
+ * 执行一次联网搜索，返回 { provider, results }。
+ * @param {{ query: string, maxResults?: number, provider?: string,
+ *   config?: { provider?: string, apiKeys?: Record<string,string>, proxy?: string } }} opts
+ */
+export async function runWebSearch({ query, maxResults, provider, config } = {}) {
+  const cfg = config || {}
+  const chosen = pickProvider(provider, cfg.provider)
+  const apiKeys = (cfg.apiKeys && typeof cfg.apiKeys === 'object') ? cfg.apiKeys : {}
+  const http = await makeHttp(cfg.proxy)
+  const limit = clampResults(maxResults)
+  const results = await PROVIDERS[chosen].search({ query: str(query).trim(), maxResults: limit, apiKey: str(apiKeys[chosen]), http })
+  return { provider: chosen, results }
+}
+
+/**
+ * 抓取一个网页的正文（markdown）。返回 { provider, title, url, text }。
+ * 正文可能很长，进上下文前先按 maxChars 裁（默认 20,000 字符）。
+ */
+export async function runWebFetch({ url, provider, config, maxChars } = {}) {
+  const cfg = config || {}
+  const chosen = pickProvider(provider, cfg.provider)
+  const apiKeys = (cfg.apiKeys && typeof cfg.apiKeys === 'object') ? cfg.apiKeys : {}
+  const http = await makeHttp(cfg.proxy)
+  const out = await PROVIDERS[chosen].fetch({ url: str(url).trim(), apiKey: str(apiKeys[chosen]), http })
+  const limit = Math.max(1000, Math.min(MAX_FETCH_CHARS, Number(maxChars) || DEFAULT_FETCH_CHARS))
+  return { provider: chosen, title: out.title || str(url), url: out.url || str(url), text: str(out.text).slice(0, limit) }
+}
+
+export default { WEB_SEARCH_PROVIDERS, runWebSearch, runWebFetch }

package/src/config.js

@@ -239,6 +239,53 @@ export function normalizeAgentDefaultPrompt(value) {
   return value.slice(0, AGENT_DEFAULT_PROMPT_MAX);
 }
 
+// ──────────────────────────────────────────────
+// 联网搜索（web_search / web_fetch 工具，全局配置，跨项目共享）
+// ──────────────────────────────────────────────
+
+/**
+ * 联网搜索可选的 provider 白名单。**这里是权威**；前端
+ * `utils/webSearchProviders.ts` 里另有一份（只做展示 & 申请入口）。
+ *   · firecrawl —— 无 key 也能用（按 IP 限流），注册免费 key 后每月 1,000 credits
+ *   · tavily    —— 必须有 key（免费 1,000 credits/月）
+ *   · exa       —— 必须有 key（免费 $10 credits/月）
+ */
+export const WEB_SEARCH_PROVIDERS = ['firecrawl', 'tavily', 'exa'];
+const WEB_SEARCH_DEFAULT_PROVIDER = 'firecrawl';
+const WEB_SEARCH_API_KEY_MAX = 300;
+const WEB_SEARCH_PROXY_MAX = 300;
+
+/**
+ * 规范化「联网搜索」配置（全局配置，跨项目共享）。
+ *
+ * 形状：{ enabled, provider, apiKeys: {[provider]: key}, proxy }
+ *
+ * 语义约定：
+ *   · undefined / null → null（没配过，调用方回落 defaultConfig = 默认开启 + firecrawl）
+ *   · 非普通对象（含数组）→ null（手改坏了，整组回落默认，与 normalizeAgent* 同一口径）
+ *   · **单个字段坏只回落该字段**，不整组拒绝 —— 一个 key 写错不该把"开关/代理"也重置
+ *   · apiKeys 只保留白名单 provider 的键；非字符串值 → 该键置空串
+ *   · proxy 空串是合法值（= 直连），照写；非字符串 → 空串
+ */
+export function normalizeWebSearch(value) {
+  if (value === undefined || value === null) return null;
+  if (typeof value !== 'object' || Array.isArray(value)) return null;
+  const rawKeys = (value.apiKeys && typeof value.apiKeys === 'object' && !Array.isArray(value.apiKeys))
+    ? value.apiKeys : {};
+  const apiKeys = {};
+  for (const p of WEB_SEARCH_PROVIDERS) {
+    const v = rawKeys[p];
+    apiKeys[p] = typeof v === 'string' ? v.trim().slice(0, WEB_SEARCH_API_KEY_MAX) : '';
+  }
+  const providerRaw = typeof value.provider === 'string' ? value.provider.trim().toLowerCase() : '';
+  return {
+    enabled: typeof value.enabled === 'boolean' ? value.enabled : true,
+    provider: WEB_SEARCH_PROVIDERS.includes(providerRaw) ? providerRaw : WEB_SEARCH_DEFAULT_PROVIDER,
+    apiKeys,
+    proxy: typeof value.proxy === 'string' ? value.proxy.trim().slice(0, WEB_SEARCH_PROXY_MAX) : '',
+  };
+}
+
 /**
  * 三个提示通道（页面提示 / 浏览器通知 / 提示音）的最终取值。
  *
@@ -340,6 +387,17 @@ const defaultConfig = {
   // 见 workbench/chatPrompts.js）。空串 = 不注入。
   // 归一化见 normalizeAgentDefaultPrompt。
   agentDefaultPrompt: '',
+  // 联网搜索（web_search / web_fetch 工具）。全局配置，CLI `g ai` 与 Web 智能体共用。
+  // 默认开启：模型能联网查资料，默认走 firecrawl 的**无 key**接口（按 IP 限流）；
+  // 各 provider 的 key 留空即用各自的"免 key / 降级"形态（tavily / exa 没 key 会直接失败）。
+  // 代理留空 = 直连；填了就走 undici 的 ProxyAgent（如 http://127.0.0.1:7890）。
+  // 归一化见 normalizeWebSearch。
+  webSearch: {
+    enabled: true,
+    provider: 'firecrawl',
+    apiKeys: { firecrawl: '', tavily: '', exa: '' },
+    proxy: '',
+  },
   // 工作台任务执行器（claude | opencode | codex | codebuddy）。全局配置，跨项目共享。
   // 决定「执行任务 / 执行子任务 / 从此处开始 / 简单任务续聊」这条链路
   // 默认 spawn 哪个本地 CLI；执行入口可以按次覆盖（见 workbench 执行路由）。
@@ -692,6 +750,7 @@ async function loadConfig() {
         ?? defaultConfig.agentPresetPromptsByView,
       agentDefaultPrompt: normalizeAgentDefaultPrompt(raw.agentDefaultPrompt)
         ?? defaultConfig.agentDefaultPrompt,
+      webSearch: normalizeWebSearch(raw.webSearch) ?? defaultConfig.webSearch,
       ...resolveNotifySwitches(raw)
     };
   }
@@ -721,6 +780,8 @@ async function loadConfig() {
     // 同 agentPresetPrompts：全局配置，始终取顶层，防止被项目配置里的旧值覆盖
     agentDefaultPrompt: normalizeAgentDefaultPrompt(raw?.agentDefaultPrompt)
       ?? defaultConfig.agentDefaultPrompt,
+    // 同 agentDefaultPrompt：全局配置，始终取顶层，防止被项目配置里的旧值覆盖
+    webSearch: normalizeWebSearch(raw?.webSearch) ?? defaultConfig.webSearch,
     ...resolveNotifySwitches(raw)
   };
 }
@@ -774,7 +835,7 @@ async function saveConfig(config) {
   // 项目级是这一族键最容易踩的坑。解构出来本身不写回顶层（它已不再被任何地方读取）。
   const {
     theme, locale, models, ui, aiMaxToolIterations, aiMaxRequestTokens, taskExecutor,
-    agentPresetPrompts, agentPresetPromptsByView, agentDefaultPrompt,
+    agentPresetPrompts, agentPresetPromptsByView, agentDefaultPrompt, webSearch,
     notifyOnTaskDone: legacyNotifyOnTaskDone,
     notifyPageOnTaskDone, notifyBrowserOnTaskDone, notifySoundOnTaskDone,
     ...projectConfig
@@ -840,6 +901,12 @@ async function saveConfig(config) {
   if (normalizedAgentPrompt !== null) {
     raw.agentDefaultPrompt = normalizedAgentPrompt;
   }
+  // 联网搜索同属全局设置：结构坏(非普通对象)不落盘,保留磁盘旧值;
+  // 全默认 / 空 key 是**合法值**,照写 —— 与上面各键同一套语义。
+  const normalizedWebSearch = normalizeWebSearch(webSearch);
+  if (normalizedWebSearch !== null) {
+    raw.webSearch = normalizedWebSearch;
+  }
 
   // 写入当前项目配置（在 defaultConfig 基础上合并，但不清空顶层其它键）
   const existingProjectConfig = (raw.projects[key] && typeof raw.projects[key] === 'object') ? raw.projects[key] : {};
@@ -1052,6 +1119,9 @@ export default {
   normalizeAgentPresetPromptsByView,
   // g ai 智能体默认提示词的规范化(同上,见 /api/config/save-ai-settings)
   normalizeAgentDefaultPrompt,
+  // 联网搜索的规范化/白名单(同上,见 /api/config/save-ai-settings;CLI 工具层也要用)
+  normalizeWebSearch,
+  WEB_SEARCH_PROVIDERS,
 };
 
 // 命名导出 — 用于测试与外部复用