ChatLab/changelogs/cn.md

更新日志

v0.37.6 (2026-10-22)

完善导入格式失败引导，支持将记忆设为会话默认页面，并修复 MCP 数组参数类型问题。

🐛 修复

• 无法识别聊天记录格式时提供说明和 AI 转换指南，支持单文件与批量导入，并适配多语言
• 支持将记忆设为进入聊天会话后的默认页面 (by @KokerZhou)
• 【MCP】修复字符串、数字和布尔值数组参数被错误识别为字符串、导致工具调用失败的问题 (by @moesnow)

v0.37.5 (2026-09-28)

统一右侧面板交互，新增桌面界面缩放，并修复会话加载、数据源配置与代理模型下载问题。

✨ 新功能

• 统一聊天记录、联系人详情和聊天话题的右侧面板，支持页头展开收起、拖动调宽，并保留收起前的浏览位置
• 【桌面端】新增界面缩放设置

🐛 修复

• 修复部分 Windows 用户升级后因重复写入数据目录兼容标记而无法加载会话列表的问题
• 修复远程数据源配置读取或保存失败时可能覆盖原配置、误报成功的问题，保留原文件并明确提示错误
• 修复使用代理时本地语义模型下载后无法写入缓存、导致模型加载失败的问题 (by @huaqian0226)

v0.37.4 (2026-09-23)

优化 AI 工具结果的上下文控制，修复 Qwen 话题总结问题，并完善会话加载失败提示。

🐛 修复

• 修复 AI 多轮或并行工具调用的结果累积后可能超出模型上下文限制的问题，按请求裁剪工具结果并保留完整对话记录 (by @Sanssssssssssssssss)
• 修复部分 Qwen 模型在话题总结时因默认开启思考而无法生成结果的问题
• 话题总结达到模型输出上限时显示明确提示，避免无效重试造成额外消耗
• 会话列表加载失败时完整展示错误详情，并在应用日志中保留完整错误堆栈，便于排查升级后的权限等问题
• 补齐 AI 词频与回复速度分析工具的英文时间参数说明
• 【CLI】Docker 镜像改用与 npm 发布相同的安装包，避免 npm 同步延迟导致镜像发布失败

v0.37.3 (2026-09-22)

修复 AI 时间筛选、Qwen 模型兼容与续聊问题，完善多语言支持和消息上下文查询。

✨ 新功能

• 完善 AI 工具说明的中英文适配，统一桌面端、CLI Web 与 MCP 的语言处理 (by @Zycheng114514)

🐛 修复

• 修复 AI 词频与回复速度分析忽略所选时间范围的问题，明确提问时间、页面筛选与默认范围的优先级 (by @liuyy2)
• 修复部分 Qwen 模型在 AI 对话、话题总结时因消息角色不兼容而报错的问题
• 修复补录历史消息后上下文可能错位的问题，并优化消息上下文检索性能 (by @Sanssssssssssssssss)
• 补齐语言偏好卡片中缺失的日语标签 (by @Zycheng114514)
• 【CLI】修复 AI 续聊遗漏已完成工具调用结果的问题，保留工具结果与错误状态供后续对话使用 (by @Sanssssssssssssssss)
• 【CLI】修复 Docker 镜像发布可能因 npm 新版本尚未同步而失败的问题

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)

新增群聊关系星空图与 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 原生解析，提升大型导出文件的处理稳定性
• 多文件导入新增安全并发调度，避免同一会话并发写入，并提供逐文件进度和失败详情
• 新增隐私安全的匿名产品统计，仅上报白名单内的运行环境与功能使用事件
• 【Web CLI】本地语义索引运行组件改为首次使用时按需安装，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 批量嵌入提速与本地模型惰性加载，修复语义索引断点续跑、同步游标回退与对话导出等多项问题。

✨ 新功能

• 语义索引支持 API 嵌入模型批量向量化，大幅提升索引构建速度
• 本地嵌入模型改为惰性 Worker 加载，减少启动资源占用

🐛 修复

• 修复 AI 对话导出：支持导出当前可见的 AI 对话内容
• 修复语义索引批量写入中途崩溃后续跑触发唯一约束错误、会话状态卡死的问题
• 修复语义 Worker 多项问题：配置变更未同步到运行中 Worker、可用性探针异常影响普通 AI 对话、活跃构建状态追踪不准确导致 Worker 提前关闭
• 修复同步拉取游标：空响应重试前未保存初始页服务端水位，导致重复拉取尾部窗口
• 修复同步拉取分页游标错误回退，避免重复导入

♻️ 重构

