前言¶
DeepSeek Harness（DSH）的小说创作插件。设计主线只有一条：代码强制 > 提示词自觉。凡是“靠模型自觉”的约束都会失效——一致性、门禁、审计必须是工具层/数据层的硬约束。插件通过 20 个 novel_* 工具和右侧栏“锻炉”面板，将长篇网文写作中的设定崩坏、上下文丢失、水文、AI 味等问题转化为代码层面的硬约束。
核心功能¶
插件将长篇写作的常见问题转化为具体的工程约束：
- 设定与一致性管理：提供事实账本（
novel_ledger）与世界书（novel_worldbook），同章改值冲突直接拒绝；提供语言基因卡（novel_character voice）解决多角色千人一腔问题；通过写前简报（novel_briefing）按需注入上下文，防止长篇上下文爆炸。 - 流程与门禁控制：采用九阶段状态机（
novel_project phase）强制设定、大纲、细纲、正文的顺序；阶段门禁（novel_outline approve）要求细纲必须批准才能写章；同一章连续驳回 3 次触发熔断拒写。 - 质量控制：提供六维结构性扫描（
novel_noai_scan）进行去 AI 味检查；提供机审门槛（默认 2000–4000 字）和 8 字 shingle 重复检测防止跨章复读；提供章末钩子启发式检查和细纲契约覆盖率检查。 - 审稿与合规：支持平台审稿（
novel_audit platform，支持起点/番茄）和敏感自查七类（novel_audit censor）；机审与模型审分离，审稿产出确定性数字并引用证据；修订走提案制（novel_propose），用户在面板确认后才覆盖正文。
安装与启用¶
前提：已安装 DeepSeek Harness（DSH）并跑通模型；Node ≥ 22（22.19+ / 24+ 可启用检索索引，否则自动降级）。
安装：
dsh plugin --profile web add npm:dsh-novel-forge
启用：安装后必须重启 DSH web 进程并浏览器硬刷新。客户端 bundle 在进程启动时快照，不重启等于没装。重启后，右侧栏会出现「🔨 锻炉」独立 tab，会话中模型应能看到 20 个 novel_* 工具。
典型用法¶
- 建书：在会话中调用
novel_project init建立项目。 - 看阶段：使用
novel_project phase查看九阶段看板，按代码列出的缺项补齐（如先立意、再设定）。 - 写章：先
novel_outline save_chapter并approve批准细纲，再novel_briefing获取上下文包，最后novel_write_chapter写章并过门禁。 - 审稿：使用
novel_noai_scan扫描 AI 味，使用novel_audit进行平台审稿或敏感自查。 - 修订：使用
novel_propose propose提交修订提案，在右侧面板确认后应用。
面板与工具¶
- 锻炉面板：右侧栏提供项目列表、全书体检、批量起草（含断点续跑
draft-batch resume）、提案审批、章节听书等功能。 - 20 个工具：核心工具包括
novel_project（阶段管理）、novel_outline（大纲与批准）、novel_character（人物与语言基因）、novel_worldbook（世界书）、novel_scene（场景契约与隐藏人物）、novel_write_chapter（写章与门禁）、novel_ledger（事实账本）、novel_search（本地检索索引）等。
注意事项¶
- 纯本地零费用：扫描与诊断功能完全本地运行，不消耗模型 token。
- 修订机制：所有修订走提案，旧版永不覆盖，必须在面板确认后生效。
- 仓库：GitHub 公开仓库（需配好 SSH key 才能走 SSH 源），npm 版本从 0.16.0 起。
-
兼容性：代码强制逻辑依赖于 DSH 进程权限，安装前建议检查源码与许可证。
