# 更新日誌

## v0.28.1 (2026-06-26)

> 優化聊天記錄檢視，新增匯入 API，修正匯入、同步與本機模型代理下載問題。

### ✨ 新功能

- 新增 Push 匯入 API，支援依會話追加寫入、去重與增量索引產生
- 匯入完成後自動產生會話索引，涵蓋 CLI、桌面端與 pull sync 匯入流程
- 優化聊天記錄檢視器的控制項與高亮顯示體驗
- 側邊欄預設隱藏捲軸，滑鼠移入時顯示

### 🐛 修復

- 強化 Push/Pull 匯入校驗、去重與並發鎖定，避免異常輸入造成誤寫或重複匯入
- GET /api/v1/sessions/:id 補齊 lastPlatformMessageId 與 importedAt 欄位，支援增量匯入邊界判斷
- 背景 pull sync 完成後自動刷新會話列表
- 修正本機語意索引模型下載未正確使用代理的問題，並補齊 Worker 日誌初始化
- 【桌面端】API 預設連接埠與 CLI 對齊為 3110，連接埠被占用時會自動嘗試後續連接埠
- 【桌面端】系統代理解析支援 HTTP、HTTPS 與 SOCKS 結果，避免本機模型下載靜默繞過代理

### ♻️ 重構

- 【CLI】pull/sync 匯入流程改用共享 streaming importer，移除舊解析與寫入實作
- 【桌面端】移除增量匯入後重複產生會話索引的多餘呼叫

### 📝 文件

- 修正文檔中的 API 連接埠、範例與未實作能力說明

## v0.28.0 (2026-06-25)

> 新增 Google Chat 匯入支援，引入統一應用程式日誌模組，優化語意索引使用體驗。

### ✨ 新功能

- 新增 Google Chat 匯入支援，涵蓋 CLI 與桌面端完整流程
- 新增統一應用程式日誌模組，支援依檔案大小自動輪替與全域未捕獲錯誤記錄
- 語意索引管理改為「移除」操作取代停用，修正 legacy hash，限制清單高度
- 語意索引模型設定儲存時自動預熱，並遷移至 AI 目錄統一管理
- 簡化語意索引設定，移除搜尋結果數量設定項，改用內建預設值

### 🐛 修復

- 補齊 stream-json/stream-chain 相依套件聲明，修正多聊天掃描穿透問題

### 📝 文件

- 文件新增 Google Chat 支援平台說明

## v0.27.2 (2026-06-24)

> 修正 AI auth profile 生命週期管理的多項問題，提升分析服務穩定性，補齊本機嵌入執行環境相依套件。

### ✨ 新功能

- 【CLI Web】透過共享 AnalyticsService 統一回報日活用戶資料

### 🐛 修復

- 刪除 AI 服務設定時同步清除對應的 auth profile

### ♻️ 重構

- 移除已過期的分析設定遷移邏輯

## v0.27.1 (2026-06-23)

> 支援 API 批次向量化加速語意索引建立，改為惰性載入本機模型；修正斷點續跑、同步游標回退與 AI 對話匯出等問題。

### ✨ 新功能

- 語意索引支援 API 嵌入模型批次向量化，大幅提升索引建立速度
- 本機嵌入模型改為惰性 Worker 載入，降低啟動資源消耗

### 🐛 修復

- 修正 AI 對話匯出：支援匯出目前可見的 AI 對話內容
- 修正語意索引批次寫入中途崩潰後，續跑觸發唯一約束錯誤、會話狀態卡住的問題
- 修正語意 Worker 多項問題：設定變更未同步至執行中的 Worker、可用性探針異常影響一般 AI 對話、活躍建立狀態追蹤不準確導致 Worker 提前關閉
- 修正同步拉取游標：空回應重試前未儲存初始頁伺服器水位，導致重複拉取尾端視窗
- 修正同步拉取分頁游標錯誤回退，避免重複匯入

### ♻️ 重構

- 清理多處無效程式碼與過度設計的抽象，簡化工具目錄結構與深層合併邏輯

## v0.27.0 (2026-06-22)

> 新增向量索引與證據檢索功能，支援透過語意搜尋定位並呈現聊天證據，並提供索引管理介面。

### ✨ 新功能

- 新增語意索引管理介面，可選擇指定會話建立向量索引，提供多語言支援
- 新增 retrieve_chat_evidence 工具：AI 可透過語意搜尋檢索帶時間定位的聊天證據
- 規劃器自動辨識證據類問題，路由至語意檢索工具處理
- 證據內容區塊支援展開檢視、折疊收起與點擊跳轉原始訊息
- 語意檢索支援時間範圍篩選
- 重新設計語意索引模型選擇介面
- AI 處理過程片段支援折疊收起
- 簡化證據來源列與 Agent 工具呼叫結果呈現

### 🐛 修復

- 修正多關鍵字訊息搜尋功能
- 修正詞雲詞典載入 UX 回歸問題
- 修正排行榜標籤與 emoji 清理
- 修正 v8 資料庫遷移缺少國際化文字的問題
- 【CLI】修正工具轉接器中會話上下文傳遞與前處理缺失的問題

## v0.26.3 (2026-06-15)

> 優化分析模組效能：新增磁碟快取與過期請求取消機制，切換會話更順暢；修正詞雲、高頻詞統計及時間軸等多處問題。

### ✨ 新功能

- 【CLI Web】新增網站圖示（favicon）

### ⚡ 效能

- 分析結果依資料庫檔案版本落地快取，大幅提升二次載入速度
- 切換會話或篩選條件時自動取消過期分析請求
- 切換詞雲詞數時略過重新分詞，減少不必要的運算

### 🐛 修復

- 修正高頻詞統計中含有平台回覆訊息占位符的問題
- 修正詞雲文字中包含媒體占位符的問題
- 修正 Jieba 自訂詞典變更後語言偏好快取與詞頻快取未失效的問題
- 修正時效性分析快取未按日失效的問題
- 修正時間軸面板預設捲動位置及會話跳轉功能失效的問題
- 修正片段訊息上下文缺失的問題
- 修正 AI 對話數量始終回傳 0 的問題
- 修正首頁教學連結未使用本地化路徑的問題
- 移除 AI 聊天頂部截圖按鈕
- 【桌面端】預先打包懶載路由依賴，避免開發模式 504 錯誤
- 【CLI】修正版本號不同步導致誤報更新提示的問題
- 【CLI】更新提示支援方向鍵選擇

### ♻️ 重構

- 將時間軸面板標籤重新命名為「摘要」

## v0.26.2 (2026-06-13)

> 優化會話「我是誰」身分識別功能，支援手動選擇 owner profile 並自動批次填充同平台會話；修正多處圖表渲染與 AI 快取問題。

### ✨ 新功能

- 新增會話「我是誰」身分識別功能：手動確認後儲存平台 owner profile，並自動批次比對填充同平台其他未設定擁有者的會話
- 匯入和 pull sync 完成後自動嘗試套用已儲存的 owner profile，減少手動設定次數

### 🐛 修復

