# char-vela

**Repository Path**: 75270093/char-vela

## Basic Information

- **Project Name**: char-vela
- **Description**: 为网文作者、独立作家与创意写作者设计的下一代 AI 驱动小说创作集成开发环境。。它将大语言模型驱动的全流程工作流（大纲生成、章节起草、智能重写、自动审阅）与本地 RAG 知识库深度融合，为作者提供 IDE 级别的沉浸式创作体验——所有数据和模型调用都运行在您自己的计算机上，使用您自己的 API Key (BYOK)。

- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-12
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🌌 Vela — AI Novel Writing IDE / AI 小说创作 IDE

**The next-generation AI-powered novel & fiction writing IDE for web novel authors, indie writers and creative professionals.**

**为网文作者、独立作家与创意写作者设计的下一代 AI 驱动小说创作集成开发环境。**

[![React](https://img.shields.io/badge/React-18-blue.svg)](https://reactjs.org/)
[![Electron](https://img.shields.io/badge/Electron-Latest-black.svg)](https://www.electronjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6.svg)](https://www.typescriptlang.org/)
[![License: GPL-3.0](https://img.shields.io/badge/License-GPLv3-yellow.svg)](https://opensource.org/licenses/GPL-3.0)

[🚀 下载客户端 / Download](#-安装与使用--installation) • [☕ 赞助作者 / Sponsor](#-赞助与支持--sponsor)

</div>

---

> **Vela** 是一款开源、隐私优先、本地优先的 AI 写作 IDE，专为**长篇小说创作 (Novel Writing)**、**网文写手 (Web Fiction)**与**创意写作 (Creative Writing)** 而生。它将大语言模型驱动的全流程工作流（大纲生成、章节起草、智能重写、自动审阅）与本地 RAG 知识库深度融合，为作者提供 IDE 级别的沉浸式创作体验——所有数据和模型调用都运行在您自己的计算机上，使用您自己的 API Key (BYOK)。

<!-- SEO: Vela is an open-source, privacy-first, local-first AI writing IDE purpose-built for novel writing, fiction writing, web novel creation, and long-form creative writing. It deeply integrates LLM-powered workflows with a local RAG knowledge base, giving authors an IDE-level creative experience — all running on your own machine with your own API keys (BYOK). -->

---

## 🎨 界面预览 / Screenshots

|<img src="public/screenshot/1.png" width="800" alt="Vela AI Novel Writing IDE - Main Editor Interface"/>|
|:---:|
|*沉浸式写作空间：编辑器 + AI 助手并排布局，支持 JetBrains/VSCode 级窗口管理*|
|*Immersive writing workspace with side-by-side AI panel, IDE-grade window management*|

|<img src="public/screenshot/2.png" width="800" alt="Vela AI Writing Workflow - Outline and Chapter Generation"/>|
|:---:|
|*全自动小说创作工作流：从世界观到正文的端到端 AI 管线*|
|*End-to-end AI novel writing pipeline: from worldbuilding to chapter generation*|

<details>
<summary><b>点击查看更多截图 / More Screenshots 📸</b></summary>
<br>

<img src="public/screenshot/3.png" width="800" alt="Vela AI Writer - Character Management and World Building"/>
<br/><br/>
<img src="public/screenshot/4.png" width="800" alt="Vela Novel IDE - AI Rewrite and Refinement Pipeline"/>
<br/><br/>
<img src="public/screenshot/5.png" width="800" alt="Vela Writing Tool - Local RAG Knowledge Base Search"/>
<br/><br/>
<img src="public/screenshot/6.png" width="800" alt="Vela Creative Writing IDE - Dark Theme Full View"/>

</details>

---

## ✨ 核心特性 / Key Features

Vela is not just another chat-based text editor — it is a **production-grade novel writing engine** that deeply integrates LLM capabilities, long-context retrieval (RAG), and automated pipelines for fiction authoring.

Vela 不是又一个带对话框的文本编辑器——它是一套深度融合了**大语言模型能力、长文本上下文检索 (RAG)、自动化创作管线**的专业级小说写作引擎。

---

### 🧬 1. AI 智能创作流水线 / AI-Powered Novel Writing Pipeline

从构思到定稿的全流程 AI 辅助管线：**构思 → 大纲 → 蓝图 → 写稿 → 修稿 → 审稿 → 定稿**，七站串联闭环。

| 能力 / Capability | 说明 / Description |
|---|---|
| 🌍 世界观与设定管理 (Worldbuilding) | 自定义全局世界观背景、核心剧情主轴、角色人设档案（含跨章节动态状态追踪） |
| 📋 自动大纲与细纲生成 (Auto Outline) | AI 一键生成「结构骨架 → 章节细纲 → 场景/情绪/节奏段落要求」，支持三幕式、英雄之旅等多种叙事结构 |
| ✍️ 流式章节正文生成 (Chapter Drafting) | 单章流式打字机生成，精准响应前文上下文与预设提纲，随时可中止 |
| 🔄 AI 智能重写 (Rewrite) | 支持选中段落局部重写或整章全局重写，保持人设与剧情一致性 |
| ✨ 语病与错别字精修 (Refine) | AI 自动检测语法错误、错别字、逻辑漏洞，输出精修建议 |
| 📝 剧情自评审阅 (Review) | AI 以读者/编辑视角对章节进行质量自评，指出节奏、人物弧光、伏笔等问题 |
| 🔁 三重后期管线 (Post-Process) | Rewrite → Refine → Review 三级串联闭环，确保每章高质量出稿 |

<p align="center">
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-07-00.png" width="30%" alt="创作流水线七站全景"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-07-05.png" width="30%" alt="AI核心三环绕"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-07-09.png" width="30%" alt="四层技术架构"/>
</p>

---

### 🧠 2. 百万字级本地知识库 / Million-Word Local RAG Knowledge Base

基于向量数据库的本地语义检索引擎，写作时自动召回最相关设定，告别"人设崩塌"。

| 能力 / Capability | 说明 / Description |
|---|---|
| 📂 海量设定导入 (Bulk Import) | 一键导入数百万字的参考小说、世界观文档、角色设定集 |
| 🔍 语义向量检索 (Vector Search) | 写作时根据当前章节语义自动召回最相关的设定切片 (Chunk)，告别人设崩塌与设定遗忘 |
| 🔒 纯本地存储 (Local-Only) | 内置 SQLite + 轻量向量引擎，所有数据存储在您的本地计算机，断网依然可用 |

<p align="center">
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-07-38.png" width="30%" alt="知识库中心辐线"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-07-42.png" width="30%" alt="写作检索交互"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-07-48.png" width="30%" alt="云端vs本地安全"/>
</p>

---

### 🔍 3. 叙事一致性系统 / Narrative Consistency System

六维自动检查引擎 + Canon 知识图谱，确保长篇小说中的人物、时间线、地点、物品等叙事要素始终一致。

| 能力 / Capability | 说明 / Description |
|---|---|
| 🔎 六维一致性检查 | 地点连续性、知识授权、时间线顺序、关系一致性、物品归属、前文衔接 |
| 🛠️ 自动检测与修复 | 高置信度自动修复 knowledge leak 和 location jump，输出诊断报告 |
| 📚 Canon 知识图谱 | 5 张专用表（时间线事件 / 角色状态 / 剧情线 / 事实条目 / 章节摘要）持续追踪叙事状态 |

<p align="center">
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-08-17.png" width="30%" alt="六维检查环"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-08-22.png" width="30%" alt="检测分析修复"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-08-27.png" width="30%" alt="Canon五层知识图谱"/>
</p>

---

### 🤖 4. AI Agent 对话系统 / AI Agent & MCP Integration

基于 ReAct 循环的智能 Agent，内置工具调用 + Skill 体系 + MCP 协议支持。

| 能力 / Capability | 说明 / Description |
|---|---|
| 🧭 ReAct 推理循环 | Agent 执行"思考 → 行动 → 观察 → 反思"四步推理，可调用工具、创建文件 |
| 🔧 工具注册系统 | 读取项目状态、搜索知识库、读写文件、启动工作流、更新配置等内置工具 |
| 🎯 Skill 三级体系 | 内置 Skill + 用户自定义 + 项目级 Skill，支持 Slash 命令和 @ 提及上下文引用 |
| 🔗 MCP 协议 (Model Context Protocol) | 原生集成 MCP 协议，随时外挂自定义工具服务器，扩展 AI 能力边界 |

<p align="center">
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-08-56.png" width="30%" alt="ReAct四步循环"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-09-10.png" width="30%" alt="工具与Skill体系"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-09-04.png" width="30%" alt="MCP外部集成"/>
</p>

---

### 🎛️ 5. 多模型智能调度 / Multi-Model Smart Routing

自带模型 (BYOK) + 智能分流：不同任务指派不同模型，获取最佳性价比。

| 能力 / Capability | 说明 / Description |
|---|---|
| 🤖 八大服务商支持 | 原生兼容 OpenAI、DeepSeek、Gemini、Claude、Ollama (本地离线)、智谱 GLM、MiniMax、SiliconFlow |
| 🧭 智能分流调度 | 按任务类型（创作/润色/总结/嵌入）自动路由到最优模型：用 DeepSeek 写大纲，用 Claude 润色，用本地模型做隐私审查 |
| 📊 用量统计 (Usage Analytics) | 内置 LLM 调用量、Token 消耗、成本趋势的完整统计面板，数据纯本地 |

<p align="center">
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-09-40.png" width="30%" alt="八大LLM中心"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-09-45.png" width="30%" alt="智能路由决策"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-09-50.png" width="30%" alt="用量统计面板"/>
</p>

---

### 🛠️ 6. IDE 级写作界面 / IDE-Grade Productivity UI

专业级集成开发环境体验：四分屏布局、多 Tab 管理、Diff 版本对比、深色/浅色双主题。

| 能力 / Capability | 说明 / Description |
|---|---|
| 🖥️ 可拖拽四分屏布局 (Resizable Panels) | 文件树 + 编辑器 + AI 面板 + 底部终端，像 VSCode/JetBrains 一样灵活组合 |
| 📑 多 Tab + Diff 对比 | 章节/大纲/角色/审稿报告等多 Tab 管理，Monaco Editor 驱动三路合并 (Three-Way Merge) |
| 🌙 主题与缩放 | 深色/浅色双主题 (Darcula Warm / IntelliJ Light)，全局 70%-150% 缩放，写作字体独立切换 |
| ⌨️ 快捷键体系 (Keyboard Shortcuts) | 全局快捷键：Cmd+N 新建、Cmd+O 打开、Cmd+=/- 缩放 |
| 📦 跨平台 (Cross-Platform) | macOS (dmg) / Windows (nsis) / Linux (AppImage) |

<p align="center">
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-10-20.png" width="30%" alt="四分屏布局"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-10-25.png" width="30%" alt="三路合并对比"/>
  <img src="local-tests/vela-core-features/assets/3D_material_illustration_in_Sw_2026-07-12T08-10-40.png" width="30%" alt="主题定制系统"/>
</p>

---

## 🚀 安装与使用 / Installation

### 方式一：直接下载 / Direct Download

前往 [Releases](https://github.com/heider-x/vela/releases) 下载对应操作系统的最新版本：
- **macOS**: `.dmg` 安装包
- **Windows**: `.exe` 安装程序 (NSIS)

### 方式二：源码构建 / Build from Source

```bash
# 环境要求：Node.js >= 18, pnpm >= 8

# 1. 克隆项目
git clone https://github.com/heider-x/vela.git
cd vela

# 2. 安装依赖
pnpm install

# 3. 启动开发服务器 (含热更新)
pnpm dev

# 4. 打包分发
pnpm build
```

> **Note**: 需要确保本地系统安装了构建 SQLite 的前置依赖（macOS: Xcode Command Line Tools, Windows: windows-build-tools）。

---

## ⚙️ 模型配置 / Model Configuration

Vela 支持接入多种主流 LLM 服务商，以下是快速配置步骤：

1. 打开应用 → 点击左下角 **⚙️ 设置**
2. 进入 **「模型配置」** 页面
3. 点击 **「新增模型」**：
   - 选择服务商：OpenAI / DeepSeek / Gemini / Ollama / 智谱 / 自定义
   - 填入 `API Key` 和 `Base URL`（如使用代理）
   - 为不同任务（写作 / 润色 / Embedding 检索）指派推荐模型
4. **开始创作！** 🎉

**支持的 LLM 服务商 / Supported LLM Providers:**

`OpenAI` · `DeepSeek` · `Google Gemini` · `Anthropic Claude` · `Ollama (Local)` · `智谱 GLM (Zhipu)` · `MiniMax` · `SiliconFlow` · `Any OpenAI-compatible API`

---

## 🤝 赞助与支持 / Sponsor

Vela 开源版由独立开发者利用业余时间热情驱动。如果这个工具有效提升了您的小说创作效率，欢迎扫码赞助！您的每一份支持都是我持续迭代的最大动力 ❤️

### 📢 微信群交流 / WeChat Group

<p align="left">
  <img src="public/buyme/group.png" width="300" alt="Vela 微信群 WeChat Group"/>
</p>

### 👤 技术交流与合作 / Contact

如果您对本项目的商业化落地（SaaS 授权）、AI 写作技术实现或产品方向感兴趣，欢迎扫码加我个人微信：

<p align="left">
  <img src="public/buyme/wechat.jpg" width="200" alt="个人微信 Author WeChat"/>
</p>

### 💰 赞助二维码 / Donate QR Codes

<p align="left">
  <img src="public/buyme/wepay.jpg" width="200" alt="微信赞助 WeChat Donate"/>
  &nbsp;&nbsp;&nbsp;
  <img src="public/buyme/alipay.jpg" width="200" alt="支付宝赞助 Alipay Donate"/>
</p>

### 🎁 推荐 API 服务商 / Recommended API Providers

以下是经过测试、与 Vela 完美兼容的 API 服务商，使用推荐链接注册可享受专属优惠，同时也是对本项目的支持：

* **智谱 AI (GLM Coding)**：国内顶流编程大模型，20+ 主流工具全适配 👉 [立即参与「拼好模」](https://www.bigmodel.cn/glm-coding?ic=7IJ2G7AE6W)
* **MiniMax (海螺 AI)**：Token Plan 含语音/视频/生图权益，新用户 **9折** 优惠 👉 [立即订阅](https://platform.minimaxi.com/subscribe/token-plan?code=EjhLD7uCvT&source=link)

---

## 🏗️ 技术架构 / Tech Stack

| 层级 / Layer | 技术 / Technology |
|---|---|
| **UI 框架** | React 18 + TypeScript + Zustand |
| **样式** | Tailwind CSS + Radix UI + Lucide Icons |
| **桌面端** | Electron + Vite |
| **本地存储** | better-sqlite3 (关系型) + 轻量向量引擎 (RAG) |
| **IPC 通信** | 强类型频道契约 (Type-safe IPC Channels) |
| **AI 集成** | OpenAI-compatible + Gemini Protocol + MCP |

---

## 🙋‍♂️ 参与贡献 / Contributing

我们欢迎来自社区的代码贡献，包括但不限于：
- 🐛 Bug 修复
- 🤖 新 AI 服务商适配
- 🎨 UI/UX 改进
- 🌐 国际化 (i18n) 翻译
- 📖 文档完善

> 重大功能重构请先在 [Issues](https://github.com/heider-x/vela/issues) 中与作者探讨，以避免方向冲突。

---

## 📄 开源协议 / License

本项目采用 [GPL-3.0 License](LICENSE) 开源。您可以自由地运行、研究、分享和修改代码，但基于此修改分发的新软件**必须同样遵循 GPL-3.0 协议开源**。

如需闭源商用授权，请通过微信或邮件联系作者。

---

<div align="center">

**Crafted with 💡 by [heider-x]([https://github.com/heider](https://github.com/heider-x))**

*Vela — Your AI-powered novel writing companion. Write smarter, not harder.*

*Vela — 你的 AI 小说创作伙伴。让写作更智能，而非更辛苦。*

</div>

<!-- 
  SEO Keywords (GitHub indexed): 
  AI novel writing, AI writer, novel writing tool, fiction writing software, 
  web novel, 网文写作, AI小说, 小说创作工具, creative writing IDE, 
  AI story generator, novel outline generator, RAG knowledge base,
  LLM writing assistant, Electron writing app, open source writing tool,
  DeepSeek writing, Claude writing, Ollama writing, BYOK AI,
  AI 写作助手, 网文生成器, 小说大纲生成, AI创作, 长篇小说写作
-->