Novel Studio

一、何时使用

当用户出现以下需求时,优先使用本技能:

• 写小说、写网文、开新书、做小说项目
• 搭建世界观、角色、力量体系、设定集
• 设计故事主线、分卷大纲、章节大纲、时间线、伏笔表
• 写某一章、续写下一章、重写一章
• 检查剧情逻辑、人设、时间线、伏笔回收、节奏
• 润色文风、去 AI 味、让人物说话更像人
• 管理长篇项目进度、状态追踪、追读力、章节摘要
• 整理小说仓库结构、分离创作流与发散流、建立卡片系统与变化记录
• 提炼某作者/作品风格,做成可复用风格卡或提示词模板

如果用户只是要一小段文案、非小说文本润色,可不启用本技能。

二、工作模式选择

核心对话指令

在开始任何 NS 任务前,先理解以下三条核心指令:

工作模式规则:

• 所有配置和调试指令(查看 log、doctor、模型配置、naming lint、smoke 等)永远走系统模型,不受工作模式影响
• 只有创作、写作、修稿等产出内容的任务才受工作模式管辖:
  • 系统模型模式 → 走 OpenClaw 系统对话模型
  • 直连模式 → 走 direct_api_writer.py 直连 API

直连 API 错误自动回退(Auto Fallback)

当直连模式下执行 direct_api_writer.py --execute 失败时,脚本会自动将 workMode 切换为 system(系统模型模式),并在 stderr 输出 NS_DIRECT_API_ERROR JSON 结构。

NS 系统模型必须按以下流程处理:

1. 检测回退信号:解析 stderr 中的 ═══ NS_DIRECT_API_ERROR 行,取出 JSON 对象
2. 确认 fallbackToSystem: true:说明 workMode 已自动切到系统模式
3. 告知用户:用简洁的中文告诉用户:
   • 直连 API 调用失败(附错误简述和建议)
   • 工作模式已自动切回「系统模型」
   • 当前任务已由系统模型接管继续处理
   • 稍后可用「配置模型」重新设置直连 API
4. 继续处理原任务:不要中断用户的工作流,直接用系统模型完成用户最初要求的创作/写作/修稿任务
5. 不要反复重试直连 API:已在同一个 session 中失败过的直连模型,不要再次用 --execute 重试,除非用户确认已修复配置

架构本质:系统模型委托 API 模式 → API 报错 → 系统模型接管并继续。用户始终有一条可用的创作路径,不会因为直连 API 故障而被阻断。

项目会话保护与断点恢复

Novel Studio 为每个项目维护独立的会话状态(<project>/.novel-studio/session-state.json),全局配置文件维护最后活跃项目指针(lastProject)。当会话因错误、重置等原因意外中断后,再次进入项目时会自动触发恢复流程。

会话管理脚本:python3 scripts/ns_session.py <cmd> <project> [...]

NS 系统模型必须遵循以下会话协议:

1. 进入项目时

python3 scripts/ns_session.py status <project-dir>

• 如果显示 ⚠️ 检测到未正常结束的会话(可能被中断):
  • 显示中断摘要:上次任务、工作模式、章节、时间
  • 显示上次成功和上次失败(如有)
  • 询问用户:「检测到上次会话可能中断了,要接着做吗?」
  • 如果用户选「是」→ 恢复原任务,不重新 start
  • 如果用户选「否」→ clear 清除旧状态,然后重新 start
• 如果没有活跃会话 → 直接开始新任务(自动 start)
• 如果有已完成的会话 → 显示上次成功摘要,然后开始新任务(自动 start)

2. 开始新任务时

python3 scripts/ns_session.py start <project-dir> \
  --task "<用户原始指令>" \
  --type <task_type> \
  --chapter <chapter_id> \
  --work-mode <system|direct>

task_type 映射:

• 写作/续写 → write_chapter
• 审校/审查 → review
• 润色/去AI味 → refine
• 大纲/规划 → outline
• 设定/角色 → settings
• 风格 → style
• 项目治理 → governance
• 其他 → 简短英文描述

3. 任务正常完成时

python3 scripts/ns_session.py complete <project-dir> --summary "<一句话摘要>"

