@happyvertical/smrt-assets

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

为SMRT框架提供版本、元数据和AI授权操作的资产管理系统

中文使用文档
文档目录12 节
  1. 特色食谱
  2. 安装
  3. 使用量
  4. 便携式本地存储
  5. API 密码
  6. 模型( smrt 对象)
  7. 收藏( 收藏)
  8. 公用事业
  9. 类型
  10. 依赖关系
  11. 本地私人附属物
  12. 多态相交集类型

@happy垂直/smrt-资产

提供人-不可知资产管理,包括版本、类型分类、元数据领域和通用/认证协会.

AssetAssociation 是将资产与任意 对象,当没有模型所有名词加入表格。 基地/领域 关系应使用专用连接,例如 content_assets, (中文(简体) ), profile_assets, (中文(简体) ), event_assets, (中文(简体) ), place_assets,以及 product_assets。 。 。 .

特色食谱

assets.library 提供模型支持的文件和媒体库:资产, 文件夹、分类、状态和元数据定义. assets.attachments 添加记录附件来源并需要库. 他们分享 文件和媒体 分类卡和目录 资产 导航 区域,并同时在生成的列表中嵌入了用户显示的帮助。 食谱 发布浏览器安全模拟固定导出 @happyvertical/smrt-assets/playground。 。 。 . AssetManager 需要主机持续回调和 AttachmentPanel 需求 记录范围授权附件,因此两个附件都不宣布为独立附件 放置。 储存供应商仍然拥有应用程序,因此秘方宣布 无供养.

套接字游乐场是一个 Moock 预览. 其资产网格使用记忆道具 和数据 URI 缩略图,及其附件面板显示提供了本地 表格数据。 它从不执行真正的网络上传或创建公共 存储 URL.

安装

pnpm add @happyvertical/smrt-assets

使用量

import {
  Asset, AssetCollection,
  AssetType, AssetStatus, AssetMetafield,
  AssetAssociation, AssetAssociationCollection,
  Folder, FolderCollection,
  AssetStore,
} from '@happyvertical/smrt-assets';

// Create lookup records
const imageType = new AssetType({ slug: 'image', name: 'Image' });
await imageType.save();

const published = new AssetStatus({ slug: 'published', name: 'Published' });
await published.save();

// Create an asset
const photo = new Asset({
  name: 'Product Photo',
  slug: 'product-photo-001',
  sourceUri: 's3://bucket/products/photo-001.jpg',
  mimeType: 'image/jpeg',
  typeSlug: 'image',
  statusSlug: 'published',
  version: 1,
});
await photo.save();

// Versioning -- chain via primaryVersionId, increment version number
const v2 = new Asset({
  ...photo, slug: 'product-photo-002', version: 2, primaryVersionId: photo.id,
  sourceUri: 's3://bucket/products/photo-002.jpg',
});
await v2.save();

// Derivatives via sourceAssetId (renamed from `parentId` in R3-D)
const thumb = new Asset({
  name: 'Thumbnail', slug: 'product-photo-001-thumb', sourceAssetId: photo.id,
  sourceUri: 's3://bucket/products/photo-001-thumb.jpg',
  mimeType: 'image/jpeg', typeSlug: 'image', statusSlug: 'published',
});
await thumb.save();

// Generic/provenance association -- link asset to an arbitrary object
const assoc = new AssetAssociation({
  assetId: photo.id,
  metaType: 'Image',
  metaId: 'derived-image-123',
  role: 'derivation-source',
  sortOrder: 0,
});
await assoc.save();

// Base/domain-owned asset relationships should use dedicated noun joins instead:
// content_assets, profile_assets, event_assets, place_assets, product_assets

// Folder organization (its own SmrtHierarchical model, `folders` table)
const folder = new Folder({ name: 'Product Images', slug: 'product-images' });
await folder.save();
// Move an asset into a folder
photo.folderId = folder.id;
await photo.save();

// AssetStore -- provider-agnostic file I/O + record creation
const store = await new AssetStore(assetRoot, collection).initialize();
await store.store('screenshot', buffer, { mimeType: 'image/png' });

便携式本地存储

对于新的桌面安装, 通过相同的便携式存储配置 用于处理其管理文件的资产运行时间、工人和服务:

const assets = await createAssetRuntime({
  db,
  storage: { type: 'local', basePath: assetRoot, locatorMode: 'relative' },
});

使用绝对的,应用的 assetRoot。该商店持续 asset-local:<key>,例如 asset-local:document/17f6.txt。 。 。 . 密钥是在所配置的根下一个原始的,被斜线分隔的路径 包含不跳出 URL。 使用 ASCII 字母、数字、下划线和 型号为"鼻涕"和"ID"的连字符. 商店拒绝转弯,绝对的钥匙, Windows设备名称,根部或下方的链接,以及非正则文件. 保留 ; 文件系统检查假设 不通过不信任的本地进程同时进行修改.

