node-resource-utils 0.0.0-stage → 1.1.8

package/resources/src/lib/validation.ts

@@ -0,0 +1,658 @@
+/**
+ * 输入合理性校验底座 —— 前端表单、后端接口、AI 动态表单共用同一套规则。
+ *
+ * ★ 为什么单独抽一层，而不是在每个 Form.Item 里写正则：
+ *   比赛会换题/加字段，如果校验规则散落在页面和接口里，每加一个「身份证号」
+ *   就要前端写一遍 required、后端再写一遍 zod，提示语还对不上。
+ *   这里把「字段类型 → 规整方式 + 校验逻辑 + 友好提示」收敛成注册表：
+ *     - 新题加字段：优先复用内置类型；不够用时 registerFieldType() 注册一个即可
+ *     - 前端：formRules() / autoFormRules() 直接产出 antd 规则
+ *     - 后端：zField() / zOptionalField() / zNullableField() 直接产出 zod schema
+ *     - AI 表单：inferValidationType() 按字段名/中文标签自动识别，无需人工配置
+ *
+ * ★ 提示语原则：
+ *   1. 说清楚「字段叫什么、错在哪、正确格式长什么样」
+ *   2. 不把正则原文、英文报错、堆栈丢给用户
+ *   3. 校验前先规整（去空格、身份证 X 大写、手机号去 +86），避免「明明没错却报错」
+ */
+
+export type ValidationType =
+  | 'text'
+  | 'name'
+  | 'username'
+  | 'password'
+  | 'idCard'
+  | 'phone'
+  | 'email'
+  | 'contact'
+  | 'code'
+  | 'bankCard'
+  | 'creditCode'
+  | 'postalCode'
+  | 'url'
+  | 'date'
+  | 'integer'
+  | 'number'
+  | 'amount';
+
+/** 校验上下文。min/max 对文本是长度，对数字是数值范围 */
+export interface ValidationOptions {
+  /** 字段中文名，用于拼出「请输入姓名」「手机号应为 11 位」 */
+  label?: string;
+  /** 必填。为空时返回「请输入 xxx」 */
+  required?: boolean;
+  /** 文本最小/最大长度；数字类型下表示数值下限/上限 */
+  min?: number;
+  max?: number;
+  /** 额外正则（在内置规则通过后执行） */
+  pattern?: RegExp;
+  patternMessage?: string;
+  /** 密码强度：basic = 6-64 位；strong = 8-64 位且同时含字母和数字 */
+  strength?: 'basic' | 'strong';
+}
+
+export type ValidationResult =
+  | {
+      ok: true;
+      /** 规整后的值（去首尾空白、身份证 X 大写、手机号去 +86 等） */
+      value: string;
+      message?: undefined;
+    }
+  | {
+      ok: false;
+      /** 规整后的值（即使不合法也保留，便于表单回填） */
+      value: string;
+      /** 就直接展示给用户的友好提示 */
+      message: string;
+    };
+
+type CheckContext = ValidationOptions & { label: string };
+
+export interface FieldTypeDefinition {
+  /** 默认中文名，options.label 未提供时使用 */
+  label: string;
+  /** 输入框建议 maxLength（仅 UI 用，不参与业务判断） */
+  suggestedMaxLength?: number;
+  /** 校验前规整。默认去首尾空白 */
+  normalize?: (value: string) => string;
+  /** 返回 null 表示通过；返回字符串表示友好提示 */
+  check: (value: string, ctx: CheckContext) => string | null;
+  /** min/max 是否按字符长度解释。数字类型设为 false，交给 check 按数值判断 */
+  lengthOptions?: boolean;
+}
+
+/* ------------------------------ 基础工具 ------------------------------ */
+
+function asText(value: unknown): string {
+  if (value === undefined || value === null) return '';
+  return typeof value === 'string' ? value : String(value);
+}
+
+function trim(value: string): string {
+  return value.trim();
+}
+
+function charCount(value: string): number {
+  return Array.from(value).length;
+}
+
+/** 中文输入法下常见的全角数字/字母/符号 → 半角，避免「格式明明没错却报错」 */
+function toHalfWidth(value: string): string {
+  return value
+    .replace(/[\uFF01-\uFF5E]/g, (ch) => String.fromCharCode(ch.charCodeAt(0) - 0xfee0))
+    .replace(/\u3000/g, ' ');
+}
+
+function normalizePhone(value: string): string {
+  let out = toHalfWidth(value).replace(/[\s\-()]/g, '');
+  // 允许 +86 / 86 / 0086 前缀；只在后面正好是 11 位时剥离，避免把 86 开头的号码误伤
+  out = out.replace(/^(\+?86|0086)(?=\d{11}$)/, '');
+  return out;
+}
+
+function normalizeDate(value: string): string {
+  const s = toHalfWidth(value).trim();
+  // 允许 Excel 导出的 `2024-01-31 00:00:00` / ISO 时间：日期字段只保留日期部分
+  const m = /^(\d{4})[-/.](\d{1,2})[-/.](\d{1,2})(?:[ T].*)?$/.exec(s);
+  if (!m) return s;
+  return `${m[1]}-${m[2].padStart(2, '0')}-${m[3].padStart(2, '0')}`;
+}
+
+function normalizeNumberText(value: string): string {
+  // 容忍用户从 Excel / 收据里复制的千分位、货币符号和空格
+  return toHalfWidth(value)
+    .replace(/[,，\s¥￥$]/g, '')
+    .trim();
+}
+
+/* ------------------------------ 身份证 ------------------------------ */
+
+/** 合法省份前两位。能挡掉 123456… 这类明显编造的号码 */
+const ID_REGION_PREFIXES = new Set([
+  '11',
+  '12',
+  '13',
+  '14',
+  '15',
+  '21',
+  '22',
+  '23',
+  '31',
+  '32',
+  '33',
+  '34',
+  '35',
+  '36',
+  '37',
+  '41',
+  '42',
+  '43',
+  '44',
+  '45',
+  '46',
+  '50',
+  '51',
+  '52',
+  '53',
+  '54',
+  '61',
+  '62',
+  '63',
+  '64',
+  '65',
+  '71',
+  '81',
+  '82',
+]);
+
+const ID_WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+const ID_CHECK_CODES = '10X98765432';
+
+function idCardCheckChar(body17: string): string {
+  let sum = 0;
+  for (let i = 0; i < 17; i++) sum += Number(body17[i]) * ID_WEIGHTS[i];
+  return ID_CHECK_CODES[sum % 11];
+}
+
+/** 校验身份证里的 YYYYMMDD；返回提示或 null */
+function checkBirthday(birth: string, label: string): string | null {
+  if (!/^\d{8}$/.test(birth)) return `${label}中的出生日期不完整`;
+  const year = Number(birth.slice(0, 4));
+  const month = Number(birth.slice(4, 6));
+  const day = Number(birth.slice(6, 8));
+  if (year < 1900) return `${label}中的出生年份不合理`;
+  const date = new Date(Date.UTC(year, month - 1, day));
+  if (
+    date.getUTCFullYear() !== year ||
+    date.getUTCMonth() !== month - 1 ||
+    date.getUTCDate() !== day
+  ) {
+    return `${label}中的出生日期不存在，请核对`;
+  }
+  if (date.getTime() > Date.now()) return `${label}中的出生日期不能晚于今天`;
+  if (new Date().getUTCFullYear() - year > 150) return `${label}中的出生年份不合理`;
+  return null;
+}
+
+function checkIdCard(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (value.length !== 15 && value.length !== 18) {
+    return `${label}应为 15 位或 18 位`;
+  }
+  if (!/^\d+$/.test(value.slice(0, 15))) {
+    return `${label}只能包含数字，18 位时最后一位可以是 X`;
+  }
+  if (value.length === 15) {
+    if (!/^\d{15}$/.test(value)) return `15 位${label}应全部为数字`;
+    if (!ID_REGION_PREFIXES.has(value.slice(0, 2))) return `${label}前两位地区码不正确，请核对`;
+    return checkBirthday(`19${value.slice(6, 12)}`, label);
+  }
+  if (!/^\d{17}[\dX]$/.test(value)) {
+    return `18 位${label}应由 17 位数字和 1 位校验码组成（校验码可为 X）`;
+  }
+  if (!ID_REGION_PREFIXES.has(value.slice(0, 2))) return `${label}前两位地区码不正确，请核对`;
+  const birthMsg = checkBirthday(value.slice(6, 14), label);
+  if (birthMsg) return birthMsg;
+  const expected = idCardCheckChar(value.slice(0, 17));
+  if (value[17] !== expected) return `${label}校验位不正确，请核对是否输错`;
+  return null;
+}
+
+/* ------------------------------ 各字段类型 ------------------------------ */
+
+const CN_NAME_RE = /^[\u3400-\u4DBF\u4E00-\u9FFF·•]{2,32}$/;
+const EN_NAME_RE = /^[A-Za-z][A-Za-z .'-]{1,31}$/;
+
+function checkName(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (CN_NAME_RE.test(value)) {
+    if (/^[·•]|[·•]$|[·•]{2}/.test(value)) return `${label}中的间隔号「·」位置不正确`;
+    return null;
+  }
+  if (EN_NAME_RE.test(value)) return null;
+  if (charCount(value) < 2) return `${label}至少需要 2 个字符`;
+  if (charCount(value) > 32) return `${label}不能超过 32 个字符`;
+  if (/\d/.test(value)) return `${label}不能包含数字`;
+  if (/\s/.test(value)) return `${label}不能包含空格`;
+  if (/[^\u3400-\u4DBF\u4E00-\u9FFFA-Za-z·• .'-]/.test(value)) {
+    return `${label}不能包含特殊符号`;
+  }
+  return `${label}格式不正确，请填写真实姓名`;
+}
+
+function checkUsername(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (charCount(value) < 3) return `${label}至少需要 3 个字符`;
+  if (charCount(value) > 32) return `${label}不能超过 32 个字符`;
+  if (!/^[A-Za-z]/.test(value)) return `${label}需以字母开头`;
+  if (!/^[A-Za-z0-9_-]+$/.test(value)) return `${label}只能包含字母、数字、下划线或短横线`;
+  return null;
+}
+
+function checkPassword(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  const strong = ctx.strength === 'strong';
+  const min = ctx.min ?? (strong ? 8 : 6);
+  const max = ctx.max ?? 64;
+  if (/\s/.test(value)) return `${label}不能包含空格`;
+  if (charCount(value) < min) return `${label}至少需要 ${min} 位`;
+  if (charCount(value) > max) return `${label}不能超过 ${max} 位`;
+  if (strong && (!/[A-Za-z]/.test(value) || !/\d/.test(value))) {
+    return `${label}需同时包含字母和数字`;
+  }
+  return null;
+}
+
+function checkPhone(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (!/^\d+$/.test(value)) return `${label}只能包含数字`;
+  if (value.length !== 11) return `${label}应为 11 位数字`;
+  if (!/^1[3-9]\d{9}$/.test(value)) {
+    return `${label}应以 1 开头，第二位为 3-9，例如 13800138000`;
+  }
+  return null;
+}
+
+const EMAIL_RE =
+  /^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/;
+
+function checkEmail(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (charCount(value) > 254) return `${label}不能超过 254 个字符`;
+  if (!EMAIL_RE.test(value)) return `${label}格式不正确，例如 name@example.com`;
+  return null;
+}
+
+function checkContact(value: string, ctx: CheckContext): string | null {
+  if (value.includes('@')) {
+    return checkEmail(value, ctx)
+      ? `${ctx.label}需填写正确的手机号或邮箱，例如 13800138000 / name@example.com`
+      : null;
+  }
+  return checkPhone(value, ctx)
+    ? `${ctx.label}需填写正确的手机号或邮箱，例如 13800138000 / name@example.com`
+    : null;
+}
+
+function checkCode(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (charCount(value) > 32) return `${label}不能超过 32 个字符`;
+  if (!/^[A-Za-z0-9_-]+$/.test(value)) {
+    return `${label}只能包含字母、数字、下划线或短横线`;
+  }
+  return null;
+}
+
+function checkBankCard(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (!/^\d+$/.test(value)) return `${label}只能包含数字`;
+  if (value.length < 16 || value.length > 19) return `${label}应为 16-19 位数字`;
+  let sum = 0;
+  let double = false;
+  for (let i = value.length - 1; i >= 0; i--) {
+    let n = Number(value[i]);
+    if (double) {
+      n *= 2;
+      if (n > 9) n -= 9;
+    }
+    sum += n;
+    double = !double;
+  }
+  if (sum % 10 !== 0) return `${label}校验失败，请核对卡号`;
+  return null;
+}
+
+const CREDIT_CODE_CHARS = '0123456789ABCDEFGHJKLMNPQRTUWXY';
+const CREDIT_CODE_WEIGHTS = [1, 3, 9, 27, 19, 26, 16, 17, 20, 29, 25, 13, 8, 24, 10, 30, 28];
+
+function checkCreditCode(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (value.length !== 18) return `${label}应为 18 位`;
+  let sum = 0;
+  for (let i = 0; i < 17; i++) {
+    const index = CREDIT_CODE_CHARS.indexOf(value[i]);
+    if (index < 0) return `${label}包含不支持的字符`;
+    sum += index * CREDIT_CODE_WEIGHTS[i];
+  }
+  const expected = CREDIT_CODE_CHARS[(31 - (sum % 31)) % 31];
+  if (value[17] !== expected) return `${label}校验位不正确，请核对`;
+  return null;
+}
+
+function checkPostalCode(value: string, ctx: CheckContext): string | null {
+  if (!/^[1-9]\d{5}$/.test(value)) return `${ctx.label}应为 6 位数字，且不能以 0 开头`;
+  return null;
+}
+
+function checkUrl(value: string, ctx: CheckContext): string | null {
+  if (value.length > 2048) return `${ctx.label}不能超过 2048 个字符`;
+  try {
+    const url = new URL(value);
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+      return `${ctx.label}需以 http:// 或 https:// 开头`;
+    }
+    return null;
+  } catch {
+    return `${ctx.label}格式不正确，例如 https://example.com`;
+  }
+}
+
+function checkDate(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (!m) return `${label}格式不正确，请使用 YYYY-MM-DD（如 2024-01-31）`;
+  const year = Number(m[1]);
+  const month = Number(m[2]);
+  const day = Number(m[3]);
+  if (year < 1900 || year > 2999) return `${label}年份应在 1900-2999 之间`;
+  const date = new Date(Date.UTC(year, month - 1, day));
+  if (
+    date.getUTCFullYear() !== year ||
+    date.getUTCMonth() !== month - 1 ||
+    date.getUTCDate() !== day
+  ) {
+    return `${label}不存在，请检查年月日`;
+  }
+  return null;
+}
+
+function checkInteger(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (!/^[+-]?\d+$/.test(value)) return `${label}必须是整数`;
+  const n = Number(value);
+  if (ctx.min !== undefined && n < ctx.min) return `${label}不能小于 ${ctx.min}`;
+  if (ctx.max !== undefined && n > ctx.max) return `${label}不能大于 ${ctx.max}`;
+  return null;
+}
+
+function checkNumber(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (!/^[+-]?(\d+\.?\d*|\.\d+)$/.test(value)) return `${label}必须是数字`;
+  const n = Number(value);
+  if (!Number.isFinite(n)) return `${label}必须是有效数字`;
+  if (ctx.min !== undefined && n < ctx.min) return `${label}不能小于 ${ctx.min}`;
+  if (ctx.max !== undefined && n > ctx.max) return `${label}不能大于 ${ctx.max}`;
+  return null;
+}
+
+function checkAmount(value: string, ctx: CheckContext): string | null {
+  const label = ctx.label;
+  if (!/^(0|[1-9]\d*)(\.\d{1,2})?$/.test(value)) {
+    return `${label}需为不小于 0 的金额，最多保留 2 位小数`;
+  }
+  const n = Number(value);
+  if (ctx.min !== undefined && n < ctx.min) return `${label}不能小于 ${ctx.min}`;
+  if (ctx.max !== undefined && n > ctx.max) return `${label}不能大于 ${ctx.max}`;
+  return null;
+}
+
+/* ------------------------------ 注册表 ------------------------------ */
+
+/**
+ * 内置字段类型。新题需要更特殊的字段时：
+ *   registerFieldType('licensePlate', { label: '车牌号', normalize, check })
+ * 前端 formRules / 后端 zField / AI 表单会自动认这个新类型。
+ */
+export const FIELD_TYPES: Record<string, FieldTypeDefinition> = {
+  text: {
+    label: '内容',
+    check: () => null,
+  },
+  name: {
+    label: '姓名',
+    suggestedMaxLength: 32,
+    normalize: (v) => toHalfWidth(v).trim(),
+    check: checkName,
+  },
+  username: {
+    label: '用户名',
+    suggestedMaxLength: 32,
+    normalize: (v) => toHalfWidth(v).trim(),
+    check: checkUsername,
+  },
+  password: {
+    label: '密码',
+    suggestedMaxLength: 64,
+    // 密码不 trim：用户确实输入了空格时要明确提示，而不是偷偷删掉
+    normalize: (v) => v,
+    check: checkPassword,
+  },
+  idCard: {
+    label: '身份证号',
+    suggestedMaxLength: 18,
+    normalize: (v) => toHalfWidth(v).replace(/[\s-]/g, '').toUpperCase(),
+    check: checkIdCard,
+  },
+  phone: {
+    label: '手机号',
+    suggestedMaxLength: 20,
+    normalize: normalizePhone,
+    check: checkPhone,
+  },
+  email: {
+    label: '邮箱',
+    suggestedMaxLength: 254,
+    normalize: (v) => toHalfWidth(v).trim(),
+    check: checkEmail,
+  },
+  contact: {
+    label: '联系方式',
+    suggestedMaxLength: 254,
+    normalize: (v) => {
+      const text = toHalfWidth(v).trim();
+      return text.includes('@') ? text : normalizePhone(text);
+    },
+    check: checkContact,
+  },
+  code: {
+    label: '编码',
+    suggestedMaxLength: 32,
+    normalize: (v) => toHalfWidth(v).trim(),
+    check: checkCode,
+  },
+  bankCard: {
+    label: '银行卡号',
+    suggestedMaxLength: 23,
+    normalize: (v) => toHalfWidth(v).replace(/[\s-]/g, ''),
+    check: checkBankCard,
+  },
+  creditCode: {
+    label: '统一社会信用代码',
+    suggestedMaxLength: 18,
+    normalize: (v) => toHalfWidth(v).replace(/\s/g, '').toUpperCase(),
+    check: checkCreditCode,
+  },
+  postalCode: {
+    label: '邮政编码',
+    suggestedMaxLength: 6,
+    normalize: (v) => toHalfWidth(v).replace(/\s/g, ''),
+    check: checkPostalCode,
+  },
+  url: {
+    label: '网址',
+    suggestedMaxLength: 2048,
+    normalize: (v) => toHalfWidth(v).trim(),
+    check: checkUrl,
+  },
+  date: {
+    label: '日期',
+    suggestedMaxLength: 10,
+    normalize: normalizeDate,
+    check: checkDate,
+  },
+  integer: {
+    label: '整数',
+    normalize: normalizeNumberText,
+    check: checkInteger,
+    lengthOptions: false,
+  },
+  number: {
+    label: '数字',
+    normalize: normalizeNumberText,
+    check: checkNumber,
+    lengthOptions: false,
+  },
+  amount: {
+    label: '金额',
+    normalize: normalizeNumberText,
+    check: checkAmount,
+    lengthOptions: false,
+  },
+};
+
+/** 新题扩展入口：注册后即可被 validateField / 表单 / zod 适配器使用 */
+export function registerFieldType(name: string, definition: FieldTypeDefinition): void {
+  FIELD_TYPES[name] = definition;
+}
+
+export function fieldTypeLabel(type: string): string {
+  return FIELD_TYPES[type]?.label ?? FIELD_TYPES.text.label;
+}
+
+export function suggestedMaxLength(type: string): number | undefined {
+  return FIELD_TYPES[type]?.suggestedMaxLength;
+}
+
+export function normalizeFieldValue(type: string, value: unknown): string {
+  const def = FIELD_TYPES[type] ?? FIELD_TYPES.text;
+  const text = asText(value);
+  return (def.normalize ?? trim)(text);
+}
+
+/**
+ * 校验任意值。
+ * @param type 字段类型（内置类型见 FIELD_TYPES，也可注册自定义类型）
+ * @param raw 原始值
+ * @param options 必填、标签、长度/数值范围、额外正则等
+ */
+export function validateField(
+  type: string,
+  raw: unknown,
+  options: ValidationOptions = {}
+): ValidationResult {
+  const def = FIELD_TYPES[type] ?? FIELD_TYPES.text;
+  const label = options.label?.trim() || def.label;
+  const value = (def.normalize ?? trim)(asText(raw));
+
+  if (!value) {
+    return options.required ? { ok: false, value, message: `请输入${label}` } : { ok: true, value };
+  }
+
+  const ctx: CheckContext = { ...options, label };
+  let message = def.check(value, ctx);
+
+  if (!message && options.pattern) {
+    // 带 g/y 的正则 test() 会记住 lastIndex，复用同一个正则会时灵时不灵
+    options.pattern.lastIndex = 0;
+    if (!options.pattern.test(value)) {
+      message = options.patternMessage || `${label}格式不正确`;
+    }
+  }
+  if (!message && def.lengthOptions !== false && options.min !== undefined) {
+    if (charCount(value) < options.min) message = `${label}至少需要 ${options.min} 个字符`;
+  }
+  if (!message && def.lengthOptions !== false && options.max !== undefined) {
+    if (charCount(value) > options.max) message = `${label}不能超过 ${options.max} 个字符`;
+  }
+
+  return message ? { ok: false, value, message } : { ok: true, value };
+}
+
+/* ------------------------------ 自动识别 ------------------------------ */
+
+/** 人员类模型里的 name 字段按“姓名”校验，其他模型（部门/菜单）的 name 不误判 */
+const PERSON_MODEL_RE = /^(user|employee|staff|person|member|customer|student|teacher|contact)$/i;
+
+/**
+ * 根据字段名 + 中文标签 + 说明推断字段类型。
+ *
+ * ★ 这是「通用底座」的关键：AI 动态表单、图谱详情面板、未来新模块的字段
+ *   都不需要手写规则 —— 字段叫 phone 就按手机号校验，叫 idCard 就按身份证校验。
+ *   推断不出来返回 undefined，表示只做必填/长度这类通用校验，不乱套格式。
+ */
+export function inferValidationType(
+  name?: string,
+  label?: string,
+  hint?: string,
+  model?: string
+): ValidationType | undefined {
+  const key = (name ?? '').toLowerCase().replace(/[^a-z0-9]/g, '');
+  const text = `${label ?? ''} ${hint ?? ''}`;
+
+  // 中文标签最可靠，先判断。顺序上把「联系方式」放在「电话」之前，避免误判。
+  if (/身份证/.test(text)) return 'idCard';
+  if (/统一社会信用代码|信用代码/.test(text)) return 'creditCode';
+  if (/密码/.test(text)) return 'password';
+  if (/用户名|登录账号/.test(text)) return 'username';
+  if (/银行卡|银行账号/.test(text)) return 'bankCard';
+  if (/邮政编码|邮编/.test(text)) return 'postalCode';
+  // 组合字段要先于单独的邮箱/手机判断，否则「手机或邮箱」会被当成邮箱
+  if (/联系方式|手机或邮箱|电话或邮箱|手机号\/邮箱/.test(text)) return 'contact';
+  if (/邮箱|电子邮件/.test(text)) return 'email';
+  if (/手机|电话/.test(text)) return 'phone';
+  if (/真实姓名|姓名/.test(text)) return 'name';
+  if (/网址|主页|URL/i.test(text)) return 'url';
+  if (/工号|编号|编码/.test(text)) return 'code';
+  if (/金额|月薪|薪资|价格|费用|预算/.test(text)) return 'amount';
+  if (/年龄|数量|排序|得分|库存/.test(text)) return 'integer';
+  if (/日期/.test(text)) return 'date';
+
+  if (
+    /^(idcard|idcardno|idcardnumber|identitycard|identityno|idnumber|idno|certno|certificateno|sfzh|shenfenzheng)$/.test(
+      key
+    )
+  ) {
+    return 'idCard';
+  }
+  if (/(password|passwd|pwd)$/.test(key)) return 'password';
+  if (/^(username|loginname|loginaccount|useraccount)$/.test(key)) return 'username';
+  if (/creditcode|unifiedcode|socialcreditcode/.test(key)) return 'creditCode';
+  if (/^(bankcard|bankcardno|bankno|bankaccount|cardnumber)$/.test(key)) return 'bankCard';
+  if (/^(postalcode|zipcode|zip)$/.test(key)) return 'postalCode';
+  if (/^(email|emailaddress|mail|mailbox)$/.test(key)) return 'email';
+  if (/^(contact|contactinfo|contactway|contactdetail)$/.test(key)) return 'contact';
+  if (/phone|mobile|cellphone|telephone/.test(key) || key === 'tel') return 'phone';
+  if (/^(realname|fullname|personname|contactname|linkmanname)$/.test(key)) return 'name';
+  // 权限标识常见 system:user:add 这种带冒号的写法，不能套用工号/编码的字符集
+  if (/permcode|permissioncode/.test(key)) return undefined;
+  if (
+    /^(jobno|employeeno|empno|staffno|serialno)$/.test(key) ||
+    /(code|jobno|empno|staffno)$/.test(key)
+  ) {
+    return 'code';
+  }
+  // 只认明确的网址字段；link/photoUrl 这类可能存的是站内相对路径，不能强行要求 http(s)
+  if (/^(url|website|homepage|websiteurl|homepageurl)$/.test(key)) return 'url';
+  if (
+    /^(date|birthday|birthdate|hiredate|startdate|enddate|expiredate|duedate|applydate|createdate)$/.test(
+      key
+    )
+  ) {
+    return 'date';
+  }
+  if (/(amount|price|salary|money|cost|fee|budget|expense)$/.test(key)) return 'amount';
+  if (/^(age|quantity|qty|count|sort|score|stock|total|num)$/.test(key)) return 'integer';
+  if (key === 'name' && model && PERSON_MODEL_RE.test(model)) return 'name';
+
+  return undefined;
+}