README

Ontology Playground（预览）☕

English · 简体中文 · 日本語

 翻译说明： 此简体中文译文仅为提高可用性而按“现状”（as is）提供。术语和内容已由 AI 依据 Microsoft Learn 官方简体中文文档进行核验，但这并不代表 Microsoft 的官方翻译或认证。如有差异，以英文 README为准。

 注意：本项目使用了 AI 辅助编程进行开发。

在线试用 &x2192; microsoft.github.io/Ontology-Playground



这是一个用于学习本体和 Microsoft Fabric IQ 的免费开源 Web 应用。
你可以探索预构建本体、在可视化编辑器中设计自己的本体、导出为
RDF/XML，并分享交互式图表——所有功能均来自完全静态的网站，
不依赖任何后端。

!Microsoft Fabric
!React
!TypeScript
!许可证

 功能

 交互式图探索

由 Cytoscape.js 驱动的图形系统，可将任意本体渲染为交互式的
节点与边图。你可以平移、缩放、点击节点查看属性，并使用
实时搜索栏筛选实体和关系。

 本体目录

由官方与社区贡献本体组成的精选目录，涵盖六个领域
（零售、电子商务、医疗保健、金融、制造和教育）。
可按类别浏览、按名称或标签搜索、一键加载任意本体，
并查看或下载经过哈希验证的完整 RDF 源文件。目录卡片会保留并显示外部标准和经适配的
社区条目所提供的许可证、上游来源及版本归属信息。每个本体都有
可分享的深层链接（//catalogue/official/cosmic-coffee）。图是源文件的
可视化投影；在设计器中打开目录条目时，完整源文档会一并保留。

 可视化本体设计器

全屏分栏编辑器，可用于从零创建本体或编辑现有本体。
添加带图标、颜色和类型化属性的实体类型；定义带基数的关系；
查看随操作实时更新的图预览。支持撤销/重做（50 级）、实时验证，
并可导出为 RDF/XML 或 JSON。对于带源文档的 RDF，设计器只允许修改
能精确映射到单一语句的现有标签、注释和直接 rdfs:subClassOf 边；
其余控件保持只读，撤销/重做会同时更新图投影与 RDF 补丁。

 RDF 导入与导出

RDF/XML 导入会同时保留原始字节、完整 RDF 图以及 Playground 的可视化投影。
未修改的文件会逐字节原样下载，包括 BOM、编码、格式和未映射语句。执行受支持的
编辑后，导出会序列化完整图及其补丁，而不是只重新生成可见子集；撤销全部净变更后，
文件会重新具备原始字节导出资格。

完整解析器会保留命名节点、空白节点、任意谓词、字面值词法形式、语言标签、
数据类型、OWL 限制、RDF 列表和 SHACL 语句。owl:imports 与 SHACL 始终保持
惰性，不会抓取外部资源或执行规则。当前限制为 8 MiB、250,000 条唯一语句，以及每个
展开后的 RDF 术语或 XML 字面量 16,384 个字符。XML 字面量重建还受总输出和事件数限制。
输入编码仅支持 UTF-8 或 UTF-16；BOM、字节特征和 XML 声明不一致时会明确拒绝。
不接受 DOCTYPE，也不会把命名图静默压平。Playground 中新建的本体仍可选择
Playground 往返配置或面向标准的 OWL + SHACL 配置。通过 URL 嵌入加载的
文件导入会在分配内容前检查声明的文件大小，并中止已被替换的读取。异步下载只会在
发起操作的文档和界面仍然有效时输出。大型完整源文件会作为单一纯文本节点显示，
避免创建无限增长的语法标记树；复制和下载仍使用完整源文件。
RDF/XML 也使用相同的大小、语句数和 DOCTYPE 限制。当前 Fabric API 只接受
可视化投影，因此带源文档的 RDF 无法直接推送到 Fabric；请改为下载完整 RDF。

图的呈现方式会
根据本体规模自动调整：小型本体保持完整显示；高密度本体保留全部数据，同时
减少标签干扰；超大型本体则先显示经过限制的语义层次结构概览。通过搜索、
调整层次深度以及展开标有 +N 的边界节点，无需一次绘制整个本体，也能访问
所有暂时隐藏的实体。目前不支持 Turtle 输入。

 一键提交本体目录 PR

使用 GitHub（设备流程）登录，即可直接从设计器向社区本体目录
提交你的本体——应用会 fork 存储库、创建分支、提交 RDF 和元数据，
并自动发起拉取请求。该基于投影的流程仅用于 Playground 中新建的文档；
带源文档的 RDF 必须先导出并作为有意派生的文件进行审查。

 可嵌入小组件

一个自包含的 JavaScript 文件（ontology-embed.js），只需一个
 标签即可在任意网页上渲染交互式本体查看器。
支持深色/浅色主题、多种加载方式（目录 ID、URL、内联 Base64）
和点击查看详情。目录及 RDF/XML URL 来源还可显示和复制完整 RDF 源文件。
延迟加载的目录源文件会固定到渲染当前图的同一已验证负载版本。若该不可变源文件
无法获取，小组件会明确显示错误并保留生成 RDF 作为后备，而不会切换到较新的目录版本。
URL 来源按 8 MiB 上限读取，RDF/XML 会执行与文件导入相同的安全检查。
RDF 工作线程已包含在自包含嵌入包中，因此托管在其他 HTTPS 源上的小组件不会尝试
启动跨源工作线程脚本。详细信息请参阅嵌入指南。

 本体学校

结构化学习中心（//learn），包含 9 门课程，涵盖概念
学习路径与动手实验：

- 本体基础——6 篇介绍核心概念的文章（什么是
  本体？→ RDF/OWL → Fabric IQ → 构建第一个本体 → 设计模式 →
  参与贡献）
- 7 条领域学习路径——Fourth Coffee、电子商务、金融、医疗保健、
  制造、大学和 HR 系统。每条路径包含 4 篇渐进式文章，
  逐步构建本体，并通过实时嵌入图展示每个阶段新增的实体。
- IQ 实验室：零售供应链——一个分 7 步进行的动手实验，从零构建
  包含 15 个实体的本体（通过 6 个渐进式目录条目从 3 个扩展到 15 个实体）。

每篇文章都支持演示模式（在  标题处分割幻灯片），
并包含提供即时反馈的交互式测验。本体嵌入可从目录加载
实时图，并可选择突出显示差异。

 任务系统

五个渐进式任务通过多步说明、提示、进度条和成就徽章，
引导用户学习本体概念。

 自然语言查询试验场

输入自然语言问题（“哪些客户下过订单？”），查看这些问题如何
映射到本体实体与关系——这是 Fabric IQ 的 NL2Ontology
能力预览。

 命令面板与键盘快捷键

在任意位置按 ⌘K / Ctrl+K 可打开可搜索的命令面板。无需
离开键盘即可跳转到目录、设计器、本体学校、导入/导出、帮助等页面。
按 ? 可快速访问帮助。使用方向键和 Enter 浏览命令面板。

 入门模板

设计器提供五个领域模板（