DSH-Novel · AI 写作

一个 Agent 预设，把 DeepSeek Harness 变成「AI 写小说」工作台：33 个网文写作工具 + 完整网文创作方法论，全部随「小说助手」预设内置、持久可用。 把本仓库（或 GitHub 链接）交给任意 DeepSeek Harness Agent，按 INSTALL.md 执行即可自动安装完成。

---

一、这是什么

本项目只包含一件东西——「小说助手」Agent 预设。它以写小说为核心，把 DSH 变成一位专业网文写作助手：

| 组件 | 类型 | 作用 | | --- | --- | --- | | 小说助手（novelist） Agent 预设 | 用户 Agent 预设（持久） | ① 33 个 novel_* 写作工具（内置 novel-tools.mjs），分两条线：
　· 创作单点：润色、续写、去 AI 味、大纲整理/优化/续写、小说分析、拆书学习、灵感生成、世界观构建、角色设计、章节规划、场景写作、黄金三章、书名/标题、简介与梗概（含前情提要/章末摘要）、作品评阅、改写、对话优化、文学翻译、剧情漏洞排查、起名、文风设定、情节推演、角色采访（人声校准）、平台合规体检（过审风险）、模拟读者团（发布前试读，多类读者视角反馈）；
　· 长篇工程闭环：旧稿导入（novel_import，存量作品自动分章落盘 + 逆推大纲/人物卡/设定集）→ 写前简报（novel_briefing，从工程材料浓缩本章上下文）→ 单章成稿（novel_write_chapter，草稿→自查→修订多稿流水线）→ 章后归档（novel_archive，自动更新伏笔清单/时间线/人物状态）→ 全书体检（novel_scan_book，跨章一致性 + 跨章重复扫描，无需粘贴文本）→ 作品工程（novel_project，初始化/存稿/伏笔清单/时间线/统计进度/索引）——每章走一遍这个循环，长篇一致性不靠模型硬扛。
所有工具都调用当前会话模型做真正的文本生成，并遵守「去 AI 味写作红线」。
② 以写小说为核心的人设 + 完整的《网文创作方法论》提示段（黄金三章法则、爽点公式、节奏钩子、伏笔闭环、长篇连载循环、一致性守则、节奏量化参考、长篇工程、成稿流程、去 AI 味自查、Obsidian 落盘约定）；
③ 标准工作台：文件读写、网页检索、子代理与工作流、目标与待办、计划模式。 |

二、目录结构

DSH-Novel/
├── README.md                      # 本说明
├── LICENSE                        # MIT 开源许可证
├── INSTALL.md                     # 安装指引（交给 Agent 执行，或手动参考）
└── agent-presets/
    └── novelist/                  # 「小说助手」Agent 预设（复制到 ~/.dsh/.agent-presets/novelist）
        ├── preset.yml             # 预设元数据（名称/描述）
        ├── agent.cordis.yml       # 组合文件（人设 + 标准工作台 + 内置工具行）
        └── plugins/
            └── novel-tools.mjs    # 预设内置的 33 个写作工具（自包含，随预设加载）

三、安装

方式一：交给 DSH 自动安装（推荐）

1. 把本仓库目录（或 GitHub 链接）交给任意 DeepSeek Harness Agent，例如：

   “请把 DSH-Novel 项目安装到当前环境，按 INSTALL.md 执行。”

2. Agent 会按 INSTALL.md 完成：
   • 把 agent-presets/novelist/ 复制到 DSH 用户预设根目录 ~/.dsh/.agent-presets/novelist；
   • 用 agentPresets.standingKeyFor('novelist') 做挂载校验；
   • 完成后新建会话选择「小说助手」即可开始写作。

方式二：手动安装

见 INSTALL.md 中的逐条步骤（同一套内容，供手动执行）。

四、使用

写作时的体验是这样的：你像在跟一位编辑搭档聊稿子。说一句「继续写下一章」，助手会先翻一遍工程里的材料——大纲、人物卡、伏笔清单、上一章结尾——浓缩成本章的写前简报；你确认后它按细纲成稿整章，初稿落笔时就按「去 AI 味红线」写干净；你在 Obsidian 里过目、批注、改字句，再说「归档」，伏笔清单、时间线、人物状态随之更新，下一章自动带着最新状态继续推进。长篇写到几十章都不乱，靠的是这些随写随更的工程文件，而不是模型的记忆。

