@lf_maple/koishi-plugin-phi-plugin-full 0.1.80

package/core/model/game/LevelRecordInfo.js

@@ -0,0 +1,109 @@
+import fCompute from './fCompute.js';
+import getInfo from './getInfo.js';
+import { LevelNum } from './constNum.js';
+
+
+/**
+ * @typedef {object} LevelRecordInfoWithoutInfo 曲目成绩信息
+ * @property {boolean} fc 是否满分
+ * @property {number} score 分数
+ * @property {number} acc 准确率
+ * @property {idString} id 曲目id
+ * @property {allLevelKind} rank 难度
+ * @property {ratingKind} Rating 评级
+ * @property {number} rks 等效rks
+ * @property {number} difficulty 难度
+ */
+
+/**
+ * @typedef {LevelRecordInfoWithoutInfo & {
+ *   song: songString,
+ *   illustration: string
+ * }} LevelRecordInfoWithInfo 曲目成绩信息
+ */
+
+/**@type {LevelRecordInfoWithoutInfo | LevelRecordInfoWithInfo} */
+export default class LevelRecordInfo {
+    /**
+     * @param {{fc:boolean | number, score:number, acc: number}} data 原始数据
+     * @param {idString} id 曲目id
+     * @param {number} rank 难度
+     * @param {string} [ver] 版本号
+     */
+    constructor(data, id, rank, ver) {
+        this.fc = Boolean(data.fc);
+        this.score = data.score;
+        this.acc = data.acc;
+        /** @type {idString} */
+        this.id = id;
+
+        let info = getInfo.info(id, true)
+
+        /** @type {allLevelKind} */
+        this.rank = getInfo.allLevel[rank] //AT IN HD EZ LEGACY
+
+        /** @type {ratingKind} */
+        this.Rating = Rating(this.score, this.fc) //V S A 
+
+        if (!info) {
+            this.id = id;
+            this.difficulty = 0;
+            this.rks = 0;
+            return
+        }
+        /** @type {songString} */
+        this.song = info.song //曲名
+        this.illustration = getInfo.getill(id) //曲绘链接
+
+        if (!ver || this.rank == 'LEGACY') {
+            //未指定版本或难度为LGC，使用当前版本信息
+            const difficulty = info?.chart?.[this.rank]?.difficulty
+            if (difficulty) {
+                this.difficulty = difficulty //难度
+                this.rks = fCompute.rks(this.acc, this.difficulty) //等效rks
+            } else {
+                this.difficulty = 0
+                this.rks = 0
+            }
+        } else {
+            //使用指定版本信息
+            const difficulty = getInfo.historyDifficultyBySongId[id]?.[ver]?.[this.rank]
+            if (difficulty) {
+                this.difficulty = difficulty //难度
+                this.rks = fCompute.rks(this.acc, this.difficulty) //等效rks
+            } else {
+                this.difficulty = 0
+                this.rks = 0
+            }
+        }
+
+
+    }
+}
+
+/**
+ * 
+ * @param {number} score 
+ * @param {boolean| number} fc 
+ * @returns {ratingKind} 评级
+ */
+function Rating(score, fc) {
+    if (score >= 1000000)
+        return 'phi'
+    else if (fc)
+        return 'FC'
+    else if (!score)
+        return 'NEW'
+    else if (score < 700000)
+        return 'F'
+    else if (score < 820000)
+        return 'C'
+    else if (score < 880000)
+        return 'B'
+    else if (score < 920000)
+        return 'A'
+    else if (score < 960000)
+        return 'S'
+    else
+        return 'V'
+}

package/core/model/game/SongsInfo.js

@@ -0,0 +1,46 @@
+import getInfo from "./getInfo.js"
+import Chart from "./Chart.js"
+
+export default class SongsInfo {
+    /**
+     * @param {any} data 原始数据
+     */
+    constructor(data) {
+        if (!data) {
+            //@ts-ignore
+            return {}
+        }
+        /** @type {idString} id */
+        this.id = data.id
+        /** @type {songString} 曲目 */
+        this.song = data.song
+        /** @type {string} 曲绘 */
+        this.illustration = getInfo.getill(data.id)
+        /** @type {boolean} 是否不参与猜字母 */
+        this.can_t_be_letter = data.can_t_be_letter || false
+        /** @type {boolean} 是否不参与猜曲绘 */
+        this.can_t_be_guessill = data.can_t_be_guessill || false
+        /** @type {string} 章节 */
+        this.chapter = data.chapter
+        /** @type {string} bpm */
+        this.bpm = data.bpm
+        /** @type {string} 作曲 */
+        this.composer = data.composer
+        /** @type {string} 时长 */
+        this.length = data.length
+        /** @type {string} 画师 */
+        this.illustrator = data.illustrator
+        /** @type {string} 特殊信息 */
+        this.spinfo = data.spinfo
+        /** @type {boolean} 独占曲标记 */
+        this.isOriginal = data.isOriginal
+        /**
+         * 谱面详情
+         * @type {Partial<Record<allLevelKind, Chart>>} 
+         */
+        this.chart = data.chart
+        /** @type {boolean} 是否是特殊谱面 */
+        this.sp_vis = data.sp_vis
+    }
+
+}

