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
<!doctype html>
<html lang="zh-CN" data-theme="dark">
<head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>WebBrain 用户指南</title><meta name="description" content="从第一次提问开始,了解 WebBrain 的设置、模型、安全权限、记忆与高级功能。"><link rel="canonical" href="https://webbrain.one/docs/zh/"><link rel="alternate" hreflang="en" href="https://webbrain.one/docs/"><link rel="alternate" hreflang="zh" href="https://webbrain.one/docs/zh/"><link rel="alternate" hreflang="x-default" href="https://webbrain.one/docs/"><link rel="icon" href="/favicon.png"><script>try{document.documentElement.dataset.theme=localStorage.getItem('webbrain-theme')||'dark'}catch(_){}</script><link rel="stylesheet" href="/docs/assets/docs.css?v=20261028">
<!-- Plausible analytics: start -->
<!-- Privacy-friendly analytics by Plausible -->
<script async src="https://157.230.3.9.sslip.io/js/pa-omp0F7DsOXM4sGKR50l7S.js"></script>
<script>
window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};
plausible.init()
</script>
<!-- Plausible analytics: end -->
<!-- Site footer styles: start -->
<style>
.wb-footer {
--wb-footer-text: var(--text, var(--ink, #2c1810));
--wb-footer-dim: var(--text-dim, var(--muted, #6b5b47));
--wb-footer-line: var(--border, var(--line, rgba(89, 55, 25, 0.15)));
margin: 0;
padding: 0;
border-top: 1px solid var(--wb-footer-line);
background: var(--wb-footer-bg, none);
color: var(--wb-footer-dim);
font-size: 13px;
line-height: 1.5;
text-align: start;
}
.wb-footer-inner {
width: var(--wb-footer-width, min(calc(100% - 48px), 1100px));
margin: 0 auto;
padding: 26px 0 30px;
display: flex;
flex-direction: column;
gap: 18px;
}
/* Page links start on the brand's left edge; the social icons sit at
the far end of the same row. */
.wb-footer-row { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 14px 32px; }
.wb-footer-brand { display: flex; flex-direction: column; gap: 5px; }
.wb-footer-tagline { margin: 0; color: var(--wb-footer-text); font-size: 15px; font-weight: 700; line-height: 1.4; }
.wb-footer-copy { margin: 0; }
.wb-footer-copy a { color: var(--wb-footer-text); font-weight: 650; text-decoration: none; }
.wb-footer-links { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 18px; }
.wb-footer-social { display: flex; align-items: center; gap: 8px; }
.wb-footer-links a { color: var(--wb-footer-dim); font-weight: 600; text-decoration: none; }
.wb-footer a:hover { color: var(--wb-footer-text); text-decoration: none; }
.wb-footer a:focus-visible { outline: 2px solid currentColor; outline-offset: 3px; border-radius: 4px; }
.wb-footer-icon { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; margin: -4px 0; border-radius: 6px; }
.wb-footer-icon:hover { background: color-mix(in srgb, currentColor 12%, transparent); }
.wb-footer-icon svg { display: block; width: 15px; height: 15px; }
/* Only shown without JavaScript, when the language picker can't run. */
.wb-footer-languages { display: none; flex-wrap: wrap; gap: 6px 12px; width: 100%; direction: ltr; }
.wb-footer-languages span { color: var(--wb-footer-text); font-weight: 700; }
@media (max-width: 860px) {
.wb-footer-inner { width: var(--wb-footer-width, calc(100% - 32px)); }
}
</style>
<!-- Site footer styles: end -->
</head>
<body>
<a class="skip-link" href="#main">跳到正文</a>
<header class="site-header"><div class="header-inner"><a class="brand" href="/"><img src="/logo-github.png" alt=""><span>WebBrain</span><span class="brand-docs">用户指南</span></a><nav class="top-nav" aria-label="主导航"><a href="/">首页</a><a href="/docs/zh/" aria-current="page">文档</a><a href="/blog/">博客</a><a href="https://github.com/webbrain-one/webbrain">GitHub</a></nav><div class="header-tools"><a class="lang-switch" href="/docs/" aria-label="Read in English"><span>EN</span><span class="active">中文</span></a><button class="icon-button" type="button" data-theme-toggle aria-label="切换主题">☀</button><button class="sidebar-toggle" type="button" data-sidebar-toggle aria-expanded="false" aria-label="打开文档菜单">☰</button></div></div></header>
<div class="docs-shell">
<aside class="docs-sidebar" aria-label="文档目录"><div class="sidebar-group"><div class="sidebar-label">从这里开始</div><nav><a href="/docs/zh/" aria-current="page">概览</a><a href="/docs/zh/faq/">常见问题</a><a href="#first-run">开始使用</a></nav></div><div class="sidebar-group"><div class="sidebar-label">使用 WebBrain</div><nav><a href="/docs/zh/settings/">设置说明</a><a href="/docs/zh/providers/">提供商与模型</a><a href="/companion/">WebBrain Companion</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://github.com/webbrain-one/webbrain/tree/main/docs">技术文档(英文)↗</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">
<section class="doc-hero"><div class="eyebrow">WebBrain 使用手册</div><h1>浏览器代理有很多开关,但你不需要先学会所有开关。</h1><p class="lede">先打开一个网页并提出问题。这份指南先带你用最短路径得到结果,再在真正需要时解释更深层的设置。</p><div class="path-grid"><a class="path-card" href="#first-run"><span class="tab-key">第一次使用</span><h2>先完成一个任务</h2><p>打开侧边栏、选择合适模式,不改任何设置也能开始。</p><span class="arrow">开始使用 →</span></a><a class="path-card" href="/docs/zh/settings/"><span class="tab-key">控制代理</span><h2>看懂设置</h2><p>每个标签页会改变什么、哪些默认值适合大多数人、哪些可以先忽略。</p><span class="arrow">打开设置指南 →</span></a><a class="path-card" href="/docs/zh/providers/"><span class="tab-key">选择模型</span><h2>配置提供商</h2><p>使用 WebBrain Compass、云 API、模型路由或本地模型。</p><span class="arrow">选择模型 →</span></a><a class="path-card" href="/docs/zh/safety/"><span class="tab-key">保持控制</span><h2>安全使用执行模式</h2><p>了解询问、执行、开发模式,网站权限、记忆边界和高风险覆盖项。</p><span class="arrow">查看安全指南 →</span></a><a class="path-card" href="/docs/zh/formats/"><span class="tab-key">迁移内容</span><h2>放心导出</h2><p>区分对话、轨迹、设置与已保存工作流文件,并了解哪些内容敏感。</p><span class="arrow">了解导出格式 →</span></a></div></section>
<section class="doc-section" id="first-run"><div class="eyebrow">第一次运行</div><h2>前十分钟</h2><ol class="step-list"><li><strong>打开你想处理的网页。</strong>点击 WebBrain 图标,让侧边栏与网页并排显示。</li><li><strong>先留在“询问”模式。</strong>例如:“总结本页”“列出重要日期”“比较表格中的套餐”。询问模式可以阅读,但不会点击或输入。</li><li><strong>需要改动网页时再切到“执行”。</strong>例如:“在搜索框输入 wireless headphones 并搜索”。在新网站进行关键操作前,WebBrain 会请求权限。</li><li><strong>观察过程。</strong>随时使用停止按钮或 <kbd>Escape</kbd> 中止。遇到意外跳转、输入或重复动作,应立即停止。</li><li><strong>有明确需求时才打开设置。</strong>内置云提供商与推荐安全默认值足够完成第一次任务。</li></ol><div class="callout tip"><strong class="callout-title">好的提示词要写清结果</strong><p>“找到退款政策,并告诉我促销商品是否适用”比“看看这个网站”更容易验证。写明目标,也写明 WebBrain 不应越过的边界。</p></div></section>
<section class="doc-section" id="modes"><h2>先选模式,再发提示词</h2><div class="mode-strip"><div class="mode ask"><strong>询问 Ask</strong><span>阅读、解释、比较、提取;不改变网页。</span></div><div class="mode act"><strong>执行 Act</strong><span>点击、输入、导航、下载、安排任务。</span></div><div class="mode dev"><strong>开发 Dev</strong><span>增加源码、样式、DOM、框架和调试工具。</span></div></div></section>
<section class="doc-section" id="settings-map"><div class="eyebrow">它是一张地图,不是检查清单</div><h2>设置一览</h2><p>不需要配置所有内容。提供商和权限有各自的页面;其余是设置中的标签页,另有用于特定附加功能的“技能”“CAPTCHA”和“Bridge”。每个方块底部的颜色表示普通用户需要它的频率。</p><div class="settings-map" aria-label="设置深度地图"><div class="setting-node everyday"><strong>通用</strong><span>行为与体验</span></div><div class="setting-node everyday"><strong>提供商</strong><span>模型与辅助模型</span></div><div class="setting-node everyday"><strong>权限</strong><span>允许操作的网站</span></div><div class="setting-node sometimes"><strong>预算</strong><span>花费、时间与步骤</span></div><div class="setting-node sometimes"><strong>记忆</strong><span>持久信息</span></div><div class="setting-node expert"><strong>高级</strong><span>专家开关</span></div></div><div class="depth-legend"><span>日常控制</span><span class="sometimes">按需使用</span><span class="expert">高级信任决定</span></div><div class="callout"><strong class="callout-title">安全基线</strong><p>“执行前计划”保留为“尝试计划”,计划审查使用置信度阈值,计划任务确认保持开启,“关键操作前询问”保持开启。其他选项可以先不改。</p></div></section>
<nav class="next-links" aria-label="后续指南"><a href="/docs/zh/settings/"><span>下一篇</span>设置说明 →</a><a href="/docs/zh/safety/"><span>推荐阅读</span>模式、安全与隐私 →</a></nav>
</main>
<aside class="on-this-page" aria-label="本页内容"><h2>本页内容</h2><a href="#first-run">前十分钟</a><a href="#modes">选择模式</a><a href="#settings-map">设置地图</a></aside>
</div>
<!-- Site footer: start -->
<footer class="wb-footer">
<div class="wb-footer-inner">
<div class="wb-footer-brand">
<p class="wb-footer-tagline">我们的使命:让网络更智能。</p>
<p class="wb-footer-copy">© 2026 WebBrain。由 <a href="https://emresokullu.com" target="_blank">Emre Sokullu</a> 与<a href="https://github.com/webbrain-one/webbrain/graphs/contributors" target="_blank">贡献者</a>共同构建。</p>
</div>
<div class="wb-footer-row">
<div class="wb-footer-links">
<a href="/zh/">浏览器扩展</a>
<a href="/companion/zh/">桌面 Companion</a>
<a href="/research/">研究</a>
<a href="/docs/zh/">文档</a>
<a href="/docs/zh/faq/">常见问题</a>
<a href="/blog/">博客</a>
<a href="/privacy">隐私政策</a>
<a href="https://github.com/webbrain-one/webbrain/issues" target="_blank" rel="noopener">报告 Bug</a>
<a href="https://github.com/webbrain-one/webbrain/blob/main/LICENSE" target="_blank" rel="noopener">GPL-3.0 许可</a>
<a href="https://pressreleases.online/org/webbrain.one" target="_blank" rel="noopener">媒体</a>
<a href="https://api.webbrain.one/account" target="_blank" rel="noopener">Compass 订阅</a>
</div>
<div class="wb-footer-social">
<a href="https://mastoturk.org/@webbrain" target="_blank" rel="me noopener" aria-label="Mastodon 上的 WebBrain" title="Mastodon 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M21.327 8.566c0-5.035-3.298-6.511-3.298-6.511C16.366 1.292 13.508.971 12.04.947h-.036c-1.468.024-4.326.345-5.989 1.108 0 0-3.298 1.476-3.298 6.511 0 1.153-.022 2.535.014 4.001.12 4.935.907 9.799 5.478 11.007 2.106.557 3.916.674 5.374.594 2.645-.147 4.128-.943 4.128-.943l-.087-1.918s-1.888.595-4.012.523c-2.104-.072-4.326-.227-4.668-2.809a5.289 5.289 0 0 1-.047-.724s2.066.505 4.686.625c1.603.073 3.107-.094 4.632-.276 2.925-.349 5.474-2.149 5.794-3.793.503-2.591.462-6.287.462-6.287ZM8.545 15.023H6.09V8.996c0-2.534 1.627-3.829 3.424-3.829 1.963 0 2.909 1.268 3.35 2.257.44-.989 1.386-2.257 3.349-2.257 1.797 0 3.424 1.295 3.424 3.829v6.027h-2.454V9.174c0-1.233-.519-1.859-1.557-1.859-1.148 0-1.724.742-1.724 2.207v3.203h-2.454V9.522c0-1.465-.576-2.207-1.724-2.207-1.038 0-1.557.626-1.557 1.859v5.849Z"/></svg></a>
<a href="https://bsky.app/profile/webbrain-one.bsky.social" target="_blank" rel="me noopener" aria-label="Bluesky 上的 WebBrain" title="Bluesky 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12 10.8c-1.1-2.1-4-6-6.8-8C2.6.9 1.6 1.3.9 1.6.1 1.9 0 3.1 0 3.8c0 .7.4 5.7.6 6.5.8 2.7 3.7 3.7 5.6 3.4-3.5.6-6.5 2-2.5 6.5 4.3 4.5 5.9-1 6.3-2.8.1-.5.2-.8.3-.8.1 0 .2.3.3.8.4 1.8 2 7.3 6.3 2.8 4-4.5 1-5.9-2.5-6.5 1.9.3 4.8-.7 5.6-3.4.2-.8.6-5.8.6-6.5 0-.7-.1-1.9-.9-2.2-.7-.3-1.7-.6-4.3 1.2-2.8 2-5.7 5.9-6.8 8Z"/></svg></a>
<a href="https://discord.gg/cgC325ssfw" target="_blank" rel="noopener" aria-label="Discord 上的 WebBrain" title="Discord 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 16 16" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M13.545 2.907a13.227 13.227 0 0 0-3.257-1.011c.05.069.098.137.142.207a12.471 12.471 0 0 0-3.616 0c.044-.07.093-.138.143-.207A13.207 13.207 0 0 0 3.7 2.907 13.136 13.136 0 0 0 .931 13.362a13.667 13.667 0 0 0 4.022 2.018c.33-.442.623-.907.87-1.396a8.95 8.95 0 0 1-1.37-.652c.114-.083.225-.171.33-.269a9.6 9.6 0 0 0 8.243 0c.108.09.218.18.33.269a8.923 8.923 0 0 1-1.37.652c.248.489.54.954.87 1.396a13.667 13.667 0 0 0 4.022-2.018 13.136 13.136 0 0 0-2.769-10.455zM5.106 11.275c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608zm5.788 0c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608z"/></svg></a>
<a href="https://huggingface.co/webbrain-one" target="_blank" rel="me noopener" aria-label="Hugging Face 上的 WebBrain" title="Hugging Face 上的 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12.025 1.13c-5.77 0-10.449 4.647-10.449 10.378 0 1.112.178 2.181.503 3.185.064-.222.203-.444.416-.577a.96.96 0 0 1 .524-.15c.293 0 .584.124.84.284.278.173.48.408.71.694.226.282.458.611.684.951v-.014c.017-.324.106-.622.264-.874s.403-.487.762-.543c.3-.047.596.06.787.203s.31.313.4.467c.15.257.212.468.233.542.01.026.653 1.552 1.657 2.54.616.605 1.01 1.223 1.082 1.912.055.537-.096 1.059-.38 1.572.637.121 1.294.187 1.967.187.657 0 1.298-.063 1.921-.178-.287-.517-.44-1.041-.384-1.581.07-.69.465-1.307 1.081-1.913 1.004-.987 1.647-2.513 1.657-2.539.021-.074.083-.285.233-.542.09-.154.208-.323.4-.467a1.08 1.08 0 0 1 .787-.203c.359.056.604.29.762.543s.247.55.265.874v.015c.225-.34.457-.67.683-.952.23-.286.432-.52.71-.694.257-.16.547-.284.84-.285a.97.97 0 0 1 .524.151c.228.143.373.388.43.625l.006.04a10.3 10.3 0 0 0 .534-3.273c0-5.731-4.678-10.378-10.449-10.378M8.327 6.583a1.5 1.5 0 0 1 .713.174 1.487 1.487 0 0 1 .617 2.013c-.183.343-.762-.214-1.102-.094-.38.134-.532.914-.917.71a1.487 1.487 0 0 1 .69-2.803m7.486 0a1.487 1.487 0 0 1 .689 2.803c-.385.204-.536-.576-.916-.71-.34-.12-.92.437-1.103.094a1.487 1.487 0 0 1 .617-2.013 1.5 1.5 0 0 1 .713-.174m-10.68 1.55a.96.96 0 1 1 0 1.921.96.96 0 0 1 0-1.92m13.838 0a.96.96 0 1 1 0 1.92.96.96 0 0 1 0-1.92M8.489 11.458c.588.01 1.965 1.157 3.572 1.164 1.607-.007 2.984-1.155 3.572-1.164.196-.003.305.12.305.454 0 .886-.424 2.328-1.563 3.202-.22-.756-1.396-1.366-1.63-1.32q-.011.001-.02.006l-.044.026-.01.008-.03.024q-.018.017-.035.036l-.032.04a1 1 0 0 0-.058.09l-.014.025q-.049.088-.11.19a1 1 0 0 1-.083.116 1.2 1.2 0 0 1-.173.18q-.035.029-.075.058a1.3 1.3 0 0 1-.251-.243 1 1 0 0 1-.076-.107c-.124-.193-.177-.363-.337-.444-.034-.016-.104-.008-.2.022q-.094.03-.216.087-.06.028-.125.063l-.13.074q-.067.04-.136.086a3 3 0 0 0-.135.096 3 3 0 0 0-.26.219 2 2 0 0 0-.12.121 2 2 0 0 0-.106.128l-.002.002a2 2 0 0 0-.09.132l-.001.001a1.2 1.2 0 0 0-.105.212q-.013.036-.024.073c-1.139-.875-1.563-2.317-1.563-3.203 0-.334.109-.457.305-.454m.836 10.354c.824-1.19.766-2.082-.365-3.194-1.13-1.112-1.789-2.738-1.789-2.738s-.246-.945-.806-.858-.97 1.499.202 2.362c1.173.864-.233 1.45-.685.64-.45-.812-1.683-2.896-2.322-3.295s-1.089-.175-.938.647 2.822 2.813 2.562 3.244-1.176-.506-1.176-.506-2.866-2.567-3.49-1.898.473 1.23 2.037 2.16c1.564.932 1.686 1.178 1.464 1.53s-3.675-2.511-4-1.297c-.323 1.214 3.524 1.567 3.287 2.405-.238.839-2.71-1.587-3.216-.642-.506.946 3.49 2.056 3.522 2.064 1.29.33 4.568 1.028 5.713-.624m5.349 0c-.824-1.19-.766-2.082.365-3.194 1.13-1.112 1.789-2.738 1.789-2.738s.246-.945.806-.858.97 1.499-.202 2.362c-1.173.864.233 1.45.685.64.451-.812 1.683-2.896 2.322-3.295s1.089-.175.938.647-2.822 2.813-2.562 3.244 1.176-.506 1.176-.506 2.866-2.567 3.49-1.898-.473 1.23-2.037 2.16c-1.564.932-1.686 1.178-1.464 1.53s3.675-2.511 4-1.297c.323 1.214-3.524 1.567-3.287 2.405.238.839 2.71-1.587 3.216-.642.506.946-3.49 2.056-3.522 2.064-1.29.33-4.568 1.028-5.713-.624"/></svg></a>
</div>
</div>
</div>
</footer>
<!-- Site footer: end --><script src="/docs/assets/docs.js?v=20260809"></script>
</body></html>