# 版本迭代记录

本项目遵循语义化版本。早期版本由经过脱敏的本地源码快照恢复，因此使用带日期的 `snapshot-*` 标签；自 `v1.0.0` 起按正式发布流程维护。

## [Unreleased]

- 修复 WhatsApp 账号重新授权后因网关账号 ID 与联系人名称变化导致历史会话分叉的问题；客户按稳定 JID 复用，旧渠道消息、任务、风险和商机自动归并，并保留最近有效的联系人资料。

### 新增

- Telegram Gateway 支持环境级默认 SOCKS5/HTTP/MTProto 代理，账号专属绑定仍具有更高优先级。
- WhatsApp Gateway 支持环境级默认 HTTP/HTTPS 代理，账号专属代理仍可覆盖默认值。
- 默认代理仅作用于两个消息网关，不改变平台、邮箱、数据库或 Docker 的全局网络出口。
- Docker 构建支持可配置的 Debian 与 FFmpeg 下载镜像，适配受限网络环境。

### 修复

- 将 Telegram Gateway 首次启动所需的 PostgreSQL 初始化脚本纳入版本控制，避免空数据库因挂载目录而启动失败。
- Telegram Gateway 本机调试端口改为 `127.0.0.1:3010`，避免与 Gitea 的 `3000` 端口冲突并阻止公网直连管理接口。
- 修复 WhatsApp `FULL` 历史通知被 Baileys 默认过滤的问题；首次连接和历史阶段完成后自动执行逐会话分页补齐。
- WhatsApp 历史同步增加并发合并、进度持久化、失败状态和平台数据库游标分页，避免重复同步及单次 2000 条截断。
- 修复 WhatsApp 先于平台 API 连通时首次同步被静默丢弃的问题，增加延迟启动、指数重试和重复 Webhook 恢复。
- WhatsApp 媒体与历史文件下载接入 Undici 代理 Dispatcher，并可恢复处理旧版本曾忽略但仍保存在缓存中的历史通知。

## [1.1.0] - 2026-08-01

### 新增

- 将完整 Telegram User Gateway 源码纳入 `telegram-gateway/`，平台与网关可以按同一 Git 版本追踪。
- 提交 NestJS、TDLib、PostgreSQL、Redis、BullMQ、Webhook、限流、审计、代理、会话、消息及群组相关实现。
- 增加 Telegram Gateway 独立 Docker 部署、平台连接、健康检查、凭据隔离和验证说明。

### 安全

- 排除 `.env`、TDLib 登录态、数据库、Redis 备份、上传文件、运行日志与真实账号调试脚本。
- 强化仓库忽略规则，防止后续误提交 `.binlog`、`.rdb` 和会话数据。

## [1.0.0] - 2026-07-30

### 新增

- Telegram、普通 WhatsApp 和企业邮箱统一消息中心。
- 多账号绑定、默认账号切换、渠道状态和账号级操作。
- WebSocket 实时消息、全站通知、已读上报和历史游标分页。
- 图片、文档、语音、贴纸、相册等媒体链路。
- 上下文感知的多语种双向翻译、逐句意图识别及独立开关。
- 每会话上下文记忆、自动压缩、最近消息优先和历史低优先级补齐。
- 情绪、风险、客户画像、雷达图、知识库、智能回复与翻译备注。
- WhatsApp 消息状态、撤回/编辑事件、输入状态、群组、联系人、代理、设备、失败重试、死信重放及备份接口。
- 团队、RBAC、API Key、审计、商机、任务、分析和支付基础能力。
- 全站蓝色品牌设计系统和 Telegram 风格消息界面。

### 修复

- 修复会话点击后错误置顶、删除群组后残留、消息列表空值崩溃。
- 修复语言切换、意图开关 JSON 写入、智能回复采纳与关闭。
- 修复头像、用户名、国家信息和渠道文案混用。
- 修复历史消息、实时会话列表、WhatsApp 媒体下载和状态同步问题。

## [snapshot-2026.07.30-pre-ui] - 2026-07-30

- 多账号与 WhatsApp 接入后的界面改造前快照。
- 已具备主要业务模块，保留后续上下文翻译与界面统一前的状态。

## [snapshot-2026.07.28-pre-multiaccount] - 2026-07-28

- Telegram 消息闭环和主要 SaaS 页面快照。
- 多账号、WhatsApp 网关与后续企业级能力尚未合入。

## [snapshot-2026.07.27-platform] - 2026-07-27

- React 前端、Node.js API、PostgreSQL 与 Telegram Gateway 集成版本。
- 建立客户、消息、AI、团队与设置等平台基础。

## [snapshot-2026.07.25-initial] - 2026-07-25

- 初始 Web 产品原型与页面结构。
- 作为历史参考保留，不建议部署。