ULAMS 是什么？适合谁使用？
ULAMS 是用于创建和交付课程的开源 LMS。它帮助团队把产品文档、操作手册和内部资料转化为面向客户、开发者和员工的培训。
关于 ULAMS
“无头 LMS”是什么意思？我必须自己开发前端吗？
无头是指平台的内容和功能通过 API 提供，与用户界面相互独立。你可以使用 ULAMS 自带的界面，也可以在自己的应用中构建学习体验。
安装之前可以试用 ULAMS 吗？
可以。网站提供无需注册的演示，可以分别以学员和管理员身份打开。演示环境会定期重置，因此不适合存放你自己的资料。
使用 ULAMS 需要会编程吗？
作者可以在管理后台和 Studio 中创建和管理课程。
- 安装和维护自己的环境需要技术知识。
- 只有在你想构建自己的前端、扩展平台或开发定制集成时才需要编程。
ULAMS 与其他 LMS 有什么不同？
ULAMS 结合了通过 API 提供的后端、自托管能力，以及在作者掌控下基于资料生成课程的可选功能。
- 你可以使用现成的界面，也可以设计自己的界面。
- 当学习是你产品的一部分，并且你需要掌控集成、数据和课程展示方式时，这一点尤其有用。
ULAMS 适合所有组织吗？
它最适合重视集成、自有基础设施或定制学习体验的场景。
- 自托管意味着你要负责配置、更新和维护。
- 如果你需要全托管服务，请先确定由谁来承担这些工作。
课程、资料与 AI
可以用哪些资料创建课程？
Course Builder 接受 Markdown、PDF 和 DOCX 文档。
- 结构清晰、包含真实文本的资料效果最好；没有文本层的扫描版 PDF 需要先进行文字识别。
- 默认单个文件上限为 20 MB，PDF 上限为 300 页。
生成课程中的来源引用是什么意思？
引用让你可以查看课时或题目所依据的文档片段。
- ULAMS 会将生成的课时与所引用的片段进行核对，并标出需要关注的内容。
- 这让审核更容易，但不能代替作者的判断。
AI 能在未经我同意的情况下发布课程吗？
在 Course Builder 中，作者批准课程结构和每一项建议修改。
- 课程首先以未发布状态创建，发布是单独的一步。
- 你可以在学员看到之前查看预览并修改内容。
我的文档更新后会怎样？
Living Course 会比较资料版本，并指出可能需要更新的课程部分。
- 你可以上传文档的新版本，或连接 Git 仓库或网站。
- 课程修改需要作者决定：检测到新版本资料不会自动覆盖已发布的内容。
我的文档会发送给外部 AI 提供商吗？
使用 AI 生成时，完成任务所需的资料片段会发送到已配置的模型服务。
- 目前的 Course Builder 通过 Anthropic API 使用 Claude。
- 自托管平台并不意味着 AI 模型在本地运行。
- 你可以关闭 AI 功能，继续使用 LMS 的其他功能。
可以在不使用 AI 的情况下使用 ULAMS 吗？
可以。AI 是可选的。
- 你可以手动创建课程、添加资料、管理学员和访问权限并跟踪进度。
- 关闭 AI 不会影响 LMS 的其他功能，也不需要模型服务的密钥。
功能与内容
ULAMS 支持哪些模块和功能？
- 课程与内容: 课程、课时、文本、视频、音频、图片、PDF 和嵌入内容。
- 互动内容: H5P、SCORM、cmi5、LiaScript、测验和项目作业。
- 用户与访问: 账户、群组、角色、权限和课程访问。
- 评估与报告: 成绩、进度、报告和 PDF 证书。
- 学习组织: 网络研讨会、咨询、线下活动、通知、笔记和书签。
- 销售: 支付、购物车和优惠券。
- 内容创建与维护: Course Builder 和 Living Course。
- 集成与多学院: REST API、开发者工具和租户。
- 具体界面中可用的功能取决于版本、配置和所连接的服务。
可以复用现有的 SCORM 课程和互动内容吗？
可以。ULAMS 接受 SCORM 1.2 和 SCORM 2004 包，并支持 H5P 内容和 cmi5 包。
- 你可以在课程中将它们与其他资料组合使用。
- 上线之前，请在目标环境中测试你自己的包、播放和进度记录。
可以从现有 LMS 迁移资料和用户吗？
ULAMS 支持导入 SCORM 包，以及以 .ulam 格式导入和导出课程。
- 还有一个通过 CSV 导入和导出用户的模块。
- 迁移其他数据（例如学习进度历史或购买记录）需要评估兼容性并准备迁移方案。
- 导入资料并不会自动重建原平台的完整历史。
学员界面是否无障碍？
面向学员的页面按照 WCAG 2.2 AA 构建：支持键盘操作、可见焦点、替代文本和减少动画。
- 自动化无障碍检查是测试套件的一部分。
- 如果你构建自己的前端，该界面的无障碍性由你负责。
安装与托管
可以在自己的基础设施上运行 ULAMS 吗？
可以。ULAMS 以容器方式运行在你自己的服务器上。
- 文档介绍了应用、域名、邮件、文件存储和备份的配置。
- 生产部署需要在你选择的环境中完成配置和测试。
安装 ULAMS 需要什么？
标准部署需要一台运行 64 位 Linux、Docker Engine 和 Docker Compose v2 的服务器。
- 还需要配置了 DNS 和 HTTPS 的域名、课程文件存储空间，以及用于发送邮件的 SMTP 服务。
- 安装指南介绍了每一项的配置。
- 只有在需要生成内容时才需要 AI 提供商的密钥。
服务器需要什么配置？
文档建议：少量用户测试约需 2 vCPU、4 GB 内存和 40 GB SSD；小型生产部署约需 4 vCPU、8 GB 内存和 80 GB SSD。
- 这些只是估算，并非性能保证。
- 实际需求取决于并发用户数、包导入和视频处理等因素；课程资料的存储空间需要单独规划。
可以在本地试用整个系统吗？
可以。安装 CLI，并在 Docker Compose 可用时运行 ulams stack up。
- 开发试用使用确定性 AI 响应，无需付费模型调用。
- 需要 Node.js 22.12 或更新版本。
可以部署在哪里？
可以在自有服务器使用 Docker Compose，或在现有集群使用原生 Kubernetes 清单。
- AWS、Google Cloud 或 Azure 上的 VPS 或虚拟机均可运行。
- 生产部署需要 DNS、HTTPS 和持久存储。
如何停止系统而保留课程？
运行 ulams stack down。
- 在同一安装目录再次运行
stack up时，数据和凭据仍可使用。 - 只有
stack down --purge --yes会明确删除持久数据。
使用 ULAMS 需要多少费用？
平台代码以 MIT 许可证开源。
- 自托管时，你需要承担基础设施、维护以及所使用外部服务的费用。
- AI 生成由模型提供商计费；ULAMS 会显示生成成本，并允许设置预算上限。
- 部分组件有各自的许可证，详见文档；H5P 作为独立服务以 GPL 许可证运行。
如何升级到新版本？
先备份数据库和文件，然后按照文档中针对你的部署方式的升级步骤操作。
- 升级会为平台和每个学院运行数据库迁移。
- 升级生产环境之前，请查看发布说明中需要配置的变更。
集成与扩展
可以将 ULAMS 连接到我自己的应用或 Python 后端吗？
可以。集成通过 REST API 完成，因此你的应用可以用 Python 或任何支持 HTTP 的语言编写。
- ULAMS 还提供 OpenAPI 文档、SDK、CLI 和 MCP 接口。
- 集成范围（包括登录和课程访问）需要根据你的应用架构来确定。
智能体可以操作 ULAMS 吗？
CLI 和 MCP 接口支持兼容智能体。可以使用 Claude Code、Codex、OpenCode 或 Gemini CLI，也可以通过 REST API 直接集成。
可以为 ULAMS 添加自己的功能吗？
可以。平台采用模块化架构，源代码开放。
- 你可以构建自己的 API 模块、内容类型、界面组件和集成。
- 文档包含指南和一个示例扩展模块。
学院、品牌与销售
可以在一套安装上运行多个学院吗？
可以。ULAMS 支持多个学院，即租户。
- 每个学院可以拥有自己的地址、数据库、文件存储、账户和主题，因此你可以为客户、品牌或部门运行独立的环境。
- 学院的创建和维护由平台运营者负责配置。
可以让学院匹配我的品牌吗？
可以。学院可以拥有自己的名称、主题、强调色和域名。如需更深入的修改，你可以扩展 ULAMS 自带的前端，或基于 ULAMS API 构建自己的界面。
可以销售课程访问权限吗？
平台包含价格、支付、购物车和优惠券模块。
- 开展销售需要配置受支持的支付网关，并测试从购买到授予访问权限的完整流程。
- 可用的销售场景取决于所使用的版本和界面。
帮助与贡献
在哪里可以获得帮助？
请先查阅文档。
- 关于自托管、集成或项目的问题，请使用主页上的联系表单。
- 缺陷和功能建议请提交到 GitHub 上的问题跟踪系统。
如何参与贡献？
ULAMS 在 GitHub 上公开开发。
- 你可以报告问题、建议修改文档并提交 pull request。
- 文档中的贡献章节介绍了代码的组织方式以及变更的审核流程。