班固米-条目职位自定义排序与折叠

对所有类型条目的制作人员信息进行职位的自定义排序与折叠,可在[设置-隐私]页面进行相关设置

目前為 2024-12-20 提交的版本,檢視 最新版本

// ==UserScript==
// @name         班固米-条目职位自定义排序与折叠
// @namespace    https://github.com/weiduhuo/scripts
// @version      1.4.2-1.4
// @description  对所有类型条目的制作人员信息进行职位的自定义排序与折叠,可在[设置-隐私]页面进行相关设置
// @author       weiduhuo
// @match        *://bgm.tv/subject/*
// @match        *://bgm.tv/character/*
// @match        *://bgm.tv/person/*
// @match        *://bgm.tv/settings/privacy*
// @match        *://bangumi.tv/subject/*
// @match        *://bangumi.tv/character/*
// @match        *://bangumi.tv/person/*
// @match        *://bangumi.tv/settings/privacy*
// @match        *://chii.in/subject/*
// @match        *://chii.in/character/*
// @match        *://chii.in/person/*
// @match        *://chii.in/settings/privacy*
// @grant        none
// @license      MIT
// ==/UserScript==

(function () {
  'use strict';
  const SCRIPT_NAME = '班固米-职位排序组件';
  const CURRENT_DATA_VERSION = '1.4';
  // 禁止console除log以外的操作
  console.debug = function () {};
  console.time = function () {};
  console.timeEnd = function () {};

  /** 排序延迟时间 */
  const SORTING_DELAY = 0;
  /** 防抖延迟时间 */
  const DEBOUNCE_DELAY = 500;
  /** 是否对职位信息进行了折叠,忽略网页自身`sub_group`的折叠 (依此判断 `更多制作人员` 开关的必要性) */
  let hasFolded = false;
  /** 尾部折叠图标的激活阈值相对于视口高度的系数 */
  const sideTipRate = 0.25;
  /** @type {number} 尾部折叠图标的激活行数阈值 */
  let sideTipLineThr = null;
  /** @type {Array<HTMLElement> | null} 最后一组`sub_group`的数据包 */
  let lastGroup = null;

  /**
   * 图标,已在`loadStaffStyle`中通过父元素类名`staff_sorting_icon`约束所显示的范围
   */
  const ICON = {
    // 三角形顶点向右,可表展开按键
    TRIANGLE_RIGHT: `
      <svg xmlns='http://www.w3.org/2000/svg' viewbox='0 0 13 13' height=' 0.7em'>
        <polygon points='0.5,0 12.5,6.5 0.5,13'  fill='currentColor' />
      </svg>
    `,
    // 三角形顶点向下,可表折叠按键
    TRIANGLE_DOWN: `
      <svg xmlns='http://www.w3.org/2000/svg' viewbox='0 0 13 13' height=' 0.7em'>
        <polygon points='0,0.5 13,0.5 6.5,12.5'  fill='currentColor' />
      </svg>
    `,
    // 三角形顶点向上,可表折叠按键
    TRIANGLE_UP: `
      <svg xmlns='http://www.w3.org/2000/svg' viewbox='0 0 13 13' height=' 0.7em'>
        <polygon points='0,12.5 13,12.5 6.5,0.5'  fill='currentColor' />
      </svg>
    `,
  };

  /**
   * 枚举所支持的条目类型
   */
  const SubjectType = {
    // 所支持的类型
    ANIME: {en: 'anime', zh: '动画'},
    BOOK: {en: 'book', zh: '书籍'},
    MUSIC: {en: 'music', zh: '音乐'},
    GAME: {en: 'game', zh: '游戏'},
    REAL: {en: 'real', zh: '三次元'},
    CHARACTER: {en: 'character', zh: '角色'},
    PERSON: {en: 'person', zh: '人物'},
    /**
     * @param {boolean} [isObj=false] - `true`时返回对象序列,`false`时返回英文序列
     * @returns {{ en: string, zh: string }[] | string[]}
     */
    getAll(isObj = false) {
      if (isObj) return utils.filterEnumValues(this);
      else return utils.filterEnumValues(this).map(item => item.en);
    },
    /** @returns {string | null} 有效则返回原数值,无效则返回空 */
    parse(value) {
      if (this.getAll().includes(value)) return value;
      return null;
    },
    needPrase(value) {
      return value !== this.CHARACTER.en && value !== this.PERSON.en;
    },
  };

  /**
   * 枚举各类型条目的排序折叠功能启用状态
   */
  const SortEnableState = {
    /** 启用全部功能 */
    ALL_ENABLED: "allEnable",
    /** 启用部分功能,仅排序不折叠 */
    PARTIAL_ENABLED: "partialEnable",
    /** 全部功能禁用 */
    ALL_DISABLED: "allDisable",
    /**  @returns {Array<string>} */
    getAll() {
      return utils.filterEnumValues(this);
    },
    parse(value) {
      if (this.getAll().includes(value)) return value;
      return null;
    },
  };

  /**
   * 管理`localStorage`的键名与初值。
   * 键值分为全局配置与各类型条目配置、简单类型与复杂类型
   */
  const Key = {
    /** 键名前缀 */
    KEY_PREF: 'BangumiStaffSorting',
    /** 数据版本 */
    DATA_VERSION: '_dataVersion__',

    /** 超过此行数的职位信息将被二次折叠*/
    REFOLD_THRESHOLD_KEY: '_refoldThreshold__',
    REFOLD_THRESHOLD_OLD_KEY: 'refoldThreshold',
    REFOLD_THRESHOLD_DEFAULT: 4,
    REFOLD_THRESHOLD_DISABLED: 0,

    /** 是否继承历史的匹配记录 */
    INHERIT_PREVIOUS_MATCHES_KEY: '_inheritPreMatches__',
    INHERIT_PREVIOUS_MATCHES_DEFAULT: true,

    /** 各类型条目模块的展开状态 */
    BLOCK_OPEN_KEY: 'BlockOpen',
    BLOCK_OPEN_OLD_KEY: 'blockOpen', // dataVerion < 1.4
    BLOCK_OPEN_DEFAULT: false,

    /** 各类型条目的功能启用状态 */
    ENABLE_STATE_KEY: 'EnableState',
    ENABLE_STATE_DEFAULT: SortEnableState.ALL_ENABLED,

    /** 各类型条目的自定义排序与折叠 (复杂类型,参见 {@link StaffMapListType}) */
    STAFF_MAP_LIST_KEY: 'StaffMapList',
    /** 职位排序索引的分组映射 (复杂类型,参见 {@link jobOrderMapType}) */
    JOB_ORDER_MAP_KEY: 'JobOrderMap',
    
    /** 当前使用的键值的所属条目类型 (可即时切换) */
    _subType: null,

    makeKey(key, type = null) {
      this.setSubType(type);
      if (this.isGlobalData(key)) return `${this.KEY_PREF}_${key}`;
      else return `${this.KEY_PREF}_${this._subType}${key}`;
    },
    setSubType(type) {
      if (type) this._subType = type;
    },
    isComplexData(key) {
      return [
        this.STAFF_MAP_LIST_KEY, this.JOB_ORDER_MAP_KEY,
      ].includes(key);
    },
    isGlobalData(key) {
      return [
        this.DATA_VERSION, this.INHERIT_PREVIOUS_MATCHES_KEY,
        this.REFOLD_THRESHOLD_KEY,  this.REFOLD_THRESHOLD_OLD_KEY
      ].includes(key);
    }
  }

  /**
   * 配置存储,提供`localStorage`的接口。
   * 仅对简单数据类型进行解析、编码、缓存,复杂数据类型放权给外部
   * (为便于进行防抖动绑定,由对象类型改为静态类实现)
   */
  class Store {
    /** 数据缓存,仅对简单类型的键值 */
    static _cache = {};
    /** 需要对数据进行更新 */
    static updateRequired = false;
    /** 定义防抖逻辑的占位 (忽略短时间内改变多对键值的极端情况) */
    static debouncedSet;

    /** 为缺损的配置进行初始化 */
    static initialize() {
      // 缓存初始化
      Store._cache = {};
      // 绑定防抖逻辑,确保 this 指向 Store
      Store.debouncedSet = debounce(Store._set.bind(this));
      // 全局配置初始化
      ['REFOLD_THRESHOLD', 'INHERIT_PREVIOUS_MATCHES'].forEach(
        (key) => Store._setDefault(key)
      );
      // 局部配置初始化
      SubjectType.getAll().forEach((type) => {
        ['BLOCK_OPEN', 'ENABLE_STATE'].forEach(
          (key) => Store._setDefault(key, type)
        );
      });
      // 检查数据版本
      if (Store.get(Key.DATA_VERSION) !== CURRENT_DATA_VERSION) {
        Store.updateRequired = true;
        Store.preProcessConfigUpdate();
      }
    }

    /** 版本变更,重要配置更新,主任务前执行 */
    static preProcessConfigUpdate() {
      // 键名变更,重要数据进行继承
      if (Store.get(Key.DATA_VERSION) < '1.4') { // 已涵盖 null
        // 变更了全局配置的键名格式
        const preRefoldThreshold = Store.get(Key.REFOLD_THRESHOLD_OLD_KEY);
        if (preRefoldThreshold !== null) {
          Store.set(Key.REFOLD_THRESHOLD_KEY, preRefoldThreshold);
        }
      }
    }

    /** 版本变更,次要配置更新,主任务后执行 */
    static postProcessConfigUpdate() {
      if (!Store.updateRequired) return;
      console.log(`${SCRIPT_NAME}:数据版本 ${Store.get(Key.DATA_VERSION)} > ${CURRENT_DATA_VERSION} 更新中...`);
      // [固定]对默认设置的解析缓存进行更新
      SubjectType.getAll().forEach((type) => {
        const jsonStr = Store.get(Key.STAFF_MAP_LIST_KEY, type);
        if (jsonStr) return; // 跳过自定义设置
        const staffMapList = new StaffMapList(type);
        staffMapList.initialize(null, true);
        if (Store.get(Key.INHERIT_PREVIOUS_MATCHES_KEY)) staffMapList.inheritPreMatches();
        staffMapList.saveResolvedData();
      });
      // [暂时]删除旧有的键值对,低价值数据直接丢弃
      if (Store.get(Key.DATA_VERSION) < '1.4') {
        // 已完成继承
        Store.remove(Key.REFOLD_THRESHOLD_OLD_KEY);
        // 模块的展开状态键名变更
        SubjectType.getAll().forEach((type) => {
          Store.remove(Key.BLOCK_OPEN_OLD_KEY, type);
        });
        // 旧有的异步通信接口
        Store.removeByPrefix(`${Key.KEY_PREF}Interface`);
      }
      // 更新全部完毕后再修改版本号,防止被提前终止
      Store.set(Key.DATA_VERSION, CURRENT_DATA_VERSION);
      console.log(`${SCRIPT_NAME}:数据更新成功`);
    }

    static removeByPrefix(pref) {
      // 将键名缓存到数组中,避免遍历过程中修改 localStorage 导致索引混乱
      const keysToRemove = [];
      for (let i = 0; i < localStorage.length; i++) {
        const key = localStorage.key(i);
        if (key && key.startsWith(pref)) keysToRemove.push(key);
      }
      // 遍历并删除匹配的键
      keysToRemove.forEach((key) => localStorage.removeItem(key));
    }

    static _setDefault(_key, type = null) {
      if (this.get(Key[`${_key}_KEY`], type) === null)
        this.set(Key[`${_key}_KEY`], Key[`${_key}_DEFAULT`]);
    }

    static set(key, value, type = null, isHighFreq = false) {
      if (isHighFreq) this.debouncedSet(key, value, type);
      else this._set(key, value, type);
    }

    static _set(key, value, type = null) {
      Key.setSubType(type);
      const fullKey = Key.makeKey(key);
      if (!Key.isComplexData(key)) {
        this._cache[fullKey] = value; // 同步到缓存 (注意缓存的需是原始数据)
        value = JSON.stringify(value);
      }
      localStorage.setItem(fullKey, value);
    }

    static get(key, type = null) {
      Key.setSubType(type);
      const fullKey = Key.makeKey(key);
      // 简单数据类型,命中缓存
      if (!Key.isComplexData() && Store._isCacheHit(fullKey)) {
        // console.debug(`HIT CHACHE - ${fullKey}: ${this._cache[fullKey]}`);
        return this._cache[fullKey];
      }
      // 无缓存,读取并缓存
      const value = localStorage.getItem(fullKey);
      if (Key.isComplexData(key)) return value;
      const parsedValue = JSON.parse(value);
      this._cache[fullKey] = parsedValue;
      return parsedValue;
    }

    static remove(key, type = null) {
      Key.setSubType(type);
      const fullKey = Key.makeKey(key);
      // 同时删除缓存与数据
      delete this._cache[fullKey];
      localStorage.removeItem(fullKey);
    }

    static _isCacheHit(fullKey) {
      return Object.prototype.hasOwnProperty.call(this._cache, fullKey);
    }
  }

  /**
   * 包含`RegExp`元素的`JSON`格式化字符串。
   * 1. 用于`StaffMapList`解析、编码,其最短的有效字符串为`"[]"`,示设置空缺。
   * 2. 用于`JobOrderMap`编码,由于其只在规定区域内还有`RegExp`元素,
   *    全局使用`reviver`解析性能较低,故单独处理
   */
  const RegexInJSON = {
    regexPattern: /^\/(.+)\/([gimsuy]*)$/,
    /**
     * 解析`StaffMapList`字符串。
     * 用于初步解析与有效性检测,
     * 更进一步的解析,将在`StaffMapList`中进行。
     * 仅检查:
     *   1. 是否满足`JSON`格式
     *   2. 是否为数组类型
     *   3. 字符串样式的正则表达式,是否满足规定格式
     * @returns {Array | null} 空值表失败
     */
    parse(text) {
      let parsedData;
      try {
        parsedData = JSON.parse(text, this._reviver);
      } catch (e) {
        console.error(`${SCRIPT_NAME}:StaffMapList 解析失败 - ${e}`);
        return null;
      }
      if (!utils.isArray(parsedData)) {
        console.error(`${SCRIPT_NAME}:StaffMapList 类型错误 - 非数组类型`);
        return null;
      }
      return parsedData;
    },

    /**
     * 将`RegexInList`转为`JSON`格式化字符串
     * @param {string | number | undefined} space
     */
    stringify(data, space) {
      return JSON.stringify(data, this._replacer, space);
    },

    /** 解析`JSON`字符串中的正则表达式 */
    _reviver(key, value) {
      if (utils.isString(value) && value.startsWith('/')) {
        const match = value.match(RegexInJSON.regexPattern);
        if (!match) {
          throw new Error(`正则表达式 "${value}" 不符合 ${RegexInJSON.regexPattern} 格式`);
        } try {
          return new RegExp(match[1], match[2]);
        } catch (e) {
          throw new Error(`正则表达式 "${value}" 非法 - ${e}`);
        }
      }
      return value;
    },

    /** 将正则表达式转化为字符串,以满足`JSON`格式 */
    _replacer(key, value) {
      if (utils.isRegExp(value)) return value.toString();
      return value;
    },
  }

  /**
   * 职位排序与折叠设置,是职位排序与默认折叠的职位二者信息的复合 (此为原罪)。
   * 其有两种表现形式:
   * 1. `StaffMapList`,即`this.data`,面向用户,结构简明直接,供用户自定义编辑。
   * 2. `JobOrderMap`,面向程序,来自对`StaffMapList`的解析与历史匹配记录。
   *    由`this.{exactOrderMap, regexOrderList, insertUnmatched, insertSubGroup}`组成
   */
  class StaffMapList {
    /**
     * @typedef {string | RegExp} MatchJob - 匹配职位名称
     * @typedef {Array<MatchJob | [boolean | MatchJob, ...MatchJob[]]>} StaffMapListType
     * - 其中`boolean`表示子序列内的职位是否默认折叠,缺损值为`false`,需位于子序列的首位才有意义
     *   (默认配置中`,,`表示在`JSON`数组中插入`null`元素,用于输出格式化文本时标记换行)
     * 
     * @typedef {Object} jobOrderMapType
     * - 是一张分组映射表,用于映射匹配职位的序列号,初值为`StaffMapList`的解析数据。
     *   其中序列号`number`的大小表示该匹配职位的次序,奇偶表示该匹配职位是否默认折叠。
     *   (由原先的`Map<MatchJob, number>`整表改进而为分组表,极大减少了解析与维护开销)
     * @property {Object<string, number>} exact - 精确匹配,
     *   以及用于缓存正则匹配、插入未被匹配的历史记录,并于任务结束后写入`Store`
     * @property {Array<[RegExp, number]>} regex - 正则匹配,
     *   基于需遍历使用、对象类型的键不得为字符串以外的类型,采用键值对数组
     * @property {Object<string, number>} insert - 插入匹配,
     *   目前有插入未被匹配的职位信息、插入二级职位引导信息 (后者的优先级更高,且高于其他匹配)
     */
    
    /** 未被匹配职位信息的插入前缀`'=='` */
    static _insertUnmatchedPref = '==';
    /** 二级职位引导信息的插入前缀`'>>'` */
    static _insertSubGroupPref = '>>';
    /** 懒加载的默认配置 */
    static _defaultLazyData = {
      [SubjectType.ANIME.en]: () => [,
        "中文名", "类型", "适合年龄", /地区/, "语言", "对白", /话数/, [true, "季数"],,
         "放送开始", /开始/, "放送星期", "放送时间", /上映/, "发售日", /片长/,,
        ,
        "原作", "原案", "人物原案", "人物设定", "原作插图", [true, "原作协力"],,
        "团长", "总导演", "导演", "副导演", "执行导演", "主任导演", "联合导演",,
        "系列监督", "系列构成", "脚本", "编剧", [true, /脚本|内容|故事|文艺|主笔/],,
        "分镜", "OP・ED 分镜", "主演出", "演出", [true, "演出助理"],,
        ,
        "总作画监督", [false, "作画监督"], [true, "作画监督助理"], /.*作画.*(监|导)/,,
        /主.?动画师/, [true, "构图"], [false, "原画"], [true, "第二原画", "补间动画"],,
        "数码绘图", /(原|动|動)画(?!检查)/, [true, /动画检查/],,
        ,
        "设定", "背景设定", "道具设计", /(?<!色彩|美(术|術))(设|設)(?!.*制)/, /Design|デザイン/i,,
        "色彩设计", [false, /色.?指定/], [true, "上色", /(?<!角)色/],,
        /美(术|術).*(监督|导演)/, [false, "美术设计"], "概念美术", "视觉概念", "概念艺术",,
        [false, "背景美术"], [true, /景/], /美(术|術)|艺术|工艺|创意|绘制|ART WORK|Motion Graphic|モーショングラフィック/i,,
        ,
        /CG.*导演/, [false, /(2|3)D|CG|コンピュータ/], "模型监督", "绑骨监督", [/建模|模型|动作|表情|骨/],,
        "摄影监督", "副摄影监督", "后期监督", [true, /摄影|合成|照明|拍|(特|动)效|特技|技术|Effect|モニター/i],,
        "現像", /标题|字幕|タイトル/,,
        [false, "剪辑", "编集"], [true, /(?<!音.*)剪辑/], [true, "场记"],,
        /(监|監)修/, /顾问/,,
        ,
        "音响监督", [true, /音响/, "音效", "拟音"], "录音", [true, "录音助理", "混声", /录音|声/],,
        "配音", "主演", "キャスティング", [true, /配音|((?<!歌)演出)/],,
        "音乐", "音乐制作", [true, "音乐制作人", "音乐助理"], [true, /音|乐/],,
        "主题歌演出", [true, "主题歌作词", "主题歌作曲", "主题歌编曲"],,
        "插入歌演出", [true, "插入歌作词", "插入歌作曲", "插入歌编曲"],,
        [true, "选曲"], [true, /曲|歌/],,
        ,
        "企画", [true, "企画协力"], "企划制作人", /企(画|划)|出品|策划/, /监制/,,
        "执行制片人", /总制片/, "制片人", "制片", [true, /制片/],,
        [true, /编辑/], [true, /行政|审/], [true, /法务/], [true, "宣传", /宣(传|伝)|広報/], /市场|运营|衍生/,,
        "动画制片人", [true, "制作管理", "制作主任", /制作统.?/, /制作助.?/, "计划管理"],,
        [true, "制作进行", "制作进行协力", "制作协调"],,
        [true, "设定制作"], [true, /取材/], [true, /鸣谢|Thanks/i],,
        ,
        /^(制|製)作$/, [true, "制作著作"], "制作协力", /(协|協)力/,,
        "动画制作", [true, /(制|製)作/],,
        "别名", /.+名$/,,
        "发行", "官方网站", "在线播放平台", "链接", "播放电视台", "其他电视台",,
        /配(?!音)|連載|番組|版|播放/, "播放结束", /结束/,,
        ,
        "其他", /其他/,,
        [false, "===此处插入未被匹配的职位==="],,
        "Copyright",
      ],
      [SubjectType.BOOK.en]: () => [,
        "中文名", /名/,,
        [false, "===此处插入未被匹配的职位==="],,
        ">>>此处插入二级职位引导>>>",,
        "ISBN",
      ],
      [SubjectType.MUSIC.en]: () => [,
        "制作人",,
        "艺术家", "作词", "作曲", "编曲",,
        "脚本", "声乐", "乐器", "混音", "母带制作",,
        "插图", "原作", "出版方", "厂牌",
      ],
    };

    /** @type {StaffMapListType} 主数据 */
    data = [];
    /** @type {Object<string, number>} 精确匹配的映射表,同时用于缓存匹配记录 */
    exactOrderMap = {};
    /** @type {Array<[RegExp, number]>} 正则匹配的映射序列 */
    regexOrderList = [];
    /** 是否为默认数据 */
    isDefault = null;
    /** 重新解析数据 */
    newResolvedData = false;
    /** 新记录的匹配计数器 */
    newlyMatchedCount = 0;
    /** 是否开启折叠功能 */
    foldable = false;
    /** 是否执行了折叠功能 */
    hasFolded = false;
    /** 未被匹配职位信息的插入位置 */
    insertUnmatched = Infinity;
    /** 二级职位引导信息的插入位置 (一旦启用,即为最高优先级) */
    insertSubGroup = null;
    /** 默认配置格式化文本的缓存 */
    _defaultTextBuffer = null;

    constructor(subType) {
      /** 所属条目类型(不可变更)*/
      this.subType = subType; // 小心 Key._subType 被其他模块切换
      /** 序列号计数器 */
      this.index = 0;
      /** 排序功能启用状态 */
      this.sortEnableState = Store.get(Key.ENABLE_STATE_KEY, this.subType);
    }

    /**
     * 依据`EnableState`进行初始化,使其具备职位匹配的能力。
     * 若仅为获取`StaffMapList`格式化字符串,则不需要执行本初始化。
     * @param {any[] | null | undefined} [parsedData = null] 
     * - 由设置界面传入的被初步解析的数据
     * @param {boolean} [forcedEnable = false]
     * - 是否开启强制模式 (默认关闭),强制模式下关闭`EnableState`检查并禁用折叠
     */
    initialize(parsedData = undefined, forcedEnable = false) {
      // 非强制模式下,禁止了排序功能
      if (!forcedEnable && this.sortEnableState === SortEnableState.ALL_DISABLED) return;
      // 是否开启折叠功能
      this.foldable = !forcedEnable && this.sortEnableState === SortEnableState.ALL_ENABLED;
      this._init();
      // 尝试优先获取存储的解析数据
      if (parsedData === undefined) {
        if (this._loadResolvedData()) return;
        else this._init(); // 需再次初始化
      }
      // 在设置界面保存设置时进行强制重新解析,或者在条目界面进行初始化解析
      if (!this._loadData(parsedData)) {
        this._setDefault();
        this.isDefault = true;
      }
      // 解析数据
      this._resolveData();
      this.data = null; // 释放原始数据的存储空间
      this.newResolvedData = true;
      // 替换 Infinity (替换为当前的尾值,来免除对 Infinity 在 JSON 序列化时需单独处理)
      if (!utils.isFinity(this.insertUnmatched)) {
        // 替换默认值
        this.insertUnmatched = this.index << 1;
        // 若启用了插入二级引导,且设定为尾值,则替换。以保证二级引导插入末尾的优先级
        if (utils.isNumber(this.insertSubGroup) && this.insertUnmatched - this.insertSubGroup === 2) {
          [this.insertSubGroup, this.insertUnmatched] = [this.insertUnmatched, this.insertSubGroup];
        }
      }
    }

    /** 数据参数初始化 */
    _init() {
      this.index = 0;
      this.exactOrderMap = {};
      this.regexOrderList = [];
      this.insertUnmatched = Infinity;
      this.insertSubGroup = null;
      this._defaultTextBuffer = null;
    }

    /**
     * 表示未经`initialize`,或是空缺设置,将关闭脚本的职位排序。
     * 空缺设置有两种独立开启途径:
     *   1. `EnableState = "allDisable"`
     *   2. `StaffMapListJSON = "[]"`
     */
    isNull() { return this.index === 0; }

    /**
     * 判断职位是否默认折叠
     * @param {string} job
     */
    isFoldedJob(job) {
      if (!this.foldable) return false;
      const index = this.exactOrderMap[job];
      const result = (index & 1) === 1; // 奇数代表默认折叠
      if (!this.hasFolded && result) this.hasFolded = true;
      return result;
    }

    /** 保存自定义的数据 */
    saveData(jsonStr, parsedData) {
      this.isDefault = false;
      Store.set(Key.STAFF_MAP_LIST_KEY, jsonStr, this.subType);
      console.log(jsonStr);
      console.log(`${SCRIPT_NAME}:保存自定义 ${this.subType}StaffMapList 数据`);
      this.initialize(parsedData, true);
      if (Store.get(Key.INHERIT_PREVIOUS_MATCHES_KEY)) this.inheritPreMatches();
      this.saveResolvedData();
    }

    /** 恢复默认数据的设置 */
    resetData() {
      this.isDefault = true;
      Store.remove(Key.STAFF_MAP_LIST_KEY, this.subType);
      console.log(`${SCRIPT_NAME}:恢复默认 ${this.subType}StaffMapList 数据`);
      this.initialize(null, true); // 传入null表强制重新解析
      if (Store.get(Key.INHERIT_PREVIOUS_MATCHES_KEY)) this.inheritPreMatches();
      this.saveResolvedData();
    }

    /** 继承历史的匹配记录 */
    inheritPreMatches() {
      this.newResolvedData = true; // 为计数器初始化提供保险
      this.newlyMatchedCount = 0;
      // 获取历史的匹配记录
      const jsonStr = Store.get(Key.JOB_ORDER_MAP_KEY, this.subType);
      if (!jsonStr) return;
      let preMatches;
      try {
        /** @type {jobOrderMapType} */
        const parsedMap = JSON.parse(jsonStr);
        preMatches = parsedMap.exact;
      } catch { return; }
      // 不进行排序,仅遍历匹配
      const sorter = new BaseStaffSorter(this, preMatches);
      sorter.scan();
      if (this.newlyMatchedCount) {
        console.log(`${SCRIPT_NAME}:从历史匹配记录中继承 ${this.newlyMatchedCount} 项匹配`);
      }
    }

    /**
     * 组合并保存解析数据`jobOrderMap`。
     * 非条目界面,后续版本可以利用 matchLog 提前对已缓存的正则匹配项进行预匹配
     */
    saveResolvedData() {
      // 空缺设置
      if (this.isNull()) {
        if (this.sortEnableState !== SortEnableState.ALL_DISABLED) {
          Store.remove(Key.JOB_ORDER_MAP_KEY, this.subType);
        } return;
      }
      // 解析数据未更新
      if (!this.newlyMatchedCount && !this.newResolvedData) return;
      // 组合解析数据
      const jobOrderMap = {
        'exact': this.exactOrderMap,
        'regex': this.regexOrderList,
        'insert': { [StaffMapList._insertUnmatchedPref]: this.insertUnmatched }
      };
      if (utils.isNumber(this.insertSubGroup)) {
        jobOrderMap.insert[StaffMapList._insertSubGroupPref] = this.insertSubGroup;
      }
      // JSON 序列化后进行存储
      const jsonStr = RegexInJSON.stringify(jobOrderMap);
      Store.set(Key.JOB_ORDER_MAP_KEY, jsonStr, this.subType);
      console.log(`${SCRIPT_NAME}:保存 ${this.subType}JobOrderMap 解析缓存`);
    }

    /** 恢复默认配置 */
    _setDefault() {
      // 该类型条目未有默认设置
      if (!StaffMapList._defaultLazyData[this.subType]) this.data = [];
      // 懒加载默认设置
      else this.data = StaffMapList._defaultLazyData[this.subType]();
    }

    /**
     * 尝试载入自定义的数据,并作初步解析
     * @param {any[] | null} [parsedData = null] 
     */
    _loadData(parsedData = null) {
      const jsonStr = Store.get(Key.STAFF_MAP_LIST_KEY, this.subType);
      if (!jsonStr) return null; // 键值为空,表示用户启用默认设置
      if (!parsedData) parsedData = RegexInJSON.parse(jsonStr);
      if (!parsedData) {
        // 通过UI进行的配置一般不可能发生
        console.error(
          `${SCRIPT_NAME}:自定义 ${this.subType}StaffMapList 解析失败,将使用脚本默认的数据`
        );
        return false;
      }
      /* 修复外层重复嵌套 `[]` 的形式,例如 [["", [true, ""], ""]]
       * 同时区分形如 [[true, "", ""]] 此类不需要降维的情形,
       * 忽略存在的漏洞:形如 [[true, "", [true, ""], ""]] 将无法降维 */
      if (
        parsedData.length === 1 &&
        utils.isArray(parsedData[0]) &&
        !utils.isBoolean(parsedData[0][0])
      ) {
        parsedData = parsedData[0];
      }
      this.isDefault = false;
      this.data = parsedData;
      return true;
    }

    /** 完全解析数据,拆解为`jobOrderMap` */
    _resolveData() {
      for (let item of this.data) {
        let isFolded = false;
        if (utils.isArray(item)) {
          if (!item.length) continue;
          // 对数组进行完全展平,提高对非标多维数组的兼容性
          item = item.flat(Infinity);
          /* 对于标准格式,仅当 Boolean 为一级子序列的首元素时,对该子序列的全部元素生效
           * 此时更广义的表述为,仅当 Boolean 为一级子序列的最左节点时,对该子序列的全部元素生效 */
          if (utils.isBoolean(item[0])) {
            // 始终解析折叠信息,是否最终执行通过 foldable 进行限制
            if (item[0]) isFolded = true;
            item.shift(); // 移除第一个元素,替代 slice(1)
          }
          this._processMatchers(isFolded, ...item);
        } else {
          this._processMatchers(isFolded, item);
        }
      }
      if(!this.isNull()) console.debug(`经过解析初始化 ${this.subType}StaffMapList`);
    }

    /** 尝试载入存储的解析数据`jobOrderMap` */
    _loadResolvedData() {
      const jsonStr = Store.get(Key.JOB_ORDER_MAP_KEY, this.subType);
      if (!jsonStr) return null; // 键值为空,表示存储数据为空
      try {
        /** @type {jobOrderMapType} */
        const parsedMap = JSON.parse(jsonStr);
        this.exactOrderMap = parsedMap.exact;
        this.regexOrderList = parsedMap.regex;
        for (const item of this.regexOrderList) {
          const match = item[0].match(RegexInJSON.regexPattern);
          item[0] = RegExp(match[1], match[2]); // 活化正则表达式
        }
        this.insertUnmatched = parsedMap.insert[StaffMapList._insertUnmatchedPref];
        this.insertSubGroup = parsedMap.insert[StaffMapList._insertSubGroupPref];
        if (!utils.isNumber(this.insertUnmatched)) {
          throw new Error(`插入匹配的序列号 ${this.insertUnmatched} 无效`); // 必需的数据
        }
      } catch (e) {
        console.error(
          `${SCRIPT_NAME}:${this.type}JobOrderMap 缓存数据损坏,将对 staffMapList 重新进行解析 - ${e}`
        );
        return false;
      }
      this.regexOrderList ??= []; // 允许缺损
      this.index = Infinity; // 无实义,仅表完成初始化,作用于 isNull
      console.debug(`经过读取缓存初始化 ${this.subType}StaffMapList`);
      return true;
    }

    /**
     * 处理一组匹配,用于`_resolveData`,
     * 使得`jobOrderMap.number`同时表示序列号与折叠状态
     * @param {boolean} isFolded
     * @param {...MatchJob} matchers 
     */
    _processMatchers(isFolded, ...matchers) {
      for (const matcher of matchers) {
        const matcherType = StaffMapList.getMatcherType(matcher);
        if (matcherType === 0 || matcher === "") continue;
        // 生成序列号
        let _index = this.index++ << 1;
        if (isFolded) _index++; // 默认折叠则为奇数,相否则为偶数
        // 构建正则表达式引用列表
        if (matcherType === 2) {
          this.regexOrderList.push([matcher, _index]);
          continue;
        }
        // 仅剩余 matcherType === 1
        const prefixType = StaffMapList.getPrefixType(matcher);
        switch (prefixType) {
          // 精确匹配,构建哈希表
          case 0:
            this.exactOrderMap[matcher] = _index;
            break;
          // 插入匹配,未被匹配职位信息
          case 1:
            this.insertUnmatched = _index;
            console.debug(`insertUnmatched: "${matcher}", index: ${_index}}`);
            break;
          // 插入匹配,二级职位引导信息
          case 2:
            _index = _index & ~1; // 消除折叠性
            this.insertSubGroup = _index;
            console.debug(`insertSubGroup: "${matcher}", index: ${_index}}`);
            break;
        }
      }
    }

    /**
     * 将数据转化为格式化文本 (有别于`StaffMapListJSON`)
     * 用于设置内的显示与编辑,自定义数据与默认数据二者格式化有别
     * @returns {string} 格式化文本
     */
    formatToText(useDefault) {
      let jsonStr = null;
      if (!useDefault) {
        jsonStr = Store.get(Key.STAFF_MAP_LIST_KEY, this.subType);
        this.isDefault = jsonStr === null; // useDefault 不能改变 isDefault
      }
      // 自定义数据
      if (jsonStr) return jsonStr.slice(1, -1); // 消除首尾的 `[]`
      // 读取缓存的默认数据
      else if (this._defaultTextBuffer) return this._defaultTextBuffer;
      // 将默认数据转化为格式化文本
      this._setDefault();
      const text = RegexInJSON.stringify(this.data, 1)
        .replace(/(null,\n )|(\n\s+)/g, (match, g1, g2) => {
          if (g1) return "\n";
          if (g2) return " ";
          return match;
        })
        .slice(3, -2); // 消除首部 `[ \n` 与尾部 `\n]`
      // 使得 `[ `->`[` 同时 ` ]`->`]`
      /* const text = RegexInJSON.stringify(this.data, 1).replace(
        /(null,)|(?<!\[)(\n\s+)(?!])|(\[\s+)|(\s+],)/g,
        (match, g1, g2, g3, g4) => {
          if (g1) return '\n';
          if (g2) return ' ';
          if (g3) return '[';
          if (g4) return '],';
          return match;
        }).slice(3, -2); */
      this._defaultTextBuffer = text;
      this.data = null; // 释放原始数据的存储空间
      return text;
    }

    /**
     * 获取该插入匹配的前缀类型
     * @param {string} matcher
     * @returns {0 | 1 | 2} 0-无,1-插入未被匹配,2-插入二级引导
     */
    static getPrefixType(matcher) {
      if (matcher.startsWith(StaffMapList._insertUnmatchedPref))
        return 1;
      if (matcher.startsWith(StaffMapList._insertSubGroupPref))
        return 2;
      return 0;
    }

    /**
     * 获取该匹配的类型
     * @param {MatchJob | any} matcher
     * @returns {0 | 1 | 2} 0-无效类型,1-字符串,2-正则式
     */
    static getMatcherType(matcher) {
      return utils.isString(matcher) ? 1 : utils.isRegExp(matcher) ? 2 : 0;
    }
  }

  /**
   * 基类,职位排序的核心逻辑。
   * 可被拓展用于不同的场景:网页`infobox`职位信息、职位名称序列、API`infobox`职位信息。
   * 
   * 经算法重构,并修改`StaffMapList`的解析数据的结构,
   * 总复杂度由原本的 `O(k+m + nk·T)` 变为 `O(k+m+n + nk·t + klogk)`,
   * 借助缓存匹配记录,最高可达到 `O(k+m+n + klogk)`,其中:
   *  - `k`为`li`元素的个数
   *  - `m`为精确匹配规则的数量
   *  - `n`为正则匹配规则的数量
   *  - `t/T`为正则表达式平均匹配时间
   * 
   * 其中的匹配逻辑`nk·T`实现为`for(n+m){for(k not M){T}}`,`nk·t`实现为`for(k not M){for(n){t}}`,
   * 因此对总复杂度的影响`T >> t`,同时借助该循环方式的改变,实现了精确匹配绝对优先于正则匹配
   */
  class BaseStaffSorter {
    /**
     * @type {Object<string, any> | Iterable<string>}
     * 原始数据,元素内需包含待匹配职位名称
     */
    rawData;
    /** @type {StaffMapList} 职位排序与折叠设置 */
    staffMapList;
    /** @type {Array<string>} 职位名称的排序结果 */
    sortedJobs;

    /**
     * 构造函数,子类可细化`rawData`的类型定义,
     * 并自行对其初始化,且需在其后调用`_initSetData`函数
     */
    constructor(staffMapList, rawData = null) {
      this.staffMapList = staffMapList;
      if (rawData) {
        this.rawData = rawData;
        this._initSortedJobs();
      }
    }

    /** 初始化排序结果 */
    _initSortedJobs() {
      if (utils.isArray(this.rawData) || utils.isSet(this.rawData)) {
        this.sortedJobs = Array.from(this.rawData);
      } else {
        this.sortedJobs = Object.keys(this.rawData);
      }
    }

    /**
     * 获取匹配后的序列号,
     * 被正则匹配与未被匹配的职位,将所得的序列号写入解析缓存`jobOrderMap`
     * @param {string} job - 数据集合
     * @return {number} 返回用于`Array.sort`的序列号
     */
    getMatchIndex(job) {
      let index;
      // 1.精确匹配,或命中缓存 (优先)
      index = this.staffMapList.exactOrderMap[job];
      if (index !== undefined) return index;
      // 新的匹配记录,需写入`Store`
      this.staffMapList.newlyMatchedCount++;
      // 2.正则匹配
      for (const [regex, _index] of this.staffMapList.regexOrderList) {
        if (!regex.test(job)) continue;
        index = _index;
        this.staffMapList.exactOrderMap[job] = index;
        this._logRegexMatch(regex, job);
        return index;
      }
      // 3.未被匹配
      index = this.staffMapList.insertUnmatched;
      this._logUnmatch(job);
      this.staffMapList.exactOrderMap[job] = index;
      return index;
    }

    /** 进行匹配排序 */
    sort() {
      this.sortedJobs.sort((a, b) => this.getMatchIndex(a) - this.getMatchIndex(b));
    }
    /** 进行匹配遍历 */
    scan() {
      for (const job of this.sortedJobs) this.getMatchIndex(job);
    }
    /** 记录一条被正则匹配的职位信息 */
    _logRegexMatch() {}
    /** 记录一条未被匹配的职位信息 */
    _logUnmatch() {}
  }

  /**
   * 实现网页`infobox`职位信息的排序与折叠,
   * `sub_group`及属其所有的`sub_container`将被视为一个整体进行排序
   */
  class InfoboxStaffSorter extends BaseStaffSorter {
    /**
     * @type {Object<string, HTMLElement | Array<HTMLElement>>}
     * 原始职位信息字典 (细化基类的数据格式)
     */
    rawData;

    /**
     * @param {HTMLElement} ul - `infobox`
     * @param {StaffMapList} staffMapList - 职位排序与折叠设置
     * @param {Object<string, HTMLElement | Array<HTMLElement>>} staffDict - 职位信息字典
     * @param {string} subjectId - 条目`ID`
     */
    constructor(ul, staffMapList, staffDict, subjectId) {
      super(staffMapList);
      this.rawData = staffDict;
      this._initSortedJobs();
      /** @type {Array<string>} 未被匹配的职位名称 */
      this.unmatchedJobs = [];
      /** @type {Array<string>} 被正则匹配的职位名称 */
      // this.regexMatchedJobs = [];
      /** `infobox` */
      this.ul = ul;
      /** `infobox`临时片段 */
      this.fragment = document.createDocumentFragment();
      /** 当前条目的`ID` */
      this.subjectId = subjectId;
      /** 启用插入二级职位引导信息 */
      this.needInsertSubGroup = utils.isNumber(this.staffMapList.insertSubGroup);
    }

    /**
     * 获取匹配后的序列号,
     * 在原有的基础上增加优先插入二级职位引导的功能
     */
    getMatchIndex(job) {
      if (this.needInsertSubGroup && utils.isArray(this.rawData[job])) {
        return this.staffMapList.insertSubGroup;
      }
      return super.getMatchIndex(job);
    }

    sort() {
      // 进行匹配排序
      super.sort();
      // 执行排序结果
      for (const job of this.sortedJobs) {
        const li = this.rawData[job];
        if (utils.isArray(li)) {
          // 1. sub_group 及属其所有的 sub_container 组成的序列
          this.fragment.append(...li);
          lastGroup = li;
        } else {
          // 2. 普通职位信息
          if (this.staffMapList.isFoldedJob(job)) {
            li.classList.add('folded', 'foldable');
          }
          this.fragment.appendChild(li);
        }
      }
      // 一次性更新 DOM 
      this.ul.append(...this.fragment.childNodes);
      // 打印未被匹配的职位
      if (this.unmatchedJobs.length) {
        console.log(`${SCRIPT_NAME}:未被匹配到的职位 {${this.unmatchedJobs}}`);
      }
    }
    /**
     * @param {RegExp} reg
     * @param {string} job
     */
    _logRegexMatch(regex, job) {
      console.log(`${SCRIPT_NAME}:使用正则表达式 ${regex} 成功匹配 "${job}"`);
      // this.regexMatchedJobs.push(job);
    }
    /**
     * @param {string} job
     */
    _logUnmatch(job) {
      this.unmatchedJobs.push(job);
    }
  }

  /** 主函数入口 */
  async function main() {
    const urlPatterns = [
      /^\/(subject)\/(\d+)$/,
      /^\/(character)\/(\d+)$/,
      /^\/(person)\/(\d+)$/,
      /^\/(settings)\/privacy$/,
    ];
    Store.initialize();
    for (const pattern of urlPatterns) {
      const match = window.location.pathname.match(pattern);
      if (!match) continue;
      const [, patternType, subId] = match;
      if (patternType === 'settings') handlerSettings();
      else await handlerSubject(patternType, subId); // 传入条目类型与条目ID
      break;
    }
    Store.postProcessConfigUpdate();
  }

  /** 处理设置 */
  function handlerSettings() {
    loadSettingStyle();
    const ui = buildSettingUI({ id: 'staff_sorting' });
    document.getElementById('columnA').appendChild(ui);
    // 支持 url.hash = ID 进行导引
    if (location.hash.slice(1) === 'staff_sorting') {
      ui.scrollIntoView({ behavior: 'smooth' });
    }
  }

  /** 处理条目 */
  async function handlerSubject(subType, subId) {
    if (SubjectType.needPrase(subType))
      subType = SubjectType.parse(getSubjectType());
    if (!subType) return; // 不支持该类型条目
    const ul = document.querySelector('#infobox');
    console.time(`StaffMapList`);
    const staffMapList = new StaffMapList(subType);
    staffMapList.initialize();
    console.timeEnd(`StaffMapList`);
    if (!staffMapList.isNull()) {
      // 1.实行自定义的职位顺序
      const staffDict = getStaffDict(ul);
      // 延迟执行,提高对修改 infobox 信息的其他脚本的兼容性
      await new Promise(resolve => {
      setTimeout(() => {
          console.time(`StaffSorting`);
          const sorter = new InfoboxStaffSorter(ul, staffMapList, staffDict, subId);
          sorter.sort();
          console.timeEnd(`StaffSorting`);
          hasFolded = staffMapList.hasFolded;
          resolve();
        }, SORTING_DELAY);
      });
    } else {
      // 2.实行网页原有的职位顺序
      addFoldableTag(ul);
      console.log(`${SCRIPT_NAME}:实行网页原有的职位顺序`);
    }
    loadStaffStyle();
    addRefoldToggleButton(ul);
    changeExpandToToggleButton(ul);
    dealLastGroup(ul);
    staffMapList.saveResolvedData();
  }

  /**
   * 巧妙地使用非常便捷的方法,获取当前条目的类型
   * 源自 https://bangumi.tv/dev/app/2723/gadget/1242
   */
  function getSubjectType() {
    const href = document.querySelector("#navMenuNeue .focus").getAttribute("href");
    return href.split("/")[1];
  }

  /**
   * 获取一个对象来存储网页中的职位信息。
   * 并对职位信息进行二次折叠,
   * 同时将`sub_group`及属其所有的`sub_container`打包为一个序列作为字典的键值
   * @param {HTMLElement} ul - `infobox`
   * @returns {Object<string, HTMLElement | Array<HTMLElement>>} 返回职位信息字典,键值为`DOM`或者`DOM`序列
   */
  function getStaffDict(ul) {
    const staffDict = {};
    const lis = ul.querySelectorAll(":scope > li");
    lis.forEach((li) => {
      const tip = li.querySelector("span.tip");
      if (!tip) return;
      let job = tip.innerText.trim().slice(0, -1); // 去掉最后的冒号
      if (li.classList.contains("sub_group")) {
        // 新的小组
        staffDict[job] = [li];
      } else if (li.classList.contains("sub_container")
        && li.hasAttribute("attr-info-group")) {
        // 整合进组
        job = li.getAttribute("attr-info-group");
        if (staffDict[job]) staffDict[job].push(li);
        else staffDict[job] = [li];
      } else {
        // 普通元素
        staffDict[job] = li;
        // 为了正确计算元素高度,需使其 display
        li.classList.remove("folded");
        refoldStaff(li, tip);
        // li.folded 属性已经失效无需还原
      }
    });
    return staffDict;
  }

  /**
   * 为网页原有的`folded`类别添加`foldable`便签,用于实现切换,
   * 忽略属于`sub_group`的`sub_container`,
   * 并对职位信息进行二次折叠
   * @param {HTMLElement} ul - `infobox`
   */
  function addFoldableTag(ul) {
    const lis = ul.querySelectorAll(':scope > li');
    lis.forEach(li => {
      const flag = li.classList.contains('folded') && !li.hasAttribute("attr-info-group");
      // 为了正确计算元素高度,需先使其 display
      if (flag) li.classList.remove('folded');
      const tip = li.querySelector('span.tip');
      if (tip) refoldStaff(li, tip);
      /* 特殊用法:当 StaffMapList = "[]" 空缺设置,同时 SortEnableState = "partialDisable"
       * 将实行网页原有的职位顺序,同时禁止其折叠 */
      if (flag && Store.get(Key.ENABLE_STATE_KEY) !== SortEnableState.PARTIAL_ENABLED) {
        if (!hasFolded) hasFolded = true;
        li.classList.add('folded', 'foldable');
      }
      // 获取 lastGroup
      if (li.classList.contains("sub_group")) lastGroup = [li];
      else if (li.classList.contains("sub_container")
        && li.hasAttribute("attr-info-group")) lastGroup.push(li);
    });
  }

  /**
   * 对超出限制行数的职位信息进行二次折叠,并添加开关。
   * 实现动态不定摘要的类似于`summary`的功能。
   * 过滤`别名`等不定行高的`infobox`信息
   * @param {HTMLElement} li - 职位信息根节点
   * @param {HTMLElement} tip - 职位名称节点
   */
  function refoldStaff(li, tip) {
    if (Store.get(Key.REFOLD_THRESHOLD_KEY) === Key.REFOLD_THRESHOLD_DISABLED) return;
    if (li.classList.contains('sub_container') || li.classList.contains('sub_group')) return; // 过滤不定行高的 infobox 信息
    if (!JobStyle.compStyle) JobStyle.initialize(li);
    const lineCnt = getLineCnt(li);
    const refoldThr = Store.get(Key.REFOLD_THRESHOLD_KEY);
    if (lineCnt <= refoldThr) return;
    // 添加二次折叠效果 (样式将在随后通过 loadStaffStyle 动态载入)
    li.classList.add('refoldable', 'refolded');
    // const nest = nestElementWithChildren(li, 'div', {class: 'refoldable refolded'});
    /* 尝试不修改 DOM 结构仅通过添加样式达到完备的折叠效果,
     * 难点在于处理溢出到 li.padding-bottom 区域的信息
     * 最终通过施加多层遮蔽效果实现,故不再需要内嵌一层新的 div 元素 */

    // 添加头部开关状态图标
    const prefIcon = createElement('i', { class: 'staff_sorting_icon' });
    prefIcon.innerHTML = ICON.TRIANGLE_RIGHT;
    /* 尝试使用<symbol><use>模板或直接使用JS构建实例的方法均失败...
     * 最终改为直接修改innerHTML */
    updateSubElements(tip, prefIcon, 'prepend');
    tip.classList.add('switch');

    // 添加尾部折叠图标
    const suffIcon = createElement('i', { class: 'staff_sorting_icon' });
    const sideTip = createElement('span', {class: 'tip side'}, suffIcon);
    suffIcon.innerHTML = ICON.TRIANGLE_UP;
    li.appendChild(sideTip);
    // 记录被折叠的行数,由于 span{clear: right} 防止其换行,需先渲染并重新计算行数
    const refoldLine = getLineCnt(li) - refoldThr;
    sideTipLineThr ??= getSideTipThr(); // 小于阈值的将被隐藏
    if (refoldLine >= sideTipLineThr) sideTip.dataset.refoldLine = refoldLine;
    // else delete sideTip.dataset.refoldLine;
  }

  /**
   * 为二次折叠按钮绑定开关事件,
   * 采用`事件委托`形式绑定事件 (事件冒泡机制)
   * @param {HTMLElement} ul - `infobox`
   */
  function addRefoldToggleButton(ul) {
    if (Store.get(Key.REFOLD_THRESHOLD_KEY) === 0) return;
    /* 检查点击的元素是否是开关本身 span 或其子元素 icon
     * 使用 .closest('.cls') 替代 classList.contains('cls')
     * 使得子元素也能响应点击事件 */
    ul.addEventListener('click', (event) => {
      /** @type {HTMLElement} 被点击的目标 */
      const target = event.target;
      // 1. 首部开关
      const prefTip = target.closest('.switch');
      if (prefTip && ul.contains(prefTip)){
        // 职位名称或开关状态图标被点击了
        const parent = prefTip.parentElement;
        if (parent.classList.contains('refolded')) {
          parent.classList.remove('refolded');
          prefTip.firstChild.innerHTML = ICON.TRIANGLE_DOWN;
        } else {
          parent.classList.add('refolded');
          prefTip.firstChild.innerHTML = ICON.TRIANGLE_RIGHT;
        }
        return;
      }
      // 2. 尾部开关
      const suffTip = target.closest('.side');
      if (!suffTip || !ul.contains(suffTip)) return;
      const li = suffTip.parentElement;
      // 滚轮将自动上移被折叠的距离,以确保折叠后的内容不会让用户迷失上下文
      const rectBefore = li.getBoundingClientRect();
      // 更改折叠状态
      li.classList.add('refolded');
      // 等待下一帧,让浏览器完成渲染
      requestAnimationFrame(() => {
        const rectAfter = li.getBoundingClientRect();
        /* 尝试通过 suffTip.dataset.refoldLine 计算高度变化
         * 会与理想值有 ~0.5px 的随机偏差,故改用获取元素窗口的高度变化 */
        const distance = rectAfter.top - rectBefore.top + rectAfter.height - rectBefore.height;
        // console.debug( `\n` +
        //   `heightBefore: \t${rectBefore.height},\nheightAfter: \t${rectAfter.height},\n` +
        //   `topAfter: \t${rectAfter.top},\ntopBefore: \t${rectBefore.top},\ndistance: \t${distance},\n` +
        //   `byRefoldLine: \t${suffTip.dataset.refoldLine * JobStyle.lineHeight}`
        // );
        /* 需考虑 li.top 的前后变化,且不要使用 scrollTo
         * 因为部分浏览器对于超出视口的 li 元素进行折叠时,会自主进行防迷失优化,
         * 此时 distance 的计算机结果将会是 0 */
        window.scrollBy({ top: distance, behavior: 'instant' });
      });
      // 修改首部开关的图标
      li.firstChild.firstChild.innerHTML = ICON.TRIANGLE_RIGHT;
    });

    /* 在 mousedown 阶段阻止用户拖动或双击时的默认选中行为。
     * 由于 span.switch 本质仍然是内容段落的一部分,
     * 不通过 user-select: none 这钟粗暴的方法禁止用户的一切选中行为
     * 而是采用温和的方法阻止部分情形下对该区域的选中行为 */
    ul.addEventListener('mousedown', (event) => {
      if (event.target.closest('.switch')) event.preventDefault();
    });
  }

  /**
   * 处理最后一组`sub_group`,若为`infobox`末尾元素,则为其添加标签。
   * 以优化样式,当其非末尾元素时,添加边界以区分`sub_container > li`与普通`li`
   * @param {HTMLElement} ul - `infobox`
   */
  function dealLastGroup(ul) {
    if (!lastGroup || ul.lastElementChild !== lastGroup[lastGroup.length - 1]) return;
    lastGroup.forEach((li) => {
      if (li.classList.contains("sub_container"))
        li.classList.add('last_group');
    })
  }

  /**
   * 获取固定行高`#infobox.li`元素显示的行数
   * 经测试,职员信息除了`8px`的`padding`还有`<1px`的`border`因为不影响行数计算忽略
   */
  function getLineCnt(el, padding = 8, border = 0) {
    const height = el.getBoundingClientRect().height - padding - border;
    return ~~(height / JobStyle.lineHeight);
  }

  /**
   * 根据页面视口高度,计算尾部折叠图标的激活行数阈值
   * 对于二次折叠区域较小,不予显示
   */
  function getSideTipThr() {
    const threshold = ~~(getViewportHeight() / JobStyle.lineHeight * sideTipRate);
    console.log(`${SCRIPT_NAME}:sideTipLineThreshold:${threshold}`);
    return threshold;
  }

  /**
   * 将原本存在的`更多制作人员+`一次性按钮,转绑新事件,并改为永久性开关
   * 使用网页原有的`folded`元素类别,实现对立于`sortStaff`功能
   * 添加不存在的`更多制作人员+`按钮,否则一些职位信息将永不可见
   * @param {HTMLElement} ul - `infobox`
    <div class="infobox_expand">
      <a href="javascript:void(0)">更多制作人员 +</a>
      <!-- href 属性需保留,不然鼠标悬浮效果会失效 -->
    </div>
   */
  function changeExpandToToggleButton(ul) {
    const buttonValue = { on: '更多制作人员 +', off: '更多制作人员 -' };
    let moreLink = document.querySelector('#infobox + .infobox_expand a'); // 无法实现 :scope +
    if (!hasFolded) {
      // 无必要,不进行事件绑定与可能的添加,并将原有的开关隐藏
      if (moreLink) {
        moreLink.style.display = 'none';
        console.log(`${SCRIPT_NAME} - 将原有的 '${buttonValue.on}' 隐藏`);
      }
      return;
    }
    if (!moreLink) {
      moreLink = createElement('a', { href: 'javascript:void(0)' }, buttonValue.on);
      const expand = createElement('div', { class: 'infobox_expand' }, [moreLink]);
      ul.parentElement.appendChild(expand);
      console.log(`${SCRIPT_NAME}:添加原不存在的 '${buttonValue.on}' 按钮`);
    }
    moreLink.addEventListener('click', function (event) {
      event.stopImmediatePropagation(); // 阻止其他事件的触发
      const foldedLis = document.querySelectorAll('.foldable');
      const isHidden = moreLink.innerText == buttonValue.on;
      foldedLis.forEach(li => {
        if (isHidden) li.classList.remove('folded');
        else li.classList.add('folded');
      });
      moreLink.innerText = isHidden ? buttonValue.off : buttonValue.on;
    }, { capture: true }); // 使事件处理函数在捕获阶段运行
  }

  /**
   * 创建用户设置`UI`界面
   * 仿照`#columnA`中的同类元素进行构建,使用原有的结构与样式
    <table class="settings">
      <tbody>
        <tr>
          <td>
            <h2 class="subtitle">条目职位排序 · 默认折叠的职位</h2>
            <div class="right_inline"><p class="tip_j">默认设置版本号</p></div>
          </td>
        </tr>
        <!-- 此处添加子模块 -->
      </tbody>
    </table>
   */
  function buildSettingUI(mainStyle) {
    const mainTitle = createElement('tr', null, [
      createElement('td', { class: 'maintitle' }, [
        createElement('h2', { class: 'subtitle' }, '条目职位排序 · 默认折叠的职位'),
        createElement('div', {class: 'right_inline'},
          createElement('p', { class: 'tip_j' }, `数据 v${CURRENT_DATA_VERSION}`)
        )
      ])
    ]);
    const lineLimitBlock = buildLineLimitBlock();
    const inheritPreMatchBloc = buildInheritPreMatchBlock();
    const subjectBlocks = SubjectType.getAll(true).map(sub => buildSubjectBlock(sub));
    const ui = createElement('div', mainStyle, [
      createElement('table', { class: 'settings' }, [
        createElement('tbody', null, [
          mainTitle,
          lineLimitBlock,
          inheritPreMatchBloc,
          ...subjectBlocks
        ])
      ])
    ]);
    return ui;
  }

  /**
   * 创建职位信息二次折叠的行高限制设置界面
    <tr>
      <td class="line_limit_block">
        <h2 class="subtitle">职位信息高度 限制</h2>
        <div class="right_inline">
          <fieldset class="num_input_cntr">...</fieldset>
          <div class="toggle">...</div>
        </div>
      </td>
    </tr>
   */
  function buildLineLimitBlock() {
    const subTitle = createElement('h2', { class: 'subtitle' }, '职位信息高度 限制');
    // 搭建滑动开关
    const [toggle, toggleCntr] = buildToggleSlider('refold_switch');
    // 搭建整数步进输入器
    const intInput = new IntInputStepper('refold_threshold_input', '行数');
    intInput.build();
    // 搭建外部框架
    const block = createElement('tr', null, [
      createElement('td', { class: 'line_limit_block' }, [
        subTitle,
        createElement('div', {class: 'right_inline'}, [
          intInput.root, toggleCntr
        ])
      ])
    ]);

    // 初始化 (此处无需关心Key._subType)
    toggle.checked = Store.get(Key.REFOLD_THRESHOLD_KEY) !== Key.REFOLD_THRESHOLD_DISABLED;
    intInput.num = Store.get(Key.REFOLD_THRESHOLD_KEY);
    if (!toggle.checked) intInput.display = false;

    // 绑定事件
    function setRefloadThreshold(num) {
      // 与缓存进行对比,防止无效写入
      if (num === Store.get(Key.REFOLD_THRESHOLD_KEY)) return;
      Store.set(Key.REFOLD_THRESHOLD_KEY, num, null, true);
    }
    toggle.addEventListener('click', () => {
      if (toggle.checked) {
        intInput.display = true;
        setRefloadThreshold(intInput.num); // 使用 DOM 中可能的暂存数据
      } else {
        intInput.display = false;
        setRefloadThreshold(Key.REFOLD_THRESHOLD_DISABLED);
      }
    });
    intInput.onNumChange = setRefloadThreshold;

    return block;
  }

  /**
   * 创建继承历史匹配记录设置界面
    <tr>
      <td class="inherit_prematch_block">
        <h2 class="subtitle">继承历史匹配记录</h2>
        <div class="right_inline">
          <p class="tip_j"><!-- message --></p>
          <div class="toggle">...</div>
        </div>
      </td>
    </tr>
   */
  function buildInheritPreMatchBlock() {
    const subTitle = createElement('h2', { class: 'subtitle' }, '继承历史匹配记录');
    // 搭建滑动开关
    const [toggle, toggleCntr] = buildToggleSlider('inherit_switch');
    const toggleMsgBox = createElement('p', { class: 'tip_j' });
    // 搭建外部框架
    const block = createElement('tr', null, [
      createElement('td', { class: 'inherit_prematch_block' }, [
        subTitle,
        createElement('div', {class: 'right_inline'}, [
          toggleMsgBox, toggleCntr
        ])
      ])
    ]);
    // 初始化并绑定事件
    toggle.checked = Store.get(Key.INHERIT_PREVIOUS_MATCHES_KEY);
    toggleOnClick();
    toggle.addEventListener('click', toggleOnClick);

    return block;

    function toggleOnClick() {
      if (toggle.checked) {
        setMessage(toggleMsgBox, '设置变更时将继承');
        Store.set(Key.INHERIT_PREVIOUS_MATCHES_KEY, true, null, true);
      } else {
        setMessage(toggleMsgBox, '不继承');
        Store.set(Key.INHERIT_PREVIOUS_MATCHES_KEY, false, null, true);
      }
    }
  }

  /**
   * 创建`staffMapList`文本内容编辑界面
   * 对于`textarea`,`button`等控件仍然使用原有的结构与样式
    <tr>
      <td class="subject_staff_block">
        <details open="">
          <summary>
            <h2 class="subtitle"><!-- subject type --></h2>
            <div class="right_inline">
              <p class="tip_j"><!-- message --></p>
              <div class="tri_state_selector">...</div>
            </div>
          </summary>
          <div class="staffMapList_editor">...</div>
        </details>
      </td>
    </tr>
   */
  function buildSubjectBlock(subTypeObj) {
    const subType = subTypeObj.en;
    // 设置信息,editor 与 matchLog 公有
    const staffMapList = new StaffMapList(subType);
    // 搭建标题
    const subTitle = createElement('h2', { class: 'subtitle' });
    // 搭建滑动开关
    const selector = new TriStateSlider(`${subType}_subject_enable`);
    const selectorMsgBox = createElement('p', { class: 'tip_j' });
    const selectorField = createElement('div', {class: 'right_inline hidden'}, [
      selectorMsgBox, selector.root
    ]);
    selector.build();
    // 定义编辑器,暂不构建
    const editor = new StaffMapListEditor(subType, staffMapList);
    // 搭建展开容器
    const detail = createElement('details', null, [
      createElement('summary', null, [
        subTitle, selectorField
      ]),
      editor.root,
    ])
    // 搭建外部结构
    const block = createElement('tr', null, [
      createElement('td', {class: 'subject_staff_block'}, detail)
    ]);

    // 初始化
    subTitle.textContent = `${subTypeObj.zh}条目`;
    detail.open = Store.get(Key.BLOCK_OPEN_KEY, subType);
    selector.state = Store.get(Key.ENABLE_STATE_KEY, subType);
    setSelectorMsgBox(selector.state);
    blockOnOpen();

    // 绑定事件
    selector.onStateChange = (newState) => {
      setSelectorMsgBox(newState);
      Store.set(Key.ENABLE_STATE_KEY, newState, subType, true)
    };
    detail.addEventListener('toggle', blockOnOpen); // 无需上下文环境

    return block;

    function setSelectorMsgBox(state) {
      switch (state) {
        case SortEnableState.ALL_DISABLED:
          setMessage(selectorMsgBox, '禁用设置,但仍可编辑保存'); break;
        case SortEnableState.PARTIAL_ENABLED:
          setMessage(selectorMsgBox, '仅启用排序,禁用折叠'); break;
        case SortEnableState.ALL_ENABLED:
          setMessage(selectorMsgBox, '启用自定义 / 默认设置'); break;
      }
    }
    function blockOnOpen() {
      if (detail.open) {
        // 在第一次展开时构建
        if (!editor.built) editor.build();
        selectorField.classList.remove('hidden');
      } else {
        selectorField.classList.add('hidden');
      }
      Store.set(Key.BLOCK_OPEN_KEY, detail.open, subType, true);
    }
  }

  /**
   * `staffMapList`编辑器,并对数据进行自主管理
    <div class="staffMapList_editor">
      <div class="markItUp">
        <textarea class="quick markItUpEditor hasEditor codeHighlight" name="staff_map_list">
          <!-- staffMapListText -->
        </textarea>
      </div>
      <div>
        <input class="inputBtn" type="submit" name="submit_context" value="保存">
        <input class="inputBtn" type="submit" name="reset_context" value="恢复默认">
        <p class="tip_j" style="display: inline;">
          <!-- message -->
        </p>
      </div>
      <!-- margin-right 为移动端预留的 mainpage 滑动空间 -->
    </div>
   */
  class StaffMapListEditor {
    static _editorCls = 'staffMapList_editor';

    /**
     * @param {string} subType - 条目类型
     * @param {StaffMapList} staffMapList
     */
    constructor(subType, staffMapList) {
      this.subType = subType;
      this.staffMapList = staffMapList;
      this.root = createElement('div', { class: StaffMapListEditor._editorCls });
      this.textArea = null; // 输入文本框
      this.resetBtn = null; // 提交按钮
      this.submitBtn = null; // 重置按钮
      this.editorMsgBox = null; // 简易提示框
      this.isDefault = null; // 标记是否为默认数据
      this.hasInputed = null; // 文本框内容是否被改变且未被保存
      this.preInheritState = Store.get(Key.INHERIT_PREVIOUS_MATCHES_KEY);
      this.built = false; // 标记是否已经初始化
    }

    build() {
      if (this.built) return; // 防止重复构建
      // 构建元素结构
      this.textArea = createElement('textarea', {
        class: 'quick markItUpEditor hasEditor codeHighlight', name: 'staff_map_list'
      });
      this.submitBtn = createElement('input', {
        class: 'inputBtn', type: 'submit', name: 'submit_context', value: '保存'
      });
      this.resetBtn = createElement('input', {
        class: 'inputBtn', type: 'submit', name: 'reset_context', value: '恢复默认'
      });
      this.editorMsgBox = createElement('p', { class: 'tip_j'});
      this.root.append(
        createElement('div', { class: 'markItUp' }, this.textArea),
        createElement('div', null, [this.submitBtn, this.resetBtn, this.editorMsgBox])
      );
      // 初始化状态
      const text = this.staffMapList.formatToText(false);
      this.textArea.value = text;
      this.isDefault = this.staffMapList.isDefault;
      this.hasInputed = false;
      if (text.trim() === "") setMessage(this.editorMsgBox, '现为设置空缺', 0); // 网页实行原有的职位顺序与折叠
      else if (this.isDefault) setMessage(this.editorMsgBox, '现为默认设置', 0); // 初始化时,提醒用户已为默认设置
      else setMessage(this.editorMsgBox, '现为自定义设置', 0);
      // 绑定事件
      this.textArea.addEventListener('input', this._onInput.bind(this));
      this.resetBtn.addEventListener('click', this._onReset.bind(this));
      this.submitBtn.addEventListener('click', this._onSubmit.bind(this));
      this.built = true;
    }

    _onInput() {
      if (this.isDefault) this.isDefault = false;
      if (!this.hasInputed) this.hasInputed = true;
      // console.debug("IS INPUTTING");
    }

    async _onReset() {
      if (this.isDefault) return setMessage(this.editorMsgBox, '已为默认内容');
      await trySetText(
        this.textArea, this.editorMsgBox, this.staffMapList.formatToText(true),
        '已恢复默认内容', false
      );
      // 需进行同步等待,由于 setText 可能会触发 input 事件
      this.isDefault = true;
      this.hasInputed = false;
    }

    async _onSubmit() {
      // 判断是否为重置后未对默认内容进行修改
      if (this.isDefault) {
        if (this.staffMapList.isDefault && !this._onInheritStateChange()) {
          setMessage(this.editorMsgBox, '已为默认设置');
        } else {
          // 由自定义改为默认设置,或继承状态发生改变
          this.staffMapList.resetData();
          setMessage(this.editorMsgBox, '保存成功!恢复默认设置');
        }
        this.hasInputed = false;
        return;
      }
      if (!this.hasInputed && !this._onInheritStateChange()) {
        setMessage(this.editorMsgBox, '未作修改');
        return;
      }
      const [modifiedData, isModified, curCursorPos] = StaffMapListEditor.modifyText(this.textArea);
      // 强制将用户输入的文本外层嵌套 `[]`,若为重复嵌套可在 loadMapList 中识别并去除
      const savedData = `[${modifiedData}]`;
      const parsedData = RegexInJSON.parse(savedData);
      // 数据解析失败
      if (!parsedData) return setMessage(this.editorMsgBox, '保存失败!格式存在错误');
      // 保存数据
      this.staffMapList.saveData(savedData, parsedData);
      // 页面显示
      if (modifiedData.trim() === "") setMessage(this.editorMsgBox, '保存成功!空缺设置');
      else if (isModified) {
        await trySetText(
          this.textArea, this.editorMsgBox, modifiedData,
          '保存成功!并自动纠错', true, curCursorPos
        );
      } else setMessage(this.editorMsgBox, '保存成功!');
      this.hasInputed = false;
    }

    _onInheritStateChange() {
      const curInheritState = Store.get(Key.INHERIT_PREVIOUS_MATCHES_KEY);
      if (this.preInheritState !== curInheritState) {
        this.preInheritState = curInheritState;
        return true;
      } else return false;
    }

    /**
     * 对用户输入可能的常见语法与格式错误,进行自动纠错,以满足`JSON`格式
     * 并计算文本修改后,光标的适宜位置
     * 已基本兼容`JavaScript`格式的文本数据,实现格式转化
     * `group2`与`group4`致使正则表达式中不允许出现`/'"`三种字符
     */
    static modifyText(textArea) {
      const preCursorPos = getTextAreaPos(textArea).cursorPos;
      let curCursorPos = preCursorPos;
      let flags = new Array(6).fill(false);
      const rslt = textArea.value.replace(
        /(,\s*)+(?=]|$)|(?<=\[|^)(\s*,)+|(,\s*)+(?=,)|(['‘’“”])|(?<!['"‘“])(\/[^/'"‘’“”]+\/[gimsuy]*)(?!['"’”])|([,、])/g,
        (match, g1, g2, g3, g4, g5, g6, offset) => {
          isTriggered(0, '删除序列末尾元素后的 `,` 逗号', g1);
          isTriggered(1, '删除序列首位元素前的 `,` 逗号', g2);
          isTriggered(2, '删除连续重复的 `,` 逗号', g3);
          isTriggered(3, '将非半角单引号的引号替换', g4);
          isTriggered(4, '将正则表达式以双引号包裹', g5);
          isTriggered(5, '将全角逗号顿号变为半角逗号', g6);
          if (booleanOr(g1, g2, g3)) {
            let diff = preCursorPos - offset;
            if (diff > 0) curCursorPos -= Math.min(diff, match.length);
            return '';
          }
          if (g4) return '"';
          if (g5) {
            if (offset < preCursorPos && preCursorPos < offset + match.length) curCursorPos += 1;
            else if (preCursorPos >= offset + match.length) curCursorPos += 2;
            return `"${match}"`;
          }
          if (g6) return ',';
          return match;
        });
      return [rslt, booleanOr(...flags), curCursorPos];

      function isTriggered(index, msg, ...groups) {
        if (!flags[index] && booleanOr(...groups)) {
          console.log(`${SCRIPT_NAME}:触发自动纠错 - ${msg}`);
          flags[index] = true;
        }
      }
      function booleanOr(...values) {
        return values.reduce((acc, val) => acc || val, false);
      }
    }
  }

  /**
   * 整数步进输入器,
   * 不使用`input.type: 'number'`而是自我搭建相关控制
    <fieldset class="num_input_cntr">
      <span class="text">行数</span>
      <input class="inputtext input_num" type="text" maxlength="2">
      <div class="num_ctrs">
        <div><svg>...</svg></div>
        <div><svg>...</svg></div>
      </div>
    </fieldset>
   */
  class IntInputStepper {
    static default = Key.REFOLD_THRESHOLD_DEFAULT;
    // 所用样式的类名
    static _fieldCls = 'num_input_cntr';
    static _inputCls = 'inputtext input_num';
    static _ctrsCls = 'num_ctrs';
    /**
     * @type {(newNum: int) => void | null}
     * 回调函数,当数据变化时被调用
     */
    onNumChange = null;

    constructor(id, labelName, initNum = IntInputStepper.default) {
      this.root = createElement('fieldset', { class: IntInputStepper._fieldCls });
      this.numInput = null;
      this.incBtn = null;
      this.decBtn = null;
      this.id = id;
      this.labelName = labelName;
      this.initNum = initNum;
      this.minNum = {int: 1, str: '1'};
      this.maxDigits = 2;
    }

    set num(num) {
      if(!num) num = IntInputStepper.default;
      this.numInput.value = String(num);
    }
    get num() {
      return Number(this.numInput.value);
    }
    /**  @param {boolean} flag */
    set display(flag) {
      this.root.style.display = flag ? 'flex' : 'none';
    }

    build() {
      // 构建元素结构
      this.numInput = createElement('input', {
        class: IntInputStepper._inputCls, type: 'text', maxlength: this.maxDigits, id: this.id
      });
      this.incBtn = createElement('div', { name: 'inc_btn' });
      this.decBtn = createElement('div', { name: 'dec_btn' });
      this.incBtn.innerHTML = ICON.TRIANGLE_UP;
      this.decBtn.innerHTML = ICON.TRIANGLE_DOWN;
      this.root.append(
        createElement('span', { class: 'text' }, this.labelName),
        this.numInput,
        createElement('div', { class: IntInputStepper._ctrsCls }, [this.incBtn, this.decBtn])
      );
      // 初始化状态并绑定事件
      this.num = this.initNum;
      this.numInput.addEventListener('input', this._onInput.bind(this));
      this.numInput.addEventListener('keydown', this._onKeyDown.bind(this));
      this.incBtn.addEventListener('click', this._onInc.bind(this));
      this.decBtn.addEventListener('click', this._onDec.bind(this));
    }

    /** 限制输入为正整数 */
    _onInput() {
      let value = this.numInput.value.replace(/[^0-9]/g, '');
      if (value === '' || parseInt(value) === 0) value = this.minNum.str;
      this.numInput.value = value;
      if (this.onNumChange) this.onNumChange(this.num);
    }
    /** 限制键盘输入行为,禁止非数字键输入 */
    _onKeyDown(event) {
      if (!/^[0-9]$/.test(event.key) && event.key !== 'Backspace'
        && event.key !== 'ArrowLeft' && event.key !== 'ArrowRight')
        event.preventDefault();
      if (event.key === 'ArrowUp') this._onInc();
      else if (event.key === 'ArrowDown') this._onDec();
    }
    /** 步增,可按钮或键盘触发 */
    _onInc() {
      let value = this.num;
      this.num = value + 1;
      if (this.onNumChange) this.onNumChange(this.num);
    }
    /** 步减,可按钮或键盘触发 */
    _onDec() {
      let value = this.num;
      if (value > this.minNum.int) this.num = value - 1;
      if (this.onNumChange) this.onNumChange(this.num);
    }
  }

  /**
   * 三态滑动选择器
    <div class="tri_state_selector">
      <input type="radio" name="_subject_enable_group" value="allDisable" class="radio_input">
      <label class="radio_label"></label>
      <input type="radio" name="_subject_enable_group" value="partialEnable" class="radio_input">
      <label class="radio_label"></label>
      <input type="radio" name="_subject_enable_group" value="allEnable" class="radio_input">
      <label class="radio_label"></label>
      <div class="select_slider">
        <div class="select_indicator"></div>
      </div>
    </div>
   */
  class TriStateSlider {
    /** 可选状态 */
    static states = [
      SortEnableState.ALL_DISABLED,     // 1 灰
      SortEnableState.PARTIAL_ENABLED,  // 2 红
      SortEnableState.ALL_ENABLED       // 3 蓝
    ];
    static default = Key.ENABLE_STATE_DEFAULT;
    // 所用样式的类名
    static _selectorCls = 'tri_state_selector';
    static _radioCls = 'radio_input';
    static _labelCls = 'radio_label';
    static _sliderCls = 'select_slider';
    static _indicatorCls = 'select_indicator';
    /**
     * @type {(newState: string) => void | null}
     * 回调函数,当状态变化时被调用
     */
    onStateChange = null;

    constructor(idPref, initState = TriStateSlider.default) {
      this.root = createElement('div', { class: TriStateSlider._selectorCls });
      this.radios = {};
      this.idPref = idPref;
      this.initState = initState;
      this._stateHis = {pre: null, pre2: null};
      this._initStateHis();
    }

    set state(state) {
      if (!state || !TriStateSlider.states.includes(state))
        state = TriStateSlider.default;
      this.initState = state;
      this._initStateHis();
      this.radios[state].checked = true;
    }

    get state() {
      for (const [state, radio] of Object.entries(this.radios)) {
        if (radio.checked) return state;
      }
      return this.initState;
    }

    /**
     * 构造`DOM`树,并绑定事件
     */
    build() {
      // 构建单选格,radio 本体将通过样式隐藏
      TriStateSlider.states.forEach((state) => {
        const radioId = `${this.idPref}_${state}`;
        const radio = createElement('input', {
          type: 'radio', name: `${this.idPref}_group`, id: radioId,
          value: state, class: TriStateSlider._radioCls
        });
        const label = createElement('label', { htmlFor: radioId, class: TriStateSlider._labelCls });
        this.radios[state] = radio;
        this.root.append(radio, label);
      });
      // 构建滑动外观
      this.root.append(
        createElement('div', { class: TriStateSlider._sliderCls },
          createElement('div', { class: TriStateSlider._indicatorCls })
        ));
      // 初始化状态并绑定事件
      this.radios[this.initState].checked = true;
      // 1) 箭头函数每次事件触发时,都会创建一个新的匿名函数,影响性能
      // this.selector.addEventListener('click', (event) => this._onClick(event));
      // 2) 事件监听器的回调函数本身会改变 this,使得它从指向类的实例对象,变为指向事件触发的元素
      // this.selector.addEventListener('click', this._onClick);
      // 3) 使用绑定后的函数
      this.root.addEventListener('click', this._onClick.bind(this));
    }

    _initStateHis() {
      this._stateHis.pre = this.initState;
      // 设定历史状态,使得无需在 _onClick 为重复点击初始状态单独处理
      this._stateHis.pre2 = this.initState === TriStateSlider.states[1]
        ? TriStateSlider.states[2] : TriStateSlider.states[1]; // ((1,3) 2)->(2 3)
    }

    /**
     * 采用事件委托的形式处理点击事件,
     * 将原本的`radio`操作体验处理为`ToggleSlider`手感
     */
    _onClick(event) {
      if (!event.target.classList.contains('radio_input')) return;
      let curState = event.target.value;
      // 现在与过去互异,正常不处理;现在与过去的过去互异,模拟 Toggle
      if (curState === this._stateHis.pre && curState !== this._stateHis.pre2) {
        this.radios[this._stateHis.pre2].checked = true;
        curState = this._stateHis.pre2;
      }
      this._stateHis.pre2 = this._stateHis.pre;
      this._stateHis.pre = curState;
      // 使用回调函数通知外部
      if (this.onStateChange) this.onStateChange(curState);
    }
  }

  /**
   * 创建一个滑动开关
   * @param {string} sliderId - 开关的`ID`
   * @returns {[HTMLElement, HTMLElement]} 返回`开关`与`开关容器`构成的数组
    <div class="toggle">
      <input class="toggle_input" type="checkbox" id="refold_switch">
      <label class="toggle_slider" for="refold_switch"></label>
    </div>
   */
  function buildToggleSlider(sliderId) {
    const toggle = createElement('input', { class: 'toggle_input', type: 'checkbox', id: sliderId });
    const toggleCntr = createElement('div', { class: 'toggle' },
      [toggle, createElement('label', { class: 'toggle_slider', htmlFor: sliderId })]
    );
    return [toggle, toggleCntr];
  }

  /**
   * 优先尝试使用`execCommand`方法改写文本框,使得改写前的用户历史记录不被浏览器清除
   * (虽然`execCommand`方法已被弃用...但仍然是实现该功能最便捷的途径)
   */
  async function trySetText(textArea, msgBox, text, msg, isRestore, setCursorPos = null, transTime = 100) {
    let {scrollVert, cursorPos} = getTextAreaPos(textArea);
    try {
      setMessage(msgBox);
      await clearAndSetTextarea(textArea, text, transTime);
      setMessage(msgBox, `${msg},可快捷键撤销`, 0);
    } catch {
      textArea.value = '';
      await new Promise(resolve => setTimeout(resolve, transTime));
      textArea.value = text;
      setMessage(msgBox, msg, 0);
      console.log(`${SCRIPT_NAME}:浏览器不支持 execCommand 方法,改为直接重置文本框,将无法通过快捷键撤销重置`)
    }
    if (isRestore) {
      setCursorPos ??= cursorPos; // 可以使用外部计算获取的光标位置
      restorePos();
    }

    /**
     * 恢复滚动位置和光标位置
     */
    function restorePos() {
      const currentTextLen = textArea.value.length;
      if (setCursorPos > currentTextLen) setCursorPos = currentTextLen;
      textArea.scrollTop = Math.min(scrollVert, textArea.scrollHeight);
      // textArea.scrollLeft = Math.min(scrollHoriz, textArea.scrollWidth - textArea.clientWidth);
      textArea.setSelectionRange(setCursorPos, setCursorPos);
    }
  }

  /**
   * 获取文本框的滚动位置和光标位置
   */
  function getTextAreaPos(textArea) {
    return {
      scrollVert: textArea.scrollTop,
      scrollHoriz: textArea.scrollLeft,
      cursorPos: textArea.selectionStart
    };
  }

  async function clearAndSetTextarea(textarea, newText, timeout = 100) {
    textarea.focus();
    // 全选文本框内容并删除
    textarea.setSelectionRange(0, textarea.value.length);
    document.execCommand('delete');
    // 延迟一段时间后,插入新的内容
    await new Promise(resolve => setTimeout(resolve, timeout));
    document.execCommand('insertText', false, newText);
  }

  async function setMessage(container, message, timeout = 100) {
    container.style.display = 'none';
    if (!message) return; // 无信息输入,则隐藏
    // 隐藏一段时间后,展现新内容
    if (timeout) await new Promise(resolve => setTimeout(resolve, timeout));
    container.textContent = message;
    container.style.display = 'inline';
  }

  /**
   * 获取当前页面的视口高度
   */
  function getViewportHeight() {
    return document.documentElement.clientHeight || document.body.clientHeight;
  }

  /**
   * 创建元素实例
   * @param {string} tagName - 类名
   * @param {Object | undefined} options - 属性
   * @param {Array<HTMLElement | string> | undefined} subElements - 子元素
   * @param {Object<string, Function> | undefined} eventHandlers - 绑定的事件
   */
  function createElement(tagName, options, subElements, eventHandlers) {
    const element = document.createElement(tagName);
    if (options) {
      for (const opt of Object.keys(options)) {
        if (opt === 'class') element.className = options[opt];
        else if (['maxlength', 'open'].includes(opt)) element.setAttribute(opt, options[opt]);
        else if (opt === 'dataset' || opt === 'style') {
          for (const key of Object.keys(options[opt])) {
            element[opt][key] = options[opt][key];
          }
        } else element[opt] = options[opt];
      }
    }
    if (subElements) updateSubElements(element, subElements);
    if (eventHandlers) {
      for (const e of Object.keys(eventHandlers)) {
        element.addEventListener(e, eventHandlers[e]);
      }
    }
    return element;
  }

  /**
   * 更新子元素的内容
   * @param {HTMLElement} parent - 父元素
   * @param {Array<HTMLElement | string> | HTMLElement | string | undefined} subElements - 要插入的子元素
   * @param {'append' | 'prepend' | 'replace'} [actionType='append'] - 操作类型,可以是以下之一:
   *   `prepend` - 将元素插入到父元素的首位
   *   `append`  - 将元素插入到父元素的末尾
   *   `replace` - 清空父元素内容并插入元素
   */
  function updateSubElements(parent, subElements, actionType = 'append') {
    if (actionType === 'replace') parent.innerHTML = '';
    if (!subElements) return parent;
    if (!utils.isArray(subElements)) subElements = [subElements];
    subElements = subElements.map(e => typeof e === 'string' ? document.createTextNode(e) : e);
    switch (actionType) {
      case "append":
      case "replace":
        parent.append(...subElements);
        break;
      case "prepend":
        parent.prepend(...subElements);
        break;
      default:
        throw new Error(`'${actionType}' is invalid action type of updateElements!`);
    }
    return parent;
  }

  /**
   * 使用闭包定义防抖动函数模板。
   * 若为立即执行,将先执行首次触发,再延迟执行最后一次触发
   * @param {Function} func - 回调函数
   * @param {boolean} [immediate=false] - 是否先立即执行
   */
  function debounce(func, immediate = false, delay = DEBOUNCE_DELAY) {
    let timer = null;
    return function (...args) {
      const context = this; // 保存调用时的上下文
      const callNow = immediate && !timer;
      if (timer) clearTimeout(timer);
      // 设置新的定时器
      timer = setTimeout(() => {
        timer = null;
        if (!immediate) func.apply(context, args); // 延时执行
      }, delay);
      if (callNow) func.apply(context, args); // 立即执行
    };
  }

  /** 基本工具函数集 */
  const utils = {
    isObject: (value) => value !== null && typeof value === "object",
    isArray: Array.isArray,
    isSet: (value) => value instanceof Set,
    isRegExp: (value) => value instanceof RegExp,
    isString: (value) => typeof value === "string",
    isBoolean: (value) => typeof value === "boolean",
    isFunction: (value) => typeof value === "function",
    isNumber: (value) => typeof value === 'number' && !isNaN(value),
    isFinity: (num) => Number.isFinite(num),

    /**
     * 过滤对象中的方法,只返回对象的枚举值
     * @param {Object} obj - 需要过滤的对象
     * @param {(value: any) => boolean} [filterFn = value => typeof value !== 'function']
     * - 过滤函数 (默认过滤掉函数类型)
     * @returns {Array} 过滤后的枚举值数组
     */
    filterEnumValues: (
      obj, filterFn = (value) => typeof value !== "function"
    ) => Object.values(obj).filter(filterFn),
  };

  /**
   * `infobox.li`职位人员信息的计算样式
   */
  const JobStyle = {
    compStyle: null,
    // fontSize: null, // num
    lineHeight: null, // num
    borderBottom: null, // px
    paddingBottom: null, // px
    initialize(el) {
      this.compStyle = window.getComputedStyle(el); // 通常不会返回 em % normal 类别的数据
      // this.fontSize = parseFloat(this.compStyle.fontSize);
      this.lineHeight = parseFloat(this.compStyle.lineHeight);
      this.borderBottom = this.compStyle.borderBottomWidth;
      this.paddingBottom = this.compStyle.paddingBottom;
      console.log(
        `${SCRIPT_NAME}:lineHeight:${this.lineHeight}px, ` +
        `borderBottom:${this.borderBottom}, paddingBottom:${this.paddingBottom}`
      );
    },
  }

  /**
   * 动态载入职位排序的样式,
   * 依据的职位信息行高`jobLineHeight`与设置的限制行数`maxRefoldLines`
   */
  function loadStaffStyle() {
    const style = createElement('style', {class: 'staff_sorting'});
    // 使用CSS变量,以便未来拓展监听窗口布局变化
    style.innerHTML = `
      :root {
        --refold-threshold: ${Store.get(Key.REFOLD_THRESHOLD_KEY)};
        --job-line-height: ${JobStyle.lineHeight}px; /* 18px */
        --job-border-bottom: ${JobStyle.borderBottom}; /* 0.64px */
        --job-padding-bottom: ${JobStyle.paddingBottom}; /* 4px */
      }

      /* 删除与前继元素重复的边线 */
      #infobox li.sub_container li.sub_section:first-child,
      #infobox li.sub_group,
      html[data-theme='dark'] ul#infobox li.sub_group {
        border-top: none; !important
      }

      /* 优化小组样式 */
      #infobox li:not(.last_group)[attr-info-group] {
        border-bottom: none;
      }
      #infobox li:not(.last_group)[attr-info-group] > ul {
        border-bottom: 3px solid #fafafa;
      }
      html[data-theme='dark'] #infobox li:not(.last_group)[attr-info-group] > ul {
        border-bottom: 3px solid #3d3d3f;
      }

      /* 防止图标可能污染爬取 infobox 数据的脚本 */
      .staff_sorting_icon {
        display: none;
      }
      #infobox .staff_sorting_icon {
        display: inline;
      }

      /* 职位信息二次折叠 */
      #infobox li.refoldable {
        display: inline-block; /* 使其容纳.tip.side */
        height: auto;
        overflow: visible;
      }
      #infobox li.refolded {
        display: block;
        overflow: hidden;
        height: calc(var(--refold-threshold) * var(--job-line-height));
        /* 由下至上进行遮蔽 */
        -webkit-mask-image:
          linear-gradient(black, black), /* 显现 border-bottom */
          linear-gradient(transparent, transparent), /* 隐藏溢出到 padding-bottom 区域的信息 */
          linear-gradient(160deg, black 10%, transparent 90%), /* 修饰最后一行人员信息 */
          linear-gradient(black, black); /* 显现其余的人员信息 */
                mask-image:
          linear-gradient(black, black),
          linear-gradient(transparent, transparent),
          linear-gradient(160deg, black 10%, transparent 90%),
          linear-gradient(black, black);
        -webkit-mask-size:
          100% var(--job-border-bottom),
          100% var(--job-padding-bottom),
          100% var(--job-line-height),
          100% calc(100% - var(--job-line-height) - var(--job-padding-bottom) - var(--job-border-bottom));
                mask-size:
          100% var(--job-border-bottom),
          100% var(--job-padding-bottom),
          100% var(--job-line-height),
          100% calc(100% - var(--job-line-height) - var(--job-padding-bottom) - var(--job-border-bottom));
        -webkit-mask-position:
          0 100%,
          0 calc(100% - var(--job-border-bottom)),
          0 calc(100% - var(--job-border-bottom) - var(--job-padding-bottom)),
          0 0;
                mask-position:
          0 100%,
          0 calc(100% - var(--job-border-bottom)),
          0 calc(100% - var(--job-border-bottom) - var(--job-padding-bottom)),
          0 0;
        -webkit-mask-repeat: no-repeat;
                mask-repeat: no-repeat;
        -webkit-mask-composite: source-over;
                mask-composite: add;
      }
      #infobox .tip.switch,
      #infobox .tip.side {
        cursor: pointer;
      }
      #infobox .tip.switch:hover {
        color: #000;
      }
      html[data-theme='dark'] #infobox .tip.switch:hover {
        color: #FFF;
      }
      #infobox .tip.switch:hover i,
      #infobox .tip.side:hover i {
        color: #2ea6ff;
      }
      #infobox .tip.side {
        display: none;
        float: right; /* 将其推到尾行右侧 */
        clear: right; /* 如果尾行放不下,则换到新行 */
        margin: 0 5px;
      }
      #infobox .tip.side[data-refold-line] {
        display: inline-block;
      }
    `;
    document.head.appendChild(style);
  }

  /** 载入设置界面的样式 */
  function loadSettingStyle() {
    const style = createElement('style', {class: 'staff_sorting'});
    // 使用CSS变量提高对代码的复用性
    style.innerHTML = `
      :root {
        --state-selector-size: 22px;
        --state-selector-step: 19px;
      }

      /* 设置界面的样式 */
      #staff_sorting > .settings {
        margin-left: 5px;
      }
      #staff_sorting .right_inline {
        display: flex;
        float: right;
        align-items: center;
      }
      #staff_sorting .right_inline .tip_j {
        margin-right: 15px;
      }
      #staff_sorting .hidden {
        display: none;
      }
      #staff_sorting h2 {
        display: inline-block;
      }
      #staff_sorting [class*='_block'] h2 {
        font-size: 16px;
      }

      /* 主标题 */
      #staff_sorting .maintitle .right_inline {
        height: 25px;
      }
      #staff_sorting .maintitle .tip_j {
        font-size: 13px;
        margin-right: 6px;
      }

      /* 各类型条目的职位设置模块 */
      .subject_staff_block h2,
      .subject_staff_block summary::marker {
        cursor: pointer;
      }
      .subject_staff_block .tip_j {
        display: none;
        margin: 0 5px;
      }
      .subject_staff_block .staffMapList_editor {
        padding-right: 10%;
        margin-bottom: 5px;
      }
      .staffMapList_editor .inputBtn {
        margin-right: 5px;
      }
      .staffMapList_editor textarea {
        font-size: 15px;
        line-height: 21px;
      }

      /* 数字输入框与控制器 */
      .num_input_cntr {
        display: flex;
        float: left;
        align-items: center;
        gap: 5px;
        margin-right: 30px;
      }
      .num_input_cntr .text {
        font-size: 14px;
        margin-right: 2px;
      }
      .inputtext.input_num {
        width: 30px;
        height: 11px;
        text-align: center;
        font-size: 15px;
      }
      .num_ctrs {
        display: flex;
        flex-direction: column;
        background-color: white;
        border: 1px solid #d9d9d9;
        border-radius: 4px;
        box-shadow: inset 0 1px 3px rgba(0, 0, 0, 0.1);
        gap: 0;
      }
      html[data-theme="dark"] .num_ctrs {
        background-color: black;
        border: 1px solid #757575;
      }
      .num_ctrs div {
        display: flex;
        text-align: center;
        width: 12px;
        height: 6.5px;
        padding: 2px;
        cursor: pointer;
      }
      .num_ctrs div:first-child {
        border-radius: 3px 3px 0 0;
      }
      .num_ctrs div:last-child {
        border-radius: 0 0 3px 3px;
      }
      .num_ctrs div svg {
        width: 100%;
        height: 100%;
      }
      .num_ctrs div:active {
        background-color: #2ea6ff;
      }

      /* 滑动开关 */
      .toggle {
        position: relative;
        width: 44px;
        height: 22px;
        display: block;
        float: right;
      }
      .toggle_input {
        display: none;
      }
      .toggle_slider {
        position: absolute;
        cursor: pointer;
        top: 0;
        left: 0;
        right: 0;
        bottom: 0;
        background-color: #eaeaea;
        border-radius: 22px;
        box-shadow: inset 0 2px 3px rgba(0, 0, 0, 0.2);
        transition: background-color 0.2s ease-in;
      }
      html[data-theme="dark"] .toggle_slider {
        background-color: #9a9a9a;
      }
      .toggle_slider::before {
        content: "";
        position: absolute;
        height: 16px;
        width: 16px;
        left: 3px;
        bottom: 3px;
        background-color: white;
        border-radius: 50%;
        box-shadow: 0 2px 3px rgba(0, 0, 0, 0.3);
        transition: transform 0.2s ease-in;
      }
      .toggle_input:checked + .toggle_slider {
        background-color: #72b6e3;
      }
      html[data-theme="dark"] .toggle_input:checked + .toggle_slider {
        background-color: #3072dc;
      }
      .toggle_input:checked + .toggle_slider::before {
        transform: translateX(22px);
      }

      /* 滑动选择器公有 */
      .tri_state_selector {
        position: relative;
        height: var(--state-selector-size);
        display: inline-block;
      }
      .radio_input {
        position: absolute;
        opacity: 0;
        z-index: 2;
      }
      .select_slider {
        position: relative;
        width: 100%;
        height: 100%;
        background-color: #eaeaea;
        border-radius: var(--state-selector-size);
        box-shadow: inset 0 2px 5px rgba(0, 0, 0, 0.2);
        z-index: 1;
        overflow: hidden;
        transition: background-color 0.2s ease-in;
      }
      html[data-theme="dark"] .select_slider {
        background-color: #9a9a9a;
      }
      .select_indicator {
        position: absolute;
        width: calc(var(--state-selector-size) - 4px);
        height: calc(var(--state-selector-size) - 4px);
        top: 2px;
        left: 2px;
        background-color: white;
        border-radius: 50%;
        box-shadow: 0 2px 3px rgba(0, 0, 0, 0.3);
        z-index: 1;
        transition: transform 0.2s ease-in;
      }
      .radio_label {
        position: absolute;
        width: var(--state-selector-step);
        height: 100%;
        top: 0;
        cursor: pointer;
        z-index: 3;
      }

      /* 三态滑动选择器 */
      .tri_state_selector {
        width: calc(
          var(--state-selector-size) + var(--state-selector-step) * 2
        );
      }
      label.radio_label:nth-of-type(1) {
        left: 0;
      }
      label.radio_label:nth-of-type(2) {
        left: var(--state-selector-step);
      }
      label.radio_label:nth-of-type(3) {
        width: var(--state-selector-size);
        left: calc(var(--state-selector-step) * 2);
      }
      input.radio_input:nth-of-type(2):checked ~ .select_slider {
        background-color: #f47a88;
      }
      input.radio_input:nth-of-type(3):checked ~ .select_slider {
        background-color: #72b6e3;
      }
      html[data-theme="dark"] input.radio_input:nth-of-type(2):checked ~ .select_slider {
        background-color: #ff668a;
      }
      html[data-theme="dark"] input.radio_input:nth-of-type(3):checked ~ .select_slider {
        background-color: #3072dc;
      }
      input.radio_input:nth-of-type(1):checked ~ .select_slider .select_indicator {
        transform: translateX(0);
      }
      input.radio_input:nth-of-type(2):checked ~ .select_slider .select_indicator {
        transform: translateX(var(--state-selector-step));
      }
      input.radio_input:nth-of-type(3):checked ~ .select_slider .select_indicator {
        transform: translateX(calc(var(--state-selector-step) * 2));
      }
      .select_slider::after {
        content: "";
        position: absolute;
        width: calc(var(--state-selector-size) + var(--state-selector-step));
        height: var(--state-selector-size);
        left: var(--state-selector-step);
        border-radius: calc(var(--state-selector-size) / 2);
        box-shadow: 0 0 3px rgba(0, 0, 0, 0.1), inset 0 0 6px rgba(0, 0, 0, 0.3);
        transition: transform 0.2s ease-in-out;
      }
      input.radio_input:nth-of-type(1):checked ~ .select_slider::after {
        transform: translateX(calc(0px - var(--state-selector-step)));
      }
    `;
    document.head.appendChild(style);
  }

  main();

})();

QingJ © 2025

镜像随时可能失效,请加Q群300939539或关注我们的公众号极客氢云获取最新地址