# 更新日誌
## v0.36.2 (2026-08-20)
> 改善 AI 對話過程呈現與長對話效能，群組排行支援成員頭像。
### ✨ 新功能
- 改善 AI 回覆排版、使用者氣泡與操作按鈕，游標停留時顯示訊息時間
- AI 對話將思考、規劃與工具執行整理成可展開的過程區塊，完成後顯示耗時與步驟
- 群組排行榜及相關圖表顯示成員頭像
- 排行榜載入時維持卡片對齊，避免版面跳動
### 🐛 修復
- 匯入資料夾改為獨立按鈕，避免與選取檔案互相搶入口
### ⚡ 效能
- 改善長對話渲染效能，串流輸出改為批次更新，並支援分段載入較早的紀錄
## v0.36.1 (2026-08-18)
> 完善 AI 工具執行進度與平行呼叫，改善關係星空圖體驗，並強化桌面版的升級復原能力。
### ✨ 新功能
- AI 對話可平行執行彼此獨立的唯讀工具，讓複雜分析更快完成
- 聊天證據檢索會即時顯示功能檢查、語意搜尋、關鍵字搜尋與證據整理進度
- 改善關係星空圖的縱深層次、焦點連線與選取操作
### 🐛 修復
- 修正平行工具呼叫時，執行狀態與進度可能過早清除的問題
- 限制關係星空圖篩選後的連線數量，避免畫面過於擁擠
- 【桌面版】資料目錄需要較新版本時提供自動升級引導，避免啟動直接中斷
- 【桌面版】更新提示會在應用程式視窗取得焦點後再顯示，避免視窗尚未可用時彈出
### build
- 【CLI】最低 Node.js 版本調整為 22.19，並同步更新格式驗證工具
- 【桌面版】支援 pnpm 11 打包流程
## v0.36.0 (2026-08-11)
> 足跡新增「時間投入」、改善「關於我」，並加入可依話題整理聊天內容的記憶頁面。
後續版本將持續擴充記憶相關功能。
### ✨ 新功能
- 聊天記憶新增 AI 話題摘要，可按自然日批次產生或單日產生話題，並同步醒目標示對應訊息
- 聊天記憶新增連動的聊天記錄檢視，整合摘要時間軸、篩選與原文定位體驗
- 足跡新增跨會話「時間投入」分析，顯示累計投入、每月趨勢、投入日曆、活躍節奏與關係分布
- 全域洞察只統計已確認本人身分的會話，避免未識別身分的會話影響個人統計
- 可關閉更新日誌自動彈出，同時保留手動檢視入口
- 統一按鈕、圖示、狀態標籤、進度列與提示元件，讓桌面版與 Web WASM 的操作體驗保持一致
## v0.35.0 (2026-08-09)
> 新增群組關係 3D 星空圖與 AI 上下文壓縮，並改善啟動速度、洞察載入及 Windows 背景執行體驗。
### ✨ 新功能
- 將群組關係升級為 3D 星空圖，並把互動排行與鄰近度排行整理為獨立的第二層分頁
- 【桌面版】Windows 支援關閉至系統匣，並可在設定中選擇於背景執行或直接結束
- AI 對話會依模型的上下文容量自動壓縮歷史訊息，讓長對話可在桌面版、CLI Web 與 Web WASM 持續進行
- 統一會話洞察、關係與足跡頁面的切換載入提示，減少非同步檢視切換時的空白與閃爍
- 啟動畫面動畫同時作為應用程式預載視窗，首次啟動播放完整動畫，後續可更快進入應用程式
- 【Web WASM】統一 AI 模型設定、會話列表、輸入區與設定入口的使用體驗
### 🐛 修復
- 強化 AI 上下文壓縮的模型容量判斷與失敗備援，避免切換至較小上下文模型後因歷史訊息過長而請求失敗
- 【桌面版】修正匯出或刪除會話後未釋放資料庫控制代碼，導致 Windows 必須重新啟動應用程式才能刪除檔案的問題
- 【桌面版】修正 Windows 標題列懸停區域與系統按鈕不一致，並統一關閉至背景的預設行為
## v0.34.3 (2026-08-06)
> 修正自動增量匯入與合併去重的資料問題，並改善大型資料庫匯入、搜尋與洞察體驗。
### 🐛 修復
- 修正 QQ 自動匯入在 UID/UIN 變更、缺少 owner 資訊或工作階段已合併時的比對與成員對應問題，避免產生重複工作階段或錯誤的成員身分
- 修正合併匯入因平台訊息 ID 衝突或私人聊天身分資訊不足而誤刪訊息的問題，並保留有效的 owner 與工作階段身分資訊
- 修正動態關鍵字排行的請求、快速切換與多色模式，避免顯示過期結果或因未知類型導致頁面當機
- 統一洞察頁面的載入轉場，並恢復年度活動日曆配色與關係檢視切換控制項
### ⚡ 效能
- 最佳化增量匯入去重，只在需要時查詢既有的候選訊息，降低大型資料庫匯入時的記憶體用量
## v0.34.2 (2026-08-01)
> 提升大型檔案與批次匯入效能，完善 CLI 本機語意索引，並強化資料移轉與匯入穩定性。
### ✨ 新功能
- QQ Shuakami 與 QQ Chat Exporter 匯入改用 Rust 原生解析，提升大型匯出檔案的處理穩定性
- 多檔案匯入加入安全的並行排程，避免同一工作階段同時寫入，並顯示各檔案的進度與失敗資訊
- 新增兼顧隱私的匿名產品統計，只回報白名單內的執行環境與功能使用事件
- 【CLI Web】本機語意索引執行元件改為首次使用時按需安裝，Docker 映像仍預先內建所需元件
### 🐛 修復
- 自動匯入會略過 macOS 產生的 `._*.db` AppleDouble 附屬檔案，避免無關的中繼資料阻擋聊天記錄匯入
- 強化設定移轉與舊資料目錄清理保護，避免並行移轉覆寫驗證設定或誤刪仍在使用的目錄
- 大型 QQ 匯出檔案從原生解析切換至相容模式時，持續使用低記憶體預處理，避免重新占用過多記憶體
- 修正本機模型預載完成後未及時釋放 Worker，以及背景失敗原因記錄不完整的問題
## v0.34.1 (2026-07-27)
> 修正 QQ 分塊匯入與資料相容性問題。
### ✨ 新功能
- 示例聊天記錄改為動態時間軸，匯入時會呈現最近一整年的完整資料
### 🐛 修復
- 修正新版 QQ Chat Exporter 的 chunked JSONL 匯出無法辨識，或在大型群組中被誤判為空白匯入的問題
- 官方示例匯入新增跨時區校正、失敗回復與逾時控制，避免部分匯入
- 強化 ChatLab 格式的系統訊息辨識與早期資料庫移轉相容性，避免資料解析或升級失敗
- AI 對話不再將使用者訊息正文寫入日誌，降低本機隱私外洩風險
## v0.34.0 (2026-07-23)
> 新增私人聊天歷程與足跡趨勢分析，重新整理工作階段洞察導覽，並修正僅限好友的關係圖。
### ✨ 新功能
- 私人聊天洞察新增「歷程」，呈現年度篇章、每月足跡與關鍵時刻
- 足跡新增年度活動節奏與每月直接聯絡人趨勢
- 將工作階段概覽整合至洞察，並統一桌面版、CLI Web 與 Web WASM 的分析導覽
- 重新設計關係洞察的互動歷程，以階段摘要與關鍵時刻取代冗長明細
### 🐛 修復
- 僅限好友的關係星圖只顯示好友節點、好友關係與好友搜尋結果，並提高連線辨識度
### ♻️ 重構
- 統一 LLM 設定的儲存與移轉，降低跨平台設定差異與同時寫入風險
- 重新整理工作階段洞察元件，並移除已停用的匯入與資料庫程式碼
- 【桌面版】精簡主程序與封存檔匯入的重複實作
## v0.33.0 (2026-07-22)
> 新增 Docker 部署方式與支援行動裝置的純瀏覽器本機分析版，並完善聊天格式轉換驗證及本機資料安全。
### ✨ 新功能
- 新增純瀏覽器本機分析版，可直接在瀏覽器中匯入、管理及分析聊天工作階段
- 新增中英文聊天記錄轉換 Skill，可產生 ChatLab 標準格式並離線驗證
- 【CLI】新增 ChatLab 格式驗證指令
### 🐛 修復
- 修正純 Web 版同時存取 OPFS、概覽篩選競態、詞頻統計與關係分析篩選問題
- 前端圖示改為隨應用程式一併封裝，避免執行時依賴外部圖示服務
- 統一 ChatLab JSONL 自動辨識與格式驗證規則，並拒絕無法解析的 owner 資訊
- 【桌面版】防止移轉程序刪除目前使用中的資料目錄，並拒絕新舊資料目錄互相巢狀或指向同一路徑
- 【CLI】Docker 部署會保存使用者資料與系統狀態，並預設只將連接埠綁定至 localhost
### 📝 文件
- 新增 Docker 部署指南，並補充 AI 分析效益與本機隱私說明
### 👷 CI
- 發布適用於 amd64 與 arm64 架構的 ChatLab CLI Docker 映像檔
## v0.32.0 (2026-07-18)
> 新增桌面版應用程式鎖定，強化資料移轉安全性，並修正大型檔案與多檔匯入問題。
### ✨ 新功能
- 【桌面版】新增應用程式鎖定，支援密碼、立即鎖定、啟動時解鎖，以及閒置逾時自動鎖定
### 🐛 修復
- 資料目錄移轉後保留舊資料並提示使用者手動確認清理，避免移轉或重試時誤刪來源檔案
- 大型 ChatLab JSONL 改為串流分批處理，避免匯入卡住，並保留合併匯入中的成員頭像
- 統一桌面版與 CLI Web 的多檔批次匯入流程，提供循序處理進度、取消與結果摘要
- 【桌面版】應用程式鎖定新增失敗次數限制、冷卻時間與啟動狀態保護，避免重新整理或重新啟動後繞過鎖定
## v0.31.3 (2026-07-17)
> 新增成員批次刪除，調整預設助理系統提示詞，重新整理排行榜分析，並完善暫存目錄清理機制。
### ✨ 新功能
- 成員管理支援批次刪除已選成員，送出前會先確認影響範圍
- 群組聊天分析拆分為「洞察」與「排行榜」入口，集中呈現總榜、複讀、口頭禪與關鍵字排行
### ♻️ 重構
- 統一 Desktop 與 CLI Web 的 HTTP 服務、錯誤模型、系統與會話路由及 JSON Push 協定
- 重新整理桌面端的啟動、視窗、路徑與執行階段模組，並移除多餘的重新匯出層
## v0.31.2 (2026-07-16)
> 統一群組與私人聊天的成員管理，補強自動匯入提示，並修正截圖複製與介面穩定性。
### ✨ 新功能
- 成員管理改用虛擬化表格，支援依訊息數、群組暱稱與最後發言時間排序，以及整列點選與 Shift 連續多選
- 群組與私人聊天共用同一套成員管理，包含搜尋、別名、檢視聊天記錄、合併與刪除
- 增量匯入視窗新增首頁自動匯入提示，協助了解後續匯入方式
### 🐛 修復
- 【CLI Web】修正截圖無法直接複製為圖片的問題
## v0.31.1 (2026-07-15)
> 重新整理首頁匯入入口，新增 Agent／CLI 匯入預覽，並修正匯入一致性、訊息排序與側邊欄版面。
### ✨ 新功能
- 首頁匯入入口重新整理為檔案、API 與 CLI 三種方式
- 新增官方中英文匯入與分析 Skill
- API 匯入支援冪等鍵，重複請求可安全沿用結果並偵測衝突
### 🐛 修復
- 統一各端 Push 匯入的驗證、去重、成員推斷與 dry-run 結果，避免預覽與實際寫入不一致
- 補匯入歷史訊息後，聊天記錄會依時間與訊息 ID 穩定排序，避免舊訊息出現在最後
- 修正 QCE / QQ Chat Exporter 私人聊天被誤判為群組並產生「0」成員的問題
## v0.31.0 (2026-07-13)
> 全面優化介面樣式，首頁支援自動增量匯入，新增個人洞察，並改善身份管理與匯入相容性。
### ✨ 新功能
- 新增自動會話匹配與自動增量匯入編排，匯入同一份聊天匯出時可更自然地接續到既有會話
- 新增全域洞察入口，支援年度活動概覽、日曆熱力圖與訊息趨勢
- 設定中可管理會話 owner 身份，匯出與重新匯入時會保留 owner 與成員別名資訊
- 【CLI】支援自動增量匯入
- 【桌面端】支援自動增量匯入
### 🐛 修復
- 修正 ChatLab JSON 匯出無法直接重新匯入的問題，並保留成員、owner 與別名元資料
- 強化自動增量匯入的去重、混合訊息身份識別與 ChatLab 重複匯入判斷
- WhatsApp TXT 解析支援括號時間戳與點號 AM/PM 標記
### ♻️ 重構
- 統一導航、卡片與報告元件結構，減少不同頁面之間的互動差異
### 💄 樣式
- 優化側邊欄、輸入區、篩選控制項與設定頁籤樣式
- 精簡會話時間篩選器與 AI 對話側欄版面，讓資訊密度更緊湊
## v0.30.2 (2026-07-10)
> 進一步提升匯入效能，並優化語意索引、本機模型下載等體驗。
### ✨ 新功能
- 新增 ChatLab JSON 的 Rust 原生解析核心，匯入速度提升 10 倍以上
- 語意索引本機模型新增多個下載來源，提高模型取得成功率
- 放寬人際關係入口顯示門檻，讓更多會話可以進入聯絡人與關係分析
### 🐛 修復
- 修正未設定自訂詞典時 Jieba 分詞實例反覆重建的問題，加快匯入與全文索引
- ChatLab JSON 匯入改為結構化讀取成員資訊，避免複雜成員陣列導致頭像或角色遺失
- 語意索引會在共用預算內截斷過長內容與傳送者名稱，降低 embedding 輸入過長造成的失敗
- 儲存空間管理說明改為限定託管資料目錄範圍，避免將非託管路徑誤認為可自動管理
## v0.30.0 (2026-07-05)
> 新增面向 Agent 的使用入口，並改善聊天記錄篩選、匯出、頭像匯入與同步體驗。
### ✨ 新功能
- 【CLI】新增給外部 Agent 使用的命令
- 聊天記錄彈窗支援依成員篩選，並共用成員搜尋選擇器
### 🐛 修復
- 改善混亂聊天內容的顯示，減少記錄彈窗中的顯示異常
- 修正 SQL 實驗室匯出 CSV 失敗的問題
- 匯入 JSONL 等串流成員資料時保留頭像，並支援增量匯入新頭像
- 開啟 AI 日誌改由共享路由處理，讓本機 CLI Web 與桌面端行為一致
- 概覽身份卡會跟隨目前選取的時間範圍更新
### 📝 文件
- 新增 Agent 查詢命令使用文件，並提供 chatlab-analyze 技能入口
## v0.29.0 (2026-07-01)
> 新增聯絡人功能與關係星圖，改善聯絡人計算、頭像載入與側邊欄效能。
### ✨ 新功能
- 新增人際關係模組，將聯絡人作為子頁面，支援跨會話聯絡人彙整、時間範圍篩選、分頁與虛擬捲動
- 聯絡人頁支援手動將群組成員標記為好友，並提供前往來源對話與檢視聊天記錄的入口
- 新增互動關係星圖，支援 3D 全景、節點篩選、搜尋、詳情面板，以及相關聯絡人/群組探索
- 關係星圖支援高關聯、僅好友等視圖篩選，並在隱私模式下遮蔽姓名
- 【桌面端】支援在背景靜默下載應用程式更新
### ⚡ 效能
- 聯絡人列表改用分頁與虛擬捲動，降低大量好友與群組成員造成的渲染壓力
- 頭像改為懶載入，並將側邊欄會話列表虛擬化，減少啟動與頁面切換卡頓
### 💄 樣式
- 統一暗色模式的主背景、關係頁頂部與側邊欄選取狀態
## 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】新增統一啟動指令 clb web，支援 --headless 和 --no-open 參數
- 【CLI】新增背景服務模式，支援 clb web --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 串流回應中的 內容未正確識別為思考事件的問題
- 【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 對話中的連結開啟方式。
從這個版本開始，專案將正式遷移至 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