# @agenticprimitives/ontology 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/ontology/

版本：1\.0\.0-alpha\.46
npm 元数据更新时间：2026-10-26T11:49:39.431Z
中文译文更新时间：2026-11-06T00:15:10.806Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agenticprimitives/ontology
原文对照：https://npmcn.com/package/%40agenticprimitives/ontology/?lang=original
项目主页：https://agenticprimitives.dev/
源码仓库：https://github.com/agentictrustlabs/agenticprimitives

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

- 包体积（解压后）：1.6 MB，185 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-05-31T17:13:14.382Z
- 最新版本发布：2026-10-26T11:49:38.523Z
- 近 30 天下载量：8279（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

Monorepo全用正文词汇(RDFS/OWL T-box + SHACL/SKOS C-box + A-box settings)用于代理原始人. 离链真相源 链上肿瘤 (ADR-0009) 即时反应. 船舶 TTL/JSON-LD 文物+打出IRI常数.

## 安装

```sh
npm install @agenticprimitives/ontology
```

也可以使用：`pnpm add @agenticprimitives/ontology`、`yarn add @agenticprimitives/ontology`、`bun add @agenticprimitives/ontology`

## README

# @ agenticrimitives/ 肿瘤

**信任底物只与其词汇一致.** 当30个包裹,42个合同,以及一个知识图 都谈到代理, 证书,监护权, 和授权, "什么是一个 `CredentialFacet`" 不能有30个答案。 这个软件包是单一的全域形式词汇——链上本体论(英语:Con-chain totology (film))的离链真理来源[ADR-0009 (英语)](https://npmcn.com/package/docs/architecture/decisions/0009-on-chain-ontology-shacl-naming.md)即时和 [`identity-directory`](https://npmcn.com/package/%40agenticprimitives/identity-directory) (第223项)符合.

它有意宣示:它命名和约束,它从来不授权。 词汇根依赖于无-甚至 `@agenticprimitives/types` ——所以其他每个包都可以在不倒置依赖图的情况下引用相同的IRI.

> 部分 [代理原始产品](https://npmcn.com/package/README.md) ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

见 [第225区](https://npmcn.com/package/specs/225-ontology.md) 合同全文 [ADR-0018 (英语)](https://npmcn.com/package/docs/architecture/decisions/0018-agenticprimitives-wide-formal-ontology.md) 为了决定.

## 布局 (T- box / C- box / A- box) (中文(简体) )

```
context.jsonld   @context — namespace prefix → IRI bindings
tbox/            RDFS/OWL schema (classes + properties), per domain
cbox/            SHACL shapes + SKOS controlled vocabularies (codelists)
abox/            example / fixture instances (tests + golden vectors only)
mappings/        external-standard crosswalks (HCS / ERC-8004, spec 226)
src/index.ts     typed IRI constants + artifact paths
```

T-box = 名词 C-box = 约束 + 受控词汇 A-box = 例.

T-box的UML类图表文档——继承+每个域的关系 住在这里 [`docs/tbox/`](https://npmcn.com/package/%40agenticprimitives/ontology/docs/tbox/README.md). 对于普通语版本——原则 词汇保护以及为什么——首先 [`docs/story.md`](https://npmcn.com/package/%40agenticprimitives/ontology/docs/story.md)。 。 。 .

## 使用量

```ts
import { NS, CLASS, SHAPE, ARTIFACTS, artifactPath } from '@agenticprimitives/ontology';

CLASS.CanonicalAgentId; // "https://agenticprimitives.dev/ns/core#CanonicalAgentId"
artifactPath(ARTIFACTS.tbox[0]); // absolute path to tbox/core.ttl — load into a SPARQL store
```

两个切入点,故意分开:

-   **主条目(浏览器安全)** 纯IRI常数: `NS`, (中文(简体) ), `CLASS`, (中文(简体) ), `PREDICATE`, (中文(简体) ), `SHAPE`, (中文(简体) ), `ONTOLOGY_VERSION`。节点构建;这就是 `identity-directory` (并通过它,浏览器应用)导入.
-   **`/artifacts` 子路径( 只有节点)** —— 说 `ARTIFACTS` + 键 `artifactPath(rel)` 用于解析运出 SPARQL 加载器或 SHACL 引擎的 TTL/JSON-LD 文件。 仅限服务器侧.

## 怎么不一样

通用 SKOS/SHACL 工具链作为文档管理词汇-在一个编辑器中管理,脱离依赖于它们的系统,漂移瞬间运行时间代码变化. 这里的词汇带有负载,并按三个方向进行锁步检查:

1.  **链条** ——这里的形状或上游必须与其链上对应物相匹配 `OntologyTermRegistry` 编号 : `ShapeRegistry` (spec 225 §8);漂移被记录为一种发现,而不能被容忍为skew.
2.  **在类型脚本中** ——IRIs 映射出品牌类型在 [`types`](https://npmcn.com/package/%40agenticprimitives/types) (单位:千美元)`CanonicalAgentId`, (中文(简体) ), `Assurance`(中文(简体) ). 一个品牌;这个包命名为IRI,从未重新定义该类型.
3.  **各种标准** —— 说 `mappings/*.ttl` 携带明确跨行到外部代理识别标准(HCS,ERC-8004,OASF),而不是非正式"严格对应"的通俗.

并且它会轻而易举地航行:在已出版的地表没有重型的RDF/SHACL图书馆——消费者用自己的发动机来给文物接线.

## 范围

以普通AP原始为基准:身份、证书、监护、授权、审计、命名、Org、登记/发现、信任、公众接触结果以及底质-spine T-box类定义(Spec 225 §11.5)。 用于产品流动的运行时 SHACL 形状生活在自己的软件包中; GraphDB A-box 摄取形状用于发现 `cbox/discovery-graph-shapes.shacl.ttl`; 垂直词汇仍然为应用所有([ADR-0021 (英语)](https://npmcn.com/package/docs/architecture/decisions/0021-generic-packages-vs-white-label-apps.md)) (中文(简体) ).

发现本体论 刻意从 Agent Explorer 中的域源词汇形状中构建 `apps/ontology/ontology` 模块 - `core.ttl`, (中文(简体) ), `discovery.ttl`, (中文(简体) ), `descriptors.ttl`, (中文(简体) ), `erc8004.ttl`, (中文(简体) ), `hol.ttl`, (中文(简体) ), `oasf.ttl`,以及 `trust.ttl` ——同时将它提炼成植入PROV-O和DOLCE+DnS/DUL的AP-native命名空间.

### 模块映射( 按 spec 添加)

| 关切 | T- 选项 | 弹匣 |
| --- | --- | --- |
| 身份、类型、衍生类型 | `tbox/core.ttl`, (中文(简体) ), `tbox/identity.ttl` | `cbox/controlled-vocabularies.ttl`, (中文(简体) ), `cbox/canonical-agent-id-shape.shacl.ttl` |
| 类型命名、登记核心(第346项) | `tbox/naming.ttl`, (中文(简体) ), `tbox/registry.ttl` | `cbox/naming-registry-shapes.shacl.ttl`, (中文(简体) ), `cbox/registry-vocabulary.ttl` |
| 能力、索赔、分类制图(第251/325/347 §5段) | `tbox/skills.ttl` (单位:千美元)`aps:SkillTaxonomyMapping` —— 说 `relation` = SKOS 绘图属性) | `cbox/skill-vocabulary.ttl`, (中文(简体) ), `cbox/capability-catalog-shapes.shacl.ttl` |
| **Canonical profile → A2A代理卡 → 投影 → 出版 → 外部身份绑定(Spec 347 §11; ADR-0062)** | `tbox/card-projection.ttl` ——第二单元 `ap:` 核心命名空间; PROV- O 定位( 生成/ 发布 ) `prov:Activity`文物/释放 `prov:Entity`; 出版商/适应者 {} `prov:SoftwareAgent`)),"canonical agent" ("canonical agent")""≡"" `ap:Agent`,没有二等 | `cbox/card-projection-shapes.shacl.ttl` 公共卡元数据;投影出处(全部) **八点** 文摘列为 `ap:hasDigest`外部约束; **公开披露边界** (SPARQL目标于 `ap:disclosureScope "public"`:没有回回回/私通/链接-本地端点,没有金库定位;没有范围是私通. 代码列表 `ap:lossCategoryScheme`,卡片放出/投影预告/装订生命周期, `ap:bindingVerificationStateScheme`, (中文(简体) ), `ap:digestRoleScheme` 内 `cbox/controlled-vocabularies.ttl` |
| 代理交互( 第340段) | `tbox/interaction.ttl` | `cbox/interaction-shapes.shacl.ttl`, (中文(简体) ), `cbox/interaction-vocabulary.ttl` |
| 协调/参与/执行(第332/336/330段) | `tbox/coordination.ttl`, (中文(简体) ), `tbox/engagement.ttl`, (中文(简体) ), `tbox/execution.ttl`, (中文(简体) ), `tbox/plan.ttl` | —— 说 |

## 这不是什么

-   不是TS类型 - `@agenticprimitives/types` 拥有 `CanonicalAgentId`, (中文(简体) ), `Assurance`等;此套件命名为IRIs. 一个品牌.
-   不是运行时间 CAIP- 10 构建器—— 即 `@agenticprimitives/agent-profile`。 。 。 .
-   不是当局——它命名和确认;它从来不给予监护权或薄荷.

## 状态

**第一阶段已执行** ——T/C/A-盒式文物,测绘,以及今天申报的TS地表飞船. SHACL-引擎对实例和实时 A-box 知识图的验证(一个 SPARQL 商店- Ontotext GraphDB 参考文献, 由 `identity-directory`)是第2阶段,由消费者按225 第11个谱线接通——即使这样,本体学仍保持一个验证器,从不成为权威.

> 测试网/飞行员准备 生产启动在基础README的公开核对表上进行——包括第三方合同审计和治理关键轮换。 追踪所有安全发现 [`docs/audits/findings.yaml`](https://npmcn.com/package/docs/audits/findings.yaml)。 。 。 .

**权威规格 :** [`specs/225-ontology.md`](https://npmcn.com/package/specs/225-ontology.md). 地壳: `CLAUDE.md` + 键 `capability.manifest.json`。 。 。 .

## 构建

```bash
pnpm --filter @agenticprimitives/ontology typecheck
pnpm --filter @agenticprimitives/ontology test
pnpm --filter @agenticprimitives/ontology build
```

## 常见问题

### @agenticprimitives/ontology 是什么？

Monorepo全用正文词汇\(RDFS/OWL T-box \+ SHACL/SKOS C-box \+ A-box settings\)用于代理原始人\. 离链真相源 链上肿瘤 \(ADR-0009\) 即时反应\. 船舶 TTL/JSON-LD 文物\+打出IRI常数\.

### 如何安装 @agenticprimitives/ontology？

在项目目录运行 npm install @agenticprimitives/ontology，或使用 pnpm add / yarn add / bun add。

### @agenticprimitives/ontology 支持 TypeScript 吗？

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

### @agenticprimitives/ontology 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/ontology 可以商用吗？

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

### @agenticprimitives/ontology 的下载量有多少？

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

### @agenticprimitives/ontology 还在维护吗？

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