lingxi-web/CHANGELOG.md

版本迭代记录

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

[Unreleased]

• 完成双消息网关 P0 可靠性闭环：Webhook 采用 processing/completed/failed 可恢复状态机，Telegram 编辑与撤回落库，60 秒增量游标对账、5 分钟死信自动重放、每日资料刷新和每周受控全量对账。
• Telegram 会话发现改为 TDLib 持续加载并持久化全部会话，平台按 offset 分页读取；网关请求增加超时与任务并发合并，避免单个资料接口阻塞全部同步。
• 修复 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 产品原型与页面结构。
• 作为历史参考保留，不建议部署。