Project

NarraLeaf Project 是一个面向视觉小说体验构建的生态系统，覆盖从创作到交付的主要路径。它将零代码 Studio、桌面应用工具链和轻量 React 播放器放在同一套项目理念下，让团队可以选择合适的起点，同时保留进入完整 NarraLeaf Project 生态的空间。

这个项目围绕轻量 Web 技术、结构化内容和可增长的工作流设计。个人创作者可以先专注于场景与叙事流程，开发者也可以继续使用 TypeScript、版本控制、打包流程和应用级定制能力。

项目理念

NarraLeaf Project 不只是产品列表，也是一种让视觉小说项目在规模增长后仍然保持清晰的项目结构。

这个生态强调：

• 将创作工具、运行时行为、渲染层和播放器集成分离清楚。
• 建立在 Web 与 TypeScript 基础上，便于接入已有开发工作流。
• 让项目文件和工具链可以像现代软件一样被审查、版本管理、测试和交付。
• 提供多种入口，但让它们服务于同一个项目方向，而不是变成互不相关的产品。

因此，一个项目可以从可视化工作流开始，在需要时深入到桌面交付细节，也可以只把播放器层嵌入已有的 React 产品中。

主要路径

NarraLeaf Studio

NarraLeaf Studio 是零代码创作与编辑路径。它面向希望通过引导式可视化环境构建故事结构、场景和制作流程的创作者与团队。

当项目的首要任务是创作和维护内容，而不是立即处理应用内部实现时，Studio 是最合适的起点。

NarraLeaf Desktop

NarraLeaf Desktop 是桌面应用工具链，覆盖用于构建和交付 NarraLeaf Desktop 应用的 runtime、renderer 与 CLI。

这条路径面向需要掌控完整应用的开发者，包括本地开发、打包、运行时集成和交付流程。

NarraLeaf-React

NarraLeaf-React 是轻量 React 播放器路径。它适合希望将视觉小说体验嵌入 Web 产品，或需要深度定制播放器 UI 的团队。

这条路径让播放器保持贴近 React 生态，适用于故事体验只是更大应用中的一部分的场景。

如何选择

如果你的首要目标是创作故事内容、管理场景，并通过可视化流程推进制作，请从 NarraLeaf Studio 开始。

如果你要构建完整的桌面视觉小说应用，并需要访问 runtime、renderer、CLI 和交付工作流，请查看 NarraLeaf Desktop。

如果你已经有 React 应用，需要一个轻量播放器，或希望完全掌控周围的 UI 与产品体验，请查看 NarraLeaf-React。

这些路径是同一项目生态中的兼容组成部分。团队可以从其中一条路径开始，并随着项目变得更技术化、更协作化或更接近发布，逐步采用其他部分。

里程碑

项目

• 2024 年 8 月 10 日：NarraLeaf Project 成立。
• 2024 年 9 月：NarraLeaf-React 发布到 npm，这是 React 播放器的首个公开版本。
• 2025 年 2 月：NarraLeaf 桌面工具链发布，故事可以作为桌面应用交付。
• 2025 年 10 月：NarraLeaf 命令行工具发布，覆盖项目创建、本地开发与构建。
• 2026 年 5 月：narraleaf.com 上线，三条路径的文档集中在一处。
• 2026 年 8 月：NarraLeaf Studio 发布首个公开版本，项目可构建到 Windows、macOS、Android、iOS 与 Web。

0.1.0 之前

Studio 的大部分基础建成于首个版本之前的十个月，那段时期项目还没有版本号。

• 2025 年 10 月：项目开始。窗口与进程层、文件系统、启动器，以及新建项目向导。
• 2025 年 11 月：工作区成形，包含可调整的面板、侧栏、模块与焦点系统，以及第一版资源库。
• 2025 年 12 月：角色编辑器，含外观、差分与分组；随后是设置面板与远程资源。
• 2026 年 1 月：界面编辑器开工。资源库加入图标视图、复制粘贴与锁定。
• 2026 年 2 月：界面编辑器可用，Surface、属性编辑器、图片裁剪与取色器就位；Dev Mode 首次出现。
• 2026 年 4 月：蓝图系统，包含节点图编辑器、诊断、成员面板与变量管理。
• 2026 年 6 月：剧情编辑器开工。蓝图接上 Surface 作用域与历史记录，资产与窗口访问经过一轮加固。

Studio 版本

