novel-maker 2.2.0

package/skill/arc-templates/xianxia/tournament.md

@@ -0,0 +1,71 @@
+# 宗门大比弧
+
+> 主角参加宗门内部比武大会，一路过关斩将，最终赢得荣耀的弧线
+
+## 弧线结构
+
+报名 → 初赛 → 复赛 → 决赛 → 奖励
+
+## 阶段定义
+
+### 阶段 1：报名（2-3章）
+**目标：** 交代大比背景、规则和参赛动机，建立期待感
+**关键事件：**
+- 宗门大比即将开始，公布规则和奖励
+- 主角决定参赛（主动或被迫），明确目标
+- 各方势力暗流涌动，潜在对手陆续登场
+**情绪走向：** 期待 → 紧张
+**章节建议：** 2-3章
+
+### 阶段 2：初赛（2-3章）
+**目标：** 通过初赛展示实力，同时观察潜在对手
+**关键事件：**
+- 初赛采用群战/积分/淘汰制，门槛较低
+- 主角轻松通过，但有意隐藏部分实力
+- 观察到几个实力强劲的对手，暗中评估
+**情绪走向：** 从容 → 留意
+**章节建议：** 2-3章
+
+### 阶段 3：复赛（2-3章）
+**目标：** 遭遇强劲对手，比赛进入白热化
+**关键事件：**
+- 遇到实力相当的对手，展开苦战
+- 被迫展露更多底牌和手段
+- 险胜或惨胜，同时暴露了弱点
+**情绪走向：** 紧张 → 激烈
+**章节建议：** 2-3章
+
+### 阶段 4：决赛（2-3章）
+**目标：** 巅峰对决，大比的最高潮
+**关键事件：**
+- 对阵最强对手，双方倾尽全力
+- 战斗过程中展现各自的成长和底牌
+- 关键时刻以出人意料的方式取胜
+**情绪走向：** 白热化 → 震撼
+**章节建议：** 2-3章
+
+### 阶段 5：奖励（1-2章）
+**目标：** 领取奖励，收获名声，为后续剧情铺垫
+**关键事件：**
+- 获得大比奖励（功法/丹药/资源/地位）
+- 名声大振，引来各方关注（包括敌意）
+- 大比中发现的线索或伏笔开始展开
+**情绪走向：** 满足 → 展望
+**章节建议：** 1-2章
+
+## 关键场景
+
+1. **强者亮相**：主要对手首次展示实力的震撼场景，需要让读者感受到威胁
+2. **苦战获胜**：主角遭遇真正强敌、险胜的场景，需要节奏紧凑、攻防转换精彩
+3. **决赛巅峰**：大比最终对决的场景，需要调动所有铺垫，做到情绪和战斗的双重高潮
+
+## 注意事项
+
+- **对手不能太弱**：每个阶段的对手都要有真正的威胁，不能让主角碾压全场
+- **战斗要多样化**：不同对手应有不同的战斗风格和手段，避免千篇一律的打斗
+- **不要忽略配角**：其他参赛者的战斗和故事也能丰富大比的精彩度
+- **大比要有后续影响**：大比的结果必须对后续剧情产生实质性影响，不能比完就忘
+
+## 适用题材
+
+修仙宗门、武道大会、学院竞技、比武招亲、天下第一武道会

package/skill/arc-templates/xianxia/tribulation.md

