跳转到内容

可选 AI 输入

AI 输入是可选的:不开启时,输入法只做本地拼音解码,不发出任何网络请求。这一页讲怎么开、开完能做什么、以及密钥放在哪里。数据边界的结论写在隐私与数据,这里不复述。


  • 默认关闭。打开的是设置 → 拼音 → 启用AI输入。
  • 打开之后,云端只参与「精排 / 续写」这一环。每个按键仍先由本地给出候选,断网、超时或关闭都不改这一帧的结果。
  • 密码框等特殊输入框的处理规则见隐私与数据;云端返回的结果不会直接写进你的用户词或记忆。

设置 → 拼音,勾选「启用AI输入」后填三项:提供商、API 地址、模型。

「提供商」是一个便捷预设,选中即帮你填好地址与模型名,都可以再手改;任何 OpenAI 兼容接口都能接。

提供商预填 API 地址预填模型
DeepSeek(默认)https://api.deepseek.com/v1/chat/completionsdeepseek-chat
通义千问https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completionsqwen-plus
OpenAIhttps://api.openai.com/v1/chat/completionsgpt-4o-mini
Grokhttps://api.x.ai/v1/chat/completionsgrok-4.6
本地http://127.0.0.1:11434/v1/chat/completionsllama3
其他不覆盖,按你填的走按你填的走

「本地」这一档对应本机监听的 OpenAI 兼容端点(例如 Ollama)。本地服务可以不设置密钥。


密钥不写进配置文件,而是通过设置窗口保存到 Linux 桌面的 Secret Service(GNOME Keyring / KWallet):在「API 密钥」里输入新值后点「保存密钥」,「删除密钥」清除,旁边的状态行显示当前是否已存在该提供商的条目。

  • 没有可用的密钥环时,云端请求不会发送,本地拼音输入不受影响。
  • 不要把密钥放进命令行参数、环境变量或日志,也不要用会读取密钥内容的命令去「验证」。
  • 想确认用户会话能不能看到 Secret Service:
Terminal window
busctl --user list --no-pager | grep -F org.freedesktop.secrets
command -v secret-tool

第一条没有输出时,检查桌面会话的 D-Bus 与密钥环服务是否已启动并解锁;第二条只用来确认诊断工具装没装。


续写是独立开关:设置 → 拼音 → 启用 Ghost 续写,它依赖「启用AI输入」已经打开。同一页可以调:

项范围与默认
续写防抖(ms)0–2000,默认 300:停顿多久才开始请求
Ghost 最低置信度0–1,默认 0.6:低于这个分不显示
流式续写默认开
续写上下文脱敏默认开
优先端侧精排(关闭则直走云端)默认开

上下文窗口取光标前后各约 800 字。


停顿时建议行可能出现灰色建议,并标着「来自云端」。

  • 按 Tab 采纳。
  • 继续打字就等于拒绝,不需要额外按键,也不会打断你正在组合的拼音。
  • 建议行与本地候选分得很清楚:本地结果标「来自本地」,云端结果标「来自云端」。

提示密钥环不可用 确认当前桌面会话已启动并解锁 GNOME Keyring 或 KWallet,然后重开设置窗口重试。诊断命令见上面第 3 节。没有密钥环时,普通拼音输入照常可用,只是云端不会发请求。

显示「已配置」,但一条建议也没有 「已配置」只说明密钥环里存在该提供商的条目,不代表密钥仍然有效。请核对提供商、模型与 API 地址是否与服务商当前的一致,检查密钥是否有效、账户是否有可用额度;必要时重新保存一次密钥。