- 修正 name-match 平台（WhatsApp / Line / Instagram）批次填充時各會話 ownerId 快取與資料庫寫入不一致的問題
- 修正多路由共用獨立 PreferencesManager 實例導致 owner profile 被覆寫為舊值的問題
- 【CLI】修正長期執行時 sync 模組 preferences 快取過期，pull 匯入新會話後 owner profile 未自動生效的問題
- 修正匯入後暫存檔案未完全刪除的問題
- 修正 AI 圖表在串流生成期間渲染抖動的問題
- 修正 AI 圖表渲染順序不穩定的問題
- 修正 AI 圖表存在僅占位空白列的問題
- 新增 AI 圖表生成進度提示
- 修正截圖前未調整圖表尺寸導致圖表顯示不完整的問題
- 修正 last_message_time 語義：表示資料涵蓋截止時間，而非群組最後活躍時間
- 修正增量匯入後概覽與分析快取未失效，導致顯示舊資料的問題

## v0.26.1 (2026-06-10)

> 修正工具呼叫歷史重播多項問題，補齊工具呼叫持久化與重播能力；狀態列新增 Token 快取統計，訊息匯出支援多種格式。

### ✨ 新功能

- 聊天狀態列新增 Token 快取命中／未命中用量顯示
- 訊息匯出支援 TXT、JSON、Markdown 多種格式

### 🐛 修復

- 支援持久化並重播對話中的工具呼叫記錄，保持多輪 AI 上下文完整性
- 修正工具呼叫無文字輸出的 assistant 輪次被歷史重播過濾，導致工具結果遺失的問題
- 修正連續匯出同一會話時，因檔名衝突導致靜默覆蓋的問題
- 【桌面版】修正大型會話匯出因 60 秒 IPC 逾時提前失敗的問題
- 修正 DeepSeek 工具呼叫輪次的 reasoning_content 未隨歷史重播
- 修正歷史壓縮時重播工具結果的 token 數未被正確計入
- 修正工具結果傳給模型的文字中包含不應暴露的原始訊息資料
- 修正工具面板在點擊外部區域時未自動關閉

### ♻️ 重構

- 將會話頁面頂部列提取為共用元件

## v0.26.0 (2026-06-10)

> 新增 AI 分析規劃器，支援流式結構化計畫產生與圖表規劃整合；改善圖表模式工具可用性，修正多項 AI 與匯入問題。

### ✨ 新功能

- 新增 AI 分析規劃器，支援流式結構化分析計畫產生與區塊渲染
- 整合圖表規劃支援，AI 分析計畫可自動銜接圖表產生
- 規劃器引入啟動上下文與延伸資料快照，提升分析深度與品質
- 圖表渲染優先使用高層工具而非原始 SQL，降低權限需求
- 改善 AI 分析與圖表整體行為
- 新增圖表自動模式偏好設定
- 新增訊息 ID 複製操作
- 新增 shadow 路由 LLM 備援機制，並記錄路由決策日誌
- 【CLI】公開完整 Agent 串流事件

### 🐛 修復

- 修正明確選擇圖表技能時 render_chart 工具遺失的問題
- 修正明確圖表模式下工具可用性缺口及錯誤後計畫狀態異常
- 遷移 ECharts 6 containLabel 設定，隱藏多餘的圓餅圖圖例
- 修正設定頁導覽順序、skillSettings 鍵名及 SubTabs 換行問題
- 修正 AI 助理訊息未填滿聊天區域寬度
- 改善分析計畫產生區塊的顯示樣式
- 修正思考深度選擇跨重新啟動後不持久的問題
- 修正 JSONL 時間戳記規範化導致增量匯入異常
- 【桌面版】修正 execute_sql 工具未註冊至桌面版工具清單

### test

- 新增 Agent 路由決策評估測試集

## v0.25.1 (2026-06-08)

> 新增資料目錄相容性門禁，防止舊版執行環境誤寫已升級的資料；並新增 CLI ai chat 指令。

### ✨ 新功能

- 新增資料目錄相容性門禁：寫入 v6 schema 資料後自動記錄最低可存取的執行環境版本，防止舊版本誤寫已升級的資料目錄
- 資料庫操作前校驗資料目錄相容版本，不符合要求時拒絕存取
- 【桌面版】啟動時校驗資料目錄相容版本，不符合時顯示提示視窗並結束
- 【CLI】啟動時校驗資料目錄相容版本，不符合時立即結束
- 【CLI】新增 ai chat 指令，支援在終端機與 AI 進行多輪對話

### 🐛 修復

- 改用打包版本號（而非 Electron 開發模式回報的 0.0.0）寫入相容性門禁，並強制要求執行環境身分識別
- 資料庫遷移與匯入完成後正確寫入相容性門禁；啟動遷移失敗時立即回報錯誤，不再靜默忽略
- 【MCP】啟動時主動校驗資料目錄相容性，版本不符時提前結束，避免寫入不相容資料
- 【桌面版】HTTP API 將相容性門禁錯誤對應為 409 回應，方便前端顯示升級提示
- 【CLI】規範化 AI 工具名稱，修正 ai chat 指令的邊界處理問題

### ♻️ 重構

- 統一 AI 對話與 segment 識別碼的命名規範

### test

- 補充解析器、設定遷移、資料庫遷移、HTTP 路由與 AI 工具的測試覆蓋

### 📝 文件

- 新增資料目錄相容性門禁公開文件，說明多版本共用資料目錄的限制與升級規則

## v0.25.0 (2026-06-07)

> AI 對話現在可透過技能產生圖表，並修正工具輪次、桌面標題列與開發服務生命週期問題。

### ✨ 新功能

- 新增以斜線指令觸發的 AI 圖表執行環境，可在對話中產生並渲染 ECharts 圖表
- 改善 AI 圖表結果呈現，補上更清楚的渲染狀態與多種圖表類型支援

### 🐛 修復

- 提高 AI Agent 預設工具呼叫輪次，減少複雜任務過早停止的情況
- 修正預設問題標籤與側邊欄元素的層疊順序異常
- 【CLI Web】修正開發後端生命週期清理不完整的問題
- 【桌面版】修正自動技能未註冊圖表工具，導致圖表技能無法完整執行的問題
- 【桌面版】修正 Windows 標題列覆蓋層在切換主題後快取未更新與顯示不順的問題

### ♻️ 重構

- 集中管理 AI 圖表執行策略，統一 CLI 與桌面版的圖表工具啟用規則
- 精簡技能選單與 Skill Manager 的重複邏輯

### 📝 文件

- 更新 iMessage 聊天記錄匯出指南

### 🔧 雜項

- 移除公開儲存庫中的維護者專用技能目錄，改由私有維護上下文管理

## v0.24.1 (2026-06-04)

> 新增應用內更新提醒與 AI 預處理預設規則，並修正更新標記與脫敏設定保存問題。

### ✨ 新功能

- 新增應用內更新提醒入口，側邊欄可顯示最新版本說明
- 新增 AI 預處理預設設定，自動啟用資料清理、去噪與脫敏等基礎規則
- 支援以群組管理 AI 脫敏規則，方便維護內建與自訂規則

### 🐛 修復

