novel

Claude Code 小说写作辅助插件。提供从大纲规划到正文续写的完整创作工具链，支持伏笔追踪、动态上下文加载和风格一致性控制。

功能

命令	说明
/outline	编写、修改或基于构思生成大纲（世界观、主题、核心冲突、结构规划）
/character	新增、修改人物，或基于大纲/时间线批量生成候选人物
/event	新增、修改事件，或基于大纲/人物批量推演关键事件
/timeline	管理时间线，或从事件自动生成，检查因果矛盾
/style	创建、修改风格，或从参考作品/已写章节提炼风格
/import	导入已有小说原文，一次性分析生成所有设定文件
/continue	基于全部设定上下文续写小说，自动生成章节元数据

每个命令都支持三种模式：手动录入（你给出完整内容）、精确修改（指哪改哪）、AI 生成（基于上游设定自动推演）。比如大纲已经写好后，可以直接说「基于大纲生成 5 个主要人物」，插件会先列候选清单让你确认，再批量写入 characters/。

安装

在 Claude Code 中运行：

/plugin marketplace add cabinary/claude-plugins
/plugin install novel@cabinary-plugins

或在 ~/.claude/settings.json 中手动添加：

{
  "extraKnownMarketplaces": {
    "cabinary-plugins": {
      "source": { "source": "github", "repo": "cabinary/claude-plugins" }
    }
  },
  "enabledPlugins": {
    "novel@cabinary-plugins": true
  }
}

使用流程

从零开始创作

推荐流程（支持任意步骤调用 AI 生成）：

/outline → /style → /character → /event → /timeline → /continue

1. /outline 先建立大纲骨架（可直接给构思让 AI 扩展）
2. /style 定义写作风格（可描述、可举参考作品、可从样章归纳）
3. /character 基于大纲生成主要人物 — AI 推演候选清单，你挑选后写入
4. /event 基于大纲和人物推演关键事件 — AI 拆分情节节点
5. /timeline 从事件生成时间线 — AI 按因果排序，指出矛盾
6. /continue 开始续写

任何一步都可以手动录入或精确修改，不是必须走 AI 生成。

导入已有小说

/import 文件路径.txt

一键分析原文，自动生成大纲、人物、事件、时间线、风格设定和章节元数据，然后用 /continue 续写。

项目结构

安装插件后，你的小说项目目录会形成以下结构：

你的项目/
├── CLAUDE.md          # 写作规范（可从插件仓库复制）
├── outline.md         # 大纲
├── style.md           # 风格设定
├── timeline.md        # 时间线
├── characters/        # 人物设定
│   └── {人物名}.md
├── events/            # 事件设定
│   └── {事件名}.md
└── chapters/          # 章节
    ├── 001-标题.md       # 正文
    └── 001-标题.meta.md  # 元数据

核心机制

章节元数据

每章自动生成 .meta.md 文件，包含：

• 摘要 — 一两句话概括本章内容
• 伏笔追踪 — [ ] 未回收 / [x] 已回收
• 悬念/钩子 — 章末留下的悬念
• 人物状态变化 — 本章中人物的情感/认知变化
• context_depth — 续写下一章时需要回溯多少章全文

动态上下文加载

续写时根据最新章节的 context_depth 智能加载前文：

• 近章加载全文（保证衔接质量）
• 远章只加载摘要（节省上下文窗口）
• 伏笔和悬念始终全量加载（确保不遗漏）
• 大纲、人物、事件、时间线、风格全量加载

协议

MIT