ccgui的Browser Dock内置浏览器Agent让AI打开网页、收集只读上下文的完整用法【免费下载链接】desktop-cc-guiMulti-engine AI coding desktop client (Tauri). Claude Code, Codex, Gemini, OpenCode, DeepSeek Harness and more in one GUI.项目地址: https://gitcode.com/gh_mirrors/co/desktop-cc-guiccgui 是一款多引擎 AI 编程桌面客户端基于 Tauri内置的Browser Dock 浏览器 Agent能帮你在客户端里直接打开网页并把页面的只读上下文URL、标题、正文、链接、按钮等安全地交给 Claude Code、Codex、Gemini、OpenCode 等任意引擎无需复制粘贴也绝不把原始 DOM 或密码类内容泄露给 AI。Browser Dock 是什么为什么叫DockBrowser Dock 是 ccgui 的客户端内置浏览器点击顶部全局工具栏的 Browser Dock 图标就会弹出一个独立的浏览器窗口网页渲染在单独的 WebView 中而不会抢占你的主对话窗口——主窗口里的会话、输入区始终可用两个窗口可以并行工作。它的定位很克制先做可信观察层也就是只读的网页上下文采集而不是高风险的自动点击、自动填表。这个设计决策可以直接在行为契约中读到总契约浏览器窗口、会话、快照、脱敏、只读动作门禁openspec/specs/vibecoding-browser-agent/spec.md页面理解契约快照内容、截断、隐私、陈旧状态openspec/specs/browser-agent-page-understanding/spec.md跨平台降级能力矩阵macOS / Windows / Linux 各自能力边界docs/browser-agent/phase3-cross-platform-degraded-capability-matrix.md如何打开 Browser Dock 并浏览网页打开方式很简单点击顶部全局工具栏上的 Browser Dock 图标独立浏览器窗口随即打开已打开则聚焦到它在地址栏输入http或https网址即可浏览界面会显示 URL、标题、加载与错误状态支持多标签页但底层是单渲染器 激活标签页模型——采集上下文时永远只取当前激活的标签页后台标签不会悄悄混进 AI 上下文。一个实用细节Browser Dock 可以直接打开file://的本地 HTML 文件仅.html/.htm结尾允许其他本地文件类型会被拦截并给出诊断方便预览你项目里的静态页面。窗口默认尺寸足够大普通网页不会因窄视口而变形。让 AI 读懂网页三步完成上下文采集这是 Browser Dock 最核心的用法三步搞定打开页面在 Browser Dock 中加载你要 AI 看的网页文档站、报错页、你自己本地 dev 服务器都行附加上下文选择把当前页面附加到 AI 上下文Composer 输入区上方会出现一张预览卡片展示即将发给 AI 的内容——URL、标题、采集时间、正文摘录、元素数量、截断与脱敏状态而不是一个含糊的已附加标签提问发送直接输入问题比如这个报错是什么意思根据这个 API 文档帮我写调用代码。发送时走的是统一的BrowserContextAttachment结构不会同一份内容既当附件又塞进提示词造成重复。发送前你可以随时刷新或移除这张附加卡片移除后该次 AI 请求就不会再包含这个页面快照。相关实现入口附加逻辑src/features/browser-agent/hooks/useBrowserContextAttachment.tsComposer 预览卡片src/features/browser-agent/components/BrowserContextPreview.tsx证据检视面板src/features/browser-agent/components/BrowserEvidencePanel.tsxBrowser Dock 窗口本体src/features/browser-agent/components/BrowserDock.tsxAI 到底看到了什么快照内容详解快照不是原始 DOM 倒灌而是有边界、有预算的结构化页面事实来源元数据URL、标题、采集时间、工作区归属正文内容有长度上限的可见文本摘录超出预算会自动截断并附截断元数据你和 AI 都能看到被截过语义元素标题、链接、按钮、表单控件、导航区等地标信息角色、可见文本、启用状态帮助模型理解页面结构诊断信息如果某部分内容因平台或页面限制没采全快照会带上降级诊断模型能据此解释不确定性而不是假装看懂了整页。隐私脱敏密码和令牌绝不进 AI这是最该放心的一点快照永远不包含原始 DOM、Cookie、请求头、存储内容、密码值、令牌、Authorization 值、隐藏域、脚本与样式内容。页面上出现密码框或类令牌字段时只会留下该字段已脱敏的元数据UI 上也有隐私状态标识让你能区分已脱敏的上下文和原始页面。只读原则为什么 AI 不能替我点按钮当前阶段的 Browser Agent 是只读的AI 可以请求和消费页面快照但点击、输入、提交表单等改变页面状态的动作会被明确拦截返回 blocked 结果不存在AI 悄悄点了什么的暗箱。后续若开放高风险动作契约要求必须先展示动作预览目标、理由、预期操作、提供取消路径并对每次执行/拦截/失败写入审计记录动作执行与拦截逻辑src/features/browser-agent/actions/browserActionExecution.ts动作审计轨迹界面src/features/browser-agent/components/BrowserActionAuditTrail.tsxURL 策略同样保守默认阻止任意内网地址浏览只有当前工作区显式放行的 localhost / 本地开发源才会进入本地页面理解通道。实战场景从网页到代码的最短路径本地页面 ↔ 代码候选当激活标签页是你工作区里的本地开发页面时快照会基于路由、可见文本、元素地标生成页面到代码的候选映射文件路径 匹配理由 置信度相当于把这个页面对应哪些源码文件直接交给 AI外部网站则不会乱猜代码候选。跨引擎通用同一份浏览器上下文契约适用于 Claude、Codex、Gemini、OpenCode 与自定义 Provider——切换引擎不用重新配置不支持的结构化附件的引擎会走显式的降级路径而不是静默丢上下文。证据可回溯快照会以有界的证据引用形式保留在会话/任务中事后可检视其来源、预算、隐私状态与过期时间证据过期会显示为过期态绝不伪造内容。Browser Dock 设置与常见问题默认开启不需要先跑进设置页开箱即可用如需关闭可在设置中显式禁用禁用后快照不会被注入 AI 请求AI 的浏览器操作也不会再路由给内置 Browser Agent。页面变了附加会标陈旧如果附加后你切换了标签页、URL 变了、滚动超过阈值或快照超过保鲜期预览卡片会标记 stale 并给出刷新入口即使你硬着头皮发送AI 载荷里也会带上 stale 元数据模型不会把旧快照当成当前页面。平台不支持时明示降级若当前平台的 WebView 能力不足Browser Dock 会显示明确的不支持/降级状态不会假装上下文可用。文档索引Browser Dock 相关文档集中在 docs/browser-agent/README.mdPhase 3 实施背景可参考 docs/plans/2026-06-01-browser-dock-phase3.md。延伸阅读想深入看源码整条 Browser Agent 链路窗口生命周期、会话管理、快照采集、标注、代码桥、动作审计都收敛在 src/features/browser-agent/ 目录下配合上文两个 OpenSpec 契约文档足够把AI 是怎么安全地看网页的这件事读透。【免费下载链接】desktop-cc-guiMulti-engine AI coding desktop client (Tauri). Claude Code, Codex, Gemini, OpenCode, DeepSeek Harness and more in one GUI.项目地址: https://gitcode.com/gh_mirrors/co/desktop-cc-gui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考