• 日常写作：新建会话 → 预设选择「小说助手」→ 直接对话：
  • “把这些素材整理成大纲，再规划第一卷 10 章”
  • “接着这篇正文续写 2000 字，结尾留钩子”
  • “帮我润色这段 / 拆解这段开篇学它的钩子写法”
• 长篇连载（推荐每章走一遍闭环）： 0. 已有存稿？先“把这份旧稿导入工程”（novel_import，自动分章落盘 + 逆推大纲/人物卡/设定集），没有就“初始化作品工程《书名》”（novel_project，自动建 正文/大纲/设定集/人物卡/归档/伏笔清单/时间线）
  1. “生成第 3 章的写前简报”（novel_briefing，汇总大纲、人物卡、活跃伏笔与上一章结尾）
  2. “按这份简报和细纲写第 3 章，写完保存”（novel_write_chapter，草稿→自查→修订后落盘）
  3. “归档第 3 章”（novel_archive，更新伏笔清单、时间线与归档记录）
  4. 下一步只需说“继续写下一章”，助手会带着全部上下文接着推进。
• 去 AI 味与质量：
  • “把这段去一下 AI 味：……”（novel_deai，用于外来文本/旧稿；写作工具成稿时已按「落笔即防」产出干净稿）
  • “采访一下主角，我要校准他的说话方式”（novel_interview）
  • “这章按番茄的尺度做个合规体检”（novel_compliance，上架/过审前用）
• 读者反馈与全书体检：
  • “让读者团试试这章”（novel_reader_panel，多位典型读者的爽点/弃书点/追更意愿反馈，发布前用）
  • “给全书做个体检，抽 8 章扫一致性”（novel_scan_book，直接读工程文件，查跨章矛盾与跨章重复，无需粘贴文本）
• 让 Agent 把成果落盘：让 Agent 把章节、大纲、设定集以 Markdown 保存到工作区，之后用 Obsidian 阅读与批注（见下节）。

五、搭配 Obsidian 使用

本项目非常适合搭配 Obsidian 一起使用：把「小说助手」的工作区（或专门的写作目录）直接作为 Obsidian 的 Vault。

• Agent 产出的章节、大纲、设定集、人物卡、伏笔清单全部是 Markdown 文件，天然就是 Obsidian 笔记——无需任何转换。
• 在 Obsidian 里阅读与批注成稿：正文排版、高亮、评论随手可加，改完后把文件放回工作区，告诉 Agent「继续写」，它会读到你的修改。
• 用双链把角色、地点、事件、势力互相关联，用图谱视图看清设定网络与伏笔脉络；用标签与看板跟踪连载进度、分卷与更新状态。
• 写作闭环：Agent 生成 → Obsidian 阅读批注 → 反馈给 Agent → 迭代，人工与 AI 各取所长。

六、说明

• 持久性：整个项目就是一个 Agent 预设，随 ~/.dsh/.agent-presets/novelist 持久存在——写作工具、人设、方法论全部内置，进程重启、切换会话都不影响，无需重装任何东西。
• 模型路由：所有工具默认调用当前会话的默认模型，每个工具都支持传入 provider / model 覆盖；无默认模型时自动兜底到第一个可用提供方。
• 去 AI 味（落笔即防）：所有写作工具的共享系统提示内置「落笔即防」规范——先想画面再动笔、写完一段扫一段、交稿前整篇快扫，成稿输出即干净稿，不做「先带 AI 味、事后去味」的二道工序；《网文创作方法论》第八节同步约定；novel_deai 只用于处理外来文本与旧稿。

七、维护

• 修改预设：编辑 agent-presets/novelist/ 下文件，复制覆盖到 ~/.dsh/.agent-presets/novelist/，并重新挂载校验（agentPresets.standingKeyFor('novelist')）。
• 卸载：删除 ~/.dsh/.agent-presets/novelist 目录即可。

八、许可证

本项目使用 MIT License，© 2026 KurohaneKaoruko。你可以自由使用、修改、分发（含商用），但需保留版权与许可声明。