Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠
JavaScript ai-agentai-agentsai-toolsbrowser-aibrowser-automationbrowser-extensionchrome-aichrome-devtoolschrome-extensionchrome-extensionsfirefox-addonfirefox-addonsfirefox-extensionfirefox-extensionsgemmagemma4minimaxoffline-aioffline-llmqwen
Settings search: no current tab while results span tabs
Emre Sokullu35629ea409db
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 31bc94f6c..903b90064 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,9 @@ This changelog was generated from the repository Git history and release tags. V## [Unreleased]+### Fixed+- Settings search no longer looks as if its results belong to the tab you searched from. Searching "budget" on the CAPTCHA tab showed the Budgets settings while CAPTCHA was still highlighted. While a search shows its results, which can come from General, Budgets, CAPTCHA and Advanced, no tab is highlighted now, and the tab name above each group of results opens that tab.+## [42.2.0] - 2026-10-20### Addeddiff --git a/src/chrome/src/ui/settings-tabs.js b/src/chrome/src/ui/settings-tabs.jsindex e8cdf9ec5..db7a26318 100644--- a/src/chrome/src/ui/settings-tabs.js+++ b/src/chrome/src/ui/settings-tabs.js@@ -66,6 +66,18 @@});});+ // During a search each tab's matches sit under its name, and the name opens+ // that tab. Focus moves to its tab button, as if it had been picked.+ document.querySelectorAll('[data-search-tab]').forEach((link) => {+ link.addEventListener('click', () => {+ const tab = Array.from(buttons).find((b) => b.dataset.tab === link.dataset.searchTab);+ if (!tab) return;+ tab.click();+ tab.focus();+ window.scrollTo({ top: 0 });+ });+ });+// Restore the last-viewed tab so the page doesn't snap back to the default// every reload — makes iterating on a single section less annoying.let initial = DEFAULT_TAB;diff --git a/src/chrome/src/ui/settings.css b/src/chrome/src/ui/settings.cssindex 1b975564e..f23ceba1e 100644--- a/src/chrome/src/ui/settings.css+++ b/src/chrome/src/ui/settings.css@@ -1504,12 +1504,32 @@ button:active { transform: scale(0.97); }.captcha-advanced input { max-width: 140px; }/* Settings search spans General, Budgets, Captcha and Advanced. While a query- is active those tabs show their matches together, each under its tab name;- clearing the query returns to the tab you were on. */+ is active those tabs show their matches together, each under its tab name,+ and no tab is marked as the current one. A tab name opens that tab; picking+ a tab or clearing the query ends the search. */.search-panel-heading { display: none; }body.settings-searching .tab-panel[data-search] { display: block; }body.settings-searching .tab-panel:not([data-search]) { display: none; }body.settings-searching .tab-panel .search-panel-heading { display: block; margin: 22px 0 10px; }+body.settings-searching .tab-btn.active { background: transparent; color: var(--text2); }+body.settings-searching .tab-btn.active:hover { color: var(--text); }+.search-panel-link {+ background: none;+ border: 0;+ border-radius: 4px;+ padding: 0;+ font: inherit;+ color: inherit;+ letter-spacing: inherit;+ text-transform: inherit;+ cursor: pointer;+}+.search-panel-link::after { content: ' ›'; }+[dir="rtl"] .search-panel-link::after { content: ' ‹'; }+.search-panel-link:hover,+.search-panel-link:focus-visible { color: var(--accent); }+.search-panel-link:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }+.search-panel-link:active { transform: none; }.settings-group { margin-bottom: 10px; }.settings-group > .setting-row:last-child { margin-bottom: 0; }.settings-group > .info-box { margin: 0 0 10px; }diff --git a/src/chrome/src/ui/settings.html b/src/chrome/src/ui/settings.htmlindex 63d655676..73789b2d9 100644--- a/src/chrome/src/ui/settings.html+++ b/src/chrome/src/ui/settings.html@@ -51,7 +51,7 @@<div class="general-search-empty" id="general-search-empty" hidden data-i18n="st.display.search.empty"></div><section class="tab-panel active" data-panel="display" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.display"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="display" data-i18n="st.tab.display"></button></h2><div id="display-settings" data-search-scope><div class="setting-row"><div class="setting-info">@@ -168,7 +168,7 @@</section><section class="tab-panel" data-panel="budgets" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.budgets"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="budgets" data-i18n="st.tab.budgets"></button></h2><div id="budget-settings" data-search-scope><div class="setting-row"><div class="setting-info">@@ -481,7 +481,7 @@</section><section class="tab-panel" data-panel="captcha" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.captcha"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="captcha" data-i18n="st.tab.captcha"></button></h2><div id="captcha-settings" data-search-scope><div class="provider-card" id="captcha-card" aria-labelledby="captcha-heading"><h3 id="captcha-heading" data-i18n="st.captcha.heading"></h3>@@ -734,7 +734,7 @@</section><section class="tab-panel" data-panel="advanced" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.advanced"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="advanced" data-i18n="st.tab.advanced"></button></h2><div id="advanced-settings" data-search-scope><div class="setting-row"><div class="setting-info">diff --git a/src/firefox/src/ui/settings-tabs.js b/src/firefox/src/ui/settings-tabs.jsindex e8cdf9ec5..db7a26318 100644--- a/src/firefox/src/ui/settings-tabs.js+++ b/src/firefox/src/ui/settings-tabs.js@@ -66,6 +66,18 @@});});+ // During a search each tab's matches sit under its name, and the name opens+ // that tab. Focus moves to its tab button, as if it had been picked.+ document.querySelectorAll('[data-search-tab]').forEach((link) => {+ link.addEventListener('click', () => {+ const tab = Array.from(buttons).find((b) => b.dataset.tab === link.dataset.searchTab);+ if (!tab) return;+ tab.click();+ tab.focus();+ window.scrollTo({ top: 0 });+ });+ });+// Restore the last-viewed tab so the page doesn't snap back to the default// every reload — makes iterating on a single section less annoying.let initial = DEFAULT_TAB;diff --git a/src/firefox/src/ui/settings.css b/src/firefox/src/ui/settings.cssindex a4aa9ae2f..5b626c0aa 100644--- a/src/firefox/src/ui/settings.css+++ b/src/firefox/src/ui/settings.css@@ -1363,12 +1363,32 @@ button:active { transform: scale(0.97); }.captcha-advanced input { max-width: 140px; }/* Settings search spans General, Budgets, Captcha and Advanced. While a query- is active those tabs show their matches together, each under its tab name;- clearing the query returns to the tab you were on. */+ is active those tabs show their matches together, each under its tab name,+ and no tab is marked as the current one. A tab name opens that tab; picking+ a tab or clearing the query ends the search. */.search-panel-heading { display: none; }body.settings-searching .tab-panel[data-search] { display: block; }body.settings-searching .tab-panel:not([data-search]) { display: none; }body.settings-searching .tab-panel .search-panel-heading { display: block; margin: 22px 0 10px; }+body.settings-searching .tab-btn.active { background: transparent; color: var(--text2); }+body.settings-searching .tab-btn.active:hover { color: var(--text); }+.search-panel-link {+ background: none;+ border: 0;+ border-radius: 4px;+ padding: 0;+ font: inherit;+ color: inherit;+ letter-spacing: inherit;+ text-transform: inherit;+ cursor: pointer;+}+.search-panel-link::after { content: ' ›'; }+[dir="rtl"] .search-panel-link::after { content: ' ‹'; }+.search-panel-link:hover,+.search-panel-link:focus-visible { color: var(--accent); }+.search-panel-link:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }+.search-panel-link:active { transform: none; }.settings-group { margin-bottom: 10px; }.settings-group > .setting-row:last-child { margin-bottom: 0; }.settings-group > .info-box { margin: 0 0 10px; }diff --git a/src/firefox/src/ui/settings.html b/src/firefox/src/ui/settings.htmlindex 950fa65a2..c9fce0054 100644--- a/src/firefox/src/ui/settings.html+++ b/src/firefox/src/ui/settings.html@@ -51,7 +51,7 @@<div class="general-search-empty" id="general-search-empty" hidden data-i18n="st.display.search.empty"></div><section class="tab-panel active" data-panel="display" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.display"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="display" data-i18n="st.tab.display"></button></h2><div id="display-settings" data-search-scope><div class="setting-row"><div class="setting-info">@@ -148,7 +148,7 @@</section><section class="tab-panel" data-panel="budgets" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.budgets"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="budgets" data-i18n="st.tab.budgets"></button></h2><div id="budget-settings" data-search-scope><div class="setting-row"><div class="setting-info">@@ -461,7 +461,7 @@</section><section class="tab-panel" data-panel="captcha" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.captcha"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="captcha" data-i18n="st.tab.captcha"></button></h2><div id="captcha-settings" data-search-scope><div class="provider-card" id="captcha-card" aria-labelledby="captcha-heading"><h3 id="captcha-heading" data-i18n="st.captcha.heading"></h3>@@ -702,7 +702,7 @@</section><section class="tab-panel" data-panel="advanced" role="tabpanel" data-search>- <h2 class="search-panel-heading" data-i18n="st.tab.advanced"></h2>+ <h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="advanced" data-i18n="st.tab.advanced"></button></h2><div id="advanced-settings" data-search-scope><div class="setting-row"><div class="setting-info">diff --git a/test/run.js b/test/run.jsindex dd3375204..d2786b859 100644--- a/test/run.js+++ b/test/run.js@@ -48047,7 +48047,7 @@ test('settings tabs validate saved and hash tab names without selector interpolaconst malformed = runSettingsTabsScript(script, settingsHtml, { saved: 'display"] .boom', hash: '#bad"]' });assert.equal(malformed.activeButton, 'display', `${label}: malformed tab values should fall back to General`);assert.equal(malformed.activePanel, 'display', `${label}: malformed tab values should activate the General panel`);- assert.deepEqual(malformed.selectorCalls, ['nav.tabs', '.tab-btn', '.tab-panel'], `${label}: dynamic tab values must not be interpolated into selectors`);+ assert.deepEqual(malformed.selectorCalls, ['nav.tabs', '.tab-btn', '.tab-panel', '[data-search-tab]'], `${label}: dynamic tab values must not be interpolated into selectors`);assert.equal(malformed.storageKey, 'webbrainSettingsTab', `${label}: Settings remembers its own last tab`);for (const tab of ['budgets', 'captcha', 'advanced']) {@@ -48110,7 +48110,7 @@ test('settings organizes General, Budgets, CAPTCHA and Advanced tabs while keepiconst captcha = settingsPanelHtml(html, 'captcha');const advanced = settingsPanelHtml(html, 'advanced');for (const [name, panel] of [['General', general], ['Budgets', budgets], ['CAPTCHA', captcha], ['Advanced', advanced]]) {- assert.match(panel, /<h2 class="search-panel-heading" data-i18n="st\.tab\.[a-z]+"><\/h2>\s*<div id="[a-z-]+" data-search-scope>/, `${label}: ${name} rows sit in one search scope under the tab name`);+ assert.match(panel, /<h2 class="search-panel-heading"><button type="button" class="search-panel-link" data-search-tab="([a-z]+)" data-i18n="st\.tab\.\1"><\/button><\/h2>\s*<div id="[a-z-]+" data-search-scope>/, `${label}: ${name} rows sit in one search scope under the tab name, which opens that tab`);}const searchStart = html.indexOf('id="input-general-search"');@@ -48122,6 +48122,7 @@ test('settings organizes General, Budgets, CAPTCHA and Advanced tabs while keepiassert.match(css, /\.general-search-hidden \{ display: none !important; \}/, `${label}: search should force-hide filtered rows/cards`);assert.match(css, /body\.settings-searching \.tab-panel\[data-search\] \{ display: block; \}/, `${label}: a search shows every searchable tab at once`);assert.match(css, /body\.settings-searching \.tab-panel:not\(\[data-search\]\) \{ display: none; \}/, `${label}: a search hides the tabs it does not cover`);+ assert.match(css, /body\.settings-searching \.tab-btn\.active \{ background: transparent; color: var\(--text2\); \}/, `${label}: no tab looks current while a search shows several tabs`);// General keeps everyday preferences; the side panel picks the language and zoom.for (const id of ['select-theme', 'input-download-directory', 'select-plan-before-act-mode', 'select-auto-screenshot']) {diff --git a/test/settings-pages-ui.mjs b/test/settings-pages-ui.mjsindex f56f391fa..0d20542c9 100644--- a/test/settings-pages-ui.mjs+++ b/test/settings-pages-ui.mjs@@ -180,6 +180,16 @@ try {assert.equal(await visible(page, '#select-theme'), false, `${build}: search hides non-matching General rows`);assert.equal(await visible(page, '[data-panel="memory"]'), false, `${build}: search leaves Memory out`);assert.ok(await visible(page, '[data-panel="budgets"] .search-panel-heading'), `${build}: matches sit under their tab name`);+ // The results span tabs, so no tab is marked as the current one.+ assert.equal(await page.locator('.tab-btn.active').evaluate(el => getComputedStyle(el).backgroundColor), 'rgba(0, 0, 0, 0)',+ `${build}: no tab looks current during a search`);+ // A tab name opens that tab and ends the search.+ await page.locator('[data-panel="budgets"] [data-search-tab="budgets"]').click();+ assert.equal(await page.locator('#input-general-search').inputValue(), '', `${build}: a tab name ends the search`);+ assert.equal(await activeTab(page), 'budgets', `${build}: a tab name opens its tab`);+ assert.equal(await page.evaluate(() => document.activeElement?.dataset?.tab), 'budgets', `${build}: focus moves to that tab`);+ assert.notEqual(await page.locator('.tab-btn.active').evaluate(el => getComputedStyle(el).backgroundColor), 'rgba(0, 0, 0, 0)',+ `${build}: the picked tab is marked current again`);await page.locator('#input-general-search').fill('redact');assert.ok(await visible(page, '#screenshot-redaction-setting'), `${build}: search finds Advanced settings`);assert.equal(await visible(page, '[data-panel="budgets"]'), false, `${build}: a tab without matches is hidden`);diff --git a/web/docs/settings/index.html b/web/docs/settings/index.htmlindex ef9bedb02..a4da96730 100644--- a/web/docs/settings/index.html+++ b/web/docs/settings/index.html@@ -29,7 +29,7 @@<section class="doc-section" id="general"><div class="eyebrow">Everyday</div><h2>General: how the agent behaves</h2><p>Appearance and download location are cosmetic. The controls below them change the agent loop: how it plans, when you review, and what it captures. Language and zoom are picked in the side panel, so they are not repeated here.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-general.jpg"><img src="/docs/assets/screenshots/settings-general.jpg" alt="WebBrain General settings with the search box, appearance, download folder, planning and plan review controls"></a><figcaption>General starts with the controls you are most likely to use. Click the image to view it at full size.</figcaption></figure><h3>Planning controls</h3><ul><li><strong>Try planning</strong> is the best general choice. WebBrain attempts a structured plan before Act or Dev tools run; if planner formatting still fails after repair, that turn continues with the Ask prompt and read-only tools.</li><li><strong>Strict planning</strong> cancels the run when a valid plan cannot be produced. Use it where “no plan, no action” matters more than convenience.</li><li><strong>Off</strong> removes the extra full-plan call, while retaining the compact intent check and its safe read-only fallback. It can be faster and cheaper, but you lose the plan review checkpoint.</li></ul><h3>Auto-screenshot</h3><p><strong>On navigation</strong> (the default) takes one picture after the agent opens a page, so the vision model sees where it landed. <strong>On state change</strong> also captures after clicks, typing and other actions that change the page, which costs more image tokens; <strong>Every step</strong> captures after every tool call; <strong>Off</strong> captures only when asked.</p>- <h3>Search</h3><p>The search box below the tab bar looks through General, Budgets, CAPTCHA and Advanced at once and shows each match under its tab name. Picking a tab ends the search.</p>+ <h3>Search</h3><p>The search box below the tab bar looks through General, Budgets, CAPTCHA and Advanced at once, whichever of them you are on, and shows each match under its tab name. While it shows results, no tab is marked as the current one. Click a tab name above the results to open that tab, or pick a tab in the bar; either ends the search, and so does clearing it, which returns you to the tab you were on.</p></section><section class="doc-section" id="budgets"><div class="eyebrow">Limits</div><h2>Budgets: how far one task may go</h2><p>Budgets gathers every limit on spending, waiting and work in one tab: the cloud cost allowances, how long a question waits for you, the step limit, the model timeout and the screenshot image budget.</p><figure class="shot"><a href="/docs/assets/screenshots/settings-budgets.jpg"><img src="/docs/assets/screenshots/settings-budgets.jpg" alt="WebBrain Budgets settings with the cloud cost allowances, question timeout, step limit, request timeout and image budget"></a><figcaption>Every mechanical stop in one place. Example values are the defaults.</figcaption></figure><div class="table-wrap"><table><thead><tr><th>Setting</th><th>Default</th><th>What it limits</th></tr></thead><tbody><tr><td>Cloud cost session allowance</td><td>$10.00</td><td>Estimated spend on cloud and router model calls in one conversation. WebBrain stops before the next call once it is reached.</td></tr><tr><td>Cloud cost total allowance</td><td>$10.00</td><td>Estimated spend across all conversations. The label shows what has been spent so far, for example <code>$0.00 / $10.00</code>; <strong>Reset spend</strong> starts the count again.</td></tr><tr><td>Clarify timeout</td><td>60 seconds</td><td>How long a question card waits for your answer before WebBrain answers it itself. Instant and Off are at the ends of the slider.</td></tr><tr><td>When a question times out</td><td>Finish the task</td><td>Whether the timed-out answer keeps the task moving or takes the safe choice.</td></tr><tr><td>Max Agent Steps</td><td>130</td><td>Tool-use steps for one message, not chat messages.</td></tr><tr><td>LLM request timeout</td><td>120 seconds</td><td>How long WebBrain waits for the model to start answering.</td></tr><tr><td>Image budget</td><td>Auto detail, no per-turn limit, 1568 px</td><td>How many screenshots a turn may send to the vision model and at what size.</td></tr></tbody></table></div>diff --git a/web/docs/zh/settings/index.html b/web/docs/zh/settings/index.htmlindex 782f41f2d..11f0187a5 100644--- a/web/docs/zh/settings/index.html+++ b/web/docs/zh/settings/index.html@@ -14,7 +14,7 @@<div class="docs-shell"><aside class="docs-sidebar" aria-label="文档目录"><div class="sidebar-group"><div class="sidebar-label">从这里开始</div><nav><a href="/docs/zh/">概览</a><a href="/docs/zh/faq/">常见问题</a></nav></div><div class="sidebar-group"><div class="sidebar-label">使用 WebBrain</div><nav><a href="/docs/zh/settings/" aria-current="page">设置说明</a><a href="/docs/zh/providers/">提供商与模型</a><a href="/docs/zh/easy-cli-proxy/">订阅代理</a><a href="/docs/zh/safety/">模式、安全与隐私</a><a href="/docs/zh/apocalypse-mode/">末日模式</a><a href="/docs/zh/formats/">导出与工作流</a><a href="/docs/zh/mcp/">MCP 服务器</a><a href="/docs/zh/lm-studio/">LM Studio 插件</a><a href="/docs/zh/ollama/">Ollama</a></nav></div><div class="sidebar-group"><div class="sidebar-label">社区</div><nav><a href="https://discord.gg/cgC325ssfw">Discord 支持</a></nav></div></aside><main class="doc-main" id="main"><div class="breadcrumb"><a href="/docs/zh/">文档</a> / 设置</div><section class="doc-hero"><div class="eyebrow">不再猜测设置含义</div><h1>知道该改什么,也知道什么可以不动。</h1><p class="lede">从侧边栏齿轮或浏览器扩展选项打开设置。聊天模型及其辅助模型有单独的<strong>提供商</strong>页面:在侧边栏模型菜单中选择<strong>更多…</strong>,或点击设置页顶部的“提供商”链接即可打开。网站权限也有单独的页面:在麦克风旁边的 <strong>⚠</strong> 菜单中选择“管理网站权限”即可打开。大多数人主要使用“通用”、提供商和权限;其他标签页用于解决特定问题。</p><div class="meta">截图来自设置重新整理后的英文界面 · 中文界面的控件位置相同 · 合成示例不含真实凭据</div></section><section class="doc-section" id="defaults"><h2>适合大多数人的默认值</h2><div class="table-wrap"><table><thead><tr><th>控制项</th><th>推荐值</th><th>原因</th></tr></thead><tbody><tr><td>执行前计划</td><td>尝试计划</td><td>有计划时使用;如果规划器格式化失败,安全回退到只读轮次。</td></tr><tr><td>计划审查</td><td>低于置信度阈值时停止</td><td>不确定的计划暂停,可靠计划可继续。</td></tr><tr><td>审查阈值</td><td>90%</td><td>在监督与流畅度之间较保守的平衡。</td></tr><tr><td>最大代理步骤</td><td>130</td><td>足够处理多步骤工作;出现重复时仍应手动停止。</td></tr><tr><td>LLM 请求超时</td><td>120 秒</td><td>云模型通常更快,大型本地模型启动可能更慢。</td></tr><tr><td>自动截图</td><td>导航时</td><td>代理打开页面后截一张图,而不是每次点击或输入后都截图。需要视觉模型检查每个操作时再选“状态变化时”。</td></tr><tr><td>云端费用额度</td><td>每个会话 $10,总计 $10</td><td>付费模型调用的机械停止点,可在“预算”中调高或调低。</td></tr><tr><td>计划任务关键操作确认</td><td>开启</td><td>无人值守任务仍会在关键操作前暂停。</td></tr><tr><td>权限闸门</td><td>开启</td><td>首次在网站执行特定操作前询问,并记住你的明确选择。侧边栏输入框中麦克风旁边的 ⚠ 按钮也可以切换它。</td></tr><tr><td>决策模型</td><td>自动</td><td>无需设置。Ternary Bonsai 2 2B Vision 下载完成后用它做完成检查(WebBrain Cloud 激活时使用 Compass 的托管决策模型),其他情况下不使用决策模型。</td></tr><tr><td>浏览器内视觉模型</td><td>自动</td><td>Ternary Bonsai 2 2B Vision 下载完成后用它读取截图,且仅在聊天模型无法看图时使用。</td></tr></tbody></table></div></section>- <section class="doc-section" id="general"><div class="eyebrow">日常使用</div><h2>通用:代理如何行动</h2><p>外观和下载位置只影响使用体验;下面的控制项会改变代理的工作方式:如何计划、何时由你审查、截取哪些截图。语言和缩放在侧边栏中选择,这里不再重复。</p><figure class="shot"><a href="/docs/assets/screenshots/settings-general.jpg"><img src="/docs/assets/screenshots/settings-general.jpg" alt="WebBrain 通用设置英文界面,包含搜索框、外观、下载文件夹、计划与计划审查"></a><figcaption>“通用”标签页顶部是最常用的控制项。点击可查看原图。</figcaption></figure><p><strong>尝试计划</strong>适合日常使用;<strong>严格计划</strong>会在无法生成有效计划时取消任务;<strong>关闭</strong>会省去一次规划调用,但也失去计划审查节点。</p><p><strong>自动截图</strong>默认为<strong>导航时</strong>:代理打开页面后截一张图,让视觉模型看到它到达了哪里。<strong>状态变化时</strong>还会在点击、输入等改变页面的操作后截图,图像令牌消耗更多;<strong>每一步</strong>在每次工具调用后截图;<strong>关闭</strong>只在你要求时截图。</p><p>标签栏下方的搜索框会同时搜索“通用”“预算”“CAPTCHA”和“高级”,并把每个结果显示在所属标签页名称下。选择任意标签页即结束搜索。</p></section>+ <section class="doc-section" id="general"><div class="eyebrow">日常使用</div><h2>通用:代理如何行动</h2><p>外观和下载位置只影响使用体验;下面的控制项会改变代理的工作方式:如何计划、何时由你审查、截取哪些截图。语言和缩放在侧边栏中选择,这里不再重复。</p><figure class="shot"><a href="/docs/assets/screenshots/settings-general.jpg"><img src="/docs/assets/screenshots/settings-general.jpg" alt="WebBrain 通用设置英文界面,包含搜索框、外观、下载文件夹、计划与计划审查"></a><figcaption>“通用”标签页顶部是最常用的控制项。点击可查看原图。</figcaption></figure><p><strong>尝试计划</strong>适合日常使用;<strong>严格计划</strong>会在无法生成有效计划时取消任务;<strong>关闭</strong>会省去一次规划调用,但也失去计划审查节点。</p><p><strong>自动截图</strong>默认为<strong>导航时</strong>:代理打开页面后截一张图,让视觉模型看到它到达了哪里。<strong>状态变化时</strong>还会在点击、输入等改变页面的操作后截图,图像令牌消耗更多;<strong>每一步</strong>在每次工具调用后截图;<strong>关闭</strong>只在你要求时截图。</p><p>标签栏下方的搜索框会同时搜索“通用”“预算”“CAPTCHA”和“高级”(无论你当前在其中哪个标签页),并把每个结果显示在所属标签页名称下。显示结果时,不会把任何标签页标记为当前标签页。点击结果上方的标签页名称即可打开该标签页,也可以在标签栏中选择标签页;两种方式都会结束搜索。清空搜索也会结束搜索,并回到你原来所在的标签页。</p></section><section class="doc-section" id="budgets"><div class="eyebrow">限制</div><h2>预算:单个任务能走多远</h2><p>“预算”把所有关于花费、等待和工作量的限制集中在一个标签页:云端费用额度、问题等待你回答的时间、步骤上限、模型请求超时和截图的图像预算。</p><figure class="shot"><a href="/docs/assets/screenshots/settings-budgets.jpg"><img src="/docs/assets/screenshots/settings-budgets.jpg" alt="WebBrain 预算设置英文界面,包含云端费用额度、问题超时、步骤上限、请求超时和图像预算"></a><figcaption>所有机械停止点都在这里。示例值为默认值。</figcaption></figure><div class="table-wrap"><table><thead><tr><th>设置</th><th>默认值</th><th>限制什么</th></tr></thead><tbody><tr><td>云端费用会话额度</td><td>$10.00</td><td>单个对话中云端和路由模型调用的估算花费。达到额度后,WebBrain 会在下一次调用前停止。</td></tr><tr><td>云端费用总额度</td><td>$10.00</td><td>所有对话的估算总花费。标签会显示已花费金额,例如 <code>$0.00 / $10.00</code>;<strong>重置花费</strong>会重新开始计数。</td></tr><tr><td>澄清超时</td><td>60 秒</td><td>问题卡片等待你回答的时间,超时后 WebBrain 自行作答。滑块两端分别是“立即”和“关闭”。</td></tr><tr><td>问题超时时</td><td>完成任务</td><td>超时后的答案是继续推进任务,还是选择更安全的做法。</td></tr><tr><td>代理最大步骤数</td><td>130</td><td>一条消息中的工具调用步骤,不是聊天消息数。</td></tr><tr><td>LLM 请求超时</td><td>120 秒</td><td>等待模型开始响应的时间。</td></tr><tr><td>图像预算</td><td>自动细节、每轮不限、1568 px</td><td>每轮最多向视觉模型发送多少张截图,以及截图尺寸。</td></tr></tbody></table></div><p>步骤上限越高,长流程越有机会完成和恢复,但也可能消耗更多令牌。请求超时只限制模型开始响应前的等待时间,不会中断已经开始流式输出的响应。</p><div class="callout warning"><strong class="callout-title">无限步骤不等于更可靠</strong><p>∞ 只会移除机械停止点,不会让模型更不容易循环。除非你正在全程监督长任务,否则保留有限上限。</p></div></section><section class="doc-section" id="memory"><div class="eyebrow">按需使用</div><h2>记忆:决定哪些信息长期保留</h2><figure class="shot"><a href="/docs/assets/screenshots/settings-memory.jpg"><img src="/docs/assets/screenshots/settings-memory.jpg" alt="WebBrain 记忆设置英文界面,显示加密云同步与个人资料自动填充"></a><figcaption>记忆标签页包含加密同步、个人资料自动填充和用户记忆三种不同功能。</figcaption></figure><ul><li><strong>加密云同步</strong>面向 WebBrain Compass 会员;支持的提供商密钥、个人资料和记忆会在上传前用同步密码加密。聊天历史与 OAuth 登录不会同步。</li><li><strong>个人资料自动填充</strong>以明文保存在当前浏览器配置中,启用后会发送给当前模型提供商。</li><li><strong>用户记忆</strong>保存稳定偏好;<code>/memory --add</code> 会立即保存,自动学习是可选项。</li></ul><div class="callout danger"><strong class="callout-title">不要把记忆当作密码管理器</strong><p>不要在个人资料或用户记忆中存放密码、API 密钥、令牌、恢复码等秘密。</p></div></section><section class="doc-section" id="skills"><div class="eyebrow">信任决定</div><h2>技能:附加指令与工具</h2><p>技能可以把指令加入系统提示;含 <code>webbrain-tools</code> 清单的技能还可暴露 HTTP 或下载任务工具。导入本身就是信任决定,只导入你信任的来源。</p></section>