Ontology Playground的5个启动脚本逐个拆解dev、build、test与preview的完整指南【免费下载链接】Ontology-PlaygroundFree, open-source web app for learning about ontologies and Microsoft Fabric IQ. Explore a catalogue of pre-built ontologies, design your own visually, export as RDF/XML, and share interactive diagrams. Zero backend, fully static.项目地址: https://gitcode.com/GitHub_Trending/on/Ontology-PlaygroundOntology Playground是一款免费在线本体学习工具零后端、纯静态的网页应用帮你浏览预制本体目录、用可视化设计器创建自己的 Ontology、导出 RDF/XML 并分享交互式图表。想跑起来只需认识package.json里的 5 个核心启动脚本——dev、build、test、preview、validate这篇拆解指南带你逐个看懂它们的秘密。为什么先看脚本30秒建立全局认知这个项目由 Vite React TypeScript 驱动package.json 中的scripts字段就是它的驾驶舱。理解 5 个脚本的分工你就理解了整个开发循环写代码dev→ 验正确test→ 验数据validate→ 出产物build→ 看效果preview。启动脚本一dev一键启动开发服务器npm run dev秘密它只是 vite.config.ts 里一行vite的快捷方式但背后藏着开发体验的核心——热更新改动 src/components/ 下任意组件浏览器毫秒级刷新OAuth 代理vite.config.ts 配置了/__github代理因为 GitHub OAuth 设备流接口不支持 CORS本地开发时提交目录Catalogue功能因此可用AI 构建器开关设置VITE_ENABLE_AI_BUILDERtrue还会把/api代理到本地 Functions 服务api/。启动脚本二build一次构建四道工序npm run build这是最重的脚本package.json 中它串联了四道工序工序命令作用① 编译目录catalogue:build把 catalogue/ 下所有 RDF 编译为public/catalogue.json② 编译课程learn:build把 content/learn/ 的 Markdown 编译为public/learn.json③ 类型检查打包tsc -b vite buildTypeScript 检查后用 Vite 产出build/目录④ 嵌入产物build:embed单独构建可嵌入的ontology-embed.js库两个值得注意的设计分块优化vite.config.ts 的manualChunks把 cytoscape 图引擎、React/Zustand UI 库拆成独立 vendor 块首屏加载更快双产物策略vite.config.embed.ts 以 IIFE 格式打包src/embed.tsx让第三方网站能用一行script嵌入你的本体图——配套文档见 docs/embed-guide.md。启动脚本三test用 Vitest 守住质量底线npm test # 单次运行适合 CI npm run test:watch # 监听模式边写边测测试配置在 vitest.config.ts基于jsdom模拟浏览器环境测试入口 src/test/setup.ts。项目的测试文化相当扎实随手几个例子src/lib/rdf/roundtrip.test.ts —— RDF 解析与序列化回环一致性src/data/questIntegrity.test.ts —— 闯关任务与查询引擎的数据完整性src/a11y/themeContrast.test.ts —— 可访问性对比度检查可用test:a11y单独跑。启动脚本四preview本地预览生产构建npm run previewdev 和 preview 的区别是新手最常踩的坑dev跑的是开发服务器未压缩、有热更新preview则把build/目录这个真实的产物托管到本地端口让你提前发现开发环境好好的一构建就白屏这类问题——通常是路径或资源引用错误。启动脚本五validateRDF 数据体检仪npm run validate前四个脚本关注应用第五个关注数据。scripts/validate-rdf.ts 会校验 catalogue/ 全部本体加内置示例RDF 能否解析、本体结构是否合法、命名风格是否规范退出码 0 表示全部通过。它同时被 CI 用来把关社区贡献的 PR配套规范见 catalogue/metadata-schema.json。一图流日常开发脚本工作流场景命令改前端代码npm run dev提交前自测npm test新增/修改本体npm run validate发版检查npm run build npm run preview上手建议先dev看效果再test validate保质量最后build preview验产物。跑通这个循环你就掌握了 Ontology Playground 完整的工程节奏。 想深入了解本体建模本身content/learn/ontology-fundamentals/ 里的 6 篇入门文章是最好的起点。【免费下载链接】Ontology-PlaygroundFree, open-source web app for learning about ontologies and Microsoft Fabric IQ. Explore a catalogue of pre-built ontologies, design your own visually, export as RDF/XML, and share interactive diagrams. Zero backend, fully static.项目地址: https://gitcode.com/GitHub_Trending/on/Ontology-Playground创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考