前言¶

在 DeepSeek Harness (DSH) 的生態中，長篇創作往往面臨角色一致性難以維持、狀態管理混亂的難題。DSH 理念是“一切皆插件”，dsh-novel-craft 正是爲此設計的工具。它借鑑了 story-craft 的方法論，旨在解決結構化管理和跨章狀態同步的問題，將寫作規範、角色狀態和世界觀事實沉澱爲可管理的狀態包。

插件介紹¶

該插件由 winston-hoo 維護，基於 DeepSeek Harness (DSH) 開發。其核心價值在於提供一套從角色建模到章節產出、再到消耗監控的完整工作流，幫助創作者在長篇幅寫作中保持連貫性。

核心功能¶

插件提供以下核心工具：

• 建項目：通過 novel_create_project 初始化小說項目。
• 角色管理：
  • novel_upsert_character：建/改角色卡，支持五維模板與 S/A/B/C 分級。
  • novel_list_characters / novel_get_character：查看角色摘要或獲取單卡全文。
• 狀態管理：
  • novel_get_state：注入狀態包，包含寫作規範、事實、伏筆、角色狀態、鉤子和劇情線。
  • novel_update_state：回寫狀態包，更新 state/ 目錄下的五個文件。
• 寫作與索引：
  • novel_write_chapter：寫/追加章節，並自動生成字數索引。
• 消耗監控：
  • novel_balance：查看餘額與峯谷時段。
  • novel_usage：查看今日消耗與臺賬。

安裝與啓用¶

安裝命令如下，僅依賴 DSH 宿主的 peer 依賴（cordis/schemastery/dsh-tools/dsh-session），無需額外安裝包：

dsh plugin --profile headless add github:winston-hoo/dsh-novel-craft

典型用法¶

使用前需設置模型 key（餘額/消耗需要）。典型的寫作流程如下：

1. 新建項目：使用 novel_create_project 新建《多贏人生》（都市）等題材。
2. 章節循環：建議每章一個任務，按順序執行 get_state →（按需 get_character）→ write_chapter → update_state。
3. 稿庫結構：默認稿庫位於 ~/.dsh/novel，包含 project.json、characters/、chapters/、state/ 和 usage.json。

適用場景與注意¶

該插件適合需要結構化管理角色/世界觀、按寫作規範驅動寫稿、自動沉澱稿庫與監控消耗的用戶。

• 運行權限：插件以當前 DSH 進程權限運行。
• 源碼檢查：安裝前應檢查源碼與許可證。
• 定價配置：插件的峯谷定價對齊 DeepSeek 官方，改價時可編輯 src/usage.ts 頂部常量。

許可證¶

MIT © 2026 Winston

總結¶

dsh-novel-craft 通過狀態包和結構化角色卡，解決了長篇小說創作中的狀態一致性與寫作規範問題。更多細節可查看項目主頁：GitHub