@happyvertical/smrt-assets-ergot

中文文档
0.62.1发布于 2026/11/17MITTypeScriptES Module近 30 天下载 1.4万

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

中文使用文档
文档目录6 节
  1. 安装
  2. 快开始
  3. 能力
  4. 来源参考和产出
  5. 公共 API
  6. 发展

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

支持的处理、搜索、同步和工作流程能力 s-m-r-t 资产运行时间。 应用程序继续使用 @happyvertical/smrt-assets 作为其资产 API 并选择 进入Ergot时只有时间.

当应用程序需要基于 MAM 的搜索、 生成媒体时使用此适配器 候选人、云处理器、工作流程或与 Ergot 同步 图书馆。 使用 smrt-assets-local 轻量级 本地图像处理 .

安装

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

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

快开始

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最小客户端与主机设备签约
ErgotAssetSummaryErgot 资产中性提供方视图
ErgotAssetProcessorOptions客户端和源系统配置

发展

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

见 AGENTS.md 供养者、承租者、以及世系变化者.

版本与发布记录

@happyvertical/smrt-assets-ergot 共发布 366 个版本,首次发布于 2026/06/23;过去 12 个月发布了 366 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-assets-ergot 的常见问题

@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 和提交记录判断。