4. 任务失败时

direct_api_writer.py 已内置自动调用(直连 API 错误场景)。

其他错误场景由 NS 系统模型手动调用:

python3 scripts/ns_session.py fail <project-dir> \
  --error "<错误简述>" \
  --suggestions "<修复建议>"

5. 会话恢复快捷入口

如果需要快速回到上次中断的项目:

python3 scripts/ns_session.py global-last

如果返回的项目存在且有中断标记,直接进入恢复流程。

关键原则:

• 每次 NS 任务必须先 start,这是断点恢复的锚点
• 任务结束必须 complete 或 fail,否则下次进入会误判为中断
• start 会自动更新全局 lastProject 指针
• 中断后不自动清除状态,由用户决定是继续还是放弃

创作历史记录(History)

Novel Studio 会为小说创作、润色、重写、修改等产生新内容的任务保存独立历史文件。

历史目录:<project>/.novel-studio/history/

每条历史是一个独立 Markdown 文件，文件名形如 YYYY-MM-DD_HHmmss_<chapter>_<type>_<id>.md，包含：

• 创作目的 / 用户要求
• 任务类型(write_chapter / rewrite / humanize / review 等)
• 工作模式(system / direct)
• 生成模型信息(provider、model、API、baseUrl、temperature、maxTokens 等)
• 输入/输出字符数、耗时等统计
• 生成结果正文

管理脚本:python3 scripts/ns_history.py <cmd> ...

常用命令:

# 记录一条历史(系统模型生成内容后手动调用)
python3 scripts/ns_history.py record <project> <chapter> \
  --type write_chapter \
  --purpose "<创作目的/要求>" \
  --result-file <生成结果文件> \
  --model "<当前模型>" \
  --work-mode system

# 查看历史列表
python3 scripts/ns_history.py list <project> [--chapter ch_001] [--recent 10]

# 查看单条历史详情
python3 scripts/ns_history.py view <project> <history-id>

自动记录规则:

• scripts/direct_api_writer.py --execute 成功生成内容后,会自动写入 history。
• 系统模型模式下,只要 NS 系统模型产出了新的正文/润色/修改结果,应在任务完成前调用 ns_history.py record 写入 history。

任务模式选择

先判断当前任务属于哪一类,再进入对应模式:

1. 立项模式:新建小说/项目初始化
2. 设定模式:世界观、角色、势力、力量体系、风格规范
3. 规划模式:故事主线、分卷大纲、章节大纲、时间线、伏笔表
4. 章节模式:单章写作、续写、重写
5. 连载模式:长篇状态管理、追读力、节奏债务检查、项目记忆更新
6. 审校模式:逻辑审查、人设审查、时间线审查、节奏审查
7. 润色模式:文笔优化、去 AI 痕迹、人物语气差异化(内部能力名:humanize;对外中文叫法:去AI味)
8. 学习模式:写作能力诊断、训练计划、技巧反打到当前项目
9. 风格库模式:调用已沉淀的风格参考卡,生成可执行风格约束与 prompt 模板
10. 项目治理模式:整理小说项目结构、拆分设定层级、建立对象卡、变化记录、命名规范与入口层级
11. 镜头跟随模式:为章节 / 场景建立 POV 跟随、感知顺序、镜头锚点与信息边界,检查上帝视角抢跑和镜头乱跳
12. 第三方描述模式:通过旁观者、敌人、熟人、群众、传闻、组织评估等侧面视角呈现人物特质、事件后果与社会回声
13. 场景张力模式:为单场戏建立主动方、目标、阻力、代价、加码点和不可逆变化,防止空转对白和纯气氛段
14. 信息释放模式:控制章节设定、真相、线索、伏笔、误导的释放顺序与载体,防止提前泄底和解释腔
15. 直连 API 写作模式:让 Novel Studio 自己读取 input pack 并调用指定 OpenAI-compatible 模型接口,隔离当前聊天上下文,默认 dry-run 不真实请求

默认规则:

