koishi-plugin-noah 1.7.1 → 1.7.5

package/lib/core/utils/server.d.ts

@@ -0,0 +1,8 @@
+import { Context } from 'koishi';
+import { ServerService } from '../services/server-service';
+import { UserService } from '../services/user-service';
+/**
+ * Ensure the user has an Official (KONAMI) server and return its id.
+ * Creates one with the configured support URL when missing.
+ */
+export declare function ensureOfficialServerForUser(ctx: Context, serverService: ServerService, userService: UserService, uid: number, officialSupportUrl?: string): Promise<number>;

package/lib/games/sdvx/commands/info.d.ts

@@ -0,0 +1,3 @@
+import { Context, Logger } from 'koishi';
+import { SDVXConfig } from '../../../types/config';
+export declare function info(ctx: Context, config: SDVXConfig, logger: Logger): void;

package/lib/games/sdvx/utils/vf.d.ts

@@ -1,8 +1,16 @@
 import { SDVXGrade, SDVXClearType, SDVXScore } from '../types';
+/**
+ * 使用 100 作为倍率基准，避免浮点误差。
+ */
+export declare const FACTOR_SCALE = 100;
+/**
+ * VF 公式中的常量（分数与系数乘积乘以缩放后再取整）。
+ */
+export declare const VOLFORCE_BASE_DENOMINATOR: bigint;
 /**
  * 计算 Volforce 值
- * @param raw_score - API 返回的分数对象
- * @returns 计算后的 Volforce 值
+ * @param raw_score - API 返回的单曲成绩
+ * @returns 保留 0.05 步进的 Volforce
  */
 export declare function calculateVolforce(raw_score: SDVXScore): number;
 /**
@@ -11,9 +19,21 @@ export declare function calculateVolforce(raw_score: SDVXScore): number;
  * @returns 等级系数
  */
 export declare function getGradeFactor(grade: SDVXGrade): number;
+/**
+ * 获取指定等级系数的整数缩放值
+ */
+export declare function getGradeFactorScale(grade: SDVXGrade): number;
 /**
  * 获取指定通关类型的系数
  * @param clearType - 要获取系数的通关类型
- * @returns 通关类型系数
+ * @returns 通关系数
  */
 export declare function getClearFactor(clearType: SDVXClearType): number;
+/**
+ * 获取指定通关类型系数的整数缩放值
+ */
+export declare function getClearFactorScale(clearType: SDVXClearType): number;
+/**
+ * 基于整数系数返回精确的 VF 整数值，方便复用。
+ */
+export declare function calculateVolforceIntValue(level: number, score: number, grade: SDVXGrade, clearType: SDVXClearType): number;