更新日志
新增
- 新增 Web「订阅中心」,集中查看启用中的 Telegram 频道订阅、同步状态和广告过滤统计。
- 新增按订阅配置的广告过滤:支持关闭、保守和严格三种模式,并可添加关键词、域名、账号/机器人等允许或屏蔽规则。
- 新增广告过滤记录与人工纠正:误判为广告的内容可标记为正常并重新加入下载队列;纠正结果可用于后续模板识别。
- 新增高级设置「跳过频道普通图片」,适合频道同时发布预览图与原图文件、只需归档原图文件的场景。
修复与改进
- 广告过滤按 Telegram 媒体组整体判定,避免同一组内容只过滤部分消息。
- 恢复误拦截内容时增加幂等与并发保护,避免重复创建恢复任务。
- 订阅中心的订阅和过滤记录支持分页,减少大量订阅时的单次查询和渲染负担。
- 广告过滤默认关闭;升级后现有订阅继续按原方式下载,不会自动改变行为。
- 「跳过频道普通图片」默认关闭,并在启用时增加风险确认,避免频道只发布普通图片时意外漏图。
升级方法
使用官方安装脚本部署
cd /opt/tg-vault
sudo bash deploy/install.sh
使用 Git / Docker Compose 手动部署
cd /path/to/tg-vault
git fetch --tags origin
git checkout main
git pull --ff-only origin main
git checkout v2.3.1
version="v$(node -p "require('./backend/package.json').version")"
revision="$(git rev-parse HEAD)"
IMAGE_VERSION="$version" SOURCE_REVISION="$revision" SOURCE_VERSION="$version" docker compose build backend frontend
IMAGE_VERSION="$version" SOURCE_REVISION="$revision" SOURCE_VERSION="$version" docker compose up -d --no-build --no-deps backend frontend
- 启动后后端会自动应用本版本的数据库迁移;升级前仍建议先备份 PostgreSQL 数据库和
.env。
- 如需启用频道广告过滤,请升级后进入 Web「订阅中心」逐个订阅配置;现有订阅默认保持关闭。
验证
- Backend:457/457 项测试通过,TypeScript 类型检查通过,生产构建通过。
- Frontend:203/203 项测试通过,生产构建通过。
- 安装脚本测试:通过。