ChatLab/changelogs/tw.md

更新日誌

v0.37.2 (2026-09-18)

修正 AI 回覆遭截斷或停止後無法順利接續對話的問題，改善表情符號辨識、技能入口與下載安全檢查。

✨ 新功能

• 詞頻與語言偏好分析可辨識抖音表情代碼，避免將表情名稱列入高頻詞 (by @babybitter)

🐛 修復

• 修正部分介面在 AI 回覆遭截斷後遺失已產生內容或用量資訊的問題，儲存後可接續對話
• 修正手動停止 AI 回覆後未儲存已產生內容，導致後續提問可能遺失對話脈絡的問題 (by @Sanssssssssssssssss)
• 停止 AI 請求時一併取消上下文壓縮，避免額外的模型呼叫與摘要寫入 (by @Sanssssssssssssssss)
• 修正下載介面的檔名檢查，防止檔案寫入下載資料夾以外的位置 (by @ttsdj)

♻️ 重構

• 統一外部 Agent 的匯入、轉換與分析技能入口，依使用者的語言回覆，並保留已發布版本中舊匯入技能安裝指令的相容性

v0.37.1 (2026-09-04)

新增貢獻者署名，改善 Docker 啟動，並修正 AI 工具迴圈、文字統計與關係圖資源占用問題。

✨ 新功能

• 語言偏好、詞頻與口頭禪分析支援讀取語音轉寫內容 (by @babybitter)
• 【CLI】Docker 映像檔內建預設中文斷詞詞典，首次啟動不再需要下載 (by @KokerZhou)

🐛 修復

• 修正 AI 工具呼叫達到回合上限後可能重複產生最終回覆、工具錯誤被記為成功，以及上下文內容重複寫入的問題 (by @Sanssssssssssssssss)
• 修正系統通知和分享預留文字被納入詞頻、語言偏好與口頭禪統計的問題，並保留使用者的表情符號內容 (by @babybitter)

v0.37.0 (2026-08-28)

新增跨對話 AI 分析與長期記憶，修正匯入去重、AI 回覆失敗等多項問題，並改善洞察效能與聊天記錄檢視體驗。
目前跨對話分析的測試仍不完整，屬於實驗性功能，後續版本將持續改善。

✨ 新功能

• 新增全域 AI 對話，可跨聯絡人與群組搜尋、比較活躍度與互動，並顯示可直接跳轉的來源證據
• 新增加長期記憶，可管理偏好、關於我、聯絡人與群組記憶，並依問題自動載入相關內容
• 長期記憶可連結來源訊息，方便回到原始對話核對 AI 產生的結論
• 統一全域與單一對話 AI 的對話清單、輸入框和 @ 選取操作
• 聊天記錄檢視器可拖曳調整寬度，並記住版面設定 (by @KokerZhou)
• 分析頁將 SQL 實驗室與除錯工具統一收納至「更多」
• 【CLI】支援透過 Unix Domain Socket 啟動 Web 服務 (by @KokerZhou)

🐛 修復

• 修正 WeFlow 與缺少穩定訊息 ID 的聊天記錄在增量匯入、合併時可能過度去重的問題，避免真實訊息遺失
• 修正 AI 回覆失敗後，錯誤狀態、對話清單與後續提問可能異常的問題 (by @Sanssssssssssssssss)
• 修正 AI 對話在儲存或編輯時可能留下不完整輪次的問題，並僅允許編輯最新一輪提問 (by @Sanssssssssssssssss)
• 修正長對話壓縮可能遺失訊息邊界或記憶來源連結的問題 (by @Sanssssssssssssssss)
• 修正同名 AI 服務設定可能讀取錯誤憑證的問題 (by @Sanssssssssssssssss)
• 修正切換或返回分析頁面時可能重複載入，或繼續顯示匯入前舊資料的問題
• 完善跨對話分析的時間範圍、聯絡人解析、掃描預算與截斷提示

⚡ 效能

• 降低大型資料集下，對話關係圖與關係星空圖查詢的記憶體尖峰用量

v0.36.2 (2026-08-20)

