novelws 1.2.0

package/templates/knowledge/world-setting.md

@@ -0,0 +1,121 @@
+# 世界观设定
+
+## 基础设定
+
+### 时代背景
+[描述故事发生的时代，如：现代都市/古代王朝/未来世界/异世界等]
+
+**年代**：
+**历史阶段**：
+**科技水平**：
+**文明程度**：
+
+### 地理环境
+[描述主要地点和环境]
+
+**主要地域**：
+- 地点1：[名称] - [描述]
+- 地点2：[名称] - [描述]
+- 地点3：[名称] - [描述]
+
+**地理特征**：
+- 气候：
+- 地形：
+- 自然资源：
+
+### 社会结构
+[描述社会组织形式]
+
+**政治体系**：
+**经济形态**：
+**社会阶层**：
+**文化特点**：
+
+## 特殊规则
+
+### 核心设定
+[世界的核心运行规则]
+
+**基本法则**：
+1.
+2.
+3.
+
+### 魔法/科技体系
+[如有特殊体系，在此描述]
+
+**能量来源**：
+**使用方式**：
+**威力等级**：
+**学习途径**：
+
+### 限制与代价
+[描述世界的限制规则]
+
+**绝对禁忌**：
+**力量代价**：
+**平衡机制**：
+
+## 势力组织
+
+### 主要势力
+[描述世界中的主要组织和势力]
+
+#### [势力名称]
+- **性质**：
+- **宗旨**：
+- **规模**：
+- **影响力**：
+- **重要人物**：
+
+## 历史背景
+
+### 重要历史事件
+[影响当前世界的历史事件]
+
+1. **[事件名]** - [时间]
+   - 起因：
+   - 经过：
+   - 结果：
+   - 影响：
+
+## 文化风俗
+
+### 日常生活
+- **衣食住行**：
+- **社交礼仪**：
+- **节日庆典**：
+- **宗教信仰**：
+
+### 语言文字
+- **主要语言**：
+- **文字系统**：
+- **特殊用语**：
+
+## 经济体系
+
+### 货币制度
+- **货币单位**：
+- **购买力参考**：
+
+### 主要产业
+- **农业**：
+- **工业**：
+- **商业**：
+- **服务业**：
+
+## 设定备注
+
+### 灵感来源
+[记录世界观的灵感来源]
+
+### 参考资料
+[相关的参考书籍、影视、游戏等]
+
+### 注意事项
+[创作时需要特别注意的设定细节]
+
+---
+*创建时间：[日期]*
+*最后更新：[日期]*
+*版本：1.0*

package/templates/knowledge-base/README.md

