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：存档在写下它的那个故事里打开；场景可以把画面交还给页面；变换预设可以作为文件传递；翻译表与配音表可以搜索。

生态方向

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

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