产品架构一览
本页说明
本页用于帮助你快速理解 Ghast AI 由哪些部分组成、这些部分分别负责什么，以及在日常使用中你需要关心哪些边界。
Ghast AI 不是单一插件，也不是单一本地程序。当前产品由浏览器扩展、本地 Companion 服务和远端账号 / 模型能力共同组成。
产品由什么组成
| 组件 | 你会看到什么 | 主要作用 |
|---|---|---|
| Ghast AI 扩展 | Chrome 侧边栏 | 对话、记忆、技能、钱包、模型、设置 |
| Ghast Companion | 本地服务 | 工作区访问、本地命令、MCP、诊断、自检等高级能力 |
对大多数用户来说，可以先这样理解：
- 扩展负责你在浏览器里直接使用的大部分功能。
- Companion 负责把浏览器做不到的本地能力补上。
不安装 Companion 时能做什么
即使没有安装 Companion，当前扩展仍然可以完成这些工作：
- 登录和激活账号
- 在侧边栏中聊天
- 管理钱包
- 管理记忆
- 导入和管理技能
- 选择模型与查看充值相关状态
- 在受支持站点上读取页面上下文
这意味着 Ghast AI 的基础使用路径并不依赖 Companion。
安装 Companion 后会多出什么
安装 Companion 之后，Ghast AI 才能成为真正的“AI助手完全体”，包括：
- 连接工作区
- 访问本地命令运行环境
- 托管和使用 MCP Servers
- 运行更高级的代码代理或本地 Agent 能力
- 查看本地诊断、自检和修复状态
- 在浏览器离线或重连场景下补齐部分本地任务能力
如果你只需要浏览器内的基础使用体验，可以先不安装 Companion；如果你需要文件、命令、MCP 或更强的自动化能力，Companion 就是必要组件。
三部分是怎样配合工作的
浏览器扩展
浏览器扩展是产品的主入口。你在侧边栏中看到的 Chat、Memory、Skills、Settings 都属于扩展本体。
本地 Companion
Companion 是扩展之外的本地服务。它存在的原因很直接：浏览器本身无法安全、稳定地承担本地文件、命令和 MCP 这类能力。
因此，Companion 的定位不是“另一个界面”，而是“浏览器外的本地能力层”。
远端服务
远端服务主要承担账号和网络侧能力，例如登录、激活、模型发现和部分远端状态同步。它不是本地执行环境，也不会替代你的本机边界。
使用时最需要记住的边界
| 边界 | 当前含义 |
|---|---|
| 浏览器边界 | 扩展是主入口，但浏览器内能力天然受限 |
| 本地边界 | Companion 提供本地能力，但是否放开范围取决于当前权限模式 |
| 页面边界 | 页面上下文只在受支持站点和受支持模式下采集 |
| 钱包边界 | 钱包由扩展本地管理，不托管到 Companion |
| 账号边界 | 登录和激活依赖远端服务，但不等于远端直接获得本地执行能力 |
默认使用路径
对于通过标准方式安装产品的用户，当前默认路径通常是：
- 安装扩展并登录。
- 完成邀请码激活。
- 创建或导入本地钱包。
- 按需安装 Companion。
- 如果安装 Companion，默认先以
workspace模式使用，而不是直接放开整台机器。
这条默认路径的设计目的，是让大多数用户先获得可用能力，再逐步打开更强的本地能力，而不是一开始就把所有边界放宽。
这页对使用手册意味着什么
阅读后续文档时，可以始终用下面的方式理解整个产品：
- 看浏览器内功能，重点看扩展章节。
- 看本地能力，重点看 Companion 章节。
- 看权限和风险边界，重点看 Security 章节。
这也是 Ghast AI 手册后续结构的基础：先讲产品组成，再讲功能路径，再讲安全边界，而不是从内部实现细节开始。