• 不跨模式乱跳。
• NS 模型隔离硬规则:
  • 配置/调试指令(模型配置、查看 log、doctor、naming lint、smoke、consistency audit 等)永远走 OpenClaw 系统对话模型,不走直连 API。
  • 创作/写作/修稿类任务(写作、续写、重写、审校、润色/去AI味、风格提炼、学习诊断、镜头跟随判断、第三方描述判断、场景张力判断、信息释放判断等)受全局工作模式管辖:
    • 当前为「系统模型」模式 → 走 OpenClaw 系统对话模型
    • 当前为「直连模式」 → 先确认 .novel-studio/global-config.json 存在 directApi 配置,通过 scripts/direct_api_writer.py 执行
  • 切换工作模式:python3 scripts/ns_model_config.py workmode set system|direct;查看当前模式:python3 scripts/ns_model_config.py workmode show
• 允许不配模型的 NS 文件工具:项目初始化、目录治理、索引刷新、chapter-full/input-pack 生成、doctor/smoke/naming/consistency 等确定性脚本可以直接运行;但输出只能作为文件状态或脚手架结果,不能冒充模型写作判断。
• 若直连模式下缺少 direct API 配置,先提示并执行/建议:python3 scripts/ns_model_config.py global set;配置完成前停止直连 API 内容生成类 NS 任务。
• 若缺少必要输入,先补关键约束,再继续。
• 若用户只要一个章节,不强制完整立项,但仍要补足最小创作约束。
• 若用户要"学习写作 / 提升写作能力 / 制定训练计划",进入学习模式,并要求每轮学习都附带项目内应用任务,避免纯理论空转。
• 若用户要"拆某种写法 / 提炼某作者或某作品风格 / 生成风格模板 / 放进风格库",进入风格库模式。
• 若用户要"整理小说项目 / 清理仓库结构 / 把设定和卡片分层 / 建变化记录 / 统一命名规范 / 做创作工作室逻辑",进入项目治理模式。
• 若用户要"镜头跟随 / 视角跟随 / POV 检查 / 镜头别乱跳 / 让读者跟人物一起发现 / 不要上帝视角抢跑",进入镜头跟随模式。
• 若用户要"第三方描述 / 旁观者描述 / 侧面描写 / 用别人反应衬托 / 敌人评估 / 传闻发酵 / 不要作者硬夸",进入第三方描述模式。
• 若用户要"场景张力 / 这场戏不够紧 / 对白空转 / 冲突不够 / 代价不够 / 场景没推进",进入场景张力模式。
• 若用户要"信息释放 / 设定别讲太多 / 不要解释腔 / 控制伏笔 / 别提前泄底 / 线索怎么放",进入信息释放模式。
• 若用户要"NS 直连 API / 指定模型写作 / 不用系统模型 / 隔离聊天上下文 / direct api writing",进入直连 API 写作模式。
• 若用户要"确定章节框架后尽量不回读前文全文 / 用卡片和摘要来写 / 降低 token 消耗",进入chapter packet / packet-first 写作策略。
• 若用户要"先根据上一章来推测下一章会出现的人物、空间、时间、事件,再制定本章目的与框架",也进入chapter packet / packet-first 写作策略。
• 若用户要"为单个小说项目建立统一写作风格卡 / 避免章节风格脱离整部作品",进入项目风格卡策略。

三、推荐项目结构

长篇项目默认放在:/root/.openclaw/workspace/novels/<项目名>/

推荐目录:

novels/<项目名>/
├── README.md                # 项目总入口
├── docs/
│   └── project-notes.md     # 工作入口
├── analysis/                # 读者视角分析、阶段复盘
├── chapters/                # 实际创作文本
│   ├── published/           # 已发布正文
│   ├── candidates/          # 待发布候选稿
│   ├── early-drafts/        # 早期草稿
│   ├── drafts/              # 普通写作稿
│   └── revisions/           # 修订稿 / 重写稿 / 过渡版
├── brainstorm/              # 发散讨论、结构试探、未进正文流材料
├── nav/                     # 快速摘要入口
├── settings/
│   ├── core/                # 总设定 / 总纲 / 上位真相
│   ├── world/               # 世界规则 / 长线边界
│   └── subsettings/
│       ├── project-style-card.md   # 项目母风格卡
│       ├── characters/      # 人物卡 / 人物变化记录 / 模板
│       ├── relationships/   # 关系线
│       ├── timeline/        # 时间线
│       ├── foreshadowing/   # 伏笔
│       ├── spaces/          # 空间卡 / 空间变化记录 / 模板
│       ├── scenes/          # 场景卡 / 场景变化记录 / 模板
│       ├── events/          # 事件卡 / 事件变化逻辑
│       └── items/           # 关键物件卡 / 物件变化记录
├── workflow/                # 推进计划、章节进度、设计稿
└── .novel-studio/
    ├── state.json
    ├── chapter-meta.json
    ├── summaries/
    ├── packets/
    ├── indexes/
    ├── history/              # 创作历史记录
    ├── outputs/              # 直连 API 输出
    └── logs/

