包含: - 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/ 目录
11 KiB
11 KiB
小说创作文档整合方案
项目: 《杀了婆婆的我却无人追责?》 创建时间: 2026-03-26 目的: 整合分散文档,建立清晰的文档管理体系
📊 当前问题分析
现状
- 文档总数: 38个 Markdown 文档
- 主要问题:
- 多份重复内容(如多个版本的大纲)
- 报告文件分散(4个完善报告+多个修正报告)
- 历史演进文档过多
- 会话记录分散且可能重复
- 飞书文档更新不及时
问题影响
- ❌ 每次工作产生新文档,资源浪费
- ❌ 最新有效信息分散,难以快速找到
- ❌ 历史记录混乱,难以追溯版本
- ❌ 飞书和本地文档不同步
🎯 整合目标
- 聚合最新信息 - 所有有效信息集中在少量核心文档
- 保留历史记录 - 所有历史版本和讨论都有迹可循
- 建立清晰结构 - 文档分类清晰,层级分明
- 优化工作流 - 避免每次产生新文档,更新现有文档
- 保持飞书同步 - 核心内容实时同步到飞书
📁 推荐的文档结构
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(全局变更日志)
用途: 记录所有重要变更,按时间倒序排列 更新频率: 每次有重要变更时更新 格式示例:
## [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(问题修复日志)
用途: 集中记录所有问题发现、讨论、修正过程 更新频率: 每次发现问题时更新 格式示例:
## [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(决策记录)
用途: 记录重要的创作决策,方便追溯 更新频率: 每次有重要决策时更新 格式示例:
## [2026-03-24] - 米酵菌酸投毒方案
### 决策内容
小姑子的投毒方式选择:米酵菌酸
### 决策原因
1. 无色无味 - 符合"隐形杀手"特点
2. 剧毒 - 1毫克即可致命
3. 耐高温 - 不容易被烹饪破坏
4. 来源合理 - 小姑子可以控制食物储存条件
5. 家庭场景适合 - 小姑子负责做饭
### 替代方案(已否决)
- 买毒药 - 不合理,正常人不会买
- 买强效清洁剂 - 做饭放清洁剂不合理
- 写日记 - 不合理,正常人不会写"我要报仇"
### 决策时间
2026-03-24
### 决策人
用户 + 番茄小说创作助手
### 相关文档
- [详细讨论](./archive/session-history/session-20260324.md)
🔄 工作流程优化
场景1:修改大纲
旧流程:
- 修改
32-chapters-outline-final.md - 创建新的修正报告文档(
outline-fix-xxx.md) - 更新 INDEX.md
新流程:
- 归档旧版本:
cp current/outline.md archive/outline-history/v10.1.2-20260326.md - 修改
current/outline.md - 更新
CHANGELOG.md - 更新
INDEX.md - (可选)更新
records/ISSUE_LOG.md(如果涉及问题修复) - 同步到飞书
场景2:修改章节
旧流程:
- 修改
chapters/chapter-05/v1.0.md - 更新
CHANGELOG.md - (可选)更新 INDEX.md
新流程:
- 归档旧版本:
cp current/chapter-05.md archive/chapter-history/chapter-05/v1.0.md - 修改
current/chapter-05.md - 更新
archive/chapter-history/chapter-05/CHANGELOG.md - 更新
CHANGELOG.md - (可选)更新 INDEX.md
- 同步到飞书
场景3:发现新问题
旧流程:
- 创建新的修正报告文档(
xxx-fix.md) - 可能与其他报告重复
新流程:
- 更新
records/ISSUE_LOG.md(在对应章节追加记录) - 如果问题已修正,立即修改
current/outline.md或current/chapter-XX.md - 更新
CHANGELOG.md - 同步到飞书
场景4:会话结束
旧流程:
- 创建新的会话总结文档(
session-YYYYMMDD.md) - 可能有重复内容
新流程:
- 更新
records/ISSUE_LOG.md(记录本次会话发现的问题) - 更新
records/DECISION_LOG.md(记录本次会话的决策) - (可选)创建
archive/session-history/session-YYYYMMDD.md(仅当有重要内容时) - 更新
CHANGELOG.md(总结本次会话的重要变更)
📦 迁移计划
第一阶段:创建新结构(立即执行)
- ✅ 创建
current/目录 - ✅ 创建
archive/目录及其子目录 - ✅ 创建
records/目录 - ✅ 创建
CHANGELOG.md - ✅ 创建
records/ISSUE_LOG.md - ✅ 创建
records/DECISION_LOG.md
第二阶段:迁移现有内容(立即执行)
- ✅ 迁移最新大纲:
outline/32-chapters-outline-final.md→current/outline.md - ✅ 迁移章节最新版:
chapters/chapter-01/v2.0.md→current/chapter-01.mdchapters/chapter-02/v3.4.md→current/chapter-02.mdchapters/chapter-03/v3.0.md→current/chapter-03.mdchapters/chapter-04/v3.0.md→current/chapter-04.mdchapters/chapter-05/v1.0.md→current/chapter-05.md
- ✅ 归档旧大纲版本到
archive/outline-history/ - ✅ 归档旧章节版本到
archive/chapter-history/ - ✅ 归档会话记录到
archive/session-history/
第三阶段:整理历史记录(可以分批执行)
- 整理所有修正报告,合并到
records/ISSUE_LOG.md - 整理所有决策,合并到
records/DECISION_LOG.md - 删除或归档重复的报告文档
第四阶段:清理旧文件(谨慎执行)
- 将所有旧文件移动到
legacy/目录 - 确认新结构正常运行后,再考虑删除
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 | 结构清晰 |
| 工作流 | 每次产生新文档 | 更新现有文档 | 减少浪费 |
🚀 开始整合?
我已经准备好执行整合方案。你希望我现在开始吗?
选项:
- 立即开始整合 - 我会执行第一、二阶段迁移(立即见效)
- 先确认方案 - 你可以提出修改意见,我再执行
- 分步执行 - 你想先看看某个部分的效果
创建时间:2026-03-26 创建人:番茄小说创作助手