Reveric（幻界）是一个本地优先、以智能体为核心的桌面创作工作台，覆盖长篇小说、剧本改编与短剧/漫剧制片。 整部作品保存在你的设备上，同时也是智能体的工作区：写章节、改剧本、铺分镜、调机位、剪成片，说一句话，它就在作品里动手完成。

• 按需读取整部作品：智能体自己检索需要的章节和设定，不用把人物小传复制进对话框。
• 智能体操作所有模块：小说、剧本、画布、3D 导演台、剪辑台，智能体都能直接上手操作。
• 素材自动生成：角色定妆、分镜参考图、视频片段与音频，由智能体调用模型直接生成到画布上。
• 本地优先，模型自选（BYOK）：作品数据保存在本地 SQLite，模型直连 OpenAI、Anthropic、Gemini、DeepSeek、Seedance、H3 或自建网关。

作品里的每个模块，智能体都能直接操作。说一句话，它就在对应的编辑器里动手。

• 小说：读前文和设定，写章节、改章节，创建人物、势力与伏笔，维护关系图谱，核对前后连续性。
• 剧本：对照原著改编，拆分剧集与场次，编写对白与动作。
• 画布：按剧本铺开分镜节点，编写提示词，生成角色定妆、参考图与视频片段。
• 3D 导演台：布置机位、切镜与运镜，抽帧检查画面构图。
• 剪辑台：自动剪辑与素材处理，把素材排上时间线，分割、修剪、排序片段，添加字幕、分离音频、替换素材、调整画幅，渲染预览并抽帧检查。

文风、视角、禁忌写法可以写成规则让它长期遵守，也可以安装或导入技能扩展它的能力。

章节、大纲、人物、伏笔、素材、世界观设定、地图和图鉴放在同一个作品工作区里，彼此关联，也全部向智能体开放。作者负责把握节奏、取舍与定稿。

• 章节编辑：树状大纲导航、自动保存、历史版本快照、一键专业排版。
• 故事资产：人物、势力、技能、伏笔、地点与地图，关系图谱记录角色关系的演变与重要节点。
• AI 协作：让智能体读完前文和设定再扩写、润色或改写情节；写完一章后，还能让它提取关键事实、核验前后连续性，避免设定吃书。

支持以已有小说为原著创建改编剧本。编辑器遵循影视行业标准，包含场次、动作、角色、括号、对话、转场、字幕等核心元素：

• 标准化排版：自如流转场次、动作、角色、对话与转场，写作思路不被打断。
• 原著对照：左侧阅读小说原著，右侧编写剧本；智能体可以跨作品读取原著，提炼场景、台词与动作指示。

将剧本转换为视听语言的创作中枢。角色定妆照、场次节拍、分镜段落和生成的图片、音频、视频，均以节点形式在无限画布上铺开：

• 节点流转：镜头上下游引用关系与生图提示词一目了然。
• 智能体生成：让智能体按剧本拆分镜、写提示词、批量生成参考图与视频片段。
• 多模态管理：集中管理参考图、定妆形象与镜头批次，告别散落的本地文件夹。

内置 3D 空间预演引擎，像真正的导演一样在现场调度：

• 空间布景与角色站位：在三维场景中摆放角色与道具，确认视线关系与空间构图。
• 机位与运镜设计：自由设置特写、全景、正反打机位，规划推拉摇移运镜轨迹。
• 时间轴预演：按时间轴切镜预演整场戏，导出构图参考图或预演动图，作为视频生成的参考。
• 交给智能体：让智能体按剧本布置机位、安排切镜与运镜，并抽帧检查构图。

专为短剧与漫剧打造的多轨非线性剪辑环境：

• 6 轨专业时间线：涵盖视频主轨、画面叠加轨、角色对白轨、环境音效轨、背景音乐轨与多语言字幕轨。
• 精准编辑操作：支持剪刃分割、波纹删除与多段吸附。
• 一键成片输出：剪辑完成后直接导出成片视频，无需外部软件中转。
• 交给智能体：智能体自动把画布上的素材排进时间线，完成分割修剪、字幕与音频处理，并渲染预览。

Reveric 坚持 Local-First 与 BYOK（Bring Your Own Key）理念。无论是文学创作还是短剧制片，创作者对模型选择拥有完全自主权。

Reveric 在无限画布与故事图鉴中深度支持主流图像生成模型，用于角色定妆、分镜视觉参考、场景道具与概念插画创作：

Reveric 为短剧制片与无限画布深度集成了主流视频生成大模型，支持首尾帧锁定、多图参考、多画幅比例与运镜调度：

在 Releases 页面获取对应平台的预编译安装包：

提示：应用数据完全存储在本地（SQLite 数据库与本地工程文件夹）。升级新版本时直接覆盖安装即可，历史作品与设定会自动安全保留。

只需四步，开启你的 AI 协同创作之旅：

1. 配置模型服务 打开左侧底部「设置」➔「模型设置」，添加你常用的 AI 供应商并填入 API Key 与 Base URL，测试连通后启用。
2. 创建你的作品 在首页点击「新建作品」，可选择小说或剧本；也可以通过「快速开书」输入灵感由 AI 协助生成开篇设定，或直接导入已有的 TXT 原稿。
3. 和智能体聊出设定 进入作品后，内置的创作向导会在聊天中询问题材、文风与核心设定，并把写作约束保存为智能体规则、把人物与世界观写入设定库。你也可以随时手动补充。
4. 把任务交给智能体 直接在聊天中说"写第三章"、"把第一卷改编成剧本"、"给这场戏拆分镜并生成参考图"，智能体会自己查资料、动手执行。随后进入 3D 导演台编排镜头，在剪辑台完成配乐与成片导出。

Reveric 采用 Flutter 与现代跨平台架构构建，欢迎社区开发者共同探索与改进。

• 框架与语言：Flutter 3.8+、Dart SDK
• 状态管理：Riverpod (Hooks Riverpod) + Flutter Hooks
• 本地存储：Drift (SQLite) Local-First 架构
• 3D 引擎：Flutter Scene（3D 场景与镜头渲染）
• 多媒体处理：FFmpeg Kit、FVP 视频播放引擎

# 1. 克隆代码仓库
git clone https://github.com/looplj/reveric.git
cd reveric

# 2. 安装项目依赖 (推荐使用 FVM 管理 Flutter SDK)
make deps
# 或者: fvm flutter pub get

# 3. 运行代码生成器 (Drift 数据库与 Riverpod 代码)
make codegen

# 4. 本地启动应用调试
make run-macos     # macOS 客户端
# make run-windows # Windows 客户端
# make run-linux   # Linux 客户端

# 5. 构建 Release 正式安装包
make build-macos-release   # 构建 macOS 客户端
make build-windows-release # 构建 Windows 客户端

如果你在使用中遇到了问题，或对新功能有独到想法，欢迎参与交流：

• 提交缺陷报告或需求建议：GitHub Issues
• 学 AI、交流经验：LINUX DO 社区

本项目基于 AGPLv3 授权开源，附加条款与第三方依赖声明详见 NOTICES。商业授权请联系 bababaa261@gmail.com。