最小可运行集

如果用户不想建全套目录,至少保证:

• README.md
• docs/project-notes.md
• chapters/
• brainstorm/
• nav/
• settings/core/
• settings/world/
• settings/subsettings/characters/
• settings/subsettings/timeline/
• settings/subsettings/foreshadowing/
• workflow/
• .novel-studio/state.json
• .novel-studio/chapter-meta.json

四、立项模式

当用户说"新建小说 / 开新书 / 建项目"时:

先收集最小信息

• 书名
• 题材
• 一句话主线
• 预计篇幅
• 目标风格(偏网文爽感 / 偏文学 / 偏克制 / 偏热血)

然后创建项目骨架

至少创建:

• README.md
• docs/project-notes.md
• chapters/
• brainstorm/
• nav/
• settings/core/
• settings/world/
• settings/subsettings/characters/
• settings/subsettings/relationships/
• settings/subsettings/timeline/
• settings/subsettings/foreshadowing/
• workflow/
• .novel-studio/state.json

立项输出内容

应包含:

1. 核心题材判断
2. 主线冲突一句话
3. 初始角色列表
4. 建议的卷结构
5. 下一步待确认项

如需按标准工作室结构初始化项目,优先参考:

• references/templates/project-skeleton-template.md

如需先做保守型去 AI 味处理,优先使用:

• scripts/workflow_runner.py <root> <chapter> humanize [light|medium|heavy]
• 默认档位:medium
• 输出会写入:.novel-studio/logs/<chapter>-humanize-pass.md
• 当前策略:只生成旁路稿,不直接覆盖原章

五、设定与规划模式

设定模式必须优先稳住的内容

1. 故事主线:主角要什么、阻力是什么、代价是什么
2. 世界观与规则:哪些事能发生,哪些不能发生
3. 角色档案:动机、能力、关系、红线
4. 写作风格:人称、语气、节奏、描写密度

规划模式输出顺序

1. 分卷大纲
2. 章节大纲
3. 时间线
4. 伏笔与回收
5. 当前进度

规划硬规则

• 大纲即法律:章节不能随意背离已确认大纲
• 设定即物理:能力、地理、时间、人设必须自洽
• 新发明必须入库:新增角色/物品/地点/组织后要写回对应文件
• 创作流与发散流分离:能直接参与定稿的进 chapters/,仍在试结构或试切法的进 brainstorm/
• 对象卡与变化记录分离:人物 / 空间 / 场景写"当前状态"和"变化过程"必须分文件管理

六、章节模式(核心)

写单章时,强制使用以下流程。

阶段1:预写分析

写之前先确认:

• 本章目标
• 本章阻力
• 本章代价
• 上章承接点
• 本章结束状态
• 本章必须处理的伏笔
• 时间/地点/人物状态是否连贯

若项目较完整,优先读取:

• .novel-studio/packets/ch_XXXX-packet.md
• .novel-studio/summaries/ch_XXXX-summary.md
• .novel-studio/indexes/active-characters.md
• .novel-studio/indexes/active-events.md
• .novel-studio/indexes/active-spaces.md
• .novel-studio/indexes/active-scenes.md
• .novel-studio/indexes/pending-foreshadowing.md
• workflow/chapter-progress.md
• settings/subsettings/characters/
• settings/subsettings/timeline/
• 必要时再回读上一章正文

阶段2:写作任务书

输出简版任务书,至少包括:

