# NovelWeave（星尘织梦）- AI 驱动的小说写作 VSCode 插件

[English](README.md) | [简体中文](#)

> 🌟 使用 AI 驱动的辅助、结构化方法论和无缝的 VSCode 集成，改变你的小说创作体验。
>
> 基于经过验证的 [novel-writer](https://github.com/wordflowlab/novel-writer) 方法论，NovelWeave 将专业的小说创作工具直接集成到你的 VSCode 工作流中。

## ✨ 核心特性

- 📝 **七步方法论** - 规范驱动的小说创作工作流
- 🎨 **可视化界面** - 直观的侧边栏、网页面板和集成的 AI 聊天
- 🤖 **多 AI 支持** - Claude 4、GPT-4、Gemini Pro 以及 400+ AI 模型
- 📊 **项目管理** - 章节追踪、角色档案、情节线索
- 🔌 **斜杠命令** - 完整支持 novel-writer 命令系统
- ✅ **质量保证** - 情节追踪、时间线管理、一致性验证
- 🌐 **跨平台** - 支持 Windows、macOS 和 Linux

## 🚀 快速开始

### 1. 安装

从 VSCode 市场安装 NovelWeave：

```bash
# 在 VSCode 扩展中搜索 "NovelWeave"
# 或通过命令安装：
code --install-extension novelweave.novelweave
```

### 2. 创建你的第一个小说项目

1. 打开 VSCode 并点击活动栏中的 NovelWeave 图标
2. 点击"新建项目"初始化一个小说项目
3. 选择你的 AI 模型并配置设置
4. 开始使用 AI 辅助写作！

### 3. 使用七步方法论

NovelWeave 实现了经过验证的七步小说创作方法论：

```
1. /constitution  → 建立核心创作原则
2. /specify       → 定义故事需求
3. /clarify       → 通过问答解决模糊性
4. /plan          → 设计技术实现方案
5. /tasks         → 分解为可执行的步骤
6. /write         → 执行实际写作
7. /analyze       → 验证质量和一致性
```

## 📚 七步方法论详解

### 第一步：`/constitution` - 创作宪章

定义你不可妥协的写作原则、风格指南和核心价值观，这些将指导你的整部小说创作。

**为什么重要？** 就像公司的价值观一样，创作宪章是你在面临困难决策时的指南针。它确保你的作品保持一致的声音和愿景。

### 第二步：`/specify` - 故事规格

像产品需求文档（PRD）一样，准确定义你想要创作的故事、目标受众和成功标准。

**关键要素**：

- 故事核心概念和主题
- 目标读者群体
- 预期长度和结构
- 成功指标（如情感影响、节奏等）

### 第三步：`/clarify` - 关键澄清

AI 识别你的规格中的模糊之处，生成最多 5 个关键问题，在写作前消除混淆。

**示例问题**：

- "主角的核心冲突是内在还是外在？"
- "故事的时间跨度是多久？"
- "次要角色的发展弧线需要多深入？"

### 第四步：`/plan` - 创作计划

将抽象需求转化为具体的技术解决方案：章节结构、角色弧线、世界观构建和情节时间线。

**输出内容**：

- 详细的章节大纲
- 角色发展路线图
- 世界观设定文档
- 情节时间线和里程碑

### 第五步：`/tasks` - 任务分解

将计划分解为可执行的写作任务，明确优先级和依赖关系。

**任务示例**：

- [ ] 编写第1章：主角登场（2000字）
- [ ] 完善角色A的背景故事
- [ ] 绘制魔法系统规则图表

### 第六步：`/write` - 执行写作

基于你的任务列表进行写作，遵循宪章原则和创作计划。

**最佳实践**：

- 一次专注于一个任务
- 使用 AI 辅助保持角色声音一致
- 定期参考创作宪章
- 小步快跑，频繁提交

### 第七步：`/analyze` - 综合验证

验证情节一致性、时间线准确性、角色发展和对创作原则的遵守。

**验证清单**：

- ✅ 所有情节线索都已解决
- ✅ 时间线没有矛盾
- ✅ 角色行为符合设定
- ✅ 符合创作宪章的核心原则

> 📖 **详细方法论**：从 [novel-writer 文档](https://github.com/wordflowlab/novel-writer) 了解更多

## 🔧 NovelWeave vs novel-writer CLI

| 特性           | novel-writer CLI | NovelWeave VSCode            |
| -------------- | ---------------- | ---------------------------- |
| **界面**       | 命令行           | 图形化 UI                    |
| **安装**       | `npm install -g` | VSCode 市场                  |
| **AI 集成**    | 基础             | 完整的 AI 聊天和辅助         |
| **项目管理**   | 文件系统         | VSCode 工作区 + UI 面板      |
| **斜杠命令**   | ✅               | ✅                           |
| **可视化追踪** | ❌               | ✅（情节、角色、时间线）     |
| **学习曲线**   | 需要 CLI 熟悉度  | 直观的 UI                    |
| **最适合**     | 技术型作家       | 所有作家，特别是 VSCode 用户 |

**它们可以协同工作！** 使用 novel-writer CLI 进行自动化和脚本编写，而 NovelWeave 提供可视化界面和 AI 交互。

## 🎯 使用场景

- **长篇小说** - 管理 100+ 章节的复杂情节
- **网络连载** - 使用 AI 辅助保持每日更新的一致性
- **剧本创作** - 结构化叙事与场景管理
- **同人创作** - 与原作保持一致性
- **创意写作** - 任何叙事项目都能从结构化方法论中受益

## 📖 功能详解

### AI 驱动的写作助手

- **智能续写** - AI 根据你的风格建议下一段落
- **角色声音** - 保持一致的角色个性
- **情节建议** - AI 帮助解决情节漏洞和节奏问题
- **风格分析** - 对写作风格和可读性的反馈

### 项目组织

- **章节管理** - 在侧边栏中导航和组织章节
- **角色档案** - 追踪角色发展和关系
- **世界观构建** - 管理设定、规则和传说
- **情节线索** - 可视化和追踪多条故事线

### 质量保证

- **一致性检查** - 验证角色特征、时间线和事实
- **情节追踪** - 确保所有情节线索都已解决
- **时间线管理** - 时间顺序准确性验证
- **风格一致性** - 保持你独特的写作声音

## 🆕 v1.0 新特性

- ✅ 完整的七步方法论实现
- ✅ 多 AI 模型支持（400+ 模型）
- ✅ 可视化项目管理界面
- ✅ 集成的情节和角色追踪
- ✅ 实时 AI 写作辅助
- ✅ 完全兼容 novel-writer 斜杠命令

## 💡 最佳实践

1. **从宪章开始** - 在写作前定义你的原则
2. **充分使用澄清** - 尽早解决模糊性以避免重写
3. **信任流程** - 遵循所有七个步骤以获得最佳结果
4. **迭代优化** - 随着故事发展返回到早期步骤
5. **持续追踪** - 在每个主要章节后更新追踪器

## 🎨 工作流示例

### 典型的小说创作流程

```bash
# 1. 创建项目并定义原则
/constitution
# 输出：创作宪章文档

# 2. 编写故事规格
/specify
# 输出：故事需求文档（类似 PRD）

# 3. 让 AI 提出关键问题
/clarify
# 输出：5个关键澄清问题

# 4. 基于回答创建详细计划
/plan
# 输出：章节大纲、角色弧线、世界观文档

# 5. 分解为具体任务
/tasks
# 输出：可执行的写作任务列表

# 6. 开始写作
/write
# 使用 AI 辅助逐步完成任务

# 7. 验证和改进
/analyze
# 检查一致性、情节完整性、时间线准确性
```

## 🔗 相关资源

- 📦 [novel-writer CLI 工具](https://github.com/wordflowlab/novel-writer) - 命令行伴侣工具
- 📖 [七步方法论](https://github.com/wordflowlab/novel-writer/blob/main/METHODOLOGY.md) - 详细方法论指南
- 💬 [社区 Discord](#) - 加入其他使用 NovelWeave 的作家
- 📺 [视频教程](#) - 观看分步指南

## 🤝 贡献

我们欢迎贡献！请查看我们的[贡献指南](CONTRIBUTING.md)了解详情。

## 📄 许可证

MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

## 🙏 致谢

- 基于 [NovelWeave](https://github.com/wordflowlab/novelweave) 架构构建
- 方法论来自 [novel-writer](https://github.com/wordflowlab/novel-writer)
- 灵感来自 [Spec Kit](https://github.com/sublayerapp/spec-kit) 原则

---

**NovelWeave（星尘织梦）** - AI 与叙事艺术的完美结合 ✨📚

用 ❤️ 为全世界的作家打造