基礎設定

如何設定 config.yaml

可在圖形介面（TUI）的 Configuration → 一般設定 直接修改（推薦）；也可手動編輯 config/config.yaml。

💡 實際設定檔位置放在 C:\Users\{username}\AppData\Roaming\mailslide\config\config.yaml

llm_mode: per_plugin
plugin_modules:
  - custom_plugins.my_plugin_module

jobs:
  - name: "我的工作"
    account: "[email protected]"
    source: "收件匣"
    destination: "收件匣/processed"
    manual_review_destination: "收件匣/manual_review"
    batch_flush_enabled: true
    limit: 10
    plugins:
      - add_category

設定項	說明
name	工作名稱（隨意命名）
enable	是否啟用此工作（true/false，預設 true）
account	Outlook 帳號 Email 或資料檔案(pst)名稱
source	來源資料夾（如「收件匣」）
destination	處理後移動到（可省略，若省略則郵件不會移動，可能重複處理，單純測試時可不加）
manual_review_destination	LLM 無 action（skipped）或失敗（failed/retriable_failed）時移動到人工判斷資料夾（可省略）
limit	處理的郵件數量
llm_mode	LLM 呼叫模式（per_plugin 預設；share_deprecated 為舊模式）
plugin_modules	額外 plugin 模組路徑清單（啟動時動態 import，供註冊自訂 plugins）
ui_language	介面語言（zh-TW / en-US，預設 en-US）
batch_flush_enabled	Job 級批次寫入開關（預設 true；影響部分寫檔模組）
plugins	啟用的插件清單（可省略）

💡 提示：若使用 move_to_folder 插件讓 LLM 決定移動目錄，則可省略 destination，由插件負責移動。

LLM 呼叫模式

• per_plugin（預設）：每個需要 LLM 的 plugin 各自呼叫一次 LLM，適合多 plugin 混用。
• share_deprecated（舊模式）：同一封郵件只呼叫一次 LLM，回覆共用給所有 LLM plugins。此模式容易因 action 不同造成 action_mismatch/skipped，不建議新設定使用。

llm_mode 可設在：

• 全域：config.llm_mode
• 單一 Job 覆蓋：job.llm_mode

向後相容：舊值 shared / shared_legacy 仍可執行，但會被視為 share_deprecated 並記錄警告。

設定 LLM（可選）

若要使用整合 AI 分析功能的 plugins，建議在 TUI 的 Configuration → LLM 設定 編輯；也可手動修改 config/llm-config.yaml：

api_base: "http://localhost:11434/v1"
api_key: "your-api-key"
model: "llama3"

支援 Ollama、LM Studio 等 OpenAI 相容的 API 格式。