novelws 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -5,6 +5,63 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2026-02-15
+
+### Added
+
+#### Phase 1: 创作质量核心 - AI 去味智能化
+
+- **writing-balance Skill** - 6 维度写作平衡评分系统
+  - 句长分布、词汇丰富度、描写层次、成语使用、句式变化、自然度
+  - 从"禁止列表"转向"智能平衡"，保留创作自由度
+  - 量化评分 + 改进建议，替代一刀切禁用
+- **writing-techniques Skill** - 8 模块写作技巧教学
+  - 标点艺术、句式变化、描写手法、对话真实化、节奏控制、留白艺术、词汇丰富化、AI 模式规避
+- **anti-ai-v5-balanced 规则** - 平衡版去 AI 规范，替代旧版 anti-ai-v4
+- **`/write` 命令集成** - 写作时自动调用 writing-balance 评分
+
+#### Phase 2: 用户体验提升
+
+- **`/help-me` 命令** - 自然语言命令发现
+  - 50+ 场景映射，用自然语言描述需求即可找到最佳命令
+  - 支持模糊匹配和多关键词组合
+- **`/guide` 命令增强** - 上下文感知推荐引擎
+  - 基于项目当前状态智能推荐，提升推荐精准度
+- **统一错误处理框架** - 4 个新错误类
+  - `CommandNotFoundError`、`InvalidArgumentError`、`ProjectStateError`、`TrackingDataError`
+  - 每个错误附带修复建议和相关命令提示
+- **诊断系统** - `ProjectDiagnostics` 类
+  - 5 项自动检查：项目结构、tracking 文件、项目模式、MCP 状态、文件完整性
+  - 自动生成修复命令建议
+
+#### Phase 3: 功能扩展与优化
+
+- **5 个新 genre 知识库**
+  - `horror.md` - 恐怖（氛围营造、恐惧递进、心理恐怖）
+  - `youth.md` - 青春（校园、成长、青涩情感）
+  - `military.md` - 军事（战争、军旅、战术谋略）
+  - `sports.md` - 竞技（体育、比赛、热血成长）
+  - `workplace.md` - 职场（商战、职场博弈、行业深耕）
+- **AI 模型智能选择** - 8 个命令模板添加 `recommended-model` 字段
+  - opus：深度分析任务（analyze --type=framework、plan、revise）
+  - sonnet：平衡任务（write、track --check、character）
+  - haiku：速度优先（track --sync、search、help-me）
+
+### Changed
+
+- **anti-ai 规则升级** - v4 禁止列表 → v5 智能平衡评分
+- **`/track` 命令 Token 优化** - 1,080 行 → 704 行（精简 35%），保留所有核心功能
+
+### Technical
+
+- **测试增长** - 275 → 312 个测试（+37 个）
+- **测试结果** - 312 个测试全部通过，21 个 test suites，零回归
+- **新增 Skills** - writing-balance、writing-techniques（共 2 个）
+- **新增命令** - `/help-me`（共 1 个）
+- **新增 genre** - horror、youth、military、sports、workplace（共 5 个）
+
+---
+
 ## [3.0.0] - 2026-02-14
 
 ### Added

package/README.md

@@ -10,18 +10,28 @@
 
 ## 核心特性
 
