企业官网建设流程全解析

• 后端
• CLI
• MCP 服务
• 即时通讯
• RAG
• 人工智能
• AI 技能

Chatlog Alpha 是一款面向微信 4.x 的本地聊天数据读取、查询与分析工具。它的 Web 仪表盘让你不用写一行 SQL，就能在浏览器里浏览最近会话、检索历史消息、管理联系人与群聊，并查看消息统计、发言排行和活跃时段等分析视图。本文将带你快速上手这个仪表盘，从启动服务到玩转每个功能面板。

为什么需要 Chatlog Alpha Web 仪表盘？

微信的聊天记录长期以加密数据库的形式存放在本机。想要翻找一条旧消息、统计某个群的活跃情况，通常只能靠肉眼滚动聊天记录。Chatlog Alpha 的做法是：

1. 自动发现微信账号与数据目录；
2. 提取数据库密钥并完成解密（macOS 通过 Frida，Windows 通过进程内存扫描）；
3. 在本地建立 HTTP 服务，把数据库变成可查询、可浏览、可统计的"聊天数据仪表盘"。

所有解密、查询和缓存都在本机执行，数据不经过任何第三方服务器，隐私安全可控。

启动 Web 仪表盘：只需一条命令

按照官方 README（README.md）完成密钥提取后，在 TUI 中执行"启动 HTTP 服务"，或直接用 Action CLI：

./chatlog action start-http --history <历史账号名>

启动成功后，浏览器访问本机地址即可打开仪表盘：

http://127.0.0.1:5030/

几点实用提示：

• 默认监听0.0.0.0:5030，如果不需要局域网访问，建议把监听地址限制为127.0.0.1:5030；
• 如果页面打不开，确认 TUI 已显示"已启动 HTTP 服务"，并检查5030端口是否被占用；
• 健康检查接口为GET /health和GET /api/v1/ping，可用它们快速判断服务状态。

打开页面后，顶部有一排功能标签页：仪表盘 & 数据库、全局搜索、实验性功能、时间知识图谱、推送页面、发信调试、wx-cli 兼容、最近会话、群聊管理、联系人、朋友圈检索、消息检索。页面源码位于 index.htm，下文逐一介绍核心面板。

最近会话面板：快速定位想看的聊天

进入"最近会话"Tab，你可以：

• 输入关键词按昵称 / 备注 / wxid模糊搜索会话；
• 选择输出格式（YAML 或 JSON）后点击"查询 / 导出"。

背后的接口是GET /api/v1/sessions。当你不确定某个聊天对象的确切 ID 时，这个面板是最高效的入口——先在这里找到它，再到消息检索中使用对应的Talker参数。

消息检索面板：时间、关键词、消息类型全维度过滤

"消息检索"Tab 是仪表盘里功能最密集的面板，支持以下过滤条件：

对应接口为GET /api/v1/history。也推荐用命令行方式复现同样的查询（详见 skills/chatlog-http-cli/SKILL.md）：

./chatlog http call \ --endpoint history \ --query chat=<会话ID> \ --query limit=100 \ --query format=json

检索结果中的图片、视频、语音、文件会生成媒体链接，可直接在浏览器中预览，对应媒体路由：

