# @happyvertical/smrt-assets 中文文档

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

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:57:12.448Z
中文译文更新时间：2026-11-17T09:32:22.591Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.1 MB，164 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：10 个
- peer 依赖：svelte ^5\.57\.0
- 首次发布：2026-06-23T01:18:27.497Z
- 最新版本发布：2026-11-17T07:57:12.266Z
- 近 30 天下载量：32593（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：366（近 12 个月 366 个）

## 中文简介

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

## 安装

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

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

## README

# @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.

## 安装

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

## 使用量

```typescript
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' });
```

## 便携式本地存储

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

```ts
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-core` | ORM 基础( Smrt Object, Smrt Collection) |
| `@happyvertical/smrt-tags` | 标签集成( E)`addTag`编号 :`removeTag` (单位:千美元) |
| `@happyvertical/smrt-tenancy` | 备选租户范围界定 |
| `@happyvertical/files` | 资产仓库的提供者不可知文件系统 |

## 本地私人附属物

`AttachmentPanel`, (中文(简体) ), `AttachmentList` 财务报告和审定财务报表 `AttachmentUpload` 授权编制 私人链接,呼叫器提供版本历史,以及本地多段上传. 它们保留请求身份和失败操作元数据而不产生 公共存储 URL. 见 [附加合同](https://npmcn.com/package/%40happyvertical/smrt-assets/agents/attachments.md) 页: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 是什么？

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