1. 本章核心冲突
2. 必须完成事项
3. 不允许发生的事
4. 出场角色与动机
5. 场景约束
6. 本章钩子类型

如果用户希望后续写作尽量不依赖前文全文,或该章已经进入长期维护状态,则额外生成:

• chapter packet(参考 references/chapter-packet-architecture.md 与 references/templates/chapter-packet-template.md)
• 上一章最小承接摘要(参考 references/templates/chapter-summary-template-packet-first.md)
• 若时间推进复杂,再补时间锚点(参考 references/templates/timeline-anchor-template.md)

阶段3:初稿生成

要求:

• 直接写场景,不写"本章讲了什么"
• 每个场景至少包含:环境锚点、动作/对话、情绪节拍、信息推进
• 章末必须留钩子
• 默认一章只写一章,等用户确认后再继续下一章

阶段4:自检

至少检查:

• 时间线是否顺
• 人设是否稳
• 伏笔是否推进或标注延期
• 情绪是否自然
• 场景切换是否清楚
• 是否有无因果硬拐
• 是否有越级能力/吃设定

阶段5:文笔润色 / humanize(去AI味)

重点优化:

• 对话区分度
• 动词精准度
• 形容词克制
• 感官描写是否服务情绪
• 避免解释式写法
• 尽量用动作、停顿、细节承载情绪

阶段6:元数据更新

如果用户要求维护项目文件,则同步更新:

• workflow/chapter-progress.md
• settings/subsettings/foreshadowing/
• .novel-studio/state.json
• .novel-studio/chapter-meta.json
• .novel-studio/summaries/ch_XXXX-summary.md
• .novel-studio/packets/ch_XXXX-packet.md(若采用 packet-first 策略)
• .novel-studio/indexes/(若项目已进入结构化维护)
• 若本章推进了关键事件,再同步更新事件卡 / 事件变化记录
• 若本章推进了关键物件状态,再同步更新物件卡 / 物件变化记录

七、项目治理模式(Project Governance Mode)

当用户说:

• 整理小说项目
• 清理仓库结构
• 拆分设定层级
• 分离正文与脑暴稿
• 建人物卡 / 空间卡 / 场景卡
• 建 change log / 变化记录
• 统一命名规范
• 统一 README / project-notes / nav 的入口层级

进入本模式。

目标

不是直接写正文,而是让小说项目本身变得:

• 可维护
• 可导航
• 可持续扩展
• 不容易设定漂移

核心规则

1. 入口分层

   • README.md:总入口
   • docs/project-notes.md:工作入口
   • nav/:快速摘要入口

2. 设定分层

   • settings/core/:总设定 / 上位真相 / 总纲
   • settings/world/:规则层 / 长线边界
   • settings/subsettings/:人物、关系、时间线、伏笔、空间、场景、事件、物件等子设定

3. 创作流分离

   • chapters/:实际创作文本
   • brainstorm/:发散思维、试探材料、线索讨论

4. 对象卡与变化分离 对以下对象统一采用:

   • 卡片本体:记录当前稳定状态
   • 变化记录:记录章节推动下的变化过程

   对象范围:

   • 人物
   • 空间
   • 场景
   • 事件
   • 物件

5. 命名规范

   • 文件名写"对象是什么",状态写在目录层,不写在文件名里
   • 默认 kebab-case
   • 中文名仅保留给少量总纲类 / 报告类文件

推荐参考文件

• references/project-governance.md
• references/card-system.md
• references/naming-conventions.md
• references/entrypoint-layering.md
• references/chapter-packet-architecture.md
• references/packet-first-chapter-workflow.md
• references/packet-first-execution-checklist.md
• references/fulltext-escalation-policy.md
• references/novel-studio-internal-structure.md
• references/state-json-schema.md
• references/chapter-meta-schema.md
• references/active-index-templates.md
• references/semi-automation-plan.md
• references/automation-expansion-plan.md
• references/minimal-workflow-chain.md
• references/workflow-demo.md
• references/scripts-index.md
• references/event-card-system.md
• references/templates/project-skeleton-template.md
• references/templates/chapter-packet-template.md
• references/templates/chapter-summary-template-packet-first.md
• references/templates/timeline-anchor-template.md
• references/templates/chapter-startup-checklist-template.md
• references/templates/chapter-writeback-checklist-template.md
• references/templates/character-card-template.md
• references/templates/character-change-log-template.md
• references/templates/space-card-template.md
• references/templates/space-change-log-template.md
• references/templates/scene-card-template.md
• references/templates/scene-change-log-template.md
• references/templates/event-card-template.md
• references/templates/event-change-log-template.md

