novel-writer

Readme

# 多核协同写作模式

> [English](./README.en.md) | 简体中文

一个装在 [DeepSeek Harness（DSH）](https://github.com/deepseek-ai) 里的**多智能体小说创作模式**：一个「统筹队长」统领全局，5 个专职子代理各司其职——架构世界、策划剧情、管理人物、执笔写文、质检复核。新建会话时选它，就能用这支各就各位的「创作工作室」把一部小说从构思一路写到成稿。

## 这是什么

它不是只会聊天的 AI，而是一支**分工明确的 6 人小说工作室**——由**一个「队长」统领全局，5 个「专职子代理」各干各的活**。和「一个 AI 轮流演 6 个角色」不同，这里每个岗位是独立的：写正文的只写正文、挑错的只挑错、管世界的只管世界，每个子代理脑子里只装它那一份活，互不干扰，所以更专注、不串味。

| 角色 | 优势 | 干什么 |
| --- | --- | --- |
| 统筹队长 | 专职总指挥，不写稿，能客观拍板 | 派单；控节奏、终裁分歧、签发定稿；同一章被连续 3 次打回时，召集全体重新校准《叙事宪法》 |
| 世界子代理 | 世界背景与专有名词的唯一权威 | 产出《世界规则白皮书》和《名词索引附录》；每条设定都展开成「是什么 + 为什么 + 对故事的影响」；写明「主角战力 vs 天花板」的百分比差值，防战力崩坏 |
| 剧情子代理 | 主线与因果的总策划 | 用「节点法」出主线节点、转折点、伏笔台账；每个节点都写清「因为…所以…」的因果链，不拍脑袋硬写；主动埋伏笔 + 设计矛盾冲突 |
| 人物子代理 | 人物灵魂与说话风格的档案库 | 建「灵魂四维」JSON（外在底色/隐性欲望/心理阈值/社交关系网）和「语言基因卡」（句子长短/口头禅/禁忌词/小动作）；拒绝贴标签，注重成长弧光，行为合情合理 |
| 文笔子代理 | 唯一执笔，专注不被干扰 | 先遵从其他代理的设定（宪法/伏笔/世界/人物），想突破须「破格申请」；文字易读不散文化、描写为突出人物、不直写情绪（用动作/环境暗示）；每章约 2000–4000 字 |
| 复核子代理 | 只挑错、不改写，立场客观 | 正文逐条对照所有设定；三色灯判决：🔴致命→打回重写并写清原因，🟡警告→改后过审，🟢通过；额外验「水到渠成」、出【节奏建议】和【章末钩子】 |

## 安装方法

这是一个 **DSH 预设插件**：装好后，插件会把「多核协同写作模式」这个预设**自动注册进 DSH**，新建会话时直接选它就行。

### 方法一：插件安装（推荐）

在 DSH 命令行里执行下面这一行即可（Windows / macOS / Linux 通用）：

```
dsh plugin --profile web add github:sailoumili/novel-writer
```

装完后，**重启或刷新 DSH web**，新建会话时选「多核协同写作模式」即可。

### 方法二：手动安装（备选）

不想用命令行的话，也可以手动装：

#### 一键脚本

Windows（PowerShell）：复制下面这一整行，粘贴回车，自动下载安装。

```powershell
irm https://raw.githubusercontent.com/sailoumili/novel-writer/main/install.ps1 | iex
```

macOS / Linux（终端）：

```bash
curl -fsSL https://raw.githubusercontent.com/sailoumili/novel-writer/main/install.sh | bash
```

装完后，**刷新或重启 DSH 页面**，新建会话时选「多核协同写作模式」即可。

#### 手动下载

1. 点本仓库绿色 `Code` 按钮 → `Download ZIP`，下载并解压。
2. 把解压出来的文件夹**改名为 `novel-writer`**（GitHub 下载的文件夹名通常带 `-main` 后缀，要去掉）。
3. 把这个 `novel-writer` 文件夹放进 DSH 的预设目录：
   - Windows：`C:\Users\你的用户名\.dsh\.agent-presets\`
   - （`~/.dsh/.agent-presets/`，`~` 表示你的用户主目录）
4. 刷新（或重启）DSH 页面。
5. 新建会话时选 **多核协同写作模式**。

## 怎么用

1. 选好预设后，直接发一句话给题材和核心梗概，例如：

   > 题材：东方玄幻 + 克苏鲁融合。核心梗概：一个能看到别人「死亡倒计时」的猎户，如何在不被污染的前提下，拯救即将被旧日支配者吞噬的村庄。

2. 队长会走三步流程，**每一步都停下来等你确认**，不会一口气乱写：
   - 派「世界」和「剧情」开联席会，出《叙事宪法》草案和《世界白皮书》大纲 → 等你批准；
   - 批准后派「人物」生成主要角色档案 → 存进本地文件；
   - 最后申请「写第一章」的许可 → 你同意才动笔。

## 它会读写文件，请注意

为了让档案和台账跨会话不丢，这个预设会给 AI **读写文件的权限**。每开一个新小说，它会在你的工作区建一个项目文件夹：

```
outputs/日期-项目名/
├─ 叙事宪法.md        核心冲突、禁用项、硬性约束
├─ 世界规则白皮书.md   世界设定全记录（含战力天花板与差值）
├─ 人物档案.json      每个角色的「灵魂四维」档案
├─ 伏笔台账.md        所有伏笔的埋设/回收状态表
├─ 章节目录.md        每章最新版本 + 一句话梗概
├─ 第1章-v1.md        第一章正文（带版本号）
└─ 第1章-v2.md        改过的第二版……
```

文件操作仍受 DSH 自带的沙箱策略约束，预设本身不会突破沙箱。

## 章节版本管理

- 每章正文**单独存文件**，带版本号：`第N章-vX.md`（N=第几章，X=第几版，从 v1 开始）。
- **改稿不覆盖**：被打回重写或要求改稿时存成 `第1章-v2.md`，旧版留作废稿。
- **续写只认最新版**：只读每章版本号最大的那份。

## 想改它

- 完整提示词（「大脑设定」）在 `agent.cordis.yml`。
- 改完保存，下次开新会话生效。
- 卸载插件（`dsh plugin --profile web remove novel-writer`）不会删除已落地的预设文件。
- 想彻底删除：删掉 `~/.dsh/.agent-presets/novel-writer/` 整个文件夹。

## 许可

[MIT](./LICENSE)