@@ -0,0 +1,285 @@
+# 写作知识库系统
+
+## 概述
+
+这是 Novel Writer Skills 的核心竞争力 - 一个可扩展的通用写作知识库系统。
+
+**与项目特定知识的区别**：
+- `spec/knowledge/` - 存放项目特定知识（角色档案、地点、世界观等）
+- `templates/knowledge-base/`（本目录）- 存放通用写作知识（类型惯例、技法、参考资料）
+
+**工作原理**：
+1. **自动激活**：setting-detector Skill根据关键词映射表自动检测故事设定
+2. **按需加载**：只加载相关的知识库，节省token（单个知识库~500 tokens）
+3. **持续应用**：知识库在整个创作过程中保持激活
+
+**Token效率**：
+- 传统方案（50个Skill）：~2000 tokens
+- 当前方案（1个detector + 按需知识库）：~600 tokens
+- **节省75%**
+
+---
+
+## 📚 知识库索引
+
+### 1. 类型知识库（Genres）
+
+专业类型小说的创作惯例和最佳实践。
+
+| 文件 | 类型 | 关键惯例 |
+|------|------|---------|
+| `genres/romance.md` | 言情小说 | HEA结局、情感节奏点、关系弧 |
+| `genres/mystery.md` | 悬疑推理 | 公平游戏、线索管理、嫌疑人设计 |
+| `genres/historical.md` | 历史小说 | 考据平衡、时代氛围、历史白描 |
+| `genres/revenge.md` | 复仇爽文 | 节奏控制、打脸设计、情绪管理 |
+| `genres/wuxia.md` | 武侠小说 | 江湖规则、武学体系、侠义精神 |
+
+### 2. 写作技法知识库（Craft）
+
+跨类型适用的专业写作技巧。
+
+| 文件 | 技法 | 核心原则 |
+|------|------|---------|
+| `craft/dialogue.md` | 对话技巧 | 潜台词、角色声音、自然感 |
+| `craft/scene-structure.md` | 场景结构 | 目标-冲突-灾难、续场模型 |
+| `craft/character-arc.md` | 角色弧线 | 改变机制、内外冲突、成长逻辑 |
+| `craft/pacing.md` | 节奏控制 | 张弛有度、高潮设计、过渡管理 |
+| `craft/show-not-tell.md` | 展示技巧 | 感官细节、行为暗示、避免说教 |
+
+### 3. 参考资料库（References）
+
+特定时代、文化、背景的真实资料。
+
+| 目录 | 内容 | 用途 |
+|------|------|------|
+| `references/china-1920s/` | 1920年代中国 | 军阀混战、社会风貌、日常生活 |
+| └─ `overview.md` | 时代概览 | 历史事件、社会分层、城乡对比 |
+| └─ `warlords.md` | 军阀体系 | 派系关系、军队编制、权力结构 |
+| └─ `society.md` | 社会结构 | 阶层分化、家族制度、婚姻制度 |
+| └─ `daily-life.md` | 日常生活 | 衣食住行、货币物价、娱乐文化 |
+| └─ `culture.md` | 文化娱乐 | 新文化运动、文学流派、女性解放 |
+
+**未来扩展**：
+- `references/tang-dynasty/` - 唐朝（仙侠、宫斗题材）
+- `references/modern-workplace/` - 现代职场
+- `references/cultivation-world/` - 修仙世界
+- ...（可无限扩展）
+
+---
+
+## 🔍 关键词映射表
+
+**用途**：供 `setting-detector` Skill 使用，根据用户输入的关键词自动激活对应知识库。
+
+### 类型知识库关键词
+
+```yaml
+romance:
+  keywords: [言情, 爱情, 恋爱, 浪漫, 感情线, 关系弧, CP, 甜文, 虐文]
+  auto_load: genres/romance.md
+
+mystery:
+  keywords: [悬疑, 推理, 侦探, 破案, 谜团, 线索, 真相, 凶手, 犯罪]
+  auto_load: genres/mystery.md
+
+historical:
+  keywords: [历史, 古代, 朝代, 考据, 时代背景, 历史小说]
+  auto_load: genres/historical.md
+
+revenge:
+  keywords: [复仇, 报仇, 打脸, 爽文, 逆袭, 反击]
+  auto_load: genres/revenge.md
+
+wuxia:
+  keywords: [武侠, 江湖, 武功, 侠客, 门派, 武学, 剑客]
+  auto_load: genres/wuxia.md
+```
+
+### 写作技法关键词
+
+```yaml
+dialogue:
+  triggers: [对话, 角色说话, 台词, 交流场景, 谈话]
+  auto_load: craft/dialogue.md
+
+scene-structure:
+  triggers: [场景, 章节结构, 情节推进, 场景设计]
+  auto_load: craft/scene-structure.md
+
+character-arc:
+  triggers: [角色成长, 人物弧线, 角色改变, 性格转变]
+  auto_load: craft/character-arc.md
+
+pacing:
+  triggers: [节奏, 快慢, 拖沓, 高潮, 张力]
+  auto_load: craft/pacing.md
+
+show-not-tell:
+  triggers: [展示, 具象化, 说教, 感官细节, 描写]
+  auto_load: craft/show-not-tell.md
+```
+
+### 参考资料关键词
+
+```yaml
+china-1920s:
+  keywords: [1920, 民国, 军阀, 北洋, 穿越民国, 二十年代, 上海滩, 十里洋场]
+  auto_load:
+    - references/china-1920s/overview.md
+    - references/china-1920s/warlords.md
+    - references/china-1920s/society.md
+    - references/china-1920s/daily-life.md
+    - references/china-1920s/culture.md
+```
+
+---
+
+## 🛠️ 使用指南
+
+### 自动激活流程
+
+1. **用户提到关键词**：
+   ```
+   用户："我要写一部1920年代的言情复仇小说"
+   ```
+
+2. **setting-detector 检测**：
+   - 检测到 "1920" → 激活 `references/china-1920s/`
+   - 检测到 "言情" → 激活 `genres/romance.md`
+   - 检测到 "复仇" → 激活 `genres/revenge.md`
+
+3. **按需加载**：
+   ```
+   ✓ 已加载 genres/romance.md (520 tokens)
+   ✓ 已加载 genres/revenge.md (480 tokens)
+   ✓ 已加载 references/china-1920s/*.md (650 tokens)
+
+   总计：~1650 tokens（仅加载相关知识）
+   ```
+
+4. **持续应用**：
+   - 在 `/specify` 时：建议关键元素
+   - 在 `/plan` 时：提供结构框架
+   - 在 `/write` 时：实时写作建议
+   - 在 `/analyze` 时：类型惯例检查
+
+### 手动指定加载
+
+如果自动检测失败，用户可以明确指定：
+
+```
+"请加载 romance 和 mystery 知识库"
+"这个故事需要 1920s 中国参考资料"
+```
+
+### 查看当前激活的知识库
+
+用户可随时询问：
+```
+"当前激活了哪些知识库？"
+```
+
+AI会回复：
+```
+📚 当前激活的知识库：
+✓ genres/romance.md - 言情小说惯例
+✓ genres/revenge.md - 复仇爽文技巧
+✓ references/china-1920s/ - 1920年代中国资料
+```
+
+---
+
+## 📦 知识库扩展
+
+### 添加新知识库
+
+1. **确定类别**：genres / craft / references
+
+2. **创建文件**：
+   ```bash
+   # 类型知识
+   touch templates/knowledge-base/genres/sci-fi.md
+
+   # 写作技法
+   touch templates/knowledge-base/craft/worldbuilding.md
+
+   # 参考资料
+   mkdir -p templates/knowledge-base/references/ancient-rome
+   touch templates/knowledge-base/references/ancient-rome/military.md
+   ```
+
+3. **更新映射表**：在本 README 的关键词映射表中添加对应条目
+
+4. **编写内容**：参考现有知识库的格式（500-800行）
+
+### 知识库格式规范
+
+每个知识库文件应包含：
+
+```markdown
+# [知识库标题]
+
+## 快速参考（Quick Reference）
+[1-3段概述，说明核心原则]
+
+## 核心原则（Core Principles）
+[3-5个关键法则，带详细解释]
+
+## 实践应用（Practical Application）
+[如何在各个创作阶段应用这些知识]
+
+## 常见陷阱（Common Pitfalls）
+[类型新人常犯的错误及避免方法]
+
+## 示例分析（Examples）
+[经典作品案例分析]
+
+## 与Commands的集成（Integration with Commands）
+[在/specify, /plan, /write, /analyze中如何应用]
+```
+
+### 从经典小说提取知识库
+
+未来可以解构经典小说，提取为知识库：
+
+```bash
+# 示例：从《三体》提取硬科幻知识
+templates/knowledge-base/genres/hard-sci-fi.md
+
+# 从《红楼梦》提取家族叙事知识
+templates/knowledge-base/craft/family-saga.md
+```
+
+---
+
+## 📊 知识库状态
+
+**当前状态**：初始版本
+
+| 类别 | 已完成 | 计划中 | 总计 |
+|------|--------|--------|------|
+| 类型知识 | 5 | 10+ | 15+ |
+| 写作技法 | 5 | 8+ | 13+ |
+| 参考资料 | 1 | 20+ | 21+ |
+
+**下一步扩展计划**：
+- [ ] 奇幻小说（fantasy）
+- [ ] 科幻小说（sci-fi）
+- [ ] 恐怖小说（horror）
+- [ ] 世界构建技法（worldbuilding）
+- [ ] 古代中国各朝代参考资料
+- [ ] 现代都市参考资料
+
+---
+
+## 🔗 相关文档
+
+- **Skills指南**：`docs/guides/skills-guide.md` - 了解 setting-detector Skill 如何使用本知识库
+- **插件开发**：`docs/plugin-development.md` - 如何开发知识库插件
+- **命令详解**：`docs/guides/commands.md` - 知识库如何增强各个命令
+
+---
+
+**知识库系统 = Novel Writer Skills 的长期竞争力**
+
+让专业知识为你的创作保驾护航！ ✨📚