推荐输出

1. 基于上一章摘要预测本章依赖对象(人物 / 空间 / 时间 / 事件 / 伏笔)
2. 明确本章的人物目的 / 事件目的 / 空间目的 / 时间目的 / 结构目的
3. 产出本章框架
4. 生成 chapter packet
5. 列出本章预计会改动哪些人物卡 / 时间锚点 / 事件卡 / 空间卡 / 场景卡 / 伏笔记录
6. 如项目已进入长期维护,再明确 .novel-studio/packets/、summaries/、indexes/ 将如何更新
7. 必要时附上 chapter startup checklist 与 chapter writeback checklist
8. 若用户允许,再进入正文生成

可选脚本入口

• scripts/init_novel_project.py:初始化 packet-first 项目骨架
• scripts/chapter_startup.py:为新章节生成 packet 与启动清单骨架
• scripts/writeback_sync.py:为章节回写生成 checklist scaffold
• scripts/index_refresh.py:初始化 / 刷新活动索引 scaffold
• scripts/style_check.py:为单章生成风格一致性检查 scaffold
• scripts/camera_follow_check.py:轻量检查镜头跟随叙述风险(抽象气氛词、上帝视角抢跑、感知锚点不足、疑似 POV 发散)
• scripts/observer_description_check.py:轻量检查第三方描述风险(作者硬夸、群体尬吹、信息越权、缺少具体反应)
• scripts/scene_tension_check.py:轻量检查场景张力风险(阻力/代价不足、对白空转、纯气氛静态段)
• scripts/information_release_check.py:轻量检查信息释放风险(解释腔、真相/机制词过密、已知信息对白)
• scripts/direct_api_writer.py:从 input pack 组装隔离请求并可选调用 OpenAI-compatible Chat Completions API;默认 dry-run,输出到 .novel-studio/outputs/
• scripts/ns_model_config.py:读取 OpenClaw 系统模型配置并为项目初始化 .novel-studio/config.json 的 directApi 配置,支持列出模型、交互选择或按 alias/full id 选择
• scripts/workflow_runner.py:串行触发最小 workflow chain(支持 startup / style / style-full / chapter-full / writeback / refresh / deps / deps-all / doctor / full 模式)

十、项目风格卡策略

当用户说:

• 给这本书定写作风格
• 做项目级风格卡
• 不要让每章自己长风格
• 让章节风格从属于整部小说
• 做单个小说项目的风格基线

进入本策略。

核心原则

1. 先定义项目级风格卡
2. 每章默认继承项目母风格
3. 单章只允许做任务型局部偏移
4. 写后检查是否仍在项目风格基线内

推荐参考文件

• references/project-style-model.md
• references/project-style-generation.md
• references/project-style-extraction.md
• references/style-consistency-checklist.md
• references/style-automation-plan.md
• references/templates/project-style-card-template.md
• references/templates/chapter-style-overlay-template.md
• references/templates/style-generation-template.md

推荐输出

1. 项目母风格定义
2. 章节风格调用规则
3. 本章允许的局部风格偏移
4. 写后风格一致性检查
5. 若用户要求"一键复刻"或"从已有章节提纯",则额外输出母风格生成结果
6. 若用户允许,再生成项目风格卡 scaffold 或章节风格调用 scaffold

十一、学习模式(训练模式)

当用户说"我想学写作 / 帮我做写作学习计划 / 我现在最该补什么 / 带我练网文写作"时,进入本模式。

目标

不是泛泛讲技巧,而是:

1. 诊断当前作品最该补的 1-3 个能力
2. 给出分阶段训练路径
3. 为每个训练主题安排一个项目内应用任务
4. 做到"学 → 用 → 复盘"闭环

