# @happyvertical/smrt-images 中文文档

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

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

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

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

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

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

## 中文简介

图像资产管理,采用人工智能驱动分类、搜索、编辑和元数据提取系统框架

## 安装

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

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

## README

# @ happyvertical/ smrt- images (欢快的垂直/ 图像)

S-m-r-t框架的图像资产管理,采用人工智能动力分类、编辑和元数据提取。 扩展 `Asset` 从smrt-assets通过交叉包装STI -- -- 存储在同一包中 `assets` 表格,带有不同的 `_meta_type`。 。 。 .

## 摄影字符设置

相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相. 可选的SDK浏览器分页器在设备上运行被固定的CPU模型, 选择发型和相貌自信口罩, 并输出紧凑的收割口罩 透明 PNG 同时保留原始的 RGB 字节 。 用户审查后 并明确继续, 视觉请求只收到该作物 并返回口角和下巴。 S-m-r-t包 来源于加拿大 横向分割钻机确定,而动画包拥有 轮廓验证和运动。 这是语义分化,不是细发型 交配;未来运动风格是分开的. 拆分没有人工口腔外填:打开后揭示出宿主的口腔外填 通过实际相片接合的透明背景.

表达式预览保持中性钻机不变. 被批准时 语音信封在播放,主机通过下巴的受限收益将其映射出来 空隙和小头/轮船倾斜;沉默、取消、替换、完成、, 和减速都恢复中性姿势。 加拿大分裂的垂直 旅行来自测量的口到口的跨度和帆布接收量 匹配透明底板,所以一个更大的开口从不剪接PNG.

口裂是当地从MediaPipe FaceLandmarker口角和 孤立浏览器图像上的下巴地标。 钉住的模型是正直的 cPU 推断前检查; 需要一个清晰的面, 取消为 在装入和检测之间获得荣誉, 没有图像字节发送到一个视觉 此阶段的提供者.

`PhotoCutoutProfileStore` 是坚固的接合。 消耗性服务器用品 房客们, `AssetRuntime`,配置解析器,以及 授权召回; 商店将 PNG 字节保存为所有者 资产,将其链接到配置文件 `character_cutout`,并存储一个版本 是指马厩的钻机清单 `character_cutout` 资产密钥。 东道主 返回持久字节的密钥; UUID 和到期的 URL 永远不会 烤入了钻机。 它拒绝另一个房客,拒绝批准, 畸形 或未支持的列表, 无效的 PNG 维度, 并保存缺失 字节。 商店只补偿刚刚创建的未链接的资产 配置文件写入失败 。 授权阅读器可以列出稳定的保存设置摘要 不加载 PNG 字节; 错误的链接列表被省略 画廊如此有效的祭品仍可收回。 然后读者只能选择一个 现有所有者和租户 `character_cutout` 资产; 省略的资产 id 仍然装入最新的设置. `PhotoCutoutSetup` 接受主机提供的保存/装入调用, 永远不要 使用浏览器存储作为资产目录. 聊天工作台的本地调用 桥面故意只回回路,并固定在外部提供 临时配置文件; 它显示库名资产运行时/Profile存储, 但是 不是生产授权机制.

持久性测试设计:授权和拒绝重点单位覆盖演练 演员案件、租户不匹配、PNG/帧拒绝、格式/版本不正确 在选择、选定/最新画廊时省略画廊和拒绝画廊 负载, 失败的链接补偿, 以及一个在投出前链接的适配器 . SQLite 集成测试创建 `AssetRuntime`组合,以及 `ProfileAsset` 链接到一个交易执行器内,然后执行后重新装入. 服务为适配器中性; PostgreSQL 执行属于消耗 应用程序的数据库套件,因为这个软件包没有部署数据库.

关于口腔地标分析,通过 只使用服务器的 AI 配置( 例如) `SMRT_CHAT_DEV_MODEL`) (中文(简体) ). 评议 相对于实际作物的结果:有效的几何学不能保证准确 口放入处. UI从不披露供应商的资质或模型选择.

帮助发布会通过工作空间目录消耗已公布的SDK家族. s-m-r-t 保留 SDK 目录,并在解析时覆盖 `bash scripts/check-sdk-versions.sh` 释放门执行边界.

## 安装

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

## 使用量

```typescript
import {
  Image, ImageCollection,
  ImageCategorizer, ImageEditor, ImageDeriver,
  ImageMetadataExtractor, ImageSearch, UpstreamManager,
} from '@happyvertical/smrt-images';

// Create and query images
const images = await ImageCollection.create({ db });
const image = await images.create({
  name: 'hero.jpg',
  url: 'https://cdn.example.com/hero.jpg',
  mimeType: 'image/jpeg',
  width: 1920,
  height: 1080,
});
await image.save();

// Computed properties from dimensions
image.isLandscape;  // true
image.aspectRatio;  // 1.778
image.isHighResolution();  // false (below 4K)

// Metadata categorization (returns tags, description, confidence, subjects)
const categorizer = new ImageCategorizer({ ai: aiConfig });
const result = await categorizer.categorize(image);
// Auto-tag: applies tags and sets description/alt text
await categorizer.autoTag(image, assetCollection);

// AI alt text generation via this.do()
const altText = await image.generateAltText();

// Standard editing (resize, crop, convert, thumbnail)
// Each operation creates a new derivative Image linked via parentId
const editor = new ImageEditor(store, images, { ai: aiConfig });
const thumb = await editor.thumbnail(image, 256);
const resized = await editor.resize(image, 800, 600);
const webp = await editor.convert(image, 'webp');

// AI-powered editing and variation generation
const edited = await editor.edit(image, 'add warm sunset tones');
const variations = await editor.generateVariation(image, 'winter theme', { count: 3 });
```

