可选 AI 输入
AI 输入是可选的:不开启时,输入法只做本地拼音解码,不发出任何网络请求。这一页讲怎么开、开完能做什么、以及密钥放在哪里。数据边界的结论写在隐私与数据,这里不复述。
1. 开启前要知道的三件事
Section titled “1. 开启前要知道的三件事”- 默认关闭。打开的是设置 → 拼音 → 启用AI输入。
- 打开之后,云端只参与「精排 / 续写」这一环。每个按键仍先由本地给出候选,断网、超时或关闭都不改这一帧的结果。
- 密码框等特殊输入框的处理规则见隐私与数据;云端返回的结果不会直接写进你的用户词或记忆。
2. 接上一个接口
Section titled “2. 接上一个接口”设置 → 拼音,勾选「启用AI输入」后填三项:提供商、API 地址、模型。
「提供商」是一个便捷预设,选中即帮你填好地址与模型名,都可以再手改;任何 OpenAI 兼容接口都能接。
| 提供商 | 预填 API 地址 | 预填模型 |
|---|---|---|
| DeepSeek(默认) | https://api.deepseek.com/v1/chat/completions | deepseek-chat |
| 通义千问 | https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions | qwen-plus |
| OpenAI | https://api.openai.com/v1/chat/completions | gpt-4o-mini |
| Grok | https://api.x.ai/v1/chat/completions | grok-4.6 |
| 本地 | http://127.0.0.1:11434/v1/chat/completions | llama3 |
| 其他 | 不覆盖,按你填的走 | 按你填的走 |
「本地」这一档对应本机监听的 OpenAI 兼容端点(例如 Ollama)。本地服务可以不设置密钥。
3. API 密钥放在哪里
Section titled “3. API 密钥放在哪里”密钥不写进配置文件,而是通过设置窗口保存到 Linux 桌面的 Secret Service(GNOME Keyring / KWallet):在「API 密钥」里输入新值后点「保存密钥」,「删除密钥」清除,旁边的状态行显示当前是否已存在该提供商的条目。
- 没有可用的密钥环时,云端请求不会发送,本地拼音输入不受影响。
- 不要把密钥放进命令行参数、环境变量或日志,也不要用会读取密钥内容的命令去「验证」。
- 想确认用户会话能不能看到 Secret Service:
busctl --user list --no-pager | grep -F org.freedesktop.secretscommand -v secret-tool第一条没有输出时,检查桌面会话的 D-Bus 与密钥环服务是否已启动并解锁;第二条只用来确认诊断工具装没装。
4. Ghost 续写
Section titled “4. Ghost 续写”续写是独立开关:设置 → 拼音 → 启用 Ghost 续写,它依赖「启用AI输入」已经打开。同一页可以调:
| 项 | 范围与默认 |
|---|---|
| 续写防抖(ms) | 0–2000,默认 300:停顿多久才开始请求 |
| Ghost 最低置信度 | 0–1,默认 0.6:低于这个分不显示 |
| 流式续写 | 默认开 |
| 续写上下文脱敏 | 默认开 |
| 优先端侧精排(关闭则直走云端) | 默认开 |
上下文窗口取光标前后各约 800 字。
5. 采纳还是拒绝
Section titled “5. 采纳还是拒绝”停顿时建议行可能出现灰色建议,并标着「来自云端」。
- 按
Tab采纳。 - 继续打字就等于拒绝,不需要额外按键,也不会打断你正在组合的拼音。
- 建议行与本地候选分得很清楚:本地结果标「来自本地」,云端结果标「来自云端」。
6. 两个常见问题
Section titled “6. 两个常见问题”提示密钥环不可用 确认当前桌面会话已启动并解锁 GNOME Keyring 或 KWallet,然后重开设置窗口重试。诊断命令见上面第 3 节。没有密钥环时,普通拼音输入照常可用,只是云端不会发请求。
显示「已配置」,但一条建议也没有 「已配置」只说明密钥环里存在该提供商的条目,不代表密钥仍然有效。请核对提供商、模型与 API 地址是否与服务商当前的一致,检查密钥是否有效、账户是否有可用额度;必要时重新保存一次密钥。