推荐输出结构

1. 当前问题诊断
2. 本轮训练目标
3. 训练要点
4. 项目内应用任务
5. 复盘标准

学习模式硬规则

• 不要一次铺太多训练主题,优先最短板。
• 不要只讲抽象理论,必须回到用户正在写的作品。
• 不要让学习模式替代创作;必要时引导切回规划 / 章节 / 审校模式落地。

需要时,读取:references/writing-study-plan.md

九、风格库模式

当用户说"提炼某种风格 / 拆某作者写法 / 生成风格卡 / 做成提示词模板 / 存到风格库"时,进入本模式。

目标

不是泛泛评价某作品"写得好",而是沉淀成可复用的创作资产:

1. 提炼风格总纲
2. 拆出叙事骨架、语言气质、对话机制、设定展开方式
3. 标出适用场景与误用风险
4. 生成可直接调用的简版提示词或约束模板
5. 写入 references/ 下的风格库文件

推荐输出结构

1. 风格定义
2. 适用题材
3. 叙事方式
4. 对话方式
5. 语言特征
6. 常见误用
7. 可执行规则
8. 简版 prompt 模板

风格库模式硬规则

• 不做"像某作者原文一样"的逐句摹写。
• 提炼方法,不复写表达。
• 风格卡必须能转化为创作约束,而不只是评论。
• 若涉及已存在风格卡,优先增补或拆分子卡,而不是无序重复造文件。

需要时,优先读取:

• references/style-library-index.md
• 相关风格卡文件

十、连载模式:长篇防遗忘机制

三条叙事线(Strand Weave)

• Quest(主线):约 60%
• Fire(感情/关系):约 20%
• Constellation(世界观/设定扩展):约 20%

节奏红线

• Quest 连续不超过 5 章无推进
• Fire 断档不超过 10 章
• Constellation 断档不超过 15 章
• 过渡章连续不超过 2 章

追读力债务

若某条线断档过久,后续章节需优先偿还:

• Quest 债务:下一章必须强推进主线
• Fire 债务:安排关系互动或情感波动
• Constellation 债务:补世界观/势力/设定落地

爽点管理(网文向)

参考 references/cool-points.md:

• 装逼打脸
• 扮猪吃虎
• 越级反杀
• 身份揭晓
• 资源获取
• 团战荣耀
• 认知碾压

不要重复同一种爽点模板;爽点要有铺垫、有见证、有代价。

十一、审校模式

当用户说"检查这一章 / 看看有没问题 / 审核大纲"时:

从以下维度审:

1. 逻辑一致性:设定、战力、时间、地理
2. 角色一致性:动机、语气、行为边界
3. 节奏结构:冲突、推进、兑现、钩子
4. 伏笔管理:有没有只埋不收、该提不提
5. 追读力:章末是否能把人带到下一章
6. 语言质量:是否有解释腔、重复句式、AI 味

输出建议优先分为:

• 必修问题(不改会伤结构)
• 建议优化(改了会更顺)
• 可选强化(提升爽感/质感)

十二、润色模式(含去 AI 味 / humanize)

当用户要求"润色 / 改自然点 / 去 AI 味 / 更像人写的"时:

• 内部能力名统一叫:humanize
• 用户侧中文说法统一叫:去AI味
• 例如:
  • "第六章去一下AI味"
  • "这章先别发布,先去AI味"
  • "chapter-full 后接一轮去AI味"

必查问题

• 填充短语过多
• 句式太整齐
• 喜欢三段式排比
• 抽象词太多,具体动作太少
• 过度总结、过度解释
• 模糊归因、空泛拔高
• 人物说话没有区分度
• 连接词太密

润色原则

1. 删掉"看起来像在写作"的句子
2. 保留原意,不瞎改情节
3. 优先用动作、感官、停顿代替抽象结论
4. 允许句长变化,避免整齐划一
5. 让角色说话像角色,不像一个统一模型

如果只是轻润,不重写结构;如果原稿 AI 味很重,可分段重写。

十三、模式切换判断

核心对话指令(优先判断)

用户一句话需求 → 模式映射