- 修正更新檢查失敗結果、舊版快取與 CLI Web 開發占位版本造成錯誤 New 標記的問題
- 修正 AI 預處理執行前未正確套用內建脫敏規則的問題
- 修正脫敏規則偏好以空覆蓋儲存時，無法清除舊內建規則開關的問題
- 修正舊版內建脫敏規則遷移後覆蓋設定遺失的問題

### 📝 文件

- 新增公開開發指南，補充本機開發、目錄職責與協作規範

### 👷 CI

- 發布流程新增 Markdown 版本更新記錄連結

## v0.24.0 (2026-06-03)

> 新增 CLI Web 驗證與資料目錄遷移能力，統一多端 HTTP 路由，並修正資料遷移、AI 設定與匯入刷新問題。

### ✨ 新功能

- 新增多語版本更新記錄的 Markdown 產生能力
- 支援在儲存空間管理中忽略舊資料遷移提示
- 【CLI Web】新增登入頁、Token 驗證與記住登入狀態
- 【CLI Web】支援資料目錄遷移流程，可在 Web 設定中切換並遷移資料目錄
- 【CLI】新增 --require-auth 參數，用於保護 /\_web/\* API 存取
- 【桌面端】新增內部 HTTP 服務，讓前端可透過統一服務轉接層使用共享介面

### 🐛 修復

- 修正資料目錄遷移與資料庫遷移流程中的多個邊界情境，避免舊資料庫欄位缺失或路徑切換後讀取失敗
- 修正舊資料不存在或目錄變更後，資料遷移提示仍錯誤顯示的問題
- 修正增量匯入後側邊欄訊息數量未更新的問題
- 修正側邊欄收合狀態只存於 sessionStorage，導致重新整理後遺失的問題
- 修正編輯 AI 設定且已儲存金鑰時，拉取模型與驗證按鈕未正確啟用的問題
- 修正 AI 共享 SSE 串流回應的穩定性問題
- 修正新增自訂資料來源時未強制填寫 Token 的問題
- 【桌面端】將圖表外掛運算移至 Worker，避免阻塞主執行緒

### ♻️ 重構

- 抽出 @openchatlab/http-routes 共享套件，統一 CLI Web 與桌面端的 HTTP 路由實作
- 將 AI 設定、助手、技能、對話、串流回應、快取與合併相關 API 遷移到共享 HTTP 路由
- 精簡桌面端 IPC 橋接層，移除舊版 AI、對話索引、LLM、Assistant、Skill、NLP 等相容處理程式
- 統一前端服務層，減少 Electron 與 Web 模式的分支實作

### ⚡ 效能

- 壓縮主程序建置產物，並延遲載入 tiktoken rank table，降低啟動與打包體積壓力

### 👷 CI

- 修正 Windows 發布流程中的 zstd 快取問題，並補充 CLI 更新發布說明

### 🔧 雜項

- 調整 Node 型別檢查專案設定，涵蓋桌面端與共享 Node 程式碼

## v0.23.1 (2026-06-01)

> 新增 clb 短別名與連接埠預檢提示，修正背景程式靜默退出及深色模式標題列等多處問題。

### ✨ 新功能

- 最佳化頁面頂部標題列與工具列排版
- 【CLI】啟動前主動偵測連接埠佔用，被佔用時提示切換埠號或執行 lsof，避免延遲報錯
- 【CLI】新增 clb 作為 chatlab 指令的短別名

### 🐛 修復

- 修正側邊欄 Tooltip 位置異常及 Nuxt UI v4 API 相容問題
- 修正標題列在深色模式下出現紅色背景與層疊順序錯誤
- 規範 AI 訊息角色參數型別，強化對話測試斷言
- 【CLI】修正背景程式啟動入口錯誤導致服務啟動後靜默退出的問題
- 【CLI】改善連接埠偵測的錯誤處理與提示訊息
- 【CLI】修正 Web 模式下缺少 chatlab.fun 反向代理路由的問題

## v0.23.0 (2026-05-31)

> 重構訊息編輯互動，新增推理等級按模型獨立設定，統一 CLI 啟動入口，修正多處推理識別與計算問題。

### ✨ 新功能

- 新增訊息分叉（Fork）功能，可從任意 AI 回覆處建立獨立分支對話
- 狀態列新增推理強度選擇器，支援為每個推理模型個別記憶並切換思維等級
- 推理等級控制新增 default/auto 選項，擴展對 Kimi、Doubao、Gemini 等更多模型系列的支援
- 訊息分析檢視拆分為「類型分析」與「時間分析」兩個分頁，提供豐富統計洞察卡片
- 批次重建對話索引前新增確認彈窗，防止誤操作清空現有摘要
- 示範資料擴充為 4 個檔案，涵蓋群組及多個私訊場景
- 【CLI】新增統一啟動指令 chatlab start，支援 --headless 和 --no-open 參數
- 【CLI】新增背景服務模式，支援 chatlab start --daemon 安裝為系統服務，以及 stop/status 指令

### 🐛 修復

- 修正訊息編輯可能導致資料遺失與狀態錯誤的多個並發安全問題
- 修正思維等級與上下文視窗計算未使用當前啟用模型 ID 的問題
- 修正自訂模型僅含 chat 能力時推理識別失敗，補全啟發式回退邏輯
- 修正 Kimi、Doubao 等模型在選擇 auto 思維等級時被靜默停用的問題
- 【CLI】修正 start 指令未啟動 Web 開發後端的問題
- 【CLI】修正 Linux 上服務路徑含空格時背景服務啟動失敗的問題

### ♻️ 重構

- 重構訊息分支系統為「編輯並重新產生」模型，支援僅更新當前輪或覆蓋後續訊息兩種模式
- 移除模型設定中的「推理模型」與「停用思維模式」開關，改為依能力自動推斷
- 簡化模型切換按鈕介面，優化對話索引載入效能

## v0.22.1 (2026-05-29)

> 新增對話摘要詳細程度設定，修正 CLI Web 批次摘要凍結、AI 設定編輯誤判及多項憑證偵測問題。

### ✨ 新功能

- 新增對話摘要詳細程度設定，支援「簡潔」與「標準」兩種策略，可在 AI 設定中切換

### 🐛 修復

- 修正 OpenAI 相容模式下變更 Base URL 後未重新驗證憑證的問題
- 修正 API 金鑰已設偵測邏輯錯誤，避免舊金鑰被誤用
- 修正批次產生摘要時點擊停止需等待當前請求完成才回應的問題
- 【CLI Web】修正批次產生摘要導致頁面凍結的問題
- 【CLI Web】修正批次產生摘要時未遵循已選取工作階段範圍的問題
- 【CLI Web】修正編輯 AI 設定時第三方服務被誤判為本機服務的問題

### ♻️ 重構

- 將工作階段索引的國際化 key 從 storage 命名空間遷移至 ai 命名空間

### 💄 樣式

- 最佳化聊天記錄清單密度與訊息氣泡樣式

### 📝 文件

- 重整文件站導覽結構，將快速開始移至使用指南目錄

## v0.22.0 (2026-05-26)

