可選 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 網址是否與服務商目前的相符,檢查金鑰是否有效、帳戶是否有可用額度;必要時重新儲存一次金鑰。