package/core/model/game/b30Analysis.js

@@ -0,0 +1,93 @@
+/**
+ * @typedef {object} B30AnalysisRecord
+ * @property {idString} id
+ * @property {allLevelKind} rank
+ * @property {number} rks
+ * @property {'phi'|'best'} kind
+ * @property {string} slot
+ */
+
+/**
+ * 取得实际参与 RKS 计算的 P3 + B27 槽位。
+ * @param {{phi?: any[], b19_list?: any[]}} b30
+ * @returns {B30AnalysisRecord[]}
+ */
+export function getB30AnalysisRecords(b30) {
+    const phi = (b30.phi || []).slice(0, 3).map((record, index) => record && ({
+        id: record.id,
+        rank: record.rank,
+        rks: Number(record.rks),
+        kind: 'phi',
+        slot: `P${index + 1}`,
+    })).filter(Boolean)
+    const best = (b30.b19_list || []).slice(0, 27).map((record, index) => record && ({
+        id: record.id,
+        rank: record.rank,
+        rks: Number(record.rks),
+        kind: 'best',
+        slot: `B${index + 1}`,
+    })).filter(Boolean)
+    return /** @type {B30AnalysisRecord[]} */ ([...phi, ...best].filter(record =>
+        record.id && ['EZ', 'HD', 'IN', 'AT', 'LEGACY'].includes(record.rank) && Number.isFinite(record.rks)
+    ))
+}
+
+/**
+ * @param {number} value
+ */
+function niceAxisStep(value) {
+    const candidates = [0.02, 0.05, 0.1, 0.2, 0.25, 0.5, 1]
+    return candidates.find(candidate => candidate >= value) || Math.ceil(value)
+}
+
+/**
+ * 按 P1-P3、B1-B27 槽位生成等效单曲 RKS 直方图。
+ * @param {B30AnalysisRecord[]} records
+ * @param {number} [targetTickCount]
+ */
+export function buildRksHistogram(records, targetTickCount = 4) {
+    const valid = records.filter(record => Number.isFinite(record.rks))
+    if (!valid.length) return { slots: [], ticks: [], average: 0, averagePosition: 0, count: 0 }
+
+    const values = valid.map(record => record.rks)
+    const minimum = Math.min(...values)
+    const maximum = Math.max(...values)
+    const step = niceAxisStep(Math.max(maximum - minimum, 0.2) / targetTickCount)
+    const domainMin = Math.floor((minimum - step * 0.1) / step) * step
+    let domainMax = Math.ceil((maximum + step * 0.1) / step) * step
+    if (domainMax <= domainMin) domainMax = domainMin + step
+    const domainRange = domainMax - domainMin
+
+    const ticks = []
+    const tickCount = Math.round(domainRange / step)
+    for (let index = 0; index <= tickCount; index++) {
+        const value = domainMin + index * step
+        ticks.push({
+            value,
+            label: value.toFixed(2),
+            position: index / tickCount * 100,
+        })
+    }
+
+    const slotCounters = { phi: 0, best: 0 }
+    const slots = valid.map(record => {
+        slotCounters[record.kind] += 1
+        return {
+            label: record.slot || `${record.kind === 'phi' ? 'P' : 'B'}${slotCounters[record.kind]}`,
+            rks: record.rks,
+            kind: record.kind,
+            height: Math.min(100, Math.max(0, (record.rks - domainMin) / domainRange * 100)),
+        }
+    })
+
+    const average = values.reduce((sum, value) => sum + value, 0) / values.length
+    return {
+        slots,
+        ticks,
+        average,
+        averagePosition: Math.min(100, Math.max(0, (average - domainMin) / domainRange * 100)),
+        count: valid.length,
+        domainMin,
+        domainMax,
+    }
+}

