前言¶

在 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