改善 AI 對話過程呈現與長對話效能，群組排行支援成員頭像。

✨ 新功能

• 改善 AI 回覆排版、使用者氣泡與操作按鈕，游標停留時顯示訊息時間
• AI 對話將思考、規劃與工具執行整理成可展開的過程區塊，完成後顯示耗時與步驟
• 群組排行榜及相關圖表顯示成員頭像
• 排行榜載入時維持卡片對齊，避免版面跳動

🐛 修復

• 匯入資料夾改為獨立按鈕，避免與選取檔案互相搶入口 (by @kongjiyu)

⚡ 效能

• 改善長對話渲染效能，串流輸出改為批次更新，並支援分段載入較早的紀錄

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 與工作階段身分資訊
• 修正動態關鍵字排行的請求、快速切換與多色模式，避免顯示過期結果或因未知類型導致頁面當機 (by @kelaocai)
• 統一洞察頁面的載入轉場，並恢復年度活動日曆配色與關係檢視切換控制項

⚡ 效能

• 最佳化增量匯入去重，只在需要時查詢既有的候選訊息，降低大型資料庫匯入時的記憶體用量

v0.34.2 (2026-08-01)

提升大型檔案與批次匯入效能，完善 CLI 本機語意索引，並強化資料移轉與匯入穩定性。

✨ 新功能

• QQ Shuakami 與 QQ Chat Exporter 匯入改用 Rust 原生解析，提升大型匯出檔案的處理穩定性
• 多檔案匯入加入安全的並行排程，避免同一工作階段同時寫入，並顯示各檔案的進度與失敗資訊
• 新增兼顧隱私的匿名產品統計，只回報白名單內的執行環境與功能使用事件
• 【CLI Web】本機語意索引執行元件改為首次使用時按需安裝，Docker 映像仍預先內建所需元件 (by @kelaocai)

🐛 修復

• 自動匯入會略過 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、概覽篩選競態、詞頻統計與關係分析篩選問題
• 前端圖示改為隨應用程式一併封裝，避免執行時依賴外部圖示服務 (by @KokerZhou)
• 統一 ChatLab JSONL 自動辨識與格式驗證規則，並拒絕無法解析的 owner 資訊
• 【桌面版】防止移轉程序刪除目前使用中的資料目錄，並拒絕新舊資料目錄互相巢狀或指向同一路徑
• 【CLI】Docker 部署會保存使用者資料與系統狀態，並預設只將連接埠綁定至 localhost (by @KokerZhou)

📝 文件

• 新增 Docker 部署指南，並補充 AI 分析效益與本機隱私說明 (by @KokerZhou)

👷 CI

• 發布適用於 amd64 與 arm64 架構的 ChatLab CLI Docker 映像檔 (by @KokerZhou)

v0.32.0 (2026-07-18)

新增桌面版應用程式鎖定，強化資料移轉安全性，並修正大型檔案與多檔匯入問題。

✨ 新功能

• 【桌面版】新增應用程式鎖定，支援密碼、立即鎖定、啟動時解鎖，以及閒置逾時自動鎖定 (by @xyz-225648)

🐛 修復

• 資料目錄移轉後保留舊資料並提示使用者手動確認清理，避免移轉或重試時誤刪來源檔案
• 大型 ChatLab JSONL 改為串流分批處理，避免匯入卡住，並保留合併匯入中的成員頭像
• 統一桌面版與 CLI Web 的多檔批次匯入流程，提供循序處理進度、取消與結果摘要
• 【桌面版】應用程式鎖定新增失敗次數限制、冷卻時間與啟動狀態保護，避免重新整理或重新啟動後繞過鎖定 (by @xyz-225648)

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」成員的問題 (by @shuakami)

v0.31.0 (2026-07-13)

全面優化介面樣式，首頁支援自動增量匯入，新增個人洞察，並改善身份管理與匯入相容性。

✨ 新功能