> 本次優化軟體預設狀態的介面樣式，並新增 CLI Web 更新與儲存管理能力，同時改善首頁匯入、文件站與多端穩定性。

### ✨ 新功能

- 首頁匯入區改為分入口設計，新增 API 匯入與自動同步入口
- 版本紀錄改為隨應用程式本地打包，減少執行時對遠端資源的依賴
- 【CLI Web】新增儲存管理功能，可在 Web 設定中檢視並管理資料快取
- 【CLI】新增更新檢查與自動更新流程，並接入 CLI Web 的更新檢查
- 【文件站】新增獨立文件站 docs.chatlab.fun

### 🐛 修復

- 修正首頁快捷開始按鈕缺失的問題
- 修正國際化 key 路徑錯誤與 ECharts 廢棄 api.style() 用法
- 強化自動更新與遷移重試流程中的安全保護
- 【桌面端】修正統一遷移可能回退資料目錄改動的問題
- 【CLI Web】修正發現新版本時顯示必定失敗的「立即更新」操作
- 【CLI Web】停用不可用的 Web 自動更新執行流程
- 【CLI Web】修正檔案管理操作依賴 shell 開啟造成的相容性與安全性問題
- 【CLI Web】修正資料目錄提示後 Web 服務無法繼續啟動的問題
- 【CLI Web】補齊合併相關 API 相容層
- 【CLI】優化更新檢查的非同步快取、按鍵互動與開發模式略過邏輯

### ♻️ 重構

- 將文件連結遷移到 docs.chatlab.fun
- 【設定】將會話索引移入 AI 設定，並調整設定頁排序

### 💄 樣式

- 優化側邊欄密度，並提升深色模式下 Tab 選擇器的對比度

### 📝 文件

- 重整公開文件站結構與匯出說明

### 🔧 雜項

- 將工作區套件遷移為 ESM
- 隔離文件站工作區依賴
- 將發布版本紀錄移出 docs 目錄

## v0.21.1 (2026-05-23)

> 優化 Pull 同步可靠性與資料安全性，新增移除訂閱時清除已匯入聊天記錄的選項，並修正 UI 動畫與彈窗互動問題。

### ✨ 新功能

- Pull 同步完成後自動產生會話索引
- 新增移除訂閱時清除已匯入聊天記錄的選項
- 【CLI Web】版本紀錄彈窗支援依版本截圖，Markdown 列表修正改為可選
- 【MCP】新增 ci 變更類型的圖示與多語系支援

### 🐛 修復

- 修正 Pull 同步在小頁面情境下可能遺失資料的問題，並驗證重試匯入結果
- 修正拉取同步後會話索引未自動產生的問題
- 修正 Pull 完成或資料刪除後側邊欄會話列表未重新整理的問題
- 修正遠端服務不支援分頁時無法取得全部會話的問題
- 優化拉取同步的重試機制與分頁策略，提升穩定性
- 修正會話存在性檢查缺少 schema 驗證導致資料表不存在報錯的問題
- 修正強制產生會話索引彈窗在失敗時意外關閉的問題
- 修正空會話狀態下會話索引彈窗阻塞頁面的問題
- 【桌面端】修正應用程式版本號顯示為 0.0.0 時自動回退讀取 package.json 版本
- 【CLI Web】同步圖示改為原地旋轉動畫，不再出現獨立的載入指示器

### 📝 文件

- 更新 Pull 協議文件為 since+nextSince 分頁模式

## v0.21.0 (2026-05-22)

> 本次更新新增 MCP 支援，統一多端匯入與服務層，並改善 Web、AI、同步與發布穩定性。

### ✨ 新功能

- Electron 與 Web 模式支援一致的資料夾匯入流程，可處理多檔聊天記錄格式
- 【MCP】新增獨立命令入口，並在設定頁接入 MCP 設定
- 【MCP】Server 擴充至 19 個工具，並支援精簡文字與 JSON 兩種輸出格式

### 🐛 修復

- 強化資料夾匯入路徑處理，降低匯入失敗風險
- 修復新增訂閱時可能發生的同步競態問題
- 修復 MiniMax 串流回應中的 <think> 內容未正確識別為思考事件的問題
- 【CLI Web】修復增量匯入無法使用的問題
- 【CLI Web】修復會話不存在與成員歷史等行為和桌面版不一致的問題
- 【CLI Web】修復開發服務的 Node 執行環境設定問題
- 【MCP】修復啟動時原生模組 ABI 綁定不一致的問題

### ♻️ 重構

- 統一 CLI Web 與 Electron 的共用服務層，減少路由與 IPC 中的重複業務邏輯
- 【MCP】精簡對外暴露的工具註冊表，降低外部 AI Agent 的工具 schema 成本
- 【MCP】將核心能力抽取為獨立共用套件，簡化 CLI 與桌面版整合
- 【MCP】精簡設定頁整合方式，降低桌面端輔助程式碼複雜度

### 👷 CI

- 【CLI】發布流程支援同步發布 npm 套件

### 📝 文件

- 補充 changelog 端特有變更的前綴與排序規則

### 🔧 雜項

- 【CLI】【MCP】補齊 npm 發布所需設定與發布說明

## v0.20.0 (2026-05-19)

> 本次更新統一多端核心架構，並改善 AI、匯入、同步與桌面版建置穩定性。同時為下一版的獨立 Web、CLI 與 MCP 能力預做準備；使用 CLI 前請先升級到此版本，以完成資料預遷移。

### ✨ 新功能

- 新增獨立 CLI、HTTP API 服務與 MCP Server，為命令列、Web 與 AI Agent 整合提供基礎能力
- 新增獨立 Web 建置與一鍵啟動流程，支援透過 CLI 啟動 Web UI 並自動開啟瀏覽器
- Web 模式支援聊天記錄匯入、Demo 匯入、會話查詢、成員查詢、搜尋與分析等核心流程
- Web 模式接入 AI 對話、模型設定、自訂 Provider/Model、上下文壓縮與串流事件顯示
- 匯入能力升級為共用串流管線，支援多格式解析、增量匯入、匯入分析與自動產生會話索引
- 新增合併流程、Markdown 匯出與會話快取相關的服務端能力
- 新增同步共用套件與 CLI 自動化支援，作為後續多端同步能力的基礎
- 新增後端偏好設定持久化，並支援 CLI 首次執行時自動偵測與遷移桌面版資料

### 🐛 修復

- 修復 Web 模式下會話索引、跨來源代理、Demo 保護與執行階段錯誤等問題
- 修復 Web 模式下應用程式版本顯示為空的問題
- 修復 AI Agent 證據檢索、Web 端事件串流與錯誤格式化等問題
- 修復同步顯示與匯入邏輯不一致的問題
- 修復 CLI 開發模式下的 ESM 模組解析問題
- 修復 CLI 安裝後可能找不到既有桌面版資料的問題
- 修復 Electron 套件拆分後資料遷移路徑不一致的問題
- 修復打包後 Worker 執行緒間接依賴 electron 模組導致崩潰的問題
- 修復 Electron 建置、依賴安裝與 better-sqlite3 原生模組重建相關問題