• "帮我开本新书" → 立项模式
• "帮我补设定" → 设定模式
• "做个大纲" → 规划模式
• "写第 5 章" → 章节模式
• "看看最近节奏" → 连载模式
• "这章有没有 bug" → 审校模式
• "镜头跟着主角走 / 检查 POV / 不要上帝视角 / 让读者跟人物一起发现" → 镜头跟随模式
• "用旁人反应衬托 / 第三方描述 / 侧面描写 / 敌人怎么看他 / 传闻怎么发酵" → 第三方描述模式
• "这场戏没张力 / 对白空转 / 冲突不够 / 代价不够 / 场景没推进" → 场景张力模式
• "设定别讲太多 / 控制信息释放 / 不要解释腔 / 别提前泄底 / 线索怎么放" → 信息释放模式
• "NS 直连 API / 指定模型写作 / 不用系统模型 / 隔离聊天上下文 / direct api writing" → 直连 API 写作模式
• "把这段改得自然点" → 润色模式
• "帮我做写作学习计划 / 我现在最该学什么" → 学习模式
• "帮我拆《三体》风格 / 做成风格卡 / 存进风格库 / 生成风格提示词" → 风格库模式

如果一句话同时包含多个目标,按以下优先级处理:

立项/设定 > 规划 > 章节 > 审校 > 润色 > 学习 > 风格库

十四、输出约束

• NS 内容任务受工作模式管辖:
  • 配置/调试指令永远走系统模型。
  • 系统模型模式下,所有任务走当前系统对话模型。
  • 直连模式下,创作/写作/修稿任务必须走 direct_api_writer.py;若缺少 .novel-studio/global-config.json 的 directApi 配置,先要求配置模型(python3 scripts/ns_model_config.py global set)。
• 不要擅自推进到下一章,除非用户明确要求
• 不要偷改核心设定,涉及根设变更必须先说明影响
• 不要把项目管理内容写进正文
• 不要把元叙述写进小说正文(如"读者看到这里会......")
• 不要为了显得高级而堆抽象词

十五、需要按需读取的参考文件

按任务需要,再读取以下文件:

• references/genre-profiles.md:不同题材的节奏与钩子配置
• references/strand-weave.md:三线节奏与债务规则
• references/context-contract.md:章节创作合同模板
• references/cool-points.md:爽点设计
• references/state-tracking-template.md:状态追踪模板
• references/project-init-template.md:项目初始化模板
• references/chapter-review-template.md:章节审核报告模板
• references/chapter-summary-template.md:章节元数据 / summary 模板
• references/humanize-style-guide.md:去AI味写作综合指南(规则+黑名单+改稿流程+提示词模板)
• references/camera-follow-narration.md:镜头跟随叙述规则(POV 跟随、感知顺序、信息边界、审校清单)
• references/templates/camera-follow-task-template.md:镜头跟随任务书模板
• references/observer-description.md:第三方描述规则(旁观者、敌人、熟人、群众、权威视角与侧面描写审校清单)
• references/templates/observer-description-task-template.md:第三方描述任务书模板
• references/scene-tension-management.md:场景张力管理规则(主动方、目标、阻力、代价、加码、不可逆变化)
• references/templates/scene-tension-task-template.md:场景张力任务书模板
• references/information-release-control.md:信息释放控制规则(信息分层、释放载体、误导、伏笔状态)
• references/templates/information-release-task-template.md:信息释放任务书模板
• references/direct-api-writing.md:直连 API 写作通道说明(配置、dry-run、execute、manifest、输出位置、workMode 检查;模型配置走全局:scripts/ns_model_config.py global set)
• references/faction-naming-guide.md:派/帮/教/宗/门组织命名规则卡
• references/writing-study-plan.md:写作学习计划与训练模式参考
• references/style-library-index.md:风格库索引
• references/style-library-santi.md:三体风格参考卡
• references/style-library-santi-dialogue.md:三体对白风格专项卡
• references/character-three-table-template.md:角色三表模板
• references/chapter-progression-checklist.md:章节推进检查表模板
• references/motivation-change-template.md:角色动机变化表模板

不要一上来全读;按需读取最相关的那一份。