package/core/model/game/chartParser/Chart.js

@@ -0,0 +1,23 @@
+import JudgeLine from "./JudgeLine.js"
+
+export default class Chart {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        this.formatVersion = data.formatVersion
+
+        /**
+         * 谱面偏移（单位：秒）
+         * @type {number}
+         */
+        this.offset = data.offset
+
+        /**
+         * 判定线列表
+         * @type {JudgeLine[]}
+         */
+        this.judgeLineList = data.judgeLineList.map(/** @param {any} e */(e) => new JudgeLine(e));
+    }
+}

package/core/model/game/chartParser/JudgeLine.js

@@ -0,0 +1,38 @@
+import Note from "./base/Note.js";
+import SpeedEvent from "./base/SpeedEvent.js";
+import { judgeLineDisappearEvent, judgeLineMoveEvent, judgeLineRotateEvent } from "./base/JudgeLineEvent.js";
+
+export default class JudgeLine {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        /** @type {number} BPM */
+        this.bpm = data.bpm;
+
+        /**
+         * 判定线上方的音符
+         * @type {Note[]}
+         */
+        this.notesAbove = data.notesAbove.map(/** @param {any} e */(e) => new Note(e));
+
+        /**
+         * 判定线下方的音符
+         * @type {Note[]}
+         */
+        this.notesBelow = data.notesBelow.map(/** @param {any} e */(e) => new Note(e));
+
+        /** @type {SpeedEvent[]} 速度事件 */
+        this.speedEvents = data.speedEvents.map(/** @param {any} e */(e) => new SpeedEvent(e));
+
+        /** @type {judgeLineMoveEvent[]} 移动事件 */
+        this.judgeLineMoveEvents = data.judgeLineMoveEvents.map(/** @param {any} e */(e) => new judgeLineMoveEvent(e));
+
+        /** @type {judgeLineRotateEvent[]} 角度事件 */
+        this.judgeLineRotateEvents = data.judgeLineRotateEvents.map(/** @param {any} e */(e) => new judgeLineRotateEvent(e));
+
+        /** @type {judgeLineDisappearEvent[]} 透明度事件 */
+        this.judgeLineDisappearEvents = data.judgeLineDisappearEvents.map(/** @param {any} e */(e) => new judgeLineDisappearEvent(e));
+    }
+}

package/core/model/game/chartParser/base/JudgeLineEvent.js

@@ -0,0 +1,99 @@
+export class JudgeLineEvent {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        /**
+         * 事件开始时刻
+         * @type {chartTick}
+         */
+        this.startTime = data.startTime;
+
+        /**
+         * 事件结束时刻
+         * @type {chartTick}
+         */
+        this.endTime = data.endTime;
+    }
+}
+
+export class judgeLineMoveEvent extends JudgeLineEvent {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        super(data);
+
+        /**
+         * 事件开始时刻的水平位置 0-1W
+         * @type {number}
+         */
+        this.start = data.start;
+
+        /**
+         * 事件结束时刻的水平位置 0-1W
+         * @type {number}
+         */
+        this.end = data.end;
+
+        /**
+         * 事件开始时刻的垂直位置 0-1H
+         * @type {number}
+         */
+        this.start2 = data.start2;
+
+        /**
+         * 事件结束时刻的垂直位置 0-1H
+         * @type {number}
+         */
+        this.end2 = data.end2;
+    }
+}
+
+export class judgeLineRotateEvent extends JudgeLineEvent {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        super(data);
+
+        /** @typedef {number} Rotate 值表示逆时针旋转的角度（单位：度） */
+
+        /**
+         * 事件开始时刻的旋转角度
+         * @type {Rotate}
+         */
+        this.start = data.start;
+
+        /**
+         * 事件结束时刻的旋转角度
+         * @type {Rotate}
+         */
+        this.end = data.end;
+    }
+}
+
+export class judgeLineDisappearEvent extends JudgeLineEvent {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        super(data);
+
+        /**
+         * 事件开始时刻的不透明度 0-1
+         * @type {number}
+         */
+        this.start = data.start;
+
+        /**
+         * 事件结束时刻的不透明度 0-1
+         * @type {number}
+         */
+        this.end = data.end;
+    }
+}

package/core/model/game/chartParser/base/Note.js

