n2/README.md

N2 Auto Update Program

简介

这是一个自动更新程序，用于保持 Gitea 仓库中的 n2.json 文件与上游源同步。程序会自动处理下载、格式化、字段强制覆盖以及通知发送。

功能特性

1. 自动同步: 每日定时（05:30）从指定 URL 下载最新的 JSON 文件。
2. 智能比对: 仅在内容发生实质变化时才触发更新。
3. 字段强制:
   • 强制设置 logo 字段为 ./bj/fyj.gif，且更新时不会被覆盖。
   • 保留或插入 lf_js_search (大鹏私人影库) 字段，并始终置顶。
4. 自动验证: 每次运行都会自动从 Gitea 拉取最新文件进行验证，确保关键字段正确。
5. Telegram 通知:
   • 仅在发生更新或验证失败时发送通知。
   • 通知包含更新内容详情及验证结果。
   • 支持长消息分片发送。
6. 安全可靠:
   • 使用 Git SHA 校验防止并发冲突。
   • 文件锁机制防止程序重复运行。
   • Gitea 提交使用服务器自动时间戳，避免时间穿越问题。

部署信息

• 程序路径: /root/n2-auto-update/
• 配置文件: /root/n2-auto-update/config.yaml
• 服务名称: n2-update.service
• 定时任务: n2-update.timer

运行日志

日志文件位于 /root/n2-auto-update/logs/n2_update.log，会自动轮转。

更新记录

2026-02-05

• 优化: 调整通知策略，仅在文件更新或验证失败时发送 Telegram 通知，避免每日无效打扰。
• 修复: 修正 Gitea 提交时间显示为 "26 years ago" 的问题 (移除显式时间戳，使用服务器时间)。
• 增强: 添加 verify_and_notify 模块，每次运行自动验证 logo 和 lf_js_search 字段。
• 功能: 强制 logo 字段值为 ./bj/fyj.gif，并确保 lf_js_search 字段不被修改且置顶。

2026-02-04

• 初始部署: 完成基础框架搭建，包括下载、Diff 比对、Gitea 上传及 Systemd 定时任务配置。