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

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

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

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

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

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

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

## 中文简介

SMRT 资产的本地图像元数据和变体处理器

## 安装

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

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

## README

# @happyvertical/smrt-资产-本地

S-m-r-t资产运行时间的本地图像处理. 它提取出正态图像 元数据并生成带有 Sharp 的决定性 WebP 变体, 而资产 身份、储存、租赁和出版政策仍为 [`@happyvertical/smrt-assets`](https://npmcn.com/package/%40happyvertical/assets/README.md)。 。 。 .

选择此适配器用于本地开发、 单节点部署和应用程序 需要实际的图像处理,而不需要媒体资产管理服务.

## 安装

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

`sharp` 由这个适配器安装,而不被拖入 s-m-r-t 核心资产 消费者.

## 快开始

```ts
import { createAssetRuntime } from '@happyvertical/smrt-assets';
import { createLocalAssetProcessor } from '@happyvertical/smrt-assets-local';

const runtime = await createAssetRuntime({
  db: 'assets.db',
  storage: './data/assets',
  capabilityProviders: [createLocalAssetProcessor()],
});

const source = await runtime.storeSourceAsset(
  'photo.png',
  imageBytes,
  { mimeType: 'image/png', typeSlug: 'image' },
);

const processed = await runtime.processAsset(source, {
  variants: [{ variant: 'thumb' }, { variant: 'card' }],
});

console.log(processed.metadata, processed.variants);
```

处理器将普通元数据保存到源资产并创建 与该来源有关的衍生资产.

## 标准变体

| 名称 | 大小 | 适应 |
| --- | --- | --- |
| `thumb` | 160x160 (中文(简体) ) | `cover` |
| `card` | 480×270 (中文(简体) ) | `cover` |
| `preview` | 960×960 (英语) | `inside` |
| `publish` | 1200x630 (英语) | `cover` |

创建处理器时覆盖预设或输出质量 :

```ts
const processor = createLocalAssetProcessor({
  quality: 85,
  variants: {
    card: { width: 640, height: 360, fit: 'cover' },
  },
});
```

未知的变种名称必须提供明确的 `width` 财务报告和审定财务报表 `height`重复 在源版本和参数时请求重用匹配的衍生资产 没有改变.

## 元数据

`extractAssetImageMetadataFromBuffer()` 报告前的定向正常化 维度和返回 MIME 类型、维度、捕获时间、, 和GPS坐标 GPS 值保持足够的精度 附近图片搜索.

非图像资产被明确跳出,以便后来注册的提供者能够 处理他们.

## 公共 API

| 导出 | 目的 |
| --- | --- |
| `createLocalAssetProcessor()` | 创建资产能力提供者 |
| `extractAssetImageMetadataFromBuffer()` | 提取正版图像元数据 |
| `normalizeAssetImageMetadata()` | 将原始的Sharp/EXIF元数据规范化 |
| `LocalAssetProcessorOptions` | 配置变体预设和质量 |

## 发展

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

见 [`AGENTS.md`](https://npmcn.com/package/%40happyvertical/smrt-assets-local/AGENTS.md) 确定性、元数据和提供者边界 所需经费.

## 常见问题

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

SMRT 资产的本地图像元数据和变体处理器

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

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

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

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

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

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

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

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

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

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

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

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

