常见问题与排障
Cordy for Chrome 常见问题解答——费用、安装与更新、同意弹窗、权限、WebGPU 与本地模型、服务商检测、键盘快捷键,以及反馈渠道。
常见问题与修复方法。若这里没有,底部链接的功能页面会有更深入的说明。
通用
Cordy 免费吗?
扩展本身免费。由于它采用自带密钥,你按使用量直接向你的 AI 服务商付费——如果你运行本地设备端模型,则完全免费。没有 Cordy 订阅或账号。
Cordy 上架 Chrome 应用商店了吗?
是的。请从 Chrome 应用商店安装 Cordy;这是唯一受支持的安装方式,Chrome 会自动更新它。每个公开版本随附的 .zip 用于校验,而不是另一种安装方式。见安装。
如何查看某次更新改了什么?
打开仪表盘侧栏底部的更新记录,或从侧边栏设置中打开。更新说明随扩展打包。中文界面显示中文说明;其他语言显示英文。自 2.5.5 起,每个版本都链接到其公开 Release 页面,全部版本会打开完整列表。更新后,已更新至 v… 提示会提供查看更新和知道了。
新标签页去哪了?
Cordy 2.5.3 移除了自定义新标签页(时钟、壁纸和快捷链接)。搜索位于仪表盘的搜索页面。如果希望浏览器启动时由 Cordy 打开收藏页,请开启设置 → 通用 → 启动 → 浏览器启动时打开收藏页;该选项默认关闭。
支持哪些浏览器和版本?
Chrome 148 或更高版本。 这是扩展清单声明的最低版本。
这个以前是不是叫「Web Nexus」?
是的——Cordy for Chrome 的前身是 Web Nexus,在整个产品中更名为 Cordy。旧文中提到的「Web Nexus」指的就是这款扩展。
我的数据安全吗?
安全。一切都保存在本地,密钥经过加密,提示词直接发往你所配置的服务商,且没有遥测、没有 Cordy 后端。完整模型见 隐私与权限。
设置与服务商
为什么我看到「发送到云端 AI 服务?」弹窗?
那是一次性的云端同意闸门。首次向云端模型发送任何内容时,Cordy 会确认你的文本发往你所配置的服务商(且不发往别处)。同意一次即可;之后可在设置 → 数据管理 → 数据与隐私中撤回。本地模型从不显示它。见 隐私。
提示「AI 功能尚未配置」或未列出任何模型。
尚未接入任何服务商。打开仪表盘 → 设置 → AI 配置 → 服务商配置,添加密钥并点击检测。然后在功能模型下选择聊天模型。见服务商与模型。
某个服务商显示「不可用」或未被检测到。
重新检查 API 密钥和 Base URL,然后再次点击检测。确认该密钥在服务商处有效、且你有网络访问。对于自定义的 OpenAI 兼容端点,记得手动键入其模型 ID——由手动模型列表决定可用的模型。检查模型目录只是诊断工具;即使检查失败,你手动填写的模型仍可使用。
我一定需要 API 密钥吗?
不需要。你可以完全在设备端运行——Chrome 的 Gemini Nano、浏览器内 Gemma,或本地运行时。见 本地与设备端 AI。
网站访问与权限
页面内功能无法使用。
打开设置 → 权限并查看页面内功能。如果显示未启用,请点击启用并同意 Chrome 的提示。聊天和面板功能不受影响;只有页面内功能(划词菜单、网页朗读、命令面板、读取页面内容)才需要它。页面内功能无法在浏览器页面、Chrome 应用商店或扩展页面上运行。
命令面板快捷键没有反应。
当面板无法在当前页面打开时,Cordy 会打开设置 → 权限并提示原因:缺少网站访问权限、页面不是 http 或 https 页面,或页面需要刷新。
为什么 Cordy 没有警告我它能「读取我在所有网站上的所有数据」?
因为它在安装时并不请求该权限。网站访问是可选的,当你选择使用页面内功能时才从按钮授予。见 隐私与权限。
如何撤销权限?
- 网站访问:设置 → 权限 → 页面内功能 → 撤销权限。
- 书签、浏览历史、清除浏览数据:设置 → 权限 → 在对应行点击撤销。
- 云端同意:设置 → 数据管理 → 数据与隐私 → 撤回同意。
本地模型与 WebGPU
本地模型需要什么?
在设置中打开本地 AI(实验性) 并接受风险提示。浏览器内模型(Gemma)和 Kokoro TTS 需要 WebGPU;Gemini Nano 需要启用 Chrome 的 AI 标志。见 本地与设备端 AI。
「WebGPU is required but not available」。
你的浏览器/设备未暴露 WebGPU。请更新 Chrome 和显卡驱动。若仍不可用,请改用 Chrome 内置 AI 或本地原生运行时,而非浏览器内模型。
模型下载卡住或失败。
取消并重试,并确保有足够的可用磁盘空间(Gemma 模型有数 GB)。下载卡住也可能意味着 WebGPU 不可用。
如何启用 Chrome 的 Gemini Nano?
将 chrome://flags/#prompt-api-for-gemini-nano 设为 Enabled,将 chrome://flags/#optimization-guide-on-device-model 设为 Enabled BypassPerfRequirement,重启 Chrome,然后在设置 → 本地 AI 中使用初始化模型。
聊天
如何清空或导出对话?
用 /clear 归档当前对话并重新开始,或用 /export 将其保存为 Markdown。你也可以复制任意单条消息。见 聊天。
我的附件被拒绝了。
附件限制为每条 5 个文件、每个 10 MB,且需要多模态云端模型。本地模型不接受附件——请切换到云端模型或移除文件。
回复超时了。
与后台工作进程的连接被中断。请重新发送;若持续出现,请在面板的错误界面点击重新加载侧边栏。
键盘快捷键
全局(由 Chrome 管理,可在 chrome://extensions/shortcuts 重新映射)
| 操作 | Windows / Linux | macOS |
|---|---|---|
| 切换侧边栏 | Ctrl + Shift + Y | Cmd + Shift + Y |
| 打开命令面板 | Ctrl + Shift + P | Cmd + Shift + P |
| 收纳当前窗口的标签页 | Ctrl + Shift + K | Cmd + Shift + K |
| 打开扩展图标操作 | Ctrl + Shift + L | Cmd + Shift + L |
聊天与对话标签页
| 操作 | 快捷键 |
|---|---|
| 发送消息 | Ctrl + Enter(默认)或 Enter(可配置) |
| 换行 | Enter 或 Shift + Enter(与你的发送键选择相匹配) |
| 浏览输入历史 | 空输入框中按 ↑ / ↓ |
| 新建对话标签页 | Alt + T |
| 关闭当前标签页 | Alt + W |
| 重新打开刚关闭的标签页 | Alt + Shift + T |
| 跳到第 1–9 个标签页 | Alt + 1 … Alt + 9 |
| 下一个 / 上一个标签页 | Ctrl/Cmd + Tab / Ctrl/Cmd + Shift + Tab |
| 打开命令菜单(输入框内) | / |
| 插入浏览器上下文提及 | @ |
你可以在设置 → 快捷键中更改发送消息的按键。
反馈与支持
可在此报告问题、提出疑问或建议功能。报告问题时,请在设置 → 日志 → 导出 JSON 中导出日志并附上该文件;日志不包含消息、回复与密钥。
安全漏洞请通过 GitHub 安全通告私下报告,不要公开提交 issue。