AI 助手
========

JEditor 整合了基於 `LangChain <https://www.langchain.com/>`_ 和 OpenAI 相容 API 的
AI 聊天助手。AI 面板讓您可以直接在編輯器內與大型語言模型對話。

設定
-----

使用 AI 助手前，您需要先進行設定：

1. 從選單開啟 AI 設定對話框
2. 設定以下參數：

.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - 設定項目
     - 說明
   * - **API Base URL**
     - API 端點（例如 ``https://api.openai.com/v1``）
   * - **API Key**
     - 您的 OpenAI API 金鑰
   * - **Model**
     - 使用的模型（例如 ``gpt-3.5-turbo``、``gpt-4`` 或任何自訂模型）
   * - **System Prompt**
     - 設定 AI 行為與上下文的範本

設定會儲存到 ``.jeditor/ai_config.json``，在不同工作階段之間持續保留。

您也可以透過環境變數設定 API 金鑰。

聊天介面
---------

AI 聊天面板提供：

- **訊息歷史** — 可捲動的聊天歷史，包含所有先前的訊息
- **輸入欄位** — 在面板底部輸入提示詞
- **字型大小調整** — 自訂聊天面板的字型大小
- **唯讀訊息區域** — 聊天歷史以唯讀方式顯示

非同步通訊
-----------

AI 請求以非同步方式處理，保持編輯器的回應能力：

- 訊息在背景執行緒中傳送給 AI
- 回應透過可設定的計時器間隔拉取回來
- 訊息佇列確保有序通訊
- 等待回應期間 UI 保持完全互動

錯誤處理
---------

如果 AI 請求失敗（例如網路錯誤、無效的 API 金鑰），JEditor 會顯示清楚的錯誤對話框
描述問題。解決問題後，聊天工作階段可繼續正常使用。