星芒课件

一个以 Markdown 为课程内容中枢的轻量级工作台，用于串联：

• 课程大纲优化与实时预览
• 课程封面生成与程序排版
• Keynote / PPTX 课件拆页、编辑和导出
• Skills 导入、编辑、默认项与本地管理
• 文本、图片和课件服务 API 配置

直接下载安装

平台	系统要求	安装包
Windows	Windows 10 / 11 x64	下载 EXE 安装包
macOS	Apple Silicon（M1 及以上）	下载 DMG 安装包

也可以前往 GitHub Releases 查看版本记录和全部安装包。

当前安装包尚未进行 Apple / Windows 代码签名，首次启动时系统可能显示安全提醒。

本地运行

需要 Node.js >=22.13.0。

npm install
npm run dev:all

dev:all 会同时启动网页和仅监听 127.0.0.1:4318 的 Keynote Local Runner。只调试网页时仍可使用 npm run dev；只启动 Runner 可使用 npm run runner。

打开终端中显示的本地地址即可使用。首次执行带脚本的 Skill 包时，页面会要求 确认本地执行授权；Runner 不会在 Keynote 存在打开文稿时继续自动化，以免关闭 未保存的用户文件。

数据与接口

课程内容、Skills 和 API 配置默认保存在当前浏览器的 localStorage 中。完整 Skill 文件夹和 Runner 产物保存在项目目录下被 Git 忽略的 .course-studio-runner/ 中。

浏览器直连第三方 API 可能受 CORS 限制，也无法完全保护 API Key。正式线上使用建议通过自建服务端代理转发模型请求。

验证

npm run lint
npm test

桌面安装包

桌面版会在应用启动时自动运行 Web 服务和本地 Runner，用户不需要另外打开终端。

# macOS Apple Silicon DMG
npm run desktop:mac

# Windows x64 EXE 安装包
npm run desktop:win

# 同时构建 DMG 与 EXE
npm run desktop:dist

安装包输出到 release/。macOS 桌面版支持 Apple Keynote 自动化；Windows 桌面版支持课程、封面、Skills、API 和 PPTX 功能，但无法调用仅存在于 macOS 的 Apple Keynote。

当前安装包为未签名的内部发行版本。对外分发前应配置 Apple Developer ID、 macOS 公证以及 Windows 代码签名证书。