# @aveltens/pi-kit-linked-data 中文文档

规范地址：https://npmcn.com/package/%40aveltens/pi-kit-linked-data/

版本：0\.10\.3
npm 元数据更新时间：2026-10-28T20:02:46.861Z
中文译文更新时间：2026-11-07T07:51:28.738Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：348 kB，67 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：10 个
- peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-05-12T22:02:43.774Z
- 最新版本发布：2026-10-28T20:02:44.503Z
- 近 30 天下载量：2160（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

Pi 编码代理技能和与 RDF, SPARQL 和其他链接数据技术合作的扩展

## 安装

```sh
npm install @aveltens/pi-kit-linked-data
```

也可以使用：`pnpm add @aveltens/pi-kit-linked-data`、`yarn add @aveltens/pi-kit-linked-data`、`bun add @aveltens/pi-kit-linked-data`

## README

# @aveltens/pi- kit- 链接数据

Pi编码代理技能和扩展,与RDF,SPARQL等链接数据技术合作.

将工具和匹配技能添加到 [Pi 编码代理](https://pi.dev/)数字 :

| 工具 | 它会做什么 |
| --- | --- |
| `sparql_query_files` | 运行 SPARQL 1. 1 对本地 RDF/ Turtle 文件的查询 |
| `sparql_query_endpoint` | 通过 URL 查询任何远程 SPARQL 端点 |
| `sparql_query_wikidata` | 查询 Wikidata 知识图 真实世界的事实 |

还包括两个发现工具: `discover_rdf_files` 财务报告和审定财务报表 `discover_sparql_queries`。 。 。 .

## 快速启动

### 安装

```bash
pi install npm:@aveltens/pi-kit-linked-data
```

在不永久安装的情况下尝试软件包:

```bash
pi -e npm:@aveltens/pi-kit-linked-data
```

每个项目安装(通过 `.pi/settings.json`:

```bash
pi install -l npm:@aveltens/pi-kit-linked-data
```

### 查询本地 RDF 文件

把一些Turtle文件放在工作空间,然后用简单的英语问Pi:

> _"我的本体学中定义了什么课?"_ _"把SKOS的所有概念都标出标签"_ _"寻找所有类型的计划资源:人物"_

皮会跑的 `discover_rdf_files` 查找文件并 `sparql_query_files` 问他们.

### 查询远程 SPARQL 端点

> _"德国人口查询"_ _"列出现有课程 [https://example.org/sparql (中文(简体) )](https://example.org/sparql)""("史记")_

Pi 用途 `sparql_query_endpoint` 并自动处理 PRIFIX 声明.

### 查询维基数据

> _"20世纪法国总统是谁"_ _"日本的首都是?"_ _"自2010年起列出所有诺贝尔物理学奖获得者名单"_

Pi 用途 `sparql_query_wikidata`,该前置输入所有标准 Wikidata 前缀(`wd:`, (中文(简体) ), `wdt:`, (中文(简体) ), `wikibase:`——不需要申报.

## 包含什么

### 工具

| 工具 | 说明 |
| --- | --- |
| `sparql_query_files` | 执行SPARQL 1.1(SELECT/ASK/CONSTRUCT/DESCRIBE)针对当地 `.ttl`, (中文(简体) ), `.rdf`, (中文(简体) ), `.n3`, (中文(简体) ), `.jsonld`, (中文(简体) ), `.trig`, (中文(简体) ), `.nq`, (中文(简体) ), `.nt` 使用 Comunica 的文件 |
| `sparql_query_endpoint` | 执行 SPARQL 1.1 对 HTTP 上的任何远程端点 |
| `sparql_query_wikidata` | 对 Wikidata 查询服务执行 SPARQL 1. 1 , 并预插出标准前缀 |
| `discover_rdf_files` | 在工作空间中查找所有 RDF 数据文件 |
| `discover_sparql_queries` | 查找全部 `.rq` 编号 : `.sparql` 查询工作空间中的文件 |

### 图标

| 命令 | 说明 |
| --- | --- |
| `/rdf-memory-explorer` | 启动本地的 HTTP 服务器,并在聊天中打印 URL —— 在任意浏览器中打开它来浏览存储并视同运行 SPARQL 查询 。 在集装箱和边远地区工作. |

### 技能

技能指导Pi关于何时以及如何使用工具:

-   **sparql-query 文档** - 语义图正反向、类/财产发现,再利用现有 `.rq` 文件
-   **sparql-query- 端点** ——端点探索,输出格式选择,PRIFIX声明
-   **sparql-query-维基数据** - 实体/财产模型、标签服务模式、多跳转

## CLI 工具

软件包传送两个命令行工具,您可以从您的项目直接运行.

添加便利 `scripts` 给您的 `package.json`数字 :

```json
{
  "query": "cd .pi/npm && npx pi-kit-query",
  "validate": "cd .pi/npm && npx pi-kit-validate"
}
```

然后使用它们,比如:

```bash
npm run query
npm run validate
```

## 所需资源

-   [Pi 编码代理](https://pi.dev/) - 任何版本

## 常见问题

### @aveltens/pi-kit-linked-data 是什么？

Pi 编码代理技能和与 RDF, SPARQL 和其他链接数据技术合作的扩展

### 如何安装 @aveltens/pi-kit-linked-data？

在项目目录运行 npm install @aveltens/pi-kit-linked-data，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（\*）、@earendil-works/pi-ai（\*）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 pi-kit-query、pi-kit-validate，可以用 npx pi-kit-query 直接运行。

### @aveltens/pi-kit-linked-data 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aveltens\_\_pi-kit-linked-data 是否存在。

### @aveltens/pi-kit-linked-data 支持 ESM 还是 CommonJS？

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

### @aveltens/pi-kit-linked-data 可以商用吗？

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

### @aveltens/pi-kit-linked-data 的下载量有多少？

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

### @aveltens/pi-kit-linked-data 还在维护吗？

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