mai-kit

主题

接口: ScoreChart ​

定义于: packages/draw/src/types.ts:138

成绩卡片（展示用，prober Score 的结构子集）。

dx_max / level_value 不在 prober Score 中：由 Draw 各出图方法 在 source 提供曲目列表时用 @mai-kit/utils 计算并注入。

示例 ​

ts
import type { ScoreChart } from "@mai-kit/draw";
import { LevelIndex } from "@mai-kit/shared";

const chart: ScoreChart = {
  id: 11451,
  song_name: "曲名",
  type: "dx",
  level_index: LevelIndex.MASTER,
  achievements: 100.5432,
  dx_score: 1_593,
  dx_max: 1_722,
  dx_rating: 315,
  rate: "sssp",
  fc: "ap",
};

属性 ​

属性类型描述定义于
achievementsnumber原始达成率（>1000 时按 /10000 归一化），渲染时格式化为 "100.8621%"packages/draw/src/types.ts:148
badgeImageUri?string可选：覆盖默认 FC/FS 徽章的自定义图packages/draw/src/types.ts:187
coverDataUri?string已预解析的封面 data URI。 与 coverPath / database getAsset("jacket") 为可选回退链，勿重复必填。packages/draw/src/types.ts:183
coverPath?string封面本地路径（Node；仅当无 coverDataUri 时回退）packages/draw/src/types.ts:185
dx_max?numberDX 分数满分（notes.total × 3）。有值时与 dx_score 显示为 xxx/xxxx； 缺省只显示当前分。packages/draw/src/types.ts:155
dx_rating?number单曲 Rating（prober dx_rating）。有值时卡片展示； 缺省不显示。packages/draw/src/types.ts:165
dx_scorenumber当前 DX 分packages/draw/src/types.ts:150
dx_star?numberDX 分数星级（0–5）。渲染时与 dx_score 同一行，按星数重复绘制； 不同星级档位用不同素材（1–2 / 3–4 / 5）。缺省或 0 不显示星。packages/draw/src/types.ts:160
fc?FCType | nullFULL COMBO 标记；无标记时为 null 或缺省packages/draw/src/types.ts:176
fs?FSType | nullFULL SYNC 标记；无标记时为 null 或缺省packages/draw/src/types.ts:178
idnumber曲目 id，Draw 按 id 拉取 jacket 封面packages/draw/src/types.ts:140
level?string等级文案（如 "14+"），无精确定数时的回退展示packages/draw/src/types.ts:167
level_indexLevelIndex谱面难度索引；标签关联必需packages/draw/src/types.ts:146
level_value?number精确定数（如 14.7）。优先于 level 展示； 由 Draw 在有曲目数据时注入。packages/draw/src/types.ts:172
rate?RateType评级码值，渲染时映射为 "SSS+" 等packages/draw/src/types.ts:174
song_name?string曲名；缺省时使用曲目 idpackages/draw/src/types.ts:142
typeSongType谱面类型；标签关联必需packages/draw/src/types.ts:144