安装与首次运行

安装已发布的 2.4.4 压缩包或 2.4.5 源码构建，授予可选权限，并连接模型。

Cordy for Chrome 以未打包扩展方式安装。最新已发布 GitHub Release 为 2.4.4；源码与仓库标签为 2.4.5，但没有对应的已发布 Release。访问仓库及其 Release 需要仓库权限。

环境要求

Google Chrome 148 或更高版本。 这是清单声明的最低版本。可在 chrome://settings/help 查看版本。
若要使用云端模型，需要一个服务商 API 密钥——如果你打算运行本地设备端模型，则完全不需要。
未打包扩展约需 30 MB 磁盘空间。

获取构建包

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

一个文件夹，其中包含 manifest.json（已解包的构建），或
已发布的 cordy-2.4.4-chrome.zip Release 资产——解压到一个会长期保留的文件夹。Release 还提供 checksums-2.4.4.txt 用于校验完整性。

对于 2.4.5 源码，请运行仓库构建命令，再加载 .output/chrome-mv3。源码标签并不等于已发布二进制 Release。

加载到 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 权限，此前不会：

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

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

连接模型

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

打开仪表盘并进入设置 → AI 配置 → 服务商。
选择一个服务商（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 移除。如果还需要对话记录，请在卸载前导出。数据管理清理与备份会保留书签资料库；删除服务商密钥是单独操作。

下一步

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