# @happyvertical/smrt-assets-ergot 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-assets-ergot/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:55:10.754Z
中文译文更新时间：2026-11-17T10:31:23.209Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：31 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-06-23T01:18:24.699Z
- 最新版本发布：2026-11-17T07:55:10.555Z
- 近 30 天下载量：13883（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：366（近 12 个月 366 个）

## 中文简介

SMRT资产支持的处理、搜索和工作流程适配器

## 安装

```sh
npm install @happyvertical/smrt-assets-ergot
```

也可以使用：`pnpm add @happyvertical/smrt-assets-ergot`、`yarn add @happyvertical/smrt-assets-ergot`、`bun add @happyvertical/smrt-assets-ergot`

## README

# @happyvertical/smrt-assets-ergot (欢快的垂直)

支持的处理、搜索、同步和工作流程能力 s-m-r-t 资产运行时间。 应用程序继续使用 [`@happyvertical/smrt-assets`](https://npmcn.com/package/%40happyvertical/assets/README.md) 作为其资产 API 并选择 进入Ergot时只有时间.

当应用程序需要基于 MAM 的搜索、 生成媒体时使用此适配器 候选人、云处理器、工作流程或与 Ergot 同步 图书馆。 使用 [`smrt-assets-local`](https://npmcn.com/package/%40happyvertical/assets-local/README.md) 轻量级 本地图像处理 .

## 安装

```bash
pnpm add @happyvertical/smrt-assets @happyvertical/smrt-assets-ergot
```

适配器在结构上围绕一个小型消费客户端进行打字. 没有 强制每个s-m-r-t应用程序安装 Ergot SDK.

## 快开始

```ts
import { createAssetRuntime } from '@happyvertical/smrt-assets';
import {
  createErgotAssetProcessor,
  type ErgotConsumerAssetClient,
} from '@happyvertical/smrt-assets-ergot';

const ergot: ErgotConsumerAssetClient = createErgotClient();
const runtime = await createAssetRuntime({
  db: 'assets.db',
  storage: './data/assets',
  capabilityProviders: [createErgotAssetProcessor({ client: ergot })],
});

const asset = await runtime.storeSourceAsset(
  'Lead image',
  imageBytes,
  { mimeType: 'image/jpeg', typeSlug: 'image' },
);

const synced = await runtime.syncExternalAsset(asset);
console.log(synced.externalAssetId);
```

同步使用稳定的源引用和外部ID. 一个S-m-r-t资产 身份证和Ergot资产身份证是不同的身份,绝不能被当作 可互换.

## 能力

| 资产运行时间 | 错误的行为 |
| --- | --- |
| `syncExternalAsset()` | 通过源代码查找或上传 |
| `searchNearbyAssets()` | 调查Ergot附近的房客搜索 |
| `ensureVariant()` | 可用时解决 Egot 交付变体 |
| `submitAssetWorkflow()` | 提交带有源行的工作流程 |
| `processAsset()` | 支持处理到 Ergot 的代表 |

能够披露租户数据的每一项要求都必须包含租户范围。 直接资产 即使上游客户端已经列出范围, 任务检查也会被验证 操作.

## 来源参考和产出

-   `sourceRef` 是犬形同位素同步键.
-   `externalId` 当消费者已经拥有稳定的上游密钥时使用.
-   产生的候选人在获得核准和成为候选人之前仍是候选人 s-m-r-t 资产运行时间.
-   变位元可以参考 Ergot 交付 URL而不复制字节.
-   工作流程产出保持来源资产和Ergot工作的分界线.

## 公共 API

| 导出 | 目的 |
| --- | --- |
| `createErgotAssetProcessor()` | 创建 s-m-r- t 容量提供者 |
| `ErgotConsumerAssetClient` | 最小客户端与主机设备签约 |
| `ErgotAssetSummary` | Ergot 资产中性提供方视图 |
| `ErgotAssetProcessorOptions` | 客户端和源系统配置 |

## 发展

```bash
pnpm --filter @happyvertical/smrt-assets-ergot test
pnpm --filter @happyvertical/smrt-assets-ergot typecheck
pnpm --filter @happyvertical/smrt-assets-ergot build
```

见 [`AGENTS.md`](https://npmcn.com/package/%40happyvertical/smrt-assets-ergot/AGENTS.md) 供养者、承租者、以及世系变化者.

## 常见问题

### @happyvertical/smrt-assets-ergot 是什么？

SMRT资产支持的处理、搜索和工作流程适配器

### 如何安装 @happyvertical/smrt-assets-ergot？

在项目目录运行 npm install @happyvertical/smrt-assets-ergot，或使用 pnpm add / yarn add / bun add。

### @happyvertical/smrt-assets-ergot 支持 TypeScript 吗？

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

### @happyvertical/smrt-assets-ergot 支持 ESM 还是 CommonJS？

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

### @happyvertical/smrt-assets-ergot 可以商用吗？

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

### @happyvertical/smrt-assets-ergot 的下载量有多少？

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

### @happyvertical/smrt-assets-ergot 还在维护吗？

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

