@@ -4095,6 +4195,13 @@ import {
} from "./groupsModelsList";
import { createModelsListCandidatesTracker } from "./groupsModelsListCandidates";
import { normalizeSupportedModelScopesForPlatform } from "./groupsSupportedModelScopes";
+import {
+ isProfitControlPlatform,
+ profitPercentToDecimal,
+ profitDecimalToPercent,
+ validateProfitControlFormState,
+ type ProfitControlFormState,
+} from "./groupsProfitControl";
import {
normalizeReasoningEffortForPlatform,
reasoningEffortMappingsToAPI,
@@ -4618,6 +4725,10 @@ const createForm = reactive({
peak_start: "",
peak_end: "",
peak_rate_multiplier: 1.0,
+ // 分组利润控制（五个 token 平台）；界面按百分比输入，提交时转小数
+ profit_control_enabled: false,
+ profit_min_margin_percent: 0,
+ profit_safety_buffer_percent: 0,
// Claude Code 客户端限制（仅 anthropic 平台使用）
claude_code_only: false,
fallback_group_id: null as number | null,
@@ -4968,6 +5079,10 @@ const editForm = reactive({
peak_start: "",
peak_end: "",
peak_rate_multiplier: 1.0,
+ // 分组利润控制（五个 token 平台）；界面按百分比输入，提交时转小数
+ profit_control_enabled: false,
+ profit_min_margin_percent: 0,
+ profit_safety_buffer_percent: 0,
// Claude Code 客户端限制（仅 anthropic 平台使用）
claude_code_only: false,
fallback_group_id: null as number | null,
@@ -5412,6 +5527,9 @@ const closeCreateModal = () => {
createForm.peak_start = "";
createForm.peak_end = "";
createForm.peak_rate_multiplier = 1.0;
+ createForm.profit_control_enabled = false;
+ createForm.profit_min_margin_percent = 0;
+ createForm.profit_safety_buffer_percent = 0;
createForm.claude_code_only = false;
createForm.fallback_group_id = null;
createForm.fallback_group_id_on_invalid_request = null;
@@ -5459,6 +5577,19 @@ const normalizeRateMultiplier = (
return Number.isFinite(parsed) && parsed >= 0 ? parsed : 1;
};
+// 利润控制表单辅助（换算与校验逻辑见 groupsProfitControl.ts，便于单测）。
+const percentToDecimal = profitPercentToDecimal;
+const decimalToPercent = profitDecimalToPercent;
+
+const validateProfitControlForm = (form: ProfitControlFormState): boolean => {
+ const errorKey = validateProfitControlFormState(form);
+ if (errorKey) {
+ appStore.showError(t(`admin.groups.profitControl.${errorKey}`));
+ return false;
+ }
+ return true;
+};
+
const handleCreateGroup = async () => {
if (!createForm.name.trim()) {
appStore.showError(t("admin.groups.nameRequired"));
@@ -5471,6 +5602,9 @@ const handleCreateGroup = async () => {
) {
return;
}
+ if (!validateProfitControlForm(createForm)) {
+ return;
+ }
submitting.value = true;
try {
// 构建请求数据，包含模型路由配置
@@ -5506,7 +5640,17 @@ const handleCreateGroup = async () => {
reasoning_effort_mappings: reasoningEffortMappingsToAPI(
createForm.reasoning_effort_mappings,
),
+ // 利润控制：界面百分比转小数提交；仅五个 token 平台可启用
+ profit_control_enabled:
+ isProfitControlPlatform(createForm.platform) &&
+ createForm.profit_control_enabled,
+ profit_min_margin: percentToDecimal(createForm.profit_min_margin_percent),
+ profit_safety_buffer: percentToDecimal(
+ createForm.profit_safety_buffer_percent,
+ ),
};
+ delete (requestData as Record
).profit_min_margin_percent;
+ delete (requestData as Record).profit_safety_buffer_percent;
// v-model.number 清空输入框时产生 ""，转为 null 让后端设为无限制
const emptyToNull = (v: any) => (v === "" ? null : v);
requestData.daily_limit_usd = emptyToNull(requestData.daily_limit_usd);
@@ -5594,6 +5738,13 @@ const handleEdit = async (group: AdminGroup) => {
editForm.peak_start = group.peak_start ?? "";
editForm.peak_end = group.peak_end ?? "";
editForm.peak_rate_multiplier = group.peak_rate_multiplier ?? 1.0;
+ editForm.profit_control_enabled = group.profit_control_enabled ?? false;
+ editForm.profit_min_margin_percent = decimalToPercent(
+ group.profit_min_margin ?? 0,
+ );
+ editForm.profit_safety_buffer_percent = decimalToPercent(
+ group.profit_safety_buffer ?? 0,
+ );
editForm.claude_code_only = group.claude_code_only || false;
editForm.fallback_group_id = group.fallback_group_id;
editForm.fallback_group_id_on_invalid_request =
@@ -5654,6 +5805,9 @@ const closeEditModal = () => {
editForm.peak_start = "";
editForm.peak_end = "";
editForm.peak_rate_multiplier = 1.0;
+ editForm.profit_control_enabled = false;
+ editForm.profit_min_margin_percent = 0;
+ editForm.profit_safety_buffer_percent = 0;
editForm.video_rate_independent = false;
editForm.video_rate_multiplier = 1;
editForm.video_price_480p = null;
@@ -5678,6 +5832,9 @@ const handleUpdateGroup = async () => {
) {
return;
}
+ if (!validateProfitControlForm(editForm)) {
+ return;
+ }
submitting.value = true;
try {
@@ -5720,7 +5877,17 @@ const handleUpdateGroup = async () => {
reasoning_effort_mappings: reasoningEffortMappingsToAPI(
editForm.reasoning_effort_mappings,
),
+ // 利润控制：界面百分比转小数提交；仅五个 token 平台可启用
+ profit_control_enabled:
+ isProfitControlPlatform(editForm.platform) &&
+ editForm.profit_control_enabled,
+ profit_min_margin: percentToDecimal(editForm.profit_min_margin_percent),
+ profit_safety_buffer: percentToDecimal(
+ editForm.profit_safety_buffer_percent,
+ ),
};
+ delete (payload as Record).profit_min_margin_percent;
+ delete (payload as Record).profit_safety_buffer_percent;
// v-model.number 清空输入框时产生 ""，转为 null 让后端设为无限制
const emptyToNull = (v: any) => (v === "" ? null : v);
payload.daily_limit_usd = emptyToNull(payload.daily_limit_usd);
@@ -6068,6 +6235,11 @@ watch(
resetMessagesDispatchFormState(createForm);
createForm.allow_live = false;
}
+ if (!isProfitControlPlatform(newVal)) {
+ createForm.profit_control_enabled = false;
+ createForm.profit_min_margin_percent = 0;
+ createForm.profit_safety_buffer_percent = 0;
+ }
createForm.max_reasoning_effort = normalizeReasoningEffortForPlatform(
newVal,
createForm.max_reasoning_effort,
@@ -6111,6 +6283,11 @@ watch(
resetMessagesDispatchFormState(editForm);
editForm.allow_live = false;
}
+ if (!isProfitControlPlatform(newVal)) {
+ editForm.profit_control_enabled = false;
+ editForm.profit_min_margin_percent = 0;
+ editForm.profit_safety_buffer_percent = 0;
+ }
editForm.max_reasoning_effort = normalizeReasoningEffortForPlatform(
newVal,
editForm.max_reasoning_effort,
diff --git a/frontend/src/views/admin/__tests__/groupsProfitControl.spec.ts b/frontend/src/views/admin/__tests__/groupsProfitControl.spec.ts
new file mode 100644
index 0000000000..21e458281e
--- /dev/null
+++ b/frontend/src/views/admin/__tests__/groupsProfitControl.spec.ts
@@ -0,0 +1,153 @@
+import { describe, expect, it } from "vitest";
+
+import {
+ profitDecimalToPercent,
+ profitPercentToDecimal,
+ validateProfitControlFormState,
+ type ProfitControlFormState,
+} from "../groupsProfitControl";
+
+const formState = (
+ overrides: Partial = {},
+): ProfitControlFormState => ({
+ platform: "openai",
+ profit_control_enabled: true,
+ profit_min_margin_percent: 30,
+ profit_safety_buffer_percent: 0,
+ ...overrides,
+});
+
+describe("profitPercentToDecimal", () => {
+ it("converts percent input to backend decimal", () => {
+ expect(profitPercentToDecimal(30)).toBe(0.3);
+ expect(profitPercentToDecimal(5)).toBe(0.05);
+ expect(profitPercentToDecimal(33.33)).toBe(0.3333);
+ expect(profitPercentToDecimal(99.99)).toBe(0.9999);
+ });
+
+ it("rounds to four decimal places matching decimal(10,4) storage", () => {
+ expect(profitPercentToDecimal(33.333)).toBe(0.3333);
+ expect(profitPercentToDecimal(0.005)).toBe(0.0001);
+ });
+
+ it("treats empty, invalid and non-positive input as zero", () => {
+ expect(profitPercentToDecimal("")).toBe(0);
+ expect(profitPercentToDecimal(null)).toBe(0);
+ expect(profitPercentToDecimal(undefined)).toBe(0);
+ expect(profitPercentToDecimal("abc")).toBe(0);
+ expect(profitPercentToDecimal(-5)).toBe(0);
+ expect(profitPercentToDecimal(0)).toBe(0);
+ });
+});
+
+describe("profitDecimalToPercent", () => {
+ it("converts backend decimal to percent without float tail noise", () => {
+ expect(profitDecimalToPercent(0.3)).toBe(30);
+ expect(profitDecimalToPercent(0.05)).toBe(5);
+ expect(profitDecimalToPercent(0.3333)).toBe(33.33);
+ expect(profitDecimalToPercent(0.9999)).toBe(99.99);
+ });
+
+ it("treats missing and non-positive values as zero", () => {
+ expect(profitDecimalToPercent(null)).toBe(0);
+ expect(profitDecimalToPercent(undefined)).toBe(0);
+ expect(profitDecimalToPercent(0)).toBe(0);
+ expect(profitDecimalToPercent(-0.3)).toBe(0);
+ });
+
+ it("round-trips representative storage values", () => {
+ for (const decimal of [0.05, 0.1, 0.3, 0.3333, 0.5, 0.75, 0.9999]) {
+ expect(profitPercentToDecimal(profitDecimalToPercent(decimal))).toBe(
+ decimal,
+ );
+ }
+ });
+});
+
+describe("validateProfitControlFormState", () => {
+ it("passes valid enabled configurations", () => {
+ expect(validateProfitControlFormState(formState())).toBeNull();
+ expect(
+ validateProfitControlFormState(
+ formState({
+ profit_min_margin_percent: 0,
+ profit_safety_buffer_percent: 0,
+ }),
+ ),
+ ).toBeNull();
+ expect(
+ validateProfitControlFormState(
+ formState({
+ profit_min_margin_percent: 60,
+ profit_safety_buffer_percent: 39.99,
+ }),
+ ),
+ ).toBeNull();
+ });
+
+ it("validates all five supported platforms and skips unsupported platforms", () => {
+ expect(
+ validateProfitControlFormState(
+ formState({ profit_control_enabled: false, profit_min_margin_percent: 200 }),
+ ),
+ ).toBeNull();
+ expect(
+ validateProfitControlFormState(
+ formState({ platform: "anthropic", profit_min_margin_percent: 200 }),
+ ),
+ ).toBe("marginRangeError");
+ for (const platform of ["openai", "anthropic", "gemini", "grok", "antigravity"]) {
+ expect(validateProfitControlFormState(formState({ platform }))).toBeNull();
+ }
+ expect(
+ validateProfitControlFormState(
+ formState({ platform: "composite", profit_min_margin_percent: 200 }),
+ ),
+ ).toBeNull();
+ });
+
+ it("treats empty inputs as zero", () => {
+ expect(
+ validateProfitControlFormState(
+ formState({
+ profit_min_margin_percent: "",
+ profit_safety_buffer_percent: null,
+ }),
+ ),
+ ).toBeNull();
+ });
+
+ it("rejects out-of-range margin and buffer", () => {
+ expect(
+ validateProfitControlFormState(
+ formState({ profit_min_margin_percent: 100 }),
+ ),
+ ).toBe("marginRangeError");
+ expect(
+ validateProfitControlFormState(
+ formState({ profit_min_margin_percent: -1 }),
+ ),
+ ).toBe("marginRangeError");
+ expect(
+ validateProfitControlFormState(
+ formState({ profit_safety_buffer_percent: 100 }),
+ ),
+ ).toBe("bufferRangeError");
+ expect(
+ validateProfitControlFormState(
+ formState({ profit_safety_buffer_percent: -0.1 }),
+ ),
+ ).toBe("bufferRangeError");
+ });
+
+ it("rejects margin plus buffer reaching 100 percent", () => {
+ expect(
+ validateProfitControlFormState(
+ formState({
+ profit_min_margin_percent: 60,
+ profit_safety_buffer_percent: 40,
+ }),
+ ),
+ ).toBe("sumTooHigh");
+ });
+});
diff --git a/frontend/src/views/admin/groupsProfitControl.ts b/frontend/src/views/admin/groupsProfitControl.ts
new file mode 100644
index 0000000000..6bb55761ed
--- /dev/null
+++ b/frontend/src/views/admin/groupsProfitControl.ts
@@ -0,0 +1,56 @@
+// 分组利润控制表单辅助：百分比 <-> 小数换算与提交前校验。
+// 后端按小数存 decimal(10,4)（0.30 = 30%），界面按百分比输入展示；
+// 固定 4 位小数精度，避免 0.3 * 100 = 30.000000000000004 之类的浮点尾数回显。
+
+export const profitPercentToDecimal = (
+ value: number | string | null | undefined,
+): number => {
+ const parsed = Number(value);
+ if (!Number.isFinite(parsed) || parsed <= 0) {
+ return 0;
+ }
+ return Math.round(parsed * 100) / 10000;
+};
+
+export const profitDecimalToPercent = (
+ value: number | null | undefined,
+): number => {
+ const parsed = Number(value);
+ if (!Number.isFinite(parsed) || parsed <= 0) {
+ return 0;
+ }
+ return Math.round(parsed * 1e6) / 1e4;
+};
+
+export type ProfitControlFormState = {
+ platform: string;
+ profit_control_enabled: boolean;
+ profit_min_margin_percent: number | string | null;
+ profit_safety_buffer_percent: number | string | null;
+};
+
+export const isProfitControlPlatform = (platform: string): boolean =>
+ ["openai", "anthropic", "gemini", "grok", "antigravity"].includes(platform);
+
+// 提交前校验：margin/buffer 各自 ∈ [0,100)，且相加 < 100（否则阈值 <= 0，
+// 所有可核价账号都会被排除）。返回 null 表示通过，否则返回错误信息的 i18n key
+//（相对 admin.groups.profitControl 前缀）。仅支持平台且开关开启时才校验。
+export const validateProfitControlFormState = (
+ form: ProfitControlFormState,
+): string | null => {
+ if (!isProfitControlPlatform(form.platform) || !form.profit_control_enabled) {
+ return null;
+ }
+ const margin = Number(form.profit_min_margin_percent || 0);
+ const buffer = Number(form.profit_safety_buffer_percent || 0);
+ if (!Number.isFinite(margin) || margin < 0 || margin >= 100) {
+ return "marginRangeError";
+ }
+ if (!Number.isFinite(buffer) || buffer < 0 || buffer >= 100) {
+ return "bufferRangeError";
+ }
+ if (margin + buffer >= 100) {
+ return "sumTooHigh";
+ }
+ return null;
+};