Ghostlight 为兼容的 AI 智能体提供一个在你已使用的 Chromium 浏览器中的可见工作空间，本地优先，可选策略与审计。
用途
当智能体需要操作一个你已登录的页面时，常见做法是启动第二个空白浏览器，它不了解你的任何会话，且模型必须学习 Chrome 内部机制才能完成工作。Ghostlight 则在你已打开的 Chromium 中为智能体分配一个标签组，工作过程就在你眼前进行：你可以观看、暂停、接管或结束会话。模型表达意图，Ghostlight 负责浏览器部分。
可让智能体读取页面、填写表单、处理文件、跟随弹窗，或调查失败的 Web 工作流。Ghostlight 跨标签页和浏览器变化携带任务，同时将浏览器工作及其控制保留在你的机器上。
主要能力
- 24 个目录工具：23 个浏览器工具，覆盖标签页、导航、读取页面、截图、语义点击与悬停、表单输入、文件上传、脚本、等待、短流程、对话框、诊断和工作区切换；另有 1 个策略工具，用于解释当前生效的权限。
- 每次调用一个真实答案：说明发生了什么、浏览器中有什么变化、什么已就绪、再次运行是否安全。Ghostlight 自己撰写该答案，而非页面；最多自行添加两个恢复步骤。当效果不确定时会明确说明，而不是猜测，也绝不提议可能重复提交表单的重放。
- 桌面工作台：位于托盘，实时显示工作过程。
- 本地运行：Ghostlight 以你的身份运行，通过本地 IPC 访问浏览器，并保留无负载的本地记录。无账号、无遥测、无激活服务、无更新 ping、无托管控制平面、无第二个隐藏浏览器。唯一的网络流量是你所请求的浏览。
使用方式
环境要求
需要 Chrome、Edge、Brave 或 Chromium 125+，一个 MCP 客户端，以及用于安装器的 Node.js。之后运行的服务是原生 Rust。
安装
安装 Ghostlight 并注册它找到的 MCP 客户端：
npx -y ghostlight install
从 Chrome 应用商店添加 Ghostlight in Browser。
如果 MCP 客户端不支持热重载工具，请重启它。
首次验证
给它一个小的只读任务：
在新 Ghostlight 标签页中打开 https://example.com/，总结页面，并告诉我你使用了哪个标签页。不要点击、输入、提交或更改页面。
浏览器中应出现一个天蓝色的 Ghostlight 组。智能体打开页面、读取它，并说出它使用的确切标签页。这一个提示即可证明整个连接，而无需授权点击或写入。下次它会复用该组以及它在该站点已拥有的最近标签页，因此重复工作不再弄乱你的标签栏。
如果某一步需要关注，运行：
doctor
它会检查客户端入口、本地服务、浏览器连接和扩展，然后指出下一步操作。安装指南涵盖目标客户端、源码构建、更新、卸载和症状导向的恢复。
从单页到完整工作流
Ghostlight 在浏览器工作有线索可循时表现最佳：
- 从已登录处继续：在你选择的 Chromium 配置文件中打开应用，使用已存在的会话。凭据留在浏览器中。
- 完成交互：导航、填写表单、上传文件、处理对话框、等待页面状态，并将结果从一步带入下一步。
- 跟随浏览器：当站点打开受支持的子标签页，或已知工作区在任务下方变化时，继续工作。
- 查看失败原因：将页面状态、控制台消息和网络请求汇集在一起，使下一步调试基于证据而非猜测。
可从 Codex、Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Zed、OpenCode、Crush 或其他兼容的 stdio MCP 客户端使用相同的浏览器能力。智能体获得结构化页面读取、精确元素引用、有界操作回执和具体恢复指导。它们可随时要求策略工具解释当前生效的权限。
浏览器仍是共享空间
Ghostlight 在你选择的浏览器窗口内的专用天蓝色标签组中工作。页面扫描、点击、输入、拖拽和较长阶段共享一种视觉语言，因此屏幕上的动作都有解释。
可暂停工作区、为精细步骤接管，或停止它。将标签页移到你想要的位置；Ghostlight 跟随工作区，而不是将其弹回。普通标签页保持在智能体拥有集合之外。
关闭标签页需要两个独立的同意：编排器的权限，以及浏览器自身的保留标签页设置（默认开启）。这使发生过的证据保留在你眼前。你自己关闭标签页始终有效。
策略与审计（可选）
个人使用无需策略清单即可完整使用。从完整浏览器引擎开始，完成有用的工作。当工作流需要更强边界时，按 MCP 身份和域名授予 read、action、write 和 execute 能力。添加神圣域名、干运行预检和结构化审计，同时浏览器体验保持不变。治理指南展示操作模型，信任中心提供安全、隐私、连续性、部署和采购证据。
适用场景
- 在已登录的 Chromium 配置文件中操作应用，使用现有会话。
- 完成需要多步交互的浏览器任务：导航、填表、上传、处理对话框、等待状态。
- 跟随站点打开的受支持子标签页或工作区变化。
- 调试失败的 Web 工作流，汇集页面状态、控制台和网络请求。
- 从多种兼容 MCP 客户端（Codex、Claude Code、Cursor、VS Code 等）使用同一浏览器能力。
限制
- 无策略配置时：允许 HTTP(S) 浏览，包括 localhost、回环和链路本地目标。主机限制属于策略。非 HTTP 方案和过期句柄仍受限制。可选的本地和托管策略层只能收回能力。
- 凭据输入：需要你的明确指示。填充和输入接受智能体的每请求确认；没有确认时，调用返回指导而不暂停会话。该确认不能覆盖策略或你的暂停/停止控制。重复的策略拒绝也不会影响后续被允许的工作。
- 浏览器消息和动画：保持被动，没有按钮，不干扰你的输入；交互式运行时控制属于工作台。
- 审计记录：包含标识符、决策和内容最小化的度量：运行了哪个工具、权限是否允许、耗时多久、做了什么——3 个字段、1,240 个词、1280x720。操作落地的站点会被命名，因为这回答了你的智能体去了哪里，且已在你自己的标签栏中。路径、查询、片段、页面文本、字段值、截图、选择器、对话框文本绝不进入其中。
- 平台状态：Windows 和 Linux 是受支持的 1.0 平台，已在开发主机的实时浏览器上验证；干净的已安装产品证据通道在发布后继续。macOS 尚无 1.0 制品。
- 扩展状态：Chrome 应用商店列表提供适配器 v1.3.12，在适配器协议 3 下与服务 1.3.14 兼容。服务更新使用固定安装路径和现有注入器；无需扩展更新或重载。
- 构建要求：Rust 1.82 或更新，加上 Chromium 125 或更新用于浏览器验证。
许可与连续性
Ghostlight 完全免费且开源：本仓库中的所有内容，包括治理模块，均为 Apache-2.0 OR MIT。LICENSING.md 解释其覆盖范围。此前的开放核心拆分及其付费层级已由 ADR-0140 撤回。
许可状态从不进入运行时——没有许可检查可到达它。已安装的副本按自身条款继续工作，无需签到，无到期。连续性承诺承载其持久版本。
问题与贡献
可复现缺陷请用 GitHub Issues，问题和想法请用 GitHub Discussions，安全、许可或任何不应公开的事项请发 hello@sylin.org。