• 清理多处死代码与过度设计的抽象，简化工具目录结构与深合并逻辑

v0.27.0 (2026-06-22)

引入向量索引与证据检索功能，支持基于向量搜索定位并呈现聊天证据，新增索引管理界面。

✨ 新功能

• 新增语义索引管理界面，支持选择指定会话构建向量索引，提供多语言支持
• 新增 retrieve_chat_evidence 工具：AI 可通过语义搜索检索带时间定位的聊天证据
• 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】暴露完整智能体流式事件

🐛 修复

• 修复显式选择图表技能时 render_chart 工具丢失的问题
• 修复显式图表模式下工具可用性缺口及错误后计划状态异常
• 迁移 ECharts 6 containLabel 配置，隐藏多余饼图图例
• 修复设置页导航顺序、skillSettings 键名及 SubTabs 换行问题
• 修复 AI 助手消息未填满聊天区域宽度
• 优化分析计划生成区块的展示样式
• 修复思考深度选择跨重启不持久的问题
• 修复 JSONL 时间戳规范化导致增量导入异常 (by @cnYui)
• 【桌面端】修复 execute_sql 工具未注册到桌面端工具注册表

test

• 新增智能体路由决策评估测试集

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 配置、助手、技能、会话、流式响应、缓存和合并相关接口迁移到共享 HTTP 路由
• 精简桌面端 IPC 桥接层，移除遗留的 AI、会话索引、LLM、Assistant、Skill、NLP 等 IPC 兼容代码
• 统一前端服务层，减少 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 上服务路径含空格时守护进程启动失败的问题

♻️ 重构

• 重构消息分支系统为「编辑并重新生成」模型，支持仅更新当前轮或覆盖后续消息两种模式
• 移除模型配置中的「推理模型」和「禁用思维模式」开关，改为按能力自动推断
• 简化模型切换按钮 UI，优化会话索引加载性能

v0.22.1 (2026-05-29)

新增会话摘要详细程度配置，修复服务版批量摘要卡死、AI 配置编辑误判及多处 AI 凭据检测问题。

✨ 新功能

• 新增会话摘要详细程度设置，支持「简洁」与「标准」两种策略，可在 AI 设置中切换

🐛 修复

• 修复 OpenAI 兼容模式下修改 Base URL 后未重新验证凭据的问题
• 修复 API Key 已设检测逻辑错误，防止旧 key 被意外复用
• 修复批量生成摘要时点击停止需等待当前请求完成才响应的问题
• 【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 用法
• 修复自更新与迁移重试流程中的安全保护问题
• 【桌面端】修复统一迁移可能回退数据目录改动的问题
• 【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)

优化同步拉取可靠性与数据安全性，新增移除订阅时清理聊天记录选项，并修复 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 代理集成提供基础能力
• 新增独立 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
• 统一关系分析相关 Tab
• 将语录模块整体迁移到洞察
• 将关键词分析迁移到实验室

🐛 修复

• 修复存量类型警告
• Pull 增量同步增加 60 秒重叠窗口，避免消息丢失
• Pull 拉取时固定 limit=1000，避免远端数据源导出过多数据导致卡顿
• 修复 Windows 更新时 NSIS 弹窗导致静默安装中断的问题

v0.17.5 (2026-04-21)

修复了大量BUG。

✨ 新功能

• 优化关系卡片样式
• 以原生机器标识逻辑替换 node-machine-id 依赖，提升 Linux 下 API 密钥修改稳定性
• 合并聊天记录时支持可选保留原记录
• 预设服务与第三方服务 API 地址旁新增验证按钮

🐛 修复

• 优化 dataSource 迁移策略，提升迁移安全性
• 修复话题在消息过少时空状态显示异常
• 修复本地模型验证失效问题
• 修复切换对话后所选 Tab 被重置的问题
• 修复旧版 dataSources 升级后自动化页面白屏问题

v0.17.4 (2026-04-19)

实现 Import API v1 完整协议并新增层级数据源管理，现已支持聊天记录自动同步。

✨ 新功能

• 实现 Import API v1 完整协议与层级数据源管理

v0.17.3 (2026-04-17)

私聊新增语言偏好Tab，侧边栏对话列表支持排序筛选，完善 AI 服务商与模型配置能力，并修复时间筛选重置问题。

✨ 新功能

• 对话列表新增排序与筛选能力
• 新增语言偏好页签，支持偏好查看
• 优化界面样式细节与视觉一致性
• AI 服务商新增 Anthropic 支持
• 模型第三方服务支持自选接口类型
• AI 模型配置支持自定义名称

🐛 修复

