前言¶
長篇網文寫到幾百章後，常見的問題不只是“能不能生成一段情節”，而是設定是否還在、伏筆是否還記得、大綱是否被守住、欠讀者的兌現有沒有被跟蹤。dsh-tool-writing 是面向 DeepSeek Harness（DSH）的長篇網絡小說寫文引擎插件，把這類問題拆成工具調用、臺賬記錄、審查關卡和檢索流程。
下面介紹它解決什麼問題、提供哪些已覈實能力，以及如何安裝和啓用。
這是什麼¶
dsh-tool-writing 的維護者是 x2802490130-prog，許可證爲 MIT。
它的一句話定位是：一套把“長篇一致性”做成工程的長篇網文創作系統——寫到幾百章，依然記得住設定、接得住伏筆、守得住大綱；每章寫完，事實自動入賬，欠讀者的賬自動記賬。
它面向 DSH 提供長篇網絡小說寫作能力，並使用獨立 DeepSeek key 承擔子線程、分流、多線並行的生成與檢索任務。插件提供 novel_* 工具集，README 標註爲 48 個工具。
核心能力¶
多書隔離¶
插件按“一個工作區 = 一本書”組織項目，並按會話綁定工作區。這樣可以在同一個宿主環境裏維護多本書，減少項目狀態相互干擾的問題。
獨立 key 與任務分流¶
插件使用獨立於主 Agent 的 DeepSeek key，用於承擔子線程、分流、多線並行的生成與檢索任務。
已覈實的 key 配置包括：
- 主 key：
DSH_WRITING_API_KEY，必配。 - 起草通道：
DSH_WRITING_DRAFT_KEY，可選，回退主 key。 - 潤色通道：
DSH_WRITING_POLISH_KEY，可選，回退主 key。 - 同步/深任務通道：
DSH_WRITING_SYNC_KEY，可選，回退主 key。
憑據全部來自宿主環境變量注入，代碼內無硬編碼密鑰。
彈性合同體系¶
已覈實的彈性合同體系包括：
- 故事承諾書
- 正典臺賬
- 五段寫作任務書
- 硬關卡
這套體系的目標是把“全書承諾、已寫事實、寫作任務、寫後檢查”拆成可執行步驟，而不是隻靠一次性提示詞維持長篇一致性。
章後體檢與發書審查¶
已覈實的審查能力包括：
- 章後八項體檢，包括節奏信號與 AI 味檢查。
- 起點與番茄雙平臺審稿。
- 發書前敏感自查。
檢索與書庫¶
已覈實的檢索與書庫能力包括：
- 語義檢索
- 純概念向量檢索
- 概念索引構建
- 飼料區書庫管理：導入、列表、讀取、刪除、檢索與拆解
語義檢索使用 DeepSeek 概念索引，無需第三方 embedding key；如顯式配置有效 embedApiKey，仍可用稠密向量。
安裝與啓用¶
1、安裝插件¶
先執行插件安裝命令：
dsh plugin --profile web add dsh-tool-writing
安裝完成後，需要重啓 harness。
2、掛載到寫作預設¶
在寫作預設的 agent.cordis.yml 中掛載插件。以下代碼塊列出已覈實的配置鍵，具體模型和併發數按實際環境填寫：
- id: tool-writing
name: 'dsh-tool-writing'
config:
apiKeyEnv: DSH_WRITING_API_KEY
model: <填寫可用模型>
deepModel: <填寫可用模型>
maxConcurrency: <填寫併發數>
這一步的目的是讓寫作會話可以調用 dsh-tool-writing 提供的 novel_* 工具。
3、配置 DeepSeek key¶
主 key 必配：
DSH_WRITING_API_KEY=...
可選拆分通道 key：
DSH_WRITING_DRAFT_KEY=...
DSH_WRITING_POLISH_KEY=...
DSH_WRITING_SYNC_KEY=...
可選 key 未配置時回退主 key。
4、驗證安裝¶
進入寫作會話後，發送：
novel_status
該工具用於驗證安裝是否成功。
典型用法¶
開一本書¶
基本流程如下：
- 新建工作區。一個工作區對應一本書。
- 通過
novel_brief引導開書。 - 使用
novel_init建骨架。 - 使用
novel_outline搭大綱。 - 使用
novel_lore建設定。 - 使用
novel_draft寫第一章。
連載維護¶
每章寫完後，可以做如下編排：
- 執行
novel_sync自動編排。 - 定期執行
novel_audit八項體檢。 - 執行
novel_ledger scan追讀力。
發書前審查¶
發書前可以使用：
novel_market進行起點與番茄雙平臺審稿。novel_censor進行敏感自查。
檢索與書庫¶
可以使用插件提供的語義檢索、純概念向量檢索與概念索引構建能力，對當前項目和飼料區書庫進行檢索。飼料區書庫支持導入、列表、讀取、刪除、檢索與拆解。
環境與依賴¶
package.json 聲明的依賴環境如下：
{
"engines": {
"node": ">=22.5.0"
},
"peerDependencies": {
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
"@deepseek-ai/schemastery": "^3.18.1"
}
}
適用場景與注意¶
適合的使用場景：
- 需要在 DSH 中寫長篇網絡小說。
- 需要同時維護多本書，並要求工作區隔離。
- 需要把設定、伏筆、大綱、欠賬納入工具化流程。
- 需要在發書前做平臺審稿與敏感自查。
- 需要導入現有書庫並做檢索或拆解。
使用前注意：
- 插件會以當前 DSH 進程權限運行其代碼，安裝前應檢查源碼與許可證。
- 插件需要獨立於主 Agent 的 DeepSeek key，主 key 必配，其他通道 key 可選且回退主 key。
- 倉庫
.gitignore排除所有項目數據文件，內容不上傳，飼料由插件用戶自備。 - 代碼內無硬編碼密鑰，憑據全部來自宿主環境變量注入。
- 語義檢索默認使用 DeepSeek 概念索引，無需第三方 embedding key；如顯式配置有效
embedApiKey，仍可用稠密向量。 - 許可證爲 MIT。
資源¶
GitHub 倉庫：
https://github.com/x2802490130-prog/dsh-tool-writing
當前已覈實資料未提供目錄頁 URL，本文不給出未覈實的目錄頁鏈接。
