Novel Writer - AI 驱动的中文小说创作工具
🚀 基于规格驱动开发（SDD）的 AI 智能小说创作助手
在 Claude、Cursor、Gemini 等 AI 助手中直接使用斜杠命令，系统化创作高质量小说
✨ 核心特性
- 📚 斜杠命令 - 在 Claude、Gemini、Codex、Cursor、Windsurf、Roo Code 等 AI 助手中直接使用
- 🎯 七步方法论 - 基于规格驱动开发（SDD）的系统化创作流程
- 🤖 智能辅助 - AI 理解上下文，提供针对性创作建议
- 📝 中文优化 - 专为中文小说创作设计，支持字数统计、多线索管理
- 🔄 跨平台 - 支持 13 个 AI 工具，Windows/Mac/Linux 全平台
- 🔌 插件系统 - 可扩展功能，如真实人声、翻译、风格模仿等
- ✅ 质量保障 - 情节追踪、时间线管理、角色一致性验证
📖 详细特性说明：查看 CHANGELOG.md 了解各版本的完整更新
🚀 快速开始
1. 安装
npm install -g novel-writer-cn
2. 初始化项目
# 基本用法
novel init my-novel
# 推荐：预装真实人声插件
novel init my-novel --plugins authentic-voice
# 指定 AI 平台
novel init my-novel --ai claude # Claude Code
novel init my-novel --ai gemini # Gemini CLI
novel init my-novel --ai codex # Codex CLI
novel init my-novel --ai cursor # Cursor
3. 开始创作
在 AI 助手中使用斜杠命令：
/novel.constitution # Claude Code 格式
/novel:constitution # Gemini CLI 格式
/novel-constitution # Codex CLI 格式
/constitution # 其他平台格式
七步方法论流程：
/constitution → 2. /specify → 3. /clarify →/plan → 5. /tasks → 6. /write → 7. /analyze
📚 详细安装说明：docs/installation.md
📖 完整工作流程：docs/workflow.md
🎯 AI 平台命令对照：docs/ai-platform-commands.md ⭐ 必读
📦 升级现有项目
# 升级到最新版本
npm install -g novel-writer-cn@latest
cd my-novel
novel upgrade
# 或指定 AI 平台
novel upgrade --ai claude
📚 完整升级指南：docs/upgrade-guide.md - 包含版本兼容性、迁移说明、回滚方法
📚 斜杠命令
命名空间说明
| AI 平台 |
命令格式 |
示例 |
| Claude Code |
/novel.命令名 |
/novel.write |
| Gemini CLI |
/novel:命令名 |
/novel:write |
| Codex CLI |
/novel-命令名 |
/novel-write |
| 其他平台 |
/命令名 |
/write |
💡 下表使用通用格式，实际使用时请根据您的 AI 平台添加相应前缀
📖 详细命令对照：docs/ai-platform-commands.md
七步方法论
| 命令 |
描述 |
何时使用 |
/constitution |
创作宪法 |
项目开始，定义核心创作原则 |
/specify |
故事规格 |
像 PRD 一样定义故事需求 |
/clarify |
澄清决策 |
通过 5 个问题明确模糊点 |
/plan |
创作计划 |
制定章节结构和技术方案 |
/tasks |
任务分解 |
生成可执行的任务清单 |
/write |
章节写作 |
基于任务清单进行创作 |
/analyze |
综合验证 |
智能双模式：框架分析/内容分析 |
追踪与验证
| 命令 |
描述 |
何时使用 |
/track-init |
初始化追踪 |
首次使用（只需一次） |
/checklist |
质量检查清单 ⭐ |
规格验证（写作前）+ 内容扫描（写作后） |
/track |
综合追踪 |
每完成一章后 |
/plot-check |
情节检查 |
每 5-10 章定期检查 |
/timeline |
时间线管理 |
重要事件后 |
/relations |
关系追踪 |
角色关系变化时 |
/world-check |
世界观检查 |
新设定出现后 |
📖 详细命令说明：docs/commands.md - 包含每个命令的详细用法、参数和最佳实践
📁 项目结构（点击展开）
my-novel/
├── .specify/ # Spec Kit 配置
│ ├── memory/ # 创作记忆（constitution.md等）
│ └── scripts/ # 支持脚本
├── .claude/ # Claude 命令（或 .cursor/.gemini 等）
│ └── commands/ # 斜杠命令文件
├── spec/ # 小说规格数据
│ ├── tracking/ # 追踪数据（plot-tracker.json等）
│ └── knowledge/ # 知识库（world-setting.md等）
├── stories/ # 故事内容
│ └── 001-故事名/
│ ├── specification.md # 故事规格
│ ├── creative-plan.md # 创作计划
│ ├── tasks.md # 任务清单
│ └── content/ # 章节内容
└── scripts/ # 支持脚本
├── bash/ # Unix/Linux/Mac
└── powershell/ # Windows
🤖 支持的 AI 助手
| AI 工具 |
说明 |
状态 |
| Claude Code |
Anthropic 的 AI 助手 |
✅ 推荐 |
| Cursor |
AI 代码编辑器 |
✅ 完整支持 |
| Gemini CLI |
Google 的 AI 助手 |
✅ TOML 格式 |
| Windsurf |
Codeium 的 AI 编辑器 |
✅ 完整支持 |
| Roo Code |
AI 编程助手 |
✅ 完整支持 |
| GitHub Copilot |
GitHub 的 AI 编程助手 |
✅ 完整支持 |
| Qwen Code |
阿里通义千问代码助手 |
✅ TOML 格式 |
| OpenCode |
开源 AI 编程工具 |
✅ 完整支持 |
| Codex CLI |
AI 编程助手 |
✅ 完整支持 |
| Kilo Code |
AI 编程工具 |
✅ 完整支持 |
| Auggie CLI |
AI 开发助手 |
✅ 完整支持 |
| CodeBuddy |
AI 编程伙伴 |
✅ 完整支持 |
| Amazon Q Developer |
AWS 的 AI 开发助手 |
✅ 完整支持 |
💡 使用 novel init --all 可以同时为所有 AI 工具生成配置
🛠️ CLI 命令
详细选项（点击展开）
novel init [name]
novel init my-novel [选项]
常用选项：
--here - 在当前目录初始化--ai <type> - 选择 AI 平台（claude/gemini/cursor等）--with-experts - 包含专家模式--plugins <names> - 预装插件（逗号分隔）--all - 生成所有 AI 平台配置
novel plugins
novel plugins list # 列出已安装插件
novel plugins add <name> # 安装插件
novel plugins remove <name> # 移除插件
novel upgrade
novel upgrade [--ai <type>] # 升级项目到最新版本
novel check
novel check # 检查项目配置和状态
📖 文档索引
核心文档
进阶文档
插件与扩展
- 真实人声插件 -
novel plugins add authentic-voice
- 编辑
.specify/memory/personal-voice.md 配置个人语料
- 使用
/authentic-voice 创作，/authenticity-audit 自查
- 翻译插件 -
novel plugins add translate
- 风格模仿插件 - 路遥、王钰等作家风格
💡 使用 novel plugins list 查看所有可用插件
📈 版本历史
查看完整的更新日志：CHANGELOG.md
最新版本亮点：
- v0.15.0 - 多平台命令格式优化
- v0.14.2 - 中文字数统计修复
- v0.12.2 - Claude Code 增强层
- v0.12.0 - 多线索管理系统
- v0.10.0 - 七步方法论体系
🤝 贡献
欢迎提交 Issue 和 Pull Request！
项目地址：https://github.com/wordflowlab/novel-writer
📄 许可证
MIT License
🌐 项目矩阵
WordFlowLab 围绕 AI 辅助小说创作展开多维度探索，采用不同方法论和技术栈的开源项目组合：
方法论探索系列
工具实现系列
| 项目 |
类型 |
技术基础 |
说明 |
| WriteFlow |
CLI 工具 |
模仿 Claude Code 架构 |
独立 CLI，为技术型作家设计 |
| NovelWeave |
VSCode 扩展 |
Fork: Cline → Roo Code → Kilo Code → NovelWeave |
可视化小说编辑器，星尘织梦 |
技术演进路径
Spec-Kit 方法论分支:
Novel-Writer (主线) ──┬─→ Novel-Writer-Skills (Claude Code 专版)
└─→ WriteFlow (CLI 独立版)
OpenSpec 方法论分支:
Novel-Writer-OpenSpec (探索版)
VSCode 扩展分支:
Cline → Roo Code → Kilo Code → NovelWeave (小说定制版)
选择建议
根据您的经验背景选择合适的工具：
快速决策：
- 完全新手 → NovelWeave（可视化最友好）
- 用 Claude Code → Novel-Writer-Skills（深度集成 Agent Skills）
- 跨多个 AI 工具 → Novel-Writer（支持 13 个平台）
- 追求规格化 → Novel-Writer-OpenSpec（OpenSpec 方法论）
- 喜欢命令行 → WriteFlow（纯 CLI 体验）
💡 多矩阵、多方法论组合开源：探索 AI 写作的不同可能性，欢迎根据需求选择合适的工具！
🙏 致谢
本项目基于 Spec Kit 架构设计，特此感谢！
Novel Writer - 让 AI 成为你的创作伙伴！ ✨📚
评论