@audio/mir-structure

中文文档
1.1.4发布于 2026/10/13MITTypeScriptES Module近 30 天下载 1706

Structural segmentation — Foote checkerboard novelty over MFCC self-similarity (Foote 2000)

原始使用文档

@audio/mir-structure

Structural segmentation — Foote novelty (Foote 2000): MFCC timbre frames → cosine self-similarity → checkerboard-kernel correlation along the diagonal → novelty peaks mark section boundaries (verse/chorus/texture changes).

npm install @audio/mir-structure

import structure from '@audio/mir-structure'

let { boundaries, novelty, times } = structure(data, { fs: 44100 })
// boundaries: number[] (s, detected section edges)
// novelty: Float32Array (one value per frame, checkerboard-kernel score; 0 in the un-scoreable edge margins)
// times: Float32Array (s, frame centers, same length as novelty)

boundaries are peak-picked from novelty: local maxima above mean + sensitivity·std, at least kernel frames apart.

Options: - fs — sample rate (default 44100, Hz) · frameSize/hop — MFCC analysis window/hop (default 2048/1024) · kernel — checkerboard quadrant size, frames (default 16 — wider kernel = broader-scale boundaries) · sensitivity — novelty threshold in std-devs above the mean (default 1, higher → fewer boundaries)

Also exported as an audio.js stat manifest (./audio).

Part of @audio/mir.

版本与发布记录

@audio/mir-structure 共发布 6 个版本,首次发布于 2026/07/09;过去 12 个月发布了 6 个版本。

版本发布日期距今
1.1.4latest2026/10/1328 天前
1.1.32026/07/113 个月前
1.1.22026/07/114 个月前
1.1.12026/07/104 个月前
1.1.02026/07/104 个月前
1.0.02026/07/094 个月前

关于 @audio/mir-structure 的常见问题

@audio/mir-structure 是什么?

Structural segmentation — Foote checkerboard novelty over MFCC self-similarity (Foote 2000)

如何安装 @audio/mir-structure?

在项目目录运行 npm install @audio/mir-structure,或使用 pnpm add / yarn add / bun add。

@audio/mir-structure 支持 TypeScript 吗?

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

@audio/mir-structure 支持 ESM 还是 CommonJS?

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

@audio/mir-structure 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@audio/mir-structure 可以商用吗?

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

@audio/mir-structure 的下载量有多少?

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

@audio/mir-structure 还在维护吗?

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