# @consiliency/contract 中文文档

规范地址：https://npmcn.com/package/%40consiliency/contract/

版本：0\.6\.5
npm 元数据更新时间：2026-07-09T07:44:48.292Z
中文译文更新时间：2026-11-10T15:59:07.387Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：242 kB，91 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-07-02T00:06:50.682Z
- 最新版本发布：2026-07-09T07:44:48.013Z
- 近 30 天下载量：10442（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

协和跨repo合同包:共享的JSON合同数据,符合矢量,薄npm/PyPI阅读器,以及Cononical html.v1公共合同表面.

## 安装

```sh
npm install @consiliency/contract
```

也可以使用：`pnpm add @consiliency/contract`、`yarn add @consiliency/contract`、`bun add @consiliency/contract`

## README

# @ 和谐/ 合同

协和互换 **合同包** —— 单一的,中立的规则书: `agent-harness` 财务报告和审定财务报表 `governed-pipeline` 销售商(由两个供应商拥有)。 它定义:

-   页:1 `.consiliency/` 布局 + 显示方案
-   页:1 **类型登记** —— 说 `product` 编号 : `service` 编号 : `library` 编号 : `infra` 编号 : `tooling-meta` 编号 : `experiment` 编号 : `document`,加上修改器(`data-bearing` 编号 : `public` 编号 : `regulated` 编号 : `user-facing`),与 `baseline-only` 作为法律声明
-   每个类型(7个文件类)所需文件集
-   界面声明计划(实现 + 承诺的交叉检索边缘)
-   循环门协议(存在/新鲜度/完整性/版本-sew)
-   页:1 `canonical_html.v1` 显示方案
-   版本-sew 协议
-   **\+ 治理范围(CS-0.12)** ——通过简介(部分通过简介,不是布尔;其存在=同意受管)、受管设定逐项声明、默认被忽略设置的登记册和 `present-nonconforming` 编号 : `foreign` 编号 : `unmanaged` 治理标签
-   **租赁+收件箱协调(CS-0.10b)** - 那个 `lease` (TTL + 心跳 + 自动过期, 软/ 硬, repo/ path- set/ symbol 范围), 仅附件 `lease_event` 流,该 `lease_store` 协议(唯一的真相来源)和 `coordination_channel` 收件箱协议( 从来没有权威性)
-   **预测发现 + git-rocade(切片 C0)** - 那个 `projections.index.v1` 计划(确定性纯相聚指数的每颗卫星投影表,无) `generated_at`,所以每个驱动程序复制字节相同的条目 `git_discipline_protocol` (管道自备的参考课程、租赁+脚印、合并政策以及 **从来没有 德莱特 -赫曼 -雷夫斯** 以无常为规则 `pipeline_ref_classes` 两种登记时间都读取,以商定是否拥有所有权
-   **可互换性兼容性( X 切片)** —— 说 `scripts/interchangeability/run_driver_equivalence.py` 证明上述纯合并索赔并不仅仅是这个包件本身的参考合并所声称的: `projections-index-pure-merge-deterministic` 矢量通过真实 `spec-render/build_projections_index.py` 生产者和声称的字节相同产出,实事求是(见 `scripts/interchangeability/README.md`(中文(简体) )
-   **合同核心(XG-1 Sice 1)** - 单一的,加密的认证 `authority_event_protocol.v1` 计划与 **核心/链签名拆分** (端口为独立槽签名) `core`; 光谱附件 `chain` 退出签名,永远不要重签),一 **犬形字节算法** 可在Node 20的无依赖性联合来文中执行(见 [`docs/design/authority-event-canonical-bytes.md`](https://npmcn.com/package/%40consiliency/contract/docs/design/authority-event-canonical-bytes.md)),销售商的文摘标注 `authority_key_registry.v1` **Ed25519 信任根** (仅公用密钥),一个Ed25519在两个读取器中验证引用,以及13个符合矢量——一个在读取器和每个伪造类中都是有效的事件VERIFIES(不良/丢失的签名,未知/攻击者密钥 id,算法-拼接,签名者QQQapprover不匹配,被撤销/过期密钥,cert digest不匹配) REJECS
-   **认证标签镜(CS-1.4, XG-1 Slice 5)** ——拆分单曲 `certified` 证据标签进入 `parity-certified` (字形可复制的等同证书,没有权威事件——今天的CS proj-S认证船)和 `authority-certified` (平等PLUS是经核实的、经人批准的权力机构活动——保留到XG-1权力机构循环土地到最终); `certified` 仅作为被腐烂的别名生存 `parity-certified`永远 `authority-certified`,因此,现有的生产者/消费者继续验证(见 [`docs/design/CS-1.4-certified-label-rescope.md`](https://npmcn.com/package/%40consiliency/contract/docs/design/CS-1.4-certified-label-rescope.md)(中文(简体) )

双重出版: **无** [`@consiliency/contract`](https://www.npmjs.com/package/@consiliency/contract) + 键 **PyPI 密码** [`consiliency-contract`](https://pypi.org/project/consiliency-contract/),来自共享的 JSON 数据 + 符合向量,因此两种语言读取器保持字节-同.

> **现况 - `0.6.5` 定义词条 `protected_source_category` 词汇表(协议的第一个生产者========= 两级计划:所需粗体 `category` (七个行刑流程桶 -- -- 之前存在的六加一新 `governance_contracts` 生产方桶 管理来源)加上可选的自由形式 `subtype` 携带 生产商的细颗粒. 这个 `protected_source_categories` 登记指针 粗矿、已注册的精矿和粗矿图 用于所有~14个受管管线细分类 `protected_source_category` 计划验证 a `{category, subtype}` 释相. SoT 定义仅- 添加剂, 无已存在的语义 变化; 受管管线和相位线在后期符合. `0.6.4` 分配冻结的平价 `certificate` 计划 联合国 `result-state` `$ref` 关闭(从光谱显示的verbatim,消化器固定在 `core/spec-parity/provenance.json`因此,外部消费者(例如,绿地) XG-6)对照真实的等效证书计划进行验证,而不是手卷, repo自有的证明证书——只添加剂,没有现行化学语义变化. `0.6.0` 将 `certified` 证据标签进入 `parity-certified` (byte-parity cert,没有权威事件——什么CS proj-). 页:1 (今天的认证船) `authority-certified` (平等PLUS a ) 经核实、经人批准的权威活动——保留至XG-1 权力循环土地端到端),保留 `certified` 作为被贬值的别名 联 合 国 `parity-certified` 只有,所以现有的生产者/消费者继续验证 (CS-1.4, XG-1 第5节;见 [`docs/design/CS-1.4-certified-label-rescope.md`](https://npmcn.com/package/%40consiliency/contract/docs/design/CS-1.4-certified-label-rescope.md)) (中文(简体) ). `0.5.1` 将权威字节钉入光谱 **罐核v2** (单位:千美元)`canonical_bytes`,而不是第4行——经证明的字节-同声+摘要固定在其中 `core/authority-canon/provenance.json`)并应用已结算的 XG-4 域分隔决定:Ed25519 签名涵盖当局概况 文摘预览 `spec-canon:v2:authority\n ‖ canonical_bytes(core)`,趋同 改为零 当conon-core 添加配置时重新签名. `0.5.0` 增加了XG-1 合同核心: `authority_event_protocol.v1` 计划(核心/链签分拆) `authority_key_registry.v1` Ed25519 信任根, 犬形字节间距 算法 + Ed25519 在两个读取器中验证引用, 以及13个伪造 符合向量. `0.4.2` 制作 `projections.index.v1` 人均到期上限 双侧: proj-code 是 `[presence-only, hash-checked]` 财务报告和审定财务报表 `proj-S-certified` 实值 `[realized-edge-observed, certified]` (倒置),替换 单侧 `not:certified` 警卫. `0.4.1` 制作逐项条目(proj-code) 标出代码 + 事实; `proj-S-certified` 需求 `source_S_digest`, (中文(简体) ), (无事实/承诺). `0.4.0` 添加 Slice C0 投影-发现+ 纪律合同`projections.index.v1`, (中文(简体) ), `git_discipline_protocol`, (中文(简体) ), `pipeline_ref_classes`在顶上 `0.3.0` 所需文件重新平衡, 页:1 `0.2.0` CS-0.12 采用/治理范围 + CS-0.10b 租赁/插箱 协调,以及 `0.1.0` 阶段0L0内容.** 共享的JSON数据生活在 `core/` 财务报告和审定财务报表 `conformance/`; npm 和 PyPI 数据 读取器是故意在相同的字节上装入薄荷的.

## 阅读器 API

Java 脚本 :

```js
import {
  CONTRACT,
  CONTRACT_VERSION,
  listVectors,
  loadContract,
  loadRegistry,
  loadSchema,
  loadVector,
  // authority-event core (XG-1 Slice 1)
  canonicalCoreBytes,
  verifyAuthorityEvent,
} from "@consiliency/contract";
```

Python : (中文(简体) )

```python
from consiliency_contract import (
    CONTRACT,
    CONTRACT_VERSION,
    list_vectors,
    load_contract,
    load_registry,
    load_schema,
    load_vector,
)
# authority-event core (XG-1 Slice 1); needs the optional `authority` extra
# (cryptography) only for signature verification.
from consiliency_contract.authority import (
    canonical_core_bytes,
    verify_authority_event,
)
```

## 核查

```sh
npm test
python -m unittest discover -s tests -p 'test_*.py'
python -m build
```

## 常见问题

### @consiliency/contract 是什么？

协和跨repo合同包:共享的JSON合同数据,符合矢量,薄npm/PyPI阅读器,以及Cononical html\.v1公共合同表面\.

### 如何安装 @consiliency/contract？

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

### @consiliency/contract 支持 TypeScript 吗？

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

### @consiliency/contract 支持 ESM 还是 CommonJS？

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

### @consiliency/contract 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @consiliency/contract 可以商用吗？

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

### @consiliency/contract 的下载量有多少？

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

### @consiliency/contract 还在维护吗？

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