基于 Chatlog API 的现代化微信聊天记录查看器
一个现代化的 Web 应用，提供类似微信的界面来查看和管理您的聊天记录。 专注于隐私保护、极致性能与流畅体验。
Chatlog Session 是一个专为 Chatlog 设计的现代化前端客户端。它采用 Vue 3 + TypeScript + Vite 技术栈构建，旨在为您提供一个熟悉、流畅且功能强大的聊天记录管理界面。
这是一个纯前端应用。
所有数据都在您的浏览器本地处理（IndexedDB）和展示，绝对不会上传到任何第三方服务器。您的聊天记录、联系人信息等敏感数据完全由您掌控。
- 🖼️ 媒体预览体验升级：图片/视频点击统一为站内预览，不再弹出浏览器新窗口打断阅读。
- 🧭 图片串行浏览：
ImageViewer支持会话内上一张/下一张切换，支持键盘←/→快速切图。 - 🔍 渐进式高清加载：默认先显示预览小图，高清加载成功后自动替换，并显示“加载中/失败”状态。
- 🧱 历史加载稳定性增强：优化 EmptyRange/Gap 历史探测与相邻空窗口合并，减少重复提示。
- ⏱️ 消息顺序一致性：新增时间归一与有序合并策略，提升历史加载、缓存混合场景下的时序可靠性。
- 🪟 虚拟窗口语义升级：Gap 与 EmptyRange 职责分离，Gap 仅在“待补齐缺口”场景出现，EmptyRange 仅表达“已证实空窗”。
- 🧭 历史锚点更稳定：历史加载优先使用顶部虚拟消息锚点推进，减少重复探测同一时间窗口。
- 🧩 Gap 生命周期优化：补充 Gap 合并/消亡规则，只有检测到明确重复衔接时才判定缺口被打通。
📌 详细变更请查看：
docs/changelog/CHANGELOG_v0.18.0.md～docs/changelog/CHANGELOG_v0.22.0.md
- 🎨 原生体验：深度复刻微信 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.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.22.0: 搜索能力增强（更多筛选条件、搜索结果高亮与定位优化）
- v0.23.0: 导出体验升级（导出模板、批量任务、失败重试与断点续导）
- v0.24.0: 搜索能力增强（更多筛选条件、搜索结果高亮与定位优化）
- v0.25.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