更新 README 和 CHANGELOG 以反映 v0.24.0 版本变更

Author: xlight

README.md

@@ -38,18 +38,17 @@ _基于 Chatlog API 的现代化微信聊天记录查看器_
 
 ## ✨ 功能特性
 
-### 🆕 最新亮点 (v0.22.0)
+### 🆕 最新亮点 (v0.24.0)
 
-- 🖼️ **媒体预览体验升级**：图片/视频点击统一为站内预览，不再弹出浏览器新窗口打断阅读。
-- 🧭 **图片串行浏览**：`ImageViewer` 支持会话内上一张/下一张切换，支持键盘 `←/→` 快速切图。
-- 🔍 **渐进式高清加载**：默认先显示预览小图，高清加载成功后自动替换，并显示“加载中/失败”状态。
-- 🧱 **历史加载稳定性增强**：优化 EmptyRange/Gap 历史探测与相邻空窗口合并，减少重复提示。
-- ⏱️ **消息顺序一致性**：新增时间归一与有序合并策略，提升历史加载、缓存混合场景下的时序可靠性。
-- 🪟 **虚拟窗口语义升级**：Gap 与 EmptyRange 职责分离，Gap 仅在“待补齐缺口”场景出现，EmptyRange 仅表达“已证实空窗”。
-- 🧭 **历史锚点更稳定**：历史加载优先使用顶部虚拟消息锚点推进，减少重复探测同一时间窗口。
-- 🧩 **Gap 生命周期优化**：补充 Gap 合并/消亡规则，只有检测到明确重复衔接时才判定缺口被打通。
+- ⭐ **收藏消息支持**：新增对 `type=49, subType=24` 收藏消息的识别与展示能力，不再回退为“未知消息类型”。
+- 🗂️ **收藏卡片与详情浏览**：消息气泡可显示收藏标题、摘要、内容数量与类型标签，并支持弹窗浏览收藏中的文本、图片、视频、文件、位置和链接内容。
+- 🧠 **摘要生成更贴近真实数据**：收藏消息优先从 `recordInfo.DataList.DataItems` 提取首段文本与内容类型，而不是依赖可能为空的 `title/desc`。
+- 🧾 **收藏笔记语义增强**：针对 `WeNoteHtmlFile` / `DataFmt=htm` 样本，详情中会明确标识为“收藏笔记”内容块。
+- 🛡️ **富文本消息兜底更稳**：未知 `type=49` 子类型现在会以“富文本消息”展示，避免新子类型出现时完全失语。
+- 🔍 **会话搜索能力升级**：支持拼音、名称、最后消息预览等多字段匹配，提升查找联系人和会话的命中率。
+- 📦 **工程依赖更新**：同步升级 Vite 与 Axios 相关依赖，保持构建链路和基础网络层的稳定性。
 
-> 📌 详细变更请查看：`docs/changelog/CHANGELOG_v0.18.0.md` ～ `docs/changelog/CHANGELOG_v0.22.0.md`
+> 📌 详细变更请查看：`docs/changelog/CHANGELOG_v0.24.0.md` 与 `docs/changelog/`
 
 ### 核心功能
 
@@ -150,6 +149,8 @@ pnpm dev
 
 ### ✅ 已完成
 
+- [x] **v0.24.0**: 收藏消息类型支持、富文本消息 fallback、依赖升级
+- [x] **v0.23.0**: 会话搜索拼音与多字段匹配优化
 - [x] **v0.22.0**: Gap消息优化
 - [x] **v0.21.0**: 图片会话级串行预览、预览质量与高清加载状态指示、媒体点击行为收敛
 - [x] **v0.20.0**: 历史消息空窗口探测优化、相邻 EmptyRange 自动合并
@@ -165,10 +166,9 @@ pnpm dev
 
 ### 🔮 规划中
 