@@ -0,0 +1,71 @@
+# 渡劫弧
+
+> 主角面对天劫考验，经历失败后重修，最终成功渡劫的弧线
+
+## 弧线结构
+
+准备 → 渡劫 → 失败 → 再修 → 成功
+
+## 阶段定义
+
+### 阶段 1：准备（2-3章）
+**目标：** 渡劫在即，主角进行全面准备
+**关键事件：**
+- 感知到天劫将至，确定大致时间
+- 搜集渡劫所需的丹药、法宝和防护手段
+- 向有经验的前辈请教渡劫心得
+**情绪走向：** 紧迫 → 郑重
+**章节建议：** 2-3章
+
+### 阶段 2：渡劫（1-2章）
+**目标：** 天劫降临，主角正面应对
+**关键事件：**
+- 天劫正式降临，雷劫轰下
+- 主角运用准备的手段逐一抵挡
+- 天劫威力远超预期，形势急转直下
+**情绪走向：** 紧张 → 危急
+**章节建议：** 1-2章
+
+### 阶段 3：失败（1-2章）
+**目标：** 渡劫失败，遭受重创，但保住性命
+**关键事件：**
+- 在最后关头功亏一篑，被天劫击溃
+- 身受重伤，修为受损
+- 内心遭受巨大打击，但求生意志未灭
+**情绪走向：** 绝望 → 低谷
+**章节建议：** 1-2章
+
+### 阶段 4：再修（2-3章）
+**目标：** 从失败中汲取教训，重新修炼
+**关键事件：**
+- 疗伤恢复，反思失败的原因
+- 发现自身功法或心境的缺陷
+- 针对性地弥补不足，修炼新的保命手段
+**情绪走向：** 沉淀 → 坚定
+**章节建议：** 2-3章
+
+### 阶段 5：成功（1-2章）
+**目标：** 再次面对天劫，成功渡过
+**关键事件：**
+- 天劫再次降临，这次更加猛烈
+- 主角吸取上次教训，从容应对
+- 在最后关头以全新领悟成功渡劫
+**情绪走向：** 紧张 → 狂喜
+**章节建议：** 1-2章
+
+## 关键场景
+
+1. **天劫降临**：雷劫轰下的宏大场面，需要有天地之威的压迫感
+2. **功亏一篑**：渡劫失败的惨烈场景，需要让读者感到痛心但不绝望
+3. **逆天成功**：再次渡劫成功的壮丽场景，需要与上次失败形成鲜明对比
+
+## 注意事项
+
+- **失败不能白费**：第一次失败必须有实质性的收获（认知/经验），否则就是注水
+- **再修不能太长**：重修过程要精炼，重点放在认知提升而非重复修炼
+- **天劫要有层次**：不同阶段的天劫威力应有递进，不能每次都一样
+- **心境比实力重要**：渡劫的核心考验应该是心境而非单纯的实力对抗
+
+## 适用题材
+
+修仙渡劫、武道突破、飞升成仙、炼体锻魂、逆天改命

package/skill/docs/examples.md

@@ -0,0 +1,61 @@
+# 示例项目
+
+> 通过完整示例快速了解 NovelMaker 创作流程
+
+## 示例列表
+
+### 1. 修仙小说示例
+
+**题材：** 玄幻修仙
+**情绪标签：** 打脸爽文
+**文风：** 天蚕土豆
+
+**包含内容：**
+- 完整的创作宪法配置
+- 三幕结构大纲
+- 第一卷计划（20章）
+- 3章已写好的章节内容
+- 完整的真相文件
+
+**快速体验：**
+
+```bash
+# 复制示例到你的项目
+cp -r examples/cultivation-novel/.novel-maker ./
+cp -r examples/cultivation-novel/novels ./
+
+# 在 IDE 中继续写作
+/novel-maker write 写第四章
+```
+
+### 2. 都市搞笑示例
+
+**题材：** 都市搞笑
+**情绪标签：** 爆笑反套路
+**文风：** 会说话的肘子
+
+**包含内容：**
+- 完整的创作宪法配置
+- 三幕结构大纲
+- 第一卷计划（15章）
+- 3章已写好的章节内容
+
+### 3. 悬疑惊悚示例
+
+**题材：** 悬疑诡秘
+**情绪标签：** 悬疑惊悚
+**文风：** 爱潜水的乌贼
+
+**包含内容：**
+- 完整的创作宪法配置
+- 三幕结构大纲
+- 第一卷计划（12章）
+- 3章已写好的章节内容
+
+## 如何使用示例
+
+1. **查看配置**：了解创作宪法和真相文件的结构
+2. **阅读大纲**：理解三幕结构和幕规划
+3. **阅读已写章节**：了解写作风格和质量标准
+4. **继续写作**：使用 `/novel-maker write` 继续创作
+5. **审查质量**：使用 `/novel-maker review` 检查质量

package/skill/docs/faq.md