• 图片：/image/*key
• 视频：/video/*key
• 语音：/voice/*key
• 文件：/file/*key

联系人与群聊管理面板

联系人浏览

"联系人"Tab 支持按昵称、备注、wxid 搜索，还能筛选仅好友 / 仅非好友，并限制返回数量。输出可选 YAML 或 JSON。对应接口：

• GET /api/v1/contacts
• 群成员：GET /api/v1/members

群聊管理

"群聊管理"Tab 可按群名称 / 群 ID搜索群聊，默认返回最多 500 条，支持导出 YAML 或 JSON。对应接口GET /api/v1/chatrooms。

两个实用细节：

• 联系人和群聊数据在后台每 30 秒自动刷新缓存，读取失败时会保留上一份完整快照，不会拿到半截数据；
• 群聊消息中的 @ 列表会优先从source字段解析at_user_list，同时兼容旧版compress_content压缩格式，因此群聊历史浏览时 @ 谁一目了然。

仪表盘分析视图：消息统计、发言人排行与活跃时段

"仪表盘 & 数据库"是默认打开的面板，也是整个 Web 界面最有价值的部分，参考 WeFlow 的分析视图设计，包含四大板块：

1. 私聊 / 群聊分析卡片

• 私聊分析：消息类型分布、发送/接收比例、活跃时段，并可按"最近 30 天 / 90 天 / 全部时间"切换范围，还能按消息类型（文本、图片、语音、视频、文件）一键跳转到消息检索；
• 群聊分析：发言排行、消息类型结构与群聊活跃时段，同样支持按时间范围筛选。

2. 群聊数据概览

顶部四张统计卡片展示：消息总量、活跃群聊数、活跃成员数（按群）、语义索引覆盖。时间范围可在今天 / 近 7 天 / 近 1 月 / 近季度 / 近 1 年 / 全部之间切换。对于数据量很大的账号，可以按需点击"统计全部群聊"，避免默认范围限制。

3. 群聊对比与发言人排行榜

• 群聊对比：展示活跃度前 30 个群的消息类型结构与 24 小时活跃度图表，点击卡片可直接跳转到对应的消息检索；
• 发言人排行榜：跨群汇总 Top 15 发言量，谁最活跃、哪个群最热闹，一眼可见。

4. 消息趋势与热点摘要

• 消息趋势：近期每日消息量变化曲线，支持今天到近 1 年多个窗口；
• 热点摘要：基于原始消息统计，点击"生成摘要"后才调用大模型生成热点总结——手动触发设计避免了每次进入页面都消耗 LLM 请求，摘要能力由 route.go 中的GET /api/v1/dashboard/trend接口支撑。

数据库浏览

面板底部还列出当前所有可查询数据库，点击即可浏览表结构与表数据，等价于在图形界面里执行GET /api/v1/db/tables和GET /api/v1/db/query。对于进阶用户，还可以直接跑只读 SQL：

./chatlog http call \ --path /api/v1/db/query \ --query group=message \ --query file=message_0.db \ --query 'sql=SELECT count(*) AS total FROM MSG'

全局搜索面板：跨数据库找关键词

"全局搜索"Tab 会扫描所有可查询数据库，返回命中的数据库、表、列和行内容摘要，并提供两种模式：

• 快速搜索：速度优先，适合日常查找；
• 深度搜索：覆盖更全，适合定位疑难数据。

对应接口GET /api/v1/db/search，参数mode=deep可切换深度模式。命令行示例：

./chatlog http call \ --path /api/v1/db/search \ --query keyword=项目 \ --query mode=deep \ --query limit=100

面板与接口速查表

常见问题与注意事项

Q：页面打开是空白或提示数据库不可用？先确认密钥提取和解密步骤已完成，TUI 中应显示"已启动 HTTP 服务"。健康检查GET /health正常但 API 报数据库错误时，通常意味着解密流程还没走完。

Q：统计图表加载很慢？消息统计涉及跨库扫描。建议先缩小时间范围（如"近 7 天"），群聊统计范围与并发已做限制优化；数据量特别大时，使用"手动加载"按钮按需触发趋势扫描即可。

Q：查询结果和图片能直接复制/下载吗？可以。结果区支持 YAML/JSON 一键复制，媒体通过上面列出的媒体路由直接访问，右键即可保存到本地。

Q：数据会上传到云端吗？不会。数据库解密、查询和缓存全部在本机执行。只有你主动启用语义检索并配置了远程模型时，选中的检索文本才会发送到你配置的模型服务；使用本地 Ollama 等方案则可完全保持在本机。

结语

Chatlog Alpha 的 Web 仪表盘把"翻聊天记录"这件苦差事变成了点几下按钮的事：最近会话定位目标、消息检索按时间和关键词精确定位、联系人与群聊面板梳理人脉与群组、仪表盘分析视图提供消息统计和发言人排行。结合全局搜索和数据库浏览，它足以覆盖绝大多数本地聊天数据的查询与分析场景。配合 HTTP API 与 MCP 服务，这些数据还能进一步接入你自己的自动化工作流。

⚠️ 请仅处理你有权访问的本地数据，妥善保管生成的密钥与解密结果，不要把all_keys.json、解密数据库或聊天内容提交到任何代码仓库。

• 后端
• CLI
• MCP 服务
• 即时通讯
• RAG
• 人工智能
• AI 技能