## API 密码

### 模型

| 导出 | 说明 |
| --- | --- |
| `Image` | 科学、技术和创新子类 `Asset` 与 `width`, (中文(简体) ), `height`, (中文(简体) ), `alt`计算 `aspectRatio`编号 :`isLandscape`编号 :`isPortrait`编号 :`isSquare` |

### 收款

| 导出 | 说明 |
| --- | --- |
| `ImageCollection` | 尺寸/定向过滤器: `getByMinDimensions()`, (中文(简体) ), `getByAspectRatio()`, (中文(简体) ), `getLandscape()`, (中文(简体) ), `getPortrait()`, (中文(简体) ), `getSquare()`, (中文(简体) ), `getHighResolution()`, (中文(简体) ), `getMissingAltText()` |

### 服务

| 导出 | 说明 |
| --- | --- |
| `ImageCategorizer` | 元数据分类返回标记,描述,置信度,主体. `autoTag()` 对图像应用结果. |
| `ImageDeriver` | 来源 + AI 的衍生出的新图像提示 `AssetAssociation` |
| `ImageEditor` | 调整大小、收成、转换、缩略图(通过 `@happyvertical/images`)+AI编辑. 通过 `parentId`。 。 。 . |
| `ImageMetadataExtractor` | 从图像缓冲中提取尺寸、格式、 EXIF |
| `ImageSearch` | 使用方向过滤器在名称/描述/备忘之间搜索文本 |
| `UpstreamManager` | 从有来源追踪的外部供应商进口 |

### 密钥类型

`ImageOptions`, (中文(简体) ), `CategoryResult`, (中文(简体) ), `DeriveOptions`, (中文(简体) ), `ImageMetadataResult`, (中文(简体) ), `ImageSearchOptions`, (中文(简体) ), `AssetSourceAdapter`, (中文(简体) ), `SourceAsset`, (中文(简体) ), `SourceAssetMetadata`

### 可选词汇决定

`ImageCategorizer` 除非两者均具有遗传性 `decisions` 和标签或 提供主题词汇。 一个词汇是只读数组 `{ name, description? }` 条目或图像解析器。 提供标签和主题 标签为独立的上游:名称准确且对大小写有敏感认识,仅限 以上概率 `0.5` 选定。 标记和主题可能受到限制 独立; 缺失的词汇保留生成字段, 而 清晰的空词汇返回该字段的标签而不作出决定 供应商呼叫。 词汇条目限制为64个条目,128个字符 名称和512个特征描述。 解析器和配置的提供者出错 宣传.

使用 `categorizeDetailed()` 选定标签概率和决定 来源。 现有 `CategoryResult.confidence` 仍然是基因 分类者的信心,并不是一种经过校准的决定确定性.

此路径只分类了已解析的元数据: 图像名称,描述, MIME 类型, 和维度. `categorize(image, buffer)` 仍然忽略 `buffer`;没有 将图像字节、 EXIF、 源 URL 或元数据 blob 发送到任何提供者 . 所支持的像素/视觉特性需要单独的范围API.

## 依赖关系

-   `@happyvertical/smrt-core` -- ORM 和代码生成
-   `@happyvertical/smrt-assets` 基数 `Asset` 模型和 `AssetStore`
-   `@happyvertical/smrt-tenancy` -- 多租户范围界定
-   `@happyvertical/ai` - AI分类和图像生成
-   `@happyvertical/images` -- 调整大小、裁剪、转换、缩略图操作

## 贡献者指南

见 [`AGENTS.md`](https://npmcn.com/package/%40happyvertical/smrt-images/AGENTS.md) 用于软件包结构、变化、验证、, 和贡献者的指导.

### 局部相片头隔离

`PhotoCutoutSetup` 通过可选的 SDK 隔离用户设备上的发型和面部皮肤 `@happyvertical/images/segmentation` 进入点。 原始的RGB值被保存在透明的PNG中;α出自语义像素遮罩而不是模型授权的多边形. 本部分接受 `segmentationAssets` 同源资产目录(违约) `/api/dev-image-segmentation`) (中文(简体) ). 用 SDK 图像准备被绑定的运行时间/模型资产 `prepare:segmentation`; 聊天活字盘有一个 dev-唯一允许上市的资产路径. 发型/相片政策和审查/再生在SDK的 s-m-r-t,通论和PNG编码中. 隔离期间不上传相片. 口腔分析仍然是单独要求的下一阶段.

设置流程呈现出四个明显的阶段:选择一张照片,隔离头部,从本地面部地标上设定口腔,再保存. 每个阶段都暴露出下一个动作;重做和被保存的特性加载仍然是次要动作. 在宽屏上,被隔离的头部和动画预览会共享一个紧凑的行,它们会堆积在窄屏上. 装入、注销和失败保留了可收回的前一阶段.

保存会在授权保存的画廊中添加已审查字符 。 它不选择或激活一个帮助者;消耗的表面处理这个明确的后续. 256×256型可以软化细线和低自信界限. 用户在继续前审查头;加载错误和取消保留所选相片. 本地开发使用明确授权的SDK #1370接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接地接.

### 图像处理器依赖性

s-m-r-t图像使用本地操作所需的Sharp后端. 吉姆是个 基本SDK的可选对等方,而不是此套件的依赖; 明确选择 SDK 后端自行安装端点的应用程序.

## 常见问题

### @happyvertical/smrt-images 是什么？

图像资产管理,采用人工智能驱动分类、搜索、编辑和元数据提取系统框架

### 如何安装 @happyvertical/smrt-images？

在项目目录运行 npm install @happyvertical/smrt-images，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：svelte（^5\.57\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @happyvertical/smrt-images 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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

