novel-doomsday-resurgence/INSTALL.md

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

## 🎯 系统概述

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

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

## 📁 已创建的文件结构

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

## 🚀 快速安装

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

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

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

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

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

### 方法二：手动安装

```bash
# 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）

```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
- 同步版本标签
- 失败重试机制

## 🖥️ 使用方法

### 命令行工具

```bash
# 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
```

### 一键全流程

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

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

## 📋 定时任务列表

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

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

## 🛠️ 维护和管理

### 查看Cron任务

```bash
crontab -l
```

### 查看系统日志

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

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

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

### 手动执行任务

```bash
# 手动触发自动提交
./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任务未执行**
   ```bash
   # 检查Cron服务状态
   systemctl status cron
   
   # 重新安装Cron任务
   ./tools/schedule_manager.py install
   ```

2. **Git同步失败**
   ```bash
   # 检查网络连接
   ping gitea.nevadalice.top:226
   
   # 手动同步
   ./tools/git_version_manager.sh sync --force
   ```

3. **备份失败**
   ```bash
   # 检查磁盘空间
   df -h
   
   # 手动创建备份
   ./tools/schedule_manager.py backup --type chapters
   ```

### 日志分析

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

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

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

## 📞 技术支持

### 紧急恢复

1. **恢复最新备份**
   ```bash
   # 找到最新的备份文件
   ls -t backups/*.tar.gz | head -1
   
   # 恢复备份
   tar -xzf 最新备份文件.tar.gz -C 目标目录
   ```

2. **重新初始化系统**
   ```bash
   # 移除现有配置
   crontab -r
   
   # 重新安装
   ./tools/schedule_manager.py install
   ```

### 联系信息

- **项目名称**：《末日重生-开局囤货十亿物资》
- **作者**：唐天洛
- **Gitea仓库**：https://gitea.nevadalice.top:226/liyuchen/novel-doomsday-resurgence
- **创建时间**：2026年3月30日

## 🎉 安装完成

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

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

### 下一步建议

1. **立即测试系统**
   ```bash
   ./tools/git_version_manager.sh workflow
   ```

2. **查看系统状态**
   ```bash
   ./tools/schedule_manager.py dashboard
   ```

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

4. **监控维护**
   - 定期检查系统日志
   - 确保备份文件正常创建
   - 关注番茄平台更新要求

---

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