---
name: changelog-template
description: 变更记录模板。当 Product Spec 发生迭代变更时，按照此模板格式记录变更历史，输出为 Product-Spec-CHANGELOG.md 文件。
---

# 变更记录模板

本模板用于记录 Product Spec 的迭代变更历史。

---

## 文件命名

`Product-Spec-CHANGELOG.md`

---

## 模板格式

```markdown
# 变更记录

## [v1.2] - YYYY-MM-DD
### 新增
- <新增的功能或内容>

### 修改
- <修改的功能或内容>

### 删除
- <删除的功能或内容>

---

## [v1.1] - YYYY-MM-DD
### 新增
- <新增的功能或内容>

---

## [v1.0] - YYYY-MM-DD
- 初始版本
```

---

## 记录规则

- **版本号递增**：每次迭代 +0.1（如 v1.0 → v1.1 → v1.2）
- **日期自动填充**：使用当天日期，格式 YYYY-MM-DD
- **变更描述**：根据对话内容自动生成，简明扼要
- **分类记录**：新增、修改、删除分开写，没有的分类不写
- **只记录实际改动**：没改的部分不记录
- **新增控件要写位置**：涉及 UI 变更时，说明控件放在哪里

---

## 完整示例

以下是「剧本分镜生成器」的变更记录示例，供参考：

```markdown
# 变更记录

## [v1.2] - 2025-12-08
### 新增
- 新增「AI 优化描述」按钮（角色设定区底部），点击后自动优化角色和场景的描述文字
- 新增分镜描述显示，每张分镜图下方展示 AI 生成的画面描述

### 修改
- 左侧输入区比例从 35% 改为 40%
- 「生成分镜」按钮样式改为更醒目的主色调

---

## [v1.1] - 2025-12-05
### 新增
- 新增「场景设定」功能区（角色设定区下方），用户可上传场景参考图建立视觉档案
- 新增「水墨」画风选项
- 新增图像理解能力，用于分析用户上传的参考图

### 修改
- 角色卡片布局优化，参考图预览尺寸从 80px 改为 120px

### 删除
- 移除「自动分页」功能（用户反馈更希望手动控制分页节奏）

---

## [v1.0] - 2025-12-01
- 初始版本
```

---

## 写作要点

1. **版本号**：从 v1.0 开始，每次迭代 +0.1，重大改版可以 +1.0
2. **日期格式**：统一用 YYYY-MM-DD，方便排序和查找
3. **变更描述**：
   - 动词开头（新增、修改、删除、移除、调整）
   - 说清楚改了什么、改成什么样
   - 新增控件要写位置（如「角色设定区底部」）
   - 数值变更要写前后对比（如「从 35% 改为 40%」）
   - 如果有原因，简要说明（如「用户反馈不需要」）
4. **分类原则**：
   - 新增：之前没有的功能、控件、能力
   - 修改：改变了现有内容的行为、样式、参数
   - 删除：移除了之前有的功能
5. **颗粒度**：一条记录对应一个独立的变更点，不要把多个改动混在一起
6. **AI 能力变更**：如果新增或移除了 AI 能力，必须单独记录
