# @braccato/types 中文文档

规范地址：https://npmcn.com/package/%40braccato/types/

版本：1\.1\.0
npm 元数据更新时间：2026-11-07T15:45:25.396Z
中文译文更新时间：2026-11-08T13:15:30.588Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40braccato/types
原文对照：https://npmcn.com/package/%40braccato/types/?lang=original
项目主页：https://braccato.boidu.dev/
源码仓库：https://github.com/better-lyrics/braccato

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

- 包体积（解压后）：6.5 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-08-04T09:56:07.049Z
- 最新版本发布：2026-11-07T15:45:24.849Z
- 近 30 天下载量：6810（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

@braccato/core 和 @braccato/parsers 共享语言数据形状

## 安装

```sh
npm install @braccato/types
```

也可以使用：`pnpm add @braccato/types`、`yarn add @braccato/types`、`bun add @braccato/types`

## README

# @braccato/ 类型

语言数据形状 [`@braccato/core`](https://www.npmjs.com/package/@braccato/core) 财务报告和审定财务报表 [`@braccato/parsers`](https://www.npmjs.com/package/@braccato/parsers)。仅类型:这里没有显示 运行时代码, 且在编译时会删除一个只输入类型的导入, 因此不需要花费任何捆绑 .

你很少直接安装它。 两个包都依赖它,然后再出口它们使用的东西,所以 `import type { Lyric } from "@braccato/parsers"` 继续工作.

```bash
npm i -D @braccato/types
```

```ts
import type { Lyric, LyricPart, LyricSyncType } from "@braccato/types";
```

## 形状

`Lyric` 是一个线条. `startTimeMs`, (中文(简体) ), `words` 财务报告和审定财务报表 `durationMs` (一) 整个所需地表; 其他一切都描述了某一来源可能或可能不具备的能力.

| 外地 | 含义 |
| --- | --- |
| `startTimeMs` | 当线开始时, 以毫秒计 |
| `words` | 整行作为文本,背景声 |
| `durationMs` | 线能持续多久 |
| `key` | 源代码为行,用于附加翻译和罗马化 |
| `parts` | 文字或音节时间. 它的缺失 使得线性比富贵 |
| `agent` | 哪个配音员唱的 `v1`, (中文(简体) ), `v2`,与 `v1000` 组合 |
| `translations` | 按语言代码翻译的文本 |
| `translation` | 一同其语一译. 已经取代了 `translations` |
| `romanization` | 线被罗马化,没有时间 |
| `timedRomanization` | 线路被罗马化,时间与 `parts` |
| `isInstrumental` | 一条合成的线,站在那里 空隙没有人唱过 |

`LyricPart` 是行内的一个单词或音节: `startTimeMs`, (中文(简体) ), `words` 财务报告和审定财务报表 `durationMs`附加时 `isBackground` 支持声音, `backgroundGroup` 该行的哪个背景组 (单位:千美元)`x-bg` 间距,从0起计算) `explicit` 对于一个词 一个消息源标出.

`LyricSyncType` 实值 `"richsync" | "synced" | "none"`,线条如何精细的时间. `@braccato/parsers` 出口单位与 `SyncType`。 。 。 .

## 许可证

麻省理工学院 和其余的仓库一起.

## 常见问题

### @braccato/types 是什么？

@braccato/core 和 @braccato/parsers 共享语言数据形状

### 如何安装 @braccato/types？

在项目目录运行 npm install @braccato/types，或使用 pnpm add / yarn add / bun add。

### @braccato/types 支持 TypeScript 吗？

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

### @braccato/types 支持 ESM 还是 CommonJS？

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

### @braccato/types 可以商用吗？

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

### @braccato/types 的下载量有多少？

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

### @braccato/types 还在维护吗？

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