# @ethisyscore/protocol 中文文档

规范地址：https://npmcn.com/package/%40ethisyscore/protocol/

版本：0\.77\.1
npm 元数据更新时间：2026-10-25T16:31:36.335Z
中文译文更新时间：2026-11-13T23:47:15.066Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40ethisyscore/protocol
原文对照：https://npmcn.com/package/%40ethisyscore/protocol/?lang=original

弃用说明：This package has moved to the Ethisys Core package feed\. In Ethisys Core, open the Developers page and follow the setup steps \(cc login connects npm to the feed\)\.

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

- 包体积（解压后）：955 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：1 个
- 首次发布：2026-05-20T10:38:20.115Z
- 最新版本发布：2026-10-24T20:02:33.336Z
- 近 30 天下载量：9996（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：93（近 12 个月 93 个）

## 中文简介

EthysCore插件生态系统的Canonical协议类型(明显,SDUI,桥梁,能力,主题).

## 安装

```sh
npm install @ethisyscore/protocol
```

也可以使用：`pnpm add @ethisyscore/protocol`、`yarn add @ethisyscore/protocol`、`bun add @ethisyscore/protocol`

## README

# @ethisyscore/ protocol (英语)

EthysCore插件生态系统的 Canonical TypeScript 协议类型.

此软件包是 .NET 的 TypeScript 同伴 `EthisysCore.Protocol` NuGet软件包. 它暴露出相同的有线级合同,使得主机App Bridge和任何未来的TypeScript客户端都消耗了相同的类型.

## 范围(1.0)

此发布会登陆能力第一插件运行时间的基础层 :

-   **插件显示** —— 说 `PluginManifest`, (中文(简体) ), `RenderMode`选择 `PluginUi` 子形状( n)`src/manifest.ts`) (中文(简体) ).
-   **SDUI 原始词汇 v1** —— 说 `KNOWN_PRIMITIVES`递归 `SduiNode` 计划( s)`src/sdui/primitives.ts`) (中文(简体) ).
-   **JsonLogic 运算符子集 + 反应规则类型** —— 说 `KNOWN_OPERATORS`, (中文(简体) ), `KNOWN_RULE_KINDS`, (中文(简体) ), `ReactiveRule` (单位:千美元)`src/sdui/operators.ts`) (中文(简体) ).
-   **门户贡献+主机位分类** —— 说 `PortalContribution`, (中文(简体) ), `KNOWN_SLOTS`, (中文(简体) ), `HostSlot` (单位:千美元)`src/sdui/portal.ts`) (中文(简体) ).
-   **主题符号** ——主机渲染器所消耗的设计接罐外形 (`src/theme/tokens.ts`) (中文(简体) ).
-   **能力索赔** - 许可和能力交换机类型(`src/capability/permissions.ts`, (中文(简体) ), `src/capability/token.ts`) (中文(简体) ).
-   **桥口版本常数** —— 说 `BRIDGE_VERSION` (单位:千美元)`src/bridge/version.ts`) (中文(简体) ).

未来的合同(参考数据、数据储存、MCP、事件、伐木、通知、运输、包装、主机召回)尚未纳入这一包——随着消费客户登陆,将添加添加这些合同.

## 安装

```bash
npm install @ethisyscore/protocol
```

## 脚本

```bash
npm run build       # bundle ESM + CJS + d.ts via tsup
npm test            # run vitest in CI mode
npm run test:watch  # vitest in watch mode
npm run lint        # tsc --noEmit type check
```

## 版式

-   `src/index.ts` - 公共枪管
-   `src/manifest.ts` — 插件显示 + 渲染模式
-   `src/sdui/` ——SDUI原始人,运营商,门户贡献
-   `src/route-template.ts` —— 说 `{param}` contract A表面(RFC 0019)的路由模板语法: `scanSurfaceRoute`, (中文(简体) ), `matchRoute`, (中文(简体) ), `substituteRouteParameters`, (中文(简体) ), `getRouteShape`, (中文(简体) ), `requiredContractVersionForSurfaces`
-   `src/sdui/contract-a.ts` - 较丰富的合同A道具(RFC 0020):每套Zod schemas,封闭列表, `DATA_TABLE_QUERY_ARGUMENTS` (主机发送的参数 `DataTable`工具,返回 a `PagedResponse`, (中文(简体) ), `requiredContractVersionForDocument` (最小插件- UI 合同版本文件需要,与 `isContractVersionSupported`, (中文(简体) ), `isToolInNamespace` (前缀+宣布的工具成员), `isPluginRelativeRoute`, (中文(简体) ), `isContractAIcon` (主像符号), `CONTRACT_A_LIMITS`, (中文(简体) ), `validateContractADocument`
-   `src/sdui/bindings.ts` - 封闭装订集 `$route.<param>`, (中文(简体) ), `$row.<field>` (RFC 0020),只在顶级工具中识别 `args` 价值和 `Field.defaultValue`
-   `src/theme/` 设计符号
-   `src/capability/` 权限和能力要求
-   `src/bridge/` ——桥版常数
-   `src/__tests__/` - 检测
-   `dist/` ——建设产出(已忽略)

## 兼容性

将此软件包作为公共兼容边界 。 偏好添加剂改变; 不重用enum值; 不在未协调放出的情况下进行断裂JSON形状改变.

词汇表(SDUI原始语,JsonLogic运算符,活性规则类型,主机位分类学) 由记录在 [`docs/rfcs/README.md`](https://npmcn.com/docs/rfcs/README.md). CI 自动回放 PR 扩展词汇而无需接受 RFC.

## 常见问题

### @ethisyscore/protocol 是什么？

EthysCore插件生态系统的Canonical协议类型\(明显,SDUI,桥梁,能力,主题\)\.注意：该包已被作者标记为弃用——This package has moved to the Ethisys Core package feed\. In Ethisys Core, open the Developers page and follow the setup steps \(cc login connects npm to the feed\)\.

### 如何安装 @ethisyscore/protocol？

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

### @ethisyscore/protocol 支持 TypeScript 吗？

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

### @ethisyscore/protocol 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ethisyscore/protocol 需要什么版本的 Node\.js？

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

### @ethisyscore/protocol 可以商用吗？

@ethisyscore/protocol 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @ethisyscore/protocol 的下载量有多少？

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

### @ethisyscore/protocol 还在维护吗？

最新版本 0\.77\.1 发布于 2026/10/25（20 天前）；至今共发布 93 个版本，其中过去 12 个月发布了 93 个；首次发布于 2026/05/20。作者已将其标记为弃用，新项目建议寻找替代方案。