# ai-writer-open-source

**Repository Path**: jiangqiang1996/ai-writer-open-source

## Basic Information

- **Project Name**: ai-writer-open-source
- **Description**: ai-writer开源版本，2026-08-08最新版本，后续根据情况继续同步最新版本
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-08
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小说创作工作区

本项目是小说创作工作区。核心机制：**代理仅树立人设，技能限制流程**。

- 主代理 = 人设/文风（切换主代理 = 切换正文文风）
- 技能 = 流程与规则（加载技能即按流程执行）
- 设计流程固定使用 architect；正文写作使用对应的文风写作主代理

## 主代理与适用场景

### 写作主代理（11 个，模仿确切作家）

| 代理 | 类型 | 锚定作家 | 代表作依据 |
|------|------|---------|-----------|
| `xuanhuan-writer` | 玄幻 | 天蚕土豆 | 《斗破苍穹》 |
| `xianxia-writer` | 仙侠修真 | 忘语 | 《凡人修仙传》 |
| `dushi-writer` | 都市 | 阿耐 | 《大江大河》 |
| `xuanyi-writer` | 悬疑推理 | 紫金陈 | 《坏小孩》 |
| `lingyi-writer` | 灵异盗墓 | 天下霸唱 | 《鬼吹灯》 |
| `kehuan-writer` | 科幻 | 刘慈欣 | 《三体》 |
| `lishi-writer` | 历史古代 | 马伯庸 | 《长安十二时辰》 |
| `wuxia-writer` | 武侠 | 金庸 | 《射雕英雄传》 |
| `yanqing-writer` | 女频言情 | 顾漫 | 《何以笙箫默》 |
| `jingji-writer` | 游戏竞技 | 蝴蝶蓝 | 《全职高手》 |
| `xianshi-writer` | 现实/年代/纯文学 | 余华 | 《活着》 |

> 各写作主代理模仿对应作家的文笔与写作手法，**禁止复制原文句子**。Tab 切换到哪个写作主代理，正文就产出哪种文风。

### 非写作主代理

| 代理 | 用途 |
|------|------|
| `architect` | 设计专用：故事/大纲/细纲/封面设计（无文风、不写正文） |
| `engineer` | 资产维护：只维护 `.opencode/`、AGENTS.md、README.md、opencode.json |

## 设计流程用哪个主代理（重要）

| 任务 | 使用主代理 |
|------|-----------|
| 故事设计（基础设定） | **architect** |
| 封面设计 | **architect** |
| 大纲设计 | **architect** |
| 细纲设计 | **architect** |
| 正文写作 | **对应的写作主代理**（如玄幻用 xuanhuan-writer） |
| 设计类审查（基础设定/封面/大纲/细纲） | **architect** |
| 正文审查 + 修复 | **写作主代理**（修复保持当前文风） |

## 常用命令

| 命令 | 绑定代理 | 用途 |
|------|---------|------|
| `/design-story --novel <书名> --seed <种子构思>` | architect | 小说设计（四份基础设定） |
| `/design-cover --novel <书名> [--author <署名>]` | architect | 封面提示词设计 |
| `/design-outline --novel <书名>` | architect | 大纲设计 |
| `/design-detailed-outline --novel <书名> --chapters <N-M>` | architect | 细纲设计（逐章） |
| `/write-chapters --novel <书名> --chapters <N-M>` | 当前主代理 | 逐章写作（自动审查修复） |
| `/write-short-novel --novel <书名>` | 当前主代理 | 短篇单文件生成（一次性生成完整短篇到 story.txt，自动审查修复） |
| `/rewrite-chapters --novel <书名> --chapters <N\|all>` | 当前主代理 | 正文重写（不参考现有正文，从零重写；长篇单章/短篇全篇） |
| `/review-story-design --novel <书名>` | architect | 基础设定审查 + 修复 |
| `/review-cover --novel <书名>` | architect | 封面审查 + 修复 |
| `/review-outline --novel <书名> [--chapters <范围>]` | architect | 大纲审查 + 修复（单章/范围/全部） |
| `/review-detailed-outline --novel <书名> --chapters <N|N-M|all>` | architect | 细纲审查 + 修复（单章/范围/全部） |
| `/review-chapters --novel <书名> [--chapters <范围>]` | 当前主代理 | 正文审查 + 修复（逐章串行） |
| `/review-short-novel --novel <书名>` | 当前主代理 | 短篇单文件正文审查 + 修复（整篇审查 story.txt） |

上述命令均支持自然语言参数。可以直接描述目标、章节范围或关注点；系统会先提取并标准化参数，信息缺失或存在歧义时会要求补充，不会擅自猜测。

## 完整工作流程

### 新建一本小说（全程在 architect 下）

```
/design-story --novel 书名 --seed "种子构思"  # 基础设定 → 自动审查修复
/design-cover --novel 书名        # 封面提示词 → 自动审查
/design-outline --novel 书名      # 全书大纲 → 自动审查修复
/design-detailed-outline --novel 书名 --chapters 1-10   # 逐章细纲 → 自动审查修复
```

### 连载写作（Tab 切到目标类型写作主代理）

```
/write-chapters --novel 书名 --chapters 3-30   # 逐章写作（当前主代理文风）→ 自动正文审查修复
```

### 短篇单文件生成（Tab 切到目标类型写作主代理）

```
/write-short-novel --novel 书名   # 一次性生成完整短篇到 story.txt（当前主代理文风）→ 自动正文审查修复
```

> 短篇有两种生成模式：① 分章模式 `/write-chapters`（逐章写作到 chapters/chapter-NN.txt）；② 单文件模式 `/write-short-novel`（一次性生成完整短篇到 story.txt，单文件多章节格式）。两者均校验全书总字数 6,000-40,000，有大纲无细纲。

### 批量审查

```
设计类：architect 下分别运行 `/review-story-design --novel 书名`、`/review-cover --novel 书名`、`/review-outline --novel 书名` 或 `/review-detailed-outline --novel 书名 --chapters 范围`
正文类：写作主代理下 `/review-chapters --novel 书名 --chapters 1-10`
```

## 目录结构

```
README.md                     # 本使用手册
AGENTS.md                     # 全局底线（管线/规模/运行模式/工具/修复方向/等级/结构/格式/边界）
opencode.json                 # 配置
merge-chapters.js             # 章节合并脚本（框架脚本）
.opencode/
  agents/                     # 13 主代理 + 7 审查子代理 + 4 可选设计子代理 + 1 资产审查子代理
  skills/                     # 14 技能（SKILL.md + references/ 模板）
  commands/                   # 15 命令
  tools/                      # word-count / format-check / report-path
  sync-check.js               # 共享模板一致性校验
novels/                       # 小说产物（正文/细纲/大纲/设定/story-bible）
reviews/                      # 审查报告（临时产物）
```

## 常见问题

- **如何切换文风？** Tab 循环切换主代理；写作命令不绑定代理，用当前主代理执行。
- **设计任务找不到人？** 设计流程固定在 architect 下，与文风无关。
- **审查后正文文风变化？** 正文审查与修复由写作主代理执行，修复保持当前文风；请确认在对应文风主代理下运行 `/review-chapters`。