复制安装时, 复制数据库和资产目录 并设定 basePath 转到已复制的目录。 通过 运行时间。 存储解析器可以选择便携式写入的路径, 但是 以后读取和删除必须使用内建本地密钥 运行时间的文件系统 .

选项只更改新写 。 现有的本地选项和S3 定位器保留其格式. 本地商店可以读取便携 定位器是否选择写入它们 。 在便携式模式下, 现有 file:// 定位器仍然可以读取或删除 在配置的根内识别一个有效的密钥; 更改根 不移动此类记录。 从新的桌面数据或手柄开始 在移动安装前已有绝对定位器.

API 密码

模型( smrt 对象)

导出说明
Asset具有版本的核心资产(primaryVersionId, (中文(简体) ), version),衍生链(sourceAssetId, (中文(简体) ), sourceUri, (中文(简体) ), mimeType, (中文(简体) ), typeSlug, (中文(简体) ), statusSlug, (中文(简体) ), ownerProfileId
AssetAssociation通用/ 证明多态结合 : assetId + 键 metaType + 键 metaId + 键 role + 键 sortOrder; 不包括已经拥有名词表的基数/域名加盟
AssetType资产类型分类查询表
AssetStatus生命周期状态查询表
AssetMetafield自定义带有 JSON 验证规则的元数据字段定义
Folder资产分级容器;自有 folders 扩展的表格 SmrtHierarchical

收藏( 收藏)

导出说明
AssetCollection资产收缴
AssetAssociationCollection为资产协会募捐
AssetTypeCollection资产类型收藏
AssetStatusCollection资产状况收集
AssetMetafieldCollection资产Metafield的收藏
FolderCollection文件夹收藏

公用事业

导出说明
AssetStore提供者不可知文件 I/O , 它会写入存储和创建资产记录的缓冲

类型

导出说明
AssetOptions备选方案 Asset 构造器
AssetAssociationOptions备选方案 AssetAssociation 构造器
AssetTypeOptions备选方案 AssetType 构造器
AssetStatusOptions备选方案 AssetStatus 构造器
AssetMetafieldOptions备选方案 AssetMetafield 构造器
FolderOptions备选方案 Folder 构造器
StoreOptions备选方案 AssetStore.store()
ProviderOptions提供者配置 AssetStore

依赖关系

软件包目的
@happyvertical/smrt-coreORM 基础( Smrt Object, Smrt Collection)
@happyvertical/smrt-tags标签集成( E)addTag编号 :removeTag (单位:千美元)
@happyvertical/smrt-tenancy备选租户范围界定
@happyvertical/files资产仓库的提供者不可知文件系统

本地私人附属物

AttachmentPanel, (中文(简体) ), AttachmentList 财务报告和审定财务报表 AttachmentUpload 授权编制 私人链接,呼叫器提供版本历史,以及本地多段上传. 它们保留请求身份和失败操作元数据而不产生 公共存储 URL. 见 附加合同 页:1 公共类型、当地有效载荷、回收和服务器责任.

过 onremove(attachment) 和(或) removeAction (原始内容存档于2019-10-21) (中文(简体) ) 添加已确认的每个附件删除按钮;见 合同中的"去除附件".

多态相交集类型

AssetAssociationCollection 扩展 SmrtJunctionBase共享 byRight, (中文(简体) ), 命令,定位,和登记警卫 与普通的交叉口。 内容 byLeft, (中文(简体) ), attach, (中文(简体) ), detach,以及 setLinks 两种方法都需要 metaType 财务报告和审定财务报表 metaId;它们不执行单所有者 SmrtJunction 合同. 使用 instanceof SmrtJunctionBase 认清任何一种交叉点时. 资产协会不再满足 instanceof SmrtJunction。 。 。 .

在建造工作空间后, node scripts/verify-packed-junction-types.mjs 使用 skipLibCheck: false,继承的结果类型,以及负所有者-参数测试. 完整的节点Next声明可移植性在#3524中单独跟踪.

消费者固定安装在临时目录中宣布的依赖性 没有祖先 node_modules;它从来不连接生产者的依赖性. 它保留 项目的公开登记路线,不复制证书。 设定 SMRT_PACKED_EVIDENCE_DIR 保留柏油球和消费锁文件。 对于一个 (c) 明确分开的上游验证, SMRT_PACKED_OVERRIDES 可能名称 a Pnpm 的 JSON 文件覆盖;这种证明不能证明正常 已公布的依赖性图表.

版本与发布记录

@happyvertical/smrt-assets 共发布 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 的常见问题

@happyvertical/smrt-assets 是什么?

为SMRT框架提供版本、元数据和AI授权操作的资产管理系统

如何安装 @happyvertical/smrt-assets?

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

@happyvertical/smrt-assets 支持 TypeScript 吗?

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

@happyvertical/smrt-assets 支持 ESM 还是 CommonJS?

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

@happyvertical/smrt-assets 可以商用吗?

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

@happyvertical/smrt-assets 的下载量有多少?

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

@happyvertical/smrt-assets 还在维护吗?

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