@geti-ui/smart-tools

中文文档
1.7.1发布于 2026/11/05Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 4069

Geti 智能工具和接口

中文使用文档
文档目录15 节
  1. 安装
  2. 此软件包包含什么
  3. 快开始
  4. 配置 ONNX 运行时 WASM 二进制
  5. 配置 OpenCV.js 源码
  6. 执行提供者 (WebGPU vs CPU)
  7. 实例和文件
  8. 编译 OpenCV WASM 二进制( 手工)
  9. 先决条件
  10. 步骤
  11. Dockerfile 真理的来源
  12. 白名单配置
  13. CI / 发布
  14. 子包装
  15. 发展

@ geti- ui/ 智能工具

Intel Geti产品计算机视觉工具包.

@geti-ui/smart-tools 提供面向浏览器的OpenCV和基于ONNX的工具集成,用于注释和分块工作流程.

状态 : 初步迁移 - 包脚手架正在进行中. 见 plans/migrate-smart-tools.md 整个移民计划.


安装

npm install @geti-ui/smart-tools

此软件包包含什么

  • OpenCV 支持的工具设施和接口(/opencv, (中文(简体) ), /utils, (中文(简体) ), /types(中文(简体) )
  • ONNX 运行时 Web 模型包装器 :
    • 里特姆(RITM)@geti-ui/smart-tools/ritm(中文(简体) )
    • 任意部分( E)@geti-ui/smart-tools/segment-anything(中文(简体) )
  • 用于注释式工具链的共享几何和域名助手

快开始

import { buildGrabcutInstance } from '@geti-ui/smart-tools';
import { buildRITMInstance, RITMModels } from '@geti-ui/smart-tools/ritm';
import { buildSegmentAnythingInstance, SegmentAnythingModels } from '@geti-ui/smart-tools/segment-anything';

配置 ONNX 运行时 WASM 二进制

@geti-ui/smart-tools 用途 onnxruntime-web 给RITM和任何部分 这个包裹没有 捆绑或服务ORT .wasm编号 :.mjs 艺术品本身——它们所在的地方是应用建筑 因此,它被授权 消耗性应用:

  1. 复制了ORT的文物 node_modules/onnxruntime-web/dist/ 无论您的应用程序 为来自(例如通过Rsbuilding的)静态资产提供服务 output.copy) (中文(简体) ).
  2. 告诉聪明人他们住在哪里 setOrtWasmPaths(...)。 。 。 .

如果跳过此选项, ORT 将尝试解决与它自己的捆绑(或默认的CDN)相对的文物. 配置 setOrtWasmPaths(...) 当您的应用程序复制/服务 ORT 时 .wasm编号 :.mjs 来自不同URL的文物(否则ORT可能无法在运行时找到它们).

打电话 setOrtWasmPaths 在创建前 Session或装入RITM。 这个 参数是 ONNX 运行时的 env.wasm.wasmPaths 接受:字符串前缀/URL,记录 将每个文物文件名映射到一个明确的 URL,或 { wasm } 使用的形状 onnxruntime-web >= 1.24.

import { setOrtWasmPaths } from '@geti-ui/smart-tools';

// Files served at https://<your-app>/ort/<name>.wasm — note the trailing slash
setOrtWasmPaths('/ort/');
// Or point at explicit URLs per artifact (e.g. served from a CDN)
setOrtWasmPaths({
    'ort-wasm-simd-threaded.wasm': 'https://cdn.example.com/ort/ort-wasm-simd-threaded.wasm',
    'ort-wasm-simd-threaded.mjs': 'https://cdn.example.com/ort/ort-wasm-simd-threaded.mjs',
});

过 undefined 清除覆盖并让 ORT 解析相对于自身捆绑的二进制 (或默认CDN).

示例 Rsbuilding 复制配置( R)rsbuild.config.ts:

export default defineConfig({
    output: {
        copy: [{ from: 'node_modules/onnxruntime-web/dist/*.{wasm,mjs}', to: 'ort/[name][ext]' }],
    },
});

配置 OpenCV.js 源码