• 新增自動會話匹配與自動增量匯入編排，匯入同一份聊天匯出時可更自然地接續到既有會話
• 新增全域洞察入口，支援年度活動概覽、日曆熱力圖與訊息趨勢
• 設定中可管理會話 owner 身份，匯出與重新匯入時會保留 owner 與成員別名資訊
• 【CLI】支援自動增量匯入
• 【桌面端】支援自動增量匯入

🐛 修復

• 修正 ChatLab JSON 匯出無法直接重新匯入的問題，並保留成員、owner 與別名元資料
• 強化自動增量匯入的去重、混合訊息身份識別與 ChatLab 重複匯入判斷
• WhatsApp TXT 解析支援括號時間戳與點號 AM/PM 標記 (by @hh7418695)

♻️ 重構

• 統一導航、卡片與報告元件結構，減少不同頁面之間的互動差異

💄 樣式

• 優化側邊欄、輸入區、篩選控制項與設定頁籤樣式
• 精簡會話時間篩選器與 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 與桌面端行為一致
• 概覽身份卡會跟隨目前選取的時間範圍更新 (by @qikairo7)

📝 文件

• 新增 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 回歸問題 (by @qikairo7)
• 修正排行榜標籤與 emoji 清理 (by @qikairo7)
• 修正 v8 資料庫遷移缺少國際化文字的問題
• 【CLI】修正工具轉接器中會話上下文傳遞與前處理缺失的問題

v0.26.3 (2026-06-15)

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

✨ 新功能

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

⚡ 效能

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

🐛 修復

• 修正高頻詞統計中含有平台回覆訊息占位符的問題 (by @qikairo7)
• 修正詞雲文字中包含媒體占位符的問題 (by @qikairo7)
• 修正 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 時間戳記規範化導致增量匯入異常 (by @cnYui)
• 【桌面版】修正 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 圖表 (by @CEQ151)
• 改善 AI 圖表結果呈現，補上更清楚的渲染狀態與多種圖表類型支援 (by @CEQ151)

🐛 修復

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

♻️ 重構

• 集中管理 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 服務，讓前端可透過統一服務轉接層使用共享介面

🐛 修復

• 修正資料目錄遷移與資料庫遷移流程中的多個邊界情境，避免舊資料庫欄位缺失或路徑切換後讀取失敗
• 修正舊資料不存在或目錄變更後，資料遷移提示仍錯誤顯示的問題
• 修正增量匯入後側邊欄訊息數量未更新的問題 (by @CEQ151)
• 修正側邊欄收合狀態只存於 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 回覆處建立獨立分支對話 (by @CEQ151)
• 狀態列新增推理強度選擇器，支援為每個推理模型個別記憶並切換思維等級
• 推理等級控制新增 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 端事件串流與錯誤格式化等問題 (by @CEQ151)
• 修復同步顯示與匯入邏輯不一致的問題
• 修復 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)

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

✨ 新功能

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

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 字元的解析相容性問題 (by @kongjiyu)

🔧 雜項

• 快取 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 測試框架，支援連接埠管理與實例隔離 (by @l17728)

🐛 修復

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

♻️ 重構

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

test

• 補充可重複使用的 E2E 啟動器冒煙測試能力 (by @l17728)

📝 文件

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

💄 樣式

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

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 服務設定頁
• 優化身份卡片與助手選擇互動

🐛 修復

• 修復訊息去重誤判，並統一空字串的去重行為 (by @lnexin)
• 修復 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 支援依會話顯示上下文時間軸與執行狀態 (by @n-WN)
• 新增 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 檔案的問題 (by @n-WN)

♻️ 重構

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

🔧 雜項

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

v0.9.4 (2026-02-08)

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

✨ 新功能

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

🐛 修復

• 修復 LINE 聊天紀錄解析問題 (by @haotien91)

📝 文件

• 更新專案文件

v0.9.3 (2026-02-03)

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

✨ 新功能

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

🐛 修復

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

♻️ 重構

• 重構 session 查詢模組
• 補強遷移日誌輸出 (by @xunchahaha)

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） (by @JiQingzhe2004)

🔧 雜項

• 移除 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 模型，並加入豆包服務商與最新模型 (by @JiQingzhe2004)
• 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