@@ -0,0 +1,81 @@
+# 常见问题
+
+## 安装问题
+
+### Q: 安装后 AI 没识别到技能？
+
+**解决方案：**
+1. 确认路径正确（注意是 `skills/novel-maker/` 不是直接 `skills/`）
+2. 确认 `SKILL.md` 存在于目录根
+3. 重启 IDE 会话
+4. 输入 `/novel-maker help` 手动触发
+
+### Q: npx novel-maker 运行失败？
+
+**解决方案：**
+1. 检查 Node.js 版本（需要 >= 16.0.0）
+2. 检查网络连接
+3. 尝试使用管理员权限运行
+4. 使用手动安装方式
+
+### Q: 可以全局安装吗？
+
+**解决方案：**
+可以。全局路径一般为 `~/.<ide>/skills/novel-maker/`，所有项目都能使用。
+
+## 使用问题
+
+### Q: 生成的内容不符合预期？
+
+**解决方案：**
+1. 检查创作宪法是否完善
+2. 提供更具体的写作指引
+3. 使用 `/novel-maker review` 检查问题
+4. 调整文风设置
+
+### Q: 字数不达标怎么办？
+
+**解决方案：**
+- AI 会自动扩写，直到达标
+- 也可以手动使用 `/novel-maker expand` 扩写
+- 检查字数设置是否合理
+
+### Q: 如何切换文风？
+
+**解决方案：**
+```
+/novel-maker style 换辰东风格
+```
+
+### Q: 如何查看当前设定？
+
+**解决方案：**
+```
+/novel-maker memory 主角什么等级
+```
+
+## 高级问题
+
+### Q: 如何自定义情绪标签？
+
+**解决方案：**
+1. 编辑 `.novel-maker/memory/constitution.md`
+2. 修改情绪标签配置
+3. 重启 IDE 会话
+
+### Q: 如何导入现有小说？
+
+**解决方案：**
+1. 将小说内容放入 `novels/` 目录
+2. 运行 `/novel-maker memory` 更新记忆
+3. 运行 `/novel-maker review` 检查一致性
+
+### Q: 脚本需要额外安装依赖吗？
+
+**解决方案：**
+不需要。所有 Python 脚本只使用标准库（`os`、`re`、`json`、`argparse`、`pathlib`）。
+
+### Q: 这个技能仓库和 MCP 有什么区别？
+
+**解决方案：**
+MCP 是外部服务接口协议，需要运行额外进程；Skill 是纯 Markdown 指令包，零依赖、零配置、无需启动，开箱即用。

package/skill/docs/installation.md

@@ -0,0 +1,87 @@
+# 安装指南
+
+> NovelMaker 支持 18 款主流 AI 编程工具
+
+## 一键安装（推荐）
+
+```bash
+cd /your/project
+npx novel-maker
+```
+
+脚本会自动检测你项目中使用的 IDE，将技能安装到正确位置。
+
+### 指定 IDE
+
+如果自动检测失败，可以显式指定：
+
+```bash
+npx novel-maker --tool trae
+```
+
+### 支持的 IDE 列表
+
+| IDE | 类型 | 安装路径 |
+|-----|------|----------|
+| Claude Code | CLI | `.claude/skills/novel-maker/` |
+| Copilot CLI | CLI | `.claude/skills/novel-maker/` |
+| Hermes Agent | CLI | `.hermes/skills/novel-maker/` |
+| Cursor | IDE | `.cursor/rules/novel-maker/` |
+| Windsurf | IDE | `.windsurf/skills/novel-maker/` |
+| Kiro | IDE | `.kiro/steering/` |
+| Gemini CLI | CLI | `.gemini/skills/novel-maker/` |
+| Codex CLI | CLI | `.codex/skills/novel-maker/` |
+| Aider | CLI | `.aider/skills/novel-maker/` |
+| Trae | IDE | `.trae/skills/novel-maker/` |
+| VS Code (Copilot) | IDE 插件 | `.github/superpowers/` |
+| DeerFlow | Agent 框架 | `skills/custom/novel-maker/` |
+| OpenCode | CLI | `.opencode/skills/novel-maker/` |
+| OpenClaw | CLI | `skills/novel-maker/` |
+| Qwen Code | IDE 插件 | `.qwen/skills/novel-maker/` |
+| Antigravity | CLI | `.agents/skills/novel-maker/` |
+| Claw Code | CLI (Rust) | `.claw/skills/novel-maker/` |
+| Qoder | IDE | `.qoder/skills/novel-maker/` |
+
+## 手动安装
+
+如果 npx 不可用，可以手动复制：
+
+```bash
+# Trae
+cp -r skill/* .trae/skills/novel-maker/
+
+# Claude Code
+cp -r skill/* .claude/skills/novel-maker/
+
+# Cursor
+cp -r skill/* .cursor/rules/novel-maker/
+```
+
+## 卸载
+
+```bash
+npx novel-maker --uninstall
+```
+
+## 安装验证
+
+安装完成后，在 IDE 聊天框输入：
+
+```
+/novel-maker help
+```
+
+如果返回帮助信息，说明安装成功。
+
+## 常见问题
+
+### Q: 安装后 AI 没识别到技能？
+
+1. 确认路径正确
+2. 确认 `SKILL.md` 存在于目录根
+3. 重启 IDE 会话
+4. 输入 `/novel-maker help` 手动触发
+
+### Q: 可以全局安装吗？
+
+可以。全局路径一般为 `~/.<ide>/skills/novel-maker/`，所有项目都能使用。

package/skill/docs/quickstart.md

