Sitegeist 安全设计剖析:沙箱隔离、权限控制与CSP策略的四重防线
Sitegeist 安全设计剖析:沙箱隔离、权限控制与CSP策略的四重防线
Sitegeist 是一款运行在浏览器侧边栏的 AI 助手扩展,能帮你自动化重复网页任务、从任意网站提取数据。本文深度剖析 Sitegeist 的安全设计——沙箱隔离、权限控制与 CSP 策略,看懂浏览器 AI 助手究竟如何保护你的数据,而不是只谈"智能"。
为什么 AI 助手特别需要"安全感"?
传统网页脚本的作者是开发者,而 Sitegeist 的执行代码来自 大模型的实时生成——这意味着它必须默认假设"代码可能出错,甚至可能有害"。整个项目围绕一个核心理念构建:你主导,它执行(You guide, it executes)。AI 的每个动作都发生在受控的边界内,而不是"自主狂奔"。
具体来说,Sitegeist 搭建了四道防线:
- 沙箱隔离:AI 生成的代码在独立沙箱页中执行,先验证、后运行
- 权限控制:按需申请、可随时撤销的最小权限
- CSP 策略:用内容安全策略锁死数据外传通道
- 数据主权:所有数据留在本地,无任何遥测与跟踪
沙箱隔离:AI 代码先"体检"再"入笼"
Sitegeist 在扩展清单中注册了一个专门的沙箱页 static/sandbox.html,并在 static/manifest.chrome.json#L57-L59 中通过 "sandbox": { "pages": ["sandbox.html"] } 将其声明为 Chrome 的官方沙箱页面。
沙箱的入口逻辑在 static/sandbox.js 中,流程堪称教科书级的"先体检、后入笼":
- 监听加载请求:主面板通过
postMessage发来sandbox-load消息,携带待执行的代码 - HTML 解析校验:用
DOMParser解析代码,检查是否存在parsererror(见 static/sandbox.js#L6-L14) - JS 语法预检:对每个
<script>标签的内容执行new Function(scriptContent)——只编译、不运行,语法错误立刻拦截 - 通过后才写入文档:只有全部校验通过,才调用
document.write()真正执行代码 - 错误回传:任何校验失败都会以
sandbox-error消息返回给父页面,用户能看到清晰的错误原因
此外,AI 创建 Skill(可复用的网站自动化脚本)前,还会先在沙箱 iframe 中做语法校验和"导航意图"检查(src/tools/skill.ts#L79-L104),防止 AI 写出的代码直接跳走页面。
权限控制:只给"当前需要",随时可收回
最小权限集
在 static/manifest.chrome.json#L31-L47 中可以看到申请的权限:activeTab、scripting、userScripts、debugger 等。其中关键是 activeTab 而非全量标签页访问——Sitegeist 只能在你主动与它交互的那个标签页中注入脚本,无法在后台偷偷操作其他页面。
显式授权对话框
需要执行页面级 JavaScript 时,扩展会弹出授权对话框而不是静默放行。基类 src/dialogs/PermissionDialog.ts 强制每个权限请求回答三个问题(见 src/dialogs/PermissionDialog.ts#L17-L29):
- 需要这个权限吗?(header)
- 为什么需要?(why)
- 授权后意味着什么?(what)
以 JavaScript 执行权限为例,src/dialogs/UserScriptsPermissionDialog.ts#L30-L37 明确告知用户:AI 可以读写页面内容、代码运行在带安全防护的隔离环境中、网络访问被阻止以防数据外传、随时可在浏览器设置中撤销。底部是"继续(不授权)"和"授予权限"两个按钮——拒绝是合法路径。
CSP 策略:给数据外传通道上锁
Sitegeist 的 CSP(Content Security Policy)写在 static/manifest.chrome.json#L60-L63,分为两层,各管一摊:
扩展页(extension_pages)——极简白名单
script-src 'self'; object-src 'self'
只允许加载扩展自身的脚本,彻底拒绝第三方资源。
沙箱页(sandbox)——精细化的"栅栏"
default-src 'none':默认拒绝一切资源connect-src只放行 jsDelivr、unpkg、cdnjs、esm.sh 等少数几个静态 CDN,AI 生成的页面无法向任意后端发数据object-src 'none'、base-uri 'none'、form-action 'none':这三条是防止数据外传的关键——禁止插件对象、禁止 base 标签劫持、禁止提交表单,堵死了常见的 XSS 数据渗出通道img-src允许data:与blob:,保证 AI 仍能生成含图片的交互界面
配合声明式网络请求规则 static/cors-rules.json(declarativeNetRequest),扩展只针对 OAuth 授权所需的特定端点(如 auth.openai.com、api.anthropic.com)修改 CORS 响应头,规则是静态的、可被 Chrome 离线审计的,不存在运行时随意改写网络请求的可能。
导航与系统页面防护
REPL 执行前会先用正则扫描代码,凡包含 window.location.href=、location.assign 等直接跳转语句一律拒绝(见 src/tools/repl/repl.ts#L36-L54),强制 AI 走显式的 navigate 工具——每一步跳转对用户可见。
同时,页面覆盖层注入逻辑会先检查目标 URL,遇到 chrome://、chrome-extension://、about: 等系统页面直接放弃注入(src/tools/repl/overlay-inject.ts#L30-L41),避免 AI 代码与浏览器内部页面发生任何接触。
数据主权:本地存储 + 透明代理
Sitegeist 的全部数据(会话、设置、API 密钥、技能库)存放在浏览器本地 IndexedDB 的 sitegeist-storage 数据库中(详见 docs/storage.md 与 src/storage/app-storage.ts),没有任何云端同步,没有任何埋点统计——官方描述是:"Your data stays on your machine. Nothing is collected or tracked."
唯一涉及第三方网络的是可选的 CORS 代理(详见 docs/proxy.md),且遵循"最小中转"原则:
- 仅 Z-AI 与 Anthropic OAuth 令牌场景才走代理,OpenAI、Gemini 等直连
- 文档提取"先直连、失败才回退代理"
- 默认代理声明不保留、不记录数据,用户可一键关闭或换成自建代理
费用与会话数据同样本地可见、可审查,用户始终掌握自己花了多少钱、AI 做了什么:
安全设计清单:一张表看懂
| 防线 | 机制 | 关键文件 |
|---|---|---|
| 沙箱隔离 | 官方 sandbox 页 + 先验证后执行 | static/sandbox.js |
| 权限控制 | activeTab 最小授权 + 可撤销的显式对话框 | src/dialogs/PermissionDialog.ts |
| CSP 策略 | 双层 CSP + connect-src 白名单 + 封表单/base | static/manifest.chrome.json |
| 导航管控 | 拒绝直接跳转,强制走可见的 navigate 工具 | src/tools/repl/repl.ts |
| 数据主权 | 本地 IndexedDB,零跟踪,代理透明可控 | docs/storage.md |
总结
Sitegeist 的安全设计给出了一条值得所有"AI 进浏览器"项目参考的路径:不信任 AI 生成的代码,但通过隔离、授权与透明来让它可控地工作。沙箱保证"跑坏了也不伤及扩展",CSP 保证"数据出不去",权限对话框保证"每一步你都知情且可拒绝",本地存储保证"什么都带不走"。这正是"为协作而生,而非自主剧场"这句话在工程上的落地。



