OpenCode AI Novel Factory

A complete AI novel writing system plugin for OpenCode.

Features

• Multi-Agent collaborative writing
• Semi-automated chapter generation
• Automatic memory maintenance
• Long-form serialized writing support
• Commercial-grade writing structure

Can stably support 100+ chapters of creation.

Installation

🤖 AI 引导式完整安装（强烈推荐）

在 OpenCode 中说一句话：

请帮我安装和配置完整的 AI Novel Factory

AI 将引导你完成：

1. ✅ 环境检查（Node.js/npm）
2. ✅ 插件安装（npm）
3. ✅ OpenCode 配置（opencode.json）
4. ✅ 项目初始化（可选）
5. ✅ 世界观创建（可选）

或者直接运行完整安装脚本：

curl -fsSL https://raw.githubusercontent.com/tianxia--/ai-novel-factory/main/ai-guided-complete-install.sh | bash

🚀 一键项目安装

在 OpenCode 中运行：

curl -fsSL https://raw.githubusercontent.com/tianxia--/ai-novel-factory/main/install-inline.sh | bash

安装完成后，插件会自动配置 opencode.json 文件，无需手动操作。

📦 标准 npm 安装

npm install -g opencode-ai-novel-factory

然后让 AI 助手自动配置：

请帮我配置 opencode.json 添加 opencode-ai-novel-factory 插件

🛠️ 手动配置

如果需要手动配置，在 opencode.json 中添加：

{
  "plugin": ["opencode-ai-novel-factory"]
}

🔧 单独配置脚本

运行专门的配置脚本（AI 可引导用户执行）：

curl -fsSL https://raw.githubusercontent.com/tianxia--/ai-novel-factory/main/setup-opencode.sh | bash

📁 本地开发安装

克隆仓库：

git clone https://github.com/tianxia--/ai-novel-factory.git

在 opencode.json 中配置本地路径：

{
  "plugin": ["./path/to/ai-novel-factory/packages/opencode-ai-novel-factory"]
}

Quick Start

1. Initialize Project

🤖 让 AI 助手引导你完成初始化：

在 OpenCode 中输入：

请帮我初始化 AI 小说工厂项目

AI 助手将自动：

1. 创建完整的目录结构
2. 生成所有必要的模板文件
3. 引导你填写核心设定

或者手动运行：

@novel-init

手动创建目录结构：

studio/
├── agents/
├── automation/
├── memory/
├── story/
├── characters/
├── style/
├── production/chapters/
└── state/

2. Fill in Basic Settings

🤖 让 AI 助手引导你填写设定：

在 OpenCode 中输入：

请帮我创建小说的世界观设定

AI 助手将引导你逐步填写：

1. studio/story/world.md - 世界观设定
2. studio/story/master_outline.md - 主线大纲
3. studio/characters/protagonist.md - 主角设定
4. studio/style/*.md - 文风指南（可选）

或者按顺序手动填写上述文件。

3. Start Writing

@daily_pipeline

Available Agents

| Agent | Purpose | |-------|---------| | @story_architect | Create world-building | | @volume_planner | Generate volume outline | | @writer | Write chapter content | | @editor | Quality review | | @memory_keeper | Maintain memory system |

Available Skills

| Skill | Purpose | |-------|---------| | @daily-pipeline | One-click chapter generation |

Available Tools

| Tool | Purpose | |------|---------| | novel-init | Initialize project structure | | novel-chapter | Generate new chapter | | novel-memory-update | Update memory files | | novel-consistency-check | Check consistency | | novel-status | Show project status |

Directory Structure

studio/
├── agents/              # Agent definitions
├── automation/          # Automation configs
├── memory/              # Memory system (core)
│   ├── canon.md              # Core settings (unbreakable)
│   ├── world_rules.md        # World rules
│   ├── characters_evolution.md # Character growth log
│   └── foreshadowing.md      # Foreshadowing tracking
├── story/               # Story outlines
│   ├── world.md             # World settings
│   └── master_outline.md    # Main outline
├── characters/          # Character settings
│   ├── protagonist.md       # Protagonist
│   └── character_template.md # Character template
├── style/               # Style control
│   ├── tone.md              # Overall tone
│   ├── rhythm.md            # Sentence rhythm
│   └── dialogue.md          # Dialogue style
├── production/          # Output directory
│   └── chapters/            # Chapter content
└── state/               # State management
    ├── current_chapter.txt   # Current chapter number
    └── pipeline_config.txt   # Pipeline configuration

Memory System

The memory system is the core stabilizer for long-form writing:

• canon.md: Unchangeable core settings
• world_rules.md: Expandable but bounded rules
• characters_evolution.md: Character growth tracking
• foreshadowing.md: Foreshadowing management

Anti-Collapse Strategies

To ensure long-form stability:

• Power Control: Cannot break world_rules upper limit
• Character Protection: Behavior must match growth trajectory
• Timeline Validation: Update logical timeline each chapter
• Foreshadowing Tracking: All unresolved foreshadowing must be recorded

Workflow

Daily Creation

@daily_pipeline

This automatically:

1. Analyzes recent chapters
2. Generates next chapter plan
3. Writes chapter content
4. Checks style consistency
5. Updates memory system

Quality Control

Every 5 chapters, run:

@editor [chapter range]

Configuration

Edit studio/state/pipeline_config.txt:

target_word_count=2500
auto_skip_check=false
auto_memory_update=true
max_continuous_chapters=5
quality_threshold=7
style_check=true
consistency_check=true

License

MIT

Author

tianxia--

Links

• GitHub
• OpenCode