概览
novel-writer
README / ZH
插件文档
多核协同写作模式
English | 简体中文
一个装在 DeepSeek Harness（DSH） 里的多智能体小说创作模式：一个「统筹队长」统领全局，5 个专职子代理各司其职——架构世界、策划剧情、管理人物、执笔写文、质检复核。预设内置 novel-writing 创作引擎技能（篇幅驱动流程 + 硬门禁校验脚本 + 33 维结构审计），作为全工作室统一的操作规程。新建会话时选它，就能用这支各就各位的「创作工作室」把一部小说从构思一路写到成稿。
这是什么
它不是只会聊天的 AI，而是一支分工明确的 6 人小说工作室——由一个「队长」统领全局，5 个「专职子代理」各干各的活。和「一个 AI 轮流演 6 个角色」不同，这里每个岗位是独立的：写正文的只写正文、挑错的只挑错、管世界的只管世界，每个子代理脑子里只装它那一份活，互不干扰，所以更专注、不串味。
| 角色 | 优势 | 干什么 |
|---|---|---|
| 统筹队长 | 专职总指挥，不写稿，能客观拍板 | 派单；跑硬门禁脚本；控节奏、终裁分歧、签发定稿；同一章被连续 3 次打回时，召集全体重新校准《叙事宪法》 |
| 世界子代理 | 世界背景与专有名词的唯一权威 | 产出《世界规则白皮书》和《名词索引附录》；每条设定都展开成「是什么 + 为什么 + 对故事的影响」；写明「主角战力 vs 天花板」的百分比差值，防战力崩坏 |
| 剧情子代理 | 主线与因果的总策划 | 用「节点法」出主线节点、转折点、伏笔台账；逐章写 memo；每个节点都写清「因为…所以…」的因果链，不拍脑袋硬写；主动埋伏笔 + 设计矛盾冲突 |
| 人物子代理 | 人物灵魂与说话风格的档案库 | 建「灵魂四维」档案（外在底色/隐性欲望/心理阈值/社交关系网）和「语言基因卡」（句子长短/口头禅/禁忌词/小动作）；拒绝贴标签，注重成长弧光，行为合情合理 |
| 文笔子代理 | 唯一执笔，专注不被干扰 | 先遵从其他代理的设定（宪法/伏笔/世界/人物），想突破须「破格申请」；文字易读不散文化、描写为突出人物、不直写情绪（用动作/环境暗示）；每章字数按开工时约定的篇幅设定执行 |
| 复核子代理 | 只挑错、不改写，立场客观 | 正文逐条对照所有设定；三色灯判决：🔴致命→打回重写并写清原因，🟡警告→改后过审，🟢通过；长篇走 33 维结构审计（JSON 落盘），额外验「水到渠成」、出【节奏建议】和【章末钩子】 |
安装方法
这是一个 DSH 预设插件：装好后，插件会把「多核协同写作模式」这个预设自动注册进 DSH，新建会话时直接选它就行。
方法一：插件安装（推荐）
在 DSH 命令行里执行下面这一行即可（Windows / macOS / Linux 通用）：
dsh plugin --profile web add github:sailoumili/novel-writer
装完后，重启或刷新 DSH web，新建会话时选「多核协同写作模式」即可。
方法二：手动安装（备选）
不想用命令行的话，也可以手动装：
一键脚本
Windows（PowerShell）：复制下面这一整行，粘贴回车，自动下载安装。
irm https://raw.githubusercontent.com/sailoumili/novel-writer/main/install.ps1 | iex
macOS / Linux（终端）：
curl -fsSL https://raw.githubusercontent.com/sailoumili/novel-writer/main/install.sh | bash
装完后，刷新或重启 DSH 页面，新建会话时选「多核协同写作模式」即可。
手动下载
- 点本仓库绿色
Code按钮 →Download ZIP，下载并解压。 - 把解压出来的文件夹改名为
novel-writer（GitHub 下载的文件夹名通常带-main后缀，要去掉）。 - 把这个
novel-writer文件夹放进 DSH 的预设目录：- Windows：
C:\Users\你的用户名\.dsh\.agent-presets\ - （
~/.dsh/.agent-presets/，~表示你的用户主目录）
- Windows：
- 刷新（或重启）DSH 页面。
- 新建会话时选 多核协同写作模式。
怎么用
选好预设后，直接发一句话给题材和核心梗概，例如：
题材：东方玄幻 + 克苏鲁融合。核心梗概：一个能看到别人「死亡倒计时」的猎户，如何在不被污染的前提下，拯救即将被旧日支配者吞噬的村庄。
队长会先加载内置的
novel-writing技能（工作室操作规程），然后按流程走，每一步都停下来等你确认，不会一口气乱写：- 先问清篇幅设定（总章数、每章字数、语言、修订门禁），自动落入「短篇锚点」或「长篇锚点」模式；
- 派「世界」和「剧情」开联席会，出《叙事宪法》草案和《世界白皮书》大纲 → 等你批准；
- 批准后派「人物」生成主要角色档案 → 存进本地文件；
- 派「复核」做设定评审（最多 3 轮），最后申请「写第一章」的许可 → 你同意才动笔。
它会读写文件，请注意
为了让档案和台账跨会话不丢，这个预设会给 AI 读写文件的权限。每开一个新小说，它会在你的工作区建一个项目文件夹（<book> 为项目名，开工时可带日期前缀）：
outputs/<book>/
├─ book.md 篇幅设定：题材/总章数/每章字数/修订门禁/模式
├─ story/
│ ├─ brief.md 你的原始创意（最高权威，永不修改）
│ ├─ constitution.md 叙事宪法：核心冲突、世界观铁律、禁用项、硬性约束
│ ├─ whitepaper.md 世界规则白皮书（含战力天花板与差值）+ 名词索引
│ ├─ outline.md 大纲（卷级地图 / 短篇逐章全量）
│ ├─ roles/<名>.md 每个角色的「灵魂四维 + 语言基因卡」档案
│ ├─ pending-hooks.md 伏笔台账（埋设/推进/回收状态，3 章未收预警）
│ ├─ current-state.md 状态卡（当前章节/位置/目标/冲突…）
│ ├─ chapter-summaries.md 章摘要表
│ └─ plans/ 逐章 memo（写正文前必先规划）
├─ chapters/
│ ├─ 0001_标题.md … 每章定稿（永远是最新版）
│ └─ index.md 章节目录：章/标题/状态/字数/审计分
├─ revisions/ 审稿报告、修订痕迹、废稿（0001_v1.md …）
└─ packaging/ 完结时的简介卖点包装
内置硬门禁脚本（skills/novel-writing/scripts/check.mjs）会程序校验每章字数区间和「去 AI 味」铁律（转折词密度、「不是…而是…」句式、破折号），过不了门禁不发下一章。
文件操作仍受 DSH 自带的沙箱策略约束，预设本身不会突破沙箱。
章节版本管理
- 每章定稿单独存文件：
chapters/000N_标题.md，这份永远是当章最新版。 - 改稿不覆盖：被打回重写或要求改稿时，旧版先移存
revisions/000N_vX.md（X 从 1 递增）留作废稿，新稿写回chapters/。 - 续写只认定稿：只读
chapters/里那份；废稿留着但不作数。 chapters/index.md记录每章状态、字数与审计分，续写前先读它定位。
想改它
- 队长的「大脑设定」在
agent.cordis.yml；完整的团队操作规程在skills/novel-writing/（SKILL.md + references/ + 校验脚本）。 - 已落地的预设在你本机的
~/.dsh/.agent-presets/novel-writer/，直接改那里的文件也行——插件只在文件不存在时落地，绝不覆盖你的修改。 - 想升级到插件自带的新版本：删掉
~/.dsh/.agent-presets/novel-writer/整个文件夹，重启 DSH 让插件重新落地一份全新的。 - 卸载插件（
dsh plugin --profile web remove novel-writer）不会删除已落地的预设文件。 - 想彻底删除：删掉
~/.dsh/.agent-presets/novel-writer/整个文件夹。