基于 Chatlog API 的现代化微信聊天记录查看器
一个现代化的 Web 应用，提供类似微信的界面来查看和管理您的聊天记录。
专注于隐私保护、极致性能与流畅体验。
Chatlog Session 是一个专为 Chatlog 设计的现代化前端客户端。它采用 Vue 3 + TypeScript + Vite 技术栈构建，旨在为您提供一个熟悉、流畅且功能强大的聊天记录管理界面。
这是一个纯前端应用。
所有数据都在您的浏览器本地处理（IndexedDB）和展示，绝对不会上传到任何第三方服务器。您的聊天记录、联系人信息等敏感数据完全由您掌控。
- 📌 本地会话置顶：突破服务端限制，自由置顶重要会话，支持折叠分组。
- 📊 全新仪表盘：直观展示聊天统计数据，回顾您的社交足迹。
- 🎬 Live Photo 支持：直接在浏览器中预览和播放 Live Photo 及视频消息。
- 🔍 智能筛选：快速筛选“聊天”、“置顶”会话，查找更高效。
- 🎨 原生体验：深度复刻微信 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. 安装依赖
npm install
# 3. 启动开发服务器
npm run dev
# 访问 http://localhost:5173本项目基于以下优秀的开源技术构建：
| 类型 | 技术 | 说明 |
|---|---|---|
| 核心框架 | Vue 3 | 组合式 API, <script setup> |
| 语言 | TypeScript | 类型安全，开发体验极佳 |
| 构建工具 | Vite | 极速冷启动与热更新 |
| 状态管理 | Pinia | 直观、轻量的状态管理库 |
| UI 组件 | Element Plus | 优雅的桌面端组件库 |
| 性能优化 | vue-virtual-scroller | 处理海量数据的虚拟滚动方案 |
| 本地存储 | IndexedDB (idb) | 浏览器端高性能大容量存储 |
- v0.15.0: 本地会话置顶、Dashboard 重构、Live Photo 支持
- v0.14.0: 聊天记录/转发消息增强、消息列表体验优化
- v0.13.0: PWA 核心功能（Service Worker、Manifest）
- v0.12.0: 通知优化、隐私设置增强
- v0.11.0: 图片占位符、消息自动刷新与缓存
- v0.16.0: 数据导出增强
- v0.17.0: 滚动位置记忆、手势返回、下拉刷新
- v1.0.0: 正式版发布
详细路线图请参考 ROADMAP.md
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