liyuchen/novel-doomsday-resurgence
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1e15aa91c2
novel-doomsday-resurgence/INSTALL.md

8.0 KiB
Raw Blame History

《末日重生》项目定时同步系统安装指南

🎯 系统概述

为《末日重生-开局囤货十亿物资》项目提供完整的Git版本管理和定时同步系统，包含：

  • 🔄 自动提交：检测更改并自动提交
  • 🏷️ 版本标签：自动创建语义化版本标签
  • 📦 定时备份：按计划备份项目数据
  • 📊 状态报告：生成详细的项目状态报告
  • ⏰ Cron定时任务：自动执行所有任务
  • 📈 健康监控：监控系统运行状态

📁 已创建的文件结构

末日重生_囤货/
├── .gitattributes              # Git文件属性配置
├── .gitignore                 # Git忽略文件配置
├── tools/
│   ├── git_version_manager.sh # Git版本管理主脚本
│   └── schedule_manager.py    # 定时任务管理系统
├── config/
│   └── cron_schedule.json     # 定时任务配置
├── backups/                   # 备份文件存储
├── logs/                      # 系统日志文件
├── progress/                  # 进度报告文件
└── INSTALL.md                # 本安装指南

🚀 快速安装

方法一：一键安装（推荐）

cd /root/.openclaw/workspace/projects/末日重生_囤货

# 1. 测试系统健康
./tools/schedule_manager.py health

# 2. 安装Cron定时任务
./tools/schedule_manager.py install

# 3. 显示系统仪表板
./tools/schedule_manager.py dashboard

方法二：手动安装

# 1. 设置脚本权限
chmod +x tools/git_version_manager.sh
chmod +x tools/schedule_manager.py

# 2. 创建必要的目录
mkdir -p backups logs progress

# 3. 测试Git版本管理
./tools/git_version_manager.sh status

# 4. 手动创建Cron任务
echo "*/30 * * * * cd $(pwd) && ./tools/git_version_manager.sh commit" | crontab -

🔧 配置说明

定时任务配置（config/cron_schedule.json）

{
    "定时同步配置": {
        "自动提交": {
            "启用": true,
            "间隔": "30分钟"
        },
        "版本标签": {
            "启用": true,
            "触发条件": "每10次提交自动创建标签"
        },
        "远程同步": {
            "启用": true,
            "间隔": "1小时"
        },
        "自动备份": {
            "启用": true,
            "时间": "每日凌晨3点"
        }
    }
}

Git版本管理配置

系统会自动跟踪：

  • 章节数量变化
  • 字数统计
  • 提交历史
  • 版本标签
  • 同步状态

📊 系统功能

1. 自动提交（每30分钟）

  • 检测未提交的更改
  • 自动添加所有更改
  • 生成包含时间戳的提交信息
  • 自动提交到本地仓库

2. 版本标签管理

  • 每10次提交自动创建新版本
  • 语义化版本号（v1.0.0格式）
  • 包含章节和字数信息的标签描述
  • 标签同步到远程仓库

3. 定时备份（每天凌晨3点）

  • 完整备份：包含所有项目文件
  • 章节备份：仅备份章节内容
  • Git包备份：可移植的Git仓库
  • 自动清理：保留7天内的备份

4. 状态报告（每天凌晨1点）

  • 章节统计和字数统计
  • Git提交历史和版本信息
  • 番茄平台适配情况
  • 系统健康状态检查

5. 远程同步（每1小时）

  • 自动拉取远程最新更改
  • 推送本地提交到Gitea
  • 同步版本标签
  • 失败重试机制

🖥️ 使用方法

命令行工具

# 1. 显示系统仪表板
./tools/schedule_manager.py dashboard

# 2. 执行自动提交
./tools/git_version_manager.sh commit

# 3. 创建版本标签
./tools/git_version_manager.sh tag

# 4. 同步到远程仓库
./tools/git_version_manager.sh sync

# 5. 创建备份
./tools/schedule_manager.py backup --type full