-- **17 个 Slash Commands** - 七步方法论 + 角色管理 + 智能引导 + 追踪验证
-- **37 个 Agent Skills** - AI 自动激活的知识库、写作技巧、质量检查和专项分析
-- **超长篇小说支持（NEW v3.0）** - 支持 300+ 章节超长篇创作
+- **18 个 Slash Commands** - 七步方法论 + 角色管理 + 智能引导 + 命令发现 + 追踪验证
+- **39 个 Agent Skills** - AI 自动激活的知识库、写作技巧、质量检查和专项分析
+- **AI 去味智能化（NEW v3.1）** - 从"禁止列表"转向"智能平衡"
+  - **writing-balance Skill**：6 维度评分系统（句长分布、词汇丰富度、描写层次、成语使用、句式变化、自然度）
+  - **writing-techniques Skill**：8 模块写作技巧教学
+  - **anti-ai-v5-balanced**：平衡版去 AI 规则，替代旧版禁止列表
+- **用户体验提升（NEW v3.1）**
+  - **`/help-me` 命令**：自然语言命令发现（50+ 场景映射）
+  - **`/guide` 增强**：上下文感知推荐引擎
+  - **统一错误框架**：4 种错误类型 + 修复建议
+  - **诊断系统**：5 项自动检查 + 修复命令生成
+- **AI 模型智能选择（NEW v3.1）** - 每个命令标注推荐模型（opus/sonnet/haiku）
+- **超长篇小说支持（v3.0）** - 支持 300+ 章节超长篇创作
   - **三层数据架构**：MCP 服务器 + 分片 JSON + 单文件模式
   - **性能提升 100x-600x**：查询速度从秒级降至毫秒级
   - **智能分层**：根据项目规模自动选择最佳模式
   - **全文搜索**：FTS5 索引，500x 搜索加速
   - **卷级操作**：`/volume-summary`、`--volume vol-XX` 参数
   - **连贯性守护**：long-series-continuity Skill 自动监控
-- **8 大类型知识库** - 言情、悬疑、玄幻、都市、游戏文、重生、武侠、历史等
-- **网文深度优化** - 爽点管理、钩子设计、节奏控制、反 AI 检测
-- **Token 优化** - 三大核心命令精简 77%，典型会话 token 消耗降低 76%
+- **16 大类型知识库** - 言情、悬疑、玄幻、都市、游戏文、重生、武侠、历史、科幻、惊悚、恐怖、青春、军事、竞技、职场等
+- **网文深度优化** - 爽点管理、钩子设计、节奏控制、智能 AI 去味
+- **Token 优化** - 三大核心命令精简 77%，track 命令精简 35%，典型会话 token 消耗降低 76%
 - **智能资源加载** - 三层架构（推断 + 配置 + 关键词触发），按需加载
 - **批量操作** - 多章节分析、多卷规划、批量同步追踪数据
 - **命令链式提示** - 每个命令执行后自动推荐下一步操作
@@ -93,7 +103,8 @@ novelws init my-novel --plugins authentic-voice
 | 命令 | 功能 | 说明 |
 |------|------|------|
 | `/character` | 统一角色管理 | create / list / show / update / relate / voice / timeline |
-| `/guide` | 智能引导 | 三层优先级推荐引擎（P0/P1/P2），自动推荐唯一最佳下一步 + 备选操作 |
+| `/guide` | 智能引导 | 三层优先级推荐引擎（P0/P1/P2），上下文感知推荐，自动推荐唯一最佳下一步 + 备选操作 |
+| `/help-me` | 命令发现（NEW v3.1）| 自然语言描述需求，智能匹配最佳命令（50+ 场景映射） |
 
 ### 追踪与验证
 
@@ -150,7 +161,12 @@ novelws init my-novel --plugins authentic-voice
 | **Wuxia** | 武侠（江湖、武功、侠义） |
 | **Historical** | 历史（朝代、宫廷、考据） |
 | **Sci-fi** | 科幻（太空、未来、星际） |
-| **Thriller** | 惊悚（恐怖、悬念、紧张） |
+| **Thriller** | 惊悚（悬念、紧张、心理博弈） |
+| **Horror** | 恐怖（氛围营造、恐惧递进、心理恐怖）（NEW v3.1） |
+| **Youth** | 青春（校园、成长、青涩情感）（NEW v3.1） |
+| **Military** | 军事（战争、军旅、战术谋略）（NEW v3.1） |
+| **Sports** | 竞技（体育、比赛、热血成长）（NEW v3.1） |
+| **Workplace** | 职场（商战、职场博弈、行业深耕）（NEW v3.1） |
 
 ### 写作技巧（Writing Techniques）
 