• 修复从设置或 AI 对话页返回后时间筛选被重置为“全部”的问题

♻️ 重构

• 抽离语言偏好为共享类型，减少重复定义

v0.17.2 (2026-04-15)

新增跨平台数据合并与成员消息合并，强化词库与更新安全校验，优化暗色体验与日志能力，以及修复若干BUG。

✨ 新功能

• 成员管理支持成员消息合并
• 支持跨平台聊天数据合并
• 数据管理部分表头支持排序
• 话题分析入口迁移至洞察模块
• 新增 AI 日志文件原始路径记录
• 优化暗色模式配色，提升视觉体验

🐛 修复

• 修复词库刷新与合并 ID 碰撞问题
• 为 OpenAI 兼容请求补充运行时 User-Agent 请求头
• 修复暗色截图导出背景透明异常
• 词库下载新增 SHA256 完整性校验
• 收紧远程配置拉取策略并强化更新安装确认

🔧 杂项

• 新增 ARM Linux 的 deb 安装包构建支持
• 优化日志同步流程

📝 文档

• 新增繁体中文文档

v0.17.1 (2026-04-13)

重构话题模块并新增话题卡片，优化词云关键词过滤与查询缓存逻辑，支持远程下载分词词库及繁体中文词库，完善 WhatsApp 检测逻辑。

✨ 新功能

• 重构话题模块，新增话题卡片展示
• 词云支持关键词过滤
• 支持远程下载分词词库，新增繁体中文词库支持
• 查询缓存逻辑优化
• 部分 Loading 交互统一
• 完善 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 对话体验升级，新增AI对话复制、优化 UI，并支持了 FTS5 全文搜索工具，精简部分工具搜索参数，并补强错误提示与测试能力。

✨ 新功能

• 新增 7 天内记住助手选择功能
• AI 对话支持一键复制消息内容
• 优化 AI 对话样式与整体交互体验
• 支持 FTS5 全文搜索并新增快速搜索工具
• 精简部分工具搜索参数，降低 token 开销
• 新增 Electron 应用 E2E 测试框架，支持端口管理与实例隔离 (by @l17728)

🐛 修复

• 完善 AI 对话错误提示，提升问题定位效率

♻️ 重构

• 整理 AI 对话模块代码结构
• 抽取会话分析页公共逻辑并统一头部文案

test

• 补充可复用的 E2E 启动器冒烟测试能力 (by @l17728)

📝 文档

• 更新项目说明中的引导图片

💄 样式

• 统一部分代码格式，提升可读性

v0.14.1 (2026-04-02)

本次更新聚焦首页架构调整，优化UI，以及提升 SQL 对话体验、统计读取性能与AI工具质量。

✨ 新功能

• 优化总览页样式
• 优化 SQL 对话模块交互逻辑
• 将成员管理迁移到首页并调整相关 Tab 模块布局
• 新增部分 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 分词能力，语录 Tab 下新增词云；新增视图功能，支持展示更多图表；支持了系统代理跟随；优化了部分页面和样式。

✨ 新功能

• 用户选择器性能优化，支持虚拟加载
• 迁移榜单到视图Tab
• 引入分词能力，并新增词云子Tab
• 优化群聊页Tab文案
• 网络代理支持跟随系统代理
• 版本日志显示判断逻辑优化

💄 样式

• 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对话新增展示思考内容块；对部分样式进行了优化。

✨ 新功能

• 新增定位日志功能
• 接入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教程
• 1、新增GLM两个免费调用模型 2、新增豆包服务商和对应的最新模型 (by @JiQingzhe2004)
• AI回复不输出think内容

v0.1.3 (2025-12-25)

修复了一些问题。

🐛 修复

• 修复 Echotrace 解析器错误

v0.1.2 (2025-12-25)

支持了深色模式；AI对话中，系统提示词中支持传递给用户身份。

✨ 新功能

• AI对话中，系统提示词中支持传递给用户身份
• 聊天记录查看器中，Owner显示在右侧
• 支持数据库升级
• 成员Tab中支持设置Owner视角
• 支持深色模式

🐛 修复

• 修复私聊误判为群聊的问题

v0.1.1 (2025-12-24)

已适配 WhatsApp 聊天记录的导入；支持旧版 QQ 讨论组格式的分析。

✨ 新功能

• 聊天会话底部显示token消耗
• 支持WhatsApp原生格式消息
• 支持旧版QQ txt版本的讨论组格式

🐛 修复

• 修复消息管理器层级过低的问题

v0.1.0 (2025-12-23)

项目开源并发布。

✨ 新功能

• init