Chatlog Alpha
[!IMPORTANT]
用户订阅（置顶）
因收到腾讯方面关于侵权问题的投诉，本仓库已停止公开源代码、构建产物和历史 Release，仅保留项目说明。 仓库已经转移至https://gitflic.ru/project/goring/chatlog_alpha
项目状态、更新通知与用户订阅入口： 加入 Telegram 订阅
Chatlog Alpha 是面向微信 4.x 的本地聊天数据读取与自动化工具。项目用于发现本机微信账号、提取和管理密钥、只读查询 WCDB、解密媒体，并通过 TUI、Web、结构化 CLI 和本机 HTTP JSON API 提供统一入口。
当前项目状态
- GitHub 云端仓库仅保留本 README，不再公开项目源代码或二进制构建产物。
- 当前项目已移除原生文本/图片发信、发信调试、常驻注入 Session、语义检索、时序图谱和 MCP 实验功能。
- 当前保留的核心方向是本地数据读取、数据库解密、媒体处理、结构化查询、消息推送和本机自动化接口。
- 后续状态变化、版本说明和用户通知统一通过置顶的 Telegram 订阅入口发布。
当前能力
- 多进程、多账号发现与切换
- macOS 数据库密钥、图片密钥提取
- 会话、消息、联系人、群聊、收藏和朋友圈查询
- 图片、视频、语音与附件读取、解密
- 数据库浏览、跨库搜索、只读 SQL、CSV/Excel 导出
- POST、Hermes Weixin、Hermes QQ 消息推送
- 面向 LLM 的自描述 CLI 与机器可读 HTTP API 目录
- TUI、Web 控制台与结构化
chatlog ops/chatlog api接口
已移除功能
以下能力已从当前项目代码中完整移除：
chatlog send原生文本/图片发送 CLI/api/v1/send-debug/*原生发信调试接口- Web 控制台“发信调试”页面及其静态资源
- Frida 原生发信脚本、图片上传 Agent、欢迎消息与常驻 Session supervisor
- 语义检索、Embedding、MCP 和时序图谱实验模块
聊天图片读取、图片密钥提取、媒体解密和本地预览仍属于当前项目的数据读取能力，不属于原生发图功能。
安全边界
Chatlog 可读取本机完整聊天数据，应仅在可信本机环境运行：
- HTTP 仅监听
localhost、127.0.0.0/8或::1，默认地址为127.0.0.1:5030。 - 数据库以只读和
query_only模式连接。 - 配置、密钥及 Hermes 环境文件使用受限文件权限。
- Hermes Token 与 Secret 只写入配置，不通过状态接口回显。
- 朋友圈媒体代理限制私网、loopback、link-local、用户信息 URL、协议及响应大小。
- Web 控制台不应通过反向代理、端口映射或隧道公开。
当前接口概览
当前 HTTP Catalog 包含 39 个 endpoint，覆盖：
| 分类 | 数量 | 说明 |
|---|---|---|
| system | 4 | 健康检查、Ping、API Catalog、OpenAPI |
| chat | 7 | 会话、历史、搜索、未读、群成员、增量消息、统计 |
| social | 4 | 收藏、朋友圈通知、动态与搜索 |
| address_book | 3 | 联系人、群聊、OpenIM 企业信息 |
| database | 6 | 数据库、跨库搜索、表、数据、只读 SQL、缓存 |
| media | 6 | 图片、视频、语音、附件、数据文件、朋友圈媒体代理 |
| push | 9 | 推送配置、状态、事件、Hermes Weixin/QQ |
高权限的账号选择、密钥提取、数据库解密、服务生命周期和持久配置仍由本机 TUI 或结构化 chatlog ops 管理。
运行数据
默认持久化根目录为 ~/.chatlog：
~/.chatlog/
├── chatlog.json
├── chatlog.pid
├── log/chatlog.log
├── cache/
└── workspaces//
├── runtime/hook.db
└── cache/
微信原始数据目录由微信自身管理，不属于 Chatlog 的运行根目录。
获取通知
GitHub 当前不提供源代码、Release 或安装包下载。项目状态及后续通知请使用置顶入口：
Telegram 用户订阅：https://t.me/+zy1N_8leq8IxYmY8
贡献致谢
感谢以下贡献者曾提交问题复现、实测数据与实现方案。相关功能后续即使重构或下线，贡献记录仍予保留：
| 贡献者 | Pull Request | 贡献摘要 |
|---|---|---|
| @ameriadam12 | #90 | 大型数据集下仪表盘与历史查询性能优化。 |
| @onewilk | #81–#85 | OpenIM、Webhook、群聊回填、缓存刷新与群聊 @ 解析。 |
| @TnzGit | #68 | 历史 Embedding 响应截断修复；相关实验功能现已下线。 |
| @ouyadi | #64、#65 | MCP、语义检索、索引与消息钩子安全改进；仍适用的修复继续保留。 |
| @marswjf | #59、#60 | Windows 进程识别、Action CLI、媒体与历史账号支持。 |
| @think2011 | #54 | Webhook、WAL、文件锁与时间范围问题验证。 |
| @jingmian | #18 | 图片密钥扫描实测建议。 |
| Dependabot | #23、#75、#80 | 依赖更新与安全修复建议。 |
声明
Chatlog Alpha 为非官方项目，与腾讯或微信不存在隶属、授权或合作关系。“腾讯”“微信”及相关名称和标识归其权利人所有。使用者应遵守所在地法律法规、软件许可和平台规则，并自行负责本地数据与账号安全。