安装与首次运行

安装 Cordy for Chrome（当前为开发者/未打包构建或自分发版本）、固定到工具栏、在首次使用时授予网站访问权限，并添加服务商密钥。

Cordy for Chrome 尚未上架 Chrome 应用商店。在商店页面准备就绪之前，你可以以未打包（开发者）构建的方式，或从自分发的安装包来安装 Cordy。本页覆盖完整的首次运行流程：加载扩展、固定到工具栏、授予所需权限，以及连接模型。

环境要求

Google Chrome 142 或更高版本（或相当版本的 Chromium 浏览器，如 Microsoft Edge）。Cordy 声明的最低 Chrome 版本为 142，在更旧的版本上会拒绝安装，而不是在运行时崩溃。可在 chrome://settings/help 查看你的版本。
若要使用云端模型，需要一个服务商 API 密钥——如果你打算运行本地设备端模型，则完全不需要。
未打包扩展约需 30 MB 磁盘空间。

获取构建包

你拿到的 Cordy 通常是以下两种形式之一：

一个文件夹，其中包含 manifest.json（已解包的构建），或
一个 .zip 压缩包——请先将其解压到一个你不会删除或移动的文件夹。Chrome 从磁盘上的文件夹加载未打包扩展，因此如果之后移动或删除该文件夹，扩展就会失效。

如果你从源码构建，请运行项目的构建命令，并将生成的 .output/chrome-mv3 文件夹作为未打包扩展使用。

加载到 Chrome

打开 chrome://extensions（在地址栏输入，或依次进入 ⋮ 菜单 → 扩展程序 → 管理扩展程序）。
打开右上角的开发者模式开关。
点击加载已解压的扩展程序。
选择包含 manifest.json 的文件夹（解压后的文件夹，或 .output/chrome-mv3）。
Cordy 会出现在扩展列表中，名为 Cordy — AI Assistant & Tools。

如果 Chrome 报告 manifest 或版本错误，几乎都是因为你的 Chrome 版本低于 142——请升级 Chrome 后重试。

没有「读取你的所有数据」警告

你会注意到安装提示异常安静：没有「读取和更改你在所有网站上的所有数据」的警告。这是有意为之。Cordy 在安装时只请求一小组常驻权限（侧边栏、存储、标签页，以及标签页管理所需的机制）。对页面内容、历史记录和书签的访问都是可选的，会在稍后由你点击按钮时才请求——绝不会在安装时悄悄获取。完整说明见隐私与权限。

将 Cordy 固定到工具栏

点击 Chrome 工具栏中的扩展程序拼图图标。
在列表中找到 Cordy，点击旁边的固定图标。

Cordy 图标现在会常驻显示。点击它即可切换侧边栏。

打开侧边栏

点击已固定的 Cordy 图标，或使用快捷键：

平台	快捷键
Windows / Linux	`Ctrl` + `Shift` + `Y`
macOS	`Cmd` + `Shift` + `Y`

侧边栏会停靠在当前窗口的右侧。如果你需要更大的空间，也可以从侧边栏顶部把 Cordy 作为一个完整的浏览器标签页打开。

授予网站访问权限（首次使用）

聊天和大多数面板功能开箱即用。但页面内功能需要获得在你访问的网站上运行的权限，涵盖：

悬浮划词菜单（翻译 / 解释 / 总结 / 朗读），
页面内的翻译、解释与总结结果，
网页朗读，
页面命令面板，以及
将当前页面内容读入聊天。

要启用它们，请打开设置 → 通用 → 页面内功能并点击启用，然后同意 Chrome 的权限提示。（你也可以从侧边栏出现的「解锁页面内 AI 功能」卡片触发。）授权后，Cordy 会注册其页面内脚本，功能立即生效——无需刷新页面。

你可以随时在同一设置项中撤销此权限。关闭后，Cordy 将不再在页面上运行；聊天等面板功能不受影响。

升级之后： 由于网站访问是按安装授予的可选权限，重大升级可能会将其重置。如果 Cordy 更新后页面内功能停止工作，请在设置 → 通用 → 页面内功能中重新启用一次。

按需请求的可选权限

少数功能会在你首次使用时才请求各自的 Chrome 权限，此前不会：

历史记录——当你首次打开浏览历史视图或用 @ 提及历史时。
书签——当你首次打开 AI 书签管理器或同步书签时。
站点数据清理——当 AI 或命令面板首次清除某站点的缓存 / Cookie 时。

每一项都从可见的按钮发起请求，也都可以拒绝。拒绝只会让该功能保持停用，直到你授权为止。

连接模型

最后一步是告诉 Cordy 使用哪个 AI。

打开设置 → AI 配置 → API 服务商。
选择一个服务商（OpenRouter、OpenAI、Anthropic、Google AI、xAI、Vercel AI Gateway 或火山方舟），粘贴入你自己的 API 密钥。可选择设置自定义 Base URL，或添加一个自定义的 OpenAI 兼容服务商。
切换到 AI 配置 → 场景模型路由，选择一个对话模型。

完整细节，包括在哪里获取各服务商的密钥，见服务商与模型。若要完全跳过云端服务商，可改为设置本地设备端 AI。

首次发送云端消息会触发一次性的隐私知情同意弹窗——同意一次即可继续。

自定义键盘快捷键

Cordy 的全局快捷键（切换侧边栏、打开命令面板、收纳标签页、打开扩展菜单）由 Chrome 管理。要更改它们，请打开 chrome://extensions/shortcuts，或使用设置 → 快捷键 → 在 Chrome 中自定义。完整快捷键列表见常见问题。

卸载

右键点击 Cordy 图标并选择从 Chrome 中移除，或从 chrome://extensions 移除。由于所有内容都保存在本地，移除扩展会删除其设备端数据。若想保留对话与书签，请先在设置 → 数据管理 → 备份数据中导出。

下一步

快速开始——五分钟上手导览。
聊天——深入了解侧边栏聊天。
隐私与权限——每项权限的作用以及如何撤销。