dsh-novel-craft — 小说创作插件（DeepSeek Harness）

基于 DeepSeek Harness（dsh）的小说创作插件：结构化管理角色/世界观 → 状态包跨章一致性 → 按写作规范驱动写稿 → 自动沉淀稿库 + 余额/消耗/峰谷监控。

写作规范与长篇状态管理借鉴 story-craft 的方法论；余额/消耗/峰谷定价对齐 DeepSeek-Balance-Whale-Widget。

功能

能力	工具
建项目	novel_create_project
建/改角色卡（五维模板 + S/A/B/C 分级）	novel_upsert_character
角色摘要 / 单卡全文	novel_list_characters · novel_get_character
状态包注入（写作规范 + 事实 + 伏笔 + 角色状态 + 钩子 + 剧情线）	novel_get_state
状态回写（state/ 五文件）	novel_update_state
写/追加章节 + 自动字数索引	novel_write_chapter
余额 + 峰谷时段	novel_balance
今日消耗 + 台账	novel_usage

写作时自动注入反 AI 味规范（13 类禁用模式）与体裁风格取向；每次回合消耗按峰谷定价自动累计。

安装

dsh plugin --profile headless add github:<你的GitHub>/dsh-novel-craft

仅依赖 dsh 宿主的 peer 依赖（cordis/schemastery/dsh-tools/dsh-session），无需额外安装包。

使用（示例）

# 设模型 key（余额/消耗需要）
dsh plugin --profile headless ... # 或直接在环境配置 DEEPSEEK_API_KEY

dsh --profile headless "用 novel_create_project 新建《多赢人生》（都市），再按状态包流程写第1章"

建议每章一个任务：get_state →（按需 get_character）→ write_chapter → update_state，状态包让第 N 章与第 1 章保持一致，单章成本恒定。

稿库结构

<outDir>/（缺省 ~/.dsh/novel）
├── project.json
├── characters/<roleId>.md
├── chapters/{0xx.md, index.json}
├── state/{established-facts.md, foreshadows.json, character-state.md, next-hook.md, arc-status.md}
└── usage.json   # 消耗台账（峰谷定价）

定价与峰谷（对齐 DeepSeek 官方）

• 高峰：工作日 9:00–12:00 / 14:00–18:00（北京）；2026-08-23 起周末全天谷价。
• flash 系：输入未命中 1.5（谷）/3.0（峰）元-百万 token；命中 0.05/0.1；输出 4.5/9.0。v4-pro 为其 3 倍。
• 改价时编辑 src/usage.ts 顶部常量。

开发

pnpm install
pnpm run build     # tsc → lib/

许可

MIT © 2026 Winston