### ♻️ 重構

- 將專案調整為多端工作區結構，拆分 apps/desktop、apps/cli 與多個共用 packages
- 將解析器、設定、資料庫適配、查詢、遷移、NLP、會話快取、匯入、合併、匯出與同步邏輯抽取為共用模組
- 將 AI Agent、工具系統、預處理、上下文壓縮、RAG、LLM 設定、助手與技能管理抽取為共用執行階段能力
- 統一 Electron、CLI Web 與 MCP 的 AI 工具命名、工具註冊與資料存取方式
- 統一資料目錄、訊息查詢、成員查詢、會話索引、SQL 執行與匯入去重等核心邏輯
- 將 CLI 從 packages/server 遷移到 apps/cli，並補齊 npm 發布建置流程
- 將純前端圖表模組遷移到 src/features，讓 packages 目錄只保留可重用的共用套件
- 移除多處 Electron 側純轉發檔案與廢棄程式碼，減少重複實作

### build

- 升級 Vite 等建置工具鏈
- 新增 CLI tsup 建置、Web 資源打包與 npm 發布所需設定
- 調整 Electron 桌面版建置設定，移除 Linux 桌面版建置目標

### 📝 文件

- 補充版本策略、提交 scope 約定與相關開發文件

## v0.19.0 (2026-05-06)

> 本次更新支援 AI 上下文自動壓縮，新增 Demo 範例，並優化模型設定與除錯體驗。

### ✨ 新功能

- 支援模型上下文視窗預設與自訂設定
- 支援 AI 對話上下文自動壓縮與相關設定
- 優化上下文壓縮流程與狀態顯示
- 除錯模式新增原始資料檢視，並支援記錄完整 LLM 上下文
- 優化 AI 模型設定文案、表單與設定頁顯示
- 移除向量模型設定，簡化相關設定項目
- 新使用者可在空狀態直接查看 Demo 範例
- 遷移至 pnpm workspace 專案結構

### 🐛 修復

- 修正快速模型跟隨預設助手時，部分情況可能使用錯誤模型的問題
- 修正空資料狀態下不顯示 Demo 按鈕的問題
- 修正主行程直接依賴未宣告 axios，可能造成啟動失敗的風險

## v0.18.4 (2026-04-29)

> 本次更新優化了模型的穩定性，同時支援遠端取得模型清單，優化 AI 錯誤詳細資訊的顯示與部分介面樣式等。

### ✨ 新功能

- 支援遠端取得模型清單
- OpenAI 相容 API 網址自動補齊 /v1 並支援即時預覽
- 優化 AI 對話錯誤詳細資訊的顯示
- 優化部分顯示樣式

### 🐛 修復

- 修復部分邏輯漏洞

### 🔧 雜項

- 優化同步日誌技能的邏輯

## v0.18.3 (2026-04-28)

> 本次更新支援設定快捷工具入口位置，優化預設時間篩選，並修正彈窗層級與資料目錄安全提示。

### ✨ 新功能

- 支援設定快捷工具入口位置
- 優化預設時間篩選體驗
- 禁止將資料目錄設在應用程式安裝目錄內

### 🐛 修復

- 修正彈窗樣式被覆蓋的問題
- 修正設定頁內彈窗被遮擋的層級問題

## v0.18.2 (2026-04-26)

> 本次更新新增訂閱類型選擇、遠端會話分頁發現，以及每次拉取訊息數量的設定。

### ✨ 新功能

- 訂閱會話時支援依類型篩選與選取
- 支援遠端會話分頁發現與按需載入更多
- 支援為資料來源設定每次拉取的訊息數量

## v0.18.1 (2026-04-24)

> 本次更新新增 DeepSeek V4 支援與開機自動啟動選項，優化設定與整體介面體驗，並修正 AI 對話中的連結開啟方式。<br/>從這個版本開始，專案將正式遷移至 ChatLab 組織。

### ✨ 新功能

- 遷移至 ChatLab 組織
- 優化全域樣式表現
- 優化快速提問的顯示邏輯
- 優化設定彈窗的開啟方式
- 支援開機自動啟動
- 支援 DeepSeek V4 模型

### 🐛 修復

- 修正 AI 對話中的連結未在瀏覽器中開啟的問題

## v0.18.0 (2026-04-23)

> 本次更新優化 AI 對話互動、整合多個分析入口，並提升資料來源同步與 Windows 更新的穩定性。

### ✨ 新功能

- 優化 AI 助手互動流程
- 調整新增資料來源表單的提示文案
- 工具 Panel 新增 Mini 模式
- 將聊天記錄檢視器移至工具 Panel
- 統一關係分析相關分頁
- 將語錄模組整體移至洞察
- 將關鍵字分析移至實驗室

### 🐛 修復

- 修正既有型別警告
- Pull 增量同步加入 60 秒重疊視窗，避免漏掉訊息
- Pull 拉取固定使用 `limit=1000`，避免遠端資料來源一次匯出過多資料造成卡頓
- 修正 Windows 更新時 NSIS 彈窗中斷靜默安裝的問題

## v0.17.5 (2026-04-21)

> 本次更新聚焦大量錯誤修復，整體穩定性與可用性皆有所提升。

### ✨ 新功能

- 優化關係卡片樣式。
- 以原生機器識別邏輯取代 `node-machine-id` 依賴，提升 Linux 下 API 金鑰修改穩定性。
- 合併聊天記錄時新增可選保留原始記錄。
- 在預設服務與第三方服務的 API 位址旁新增驗證按鈕。

### 🐛 修復

- 優化 dataSource 遷移策略，提升遷移安全性。
- 修正話題在訊息過少時空狀態顯示異常。
- 修正本地模型驗證失效問題。
- 修正切換對話後已選分頁被重置的問題。
- 修正舊版 dataSources 升級後自動化頁面白屏問題。

## v0.17.4 (2026-04-19)

> 完成 Import API v1 完整協定並新增分層資料來源管理，現已支援聊天記錄自動同步。

### ✨ 新功能

- 完成 Import API v1 完整協定與分層資料來源管理

## v0.17.3 (2026-04-17)

> 本次更新為私聊新增語言偏好分頁，側邊欄對話清單支援排序與篩選，完善 AI 服務商與模型設定能力，並修正時間篩選重置問題。

### ✨ 新功能

- 對話清單新增排序與篩選功能
- 新增語言偏好分頁，可檢視偏好內容
- 優化介面樣式細節，提升視覺一致性
- AI 服務商新增 Anthropic 支援
- 模型第三方服務支援自行選擇介面類型
- AI 模型設定支援自訂名稱

### 🐛 修復

- 修正從設定或 AI 對話頁返回後，時間篩選會被重置為「全部」的問題

### ♻️ 重構

- 將語言偏好抽離為共用型別，減少重複定義

## v0.17.2 (2026-04-15)

> 本次更新新增跨平台資料合併與成員訊息合併，強化詞庫與更新安全檢查，優化深色模式體驗與日誌能力，並修復多項問題。

### ✨ 新功能

