bc9188b0fd
包含： - GIT_WORKFLOW.md - 详细的 Git 工作流规范 - scripts/git-setup.sh - Git 工作区初始化脚本 - scripts/git-daily.sh - 日常 Git 管理脚本 - scripts/git-novel-workflow.sh - 小说专用 Git 工作流 - 更新 .gitignore 排除子仓库的 .git 目录 - 添加 novel-tracker/ 目录 - 添加 projects/ 目录（排除子仓库 .git） - 添加 tomato-novel/ 目录
334 lines
11 KiB
Markdown
334 lines
11 KiB
Markdown
# 小说创作文档整合方案
|
||
|
||
**项目：** 《杀了婆婆的我却无人追责？》
|
||
**创建时间：** 2026-03-26
|
||
**目的：** 整合分散文档，建立清晰的文档管理体系
|
||
|
||
---
|
||
|
||
## 📊 当前问题分析
|
||
|
||
### 现状
|
||
- **文档总数：** 38个 Markdown 文档
|
||
- **主要问题：**
|
||
1. 多份重复内容（如多个版本的大纲）
|
||
2. 报告文件分散（4个完善报告+多个修正报告）
|
||
3. 历史演进文档过多
|
||
4. 会话记录分散且可能重复
|
||
5. 飞书文档更新不及时
|
||
|
||
### 问题影响
|
||
- ❌ 每次工作产生新文档，资源浪费
|
||
- ❌ 最新有效信息分散，难以快速找到
|
||
- ❌ 历史记录混乱，难以追溯版本
|
||
- ❌ 飞书和本地文档不同步
|
||
|
||
---
|
||
|
||
## 🎯 整合目标
|
||
|
||
1. **聚合最新信息** - 所有有效信息集中在少量核心文档
|
||
2. **保留历史记录** - 所有历史版本和讨论都有迹可循
|
||
3. **建立清晰结构** - 文档分类清晰，层级分明
|
||
4. **优化工作流** - 避免每次产生新文档，更新现有文档
|
||
5. **保持飞书同步** - 核心内容实时同步到飞书
|
||
|
||
---
|
||
|
||
## 📁 推荐的文档结构
|
||
|
||
```
|
||
novel-tracker/
|
||
├── 📄 INDEX.md # 【核心】项目总览（导航中心）
|
||
├── 📄 README.md # 项目说明
|
||
├── 📄 CHANGELOG.md # 【新增】全局变更日志
|
||
├── 📚 current/ # 【新增】当前有效内容
|
||
│ ├── outline.md # 最新32章大纲
|
||
│ ├── chapter-01.md # 第1章最新版
|
||
│ ├── chapter-02.md # 第2章最新版
|
||
│ ├── chapter-03.md # 第3章最新版
|
||
│ ├── chapter-04.md # 第4章最新版
|
||
│ ├── chapter-05.md # 第5章最新版
|
||
│ └── ...future chapters... # 未来章节
|
||
├── 📚 archive/ # 【新增】历史版本归档
|
||
│ ├── outline-history/ # 大纲历史版本
|
||
│ │ ├── v9.0-20260322.md # v9.0版本
|
||
│ │ ├── v10.0-20260325.md # v10.0版本
|
||
│ │ └── v10.1-20260326.md # v10.1版本（当前final）
|
||
│ ├── chapter-history/ # 章节历史版本
|
||
│ │ ├── chapter-01/
|
||
│ │ │ ├── v1.0.md
|
||
│ │ │ ├── v2.0.md
|
||
│ │ │ └── CHANGELOG.md
|
||
│ │ └── chapter-02/
|
||
│ │ ├── v1.0.md
|
||
│ │ ├── v2.0.md
|
||
│ │ ├── v3.0.md
|
||
│ │ ├── v3.4.md
|
||
│ │ └── CHANGELOG.md
|
||
│ └── session-history/ # 会话记录归档
|
||
│ ├── session-20260321.md
|
||
│ ├── session-20260322.md
|
||
│ └── ...
|
||
├── 📋 records/ # 【新增】问题修复和决策记录
|
||
│ ├── ISSUE_LOG.md # 【新增】问题修复日志
|
||
│ ├── DECISION_LOG.md # 【新增】决策记录
|
||
│ └── ...
|
||
└── 🗑️ legacy/ # 【新增】旧版文件归档（待清理）
|
||
└── ...
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 核心文档说明
|
||
|
||
### 1. INDEX.md（导航中心）
|
||
**用途：** 所有文档的入口，提供快速导航
|
||
**更新频率：** 每次有重要变更时更新
|
||
**内容：**
|
||
- 项目基本信息
|
||
- 最新状态总览
|
||
- 快速导航链接
|
||
- 版本历史摘要
|
||
|
||
---
|
||
|
||
### 2. CHANGELOG.md（全局变更日志）
|
||
**用途：** 记录所有重要变更，按时间倒序排列
|
||
**更新频率：** 每次有重要变更时更新
|
||
**格式示例：**
|
||
```markdown
|
||
## [2026-03-26] - 大纲修正（v10.1.1）
|
||
|
||
### 修改内容
|
||
- 修正第12章：演员死亡而非失踪
|
||
- 修正第20章：删除误导性伏笔（红色油漆）
|
||
- 修正第21章：明确血迹描述
|
||
|
||
### 影响范围
|
||
- 文件：`current/outline.md`
|
||
- 版本：v10.1 → v10.1.1
|
||
|
||
### 相关文档
|
||
- [详细修正报告](./records/ISSUE_LOG.md#2026-03-26-演员死亡逻辑修正)
|
||
```
|
||
|
||
---
|
||
|
||
### 3. current/outline.md（最新大纲）
|
||
**用途：** 唯一最新的32章大纲
|
||
**更新频率：** 每次大纲修改时更新
|
||
**特点：**
|
||
- 每次更新前，旧版本自动归档到 `archive/outline-history/`
|
||
- 版本号递增：v10.1.1, v10.1.2, v10.2.0...
|
||
- 文件顶部标注版本号和更新时间
|
||
|
||
---
|
||
|
||
### 4. current/chapter-XX.md（章节最新版）
|
||
**用途：** 每个章节的唯一最新版本
|
||
**更新频率：** 每次章节修改时更新
|
||
**特点：**
|
||
- 每次更新前，旧版本自动归档到 `archive/chapter-history/chapter-XX/`
|
||
- 版本号递增：v1.0, v1.1, v2.0...
|
||
- 文件顶部标注版本号和更新时间
|
||
|
||
---
|
||
|
||
### 5. records/ISSUE_LOG.md（问题修复日志）
|
||
**用途：** 集中记录所有问题发现、讨论、修正过程
|
||
**更新频率：** 每次发现问题时更新
|
||
**格式示例：**
|
||
```markdown
|
||
## [2026-03-26] - 演员死亡逻辑修正
|
||
|
||
### 问题描述
|
||
用户指出：演员应该是被当做假婆婆被女主杀掉，而不是"失踪"
|
||
|
||
### 问题影响
|
||
- 逻辑矛盾：演员"失踪"但实际已被女主杀死
|
||
- 误导读者：让读者误以为演员还活着
|
||
|
||
### 修正方案
|
||
1. 第12章：演员在"婆婆被杀"的那天之后就下落不明，张峰调查发现演员已经死亡
|
||
2. 第20章：删除"红色油漆"误导性伏笔，改为李建国反常的冷静和动作
|
||
3. 第21章：明确血迹是真的，增加悬疑感"尸体去哪了？"
|
||
|
||
### 修正时间
|
||
2026-03-26 11:54
|
||
|
||
### 修正人
|
||
用户 + 番茄小说创作助手
|
||
|
||
### 影响范围
|
||
- 文件：`current/outline.md`
|
||
- 版本：v10.1 → v10.1.1
|
||
|
||
### 相关记录
|
||
- [详细修正报告](./outline-fix-actor-death.md)
|
||
```
|
||
|
||
---
|
||
|
||
### 6. records/DECISION_LOG.md（决策记录）
|
||
**用途：** 记录重要的创作决策，方便追溯
|
||
**更新频率：** 每次有重要决策时更新
|
||
**格式示例：**
|
||
```markdown
|
||
## [2026-03-24] - 米酵菌酸投毒方案
|
||
|
||
### 决策内容
|
||
小姑子的投毒方式选择：米酵菌酸
|
||
|
||
### 决策原因
|
||
1. 无色无味 - 符合"隐形杀手"特点
|
||
2. 剧毒 - 1毫克即可致命
|
||
3. 耐高温 - 不容易被烹饪破坏
|
||
4. 来源合理 - 小姑子可以控制食物储存条件
|
||
5. 家庭场景适合 - 小姑子负责做饭
|
||
|
||
### 替代方案（已否决）
|
||
- 买毒药 - 不合理，正常人不会买
|
||
- 买强效清洁剂 - 做饭放清洁剂不合理
|
||
- 写日记 - 不合理，正常人不会写"我要报仇"
|
||
|
||
### 决策时间
|
||
2026-03-24
|
||
|
||
### 决策人
|
||
用户 + 番茄小说创作助手
|
||
|
||
### 相关文档
|
||
- [详细讨论](./archive/session-history/session-20260324.md)
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 工作流程优化
|
||
|
||
### 场景1：修改大纲
|
||
**旧流程：**
|
||
1. 修改 `32-chapters-outline-final.md`
|
||
2. 创建新的修正报告文档（`outline-fix-xxx.md`）
|
||
3. 更新 INDEX.md
|
||
|
||
**新流程：**
|
||
1. 归档旧版本：`cp current/outline.md archive/outline-history/v10.1.2-20260326.md`
|
||
2. 修改 `current/outline.md`
|
||
3. 更新 `CHANGELOG.md`
|
||
4. 更新 `INDEX.md`
|
||
5. （可选）更新 `records/ISSUE_LOG.md`（如果涉及问题修复）
|
||
6. 同步到飞书
|
||
|
||
---
|
||
|
||
### 场景2：修改章节
|
||
**旧流程：**
|
||
1. 修改 `chapters/chapter-05/v1.0.md`
|
||
2. 更新 `CHANGELOG.md`
|
||
3. （可选）更新 INDEX.md
|
||
|
||
**新流程：**
|
||
1. 归档旧版本：`cp current/chapter-05.md archive/chapter-history/chapter-05/v1.0.md`
|
||
2. 修改 `current/chapter-05.md`
|
||
3. 更新 `archive/chapter-history/chapter-05/CHANGELOG.md`
|
||
4. 更新 `CHANGELOG.md`
|
||
5. （可选）更新 INDEX.md
|
||
6. 同步到飞书
|
||
|
||
---
|
||
|
||
### 场景3：发现新问题
|
||
**旧流程：**
|
||
1. 创建新的修正报告文档（`xxx-fix.md`）
|
||
2. 可能与其他报告重复
|
||
|
||
**新流程：**
|
||
1. 更新 `records/ISSUE_LOG.md`（在对应章节追加记录）
|
||
2. 如果问题已修正，立即修改 `current/outline.md` 或 `current/chapter-XX.md`
|
||
3. 更新 `CHANGELOG.md`
|
||
4. 同步到飞书
|
||
|
||
---
|
||
|
||
### 场景4：会话结束
|
||
**旧流程：**
|
||
1. 创建新的会话总结文档（`session-YYYYMMDD.md`）
|
||
2. 可能有重复内容
|
||
|
||
**新流程：**
|
||
1. 更新 `records/ISSUE_LOG.md`（记录本次会话发现的问题）
|
||
2. 更新 `records/DECISION_LOG.md`（记录本次会话的决策）
|
||
3. （可选）创建 `archive/session-history/session-YYYYMMDD.md`（仅当有重要内容时）
|
||
4. 更新 `CHANGELOG.md`（总结本次会话的重要变更）
|
||
|
||
---
|
||
|
||
## 📦 迁移计划
|
||
|
||
### 第一阶段：创建新结构（立即执行）
|
||
1. ✅ 创建 `current/` 目录
|
||
2. ✅ 创建 `archive/` 目录及其子目录
|
||
3. ✅ 创建 `records/` 目录
|
||
4. ✅ 创建 `CHANGELOG.md`
|
||
5. ✅ 创建 `records/ISSUE_LOG.md`
|
||
6. ✅ 创建 `records/DECISION_LOG.md`
|
||
|
||
### 第二阶段：迁移现有内容（立即执行）
|
||
1. ✅ 迁移最新大纲：`outline/32-chapters-outline-final.md` → `current/outline.md`
|
||
2. ✅ 迁移章节最新版：
|
||
- `chapters/chapter-01/v2.0.md` → `current/chapter-01.md`
|
||
- `chapters/chapter-02/v3.4.md` → `current/chapter-02.md`
|
||
- `chapters/chapter-03/v3.0.md` → `current/chapter-03.md`
|
||
- `chapters/chapter-04/v3.0.md` → `current/chapter-04.md`
|
||
- `chapters/chapter-05/v1.0.md` → `current/chapter-05.md`
|
||
3. ✅ 归档旧大纲版本到 `archive/outline-history/`
|
||
4. ✅ 归档旧章节版本到 `archive/chapter-history/`
|
||
5. ✅ 归档会话记录到 `archive/session-history/`
|
||
|
||
### 第三阶段：整理历史记录（可以分批执行）
|
||
1. 整理所有修正报告，合并到 `records/ISSUE_LOG.md`
|
||
2. 整理所有决策，合并到 `records/DECISION_LOG.md`
|
||
3. 删除或归档重复的报告文档
|
||
|
||
### 第四阶段：清理旧文件（谨慎执行）
|
||
1. 将所有旧文件移动到 `legacy/` 目录
|
||
2. 确认新结构正常运行后，再考虑删除 `legacy/`
|
||
|
||
---
|
||
|
||
## 🎯 预期效果
|
||
|
||
### 整合后
|
||
- ✅ 核心文档数量：约 15 个（INDEX, README, CHANGELOG, ISSUE_LOG, DECISION_LOG + 7个章节 + 1个大纲）
|
||
- ✅ 历史版本：清晰归档，易于追溯
|
||
- ✅ 问题修复：集中记录在 ISSUE_LOG.md
|
||
- ✅ 决策记录：集中记录在 DECISION_LOG.md
|
||
- ✅ 工作流：每次修改现有文档，不产生新文档
|
||
- ✅ 飞书同步：核心内容实时同步
|
||
|
||
### 对比整合前
|
||
| 项目 | 整合前 | 整合后 | 改善 |
|
||
|------|--------|--------|------|
|
||
| 文档总数 | 38个 | ~15个核心文档 | 减少60% |
|
||
| 大纲版本 | 多份重复 | 唯一最新版 | 清晰明了 |
|
||
| 修正报告 | 分散在多个文档 | 集中在ISSUE_LOG.md | 易于查找 |
|
||
| 会话记录 | 多份重复/分散 | 归档到session-history | 结构清晰 |
|
||
| 工作流 | 每次产生新文档 | 更新现有文档 | 减少浪费 |
|
||
|
||
---
|
||
|
||
## 🚀 开始整合？
|
||
|
||
我已经准备好执行整合方案。你希望我现在开始吗？
|
||
|
||
**选项：**
|
||
1. **立即开始整合** - 我会执行第一、二阶段迁移（立即见效）
|
||
2. **先确认方案** - 你可以提出修改意见，我再执行
|
||
3. **分步执行** - 你想先看看某个部分的效果
|
||
|
||
---
|
||
|
||
*创建时间：2026-03-26*
|
||
*创建人：番茄小说创作助手*
|