常见问题
使用相关
划词后没有弹出图标？
请检查以下几点：
- 确认扩展已启用：打开
chrome://extensions（或对应浏览器的扩展页面），确认 ClueLens 状态为「已启用」 - 刷新页面：安装或更新扩展后，需要刷新已打开的页面才能生效
- 特殊页面不可用：浏览器内部页面（如
chrome://、edge://、about:）和扩展商店页面不支持内容脚本 - 检查是否被其他扩展冲突：如果安装了其他划词翻译扩展，可能会产生冲突
某个词典一直显示「加载中」或报错？
- 网络问题：部分数据源需要访问外部 API，请检查网络连接
- API 配额：彩云小译、DeepLx、OpenAI 等可能有使用限制
- 404 错误：如果查询的词不在该词典中，会返回空结果，这是正常行为
如何只使用特定词典查询？
在设置 → 字典标签页中，关闭不需要的数据源即可。也可以开启语言检测功能，让 ClueLens 根据输入文本语种自动筛选。
侧边栏如何打开？
有三种方式：
- 右键菜单：在网页上右键 → ClueLens → 打开侧边栏
- 键盘快捷键：在浏览器扩展快捷键设置中绑定（默认未设置）
- 通过弹窗：点击工具栏 ClueLens 图标打开弹窗
API 配置
彩云小译的 Token 怎么获取？
- 访问 彩云科技开放平台
- 注册账号
- 在控制台中创建应用即可获取 Token
- 在 ClueLens 设置 → 字典 → 彩云小译中填入 Token
ClueLens 内置了默认 Token，不配置也可以使用，但建议注册自己的 Token 以获得更稳定的服务。
DeepLx 怎么配置？
DeepLx 支持两种方式：
- DeepL 官方 API：前往 DeepL API 注册，在设置中填入 API Key
- DeepLx 代理：自建或使用第三方 DeepLx 服务，在设置中填入自定义端点 URL 和 Key（如果需要）
OpenAI 的 API Key 怎么获取？还能用其它大模型吗？
- 访问 OpenAI Platform
- 登录或注册账号
- 在 API Keys 页面创建新密钥
- 在 ClueLens 设置 → 字典 → OpenAI 中填入 API Key 并填入模型（如
gpt-4o-mini）
💡 使用其它大模型 (DeepSeek, 阿里通义, Ollama 等): ClueLens 的 OpenAI 词典模块支持任何兼容 OpenAI 格式的 API。你只需：
- 申请对应平台的 API Key
- 在 ClueLens 设置中将 BaseURL 修改为该平台的终点（例如
https://api.deepseek.com/v1） - 填入对应的模型名称（例如
deepseek-chat） - 填入 API Key 即可。 如果使用本地无鉴权模型（如本地启动的 LM Studio 或 Ollama），API Key 可随意填写。
注意
选用付费 API 时请注意看管额度。推荐使用便宜或免费的模型进行日常查词。
兼容性
支持哪些浏览器？
| 浏览器 | 支持情况 |
|---|---|
| Chrome | ✅ 完全支持 |
| Edge | ✅ 完全支持 |
| Brave | ✅ 支持（Chromium 内核） |
| Firefox | ✅ 支持 |
| Safari | ❌ 不支持 |
移动端浏览器支持吗？
目前不支持。ClueLens 仅适用于桌面浏览器。
数据与隐私
数据保存在哪里？
所有数据（设置、生词本）均保存在浏览器本地存储（browser.storage.local）中，不会上传到任何服务器。
如何备份数据？
在设置页面中使用导出设置功能，可以将全部配置导出为 JSON 文件。详见 设置说明 → 备份与恢复。
卸载扩展后数据会丢失吗？
是的。卸载浏览器扩展会清除本地存储中的所有数据。建议在卸载前先导出设置和生词本。
查词请求会发送到哪里？
查词时，ClueLens 会将你选中的文本发送到对应词典/翻译服务的 API。具体包括：
- 各词典的官方 API 或网页（Bing、Jisho、DictionaryAPI 等）
- 翻译服务 API（Google Translate、彩云小译、DeepL）
- OpenAI API（如果启用）
ClueLens 本身不收集、不存储、不转发任何查询数据。