Chromex

在 AI 辅助浏览的时代，我们往往需要在浏览器、聊天窗口和本地文件之间频繁切换。Chromex 是一个基于 Chrome MV3 架构的侧边栏助手，它通过本地原生桥接器（Native Messaging Host）将 Chrome 浏览器直接与 Codex 连接起来。

Chromex 不仅让你能与当前页面、选中标签页、上传文件、语音输入及图像进行自然对话，更关键的是，它将所有敏感凭证排除在扩展存储之外，确保数据隐私与安全。

核心功能：全场景 AI 交互

深度页面感知与多标签协作

• 智能聊天：与当前网页、任意选中的打开标签页、截图、PDF、Office 文档及浏览器历史记录进行上下文感知的对话。
• 内容总结与比较：一键总结 YouTube 视频、新闻文章、研究论文（如 arXiv）、PDF 文档，并支持跨页面内容比较。
• @ 选择器：使用 @ 符号快速选择一个或多个打开的标签页作为上下文，实现多源信息融合。

多模态创作与编辑

• 图像工作流：通过 Codex 图像工作流编辑或生成图像，支持本地输出处理。
• 非破坏性编辑：对上传图像、页面图像或可见屏幕截图进行智能编辑，保留原始画质。
• 语音交互：支持语音转录、实时语音模式，让输入更自然高效。

浏览器自动化与控制

• Content Scripts 驱动：通过 Chrome 内容脚本运行浏览器控制工作流，实现页内操作自动化。
• 站点感知建议：针对 YouTube、新闻、邮件、协作工具、购物、旅行等场景提供智能建议和操作指引。
• YouTube 适配器：提供当前时间戳上下文和查找操作，精准定位视频内容。

可扩展的 Codex 技能

• 技能加载：支持从用户本地的 .codex/skills/*/SKILL.md 加载可选的 Codex 技能，无限扩展助手能力。
• 自定义配置：支持自定义配置文件，满足不同用户的个性化需求。

安全与隐私：设计之初的核心原则

Chromex 将隐私保护置于首位，采用严格的运行时边界：

• 零凭证存储：扩展不在 Chrome 扩展存储中保存任何 OpenAI API 密钥、OAuth 令牌或 ChatGPT 会话令牌。
• 本地化处理：Codex OAuth / ChatGPT 登录通过本地 Codex app-server 流程处理；API 密钥登录仅为可选本地回退，且需用户确认。
• 最小权限原则：仅在功能需要时请求 history、tabs、屏幕捕获、麦克风等权限。
• 会话级历史：对话历史记录默认为会话级别，持久化本地聊天历史记录为可选功能。
• 沙箱环境：原生主机子进程和工作区钩子在缩减的环境允许列表中运行，隔离潜在风险。

技术架构：本地桥接模式

Chromex 采用以下通信链路，确保高效与安全：

Chrome Extension (MV3) -> Native Messaging Host -> Local Bridge -> codex app-server

• packages/extension：Chrome MV3 侧边栏扩展，负责 UI 交互与权限管理。
• packages/bridge：本地桥接守护进程，处理 Codex app-server 通信及多模态工作流。
• packages/native-host：Chrome Native Messaging 中继，实现扩展与本地位进程的通信。
• packages/shared：共享类型、策略、配置文件和辅助函数。

快速开始：从源码安装

由于安全考量，GitHub Releases 仅提供源代码。请按照以下步骤构建并安装：

1. 前置要求

• Node.js：20 LTS 或更新版本。
• Codex CLI：全局安装 @openai/codex。

  npm install -g @openai/codex
  codex --version
  

2. 构建与安装

# 克隆仓库
git clone https://github.com/GENEXIS-AI/chromex.git
cd chromex

# 安装依赖并构建
npm install
npm run build

# 安装原生桥接器（Windows 需指定浏览器）
node scripts/install-native-host.mjs --browser=chrome

3. 加载扩展

1. 打开 Chrome，访问 chrome://extensions。
2. 启用右上角的**“开发者模式”**。
3. 点击**“加载已解压的扩展”**，选择 packages/extension/dist 目录。
4. 在 Chromex 侧边栏中点击**“检查连接”**，确认与本地桥接器通信正常。

注意：如果 Chrome 显示的扩展 ID 与默认 ID (menmlhahmendmkiicbjihgjhppkgaeom) 不同，请使用实际 ID 重新运行安装脚本：
node scripts/install-native-host.mjs <your-extension-id> --browser=chrome

语言支持

Chromex 默认自动跟随浏览器语言，并支持英语、中文、日语、韩语、法语、德语、西班牙语等数十种语言界面。模型响应也会根据所选 UI 语言进行调整，除非用户特别指定其他语言。