novel-doomsday-resurgence/novel-tracker/DOC_INTEGRATION_PLAN.md
唐天洛 bc9188b0fd feat(git-workflow): 添加 Git 工作流和脚本
包含:
- 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/ 目录
2026-03-30 15:50:36 +08:00

11 KiB
Raw Permalink Blame History

小说创作文档整合方案

项目: 《杀了婆婆的我却无人追责?》 创建时间: 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全局变更日志

用途: 记录所有重要变更,按时间倒序排列 更新频率: 每次有重要变更时更新 格式示例:

## [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修改大纲

旧流程:

  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.mdcurrent/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.mdcurrent/outline.md
  2. 迁移章节最新版:
    • chapters/chapter-01/v2.0.mdcurrent/chapter-01.md
    • chapters/chapter-02/v3.4.mdcurrent/chapter-02.md
    • chapters/chapter-03/v3.0.mdcurrent/chapter-03.md
    • chapters/chapter-04/v3.0.mdcurrent/chapter-04.md
    • chapters/chapter-05/v1.0.mdcurrent/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 创建人:番茄小说创作助手