基于 Chatlog API 的现代化微信聊天记录查看器
一个现代化的 Web 应用，提供类似微信的界面来查看和管理您的聊天记录。 专注于隐私保护、极致性能与流畅体验。
Chatlog Session 是一个专为 Chatlog 设计的现代化前端客户端。它采用 Vue 3 + TypeScript + Vite 技术栈构建，旨在为您提供一个熟悉、流畅且功能强大的聊天记录管理界面。
这是一个纯前端应用。
所有数据都在您的浏览器本地处理（IndexedDB）和展示，绝对不会上传到任何第三方服务器。您的聊天记录、联系人信息等敏感数据完全由您掌控。
- ⭐ 收藏消息支持：新增对
type=49, subType=24收藏消息的识别与展示能力，不再回退为“未知消息类型”。 - 🗂️ 收藏卡片与详情浏览：消息气泡可显示收藏标题、摘要、内容数量与类型标签，并支持弹窗浏览收藏中的文本、图片、视频、文件、位置和链接内容。
- 🧠 摘要生成更贴近真实数据：收藏消息优先从
recordInfo.DataList.DataItems提取首段文本与内容类型，而不是依赖可能为空的title/desc。 - 🧾 收藏笔记语义增强：针对
WeNoteHtmlFile/DataFmt=htm样本，详情中会明确标识为“收藏笔记”内容块。 - 🛡️ 富文本消息兜底更稳：未知
type=49子类型现在会以“富文本消息”展示，避免新子类型出现时完全失语。 - 🔍 会话搜索能力升级：支持拼音、名称、最后消息预览等多字段匹配，提升查找联系人和会话的命中率。
- 📦 工程依赖更新：同步升级 Vite 与 Axios 相关依赖，保持构建链路和基础网络层的稳定性。
📌 详细变更请查看：
docs/changelog/CHANGELOG_v0.24.0.md与docs/changelog/
- 🎨 原生体验：深度复刻微信 UI 设计，零学习成本，上手即用。
- ⚡ 极致性能：采用虚拟滚动技术，轻松应对十万级消息列表，流畅不卡顿。
- 📱 PWA 支持：可安装至桌面/手机主屏幕，支持离线访问，体验接近原生 App。
- 🔄 实时同步：自动同步最新消息，支持后台静默刷新。
- 📂 多媒体支持：完美支持文本、图片、视频、语音、表情、引用回复等多种消息类型。
- 🔎 全局搜索：支持搜索联系人、群聊及聊天记录内容。
直接访问 GitHub Pages 部署的最新版本，无需任何安装：
👉 https://xlight.github.io/chatlog-session/
首次使用步骤：
- 打开上述链接。
- 进入 设置 (Settings) → API 设定。
- 输入您的 Chatlog API 地址（例如
http://localhost:5030）。⚠️ 可能会由于浏览器安全策略，无法连接 API 地址，请使用 Chrome 并允许不安全内容，或将 API 部署为 HTTPS。 - 点击 测试连接 确认成功，即可开始浏览。
如果您希望完全在本地运行代码：
# 1. 克隆仓库
git clone https://github.com/xlight/chatlog-session.git
cd chatlog-session
# 2. 启用 pnpm（若尚未启用）
corepack enable
# 3. 安装依赖
pnpm install
# 4. 启动开发服务器
pnpm dev
# 访问 http://localhost:5173本项目基于以下优秀的开源技术构建：
| 类型 | 技术 | 说明 |
|---|---|---|
| 核心框架 | Vue 3 | 组合式 API, <script setup> |
| 语言 | TypeScript | 类型安全，开发体验极佳 |
| 构建工具 | Vite | 极速冷启动与热更新 |
| 状态管理 | Pinia | 直观、轻量的状态管理库 |
| UI 组件 | Element Plus | 优雅的桌面端组件库 |
| 性能优化 | vue-virtual-scroller | 处理海量数据的虚拟滚动方案 |
| 本地存储 | IndexedDB (idb) | 浏览器端高性能大容量存储 |
- v0.24.0: 收藏消息类型支持、富文本消息 fallback、依赖升级
- v0.23.0: 会话搜索拼音与多字段匹配优化
- v0.22.0: Gap消息优化
- v0.21.0: 图片会话级串行预览、预览质量与高清加载状态指示、媒体点击行为收敛
- v0.20.0: 历史消息空窗口探测优化、相邻 EmptyRange 自动合并
- v0.19.0: 消息时间归一与有序合并，提升消息顺序稳定性
- v0.18.0: MessageBubble 多类型消息点击处理能力补齐
- v0.17.0: 后台联系人刷新性能优化、聊天记录导出功能
- v0.16.0: 聊天记录导出（JSON/CSV/TXT/MARKDOWN）、进度追踪与取消功能
- v0.15.0: 本地会话置顶、Dashboard 重构、Live Photo 支持
- v0.14.0: 聊天记录/转发消息增强、消息列表体验优化
- v0.13.0: PWA 核心功能（Service Worker、Manifest）
- v0.12.0: 通知优化、隐私设置增强
- v0.11.0: 图片占位符、消息自动刷新与缓存
- v0.25.0: 搜索能力增强（更多筛选条件、搜索结果高亮与定位优化）
- v0.26.0: 导出体验升级（导出模板、批量任务、失败重试与断点续导）
- v0.27.0: 会话与媒体管理优化（媒体筛选、批量操作、预览性能继续提升）
- v1.0.0: 正式版发布
详细路线图请参考 ROADMAP.md
历史版本说明请参考 docs/changelog/
Q: 为什么我的图片无法显示？
- 确保您的 Chatlog API 服务正常运行。
- 检查 设置 中的 API 地址是否正确。
- 由于 chatlog 需要 img_key 才能访问图片资源，请确保您的 API 服务已正确配置并能够提供 img_key。
- 如果是在线版（HTTPS）连接本地 HTTP API，可能会遇到 Mixed Content 问题。建议使用 Chrome 浏览器并允许不安全内容，或将 API 部署为 HTTPS。
Q: 数据是存在哪里的？
所有数据仅存储在您的浏览器 本地缓存 中。当您清除浏览器缓存或卸载 PWA 应用时，这些数据会被清除。我们不会上传任何数据到云端。
更多问题请查看 FAQ 文档。
本项目采用 Apache License 2.0 许可证。详见 LICENSE 文件。
感谢以下项目为 Chatlog Session 提供的支持与灵感：
-
📧 提交 Issue - 发现 Bug 或有功能建议？请通过 GitHub Issues 告诉我们
-
📖 查阅文档 - 详细信息请参阅 项目文档
-
🐧 QQ 交流群 - 欢迎扫码加入 QQ 群，与其他用户和开发者互动
QQ 群号: 1013023266
如果这个项目对您有帮助，请给我们一个 ⭐️
Built with ❤️ by Chatlog Session Team