@@ -0,0 +1,83 @@
+# 5分钟快速上手
+
+> 从零到写出第一章
+
+## 前提条件
+
+- 已安装 AI IDE（Trae / Claude Code / Cursor 等）
+- 已安装 NovelMaker 技能
+
+## 第一步：初始化项目（2分钟）
+
+### 1.1 输入初始化指令
+
+在 AI IDE 聊天框中输入：
+
+```
+/novel-maker init 开始写一本修仙小说
+```
+
+> 你可以替换 "修仙小说" 为你想要的任何题材
+
+### 1.2 选择启动方式
+
+AI 会询问你选择启动方式：
+
+1. **使用预设模板**（推荐新手）- 5个预设模板可选
+2. **自定义配置** - 完全控制所有设置
+3. **从现有配置导入** - 复用已有配置
+
+### 1.3 完成配置
+
+根据选择的启动方式，完成剩余配置项。AI 会显示进度指示器，让你知道当前进度。
+
+### 1.4 确认配置
+
+完成配置后，AI 会展示配置摘要，确认无误后输入 "确认"。
+
+## 第二步：生成大纲（1分钟）
+
+```
+/novel-maker plan 帮我生成总大纲
+```
+
+AI 会生成：
+- 三幕结构大纲
+- 角色设定
+- 世界观框架
+- 分卷大纲
+
+## 第三步：写出第一章（2分钟）
+
+```
+/novel-maker write 写第一章，主角在宗门被欺负
+```
+
+AI 会自动：
+1. 生成 3 个版本的开篇 50 字（黄金开篇）
+2. 选择后生成完整章节（2500-3500字）
+3. 自动审查质量（AI味检测、一致性检查）
+4. 检查字数是否达标
+
+## 第四步：继续写作
+
+```
+/novel-maker write 继续写，主角遇到了敌人
+```
+
+### 日常写作循环
+
+```
+/novel-maker write 继续写
+  ↓ AI自动: 写作 → 审查 → 字数检查 → 更新大纲/记忆
+满意 → 继续
+不满意 → /novel-maker review fix 帮我改一下
+字数不足 → /novel-maker expand 扩充本章
+写完当前幕 → /novel-maker act 下一幕怎么走
+```
+
+## 下一步
+
+- 查看 [示例项目](examples.md) 了解完整创作流程
+- 阅读 [完整功能说明](../SKILL.md) 了解更多高级功能
+- 遇到问题？查看 [常见问题](faq.md)

package/skill/genre-packs/README.md

@@ -0,0 +1,47 @@
+# 题材包系统
+
+> 为不同题材提供专门的写作规则、模板和设定参考
+
+## 使用方式
+
+初始化小说项目时，选择题材会自动加载对应的题材包：
+
+```
+/novel-maker init 开始写一本修仙小说
+```
+
+## 可用题材包
+
+| 题材包 | 说明 | 特定内容 |
+|--------|------|----------|
+| xianxia | 修仙 | 境界体系、宗门设定、秘境模板、渡劫规则 |
+| urban | 都市 | 商战模板、复仇套路、崛起路径、感情线 |
+| infinite-flow | 无限流 | 副本设计、强化体系、团队配置、BOSS战 |
+| mystery | 悬疑 | 案件设计、推理线索、反转技巧、伏笔布局 |
+| history | 历史 | 权谋模板、战役描写、改革路线、朝堂设定 |
+| sci-fi | 科幻 | 科技体系、星际设定、AI描写、时间线管理 |
+| game | 游戏 | 游戏系统、等级体系、装备设计、副本攻略 |
+| apocalypse | 末世 | 生存体系、异能设定、势力分布、资源管理 |
+| western-fantasy | 西幻 | 魔法体系、种族设定、骑士精神、王国政治 |
+| wuxia | 武侠 | 武功体系、江湖规矩、侠义精神、门派纷争 |
+| romance | 言情 | 感情线设计、人物关系、情感冲突、甜蜜互动 |
+
+## 题材包内容
+
+每个题材包包含：
+
+- `rules.md` - 该题材的写作规则和禁忌
+- `templates.md` - 该题材特有的模板（角色、场景、力量体系）
+- `arc-types.md` - 该题材常用的弧线类型
+- `settings.md` - 该题材的常见设定参考
+
+## 与现有系统集成
+
+- 初始化时选择题材，自动加载对应题材包
+- 题材包中的规则补充 `genre-rules.md` 中的通用规则
+- 角色创建时参考题材包中的设定模板
+- 幕规划时参考题材包中的弧线类型
+
+## 扩展题材包
+
+如需添加新题材包，创建对应目录并包含上述四个文件即可。

package/skill/genre-packs/_default/arc-types.md

