@desert-ant-labs/moderator

中文文档
4.3.0发布于 2026/11/06SEE LICENSE IN LICENSE.mdTypeScriptES Module近 30 天下载 8868

JavaScript 的 On-device NSFW 图像检测. 在浏览器(WebAssembly + LiteRT.js)和服务器端(native)运行,从一个导入.

中文使用文档
文档目录3 节
  1. 选项
  2. 正在装入模型
  3. 许可证

@ 沙漠- ant- labs/ 主持人

在浏览器和节点运行的 JavaScript 的在线设备 NSFW 图像检测 。 主持人对裸体或性活动评分从0分到1分,在标出裸体和性内容时调制通过泳衣和内衣. 图像留在本地.

两条共用一条 Moderator API : (英语)

  • @desert-ant-labs/moderator (默认):一个WebAssembly输油管 LitteRT.js (法语) 推论: 浏览器. 在服务器侧渲染过程中安全导入; Moderator.load() 只在浏览器或 Web Worker 中运行推论.
  • @desert-ant-labs/moderator/native: 预建的本地核心, macOS上的核心ML和Linux上的LiteRT, for 服务器侧推论 在节点。 从服务器代码导入它 .
npm i @desert-ant-labs/moderator @litertjs/core   # browser
npm i @desert-ant-labs/moderator                  # Node, prebuilt native core
import { Moderator } from "@desert-ant-labs/moderator";

const moderator = await Moderator.load();
const { score, isNSFW, regions } = await moderator.analyze(image);
// regions: { nipples, genitals, buttocks, nude, sexAct }, each 0..1

moderator.dispose();

在浏览器中, image 任何东西 createImageBitmap 接受(一个 <img>画布 画布 Blob,一个 ImageBitmap或一个 ImageData在节点中,通过解码像素为 { data, width, height } 有 RGB 或 RGBA 字节 :

import sharp from "sharp";
import { Moderator } from "@desert-ant-labs/moderator/native";

const { data, info } = await sharp("photo.jpg").rotate().raw().toBuffer({ resolveWithObject: true });
const result = await moderator.analyze({ data, width: info.width, height: info.height });

选项

analyze(image, { threshold, policy, quality })数字 :

  • threshold (默认) 0.5: 得分在哪个或哪个以上 isNSFW 这是真的.
  • policy数字 : "standard" (默认)标记任何裸体,包括赤胸; "allowTopless" 无视一个赤裸的胸口自己.
  • quality数字 : "fast" 评分中心收成(视频帧), "balanced" 四块多尺寸的瓦片, "accurate" 那些瓷砖和镜子.

正在装入模型

Moderator.load() 从 Hugging Face 下载模型(desert-ant-labs/moderator在SDK的被钉上标记,验证,并缓存. 过 directory (节点)或 modelBaseUrl (浏览器)使用您自己主机的文件,以及 onProgress 用于下载进度。 浏览器的构建也需要 litert, (中文(简体) ), litertWasmDir,以及 accelerator (单位:千美元)"wasm", (中文(简体) ), "webgpu",或 "webnn") (中文(简体) ).

许可证

沙漠蚂蚁实验室 源头可破坏许可证。为大多数免费提供 应用软件和商务许可证必须规模化。 完整的术语在链接. 许可证发放: 许可@ desertant.com。 。 。 .

SDK的第三方通知: THIRD_PARTY_NOTICES.md。 。 。 .

权重第三方通知: THIRD_PARTY_NOTICES.md。 。 。 .

版本与发布记录

@desert-ant-labs/moderator 共发布 10 个版本,首次发布于 2026/09/24;过去 12 个月发布了 10 个版本。

版本发布日期距今
4.3.0latest2026/11/066 天前
4.2.32026/10/3112 天前
4.2.22026/10/3112 天前
4.2.12026/10/2815 天前
4.2.02026/10/2716 天前
4.1.02026/10/2023 天前

关于 @desert-ant-labs/moderator 的常见问题

@desert-ant-labs/moderator 是什么?

JavaScript 的 On-device NSFW 图像检测. 在浏览器(WebAssembly + LiteRT.js)和服务器端(native)运行,从一个导入.

如何安装 @desert-ant-labs/moderator?

在项目目录运行 npm install @desert-ant-labs/moderator,或使用 pnpm add / yarn add / bun add。

@desert-ant-labs/moderator 支持 TypeScript 吗?

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

@desert-ant-labs/moderator 支持 ESM 还是 CommonJS?

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

@desert-ant-labs/moderator 可以商用吗?

@desert-ant-labs/moderator 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@desert-ant-labs/moderator 的下载量有多少?

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

@desert-ant-labs/moderator 还在维护吗?

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