> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 常見問題

> 處理安裝、供應商、CLI 檢測、冷啟動和自動更新等常見問題。

按你看到的提示往下對。還是不行，把復現步驟發到 [GitHub Issues](https://github.com/zhukunpenglinyutong/desktop-cc-gui/issues)。

## 安裝和開啟

<AccordionGroup>
  <Accordion title="從哪裡下載">
    開啟 [Releases](https://github.com/zhukunpenglinyutong/desktop-cc-gui/releases)，按平臺選擇 `dmg` / `exe` / `AppImage`。
  </Accordion>

  <Accordion title="開啟後不知道從哪開始">
    先 **新增新專案**，再在設定裡配供應商，然後發第一條訊息。見 [發出第一條訊息](/zh-Hant/desktop/start/first-task)。
  </Accordion>
</AccordionGroup>

## 供應商和 CLI

<AccordionGroup>
  <Accordion title="提示未配置供應商">
    開啟 **設定 → CLI配置管理**，為當前引擎新增供應商、使用本地配置，或先安裝對應 CLI。
  </Accordion>

  <Accordion title="CLI 一直顯示未安裝">
    客戶端不會靜默代裝。可在 **CLI配置管理** 裡點 **安裝**（先確認計劃），或先在系統終端確認命令可用，再回到設定重新檢測。GUI 啟動的程序可能讀不到 shell `PATH`，把路徑寫入系統環境變數後重啟客戶端。詳見 [檢測與安裝](/zh-Hant/desktop/providers/cli)。
  </Accordion>

  <Accordion title="設定裡看到 Gemini 卻配不了">
    Gemini 等引擎當前在「暫未開放」分組。README 裡「Gemini 預設啟用」的表述已過時，以設定頁為準，不要按已交付 runtime 排查。
  </Accordion>

  <Accordion title="配置檔案在哪">
    供應商目錄在 `~/.ccgui/config.json`。Claude 託管供應商只寫這裡，不改 `~/.claude/settings.json`（本地官方配置可選用）。Codex 啟用後寫入 `~/.codex/`。Kimi / Grok 啟用第三方會寫入各自 `config.toml`（先備份 `.bak`）。OpenCode 託管供應商走環境注入，不改 `opencode.json`。Pi 寫 `~/.pi/agent/auth.json`。DSH 的模型和 Key 在 Web UI / `$DSH_HOME`，不進 CC GUI。客戶端設定與工作區在應用 data 目錄。
  </Accordion>
</AccordionGroup>

## 效能和冷啟動

<AccordionGroup>
  <Accordion title="Windows 安裝後前幾秒點不動">
    較新版本已修復冷啟動點選假死。請升級到最新版；版本記錄會延後到 startup-gate-ready 後再彈出。
  </Accordion>

  <Accordion title="長會話越來越卡">
    客戶端對長會話做了 DOM 視窗與增量 Markdown。仍卡時，新開會話或摺疊舊訊息，並升級到最新版。
  </Accordion>

  <Accordion title="介面縮放調不了">
    產品側已永久鎖定 100% UI scale，以避免 WebView 假死路徑。這是預期行為。
  </Accordion>
</AccordionGroup>

## 更新

<AccordionGroup>
  <Accordion title="如何更新">
    客戶端內建自動更新。也可以從 Releases 手動下載新安裝包覆蓋安裝。
  </Accordion>
</AccordionGroup>