@@ -0,0 +1,44 @@
+export default class Note {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        /** 1: tap,
+         *  2: drag,
+         *  3: hold,
+         *  4: flick
+         *  @type {1|2|3|4} */
+        this.type = data.type;
+
+        /**
+         * 1 / 32 拍
+         * @type {chartTick}
+         */
+        this.time = data.time;
+
+        /** 
+         * X坐标
+         * @type {chartX}
+         */
+        this.positionX = data.positionX;
+
+        /**
+         * 长条时间 1 / 32 拍
+         * @type {chartTick}
+         */
+        this.holdTime = data.holdTime;
+
+        /**
+         * 流速倍率
+         * @type {number}
+         */
+        this.speed = data.speed;
+
+        /**
+         * 音符距离判定线中心的初始垂直位置
+         * @type {number}
+         */
+        this.floorPosition = data.floorPosition;
+    }
+}

package/core/model/game/chartParser/base/SpeedEvent.js

@@ -0,0 +1,25 @@
+export default class SpeedEvent {
+    /**
+     * 
+     * @param {any} data 
+     */
+    constructor(data) {
+        /**
+         * 事件开始时刻
+         * @type {chartTick}
+         */
+        this.startTime = data.startTime
+
+        /**
+         * 事件结束时刻
+         * @type {chartTick}
+         */
+        this.endTime = data.endTime
+
+        /**
+         * 事件的速度
+         * @type {number}
+         */
+        this.value = data.value
+    }
+}

package/core/model/game/chartParser/base/baseType.js

@@ -0,0 +1,2 @@
+/** @typedef {number} chartTick 单位时间, 1/32拍*/
+/** @typedef {number} chartX 水平单位长度, 0.05625 屏幕宽度*/

package/core/model/game/constNum.js

