# self_novel_system

**Repository Path**: AbelKeith/self_novel_system

## Basic Information

- **Project Name**: self_novel_system
- **Description**: 全模态，从小说到最终的视频衍生资源，一站式工作流，集成式IDE
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-01
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Self Novel System - AI 辅助小说创作工具

**版本**: v6.0 (多模态 AI 集成版)  
**状态**: 开发中 (Phase 1)

---

## 产品愿景

面向中长篇小说作者的桌面 AI 辅助创作工具，遵循 **"一切皆文件"** 的 Unix 哲学，提供透明、可迁移、可版本化的本地创作环境。

### 核心价值

| 价值 | 说明 |
|------|------|
| **数据主权** | 所有数据以人类可读文件存储（Markdown / YAML），无云锁定，可 Git 管理 |
| **AI 深度融合** | 多智能体协作（记忆、规划、生成、审核），非简单续写 |
| **设定即资产** | 人物/场景/道具/组织/概念一体化管理，与正文无缝联动 |
| **轻量高性能** | Tauri + Rust 内核，约 10MB 安装包 |

---

## 技术栈

| 模块 | 技术 | 说明 |
|------|------|------|
| 桌面壳 | Tauri 2.x (Rust) | ~10MB 安装包，高性能 |
| 前端框架 | React 18 + TypeScript + Vite | HMR 快，生态成熟 |
| 状态管理 | Zustand | 轻量、去中心化 |
| 编辑器 | TipTap (ProseMirror) | 富文本 + Markdown 双向 |
| 样式 | Tailwind CSS + Radix UI | 快速 UI + 无障碍组件 |
| 关系图 | React Flow | React 原生图可视化 |
| Markdown 解析 | pulldown-cmark (Rust) | GFM 标准 |
| AI 文本 | Provider 适配层 | OpenAI / Claude / Ollama / MiniMax |
| AI 多模态 | MultiModal Provider | 图像 / 音乐 / 视频生成 |

---

## 系统架构

```
┌─────────────────────────────────────────────────────────┐
│                   React 18 + TypeScript                  │
│      UI 状态、编辑器、路由、Zustand 状态管理             │
├─────────────────────────────────────────────────────────┤
│                   Tauri IPC (invoke)                    │
│        命令桥接层：前端调用 Rust 后端                    │
├─────────────────────────────────────────────────────────┤
│                      Rust 后端                          │
│  ┌──────────┬──────────┬──────────┬──────────┐       │
│  │  文件 IO  │ 全文索引 │ AI 文本  │ AI 多模态│       │
│  │  (核心)   │ (tantivy)│ (Provider│ (Multi-  │       │
│  │          │          │  适配层) │  Modal)  │       │
│  └──────────┴──────────┴──────────┴──────────┘       │
└─────────────────────────────────────────────────────────┘
```

---

## 功能特性

### Phase 1 - 基础可用

- [x] **项目管理** - 创建/打开/切换小说项目，支持模板系统
- [x] **大纲编辑器** - 卷 → 章 → 场景三级结构，拖拽重排
- [x] **富文本编辑器** - TipTap 驱动，强制分章编辑
- [x] **11 种核心卡片** - 作品标签、金手指、梗概、大纲、世界观、蓝图等
- [x] **自动保存** - 1.5s 防抖自动保存，脏标记，保存状态指示器
- [x] **快捷键系统** - Ctrl+S/Z/N/F 等常用快捷键
- [x] **Tab 分组导航** - 创作/设定/AI/管理 四组 Tab
- [x] **暗色模式** - 支持明暗主题切换

### Phase 1b - 卡片补全

- [ ] **实体卡片** - 角色、场景、物品、组织、概念
- [ ] **关系图谱** - React Flow 可视化，24 种关系类型
- [ ] **伏笔管理** - 伏笔埋下/回收追踪
- [ ] **知识库系统** - 文风约束、起名指南

### Phase 2 - AI 核心

- [ ] **Provider 适配层** - OpenAI / Claude / Ollama
- [ ] **@DSL 上下文注入** - 7 种引用语法
- [ ] **提示词管理** - 39 个模板
- [ ] **快照系统** - 手动 + 自动备份

### Phase 2b - 多模态 AI

- [ ] **文生图** - 角色立绘、场景插图
- [ ] **图生图** - 角色变体、风格迁移
- [ ] **提示词自动生成** - 从小说内容自动提炼提示词
- [ ] **资产管理** - 角色三视图、场景插图管理

### Phase 3+ - 高级功能

- [ ] **工作流引擎** - 兼容扣子/Dify/LangGraph
- [ ] **记忆提取** - 6 类提取器自动从章节提取信息
- [ ] **审核体系** - 通用/阶段/章节三层审核
- [ ] **全文搜索** - tantivy 索引
- [ ] **音乐/视频生成** - Suno/Runway/Sora 集成
- [ ] **导出** - epub/docx/pdf

---

## 项目结构

```
self_novel_system/
├── src/                          # React 前端
│   ├── app/                     # App 层：Provider、全局配置
│   ├── pages/                   # Pages 层：每个 Tab 对应页面
│   ├── widgets/                 # Widgets 层：页面内的复合区域
│   ├── features/                # Features 层：用户交互逻辑
│   ├── entities/                # Entities 层：业务实体组件
│   └── shared/                  # Shared 层：工具函数、原子组件
├── src-tauri/                   # Rust 后端
│   └── src/
│       ├── commands/            # Tauri 命令入口
│       ├── domain/              # 纯数据结构
│       ├── service/             # 业务逻辑
│       ├── storage/             # 文件 IO
│       └── ai/                  # AI Provider 适配层
├── docs/                        # 设计文档
└── design-prototype.html        # 原型设计
```

---

## 开发状态

| 阶段 | 目标 | 状态 |
|------|------|------|
| Phase 0 | 技术原型 | ✅ 完成 |
| Phase 1 | 基础可用 | 🔄 开发中 |
| Phase 1b | 卡片补全 | ⏳ 待开发 |
| Phase 2 | AI 核心 | ⏳ 待开发 |
| Phase 2b | 多模态 AI | ⏳ 待开发 |
| Phase 3 | 工作流引擎 | ⏳ 待开发 |

---

## 快速开始

### 环境要求

- Node.js 18+
- Rust 1.70+
- macOS / Windows / Linux

### 安装依赖

```bash
# 前端依赖
npm install

# Rust 依赖（自动通过 Cargo）
cargo build
```

### 开发模式

```bash
# 同时启动前端和后端
npm run tauri dev
```

### 构建发布

```bash
npm run tauri build
```

---

## 数据存储

所有数据以人类可读文件存储在项目目录 `.novel/` 下：

```
your_novel/
└── .novel/
    ├── meta.yaml              # 项目元数据
    ├── manuscript/             # 章节正文
    │   ├── volume-1/
    │   │   └── chapter-1.md
    │   └── volume-1.yaml
    ├── codex/                 # 设定集
    │   ├── characters/         # 角色卡
    │   ├── locations/         # 场景卡
    │   └── _index.yaml
    ├── relations/             # 关系图谱
    └── snapshots/             # 快照备份
```

---

## 设计文档

- [系统设计规范](docs/superpowers/specs/2026-05-27-self-novel-system-design.md)
- [MVP 分期计划](docs/superpowers/specs/mvp-phasing-plan.md)
- [数据结构设计](docs/superpowers/specs/data-structure-spec.md)

---

## 许可证

MIT License