# @\_linked/sioc 中文文档

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

版本：1\.6\.2
npm 元数据更新时间：2026-10-28T08:06:19.993Z
中文译文更新时间：2026-11-06T17:53:37.886Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：168 kB，56 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：react ^18\.2\.0 \|\| ^19\.0\.0
- 首次发布：2026-07-06T08:36:35.388Z
- 最新版本发布：2026-10-28T08:06:19.576Z
- 近 30 天下载量：2529（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

SIOC( 同步链接在线社区) 词汇为 @ 链接 形状类——用户账户,站点,空间,集装箱,项目,作用,用户组. 从lincd-sioc (plan-011)更名.

## 安装

```sh
npm install @_linked/sioc
```

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

## README

# \*

SIOC( 标准[语义-相互联系的在线社区](http://rdfs.org/sioc/spec/)(中文(简体) ) 词汇为 `@linkedShape` 课程.

## 形状

-   `UserAccount` —— 说 `sioc:UserAccount`
-   `Site` —— 说 `sioc:Site`
-   `Space` —— 说 `sioc:Space`
-   `Container` —— 说 `sioc:Container`
-   `Item` —— 说 `sioc:Item`
-   `Role` —— 说 `sioc:Role`
-   `Usergroup` —— 说 `sioc:Usergroup`

## 术语

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

static targetClass = sioc.UserAccount;
```

`ontologies/sioc` 拥有一个命名导出 `http://rdfs.org/sioc/ns#` (99个); `ontologies/sioc.data` 持有 `ns`, (中文(简体) ), `dataFiles`, (中文(简体) ), `_ontologyResource` 财务报告和审定财务报表 `loadData()`一个术语 导出名称是其本地名称( e)`sioc:account_of` → `sioc.account_of`) (中文(简体) ). `linked generate-ontology` 从数据中写入模块( e)`package.json` `"linkedOntologies"`),以及 `linked build` 失败 当他们僵硬的时候,你不要用手加以编辑.

## 数据

数据是SIOC在其命名空间中发布的,在RDF/XML中,与三相转换为Turtle 不变;主要注释命名源 :

| 文件 | 来源 | 版本 |
| --- | --- | --- |
| `src/data/sioc.ttl` | [http://rdfs.org/sioc/ns (中文(简体) )](http://rdfs.org/sioc/ns) | `owl:versionInfo "Revision: 1.36"`,最后修改的2020-06-05 |
| `src/data/sioc-types.ttl` | [http://rdfs.org/sioc/types (中文(简体) )](http://rdfs.org/sioc/types) | 最后修改的2020-06-05 |

`sioc-types.ttl` 是 SIOC 类型模块(`http://rdfs.org/sioc/types#`它的主体不在 页:1 `sioc:` 命名空间,所以它添加了数据但没有术语. 要刷新, 将每个文件下载到 `curl -sSL -H 'Accept: application/rdf+xml' <source>`转换为Turtle,检查三进制 匹配下载( RDF/ XML) `rdf:type` 空属性元素上的属性是 IRI,而不是 将注释放回去,然后运行 `npx linked generate-ontology`。 。 。 .

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

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

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

两个文件都带有自己的本体学头,所以这个软件包没有 `-added` 文档.

## 使用量

```ts
import { UserAccount } from '@_linked/sioc/shapes/UserAccount';

const account = await UserAccount.select().one();
console.log(account.accountOf?.givenName);
```

## 历史

重命名从 `lincd-sioc` 改为 `@_linked/sioc` 迁出 [页面存档备份,存于互联网档案馆. lincd.org](https://github.com/lincd-org) 雨伞在 [创建- 现在的计划-011](https://github.com/Semantu/create-now/blob/main/docs/reports/) (2026-06-12) (中文(简体) ). 当时,内部来源没有变化——只有包名和 更新了出版基础设施,以符合现代 `@_linked/*` 常规(变更套件、双包装无害环境管理+CJS建设、, `development` vite HMR 有条件导出).

## 数据许可证

软件包代码是 MIT 许可(参见 `LICENSE`) (中文(简体) ). 被捆绑的肿瘤数据是SIOC Core Ontology和SIOC类型模块, (c)2004-2018年数据科学所(原为DERI),NUI Galway,不在麻省理工学院许可范围内. 命名空间文件没有许可证;SIOC规格的Creative Commons许可证(CC BY 1.0)规定,它不适用于SIOC肿瘤学术语. 见 `NOTICE`。 。 。 .

## 常见问题

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

SIOC\( 同步链接在线社区\) 词汇为 @ 链接 形状类——用户账户,站点,空间,集装箱,项目,作用,用户组\. 从lincd-sioc \(plan-011\)更名\.

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

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

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

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

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

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

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

@\_linked/sioc 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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