@@ -0,0 +1,215 @@
+
+/**
+ * 难度映射
+ * @type {allLevelKind[]}
+ */
+export const allLevel = ['EZ', 'HD', 'IN', 'AT', 'LEGACY']
+
+/**
+ * 难度映射
+ * @type {levelKind[]}
+ */
+export const Level = ['EZ', 'HD', 'IN', 'AT']
+
+export const LevelNum = {
+    EZ: 0,
+    HD: 1,
+    IN: 2,
+    AT: 3,
+    LEGACY: 4,
+}
+
+/**redis路径前缀 */
+export const redisPath = "phiPlugin"
+
+/**最大难度 */
+export const MAX_DIFFICULTY = 17.6
+    
+export const APII18NCN = {
+    userNotFound: `未找到对应 用户`
+}
+
+export const APIBASEURL = "https://phib19.top:8080"
+// export const APIBASEURL = "http://localhost:8081"
+
+/**
+ * 用户个性化设置项标题与解释
+ */
+export const USER_SETTING_META = {
+    theme: {
+        title: '主题风格',
+        description: '使用/myset theme <序号>修改，控制图片页面的整体视觉风格，仅影响你的个人渲染结果。'
+    },
+    b30AvgKind: {
+        title: 'B30统计数据展示',
+        description: '使用/myset avgkind <序号>修改，控制 B30 均值条展示的数据，可按全部平均数、仅 B30平均数 或 百分比绝对位置。'
+    },
+    b30AvgColor: {
+        title: 'B30均值条配色',
+        description: '使用/myset avgcolor <序号>修改，控制 B30 均值条的主色，用于快速区分你的展示偏好。'
+    },
+    allowApiUsage: {
+        title: 'API功能开关',
+        description: '使用/myset api <序号>修改，关闭后将不再使用在线查分平台相关功能。'
+    },
+    showB30Analysis: {
+        title: 'B30统计分析',
+        description: '使用/myset B30分析 <序号>修改，控制 B30 图片末尾的谱面标签能力与等效 RKS 直方图。'
+    }
+}
+
+/**
+ * 用户个性化设置可选项标题与解释
+ */
+export const USER_SETTING_OPTIONS = {
+    theme: {
+        default: {
+            title: '[0]默认',
+            description: '使用插件基础主题，使用随机曲绘作为背景。'
+        },
+        snow: {
+            title: '[1]寒冬',
+            description: '在默认的基础上加入飘落雪花元素。'
+        },
+        star: {
+            title: '[2]使一颗心免于哀伤',
+            description: '飞萤之火自无梦的长夜亮起，绽放在终竟的明天。'
+        },
+        dss2: {
+            title: '[3]大师赛2',
+            description: 'Phigros 大师赛第二赛季主题配色'
+        }
+    },
+    b30AvgKind: {
+        all: {
+            title: '[0]全部统计',
+            description: '展示在相近rks的玩家中全部成绩的平均值统计，信息最完整。将使用全部四种颜色区分不同的相对位置关系。'
+        },
+        b30: {
+            title: '[1]仅 B30',
+            description: '展示在相近rks的玩家中只按 B30 成绩平均值统计，关注B30健康度。将使用前两个或后两个颜色，下个选项选择任意一个颜色时将同时使用与其对应的颜色'
+        },
+        top: {
+            title: '[2]仅 Top',
+            description: '展示玩家成绩在相近rks的玩家中所有成绩和仅考虑B30成绩中的排名百分比，展示格式：[Top： 全体 / B30]。将全部使用下个选项选择的颜色进行展示'
+        },
+        none: {
+            title: '[3]隐藏',
+            description: '不展示B30均值相关信息，界面更简洁。'
+        }
+    },
+    b30AvgColor: {
+        red: {
+            title: '[0]红',
+            description: '高对比暖色，视觉冲击更强。'
+        },
+        gold: {
+            title: '[1]金',
+            description: '偏亮金色，强调成就感和层级感。'
+        },
+        blue: {
+            title: '[2]蓝',
+            description: '冷色调方案，信息阅读更平稳。'
+        },
+        green: {
+            title: '[3]绿',
+            description: '中性偏亮配色，整体观感更清新。'
+        }
+    },
+    allowApiUsage: {
+        true: {
+            title: '[0]启用',
+            description: '允许插件使用在线查分平台相关能力。'
+        },
+        false: {
+            title: '[1]禁用',
+            description: '禁用在线查分平台能力，仅使用本地数据。'
+        }
+    },
+    showB30Analysis: {
+        true: {
+            title: '[0]显示',
+            description: '在 B30 图片末尾显示谱面标签能力和等效 RKS 直方图。'
+        },
+        false: {
+            title: '[1]隐藏',
+            description: '隐藏完整的 B30 统计分析区域。'
+        }
+    }
+}
+
+export const USER_API_SETTING_META = {
+    allowDataCollection: {
+        title: '数据收集同意',
+        description: '控制是否同意插件收集你的游戏数据（如成绩、游玩时间等）用于统计分析和功能优化，帮助我们改进插件性能和用户体验。关闭后将同步禁用下方所有选项。'
+    },
+    allowLeaderboard: {
+        title: '排行榜展示',
+        description: '同意将你的成绩展示在在线排行榜中，供其他玩家查看和比较。'
+    },
+    allowDataAggregation: {
+        title: '数据聚合',
+        description: '同意将你的成绩数据匿名化后用于整体统计分析，分析结果将用于推分建议以及谱面分析、定位等功能。'
+    },
+    allowPlayerIdSearch: {
+        title: '玩家ID搜索',
+        description: '同意其他玩家通过你游戏中的的玩家ID搜索到你的成绩信息，便于社交互动和成绩比较。'
+    },
+    allowUserIdSearch: {
+        title: '用户ID搜索',
+        description: '控制是否同意使用用户ID进行绑定，其他玩家可以通过用户id获取到你的成绩信息'
+    }
+}
+
+export const USER_API_SETTING_OPTIONS = {
+    allowDataCollection: {
+        true: {
+            title: '[1]同意',
+            description: ''
+        },
+        false: {
+            title: '[0]拒绝',
+            description: '插件将仅使用本地数据，不会上传任何信息。'
+        }
+    },
+    allowLeaderboard: {
+        true: {
+            title: '[1]同意',
+            description: ''
+        },
+        false: {
+            title: '[0]拒绝',
+            description: '你的成绩将不会在排行榜中展示。'
+        }
+    },
+    allowDataAggregation: {
+        true: {
+            title: '[1]同意',
+            description: ''
+        },
+        false: {
+            title: '[0]拒绝',
+            description: '拒绝将你的成绩数据用于统计分析，插件将不会使用你的数据进行任何形式的分析或报告。'
+        }
+    },
+    allowPlayerIdSearch: {
+        true: {
+            title: '[1]同意',
+            description: ''
+        },
+        false: {
+            title: '[0]拒绝',
+            description: '其他人将无法通过你的游戏ID搜索到你的成绩信息。'
+        }
+    },
+    allowUserIdSearch: {
+        true: {
+            title: '[1]同意',
+            description: ''
+        },
+        false: {    
+            title: '[0]拒绝',
+            description: '禁止使用用户ID获取存档，将禁用用户ID绑定功能。'
+        }
+    }
+}