前言¶
DeepSeek Harness（DSH）的插件化生态让本地大模型能力可以灵活扩展。针对中文网文写作场景，dsh-novel-writer 是一个本地化工作台插件。它解决的核心问题是：在本地运行时，如何保持文风的一致性、如何系统化地管理伏笔与设定，以及如何在不依赖在线 API 的情况下完成从“动笔前取材”到“全书体检”的全流程。
该插件由 siweina 维护，基于 MIT 协议开源。它不依赖任何云端 API，所有文本分析、风格比对、语义检索均在本地完成。
核心功能¶
该插件提供 19 个工具，覆盖网文创作的完整闭环。
- 写作台三件套：
novel_chapter_brief：动笔前调用，一次取齐 16 项输入材料（上一章结尾、钩子、大纲方向、人物卡、待回收伏笔、世界观用语、风格基线 μ±σ、原著锚段等），缺项会记录在degraded字段中。novel_fix_plan：改稿台，将风格诊断转化为按优先级排序的待办清单（带行号、当前值与目标值、锚段与改写方向），支持plan、verify、mark三态复测。novel_plot：结构视图，用于跨章体检，检查伏笔跨度、人物缺席区间、剧情线空档等。
- 风格量化：提供六维 μ±σ 基线分析（句法复杂度、修饰密度、抽象度、动作密度、不确定性、留白指数）和 12 轴氛围光谱。
- 本地语义引擎：内置 24MB 中文模型（bge-small-zh），支持本地向量检索，实现自然语言查询语义相关段落。
- MCP 支持：可作为 MCP 服务器供 Claude Desktop 或 Cursor 使用。
- 设定管理：包含伏笔登记表、设定五张表（人物/地点/道具/时间线/世界观）、连贯性审计等功能。
安装与启用¶
安装需要满足环境依赖。在终端执行以下命令：
dsh plugin add dsh-novel-writer
环境要求：
* Node.js 版本：>= 22.3
* DeepSeek Harness 版本：>= 0.1.1-rc.2
安装完成后需重启 DSH。在 DSH 左栏导航区会出现「写作助手功能」入口。
典型用法¶
以下是完成一章网文的标准工作流：
- 准备目录
mkdir -p novels/我的小说
-
动笔前取材料
在对话中输入：
> 给下一章取材料
系统会调用novel_chapter_brief，返回包含上一章承接、相关人物、待回收伏笔、风格基线 μ、原著锚段等在内的完整材料包。 -
撰写正文
照返回的锚段与骨架进行创作。 -
自检
在对话中输入：
> 自检这一章
系统会调用novel_style_check，输出相似度、偏差清单及六维对照表（带内 ✓ / 出带 ⚠）。 -
改稿清单
在对话中输入：
> 把这章排成改稿清单
系统会调用novel_fix_plan，按「严重度 → 难度 → 行号」排序输出待办事项，每项包含原句行号、当前值与目标值、锚段与改写方向。 -
全书体检
在对话中输入：
> 看看全书结构
系统会调用novel_plot { action: "graph" }，分析伏笔埋设跨度、人物连续缺席区间等跨章结构问题。
注意事项¶
- 数据隐私：全文本地推理，不上传正文，不涉及 API Token 消耗。
- 语言设计：插件仅针对中文小说设计，核心模型与语料库均为中文优化。
- UI 说明：界面风格使用 DSH 官方 token 用料。
- 安装来源：请从
dsh plugin add dsh-novel-writer或官方目录安装，以确保版本兼容性。
