这个项目能做什么

Worship Presenter Web 是一个自托管中心，旨在将崇拜流程单转换为成品幻灯片。它专为基督复临安息日会会众构建，但适用于任何运行类似崇拜程序的教会，因为幻灯片模板是数据而非代码。 核心工作流程接收流程单——粘贴到网页表单中，或通过聊天机器人经秘密门控的 webhook 发布——并从单一水合幻灯片计划生成三种输出：可下载的 PowerPoint 演示文稿（供离线使用）、全屏浏览器幻灯片，以及带独立投影仪窗口的双屏演示者模式。这意味着同一布局驱动所有四种输出（PowerPoint、网页幻灯片、投影仪和实时预览），无需针对每种格式的布局代码。 主要功能包括： - 通过网页表单或 webhook 接收流程单，未识别的行会显示出来而非静默丢弃。 - 从本地 695 首赞美诗语料库中解析赞美诗，按编号查找，并扩展为标题和歌词幻灯片，每节后重复副歌。 - 28 个可编辑幻灯片模板存储在 SQLite 注册表中，配有画布编辑器，用于移动、调整大小和样式化元素，并支持添加自定义文本框和形状。 - 演示者模式显示当前和下一张幻灯片、缩略图胶片条、幻灯片列表、跳转至任意幻灯片的网格、运行表，以及可拖到投影仪上的真实第二窗口。 - 空白屏幕功能，可黑屏投影仪并在不丢失位置的情况下恢复。 - 可选择的过渡效果（无、剪切、淡入、溶解、推入）统一应用于演示文稿和浏览器。 - 经文查找功能，在礼拜期间将 KJV 经文拉取到投影仪上。 - 公告传单，支持图片上传或白名单 URL。 - 账户和角色，提供个人管理员和操作员账户、限速登录以及可撤销会话。 该应用附带两个默认语料库：一个赞美诗集语料库（来自基督复临安息日会赞美诗的 695 首赞美诗）和一个 KJV 圣经语料库（66 卷书、1189 章、31102 节）。两者均提交到仓库中，因此克隆后可在启动时无需网络连接即可解析赞美诗编号和经文引用。语料库在每次启动时从其提交的文件中重新协调。 技术要求为 Go 1.24 和 Node.js 22 或更新版本。存储使用 SQLite，无需单独的数据库服务器。技术栈包括 Go API、使用 Vite 构建的 React SPA，以及 PPTX 工作器。快速入门涉及克隆仓库、运行 npm install、npm run setup（生成带新密钥的 .env、创建数据库、种子幻灯片注册表，并打印管理员密码），以及 npm run dev 在端口 3000 启动 Go API，在端口 5173 启动 React SPA。 项目包含一个 constitution 目录，内含私有数据处理指南、部署文档和决策记录。如果会众数据到达跟踪文件，测试将失败，从而防止敏感信息意外公开。仓库从单个初始提交开始，包含一个合成示例会众，因为原始私有仓库包含真实成员姓名、可识别人员（包括未成年人）的照片、私人消息截图和实时支付代码。 代码根据 MIT 许可授权，但名称 Worship Presenter Web、缩写 WDI 以及图标或文字标记不受 MIT 许可覆盖。包括赞美诗语料库在内的第三方内容在 ATTRIBUTIONS.md 中单独覆盖。项目鼓励为其他传统和赞美诗集进行改编，支持在随附语料库之外添加额外的赞美诗集语料库。