wx-cli/CHANGELOG.zh-CN.md

更新日志

本文件记录项目的所有重要变更。

[未发布]

变更

• 密钥提取改为支持 WeChat 4.1.7 及以上版本，不再维护固定版本前缀白名单。

[0.7.4] - 2026-07-22

功能

• 联系人和会话头像 — 联系人与会话 JSON 新增可选 avatar_url；优先使用小头像、回退大头像，并兼容没有头像字段的旧数据库
• 图片质量元数据 — /api/v1/media 图片响应会标记为 full 或 thumbnail，并继续优先返回本机已有的高清/原图文件

维护

• 适配当前 stable Rust 的格式化和 Clippy 检查，并串行化集成测试服务启动，避免并行抢占临时端口

[0.7.3] - 2026-07-10

功能

• Agent 可用的微信数据层 — 提供 Agent Skill，让 Claude Code、Codex、Cursor 等 Agent 查询和订阅本地微信数据
• 跨会话时间线 — 新增 GET /api/v1/timeline，可在有界时间范围内一次读取所有会话，并支持分页、排序、消息类型筛选和隐私过滤
• 精简时间线输出 — 返回记忆、归档和报告 Agent 所需的会话、发送者、方向、时间、类型和摘要字段

性能

• 复用 SQLCipher 派生密钥，避免在打开、计数、刷新和重开数据库时重复执行 25.6 万轮 KDF
• 限制时间线排序内存，长驻服务会复用预热的数据库连接

文档与维护

• 重写 README，补充 Release 安装方式和 Agent Skill 说明
• 更新依赖与 GitHub Actions，恢复格式化、Clippy 和全量测试基线

[0.7.2] - 2026-04-06

功能

• 解密微信数据库 — 自动解密 macOS 微信（4.1.7.x / 4.1.8.x）的加密数据库
• 提取加密密钥 — 提供两种方式：key extract（推荐，通过 LLDB）和 key scan（内存扫描，需要 sudo）
• 浏览联系人 — 搜索和查看微信联系人，支持手机号、签名、地区、标签、备注等详情
• 浏览会话 — 列出近期会话，显示未读数和最新消息预览
• 查询消息 — 按联系人、群聊、时间范围或消息类型筛选消息，支持分页浏览
• 全文搜索 — 按关键词搜索所有会话的聊天记录，自动建立搜索索引
• 导出会话 — 将聊天记录导出为 TXT 或 JSON 格式，包含图片、语音、视频和文件附件
• 实时监听 — 通过 watch 命令实时监听新消息
• 媒体处理 — 解密图片、将微信语音转为标准音频格式、解码微信专有图片格式（WXGF）、解密视频号视频
• HTTP 服务模式 — 以本地 HTTP 服务运行，提供 REST API 和实时事件推送（SSE），方便与其他应用集成
• 隐私过滤 — 可在查询和服务结果中隐藏指定联系人或群成员
• 环境检查 — doctor 命令一键检查所有运行前置条件
• 并行处理 — 大型导出任务并行处理图片、语音和视频，显著提升导出速度