- 成員管理支援合併成員訊息
- 支援跨平台聊天資料合併
- 資料管理中部分表頭支援排序
- 將話題分析入口移至洞察模組
- 新增 AI 日誌檔案原始路徑紀錄
- 優化深色模式配色，提升視覺體驗

### 🐛 修復

- 修正詞庫刷新與合併 ID 衝突問題
- 為 OpenAI 相容請求補上執行期 User-Agent 標頭
- 修正深色模式截圖匯出背景透明異常
- 詞庫下載新增 SHA256 完整性檢查
- 收斂遠端設定拉取策略並強化更新安裝確認

### 🔧 雜項

- 新增 ARM Linux 的 deb 安裝包建置支援
- 優化版本日誌同步流程

### 📝 文件

- 新增繁體中文文件

## v0.17.1 (2026-04-13)

> 重構話題模組並新增話題卡片展示，優化詞雲關鍵詞篩選與查詢快取邏輯，支援遠端下載分詞詞庫及繁體中文詞庫，並完善 WhatsApp 偵測邏輯。

### ✨ 新功能

- 重構話題模組，新增話題卡片展示
- 詞雲支援關鍵詞篩選
- 支援遠端下載分詞詞庫，新增繁體中文詞庫支援
- 查詢快取邏輯優化
- 部分讀取中介面互動統一
- 完善 WhatsApp 偵測邏輯

### 👷 CI

- 新增官網文件站，支援自動化同步與部署

## v0.17.0 (2026-04-12)

> 本次更新強化 WhatsApp 匯入解析與指定格式匯入，並重整總覽卡片體系，補上分享、截圖與除錯工具能力。

### ✨ 新功能

- 新增 WhatsApp V2 時間戳彈性解析，可自動適配不同地區匯出格式
- 完善 WhatsApp 聊天紀錄偵測機制
- 新增指定格式匯入能力
- 在訊息分頁新增分享卡片
- DEBUG 模式新增快速除錯工具
- 優化總覽身份卡並統一時間範圍查詢邏輯
- 重構總覽模組卡片並抽離主題色卡片，預留配色模式
- 統一卡片最大寬度，並將首頁工具升級為全域工具側邊欄
- 主題卡片支援截圖，並預設關閉截圖的行動端適配
- 移除診斷建議並新增提示

### 🐛 修復

- 修正 WhatsApp 時間解析正則與行匹配正則寬嚴不一致的問題
- 修正 WhatsApp 12 小時制時間與 NNBSP 字元的解析相容性問題

### 🔧 雜項

- 快取 electron 與 electron-builder 二進位檔以加速 CI 打包

## v0.16.0 (2026-04-10)

> 本次更新新增私聊主動性分析視圖，並修正模型編輯視窗中自訂模型遺失的問題。

### ✨ 新功能

- 私聊場景新增主動性分析視圖
- 優化頁尾區域的呈現與互動
- 優化語錄模組下半部邏輯

### 🐛 修復

- 修正第三方／本地服務編輯視窗會遺失多個自訂模型的問題

## v0.15.0 (2026-04-08)

> 本次版本大幅優化搜尋與查詢效能，搜尋工具可自動帶入上下文訊息，並優化 AI 模型設定、新增部分服務商，同時支援 Linux 平台。

### ✨ 新功能

- 新增查詢快取以加快存取速度
- 搜尋工具支援自動帶入上下文訊息
- 重構模型設定邏輯
- 新使用者首次啟動時優先顯示語言選擇視窗
- 實驗室新增基礎除錯工具
- 移除舊版提示詞

### 🐛 修復

- 修正 Windows 淺色模式下標題列按鈕區背景色與應用不一致的問題
- 修正 CI 打包流程中 Node 24 與 pnpm 對齊相關問題
- 補齊工具呼叫顯示名稱的 i18n 翻譯

### ♻️ 重構

- 優化 AI 設定彈窗的程式碼組織

### 🔧 雜項

- 升級至 Node 24
- 支援 Linux 打包

### 📝 文件

- 更新文件

## v0.14.2 (2026-04-07)

> 本次更新聚焦 AI 對話體驗升級，新增對話複製、優化介面，並支援 FTS5 全文搜尋工具，同步精簡部分搜尋參數並強化錯誤提示與測試能力。

### ✨ 新功能

- 新增可在 7 天內記住助手選擇的功能
- AI 對話支援一鍵複製訊息內容
- 優化 AI 對話樣式與整體互動體驗
- 支援 FTS5 全文搜尋，並新增快速搜尋工具
- 精簡部分工具的搜尋參數，降低 token 消耗
- 新增 Electron 應用 E2E 測試框架，支援連接埠管理與實例隔離

### 🐛 修復

- 完善 AI 對話錯誤提示，提升問題定位效率

### ♻️ 重構

- 整理 AI 對話模組程式結構
- 抽出會話分析頁共用邏輯並統一頁首文案

### test

- 補充可重複使用的 E2E 啟動器冒煙測試能力

### 📝 文件

- 更新專案文件中的導覽圖片

### 💄 樣式

- 統一部分程式碼格式，提升可讀性

## v0.14.1 (2026-04-02)

> 本次更新聚焦首頁資訊架構調整與介面優化，同步提升 SQL 對話體驗、統計讀取效能與 AI 工具品質。

### ✨ 新功能

- 優化總覽頁樣式
- 優化 SQL 對話模組互動流程
- 將成員管理移至首頁，並調整相關分頁配置
- 新增部分 AI 工具，包含聊天概覽取得能力
- 新增對話資料快取管理模組，提升統計讀取效能
- 完善版本日誌彈窗的類型呈現

### 🐛 修復

- 修復 SQL Lab 與摘要產生流程中 AI 錯誤被靜默吞沒的問題

### ♻️ 重構

- 重構 AI 工具分類體系，提升工具組織的可維護性

### 🔧 雜項

- 淘汰部分低價值 AI 工具，精簡可用工具集

## v0.14.0 (2026-03-28)

> 新增 API 匯入匯出與預設提問，優化總覽與設定體驗，並修復訊息去重、AI 對話流程與每日訊息趨勢顯示問題。

### ✨ 新功能

- 新增 API 匯入
- 新增 API 匯出
- 點選預設問題後可直接送出提問
- 設定頁支援選擇會話預設進入的分頁
- 優化總覽頁樣式
- 優化整體介面樣式與 API 服務設定頁
- 優化身份卡片與助手選擇互動

### 🐛 修復

- 修復訊息去重誤判，並統一空字串的去重行為
- 修復 AI 對話流程與前端 type-check 錯誤
- 補上預設 assistant 的兜底邏輯，修復例外情境
- 修復每日訊息趨勢未顯示的問題

### ♻️ 重構

- 整理 parser、worker、RAG 與 merger 的歷史型別問題

### 🔧 雜項

- 新增 assistant 設定產生技能

## v0.13.0 (2026-03-16)

> AI 對話支援助手模式，對話可使用技能，輸入框支援快捷選擇，完善對話與設定介面，支援繁體中文與日文，並調整部分 UI，同時修復多項穩定性問題。

### ✨ 新功能