@@ -162,6 +178,8 @@ novelws init my-novel --plugins authentic-voice
 | **Pacing Control** | 章内节奏检测、多章单调预警、满足间隔追踪 |
 | **Reader Expectation** | 期待自动识别、满足/颠覆节奏规划、情绪预测曲线 |
 | **Multi-Thread Narrative** | 多线叙事管理（视角切换、信息差追踪、叙事线交汇设计） |
+| **Writing Balance（NEW v3.1）** | 6 维度写作平衡评分（句长分布、词汇丰富度、描写层次、成语使用、句式变化、自然度） |
+| **Writing Techniques（NEW v3.1）** | 8 模块写作技巧教学（标点艺术、句式变化、描写手法、对话真实化、节奏控制、留白艺术、词汇丰富化、AI模式规避） |
 
 ### 写作工艺知识库（Craft Knowledge）
 
@@ -171,7 +189,7 @@ novelws init my-novel --plugins authentic-voice
 | **Power System** | 力量体系设计框架、战斗标准化、升级节奏 |
 | **Tension Management** | 紧张感管理（信息差、时间压力、两难抉择） |
 | **Story Structures** | 4 种网文结构模板（升级流/副本流/任务流/日常流） |
-| **Anti-AI v4** | 200+ 禁用词、7 层去 AI 规范、替换策略 |
+| **Anti-AI v5 Balanced（v3.1）** | 智能平衡版去 AI 规则，6 维度评分替代简单禁止列表 |
 | **Concretization** | 具象化写作检查清单、四维对照表、示例对比 |
 
 ### 智能检查（Quality Assurance）
@@ -292,10 +310,11 @@ AI: 🔍 检测到关键词触发：
 - **多章单调预警** - 检测连续章节的节奏模式是否重复
 - **节奏健康报告** - `/track --check` 生成节奏多样性、情绪曲线等指标
 
-### 反 AI 检测
+### 智能 AI 去味（v3.1 升级）
 
-- **200+ 禁用词黑名单** - 基于腾讯朱雀标准实测
-- **7 层去 AI 规范** - 禁用词、禁止句式、形容词限制、成语禁用、对话去 AI 化、段落结构、标点规范
+- **6 维度写作平衡评分** - 句长分布、词汇丰富度、描写层次、成语使用、句式变化、自然度
+- **智能平衡替代禁止列表** - 从"一刀切禁用"转向"评分引导"，保留创作自由度
+- **8 模块写作技巧教学** - 标点艺术、句式变化、描写手法、对话真实化等
 - **自然化写作原则** - 历史白描法、口语化处理、短句节奏、克制描写
 
 ### 网文结构模板
@@ -311,13 +330,14 @@ AI: 🔍 检测到关键词触发：
 
 ## Token 优化
 
-v2.1.0 对三大核心命令进行了深度 token 优化，大幅降低长篇写作的 API 成本：
+v2.1.0 对三大核心命令进行了深度 token 优化，v3.1.0 进一步优化 track 命令：
 
 | 命令 | 精简前 | 精简后 | 精简率 |
 |------|--------|--------|--------|
 | `/write` | 1,617 行 | 438 行 | 72.8% |
 | `/analyze` | 2,071 行 | 329 行 | 84.1% |
 | `/plan` | 1,286 行 | 380 行 | 70.5% |
+| `/track`（v3.1） | 1,080 行 | 704 行 | 35% |
 
 **典型会话**（`/write` ×5 + `/plan` ×1 + `/analyze` ×1）：~110,000 tokens → ~26,000 tokens（**节省 76%**）
 
@@ -328,6 +348,16 @@ v2.1.0 对三大核心命令进行了深度 token 优化，大幅降低长篇写
 - **会话级复用**：已加载的资源在同一对话中复用，不重复读取
 - **前文智能裁剪**：上一章 >1500 字时只保留最后 1000 字，配合 tracking 数据补充上下文
 