@@ -0,0 +1,153 @@
+# 通用弧线类型
+
+> 适用于所有题材的基础弧线类型
+
+## 挑战弧
+
+**结构：** 准备→挑战→失败→成长→再战→胜利
+
+**适用场景：**
+- 升级突破
+- 对抗强敌
+- 完成任务
+
+**阶段说明：**
+1. **准备**（2-3章）：展示挑战的重要性，主角准备/训练
+2. **挑战**（1-2章）：遭遇挑战，暴露不足
+3. **失败**（1章）：失败或撤退，遭受挫折
+4. **成长**（2-3章）：反思失败，寻找提升方法
+5. **再战**（2-3章）：重新挑战，展示成长
+6. **胜利**（1章）：最终胜利，获得奖励
+
+**情绪曲线：**
+- 准备：期待→紧张
+- 挑战：紧张→激烈
+- 失败：挫败→低落
+- 成长：希望→坚定
+- 再战：紧张→激烈
+- 胜利：爽快→满足
+
+---
+
+## 探索弧
+
+**结构：** 发现→探索→危险→收获→揭秘
+
+**适用场景：**
+- 秘境探险
+- 副本挑战
+- 寻找宝物
+
+**阶段说明：**
+1. **发现**（1-2章）：发现新地点或线索
+2. **探索**（2-3章）：深入探索，收集信息
+3. **危险**（1-2章）：遭遇危险或陷阱
+4. **收获**（1章）：获得宝物或关键信息
+5. **揭秘**（1章）：揭示更大的秘密
+
+**情绪曲线：**
+- 发现：好奇→期待
+- 探索：兴奋→紧张
+- 危险：恐惧→紧张
+- 收获：惊喜→满足
+- 揭秘：震撼→期待
+
+---
+
+## 冲突弧
+
+**结构：** 摩擦→升级→对决→后果→新平衡
+
+**适用场景：**
+- 势力对抗
+- 理念冲突
+- 资源争夺
+
+**阶段说明：**
+1. **摩擦**（2-3章）：小规模冲突，积累矛盾
+2. **升级**（2-3章）：冲突升级，双方加码
+3. **对决**（2-3章）：正面交锋
+4. **后果**（1-2章）：处理对决的后果
+5. **新平衡**（1章）：建立新的秩序
+
+**情绪曲线：**
+- 摩擦：不满→愤怒
+- 升级：紧张→激烈
+- 对决：高潮→爆发
+- 后果：反思→调整
+- 新平衡：接受→期待
+
+---
+
+## 悬疑弧
+
+**结构：** 线索→调查→误导→真相→反转
+
+**适用场景：**
+- 谜题破解
+- 阴谋揭露
+- 真相追寻
+
+**阶段说明：**
+1. **线索**（1-2章）：发现异常或线索
+2. **调查**（2-3章）：深入调查，收集证据
+3. **误导**（1-2章）：出现误导性信息
+4. **真相**（1章）：揭示真相
+5. **反转**（1章）：出人意料的反转
+
+**情绪曲线：**
+- 线索：好奇→困惑
+- 调查：专注→紧张
+- 误导：困惑→怀疑
+- 真相：震惊→恍然
+- 反转：震撼→深思
+
+---
+
+## 成长弧
+
+**结构：** 困境→学习→实践→突破→蜕变
+
+**适用场景：**
+- 角色成长
+- 能力提升
+- 心态转变
+
+**阶段说明：**
+1. **困境**（2-3章）：遭遇困境，暴露不足
+2. **学习**（2-3章）：寻找方法，开始学习
+3. **实践**（2-3章）：实际应用，积累经验
+4. **突破**（1-2章）：关键突破
+5. **蜕变**（1章）：完成蜕变，获得成长
+
+**情绪曲线：**
+- 困境：挫败→低落
+- 学习：希望→专注
+- 实践：紧张→坚定
+- 突破：激动→爽快
+- 蜕变：满足→期待
+
+---
+
+## 关系弧
+
+**结构：** 相遇→冲突→理解→和解→深化
+
+**适用场景：**
+- 人际关系发展
+- 感情线推进
+- 阵营转变
+
+**阶段说明：**
+1. **相遇**（1-2章）：初次相遇，第一印象
+2. **冲突**（2-3章）：产生矛盾或误解
+3. **理解**（2-3章）：逐渐理解对方
+4. **和解**（1-2章）：化解矛盾
+5. **深化**（1章）：关系更进一步
+
+**情绪曲线：**
+- 相遇：好奇→中立
+- 冲突：对立→不满
+- 理解：同情→认同
+- 和解：释然→温暖
+- 深化：信任→期待