- 完成助手模式初版並強化助手邏輯與分析工具能力
- 上線助手市集與技能市集，聊天對話支援使用技能
- 支援以 @ 選擇成員協作
- 支援繁體中文與日文在地化
- 設定頁面重構並優化部分 UI 細節
- 優化總覽模組樣式與對話介面體驗
- 調整匯出聊天記錄的入口位置
- 移除舊版提示詞系統與自訂篩選 AI 功能
- 切換頁面時模型呼叫不再中斷

### 🐛 修復

- 修復 Gemini API 設定問題
- 修復 NLP 停用詞呼叫順序導致的錯誤

### ♻️ 重構

- 重構 AIChat 組織結構
- 重構目錄位置與專案結構

### 📝 文件

- 更新使用者協議與專案文件

### 🔧 雜項

- 優化版本日誌建置流程

### 💄 樣式

- 統一程式碼格式與 lint 規則輸出

## v0.12.1 (2026-02-27)

> 新增聊天紀錄前處理與除錯能力，重構 Agent/LLM 架構，並修復國際化與 Windows 主題顯示問題。

### ✨ 新功能

- 新增聊天紀錄前處理流程
- 新增前處理設定介面與設定管理能力
- Agent 支援依會話顯示上下文時間軸與執行狀態
- 新增 AI 除錯模式並提升日誌可觀測性

### 🐛 修復

- 修復英文設定下部分介面未完成國際化的問題
- 修復 Windows 動態更新 overlay 色彩時主題不一致的問題

### ♻️ 重構

- 將 Agent 單體實作拆分為模組化架構
- 將工具系統重構為 AgentTool + TypeBox 結構並補齊 i18n
- 統一 LLM 存取層，收斂為 pi-ai 方案
- 重構資料流方向與 IPC 協議，並完成前端適配
- 引入共享型別並優化 ChatStatusBar 國際化
- 將部分圖表重構為外掛化架構

### 🔧 雜項

- 移除過度設計的 sessionLog 模組
- 移除 @ai-sdk 相關依賴與舊版 LLM 服務實作
- 暫時隱藏向量模型設定入口
- 更新專案描述文案

### 💄 樣式

- 執行 ESLint 自動修正，統一程式碼風格

## v0.11.2 (2026-02-15)

> 優化聊天紀錄匯入機制與管理頁體驗，並提升多平台聊天紀錄的相容性。

### ✨ 新功能

- 強化 LINE 與 WhatsApp 解析器的格式相容性
- 優化聊天紀錄嗅探層，支援輪詢偵測與回退機制
- 管理頁支援 Shift 多選
- 管理頁新增顯示聊天摘要數量與 AI 對話數量
- 優化首頁版面，提升可用空間
- 優化 Windows 右上角控制列樣式

### 📝 文件

- 更新專案文件

## v0.11.0 (2026-02-13)

> 支援 Telegram 匯入，優化增量匯入體驗，補齊國際化設定，並修復索引失效與頁面閃爍等問題。

### ✨ 新功能

- 補齊 AI 呼叫、日誌與主進程設定的國際化支援
- 支援 Telegram 聊天紀錄匯入
- 優化增量匯入互動與相關文案
- 優化開啟協議時的互動體驗

### 🐛 修復

- 修復增量匯入後索引失效的問題（resolve #81）
- 修復 WhatsApp 使用 iPhone 匯出後無法辨識的問題（resolve #82）
- 修復切換對話頁面時出現雙重閃爍的問題

### 🔧 雜項

- 優化 TypeScript 設定
- 調整 i18n 建置設定
- 優化技能相關工程設定

## v0.10.0 (2026-02-11)

> 新增互動頻率分析能力，優化會話查詢流程，並修復增量索引與資料庫掃描相關問題。

### ✨ 新功能

- 新增互動頻率分析視圖，更直觀地觀察成員互動趨勢
- 優化會話查詢相關邏輯與處理流程

### 🐛 修復

- 修復增量更新後會話索引產生範圍不準確的問題（fix #79）
- 修復遷移與會話掃描時誤處理非聊天 SQLite 檔案的問題

### ♻️ 重構

- 重構會話查詢模組，提升查詢結構可維護性

### 🔧 雜項

- 移除 transformers 相關依賴並更新工程設定

## v0.9.4 (2026-02-08)

> 優化時間篩選與 AI 設定體驗，新增 API Key 本機加密，並修復 LINE 聊天紀錄解析問題。

### ✨ 新功能

- 時間篩選支援更多彈性選項
- API Key 支援本機加密儲存
- 新用戶首次進入時不再顯示版本日誌
- 優化 AI 對話底部的設定狀態顯示
- 資料目錄遷移後支援立即重新啟動軟體

### 🐛 修復

- 修復 LINE 聊天紀錄解析問題

### 📝 文件

- 更新專案文件

## v0.9.3 (2026-02-03)

> 支援自訂資料目錄，並修復多項已知問題。

### ✨ 新功能

- 設定中新增資料目錄位置選項
- 優化資料儲存目錄遷移邏輯
- 切換目錄時新增確認彈窗
- 優化解析邏輯（WeFlow / Echotrace）

### 🐛 修復

- 修復 Windows 自訂篩選時訊息量過大導致崩潰的問題
- 修復第三方中轉 API 呼叫 tool_call 導致對話異常結束的問題
- 修復部分 WhatsApp 聊天紀錄無法正確辨識的問題
- 修復管理頁表頭層級顯示問題

### ♻️ 重構

- 重構 session 查詢模組
- 補強遷移日誌輸出

## v0.9.2 (2026-02-02)

> 排行榜改為圖表呈現，優化詞雲與本機 AI 推理模型，改進聊天紀錄篩選與日期選擇器，並在啟動後預先載入關鍵路由。

### ✨ 新功能

- 排行榜改為圖表展示
- 優化詞雲效果
- 優化推理模型
- 優化訊息會話搜尋與篩選的聯動體驗
- 優化日期選擇器互動
- 啟動後預先載入關鍵路由

### 🔧 雜項

- 將 preload 模組化拆分
- 優化 analytics 邏輯
- 升級 ESLint 並整理程式碼格式

## v0.9.1 (2026-01-30)

> 支援 LINE 聊天紀錄匯入，新增批次管理與聊天搜尋，並修復一些已知問題。

### ✨ 新功能

- 新增批次管理，支援批次刪除與合併
- 支援聊天搜尋
- 支援 LINE 聊天紀錄匯入
- 相容 WeFlow 匯出的 JSON 格式
- 成員列表改為後端分頁載入
- 優化部分文案

### 🐛 修復

- 修復 Windows 更新時因 Worker 占用導致軟體無法關閉的問題

## v0.9.0 (2026-01-28)

> 支援 NLP 分詞能力，語錄頁新增詞雲；新增視圖功能可展示更多圖表；支援系統代理跟隨，並優化部分頁面與樣式。

### ✨ 新功能

- 優化使用者選擇器效能，支援虛擬載入
- 將排行榜移至視圖分頁
- 引入分詞能力，並新增詞雲子分頁
- 優化群聊頁分頁文案
- 網路代理支援跟隨系統代理
- 優化版本日誌顯示判斷邏輯

