dsh-novel-writer 是一款面向中文网文作者的本地写作工作台，内置 19 个工具，覆盖从动笔前准备到跨章结构体检的完整写作流程。
【主要用途】 面向中文小说（尤其是网文）的创作辅助与一致性维护。作者可在动笔前取齐写作材料，写完后进行量化自检，按优先级复测改稿，并从跨章层面检查结构连贯性。
【主要能力】
- 开写包（novel_chapter_brief）：动笔前一次调用取齐 16 项材料，包括上一章承接口、本章方向、相关人物、待回收伏笔、用语规范、风格基线、锚段与骨架、禁用清单、开写清单等，提供 compact / full 两档 budget，取不到的材料进入 degraded 并说明原因，只读不写盘。
- 改稿台（novel_fix_plan）：把风格诊断变成按优先级排好的待办，含原句行号定位、当前值与目标值、原著锚段与改写方向，支持 plan / verify / mark 三态复测，只给方向、不生成正文。
- 结构视图（novel_plot graph）：检查伏笔埋设跨度、人物连续缺席、剧情线空档、时间线顺序与大纲对照。
- 风格画像报告（novel_style_report）：6 维测量报告，涵盖文风指纹、高频词汇、题材流派、情感量化、氛围光谱 12 轴、语义风格距离；测量与判断分离，插件只报数不贴标签。
- 氛围光谱 12 轴：噩梦感、焦虑压抑、温馨治愈、甜宠日常、催泪虐心、黑暗残酷、悬疑神秘、热血激昂、荒诞无厘头、孤独疏离、文艺唯美、情欲暧昧，证据链可追溯。
- 本地语义引擎：内置 bge-small-zh 中文模型（约 24MB 随插件分发），本地 CPU 推理，支持 novel_semantic_search 自然语言搜全书语义相关段落，具备语义级风格对比与语义隐性情感分析，懒加载并自动回退。
- 句式模式分析：九类句式分布、排列规律、句长节奏、情感曲线、风格指纹与节奏建议，带缓存与报告导出。
- 情感净化与量化：强/弱情绪词分级、污染源检测、caveat 预警；Valence 滑动窗口计算方差、斜率与矛盾指数，识别隐性意象载体。
- 世界观与语用检测：文化基准自动判断（西/东/混合）与置信度，speechStyle 称谓、客套、仪式、语气规范，题材流派与网文信号识别。
- 写作辅助：伏笔登记表、设定五张表（人物·地点·道具·时间线·世界观）、章节摘要、连贯性审计、批量导入、风格自检、续写辅助。
- 写作哨兵（novel_continuity_check）：衔接检查（时间硬跳、语义距离、人物延续、钩子承接）、OOC 检测（角色情绪基线偏离）、大纲走偏检测（方向行 vs 正文关键词重合）。
- 风格基线：文笔六维测量 + 按章节 μ±σ 基线带，支持自定义每维 ±% 容差（推荐值 = 原著章节波动的 1.5 倍 σ）。基线范围（v6.5.5）可按书选择「按全书」或「按部分」，支持勾选标杆章节作为基线，正在检查的章节永远排除。
- 原创模式与创作资料：面板可填写创作设定（世界观、角色、禁忌、主线、题材、额外要求），novel_outline 维护创作资料，原创强制「设定书→大纲→钩子」链，动态批次防剧情跳跃与角色 OOC。
- 体验与统计：书库统计卡（每本章数、总字数、近 7 天活跃字数）、体验演示、报告历史。
【使用方式】 要求 Node ≥ 22.3。支持三种安装方式：命令行（可加 --profile <名称> 指定配置）、从 GitHub 安装、以及作为 MCP 服务器使用（不用 DSH 也能用）。安装后重启 DSH，左栏主导航区出现「写作助手功能」入口。 基本写作流程：在对话中依次说「给下一章取材料」→「写第 7 章」→「自检第 7 章」→「把第 7 章排成改稿清单」，改完后再 verify 复测。 MCP 服务器：包内自带 stdio MCP 服务器（mcp/server.mjs），把 19 个工具原样暴露给任何 MCP 客户端（如 Claude Desktop、Cursor），是运行在本机的本地进程，不需要服务器、不需要联网、不需要常驻。书库根目录优先级为 --root > 环境变量 DSH_NOVEL_WRITER_ROOT > 当前工作目录。
【适用场景】 中文网文与小说作者的日常写作、续写、改稿与一致性维护；需要本地化、不外传正文的写作分析；希望通过量化基线保持写作风格稳定的作者。
【限制与注意事项】
- 本插件为中文小说分析写作而设计，句式、情感、意象等核心能力及内置语义模型均针对中文语料构建与调优，对英文等其他语言的支持有限。
- 本机运行，语义引擎不可用时自动回退纯规则模式。
- 文件系统读写限于用户指定的书库根目录 novels/ 及其数据目录 <root>/.novel-writer/，以及插件开关文件 ~/.dsh/dsh-novel-writer/state.json。唯一例外：novel_import 的 src 按设计可指向任意目录，mode:"apply" + move:true 会删除源文件。MCP 服务器默认将 src 限制在书库根内，需要导入外部目录时用 --allow-external-src 显式放开。
- 外部网络：唯一外呼是 GitHub Releases API 检查新版本，3 秒超时、24 小时缓存、失败静默降级，请求不含任何书籍内容。
- 无子进程（唯一例外是打开系统文件管理器）；无生命周期脚本。
- 兼容范围：Node.js >= 22.3，DSH >= 0.1.1-rc.2。
- 运行时依赖：onnxruntime-web、@huggingface/tokenizers，peerDependency 为 react ^18.2.0。
【数据目录】 <书库根>/.novel-writer/ 下包含 plots（伏笔）、settings（设定）、summaries（摘要）、analysis（分析报告）、audits（连贯性审计 + 改稿清单）、embedding（语义索引）、style-reports（风格画像）。
