FreeShow：开源演示文稿软件的核心架构解析

FreeShow是一款免费开源的演示文稿软件，专为高效内容展示设计，支持幻灯片制作、媒体集成和多设备同步，适合会议、教学等场景。本文将从核心价值、模块解析、关键文件和扩展指引四个维度，帮助新手开发者快速理解项目架构。

核心价值：轻量化演示解决方案

FreeShow通过模块化设计实现低门槛的演示文稿制作，无需复杂配置即可完成幻灯片排版、媒体嵌入和实时预览。其跨平台特性支持Windows、macOS和Linux系统，且所有功能完全开源，允许开发者根据需求自定义扩展。

模块解析：功能模块与价值点

前端交互层：可视化界面实现方案

目录：src/frontend/
作用：包含所有用户交互相关代码，如幻灯片编辑器、菜单组件和媒体控件。
关联：与输出模块（src/output/）实时通信，当用户编辑幻灯片时，变更会即时同步到预览窗口。
💡 场景示例：用户在左侧幻灯片列表点击某张幻灯片，frontend模块会触发渲染逻辑，通过IPC通信通知输出模块更新显示内容。

数据处理层：演示内容管理中心

目录：src/electron/data/
作用：负责文件存储、媒体资源管理和数据备份。例如导入PPT文件时，此模块会解析内容并转换为FreeShow支持的格式。
关联：与导入模块（src/converters/）协作，接收外部文件并处理为内部数据结构。

输出控制层：多设备同步展示方案

目录：src/electron/output/
作用：管理主屏幕、扩展屏和远程设备的内容输出，支持NDI视频传输和多窗口同步。
关联：接收前端模块的指令，控制不同设备的显示内容，如演讲者视图与观众视图分离。

关键文件：项目启动与运行的核心

应用入口文件：src/frontend/main.ts

路径：src/frontend/main.ts
作用：前端应用的启动点，负责初始化Svelte组件、路由配置和状态管理。当应用启动时，该文件会加载主界面（App.svelte）并建立与后端的通信通道。

后端服务文件：src/electron/index.ts

路径：src/electron/index.ts
作用：Electron主进程入口，处理系统级操作如窗口管理、文件读写和设备通信。例如，当用户导入媒体文件时，该文件会调用系统对话框并处理文件流。

配置管理文件：config/building/electron-builder.yaml

路径：config/building/electron-builder.yaml
作用：定义应用打包配置，如图标路径、依赖项和平台特定设置。运行npm run build时，打包工具会读取此文件生成可执行程序。

图：FreeShow的主界面，左侧为幻灯片列表，右侧为编辑区域，顶部工具栏提供媒体导入、样式调整等功能

扩展指引：新手入门与功能扩展

本地运行步骤

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/fr/FreeShow
2. 安装依赖：npm install
3. 启动开发模式：npm run dev

功能扩展建议

• 自定义主题：修改src/frontend/global.css调整界面样式
• 新增导入格式：在src/converters/目录下添加新的文件解析器
• 集成第三方服务：通过src/electron/contentProviders/接入外部API

📌 提示：项目使用TypeScript开发，建议先熟悉Svelte框架和Electron主进程/渲染进程通信机制。