-- [ ] **v0.22.0**: 搜索能力增强（更多筛选条件、搜索结果高亮与定位优化）
-- [ ] **v0.23.0**: 导出体验升级（导出模板、批量任务、失败重试与断点续导）
-- [ ] **v0.24.0**: 搜索能力增强（更多筛选条件、搜索结果高亮与定位优化）
-- [ ] **v0.25.0**: 会话与媒体管理优化（媒体筛选、批量操作、预览性能继续提升）
+- [ ] **v0.25.0**: 搜索能力增强（更多筛选条件、搜索结果高亮与定位优化）
+- [ ] **v0.26.0**: 导出体验升级（导出模板、批量任务、失败重试与断点续导）
+- [ ] **v0.27.0**: 会话与媒体管理优化（媒体筛选、批量操作、预览性能继续提升）
 - [ ] **v1.0.0**: 正式版发布
 
 > 详细路线图请参考 [ROADMAP.md](https://github.com/xlight/chatlog-session-docs/blob/main/ROADMAP.md)

docs/changelog/CHANGELOG_v0.24.0.md

@@ -0,0 +1,54 @@
+# Changelog
+
+## [0.24.0] - 2026-04-13
+
+### Added
+
+#### 收藏消息类型支持
+
+- 新增对 `type=49, subType=24` 收藏消息的识别能力，不再回退为通用未知消息。
+- 新增收藏消息卡片组件，支持在消息气泡中展示收藏标题、摘要、内容数量与内容类型标签。
+- 新增收藏消息详情弹窗，按收藏内容块顺序展示文本、图片、视频、文件、位置与链接等条目。
+
+#### 富文本消息兜底能力增强
+
+- 为未知 `type=49` 子类型补充类型级 fallback，未单独适配的富文本消息也能显示为“富文本消息”而不是彻底失语。
+- 扩展消息类型校验用例，覆盖收藏消息配置查找。
+
+### Changed
+
+#### 收藏摘要与详情语义优化
+
+- 收藏消息摘要改为优先从 `recordInfo.DataList.DataItems` 生成，而不是依赖经常为空的 `title` / `desc` 字段。
+- 针对 `msgtype-fav.md` 真实样本中的 `WeNoteHtmlFile` / `DataFmt=htm` 结构，将收藏内的 HTML 文件条目标记为“收藏笔记”。
+- 收藏详情展示弱化了转发聊天记录中的“发送者 / 时间 / 头像”语义，遇到缺失来源字段时仍可正常浏览内容块。
+
+#### 工程依赖升级
+
+- 升级 `vite` 相关依赖，继续保持构建链路与开发体验更新。
+- 升级 `axios` 依赖，跟进基础网络库的补丁更新。
+
+### Technical Details
+
+- **新增文件**:
+  - `src/components/chat/message-types/FavoriteMessage.vue` - 收藏消息卡片组件
+  - `src/components/chat/message-types/FavoriteDialog.vue` - 收藏消息详情弹窗
+- **修改文件**:
+  - `src/types/message.ts` - 增加 `RichMessageSubType.Favorite = 24` 及名称/图标映射
+  - `src/components/chat/composables/useMessageType.ts` - 增加收藏消息类型判断
+  - `src/components/chat/composables/useMessageUrl.ts` - 新增基于 `DataItems` 的收藏摘要与内容块提取逻辑
+  - `src/components/chat/message-types/config.ts` - 接入收藏消息配置，并为 `type=49` 添加通用 fallback
+  - `src/components/chat/MessageBubble.vue` - 接入收藏消息组件与详情弹窗交互
+  - `src/components/chat/message-types/registry.ts` / `index.ts` - 注册并导出收藏消息组件
+  - `src/components/chat/message-types/__test-config__.ts` - 增加收藏消息配置校验样例
+
+### User Experience
+
+- 收藏消息现在可以直接在聊天流中识别和阅读，不再只能看到“未知消息类型”。
+- 用户可以从收藏卡片快速进入详情视图，按真实收藏顺序浏览文本与媒体内容。
+- 即使未来继续出现新的 `type=49` 子类型，基础可读性也比之前更稳定。
+
+### Notes
+
+- 本版本基于 `v0.23.0` 之后的提交整理，包含收藏消息支持与依赖升级。
+- 收藏消息实现显式参照了 `chatlog-session-docs/api/examples/msgtype-fav.md` 的真实样本结构。

package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatlog-session",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "基于 Chatlog API 的微信聊天记录查看器",
   "type": "module",
   "packageManager": "pnpm@10.33.0",