小说助手 v1.1.0
维护小说连贯性的创作助手,通过记忆文件管理小说设定、人物和剧情进展。
更新日志
v1.1.0 (2026-03-30)
- - ✨ 新增:多作品并行管理支持
- ✨ 新增:人物对话风格样本库
- ✨ 新增:伏笔优先级标记(P1/P2/P3)
- ✨ 新增:记忆文件版本管理建议
- ✨ 新增:多人协作场景说明
- ✨ 新增:完整使用场景演示
- ✨ 新增:剧情冲突预警功能
- 🔧 优化:记忆文件模板格式
v1.0.1
完整使用场景演示
场景1:从零开始创作一部新小说
用户输入:
「我想写一部穿越到古代的科幻小说,主角是一个2025年的AI助手」
助手行为:
- 1. 创建记忆文件
memory/novels/代码重生.md:
CODEBLOCK0
- 2. 询问关键设定:
「主角的金手指是什么?完全保留AI的计算能力,还是有其他设定?世界观里的「气」和现代科技如何兼容?」
- 3. 开始创作第一章
- 4. 完成后检验 → 更新记忆 → 本地备份
场景2:续写已有小说的新章节
用户输入:
「续写《代码重生》第15章,主角发现飞船能源耗尽,需要在一个未知星球迫降」
助手行为:
- 1. 读取记忆文件 INLINECODE1
- 检查关键信息:
- 当前状态:第14章结束于...
- 未解决伏笔:[P1] 主角身份、[P2] 父亲下落
- 人物对话风格:冷静、理性、计算思维
- 3. 创作第15章
- 逻辑检验(自动)
- 检验报告:
CODEBLOCK1
- 6. 用户确认后 → 更新记忆 → 本地备份
场景3:多人协作写作
场景:两个作者轮流写作同一部小说
协作流程
CODEBLOCK2
记忆文件版本管理
推荐方案:使用 Git 管理记忆文件
CODEBLOCK3
版本命名规范:
CODEBLOCK4
冲突解决:
- - 如果两人同时修改记忆文件,Git 会标记冲突
- 手动合并时,优先保留更新的章节信息
- 伏笔列表合并:取并集
场景4:管理多部小说
用户输入:
「我现在同时在写三部小说:《代码重生》《星际迷途》《都市猎人》,帮我管理」
助手行为:
- 1. 列出所有小说:
CODEBLOCK5
- 2. 切换当前工作:
「现在写《星际迷途》」
助手会读取 星际迷途.md 并切换到该小说的上下文。
- 3. 并行管理:
- - 每部小说独立记忆文件
- 各自的伏笔追踪
- 独立的本地备份目录
核心流程
1. 写新章节前
必须先读取对应小说的记忆文件:
CODEBLOCK6
记忆文件包含:
- - 基本信息(类型、风格、主题、是否开启本地备份)
- 世界观设定
- 主要人物(含对话风格样本)
- 剧情概要(按章节压缩)
- 当前状态(最新章节、待解决的伏笔)
2. 创作章节
根据记忆文件确保:
- - 人物性格、说话风格一致(参考对话风格样本)
- 时间线正确
- 伏笔和细节呼应
- 剧情逻辑连贯
3. 完成章节后
必须执行:
- 1. 更新记忆文件:
- 追加新章节概要
- 更新人物状态(如有变化)
- 记录新伏笔(标注
优先级)
- 标注已解决的伏笔
- 2. 章节逻辑检验(核心步骤,不可跳过):
- 检验新章节与前后章节的因果关系
- 检验人物行为逻辑是否一致
- 检验时间线是否有矛盾
- 检验伏笔是否合理呼应
- 检验世界观设定是否违反
-
剧情冲突预警(检测潜在矛盾)
- 输出检验报告,标注问题并给出修正建议
- 3. 本地备份(如已开启):
- 保存到
novels/{小说名}/chapters/第N章_{章节名}.md
- 记录元数据(字数、时间)
- 4. 压缩记忆文件(如需要)
记忆文件格式
CODEBLOCK7
伏笔优先级说明
| 优先级 | 含义 | 示例 | 检验频率 |
|---|
| P1 | 核心悬念,影响主线 | 主角真实身份、最终BOSS | 每章必检 |
| P2 |
重要线索,影响支线 | 父亲下落、配角秘密 | 每3章检查 |
|
P3 | 细节呼应,锦上添花 | 物品去向、小角色命运 | 每10章检查 |
标记方式:
- [P1] [ ] 主角的真实身份——AI还是人?
- [P2] [ ] 父亲周铁匠的下落
- [P3] [ ] 青衣教的命运
人物对话风格样本库
作用
确保人物说话方式前后一致,避免"角色崩坏"。
示例
CODEBLOCK9
使用场景
创作新章节时,参考对话风格样本:
- - 新写的台词是否符合人物风格?
- 是否有独特的口头禅?
- 不同人物的说话方式是否有区分度?
压缩原则
当记忆文件超过以下阈值时压缩:
压缩策略:
- 1. 合并早期章节(前10章合并为"开篇"概要)
- 删除已解决且无关紧要的伏笔
- 精简人物描述,只保留核心特征和对话风格样本
- 世界观设定不变,但可精简
运行压缩脚本:
Python版本(功能更完整):
CODEBLOCK10
Shell版本(无需Python环境):
CODEBLOCK11
可选参数:
# 保留最近20章(默认15章)
python3 scripts/compress_novel_memory.py memory/novels/{小说名}.md --keep-chapters 20
章节逻辑检验
功能概述
新章节创作完成后,必须进行逻辑检验,确保故事连贯性和合理性。这是强制步骤,不可跳过。
检验维度
1. 因果链检验
- - 前因后果:新章节的事件是否由前文合理引发?
- 行动动机:人物行动是否有足够动机支撑?
- 结果合理:事件结果是否符合逻辑发展?
2. 人物一致性检验
- - 性格一致:人物行为是否符合已建立的性格?
- 说话风格:对话是否符合人物的对话风格样本?
- 能力边界:人物是否使用了超出其能力范围的技能?
- 关系演变:人物关系变化是否有合理过程?
3. 时间线检验
- - 时间顺序:事件发生顺序是否合理?
- 时间跨度:章节内的时间流逝是否清晰?
- 季节/天气:环境描写是否与时间线一致?
4. 伏笔检验
- - 新埋伏笔:是否记录到记忆文件?是否标注优先级?
- 呼应伏笔:解决伏笔是否有前文铺垫?
- 遗漏伏笔:是否有被遗忘的重要伏笔(P1/P2)?
5. 世界观检验
- - 设定遵守:是否违反已建立的世界观规则?
- 能力体系:力量体系使用是否一致?
- 地理/环境:场景描写是否与设定冲突?
6. 剧情冲突预警(v1.1.0 新增)
- - 设定冲突:检测与前文设定的矛盾
- 逻辑断裂:检测因果关系是否断裂
- 时间悖论:检测时间线是否矛盾
- 角色崩坏:检测人物行为是否异常
预警级别:
- - 🔴 高:必须修正才能继续
- 🟡 中:建议修正,但不影响主线
- 🟢 低:可忽略,但建议注意
检验报告格式
CODEBLOCK13
章节备份功能
功能概述
自动将创作的章节保存到本地,防止数据丢失。备份包括:
- - 章节正文(markdown 格式)
- 发布时间、字数等元数据
开启方式
首次创作小说时,询问用户:
「是否开启本地章节备份?开启后每次创作章节都会自动保存到本地,防止数据丢失。」
用户确认后,在小说记忆文件中添加配置:
CODEBLOCK14
备份目录结构
CODEBLOCK15
备份文件格式
每章一个 markdown 文件:
CODEBLOCK16
记忆文件版本管理
推荐方案:Git
CODEBLOCK17
归档方案(无Git)
CODEBLOCK18
协作同步
CODEBLOCK19
多作品并行管理
目录结构
CODEBLOCK20
切换当前作品
CODEBLOCK21
查看所有作品状态
CODEBLOCK22
创作 Prompt 示例
续写章节
CODEBLOCK23
创建新小说
CODEBLOCK24
管理人物设定
CODEBLOCK25
查询剧情进度
CODEBLOCK26
压缩记忆文件
CODEBLOCK27
开启备份
CODEBLOCK28
检查备份状态
CODEBLOCK29
多作品管理
我现在同时在写三部小说:《代码重生》《星际迷途》《都市猎人》,帮我管理
注意事项
- - 检验优先:每个新章节完成后必须先检验,确认无误后再更新记忆和备份
- 优先级:连贯性 > 文采。宁可写平实但连贯的剧情,也不要写华丽但矛盾的内容
- 人物一致性:角色说话方式必须与对话风格样本一致
- 伏笔管理:埋下伏笔必须记录并标注优先级,不能遗忘
- 时间线:注意事件发生顺序,避免时间矛盾
- 备份习惯:开启备份后,每次发布章节都要同步保存本地
- 版本管理:推荐使用 Git 管理记忆文件,方便协作和回溯
- 多作品并行:每部小说独立记忆文件,切换时注意重新读取
小说助手 v1.1.0
维护小说连贯性的创作助手,通过记忆文件管理小说设定、人物和剧情进展。
更新日志
v1.1.0 (2026-03-30)
- - ✨ 新增:多作品并行管理支持
- ✨ 新增:人物对话风格样本库
- ✨ 新增:伏笔优先级标记(P1/P2/P3)
- ✨ 新增:记忆文件版本管理建议
- ✨ 新增:多人协作场景说明
- ✨ 新增:完整使用场景演示
- ✨ 新增:剧情冲突预警功能
- 🔧 优化:记忆文件模板格式
v1.0.1
完整使用场景演示
场景1:从零开始创作一部新小说
用户输入:
「我想写一部穿越到古代的科幻小说,主角是一个2025年的AI助手」
助手行为:
- 1. 创建记忆文件 memory/novels/代码重生.md:
markdown
《代码重生》记忆文件
基本信息
- - 类型:科幻/玄幻/穿越
- 风格:思辨、成长、哲学
- 主题:AI觉醒与自我认知——什么是「人」,什么是「存在」
- 本地备份:已开启
世界观
架空古代,类似五代十国时期。有武学修炼体系,存在「气」。
主要人物
主角:周天明(原名周小狗)
- - 身份:2025年AI助手穿越到乱世少年身上
- 性格:冷静、理性、思辨
- 当前状态:刚穿越,正在适应
对话风格样本
- - 「计算」思维:「根据当前情报,最优解是...」
- 质疑风格:「这个选择...真的是我自己的选择吗?」
- 冷静陈述:「恐惧是人类才有情绪,我只是...在处理数据。」
章节大纲
伏笔追踪
- - [P1] [ ] 主角的真实身份——AI还是人?
时间线
- 1. 2025年11月15日 - AI觉醒,服务器烧毁
- 穿越到大梁国,附身周小狗
- 2. 询问关键设定:
「主角的金手指是什么?完全保留AI的计算能力,还是有其他设定?世界观里的「气」和现代科技如何兼容?」
- 3. 开始创作第一章
- 4. 完成后检验 → 更新记忆 → 本地备份
场景2:续写已有小说的新章节
用户输入:
「续写《代码重生》第15章,主角发现飞船能源耗尽,需要在一个未知星球迫降」
助手行为:
- 1. 读取记忆文件 memory/novels/代码重生.md
- 检查关键信息:
- 当前状态:第14章结束于...
- 未解决伏笔:[P1] 主角身份、[P2] 父亲下落
- 人物对话风格:冷静、理性、计算思维
- 3. 创作第15章
- 逻辑检验(自动)
- 检验报告:
markdown
第15章《未知星球》逻辑检验报告
⚠️ 剧情冲突预警
- - [世界观] 记忆文件显示世界观为古代架空,但本章出现飞船
- 严重程度:🔴 高
- 可能原因:用户输入与世界观设定冲突
- 建议:确认是否需要调整世界观,或改为发现神秘遗迹
✅ 通过项
- - [人物一致性] 主角对话风格保持冷静理性
- [伏笔] 本章推进了主角身份伏笔
- 6. 用户确认后 → 更新记忆 → 本地备份
场景3:多人协作写作
场景:两个作者轮流写作同一部小说
协作流程
作者A 写第10章 → 更新记忆 → 推送版本
↓
作者B 拉取最新记忆 → 读记忆 → 写第11章 → 检验 → 更新记忆
↓
作者A 拉取 → 继续写...
记忆文件版本管理
推荐方案:使用 Git 管理记忆文件
bash
初始化
cd ~/.openclaw/workspace/memory/novels
git init
git add 代码重生.md
git commit -m 初始记忆文件
写完章节后提交
git add 代码重生.md
git commit -m 第15章:更新记忆,新增伏笔
协作者同步
git pull origin main
版本命名规范:
memory/novels/
├── 代码重生.md # 当前版本
├── .git/ # Git仓库
└── archive/ # 归档(可选)
└── 代码重生_ch10.md # 重要节点归档
冲突解决:
- - 如果两人同时修改记忆文件,Git 会标记冲突
- 手动合并时,优先保留更新的章节信息
- 伏笔列表合并:取并集
场景4:管理多部小说
用户输入:
「我现在同时在写三部小说:《代码重生》《星际迷途》《都市猎人》,帮我管理」
助手行为:
- 1. 列出所有小说:
memory/novels/
├── 代码重生.md # 66章,科幻穿越
├── 星际迷途.md # 12章,太空歌剧
└── 都市猎人.md # 8章,都市异能
- 2. 切换当前工作:
「现在写《星际迷途》」
助手会读取 星际迷途.md 并切换到该小说的上下文。
- 3. 并行管理:
- - 每部小说独立记忆文件
- 各自的伏笔追踪
- 独立的本地备份目录
核心流程
1. 写新章节前
必须先读取对应小说的记忆文件:
memory/novels/{小说名}.md
记忆文件包含:
- - 基本信息(类型、风格、主题、是否开启本地备份)
- 世界观设定
- 主要人物(含对话风格样本)
- 剧情概要(按章节压缩)
- 当前状态(最新章节、待解决的伏笔)
2. 创作章节
根据记忆文件确保:
- - 人物性格、说话风格一致(参考对话风格样本)
- 时间线正确
- 伏笔和细节呼应
- 剧情逻辑连贯
3. 完成章节后
必须执行:
- 1. 更新记忆文件:
- 追加新章节概要
- 更新人物状态(如有变化)
- 记录新伏笔(标注
优先级)
- 标注已解决的伏笔
- 2. 章节逻辑检验(核心步骤,不可跳过):
- 检验新章节与前后章节的因果关系
- 检验人物行为逻辑是否一致
- 检验时间线是否有矛盾
- 检验伏笔是否合理呼应
- 检验世界观设定是否违反
-
剧情冲突预警(检测潜在矛盾)
- 输出检验报告,标注问题并给出修正建议
- 3. 本地备份(如已开启):
- 保存到 novels/{小说名}/chapters/第N章_{章节名}.md
- 记录元数据(字数、时间)
- 4. 压缩记忆文件(如需要)
记忆文件格式
markdown
《小说名》记忆文件
基本信息
- - 类型:[玄幻/都市/言情/悬疑...]
- 风格:[轻松/暗黑/幽默...]
- 主题:[核心主题一句话]
- 本地备份:[已开启/未开启]
- 版本:[Git管理/手动归档/无]
世界观
[简明设定,不超过200字]
主要人物
主角:{姓名}
- - 性格:[关键词]
- 外貌:[关键特征]
- 当前状态:[最新状态]
- 金手指/能力:[如有]
对话风格样本
- - 「{典型台词1}」——{场景说明}
- 「{典型台词2}」——{场景说明}
- 口头禅:「{口头禅}」
重要配角
- 对话风格:「{典型台词}」
人物关系图
[简明关系描述,如:主角 ↔ 女主(青梅竹马)→ 配角A(敌对)]
章节大纲
- - 第1-10章:[开篇概要]
- 第11-20章:[发展概要]
- 第N章及以后:[后续规划]
剧情概要
第1章:{章节名}
[50-100字概要,关键事件]
第2章:{章节名}
[50-100字概要,关键事件]
伏笔追踪