# @agenticprimitives/geo-features 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/geo-features/

版本：0\.0\.0-alpha\.42
npm 元数据更新时间：2026-10-26T11:49:30.706Z
中文译文更新时间：2026-11-06T17:05:09.179Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：34 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-06-11T04:59:59.161Z
- 最新版本发布：2026-10-26T11:49:18.218Z
- 近 30 天下载量：2650（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

链外地物索赔证书+链上地物登记帮助者(第251段)。 链条上的特征;代理QQQfeatal claim是指向一个(featureId,版本)的私人金库证书.

## 安装

```sh
npm install @agenticprimitives/geo-features
```

也可以使用：`pnpm add @agenticprimitives/geo-features`、`yarn add @agenticprimitives/geo-features`、`bun add @agenticprimitives/geo-features`

## README

# @ agenticprimitives/ 地理地物

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

**代理人运作的地方是最敏感的事实之一——大多数地理登记处默认公布.** 协调需要共享每个人可以参考的地理环境;安全需要代理人-地点协会保持保密。 此套件拆分两个: a **地理特征** 是一个公开的,版本的,在链上锁定 `GeoFeatureRegistry` (几何散列物+覆盖/来源根+粗细的bbox;准确的GeoJSON不连锁);a **地质索赔** ——智能特工与特写的关系——是 **私人可核查的证书 在那个特工的金库**,指向链上 `(featureId, version)`协会从来不是连锁的——它会泄露业务数据.

由于主体和发行商是智能代理地址,验证人通过签署 `endorsementDigest` 具有自己的链上身份(ERC-1271-可验证),该主张在主体的关键旋转中幸存下来,而选择进入的公开主张则重新使用通用 [`attestations`](https://npmcn.com/package/%40agenticprimitives/attestations) 证书-hash路径——绝不是地理特有契约.

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

## 今天的什么战舰

这个SDK拥有证书形状(`GeoClaimCredential`),自负/自负的建设者,承诺/最深的数学,以及一薄的链上功能读取器([第251类](https://npmcn.com/package/specs/251-skills-and-geo-features.md):

-   **构建器** —— 说 `buildSelfGeoClaim` 财务报告和审定财务报表 `buildEndorsedGeoClaim` (交叉发行;返回 `endorsementDigest` 发行者标志.
-   **代码列表** —— 说 `GEO_KIND` (与 `GeoFeatureRegistry.KIND_*` 在链上, [ADR-0009 (英语)](https://npmcn.com/package/docs/architecture/decisions/0009-on-chain-ontology-shacl-naming.md), (中文(简体) ), `GEO_RELATION`, (中文(简体) ), `GeoVisibility`全都是凯查克的杂草 `ns/geo#` C-box概念URIs.
-   **数学** —— 说 `computeFeatureId`, (中文(简体) ), `geometryHash`, (中文(简体) ), `geoClaimId`, (中文(简体) ), `geoEndorsementDigest`, (中文(简体) ), `geoClaimHash`。 。 。 .
-   **特性读取器** —— 说 `geoFeatureExists(read, registry, ref)` 通过注射 `readContract` 函数(无viem/合同依赖)+ `GEO_FEATURE_READ_ABI`。 。 。 .

```ts
import { buildEndorsedGeoClaim, GEO_RELATION, geoFeatureExists } from '@agenticprimitives/geo-features';

const { credential, endorsementDigest } = buildEndorsedGeoClaim({
  chainId: 84532,
  subject: orgAgent,
  issuer:  validator,
  feature: { featureId, version: 1 },     // points to the on-chain GeoFeatureRegistry
  relation: GEO_RELATION.servesWithin,
  visibility: 'public-coarse',
  nonce,
});
// the issuer signs `endorsementDigest` (ERC-1271); the app stores `credential` in the subject's vault.
```

Vault I/O是应用程序的工作——这个包是可忽略的。 精确的几何学不连锁(SDK只处理它的 `geometryHash`(三); `evidenceCommit` 是一个字节32的承诺,从来没有URI.

## 怎么不一样

开放边界数据集和地理空间登记处回答"存在的地方";它们没有"哪个代理人可以核查地运行,按照代理人的术语披露"的模式. 这里的三角洲:

1.  **只有中立的公共地理.** 一个特点是一个通用的公共场所——它从未被操作或敏感性数据所标记. 灵敏度(英語:Sensitive)是一款以中性特征为上层的脱链应用政策(Spec 251 GFR-07).
2.  **占有是私人的默认.** 代理商声称在代理商的金库里是一家签名的VC;能见度级(`public-coarse`, (中文(简体) ), `private-commitment`, (中文(简体) ), `private-zk`,.)让持有者选择披露颗粒.
3.  **锁定,CI检查.** `GEO_KIND.Region === GeoFeatureRegistry.KIND_REGION` ——代码列表被绑定在合同常数上,因此SDK不能从链中漂出.

技能是独立的兄弟 [`@agenticprimitives/capability-claims`](https://npmcn.com/package/%40agenticprimitives/capability-claims) ——没有技能QQGeo映射;"技能X在Y区"的事实是两个独立的主张. 中性底物: 无垂直词汇 ([ADR-0021 (英语)](https://npmcn.com/package/docs/architecture/decisions/0021-generic-packages-vs-white-label-apps.md)) (中文(简体) ).

## 状态

**W1地基——Spec-251技能/地基的离链地层被运出.** 链上对等点是 `GeoFeatureRegistry.sol` 内 [`packages/contracts`](https://npmcn.com/package/%40agenticprimitives/contracts)。见 [审计](https://npmcn.com/package/%40agenticprimitives/geo-features/AUDIT.md)。 。 。 .

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

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

## 构建

```bash
pnpm --filter @agenticprimitives/geo-features typecheck
pnpm --filter @agenticprimitives/geo-features test
pnpm --filter @agenticprimitives/geo-features build
```

## 常见问题

### @agenticprimitives/geo-features 是什么？

链外地物索赔证书\+链上地物登记帮助者\(第251段\)。 链条上的特征;代理QQQfeatal claim是指向一个\(featureId,版本\)的私人金库证书\.

### 如何安装 @agenticprimitives/geo-features？

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

### @agenticprimitives/geo-features 支持 TypeScript 吗？

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

### @agenticprimitives/geo-features 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/geo-features 可以商用吗？

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

### @agenticprimitives/geo-features 的下载量有多少？

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

### @agenticprimitives/geo-features 还在维护吗？

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