前言¶
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 進程權限，安裝前建議檢查源碼與許可證。