@geti-ui/smart-tools 使用自定义编译 opencv.js 用于GrabCut,智能剪刀, 水库 SSIM RITM和任何部分 这个软件包不捆绑也不服务于二进制本身——编译它 (见 编译 OpenCV WASM 二进制 (见下文)和副本 进入您的应用程序服务 静态资产从哪里, 然后告诉智能工具 它住在哪里 setOpenCVSourceUrl(...)。 。 。 .

打电话 setOpenCVSourceUrl 在启动期间,在使用任何OpenCV后置工具之前。 争论可能是

  • (单位:千美元) URL (建议用于跨源/CDN设置),
  • 绝对的 URL 字符串 (https://...),一种由app起源的绝对路径(/opencv/opencv.js, (中文(简体) ), 或相对路径字符串解决了您的应用程序的出处( 回落到智能工具模块 URL 时) location 页:1.
import { setOpenCVSourceUrl } from '@geti-ui/smart-tools';

// Served at https://<your-app>/opencv/opencv.js
setOpenCVSourceUrl('/opencv/opencv.js');

如果您跳过此选项, 任何 OpenCV 支持的工具在首次尝试加载时都会丢出描述性错误 opencv.js ——不存在默认/CDN倒置,与ORT的原声分辨率不同.

示例 Rsbuilding 复制配置( R)rsbuild.config.ts:

export default defineConfig({
    output: {
        copy: [{ from: 'src/opencv/opencv.js', to: 'opencv/[name][ext]' }],
    },
});

执行提供者 (WebGPU vs CPU)

分段 Anything 自动选择其 ONNX 运行时执行提供者 。 WebGPU( 通过 ORT ) sAM编码器的线性JSEP编码快得多 SharedArrayBuffer,浏览器仅在其中曝光 不同原生体 环境.

智能工具在启动时检测到:

  • 在相互孤立的情况下,它要求 ['webgpu', 'cpu'] 和多条线的相机.
  • 否则(非同位素标签,嵌入式的Web visions, 如 Tauri)它会钉入一个被单行径 ['cpu'] 供养.

要启用 WebGPU 路径, 消耗的应用程序必须:

  1. 通过在文档上发送这些响应信头
    • Cross-Origin-Opener-Policy: same-origin
    • Cross-Origin-Embedder-Policy: require-corp
  2. 运输有线的JSEP是文物(ort-wasm-simd-threaded.jsep.wasm 编号 : .mjs) (中文(简体) ). 这个 *.{wasm,mjs} 上面的复制块已经包含它.

如果缺少任何一个,智能工具会自动倒回CPU——不需要配置. 作为一名 最终安全网,运行时间 WebGPU/JSEP 失败仍会触发一次性降级到只限CPU 会话,所以一个被损坏的GPU驱动程序不能对工具进行楔形.

实例和文件

  • 安装 : documentation/docs/smart-tools/installation.mdx
  • OpenCV 文档 : documentation/docs/smart-tools/opencv.mdx
  • 抓起来 : documentation/docs/smart-tools/grabcut.mdx
  • 莱特: documentation/docs/smart-tools/ritm.mdx
  • 任何部分 : documentation/docs/smart-tools/segment-anything.mdx

编译 OpenCV WASM 二进制( 手工)

OpenCV JS 二进制 没有 已检查入存储器, 且未对此进行捆绑/服务 软件包。 必须在本地进行整理或从文物中获取,然后复制到您 应用和指向通过 setOpenCVSourceUrl(...) (见 设计OpenCV.js 来源" (见上文).

先决条件

  • 夹克: 用于运行基于 Dockerfile 的决定性建筑

步骤

# From the repository root:
cd packages/smart-tools

# Run the build script (compiles OpenCV 4.9.0 with the configured allow list)
./scripts/compile-opencv-wasm.sh

# Override the target version (optional)
OPENCV_VERSION=4.9.0 ./scripts/compile-opencv-wasm.sh

# Override the emscripten Docker image (optional)
EMSCRIPTEN_IMAGE=emscripten/emsdk:3.1.25 ./scripts/compile-opencv-wasm.sh

# `--skip-cleanup` is accepted for backward compatibility (no-op now)
./scripts/compile-opencv-wasm.sh --skip-cleanup

剧本将:

  1. 构建 scripts/opencv-build.Dockerfile 并带有被绑定的OpenCV+标注版本.
  2. 使用 scripts/opencv_js.config.py (白名单配置) 在图像构建.
  3. 摘录 /artifacts/opencv.js (可选) opencv.wasm) 从所建相.
  4. 将产出复制到 src/opencv/<version>/。 。 。 .

Dockerfile 真理的来源

scripts/opencv-build.Dockerfile 目前是本地和CI自动化所使用的 Cononical OpenCV 构建定义.

白名单配置

scripts/opencv_js.config.py 将 OpenCV 模块和函数汇编到二进制中的控件. 编辑此文件以添加或去除函数 - 只包括智能工具包为保持输出大小而实际使用的内容.

CI / 发布

GitHub Action 工作流程(计划)将构建该文物,并附在版本名称的发布上:

opencv-<version>-<configSha>.js

这使得配置变化可以通过文物身份来追踪.


子包装

子路径目录
@geti-ui/smart-tools主要条目
@geti-ui/smart-tools/opencvOpenCV 类型接口
@geti-ui/smart-tools/utils几何和工具设施
@geti-ui/smart-tools/types共享域类型
@geti-ui/smart-tools/ritmRITM 交互式分区模型
@geti-ui/smart-tools/segment-anything任何部件模型( SAM)

发展

# Build
npm run build --workspace=@geti-ui/smart-tools

# Tests
npm run test --workspace=@geti-ui/smart-tools

# Type check
npm run type-check --workspace=@geti-ui/smart-tools

# Lint
npm run lint --workspace=@geti-ui/smart-tools

# Format check
npm run format:check --workspace=@geti-ui/smart-tools

版本与发布记录

@geti-ui/smart-tools 共发布 20 个版本,首次发布于 2026/03/29;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.7.1latest2026/11/0510 天前
1.7.02026/10/2224 天前
1.6.02026/08/202 个月前
1.5.42026/08/063 个月前
1.5.32026/07/104 个月前
1.5.22026/07/094 个月前

关于 @geti-ui/smart-tools 的常见问题

@geti-ui/smart-tools 是什么?

Geti 智能工具和接口

如何安装 @geti-ui/smart-tools?

在项目目录运行 npm install @geti-ui/smart-tools,或使用 pnpm add / yarn add / bun add。

@geti-ui/smart-tools 支持 TypeScript 吗?

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

@geti-ui/smart-tools 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@geti-ui/smart-tools 可以商用吗?

@geti-ui/smart-tools 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@geti-ui/smart-tools 的下载量有多少?

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

@geti-ui/smart-tools 还在维护吗?

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