DSH 插件生態中，長篇小說創作依賴明確的設定和進度管理。dsh-novel 解決了這一點：它給 Agent 提供了 5 個 novel_* 工具，同時也提供了一個宿主原生席位面板，用於管理大綱、角色關係、劇情任務和章節進度。
核心功能¶
該插件將工作流分爲兩部分：一部分供 Agent 調用工具進行創作，另一部分供人類用戶管理項目結構。
Agent 工具
給 Agent 提供 5 個工具，用於讀寫設定和正文：
* novel_list：列出所有小說及其章節、角色數。
* novel_read：讀取設定文件（設定.json）、大綱、世界觀、人物卡或特定章節正文。
* novel_context：一次取全「續寫下一章」所需的完整上下文（包含設定、大綱、世界觀、角色關係及最近章節）。
* novel_save_chapter：保存章節，文件名自動按章節編號。
* novel_cast：讀取、增刪改角色與人物關係。
宿主原生席位面板
爲用戶提供可視化的管理界面：
* 開書嚮導：支持模板補全，支持先開書再慢慢補全設定。
* 小說庫：記住每本小說的閱讀進度，支持搜索、排序和切換。
* 角色關係圖：支持力導向佈局，可上傳圖片頭像。
* 劇情任務欄：管理情節點、掛載章節、卷綱領，支持手動標記完成。
* 一鍵續寫 + 流式直播：模型生成時實時顯示在面板上。
* 導出功能：支持導出 EPUB 和 Word 格式。
安裝¶
在終端執行以下命令安裝：
dsh plugin --profile web add github:wbb316/dsh-novel
安裝完成後，重啓 DSH Web 進程以使插件生效：
dsh web
使用示例¶
在對話中調用 Agent 時，可以使用以下方式調用工具：
- 使用
novel_context獲取續寫下一章所需的完整上下文：
{ "tool": "novel_context", "novel": "小說名", "chapter_count": 3 }
- 使用
novel_save_chapter保存章節，文件名會自動編號：
{ "tool": "novel_save_chapter", "novel": "小說名", "content": "本章正文..." }
- 使用
novel_cast增刪改角色和關係，或上傳頭像：
{ "tool": "novel_cast", "novel": "小說名", "addCharacters": [{ "name": "角色名", "role": "配角" }] }
系統要求與注意事項¶
- DSH 版本：要求
>= 0.2.0-rc.1。 - Node 版本：要求
>= 20。 - 老宿主兼容：老版本宿主若無原生席位，面板會退回到
dsh-better-sidebar頁籤。 - 刪除機制：刪除操作爲移入回收站，非真刪除。
- 改名風險：改角色名會進行全文替換，操作前需確認。單個字的名字不進行全文替換。
總結¶
dsh-novel 通過結構化的數據管理（JSON 設定、角色關係、劇情表）和可視化的面板，降低了長篇小說創作中上下文維護和進度管理的難度。對於需要在 DSH 中構建小說寫作流程的開發者，這是一個直接的集成方案。
