# 📋 开发日志更新规则

> **本文件定义了 AI 助手更新开发文档的规范**

---

## ⚡ 核心原则

| 规则 | 说明 |
|------|------|
| **默认更新** | 只更新 `DayN.md` |
| **按需更新** | `task_complete.md` 仅在用户**明确要求**时更新 |
| **增量追加** | 禁止覆盖/新建。请使用 replace/edit 工具插入新内容。 |
| **先读后写** | 更新前先查看文件当前内容 |

---

## 📁 文件结构

```
ViGent/Docs/
├── task_complete.md              # 任务总览（仅按需更新）
├── Doc_Rules.md                  # 本文件
└── DevLogs/
    ├── Day1.md                   # 开发日志
    └── ...
```

---

## 📅 DayN.md 更新规则（日常更新）

### 新建判断
- 检查最新 `DayN.md` 的日期
- **今天** → 追加到现有文件
- **之前** → 创建 `Day{N+1}.md`

### 追加格式
```markdown
---

## 🔧 [章节标题]

### 问题描述
简要描述...

### 解决方案
```code
# 代码示例
```

### 结果
- ✅ 修复了 xxx
```

### 快速修复格式
```markdown
## 🐛 [Bug 简述] (HH:MM)

**问题**：一句话描述
**修复**：修改了 `文件名` 中的 xxx
**状态**：✅ 已修复 / 🔄 待验证
```

---

## 📝 task_complete.md 更新规则（仅按需）

> ⚠️ **仅当用户明确要求更新 `task_complete.md` 时才更新**

### 更新原则
- **格式一致性**：直接参考 `task_complete.md` 现有格式追加内容。
- **进度更新**：仅在阶段性里程碑时更新进度百分比。

---

## 🚀 新对话检查清单

1. 查看 `task_complete.md` → 了解整体进度
2. 查看最新 `DayN.md` → 确认今天是第几天
3. 根据日期决定追加或新建 Day 文件

---

## 🎯 项目组件

| 组件 | 位置 |
|------|------|
| 后端 (FastAPI) | `ViGent/backend/` |
| 前端 (Next.js) | `ViGent/frontend/` |
| AI 模型 (MuseTalk) | `ViGent/models/` |
| 文档 | `ViGent/Docs/` |

---

**最后更新**：2026-01-13