vela

skill
Security Audit
Fail
Health Pass
  • License — License: GPL-3.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 17 GitHub stars
Code Fail
  • process.env — Environment variable access in electron/controllers/llm-controller.ts
  • exec() — Shell command execution in electron/database.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

AI-powered IDE for novel writing — local LLM + RAG, privacy-first, BYOK. For web fiction authors and creative writers.

README.md

🌌 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
Electron
TypeScript
License: GPL-3.0

🚀 下载客户端 / Download☕ 赞助作者 / Sponsor


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


🎨 界面预览 / Screenshots

Vela AI Novel Writing IDE - Main Editor Interface
沉浸式写作空间:编辑器 + AI 助手并排布局,支持 JetBrains/VSCode 级窗口管理
Immersive writing workspace with side-by-side AI panel, IDE-grade window management
Vela AI Writing Workflow - Outline and Chapter Generation
全自动小说创作工作流:从世界观到正文的端到端 AI 管线
End-to-end AI novel writing pipeline: from worldbuilding to chapter generation
点击查看更多截图 / More Screenshots 📸
Vela AI Writer - Character Management and World Building

Vela Novel IDE - AI Rewrite and Refinement Pipeline

Vela Writing Tool - Local RAG Knowledge Base Search

Vela Creative Writing IDE - Dark Theme Full View

✨ 核心特性 / 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)、自动化创作管线的专业级小说写作引擎。

🧬 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 三级串联闭环,确保每章高质量出稿

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

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

🔌 极致可扩展架构 / Extensible Architecture

能力 / Capability 说明 / Description
🤖 自带模型 BYOK (Bring Your Own Key) 原生兼容 OpenAI、DeepSeek、Gemini、Claude、Ollama (本地离线)、智谱 GLM 等。支持智能分流:用 DeepSeek 写大纲,用 Claude 润色,用本地模型做隐私审查
🔗 MCP 协议 (Model Context Protocol) 原生集成 MCP 协议,随时外挂自定义工具服务器,扩展 AI 能力边界
📊 用量统计 (Usage Analytics) 内置 LLM 调用量、Token 消耗、成本趋势的完整统计面板

🛠️ 极客级生产力 UI / IDE-Grade Productivity UI

能力 / Capability 说明 / Description
🖥️ 可拖拽四分屏布局 (Resizable Panels) 文件树 + 编辑器 + AI 面板 + 底部终端,像 VSCode/JetBrains 一样灵活组合
🌙 沉浸深色主题 (Dark Theme) 极致优化的暗色模式,自定义悬浮标题栏与状态栏微交互
⌨️ 快捷键体系 (Keyboard Shortcuts) 全局快捷键:Cmd+N 新建、Cmd+O 打开、Cmd+=/- 缩放
📦 跨平台 (Cross-Platform) macOS (dmg) / Windows (nsis) / Linux (AppImage)

🚀 安装与使用 / Installation

方式一:直接下载 / Direct Download (我暂时没构建。。。请使用源码)

方式二:源码构建 / Build from Source

# 环境要求: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 KeyBase 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 Donate     支付宝赞助 Alipay Donate

💬 商业合作与技术交流 / Contact

如果您对本项目的商业化落地(SaaS 授权)、AI 写作技术实现或产品方向感兴趣,欢迎加我个人微信交流:

个人微信 Author WeChat

🎁 推荐 API 服务商 / Recommended API Providers

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

  • 智谱 AI (GLM Coding):国内顶流编程大模型,20+ 主流工具全适配 👉 立即参与「拼好模」
  • MiniMax (海螺 AI):Token Plan 含语音/视频/生图权益,新用户 9折 优惠 👉 立即订阅

🏗️ 技术架构 / 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 中与作者探讨,以避免方向冲突。


📄 开源协议 / License

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

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


Crafted with 💡 by heider-x

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

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

Reviews (0)

No results found