• 0.1.0（2026 年 7 月）：首个版本。命令面板、快捷键自定义、通知中心、插件系统与画廊随它一同到位，项目可构建到桌面、移动端与 Web。
• 0.1.1：帮助菜单增加「关于」。
• 0.2.0：从 PSD 导入的分层立绘、按差分设置的对话头像、一张主图标烘焙出六个目标的图标，以及插件 sidecar 与按能力授权的运行时 API。
• 0.3.0（2026 年 8 月）：首个提供下载的版本。Live2D 与 Spine 模型的引导式导入、可为每个角色单开总线的音频混音、项目检查、代码签名与公证，以及轮换式自动存档。
• 0.4.0：剧情编辑器统一命令词汇，已提交的行读回去就是写出它的那一行；帮助文档进入 Studio 内部；本地化按译者工具的格式导出。
• 0.5.0：安装器，以及从 GitHub Releases 自更新；导入时检查媒体能否播放并提供转换；蓝图断点与 Dev Mode 调试器；颜色可以指向项目配色。
• 0.6.0：构建变体。变体声明自己的包里有什么、故事在哪里结束，构建会报告它删掉了什么。蓝图编辑器可以开在独立窗口，项目拥有自己的词典。
• 0.7.0：资产集。一条库条目代表一族文件，按语言在运行时解析，或按发行版在构建时确定。作者可以产出补丁、发布的游戏可以读取补丁；天气；跳过与自动前进等待。
• 0.8.0：蓝图可以对着目录以文本编写；画布工具条与图形总览；命令行构建；DLC 构建成独立文件；每次构建产出一份内容报告。
• 0.9.0：实时会话。主机开房间，会话携带的文件走它自己的连接。按轨压缩、受保护构建为所在作品编译自己的编解码器，插件 sidecar 覆盖构建产出的每个目标。
• 0.9.1：项目导出支持已打包的构建，大体积的包分块写入与读取。
• 0.9.2：存档在写下它的那个故事里打开；场景可以把画面交还给页面；变换预设可以作为文件传递；翻译表与配音表可以搜索。
• 0.10.0（2026 年 9 月）：脚本成为蓝图的图层，背后是作者在自己的编辑器里编写的 TypeScript 文件；Studio 不认识的项目要先受信任才能构建或运行；角色按自身像素尺寸绘制；--test 与 --lint 加入命令行，与 --build 并列。
• 1.0.0（2026 年 10 月）：首个正式版。0.10.0 的项目跑在 1.0 引擎上，插件类型包按 Studio 自己的版本号发布。
• 1.1.0：蓝图总览把项目里的全部蓝图列在一页；图层模板库；悬停与点击音效成为元素属性；文字的内容三选一：自己的文字、翻译键或蓝图值。
• 1.2.0：插件提供的故事动作；视频只通过 /play 上场；在 Windows 上构建 macOS 与 Linux 包；悬停连线时会说出它另一端连着什么。
• 1.3.0：页面上的每段文字只有一个来源，画布、游戏、翻译与搜索读到的都一样；项目检查在后台运行，结果列在「问题」面板中。
• 1.4.0：页面参数；蓝图引脚带上结构类型；输入意图可以绑定手柄按键；界面编辑器的网格；作者为故事命令自定的缩写。
• 1.4.1：组件的根元素可以在组件编辑器里更换；插入子元素会插进打开命令的那一行。
• 1.4.2：实时预览显示存档变量在所预览那一行的值；游戏里 Studio 自己的文字跟随游戏语言；组件参数可以是一条音轨。
• 1.4.3：更新在后台自行下载并准备好；标题栏的更新按钮显示进度；/rename 行给角色起的名字可以翻译。
• 1.4.4：每个版本都同步到 GitCode，中国大陆也能下载和更新；Windows 安装包恢复正常大小。
• 1.4.5：更新下载失败后会自动重试，有另一个下载源时改从那里下载；更新面板会说明出了什么问题。
• 1.5.0：作者自己的 AI Agent 可以在打开的项目里制作游戏；游戏可以只用键盘或手柄来玩；场景的图层按离镜头的距离摆放；重做的故事动效编辑器；项目检查新增次要警告级别。
• 1.6.0：创建浮窗里同类的蓝图节点合为一行，已放置的卡片可从标题旁切换为同类的其他节点；等于与不等于按值比较；创建浮窗的每个分类各有自己的图标；节点的 type id 只在开启开发者选项时显示。
• 1.6.1：Windows 上通过 stdio 接入的 AI Agent 可以正常连接；设置里的访问令牌可以复制；开着输入法也能用 / 与 # 在故事编辑器里开始命令；蓝图图层打开时已对准视野。
• 1.6.2：Claude Code 里的 Agent 能读到场景、页面和指南的全部内容；Agent 给界面元素设的字号和颜色会显示在页面上；.story 文件里的短 /if 和用别名写的说话人与编辑器里的效果一致；设置里重新有了端点端口，端口被占用时报错，不再自动换端口。
• 1.6.3：页面可以播放自己的音乐，设置方式与场景音乐相同，同一段音乐跨页面不中断；「替换文件…」、PSD 导入和音频导入都可以撤销，搜索面板的「全部替换」一步就能撤回；Agent 连接时不再启动 Studio；Live2D 与 Spine 角色按舞台比例绘制；「记录」页显示每句台词说出时的头像。

生态方向

NarraLeaf Project 也在围绕资产打包、音频、UI 组合、脚本工具和制作工作流发展更多支持工具。这些工具的目标是服务三条主要路径，而不是制造新的复杂入口。

长期来看，NarraLeaf Project 希望形成一套连贯的视觉小说项目工具集：对创作者足够易用，对开发者足够实用，并且能支撑团队维护和交付真实应用。