### 💄 樣式

- 優化 Markdown 渲染樣式

## v0.8.0 (2026-01-26)

> 新增會話摘要與向量檢索能力，版本更新後會顯示更新內容，優化部分介面互動，並修復一些已知問題。

### ✨ 新功能

- 聊天會話支援摘要功能
- 新增批次產生會話摘要邏輯
- 支援向量模型設定與相關檢索
- 匯入聊天紀錄報錯時記錄更詳細的日誌
- 每次更新到新版本後自動開啟版本日誌
- 首頁新增 Footer，顯示常用連結
- 側邊欄移除幫助與回饋

### 🐛 修復

- 修復 shuakami-jsonl 解析錯誤（fix #50）

## v0.7.0 (2026-01-23)

> 優化 AI 對話體驗，改進更新流程，並以 ECharts 取代 chart.js。

### ✨ 新功能

- 優化更新流程
- 補強 AI 對話錯誤日誌
- 聊天底部支援快速切換對話模型
- 優化預設提示詞，增加一點幽默感
- 以 ECharts 取代 chart.js
- 移除註冊協議邏輯

## v0.6.0 (2026-01-21)

> 接入 AI SDK 提升 AI 對話穩定性，新增思考內容區塊，並優化部分樣式。

### ✨ 新功能

- 新增定位日誌功能
- 接入 AI SDK
- 新增思考內容區塊
- 解決全域彈窗被首頁上方拖曳區域遮擋的問題
- 優化 Windows 右上角關閉按鈕樣式

## v0.5.2 (2026-01-20)

> 支援合併匯入，並修復一些問題。

### ✨ 新功能

- 支援合併匯入
- 主面板顯示聊天紀錄起訖時間
- 優化拖曳區域

### 🐛 修復

- 優化建置設定以修復 macOS x64 編譯問題
- 修復訊息紀錄檢視器在 Windows 下的關閉按鈕樣式問題
- macOS 打包時需在對應架構上編譯（fixes #36）

## v0.5.1 (2026-01-16)

> 修復一些問題。

### ✨ 新功能

- 優化文案

### 🐛 修復

- 修復 Windows 下關閉軟體後程序未退出的問題（#33）
- 修復數字輸入框 BUG（resolve #34）

## v0.5.0 (2026-01-14)

> 支援 Instagram 聊天紀錄匯入；首頁支援批次匯入；聊天頁支援增量匯入。

### ✨ 新功能

- 支援 Instagram 聊天紀錄匯入
- 優化整體邏輯
- 優化系統提示詞預設功能
- 支援增量匯入
- 支援批次匯入
- 優化樣式
- Windows 端支援原生視窗控制並實作主題同步（#31）

### 🔧 雜項

- 移除 componenst.d.ts

## v0.4.1 (2026-01-13)

> 優化部分樣式與互動體驗。

### ✨ 新功能

- 提示詞支援預覽
- 優化 AI 對話狀態列
- 優化遷移表邏輯
- 側邊欄支援顯示頭像
- 優化樣式
- 替換原生視窗控制列
- 優化全域背景色
- 關閉軟體時清理 Worker

### 🐛 修復

- 修復主題模式設定跟隨系統不生效的問題
- 修復更新彈窗提示內容排版問題

## v0.4.0 (2026-01-12)

> 匯入支援 shuakami-jsonl 格式；AI 對話更省 Token；匯入聊天紀錄時可建立會話索引，查看器也支援依索引快速跳轉；軟體更新支援加速鏡像。

### ✨ 新功能

- 相容 shuakami-jsonl
- 優化 Loading 體驗
- 新增自訂篩選
- 重構預設詞系統，支援通用預設詞
- 精簡系統提示詞以節省 Token
- 新增會話相關 function calling 呼叫
- 處理訊息跳轉到上下文的邏輯
- 聊天紀錄檢視器支援查看會話索引與快速跳轉
- 重構設定彈窗，新增會話索引設定
- 匯入聊天紀錄時支援產生會話索引
- 重構設定彈窗
- 優化基礎元件互動樣式
- 優化首頁樣式
- 優化更新加速邏輯
- 新增加速鏡像

## v0.3.1 (2026-01-09)

> 已適配 Discord 匯入；各解析器支援回覆類型匯入；軟體儲存目錄遷移至更標準的位置；匯入支援角色；匯入報錯提供更詳細的診斷與提示，並帶來一些細節優化。

### ✨ 新功能

- 資料表升級改由主進程執行
- 自動檢查更新時忽略 beta 版本
- 將資料儲存目錄遷移到 userData 下
- 各解析器重新支援回覆訊息匯入
- 支援平台訊息 ID 與回覆 ID，並同步進行資料表遷移
- 支援 Tyrrrz/DiscordChatExporter 訊息格式匯入
- member 表支援角色
- 強化 ChatLab 格式偵測行為
- 確保點擊匯入與拖曳匯入的邏輯一致
- 支援更詳細的格式診斷

### 🐛 修復

- 修復部分使用者 platformId 為空的情況

## v0.3.0 (2026-01-08)

> 完成完整國際化支援，支援中英文切換，並進一步優化部分功能。

### ✨ 新功能

- SQL 實驗室支援匯出
- AI 對話支援匯出
- 完成最終國際化
- AI 模型出錯時顯示明確錯誤
- SQL 結果支援跳轉到訊息檢視器
- 優化系統 prompt，支援 prompt 市集

## v0.2.0 (2025-12-29)

> 支援代理設定；匯入時支援顯示錯誤日誌；優化部分介面互動，並帶來一些功能更新。

### ✨ 新功能

- 訊息管理器支援顯示系統訊息
- 優化匯入流程，錯誤時會顯示匯入日誌
- WhatsApp 支援英文格式訊息匯入
- 支援設定代理（resolve #7）
- 優化 AI 模型介面互動
- 新增使用者設定 API 教學
- 新增 2 個免費 GLM 模型，並加入豆包服務商與最新模型
- AI 回覆不再輸出 think 內容

## v0.1.3 (2025-12-25)

> 修復一些問題。

### 🐛 修復

- 修復 Echotrace 解析器錯誤

## v0.1.2 (2025-12-25)

> 支援深色模式；AI 對話中的系統提示詞可帶入使用者身分。

### ✨ 新功能

- AI 對話中的系統提示詞可帶入使用者身分
- 聊天紀錄檢視器中，Owner 顯示在右側
- 支援資料庫升級
- 成員分頁支援設定 Owner 視角
- 支援深色模式

### 🐛 修復

- 修復將私聊誤判為群聊的問題

## v0.1.1 (2025-12-24)

> 已適配 WhatsApp 聊天紀錄匯入；支援舊版 QQ 討論組格式分析。

### ✨ 新功能

- 聊天會話底部顯示 Token 消耗
- 支援 WhatsApp 原生格式訊息
- 支援舊版 QQ txt 討論組格式

### 🐛 修復

- 修復訊息管理器層級過低的問題

## v0.1.0 (2025-12-23)

> 專案正式開源發布。

### ✨ 新功能

- init
