# @\_linked/schema 中文文档

规范地址：https://npmcn.com/package/%40_linked/schema/

版本：1\.9\.2
npm 元数据更新时间：2026-10-28T08:03:53.364Z
中文译文更新时间：2026-11-06T06:47:02.165Z
软件包许可：MIT AND CC-BY-SA-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40_linked/schema
原文对照：https://npmcn.com/package/%40_linked/schema/?lang=original
项目主页：https://github.com/linked-fw/schema#readme
源码仓库：https://github.com/linked-fw/schema

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.2 MB，197 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：react ^18\.2\.0 \|\| ^19\.0\.0
- 首次发布：2026-04-22T21:47:55.111Z
- 最新版本发布：2026-10-28T08:03:52.871Z
- 近 30 天下载量：4360（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

[schema.org (英语)](https://schema.org/) 对于 Linked : 它的词汇是 Turtle, 每个术语的存取器, 以及 Linked apps 使用的类的形状 。 软件包镜像 schema.org 并且只持有其条款(\[vocabulary rules\] ([https://github.com/link-fw/schema/ 页面存档备份,存于互联网档案馆](https://github.com/linked-fw/schema/)

## 安装

```sh
npm install @_linked/schema
```

也可以使用：`pnpm add @_linked/schema`、`yarn add @_linked/schema`、`bun add @_linked/schema`

## README

# 链接/舍马

[schema.org (英语)](https://schema.org/) 对于链接:它的词汇是龟,每个术语的存取者, 和用于类的形状。 该软件包镜像 schema.org , 并且只持有它的条件 (单位:千美元)[词汇规则](https://github.com/linked-fw/schema/blob/main/docs/vocabulary-rules.md)) (中文(简体) ).

## 术语

将术语模块导入为命名空间 :

```ts
import * as schema from '@_linked/schema/ontologies/schema';

static targetClass = schema.Person; // {id: 'http://schema.org/Person'}
```

`ontologies/schema` 输出每个 schema.org 的 3 023 个主题的一个名词, 没有 还有 命名空间导入是使用它们的一种方法:

-   **读起来像乌龟.** `schema.Person` 实值 `schema:Person`,前缀说 词汇词组来自, 也指几个词并用(`schema.name`, (中文(简体) ), `rdfs.label`) (中文(简体) ).
-   **有树摇.** 每个术语都是 `/*#__PURE__*/` 名称导出,所以捆绑者只保留 模块使用术语。 在2,802期的释放, [cli报告 027](https://github.com/linked-fw/cli/blob/main/docs/reports/027-ontology-accessor-generator.md) 测量了一个402,091字节模块,并且,在安装(小于)后,每个单元都测出125,759字节捆绑 保留术语,对应1 868字节 `schema.Person` 单独: 18 字节多于捆绑 没有条件(1 850)。 综合物体可以保存全部.

名称是生成的,一个规则适用于所有人:无法出现在标识符中的字符变为 `_`,领先数字得到领先 `_` (单位:千美元)`schema:3DModel` → `schema._3DModel`)和保留词 找到线索 `_` (单位:千美元)`schema:yield` → `schema.yield_`) (中文(简体) ). 无有别名.

`ns`, (中文(简体) ), `dataFiles`, (中文(简体) ), `loadData()` 财务报告和审定财务报表 `_ontologyResource` 包含 `@_linked/schema/ontologies/schema.data`数字 :

```ts
import {ns} from '@_linked/schema/ontologies/schema.data';
```

导入软件包根( E)`@_linked/schema`)或(或) `shapes/index` 登记本体学,其中 保留每个术语; 导入 `ontologies/schema` 直接在捆绑大小重要的地方.

如何使用任何词汇中的术语,以及何时 `{id}` 仍然是正确的,在核心的README: [使用本体学术语](https://github.com/linked-fw/core#using-ontology-terms)。 。 。 .

## 数据

`src/data/schema.ttl` 是schema.org最新发布, **第30.1号版本**, (中文(简体) ), [https://schema.org/version/30.1/schemaorg-current-https.nt](https://schema.org/version/30.1/schemaorg-current-https.nt),写作"乌龟" `scripts/write-turtle.mjs` ;主要注释为来源。 这个 名称空间是 `http://schema.org/`,而不是schema.org的首选 `https://schema.org/`: 工具类 jsonld 将每个 schema.org IRI 转换为 http,所以作者在导入时重写 https (除了 `schema:isPartOf` 对象,保留为已发布)。 其他文件都使用http. 刷新数据 由 schema.org 发布 : [积压的002件](https://github.com/linked-fw/schema/blob/main/docs/backlog/002-refresh-schema-org-data.md)。 。 。 .

官方文件是软件包术语的唯一来源:软件包从未添加一个类 或属性到标准命名空间。 所公布的标准,主要是元数据所缺乏的 每个前缀多一个文件, `src/data/<prefix>-added.ttl`,在 `"linkedOntologies"`数据:

-   肿瘤实体本身: `owl:Ontology`,标题,描述, `vann:preferredNamespacePrefix`, (中文(简体) ), `vann:preferredNamespaceUri`,源 URL和版本;
-   关于标准已经界定的术语的说明,例如缺失 `rdfs:label`。 。 。 .

新的类别或属性从不去那里;一个术语缺少标准属于消费者自己 肿瘤学包.

schema.org的数据没有描述命名空间本身,所以 `src/data/schema-added.ttl` 拿着 肿瘤学实体: `schema:` 作为 `owl:Ontology`,标题、说明和标签,首选 前缀和命名空间,以及源和版本.

`linked generate-ontology` 将三个模块写入 `src/ontologies/` 从数据 (单位:千美元)`package.json` `"linkedOntologies"`(三); `linked build` 过期时失败 。 永不编辑 他们用手.

## 发展

```bash
npx linked build    # checks the ontology modules, compiles, writes lib/esm/data/shapes.ttl
npm test            # runs against lib/
```

## 数据许可证

软件包代码是 MIT 许可(参见 `LICENSE`) (中文(简体) ). 被捆绑的本体学数据取自schema.org词汇 ([https://schema.org (英语)](https://schema.org/)), (c) schema.org 赞助商且不在麻省理工学院许可范围内:它仍然属于Creative Community Attroduction-ShareAlike 3.0(CC BY-SA 3.0), [https://creativecommons.org/licenses/by-sa/3.0 (英语)](https://creativecommons.org/licenses/by-sa/3.0/)。见 `NOTICE`。 。 。 .

## 常见问题

### @\_linked/schema 是什么？

schema\.org \(英语\) 对于 Linked : 它的词汇是 Turtle, 每个术语的存取器, 以及 Linked apps 使用的类的形状 。 软件包镜像 schema\.org 并且只持有其条款\(\[vocabulary rules\] \(https://github\.com/link-fw/schema/ 页面存档备份,存于互联网档案馆

### 如何安装 @\_linked/schema？

在项目目录运行 npm install @\_linked/schema，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @\_linked/schema 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @\_linked/schema 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @\_linked/schema 可以商用吗？

@\_linked/schema 使用 MIT AND CC-BY-SA-3\.0 许可。声明的许可为 MIT AND CC-BY-SA-3\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @\_linked/schema 的下载量有多少？

根据 npm 官方下载统计，@\_linked/schema 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,360 次，日均约 145 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @\_linked/schema 还在维护吗？

最新版本 1\.9\.2 发布于 2026/10/28（10 天前）；至今共发布 35 个版本，其中过去 12 个月发布了 35 个；首次发布于 2026/04/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。