# 更新日志

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

## [未发布]

### 变更

- 密钥提取改为支持 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` 命令一键检查所有运行前置条件
- **并行处理** — 大型导出任务并行处理图片、语音和视频，显著提升导出速度