package/templates/knowledge-base/character-archetypes/01-hero.md

@@ -0,0 +1,233 @@
+# Hero (英雄原型)
+
+## 核心定义
+
+**英雄** = 踏上旅程、面对考验、获得成长的主角。
+
+英雄是故事的核心驱动力。读者通过英雄的眼睛看世界，通过英雄的选择理解主题，通过英雄的成长获得情感满足。英雄不等于"勇敢的人"——英雄的本质是**变化**：从不完整到完整，从无知到觉醒，从软弱到坚强（或反过来）。
+
+**关键区分：**
+- **英雄 vs 主角：** 主角是叙事焦点，英雄是经历成长弧线的角色。两者通常重合，但不总是
+- **英雄 vs 战士：** 战士靠武力，英雄靠选择。真正定义英雄的不是力量，而是在关键时刻做出的决定
+- **英雄 vs 好人：** 英雄可以自私、懦弱、道德模糊——只要他们经历了有意义的转变
+
+---
+
+## 核心特征
+
+### 1. 不完整性
+
+故事开始时，英雄有缺陷或不足——这是成长的前提：
+
+- **技能不足：** 缺乏完成使命所需的能力（弗罗多不会战斗）
+- **心理创伤：** 过去的伤痛限制了行动（蝙蝠侠的父母之死）
+- **错误信念：** 对世界或自己有根本性的误解（傲慢、偏见、恐惧）
+
+不完整性越具体、越真实，读者越容易产生共鸣。"他很弱"不如"他因为童年溺水事件而恐惧一切与水有关的东西"。
+
+### 2. 召唤
+
+被推入或选择踏上旅程：
+
+- **被动召唤：** 外部事件打破平静（家园被毁、亲人被害、世界危机）
+- **主动选择：** 内心渴望驱动行动（追求梦想、寻找真相、证明自己）
+- **拒绝与接受：** 大多数英雄最初会拒绝召唤——恐惧、怀疑、不愿离开舒适区。拒绝的过程让最终的接受更有力量
+
+### 3. 成长
+
+通过考验和选择，获得转变：
+
+- **技能提升：** 学会新能力，掌握新武器
+- **心理成熟：** 克服恐惧，面对创伤，接受责任
+- **信念修正：** 放弃错误信念，建立新的世界观
+
+成长不是线性的。最好的英雄弧线包含退步、怀疑和挣扎——两步前进一步后退，才是真实的成长节奏。
+
+### 4. 牺牲
+
+为更大的善，愿意付出代价：
+
+- **舒适牺牲：** 离开安全的家园和熟悉的生活
+- **欲望牺牲：** 放弃个人渴望（爱情、权力、安逸）
+- **终极牺牲：** 愿意付出生命的代价
+
+牺牲的关键是**自愿性**——英雄必须有选择不牺牲的可能，但他们选择了牺牲。被迫的牺牲不是英雄行为，是受害。
+
+---
+
+## 故事功能
+
+- **视角提供者：** 读者通过英雄的眼睛看世界，英雄的认知边界就是读者的认知边界
+- **成长示范：** 展示如何面对恐惧、克服困难、做出艰难选择
+- **价值传达：** 英雄的选择体现故事的核心主题——他选择牺牲，故事就在讲牺牲的价值
+- **情感锚点：** 读者的情感投入集中在英雄身上，英雄的胜利是读者的胜利，英雄的痛苦是读者的痛苦
+
+---
+
+## 典型弧线
+
+### 经典英雄之旅（坎贝尔/沃格勒十二阶段）
+
+```
+1. 平凡世界（普通生活）
+   ↓
+2. 召唤（冒险开始）
+   ↓
+3. 拒绝召唤（恐惧/怀疑）
+   ↓
+4. 遇见导师（获得指导）
+   ↓
+5. 跨越第一道门槛（进入新世界）
+   ↓
+6. 试炼、盟友、敌人（考验）
+   ↓
+7. 深入洞穴（面对最深恐惧）
+   ↓
+8. 磨难（危机/死亡与重生）
+   ↓
+9. 奖赏（获得宝剑/知识）
+   ↓
+10. 返回之路（回归旧世界）
+    ↓
+11. 复活（最终考验）
+    ↓
+12. 带着灵药回归（成长完成）
+```
+
+这个结构不是公式，而是地图。好的故事可以跳过某些阶段、重新排列顺序、或在某个阶段停留更久。关键是理解每个阶段的**功能**，而不是机械套用。
+
+---
+
+## 示例分析
+
+### 正面示例
+
+**弗罗多（《魔戒》）**
+- **不完整性：** 平凡的霍比特人，没有战斗力，没有魔法，甚至没有冒险的欲望
+- **召唤：** 继承魔戒——不是他选择的命运，而是命运选择了他
+- **成长：** 从天真的乡下人到承受世界重担的戒指持有者。他的成长不是变强，而是学会在绝望中坚持
+- **牺牲：** 愿意牺牲自己的生命和心智来摧毁魔戒。最终他失败了（在末日山被魔戒控制），但他之前的善行（饶恕咕噜）间接完成了使命
+- **为什么有效：** 弗罗多证明了英雄不需要强大，需要的是坚韧和善良
+
+**哈利·波特**
+- **不完整性：** 孤儿，不了解魔法世界，在姨妈家受虐待
+- **召唤：** 霍格沃茨录取信——从被忽视的孩子到"大难不死的男孩"
+- **成长：** 从被动接受命运到主动对抗伏地魔，从依赖他人到独立承担
+- **牺牲：** 第七部中走向死亡，愿意为朋友和世界牺牲自己
+- **为什么有效：** 哈利的力量不是魔法，而是爱和友谊——这让普通读者也能产生共鸣
+
+### 反面示例（扭曲的英雄）
+
+**安纳金·天行者（《星球大战》前传）**
+- 拥有英雄的一切条件：天赋、导师、使命
+- 但英雄弧线失败：恐惧战胜了勇气，执念战胜了放手
+- 选择黑暗面不是因为邪恶，而是因为爱（害怕失去帕德梅）
+- **为什么有效：** 展示了英雄也可能堕落，而堕落的原因往往是人性中最可理解的部分
+
+---
+
+## 常见错误
+
+- ❌ **完美英雄：** 没有缺陷，从一开始就无所不能。没有成长空间，读者无法产生共鸣。超人之所以需要氪石，就是因为无敌的英雄没有故事
+- ❌ **被动英雄：** 只被事件推动，从不主动做出选择。英雄的定义是选择，不是遭遇。如果去掉英雄，故事照样发生，那这个英雄就是多余的
+- ❌ **无牺牲英雄：** 轻松获得一切，没有代价。没有牺牲就没有张力，读者不会为不需要付出的胜利感到激动
+- ❌ **无弧线英雄：** 从头到尾没有变化。故事结束时和开始时一模一样的角色不是英雄，是道具
+
+---
+
+## 独特化建议
+
+### 超越原型的方法
+
+1. **特殊背景：** 独特的文化、职业或经历
+   - 不是农家少年，是落魄贵族；不是孤儿，是被放逐的王子
+   - 背景决定了英雄看世界的方式，也决定了他的盲点
+
+2. **独特缺陷：** 非典型的"不完整性"
+   - 不是缺乏勇气，是过于鲁莽；不是软弱，是过度自信
+   - 最好的缺陷是优点的反面——聪明的人容易傲慢，勇敢的人容易冲动
+
+3. **特殊动机：** 不同的"召唤"原因
+   - 不是拯救世界，是为了个人复仇；不是正义，是为了赎罪
+   - 自私的动机比高尚的动机更有趣，因为它们更真实
+
+4. **非典型弧线：** 颠覆传统成长路径
+   - 不是从弱到强，是从强大到接受软弱
+   - 不是获得力量，是学会放弃力量
+
+5. **个性化细节：** 怪癖、习惯、说话方式
+   - 总是带着祖母的遗物，紧张时会数数，用食物比喻一切
+   - 细节让原型变成人物
+
+---
+
+## 与其他原型的关系
+
+- **需要 Mentor：** 导师提供指导和工具，帮助英雄准备面对考验
+- **对抗 Shadow：** 阴影是英雄的主要对手，也是英雄黑暗面的镜像
+- **伴随 Ally：** 盟友提供支持、互补能力和情感陪伴
+- **被 Herald 召唤：** 信使带来打破现状的消息，开启英雄旅程
+- **被 Threshold Guardian 考验：** 守门人测试英雄是否准备好进入下一阶段
+
+---
+
+## 写作提示
+
+### 设计英雄时问自己
+
+1. **他的不完整性是什么？** 缺陷、创伤还是错误信念？这个不完整性如何限制他的行动？
+2. **什么召唤他踏上旅程？** 外部事件还是内部渴望？他为什么不能拒绝？
+3. **他最大的恐惧是什么？** 这个恐惧如何与故事的核心冲突相关？
+4. **他愿意为什么牺牲？** 牺牲的代价是否足够大？读者是否能感受到这个代价？
+5. **故事结束时他将如何不同？** 他的信念、能力、关系发生了什么变化？
+
+### 检查清单
+
+- [ ] 英雄有明确的缺陷或不足
+- [ ] 召唤足够强烈（不能轻易拒绝）
+- [ ] 有清晰的成长弧线（开始和结束时不同）
+- [ ] 面临真正的选择（不只是被推动）
+- [ ] 有牺牲或代价（胜利不是免费的）
+
+---
+
+## 变体
+
+### 反英雄 (Anti-Hero)
+
+英雄的扭曲版本——缺乏传统美德（自私、懦弱、道德模糊），但仍完成"英雄旅程"。反英雄的魅力在于真实：大多数人不是圣人，反英雄让读者看到不完美的人也能做出有意义的事。
+
+- **示例：** 沃尔特·怀特（《绝命毒师》）——从普通人到毒枭的堕落弧线
+- **示例：** 韩·索罗——自私的走私客最终选择为正义而战
+
+### 悲剧英雄
+
+英雄的失败版本——因致命缺陷（hubris、执念、盲目）而走向毁灭。悲剧英雄让读者思考：如果英雄做了不同的选择，结局会怎样？
+
+- **示例：** 麦克白——野心吞噬了一切
+- **示例：** 盖茨比——对过去的执念导致毁灭
+
+### 勉强英雄 (Reluctant Hero)
+
+不愿意但被迫成为英雄——拒绝召唤更强烈，接受使命更痛苦。勉强英雄的力量在于，他们的每一步都是艰难的选择，而不是天命所归。
+
+- **示例：** 比尔博·巴金斯——只想待在家里喝茶的霍比特人
+- **示例：** 凯特尼斯——被迫参加饥饿游戏，从不想当领袖
+
+---
+
+## 文化变体
+
+### 中国式英雄
+
+- **集体优先：** 强调为家族、国家、天下而战，而非个人成长
+- **忠孝为本：** 英雄的动机常与孝道和忠义相关
+- **修炼传统：** 通过修炼（武功、心性）获得力量，强调自律和坚持
+- **示例：** 花木兰——为父从军，集体荣誉高于个人身份
+
+### 日本式英雄
+
+- **修行与自律：** 强调通过严格训练和自我克制获得力量
+- **师承关系：** 师父的传承是英雄力量的重要来源
+- **物哀美学：** 英雄的旅程常带有悲剧色彩，美在于无常
+- **示例：** 宫本武藏——剑道修行者，追求"剑与禅"的统一