# novel

**Repository Path**: asialjim/novel

## Basic Information

- **Project Name**: novel
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# InkFlow

综合 AI 网文创作系统 —— 多 Agent 仿真驱动的小说生成引擎。

故事不是由一个 AI 写出来的，而是多个独立角色 Agent、天道 Agent、故事顾问互相博弈、交互涌现的结果。

## 快速开始

```bash
# 安装
pnpm install
pnpm build

# 创建项目（交互式讨论模式）
node packages/cli/dist/index.js init

# 或快速创建
node packages/cli/dist/index.js init --quick "书名" --genre 玄幻

# 冷启动（生成模板和角色画像）
node packages/cli/dist/index.js bootstrap

# 写一章
node packages/cli/dist/index.js write

# 启动 Web 工作台
pnpm start        # 生产模式（端口 3100）
pnpm dev          # 开发模式（前端热更新，端口 5173）
```

## 配置 LLM

在项目 `books/{slug}/.env` 中配置。支持任意 OpenAI 兼容协议的供应商（DeepSeek、Kimi、Qwen、Zhipu、Doubao...），以及 Ollama 本地模型。

```bash
# 全局默认
DEFAULT_PROVIDER=deepseek
DEFAULT_MODEL=deepseek-chat
INKFLOW_API_KEY=sk-your-key

# 按任务独立配置（覆盖全局默认值）
TASK_PROSE_WRITER_PROVIDER=kimi
TASK_PROSE_WRITER_MODEL=moonshot-v1-8k
TASK_PROSE_WRITER_REASONING=true

TASK_DISTILLER_PROVIDER=deepseek
TASK_DISTILLER_MODEL=deepseek-chat
TASK_DISTILLER_REASONING=false

# Ollama 本地模型
# TASK_WRITER_PROVIDER=ollama
# TASK_WRITER_MODEL=qwen2.5:14b
```

## CLI 命令

| 命令 | 说明 |
|------|------|
| `init` | 创建新项目（交互式讨论 / --quick 快速模式） |
| `bootstrap` | 冷启动：生成角色画像、模板、契约 |
| `write` | 写下一章（自动推进章号） |
| `studio` | 启动 Web 工作台 |
| `radar` | 长程叙事一致性扫描 |
| `rollback <n>` | 回滚到第 n 章 |
| `export` | 导出 TXT |
| `react --event "..."` | 调试：模拟角色对事件的反应 |
| `react --trace --chapter <n>` | 调试：查看章节决策追溯 |

## 项目结构

```
inkflow/
├── packages/
│   ├── core/              # Agent 内核、状态机、LLM 客户端
│   ├── cli/               # CLI 入口
│   ├── server/            # Web API + SSE 服务器
│   ├── studio/            # React 前端 SPA
│   ├── reaction-engine/   # 故事剧情推动引擎
│   ├── auditor/           # 33 维审计 + 雷达 + Revisor
│   ├── distiller/         # 正文 → 角色画像蒸馏
│   ├── skill-compiler/    # 画像 → 可执行技能编译
│   ├── truth-files/       # 真相文件 Zod Schema
│   ├── causal-engine/     # 因果链 + 事件链管理
│   ├── evolution-engine/  # 角色画像演化
│   ├── conflict-detector/ # 角色需求冲突检测
│   ├── tui/               # 终端仪表盘
│   └── vault-sync/        # Obsidian 双向同步
├── docs/                  # 文档
├── books/                 # 用户项目（gitignore）
└── DESIGN.md              # 完整设计文档
```

## 架构

```
大道（作者）— 最高权限
  ↓
叙事智能层 — 故事顾问 + 长程雷达
  ↓
故事剧情推动引擎 — 天道 Agent + 角色 Agents
  ↓
正文写作引擎 — 事件流 → 小说正文
  ↓
质量闭环层 — 33 维审计 + 定点修复
  ↓
记忆与知识层 — 真相文件 + SQLite + 向量库
```

## 技术栈

| 层 | 选型 |
|----|------|
| 语言 | TypeScript |
| 运行时 | Node.js >= 20 |
| 包管理 | pnpm workspace |
| 前端 | React 19 + Vite 6 + Tailwind 4 + Zustand |
| 后端 | Express 5 + SSE |
| LLM | OpenAI 兼容协议 + Ollama 原生协议 |
| 存储 | JSON + Zod + SQLite (better-sqlite3) |
| RAG | Python (LangChain / Jina) — 待完善 |

## License

MIT