# 6. 生成状态报告
./tools/git_version_manager.sh report

# 7. 检查系统健康
./tools/schedule_manager.py health

# 8. 显示交互式菜单
./tools/git_version_manager.sh menu

一键全流程

# 执行完整的版本管理流程
./tools/git_version_manager.sh workflow

这将依次执行：

  1. 检查Git状态
  2. 自动提交更改
  3. 创建版本标签（如果需要）
  4. 同步到远程仓库
  5. 生成状态报告

📋 定时任务列表

安装后系统会自动配置以下定时任务：

任务 时间 描述
自动提交 每30分钟 检测并提交未提交的更改
状态报告 每天01:00 生成项目状态报告
项目备份 每天03:00 创建项目备份文件
健康检查 每小时 检查系统健康状态

🛠️ 维护和管理

查看Cron任务

crontab -l

查看系统日志

# 查看Git版本管理日志
tail -f logs/git_version.log

# 查看定时任务日志
tail -f /tmp/末日重生_*.log

# 查看备份目录
ls -la backups/

手动执行任务

# 手动触发自动提交
./tools/git_version_manager.sh commit

# 手动创建备份
./tools/schedule_manager.py backup

# 手动生成报告
./tools/git_version_manager.sh report

🔍 监控和告警

系统健康检查

系统会自动监控：

  • ✅ Git仓库状态
  • ✅ 磁盘空间使用
  • ✅ 项目目录完整性
  • ✅ 网络连接状态
  • ✅ 任务执行状态

日志文件位置

末日重生_囤货/logs/
├── git_version.log      # Git版本管理日志
├── schedule_YYYYMM.log  # 定时任务日志
└── monitor_YYYYMMDD.json # 监控数据

/tmp/
├── 末日重生_自动提交.log    # 自动提交日志
├── 末日重生_报告生成.log    # 报告生成日志  
├── 末日重生_备份.log       # 备份任务日志
└── 末日重生_健康检查.log    # 健康检查日志

🚨 故障排除

常见问题

  1. Cron任务未执行

    # 检查Cron服务状态
systemctl status cron

# 重新安装Cron任务
./tools/schedule_manager.py install

  2. Git同步失败

    # 检查网络连接
ping gitea.nevadalice.top:226

# 手动同步
./tools/git_version_manager.sh sync --force

  3. 备份失败

    # 检查磁盘空间
df -h

# 手动创建备份
./tools/schedule_manager.py backup --type chapters

日志分析

# 查看错误日志
grep -i "error\|fatal\|failed" logs/git_version.log

# 查看最近活动
tail -100 /tmp/末日重生_自动提交.log

# 检查任务执行时间
grep "开始\|完成\|成功\|失败" logs/git_version.log | tail -20

📞 技术支持

紧急恢复

  1. 恢复最新备份

    # 找到最新的备份文件
ls -t backups/*.tar.gz | head -1

# 恢复备份
tar -xzf 最新备份文件.tar.gz -C 目标目录

  2. 重新初始化系统

    # 移除现有配置
crontab -r

# 重新安装
./tools/schedule_manager.py install

联系信息

🎉 安装完成

系统已成功安装！你现在拥有：

  1. ✅ 自动版本管理：每30分钟自动提交更改
  2. ✅ 定时备份：每天凌晨3点自动备份
  3. ✅ 状态报告：每天凌晨1点生成报告
  4. ✅ 远程同步：自动同步到Gitea仓库
  5. ✅ 健康监控：系统健康状态实时监控

下一步建议

  1. 立即测试系统

    ./tools/git_version_manager.sh workflow

  2. 查看系统状态

    ./tools/schedule_manager.py dashboard

  3. 开始创作

    • 在 chapters/ 目录下继续写第25章
    • 系统会自动跟踪和备份你的创作
    • 定期查看状态报告了解进度

  4. 监控维护

    • 定期检查系统日志
    • 确保备份文件正常创建
    • 关注番茄平台更新要求

系统状态：✅ 安装完成 | 版本：v1.0.0 | 最后更新：2026-03-30