+## AI 模型智能选择（NEW in v3.1）
+
+v3.1.0 为每个命令标注了推荐模型，根据任务复杂度自动匹配最佳性价比：
+
+| 级别 | 模型 | 适用命令 |
+|------|------|---------|
+| **深度分析** | opus | `/analyze --type=framework`、`/plan`、`/revise` |
+| **平衡任务** | sonnet | `/write`、`/track --check`、`/character` |
+| **速度优先** | haiku | `/track --sync`、`/search`、`/help-me` |
+
 ## 命令链式提示
 
 每个命令执行完成后，自动推荐下一步操作：
@@ -341,7 +371,7 @@ v2.1.0 对三大核心命令进行了深度 token 优化，大幅降低长篇写
 3️⃣ /recap --brief — 快速回顾上下文（如需刷新记忆）
 ```
 
-所有 17 个命令均支持链式提示，形成完整的创作工作流图。
+所有 18 个命令均支持链式提示，形成完整的创作工作流图。
 
 ## 插件系统
 
@@ -369,8 +399,8 @@ novelws plugin:remove authentic-voice
 my-novel/
 ├── .claude/
 │   ├── CLAUDE.md          # 共享核心规范（自动缓存）
-│   ├── commands/          # Slash Commands (17 个)
-│   └── skills/            # Agent Skills (37 个)
+│   ├── commands/          # Slash Commands (18 个)
+│   └── skills/            # Agent Skills (39 个)
 │
 ├── .specify/              # Spec Kit 配置
 │   ├── memory/
@@ -427,10 +457,10 @@ my-novel/
 |------|-------------|-------------------|
 | **支持平台** | 13个AI工具（Claude、Cursor、Gemini等） | Claude Code 专用 |
 | **核心方法论** | 七步方法论 | 七步方法论 |
-| **Slash Commands** | 7 个跨平台命令 | 17 个 Claude 优化命令 |
-| **Agent Skills** | 不支持 | 37 个深度集成 |
+| **Slash Commands** | 7 个跨平台命令 | 18 个 Claude 优化命令 |
+| **Agent Skills** | 不支持 | 39 个深度集成 |
 | **智能检查** | 手动执行 | 自动监控 |
-| **类型知识库** | 需手动查阅 | 10 种类型自动激活 |
+| **类型知识库** | 需手动查阅 | 15 种类型自动激活 |
 | **网文优化** | 基础支持 | 深度优化（爽点/钩子/节奏/反AI） |
 | **批量操作** | 不支持 | 多章分析/多卷规划/批量同步 |
 | **适用场景** | 需要跨平台支持 | 追求最佳体验（Claude Code） |

package/dist/core/errors.d.ts

@@ -51,6 +51,22 @@ export declare class ConfigError extends NovelWriterError {
 export declare class PluginAlreadyInstalledError extends NovelWriterError {
     constructor(name: string);
 }
+/** 文件缺失错误（带修复建议） */
+export declare class MissingFileError extends NovelWriterError {
+    constructor(filePath: string, suggestion: string);
+}
+/** 模式不匹配错误 */
+export declare class ModeMismatchError extends NovelWriterError {
+    constructor(expectedMode: string, actualMode: string, action: string);
+}
+/** 数据完整性错误 */
+export declare class DataIntegrityError extends NovelWriterError {
+    constructor(issue: string, autoFixed: boolean);
+}
+/** 依赖缺失错误 */
+export declare class DependencyMissingError extends NovelWriterError {
+    constructor(dependency: string, installCmd: string);
+}
 /**
  * CLI 全局错误处理
  * 将 NovelWriterError 格式化为用户友好的输出，非预期错误输出堆栈

package/dist/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU;CAMhE;AAED,cAAc;AACd,qBAAa,oBAAqB,SAAQ,gBAAgB;gBAC5C,GAAG,CAAC,EAAE,MAAM;CAMzB;AAED,YAAY;AACZ,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,IAAI,EAAE,MAAM;CAGzB;AAED,YAAY;AACZ,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,IAAI,EAAE,MAAM;CAGzB;AAED,aAAa;AACb,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAEhB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAM,EAAO;CAKpE;AAED,aAAa;AACb,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAO1D;AAED,aAAa;AACb,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAU9D;AAED,YAAY;AACZ,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,OAAO,EAAE,MAAM;CAG5B;AAED,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOhD;AAED,YAAY;AACZ,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,IAAI,EAAE,MAAM;CAGzB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAyBjD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU;CAMhE;AAED,cAAc;AACd,qBAAa,oBAAqB,SAAQ,gBAAgB;gBAC5C,GAAG,CAAC,EAAE,MAAM;CAMzB;AAED,YAAY;AACZ,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,IAAI,EAAE,MAAM;CAGzB;AAED,YAAY;AACZ,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,IAAI,EAAE,MAAM;CAGzB;AAED,aAAa;AACb,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAEhB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAM,EAAO;CAKpE;AAED,aAAa;AACb,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAO1D;AAED,aAAa;AACb,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAU9D;AAED,YAAY;AACZ,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,OAAO,EAAE,MAAM;CAG5B;AAED,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOhD;AAED,YAAY;AACZ,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,IAAI,EAAE,MAAM;CAGzB;AAED,oBAAoB;AACpB,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAMjD;AAED,cAAc;AACd,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOrE;AAED,cAAc;AACd,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO;CAO9C;AAED,aAAa;AACb,qBAAa,sBAAuB,SAAQ,gBAAgB;gBAC9C,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAMnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAyBjD"}

package/dist/core/errors.js

@@ -94,6 +94,32 @@ export class PluginAlreadyInstalledError extends NovelWriterError {
         super(`插件 "${name}" 已安装。如需更新请使用 plugin:update`, 'PLUGIN_ALREADY_INSTALLED');
     }
 }
+/** 文件缺失错误（带修复建议） */
+export class MissingFileError extends NovelWriterError {
+    constructor(filePath, suggestion) {
+        super(`文件不存在: ${filePath}\n\n💡 修复建议: ${suggestion}`, 'MISSING_FILE');
+    }
+}
+/** 模式不匹配错误 */
+export class ModeMismatchError extends NovelWriterError {
+    constructor(expectedMode, actualMode, action) {
+        super(`模式不匹配: 当前项目使用 ${actualMode} 模式，但 ${action} 需要 ${expectedMode} 模式\n\n` +
+            `💡 修复建议: 运行 /track --migrate --target ${expectedMode}`, 'MODE_MISMATCH');
+    }
+}
+/** 数据完整性错误 */
+export class DataIntegrityError extends NovelWriterError {
+    constructor(issue, autoFixed) {
+        super(`数据完整性问题: ${issue}\n\n` +
+            (autoFixed ? '✅ 已自动修复' : '⚠️ 需要手动检查'), 'DATA_INTEGRITY');
+    }
+}
+/** 依赖缺失错误 */
+export class DependencyMissingError extends NovelWriterError {
+    constructor(dependency, installCmd) {
+        super(`缺少依赖: ${dependency}\n\n💡 安装方法: ${installCmd}`, 'DEPENDENCY_MISSING');
+    }
+}
 /**
  * CLI 全局错误处理
  * 将 NovelWriterError 格式化为用户友好的输出，非预期错误输出堆栈

package/dist/core/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/utils/diagnostics.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 项目诊断系统
+ *
+ * 命令失败时自动诊断并给出修复步骤。
+ * 5 项检查：项目结构、JSON 格式、项目模式、依赖状态、修复建议。
+ */
+/** 单项检查结果 */
+export interface CheckResult {
+    name: string;
+    passed: boolean;
+    message: string;
+    fix?: string;
+}
+/** 诊断报告 */
+export interface DiagnosticReport {
+    error: string;
+    checks: CheckResult[];
+    fixes: string[];
+    summary: string;
+}
+/** 命令上下文 */
+export interface CommandContext {
+    command: string;
+    projectRoot: string;
+    args?: string[];
+}
+/** 项目模式 */
+export type ProjectMode = 'single-file' | 'sharded' | 'mcp' | 'unknown';
+export declare class ProjectDiagnostics {
+    /**
+     * 对错误进行诊断，返回诊断报告
+     */
+    diagnoseError(error: Error, context: CommandContext): Promise<DiagnosticReport>;
+    /**
+     * 检查 1: 项目结构是否完整
+     */
+    checkProjectStructure(projectRoot: string): Promise<CheckResult>;
+    /**
+     * 检查 2: tracking 文件是否存在
+     */
+    checkTrackingFiles(projectRoot: string): Promise<CheckResult>;
+    /**
+     * 检查 3: 项目模式是否匹配
+     */
+    checkProjectMode(projectRoot: string): Promise<CheckResult>;
+    /**
+     * 检查 4: MCP 服务器状态
+     */
+    checkMCPStatus(projectRoot: string): Promise<CheckResult>;
+    /**
+     * 检查 5: JSON 文件完整性
+     */
+    checkFileIntegrity(projectRoot: string): Promise<CheckResult>;
+    /**
+     * 检测项目模式
+     */
+    detectProjectMode(projectRoot: string): Promise<ProjectMode>;
+    /**
+     * 格式化诊断报告为用户友好的字符串
+     */
+    formatReport(report: DiagnosticReport): string;
+    private generateSummary;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/utils/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,aAAa;AACb,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,WAAW;AACX,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AAExE,qBAAa,kBAAkB;IAC7B;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBrF;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2BtE;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsCnE;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBjE;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2B/D;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCnE;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBlE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAuB9C,OAAO,CAAC,eAAe;CAWxB"}

package/dist/utils/diagnostics.js

@@ -0,0 +1,226 @@
+/**
+ * 项目诊断系统
+ *
+ * 命令失败时自动诊断并给出修复步骤。
+ * 5 项检查：项目结构、JSON 格式、项目模式、依赖状态、修复建议。
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { getProjectPaths } from '../core/config.js';
+export class ProjectDiagnostics {
+    /**
+     * 对错误进行诊断，返回诊断报告
+     */
+    async diagnoseError(error, context) {
+        const checks = await Promise.all([
+            this.checkProjectStructure(context.projectRoot),
+            this.checkTrackingFiles(context.projectRoot),
+            this.checkProjectMode(context.projectRoot),
+            this.checkMCPStatus(context.projectRoot),
+            this.checkFileIntegrity(context.projectRoot),
+        ]);
+        const fixes = checks
+            .filter(c => !c.passed && c.fix)
+            .map(c => c.fix);
+        return {
+            error: error.message,
+            checks,
+            fixes,
+            summary: this.generateSummary(checks),
+        };
+    }
+    /**
+     * 检查 1: 项目结构是否完整
+     */
+    async checkProjectStructure(projectRoot) {
+        const paths = getProjectPaths(projectRoot);
+        const requiredDirs = [
+            { path: paths.specify, label: '.specify' },
+            { path: paths.claude, label: '.claude' },
+            { path: paths.commands, label: '.claude/commands' },
+        ];
+        const missing = [];
+        for (const dir of requiredDirs) {
+            if (!await fs.pathExists(dir.path)) {
+                missing.push(dir.label);
+            }
+        }
+        if (missing.length === 0) {
+            return { name: '项目结构', passed: true, message: '项目结构正常' };
+        }
+        return {
+            name: '项目结构',
+            passed: false,
+            message: `缺少目录: ${missing.join(', ')}`,
+            fix: 'novelws init',
+        };
+    }
+    /**
+     * 检查 2: tracking 文件是否存在
+     */
+    async checkTrackingFiles(projectRoot) {
+        const trackingDir = getProjectPaths(projectRoot).tracking;
+        if (!await fs.pathExists(trackingDir)) {
+            return {
+                name: 'Tracking 文件',
+                passed: false,
+                message: 'spec/tracking 目录不存在',
+                fix: '/track --sync',
+            };
+        }
+        const expectedFiles = [
+            'character-state.json',
+            'plot-tracker.json',
+            'timeline.json',
+            'relationships.json',
+        ];
+        const missing = [];
+        for (const file of expectedFiles) {
+            if (!await fs.pathExists(path.join(trackingDir, file))) {
+                missing.push(file);
+            }
+        }
+        if (missing.length === 0) {
+            return { name: 'Tracking 文件', passed: true, message: 'tracking 文件存在' };
+        }
+        return {
+            name: 'Tracking 文件',
+            passed: false,
+            message: `缺少 tracking 文件: ${missing.join(', ')}`,
+            fix: '/track --sync',
+        };
+    }
+    /**
+     * 检查 3: 项目模式是否匹配
+     */
+    async checkProjectMode(projectRoot) {
+        const mode = await this.detectProjectMode(projectRoot);
+        if (mode === 'unknown') {
+            return {
+                name: '项目模式',
+                passed: false,
+                message: '无法检测项目模式',
+                fix: '/track --sync',
+            };
+        }
+        return {
+            name: '项目模式',
+            passed: true,
+            message: `当前模式: ${mode}`,
+        };
+    }
+    /**
+     * 检查 4: MCP 服务器状态
+     */
+    async checkMCPStatus(projectRoot) {
+        const dbPath = path.join(projectRoot, 'novel-tracking.db');
+        const mcpConfigPath = path.join(projectRoot, '.claude', 'mcp.json');
+        const hasDb = await fs.pathExists(dbPath);
+        const hasMcpConfig = await fs.pathExists(mcpConfigPath);
+        if (!hasMcpConfig) {
+            return {
+                name: 'MCP 状态',
+                passed: true,
+                message: '未配置 MCP（使用 JSON 模式）',
+            };
+        }
+        if (hasMcpConfig && !hasDb) {
+            return {
+                name: 'MCP 状态',
+                passed: false,
+                message: 'MCP 已配置但数据库不存在',
+                fix: '/track --migrate --target mcp',
+            };
+        }
+        return { name: 'MCP 状态', passed: true, message: 'MCP 服务正常' };
+    }
+    /**
+     * 检查 5: JSON 文件完整性
+     */
+    async checkFileIntegrity(projectRoot) {
+        const trackingDir = getProjectPaths(projectRoot).tracking;
+        if (!await fs.pathExists(trackingDir)) {
+            return { name: '文件完整性', passed: true, message: '无 tracking 文件需要验证' };
+        }
+        const jsonFiles = [
+            'character-state.json',
+            'plot-tracker.json',
+            'timeline.json',
+            'relationships.json',
+        ];
+        const corrupted = [];
+        for (const file of jsonFiles) {
+            const filePath = path.join(trackingDir, file);
+            if (await fs.pathExists(filePath)) {
+                try {
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    JSON.parse(content);
+                }
+                catch {
+                    corrupted.push(file);
+                }
+            }
+        }
+        if (corrupted.length === 0) {
+            return { name: '文件完整性', passed: true, message: 'JSON 文件格式正确' };
+        }
+        return {
+            name: '文件完整性',
+            passed: false,
+            message: `JSON 格式损坏: ${corrupted.join(', ')}`,
+            fix: '/track --fix',
+        };
+    }
+    /**
+     * 检测项目模式
+     */
+    async detectProjectMode(projectRoot) {
+        const paths = getProjectPaths(projectRoot);
+        const dbPath = path.join(projectRoot, 'novel-tracking.db');
+        if (await fs.pathExists(dbPath)) {
+            return 'mcp';
+        }
+        if (await fs.pathExists(paths.trackingVolumes)) {
+            const entries = await fs.readdir(paths.trackingVolumes).catch(() => []);
+            if (entries.length > 0) {
+                return 'sharded';
+            }
+        }
+        if (await fs.pathExists(paths.tracking)) {
+            return 'single-file';
+        }
+        return 'unknown';
+    }
+    /**
+     * 格式化诊断报告为用户友好的字符串
+     */
+    formatReport(report) {
+        const lines = [
+            `❌ 错误: ${report.error}`,
+            '',
+            '🔍 诊断结果:',
+        ];
+        for (const check of report.checks) {
+            const icon = check.passed ? '✅' : '❌';
+            lines.push(`  ${icon} ${check.name}: ${check.message}`);
+        }
+        if (report.fixes.length > 0) {
+            lines.push('');
+            lines.push('💡 修复步骤:');
+            report.fixes.forEach((fix, i) => {
+                lines.push(`  ${i + 1}. 运行: ${fix}`);
+            });
+        }
+        return lines.join('\n');
+    }
+    generateSummary(checks) {
+        const passed = checks.filter(c => c.passed).length;
+        const total = checks.length;
+        if (passed === total) {
+            return '所有检查通过，问题可能来自其他原因';
+        }
+        const failed = checks.filter(c => !c.passed).map(c => c.name);
+        return `${passed}/${total} 项检查通过，问题: ${failed.join(', ')}`;
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/utils/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/utils/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAQ,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA4B1D,MAAM,OAAO,kBAAkB;IAC7B;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,KAAY,EAAE,OAAuB;QACvD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/B,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,WAAW,CAAC;YAC/C,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC;YAC5C,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC;YAC1C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC;YACxC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC;SAC7C,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAI,CAAC,CAAC;QAEpB,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,MAAM;YACN,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;SACtC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QAC7C,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG;YACnB,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE;YAC1C,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;YACxC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE;SACpD,CAAC;QAEF,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC3D,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,SAAS,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACtC,GAAG,EAAE,cAAc;SACpB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,WAAmB;QAC1C,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC;QAE1D,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,qBAAqB;gBAC9B,GAAG,EAAE,eAAe;aACrB,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG;YACpB,sBAAsB;YACtB,mBAAmB;YACnB,eAAe;YACf,oBAAoB;SACrB,CAAC;QAEF,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QACzE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAChD,GAAG,EAAE,eAAe;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAEvD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,UAAU;gBACnB,GAAG,EAAE,eAAe;aACrB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,SAAS,IAAI,EAAE;SACzB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,WAAmB;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAEpE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAExD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,qBAAqB;aAC/B,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,gBAAgB;gBACzB,GAAG,EAAE,+BAA+B;aACrC,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,WAAmB;QAC1C,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC;QAE1D,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;QACvE,CAAC;QAED,MAAM,SAAS,GAAG;YAChB,sBAAsB;YACtB,mBAAmB;YACnB,eAAe;YACf,oBAAoB;SACrB,CAAC;QAEF,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtB,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACjE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,cAAc,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC7C,GAAG,EAAE,cAAc;SACpB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,WAAmB;QACzC,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QAE3D,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACxE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAwB;QACnC,MAAM,KAAK,GAAa;YACtB,SAAS,MAAM,CAAC,KAAK,EAAE;YACvB,EAAE;YACF,UAAU;SACX,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,eAAe,CAAC,MAAqB;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAE5B,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,GAAG,MAAM,IAAI,KAAK,cAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7D,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novelws",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "type": "module",
   "description": "Claude Code 专用的 AI 小说创作工具 - 深度集成 Slash Commands 和 Agent Skills",
   "keywords": [