koishi-plugin-ets2-tools-tmp 3.3.65 → 3.4.0

package/lib/api/evmOpenApi.js

@@ -21,43 +21,19 @@ async function requestWithFallback(http, path) {
 module.exports = {
     /**
      * 查询服务器列表
+     * game: 'ETS2' 欧卡 / 'ATS' 美卡（接口 game 参数 1=欧卡 / 2=美卡，不传默认欧卡）
      */
     async serverList(http, game) {
+        const gameCode = game === 'ATS' ? 2 : 1
         let result = null
         try {
-            result = game === 'ATS'
-                ? await apiLog.get(http, 'evm.proxy.truckersmp.servers', `${BASE_APIS[0]}/proxy/truckersmp/servers`)
-                : await requestWithFallback(http, `/server/list`)
+            result = await requestWithFallback(http, `/server/list?game=${gameCode}`)
         } catch {
             return {
                 error: true
             }
         }
 
-        if (game === 'ATS') {
-            const servers = result?.response
-            const isError = result?.error === true || !Array.isArray(servers)
-            return {
-                error: isError,
-                ...(isError ? {} : {
-                    data: servers
-                        .filter(server => server.game === 'ATS')
-                        .map(server => ({
-                            serverName: server.name,
-                            isOnline: server.online ? 1 : 0,
-                            playerCount: server.players,
-                            maxPlayer: server.maxplayers,
-                            queueCount: server.queue || 0,
-                            afkEnable: server.afkenabled ? 1 : 0,
-                            collisionsEnable: server.collisions ? 1 : 0,
-                            policeCarEnable: server.policecarsforplayers ? 1 : 0,
-                            speedLimiterEnable: server.speedlimiter > 0 ? 1 : 0,
-                            playerHistory: []
-                        }))
-                })
-            }
-        }
-
         // 拼接返回数据
         let data = {
             error: result.code !== 200
@@ -181,11 +157,13 @@ module.exports = {
     },
     /**
      * 查询玩家历史数据
+     * @param game 可选，2=美卡（接口不传默认欧卡）
      */
-    async mapPlayerHistory(http, tmpId, serverId, startTime, endTime) {
+    async mapPlayerHistory(http, tmpId, serverId, startTime, endTime, game) {
         let result = null
         try {
-            result = await requestWithFallback(http, `/map/playerHistory?tmpId=${tmpId || ''}&serverId=${serverId || ''}&startTime=${startTime || ''}&endTime=${endTime || ''}`)
+            const gameParam = game ? `&game=${game}` : ''
+            result = await requestWithFallback(http, `/map/playerHistory?tmpId=${tmpId || ''}&serverId=${serverId || ''}&startTime=${startTime || ''}&endTime=${endTime || ''}${gameParam}`)
         } catch {
             return {
                 error: true

package/lib/api/truckyAppApi.js

@@ -27,11 +27,13 @@ module.exports = {
   },
   /**
    * 查询热门交通数据
+   * @param game 'ets2' 欧卡 / 'ats' 美卡
    */
-  async trafficTop (http, serverName) {
+  async trafficTop (http, serverName, game) {
+    const gameCode = game || 'ets2'
     let result = null
     try {
-      result = await apiLog.get(http, 'trucky.trafficTop', `${BASE_API}/v2/traffic/top?game=ets2&server=${serverName}`)
+      result = await apiLog.get(http, 'trucky.trafficTop', `${BASE_API}/v2/traffic/top?game=${gameCode}&server=${serverName}`)
     } catch {
       return {
         error: true

package/lib/command/tmpBind.js

@@ -2,7 +2,7 @@ const guildBind = require('../database/guildBind');
 const truckersMpApi = require("../api/truckersMpApi");
 const evmOpenApi = require('../api/evmOpenApi');
 /**
- * 绑定 TMP ID
+ * 绑定 TMP ID（支持绑定多个：追加入库，同一编号重复绑定会提示）
  */
 module.exports = async (ctx, cfg, session, tmpId) => {
     if (!tmpId || isNaN(tmpId)) {
@@ -13,7 +13,11 @@ module.exports = async (ctx, cfg, session, tmpId) => {
     if (playerInfo.error) {
         return '绑定失败 (查询玩家信息失败)';
     }
-    // 更新数据库
-    guildBind.saveOrUpdate(ctx.database, session.platform, session.userId, playerInfo.data.tmpId);
-    return `绑定成功 ( ${playerInfo.data.name} )`;
+    // 追加绑定（同一 tmpId 已绑定过则提示，不重复入库）
+    const result = await guildBind.add(ctx.database, session.platform, session.userId, playerInfo.data.tmpId, playerInfo.data.name);
+    if (result.exists) {
+        return `该编号已在绑定列表中 ( ${playerInfo.data.name} )，无需重复绑定`;
+    }
+    const count = (await guildBind.list(ctx.database, session.platform, session.userId)).length;
+    return `绑定成功 ( ${playerInfo.data.name} )，当前已绑定 ${count} 个编号`;
 };

package/lib/command/tmpFootprint.js

@@ -2,9 +2,10 @@ const { segment } = require('koishi')
 const dayjs = require('dayjs')
 const { resolve } = require('path')
 const common = require('../util/common')
-const { PromodsIds, ServerType } = require('../util/constant')
+const { PromodsIds, AtsIds, AtsFootprintStartDate, ServerType } = require('../util/constant')
 const evmOpenApi = require('../api/evmOpenApi')
 const guildBind = require('../database/guildBind')
+const tmpIdPicker = require('../util/tmpIdPicker')
 
 // 足迹统计数据的开始收集日期（仅用于近一年足迹图片中的提示展示）
 const FOOTPRINT_DATA_START_DATE = '2026-08-19'
@@ -81,13 +82,25 @@ module.exports = async (ctx, session, serverType, tmpId, date) => {
     return `请输入正确的玩家编号，或绑定玩家编号`
   }
 
-  // 如果没有传入tmpId，尝试从数据库查询绑定信息
+  // 如果没有传入tmpId，尝试从绑定记录获取（多绑定时会列出序号供选择，支持多选=发多张足迹图）
   if (!tmpId) {
-    let guildBindData = await guildBind.get(ctx.database, session.platform, session.userId)
-    if (!guildBindData) {
+    const bindings = await guildBind.list(ctx.database, session.platform, session.userId)
+    if (bindings.length === 0) {
       return `请输入正确的玩家编号，或绑定玩家编号`
     }
-    tmpId = guildBindData.tmp_id
+    const picked = await tmpIdPicker.pick(ctx, session, bindings)
+    if (picked === null) {
+      return // 已列出序号等待用户回复
+    }
+    if (picked.length > 1) {
+      const results = []
+      for (const id of picked) {
+        const r = await module.exports(ctx, session, serverType, id, date)
+        if (r != null) results.push(r)
+      }
+      return results.length === 1 ? results[0] : results
+    }
+    tmpId = picked[0]
   }
 
   // 查询玩家信息
@@ -131,16 +144,23 @@ module.exports = async (ctx, session, serverType, tmpId, date) => {
     return '日期传递错误';
   }
 
-  let mapPlayerHistory = await evmOpenApi.mapPlayerHistory(ctx.http, tmpId, null, startTime, endTime)
+  // 是否为美卡足迹（决定历史接口的 game 参数与过滤规则）
+  const isAts = ServerType.ats === serverType
+  // 查询美卡历史需要显式传 game=2（不传默认欧卡，欧卡/Promods 维持原样）
+  let mapPlayerHistory = await evmOpenApi.mapPlayerHistory(ctx.http, tmpId, null, startTime, endTime, isAts ? 2 : undefined)
   if (mapPlayerHistory.error) {
     return '查询玩家历史位置数据失败，请稍后重试'
   }
 
   // 过滤非对应服务器数据（单次遍历统计轨迹范围与有效点数，避免百万级数据产生额外数组拷贝）
   const promodsIdSet = new Set(PromodsIds)
+  const atsIdSet = new Set(AtsIds)
   const isTargetServer = item => {
-    if (ServerType.ets === serverType) {
-      return !promodsIdSet.has(item.serverId)
+    if (isAts) {
+      return atsIdSet.has(item.serverId)
+    } else if (ServerType.ets === serverType) {
+      // 欧卡：排除 Promods 与美卡的服务器
+      return !promodsIdSet.has(item.serverId) && !atsIdSet.has(item.serverId)
     } else if (ServerType.promods === serverType) {
       return promodsIdSet.has(item.serverId)
     }
@@ -191,16 +211,19 @@ module.exports = async (ctx, session, serverType, tmpId, date) => {
 
   // 拼接数据（今日足迹展示今日里程；其余展示该区间里程（distance 累加）与玩家总里程）
   const isToday = date === 'today'
+  const rangeTextMap = { today: '今日', yesterday: '昨日', sevenday: '近七日', month: '近一个月', year: '近一年' }[date] || ''
   let data = {
-    mapType: ServerType.promods === serverType ? 'promods' : 'ets',
+    mapType: isAts ? 'ats' : (ServerType.promods === serverType ? 'promods' : 'ets'),
     name: playerInfo.data.name,
     smallAvatarUrl: playerInfo.data.smallAvatarUrl,
-    rangeText: { today: '今日', yesterday: '昨日', sevenday: '近七日', month: '近一个月', year: '近一年' }[date] || '',
+    rangeText: isAts ? `${rangeTextMap}（美卡）` : rangeTextMap,
     isToday,
     mileageLabel: isToday ? '今日里程' : '该区间里程',
     mileage: isToday ? playerInfo.data.todayMileage : intervalDistance,
     totalMileage: isToday ? null : playerInfo.data.mileage,
-    dataStartDate: date === 'year' ? FOOTPRINT_DATA_START_DATE : null,
+    etsMileage: isToday ? null : playerInfo.data.mileageEts2,
+    atsMileage: isToday ? null : playerInfo.data.mileageAts,
+    dataStartDate: date === 'year' ? (isAts ? AtsFootprintStartDate : FOOTPRINT_DATA_START_DATE) : null,
     segments
   }
 

package/lib/command/tmpMileageRanking.js

@@ -3,6 +3,7 @@ const { resolve } = require('path');
 const common = require('../util/common');
 const evmOpenApi = require('../api/evmOpenApi');
 const guildBind = require('../database/guildBind');
+const tmpIdPicker = require('../util/tmpIdPicker');
 module.exports = async (ctx, session, rankingType) => {
     if (!ctx.puppeteer) {
         return '未启用 Puppeteer 功能';
@@ -15,11 +16,21 @@ module.exports = async (ctx, session, rankingType) => {
     else if (mileageRankingList.data.length === 0) {
         return '暂无数据';
     }
-    // 查询当前玩家的排行信息
-    let guildBindData = await guildBind.get(ctx.database, session.platform, session.userId);
+    // 查询当前玩家的排行信息（多绑定时先单选一个，排行榜只高亮一个人）
+    const bindings = await guildBind.list(ctx.database, session.platform, session.userId);
+    let bindTmpId = null;
+    if (bindings.length === 1) {
+        bindTmpId = String(bindings[0].tmp_id);
+    } else if (bindings.length > 1) {
+        const picked = await tmpIdPicker.pick(ctx, session, bindings, { allowMulti: false });
+        if (picked === null) {
+            return; // 已列出序号等待用户回复
+        }
+        bindTmpId = picked[0];
+    }
     let playerMileageRanking = null;
-    if (guildBindData) {
-        let playerMileageRankingResult = await evmOpenApi.mileageRankingList(ctx.http, rankingType, guildBindData.tmp_id);
+    if (bindTmpId) {
+        let playerMileageRankingResult = await evmOpenApi.mileageRankingList(ctx.http, rankingType, bindTmpId);
         if (!playerMileageRankingResult.error && playerMileageRankingResult.data.length > 0) {
             playerMileageRanking = playerMileageRankingResult.data[0];
         }

package/lib/command/tmpPosition.js

@@ -1,6 +1,7 @@
 const { segment } = require('koishi')
 const { resolve } = require('path')
 const guildBind = require('../database/guildBind')
+const tmpIdPicker = require('../util/tmpIdPicker')
 const truckyAppApi = require('../api/truckyAppApi')
 const truckersMpApi = require('../api/truckersMpApi')
 const evmOpenApi = require('../api/evmOpenApi')
@@ -32,13 +33,25 @@ module.exports = async (ctx, cfg, session, tmpId) => {
         }
         tmpId = guildBindData.tmp_id;
     }
-    // 如果没有传入tmpId，尝试从数据库查询绑定信息
+    // 如果没有传入tmpId，尝试从绑定记录获取（多绑定时会列出序号供选择，支持多选=发多张定位图）
     if (!tmpId) {
-      let guildBindData = await guildBind.get(ctx.database, session.platform, session.userId)
-      if (!guildBindData) {
+      const bindings = await guildBind.list(ctx.database, session.platform, session.userId)
+      if (bindings.length === 0) {
         return `请输入正确的玩家编号`
       }
-      tmpId = guildBindData.tmp_id
+      const picked = await tmpIdPicker.pick(ctx, session, bindings)
+      if (picked === null) {
+        return // 已列出序号等待用户回复
+      }
+      if (picked.length > 1) {
+        const results = []
+        for (const id of picked) {
+          const r = await module.exports(ctx, cfg, session, id)
+          if (r != null) results.push(r)
+        }
+        return results.length === 1 ? results[0] : results
+      }
+      tmpId = picked[0]
     }
 
     // 查询玩家信息

package/lib/command/tmpQuery/tmpQueryImg.js

@@ -2,6 +2,7 @@ const dayjs = require('dayjs');
 const dayjsRelativeTime = require('dayjs/plugin/relativeTime');
 const dayjsLocaleZhCn = require('dayjs/locale/zh-cn');
 const guildBind = require('../../database/guildBind');
+const tmpIdPicker = require('../../util/tmpIdPicker');
 const truckyAppApi = require('../../api/truckyAppApi');
 const evmOpenApi = require('../../api/evmOpenApi');
 const baiduTranslate = require('../../util/baiduTranslate');
@@ -80,13 +81,25 @@ module.exports = async (ctx, cfg, session, tmpId) => {
         }
         tmpId = guildBindData.tmp_id;
     }
-    // 如果没有传入tmpId，尝试从数据库查询绑定信息
+    // 如果没有传入tmpId，尝试从绑定记录获取（多绑定时会列出序号供选择，支持多选）
     if (!tmpId) {
-        let guildBindData = await guildBind.get(ctx.database, session.platform, session.userId);
-        if (!guildBindData) {
+        const bindings = await guildBind.list(ctx.database, session.platform, session.userId);
+        if (bindings.length === 0) {
             return `请输入正确的玩家编号`;
         }
-        tmpId = guildBindData.tmp_id;
+        const picked = await tmpIdPicker.pick(ctx, session, bindings);
+        if (picked === null) {
+            return; // 已列出序号等待用户回复
+        }
+        if (picked.length > 1) {
+            const results = [];
+            for (const id of picked) {
+                const r = await module.exports(ctx, cfg, session, id);
+                if (r != null) results.push(r);
+            }
+            return results.length === 1 ? results[0] : results;
+        }
+        tmpId = picked[0];
     }
     // 并行请求玩家信息与线上状态（互不依赖，避免串行等待）
     const [playerInfo, playerMapInfo] = await Promise.all([
@@ -176,8 +189,13 @@ module.exports = async (ctx, cfg, session, tmpId) => {
     data.sponsorAmount = playerInfo.data.sponsorAmount;
     data.sponsorCumulativeAmount = playerInfo.data.sponsorCumulativeAmount;
     data.sponsorHide = playerInfo.data.sponsorHide;
+    // 里程：mileage/todayMileage 为欧卡+美卡合计，另附两款游戏的单独里程
     data.mileage = playerInfo.data.mileage;
     data.todayMileage = playerInfo.data.todayMileage;
+    data.mileageEts2 = playerInfo.data.mileageEts2;
+    data.mileageAts = playerInfo.data.mileageAts;
+    data.todayMileageEts2 = playerInfo.data.todayMileageEts2;
+    data.todayMileageAts = playerInfo.data.todayMileageAts;
     data.isOnline = false;
     data.onlineStatus = '离线';
     if (playerMapInfo && !playerMapInfo.error) {

package/lib/command/tmpQuery/tmpQueryText.js

@@ -2,11 +2,38 @@ const dayjs = require('dayjs');
 const dayjsRelativeTime = require('dayjs/plugin/relativeTime');
 const dayjsLocaleZhCn = require('dayjs/locale/zh-cn');
 const guildBind = require('../../database/guildBind');
+const tmpIdPicker = require('../../util/tmpIdPicker');
 const truckyAppApi = require('../../api/truckyAppApi');
 const evmOpenApi = require('../../api/evmOpenApi');
 const baiduTranslate = require('../../util/baiduTranslate');
 dayjs.extend(dayjsRelativeTime);
 dayjs.locale(dayjsLocaleZhCn);
+
+/**
+ * 里程文本：>=1000 米换算成公里；0 显示成「0公里」（表示这款游戏没跑过）
+ */
+function formatMileageText(value) {
+    const n = Number(value) || 0;
+    if (n <= 0) {
+        return '0公里';
+    }
+    if (n >= 1000) {
+        return Number((n / 1000).toFixed(1)).toLocaleString('en-US') + '公里';
+    }
+    return n + '米';
+}
+
+/**
+ * 欧卡/美卡里程明细文本（两者都为 0 时返回空串）
+ */
+function formatMileageDetail(ets2, ats) {
+    const ets2Val = Number(ets2) || 0;
+    const atsVal = Number(ats) || 0;
+    if (ets2Val <= 0 && atsVal <= 0) {
+        return '';
+    }
+    return ` (欧卡 ${formatMileageText(ets2Val)} / 美卡 ${formatMileageText(atsVal)})`;
+}
 /**
  * 用户组
  */
@@ -43,13 +70,25 @@ module.exports = async (ctx, cfg, session, tmpId) => {
         }
         tmpId = guildBindData.tmp_id;
     }
-    // 如果没有传入tmpId，尝试从数据库查询绑定信息
+    // 如果没有传入tmpId，尝试从绑定记录获取（多绑定时会列出序号供选择，支持多选）
     if (!tmpId) {
-        let guildBindData = await guildBind.get(ctx.database, session.platform, session.userId);
-        if (!guildBindData) {
+        const bindings = await guildBind.list(ctx.database, session.platform, session.userId);
+        if (bindings.length === 0) {
             return `请输入正确的玩家编号`;
         }
-        tmpId = guildBindData.tmp_id;
+        const picked = await tmpIdPicker.pick(ctx, session, bindings);
+        if (picked === null) {
+            return; // 已列出序号等待用户回复
+        }
+        if (picked.length > 1) {
+            const results = [];
+            for (const id of picked) {
+                const r = await module.exports(ctx, cfg, session, id);
+                if (r != null) results.push(r);
+            }
+            return results.length === 1 ? results[0] : results;
+        }
+        tmpId = picked[0];
     }
     // 并行请求玩家信息与线上状态（互不依赖，避免串行等待）
     const [playerInfo, playerMapInfo] = await Promise.all([
@@ -139,23 +178,14 @@ module.exports = async (ctx, cfg, session, tmpId) => {
         }
     }
     message += '\n🚫封禁次数: ' + (playerInfo.data.banCount || 0);
+    // 历史/今日里程为欧卡+美卡合计，后面附上两款游戏的单独里程
     if (playerInfo.data.mileage) {
-        let mileage = playerInfo.data.mileage;
-        let mileageUnit = '米';
-        if (mileage > 1000) {
-            mileage = (mileage / 1000).toFixed(1);
-            mileageUnit = '公里';
-        }
-        message += '\n\n🚩历史里程: ' + mileage + mileageUnit;
+        message += '\n\n🚩历史里程: ' + formatMileageText(playerInfo.data.mileage)
+            + formatMileageDetail(playerInfo.data.mileageEts2, playerInfo.data.mileageAts);
     }
     if (playerInfo.data.todayMileage) {
-        let todayMileage = playerInfo.data.todayMileage;
-        let mileageUnit = '米';
-        if (todayMileage > 1000) {
-            todayMileage = (todayMileage / 1000).toFixed(1);
-            mileageUnit = '公里';
-        }
-        message += '\n🚩今日里程: ' + todayMileage + mileageUnit;
+        message += '\n🚩今日里程: ' + formatMileageText(playerInfo.data.todayMileage)
+            + formatMileageDetail(playerInfo.data.todayMileageEts2, playerInfo.data.todayMileageAts);
     }
     if (playerMapInfo && !playerMapInfo.error) {
         message += '\n📶在线状态: ' + (playerMapInfo.data.online ? `在线🟢 (${playerMapInfo.data.serverDetails.name})` : '离线⚫');

package/lib/command/tmpTraffic/tmpTrafficMap.js

@@ -1,5 +1,6 @@
 const truckyAppApi = require('../../api/truckyAppApi');
 const evmOpenApi = require('../../api/evmOpenApi');
+const truckersMpMapApi = require('../../api/truckersMpMapApi');
 const baiduTranslate = require('../../util/baiduTranslate');
 const { resolve } = require("path");
 const common = require("../../util/common");
@@ -31,6 +32,28 @@ const serverAlias = {
         mapType: 'ets',
         serverId: 7,
         bounds: [[-94189, 93775], [79264, -78999]]
+    },
+    // 美卡：evm 的 /map/playerList 没有美卡数据，玩家位置改走 ets2map tracker（坐标同为游戏坐标）
+    '美s': {
+        name: 'eusim',
+        game: 'ats',
+        mapType: 'ats',
+        serverId: 8,
+        bounds: [[-122000, 100000], [39000, -88000]]
+    },
+    '美uss': {
+        name: 'ussim',
+        game: 'ats',
+        mapType: 'ats',
+        serverId: 10,
+        bounds: [[-122000, 100000], [39000, -88000]]
+    },
+    '美usa': {
+        name: 'usarc',
+        game: 'ats',
+        mapType: 'ats',
+        serverId: 45,
+        bounds: [[-122000, 100000], [39000, -88000]]
     }
 };
 /**
@@ -72,24 +95,42 @@ module.exports = async (ctx, cfg, serverName) => {
     // 根据别名获取服务器信息
     let serverInfo = serverAlias[serverName];
     if (!serverInfo) {
-        return '请输入正确的服务器名称 (s1, s2, p, a)';
+        return '请输入正确的服务器名称 (s1, s2, p, a, 美s, 美uss, 美usa)';
     }
     // 查询路况信息
-    let trafficData = await truckyAppApi.trafficTop(ctx.http, serverInfo.name);
+    let trafficData = await truckyAppApi.trafficTop(ctx.http, serverInfo.name, serverInfo.game);
     if (trafficData.error) {
         return '查询路况信息失败';
     }
-    // 查询地图玩家数据
-    let mapData = await evmOpenApi.mapPlayerList(ctx.http, serverInfo.serverId, serverInfo.bounds[0][0], serverInfo.bounds[0][1], serverInfo.bounds[1][0], serverInfo.bounds[1][1]);
+    // 查询地图玩家数据（美卡走 ets2map tracker，欧卡/Promods 走 evm）
+    let mapData;
+    if (serverInfo.game === 'ats') {
+        mapData = await truckersMpMapApi.area(ctx.http, serverInfo.serverId,
+            serverInfo.bounds[0][0], serverInfo.bounds[0][1], serverInfo.bounds[1][0], serverInfo.bounds[1][1]);
+    } else {
+        mapData = await evmOpenApi.mapPlayerList(ctx.http, serverInfo.serverId,
+            serverInfo.bounds[0][0], serverInfo.bounds[0][1], serverInfo.bounds[1][0], serverInfo.bounds[1][1]);
+    }
+    // 两个接口的坐标字段名不同：tracker 为 X/Y，evm 为 axisX/axisY（数值都是游戏坐标）
+    const coordOf = serverInfo.game === 'ats'
+        ? (item => [item.X, item.Y])
+        : (item => [item.axisX, item.axisY]);
+    // 接口失败或返回异常时用空数组兜底，避免对 undefined 调 map 导致指令崩溃
+    const playerCoordinateList = (!mapData.error && Array.isArray(mapData.data))
+        ? mapData.data.map(coordOf)
+        : [];
 
     switch (serverName) {
         case 's1':
         case 's2':
-        case 'a': {
+        case 'a':
+        case '美s':
+        case '美uss':
+        case '美usa': {
             let data = {
                 mapType: serverInfo.mapType,
                 trafficList: [],
-                playerCoordinateList: mapData.error && mapData.data ? [] : mapData.data.map(item => [item.axisX, item.axisY])
+                playerCoordinateList
             };
             for (const traffic of trafficData.data) {
                 data.trafficList.push({
@@ -126,7 +167,7 @@ module.exports = async (ctx, cfg, serverName) => {
             let data = {
                 mapType: serverInfo.mapType,
                 trafficList: [],
-                playerCoordinateList: mapData.error && mapData.data ? [] : mapData.data.map(item => [item.axisX, item.axisY])
+                playerCoordinateList
             };
             for (const traffic of trafficData.data) {
                 data.trafficList.push({

package/lib/command/tmpTraffic/tmpTrafficText.js

@@ -11,7 +11,19 @@ const serverNameAlias = {
     'S1': 'sim1',
     'S2': 'sim2',
     'P': 'eupromods1',
-    'A': 'arc1'
+    'A': 'arc1',
+    // 美卡（Trucky 的美卡服务器代号：eusim/ussim/usarc）
+    '美s': 'eusim',
+    '美uss': 'ussim',
+    '美usa': 'usarc'
+};
+/**
+ * 别名对应的车队游戏（路况接口的 game 参数）
+ */
+const aliasGame = {
+    '美s': 'ats',
+    '美uss': 'ats',
+    '美usa': 'ats'
 };
 /**
  * 路况程度转中文
@@ -36,9 +48,9 @@ const typeToZh = {
 module.exports = async (ctx, cfg, serverName) => {
     let serverQueryName = serverNameAlias[serverName];
     if (!serverQueryName) {
-        return '请输入正确的服务器名称 (s1, s2, p, a)';
+        return '请输入正确的服务器名称 (s1, s2, p, a, 美s, 美uss, 美usa)';
     }
-    let trafficData = await truckyAppApi.trafficTop(ctx.http, serverQueryName);
+    let trafficData = await truckyAppApi.trafficTop(ctx.http, serverQueryName, aliasGame[serverName]);
     if (trafficData.error) {
         return '查询路况信息失败';
     }

package/lib/command/tmpVtcMileageRanking.js

@@ -3,6 +3,7 @@ const { resolve } = require('path');
 const common = require('../util/common');
 const evmOpenApi = require('../api/evmOpenApi');
 const guildBind = require('../database/guildBind');
+const tmpIdPicker = require('../util/tmpIdPicker');
 module.exports = async (ctx, cfg, session, rankingType) => {
     if (!ctx.puppeteer) {
         return '未启用 Puppeteer 功能';
@@ -19,11 +20,21 @@ module.exports = async (ctx, cfg, session, rankingType) => {
     else if (mileageRankingList.data.length === 0) {
         return '暂无数据';
     }
-    // 从排行榜中查找当前玩家的排行信息
-    let guildBindData = await guildBind.get(ctx.database, session.platform, session.userId);
+    // 从排行榜中查找当前玩家的排行信息（多绑定时先单选一个，排行榜只高亮一个人）
+    const bindings = await guildBind.list(ctx.database, session.platform, session.userId);
+    let bindTmpId = null;
+    if (bindings.length === 1) {
+        bindTmpId = String(bindings[0].tmp_id);
+    } else if (bindings.length > 1) {
+        const picked = await tmpIdPicker.pick(ctx, session, bindings, { allowMulti: false });
+        if (picked === null) {
+            return; // 已列出序号等待用户回复
+        }
+        bindTmpId = picked[0];
+    }
     let playerMileageRanking = null;
-    if (guildBindData) {
-        playerMileageRanking = mileageRankingList.data.find(p => p.tmpId == guildBindData.tmp_id) || null;
+    if (bindTmpId) {
+        playerMileageRanking = mileageRankingList.data.find(p => p.tmpId == bindTmpId) || null;
     }
     // 拼接页面数据
     let data = {

package/lib/database/guildBind.js

@@ -1,6 +1,11 @@
+/**
+ * TMP ID 绑定（支持一人绑定多个）
+ * 表 tmp_guild_bind：一个绑定一行，同一 (platform, user_id) 可有多行；
+ * get() 返回第一行（默认绑定），保持与旧版行为兼容。
+ */
 module.exports = {
     /**
-     * 获取绑定信息
+     * 获取默认绑定（第一行，兼容旧逻辑）
      * @param db 数据源
      * @param platform 平台
      * @param userId 用户编号
@@ -16,26 +21,52 @@ module.exports = {
         return null;
     },
     /**
-     * 新增或更新绑定信息
-     * @param db 数据源
-     * @param platform 平台
-     * @param userId 用户编号
+     * 获取全部绑定（按绑定先后排序）
+     * @returns 绑定行数组，可能为空数组
+     */
+    async list(db, platform, userId) {
+        const guildBindList = await db.get('tmp_guild_bind', {
+            platform,
+            user_id: userId
+        });
+        if (!guildBindList || guildBindList.length === 0) {
+            return [];
+        }
+        return guildBindList.sort((a, b) => a.id - b.id);
+    },
+    /**
+     * 追加绑定（同一 tmpId 重复绑定时不会重复入库）
      * @param tmpId TMP ID
+     * @param tmpName TMP 玩家名称（用于多绑定列表展示，可为 null）
+     * @returns { exists, row } exists=true 表示该 tmpId 已绑定过
      */
-    saveOrUpdate(db, platform, userId, tmpId) {
-        this.get(db, platform, userId).then((data) => {
-            if (data) {
-                db.set('tmp_guild_bind', data.id, {
-                    tmp_id: tmpId
-                });
-            }
-            else {
-                db.create('tmp_guild_bind', {
-                    platform: platform,
-                    user_id: userId,
-                    tmp_id: tmpId
-                });
-            }
+    async add(db, platform, userId, tmpId, tmpName) {
+        const guildBindList = await this.list(db, platform, userId);
+        const existed = guildBindList.find(row => String(row.tmp_id) === String(tmpId));
+        if (existed) {
+            return { exists: true, row: existed };
+        }
+        const row = await db.create('tmp_guild_bind', {
+            platform: platform,
+            user_id: userId,
+            tmp_id: tmpId,
+            tmp_name: tmpName || null
+        });
+        return { exists: false, row };
+    },
+    /**
+     * 删除指定主键的绑定
+     */
+    async remove(db, id) {
+        await db.remove('tmp_guild_bind', id);
+    },
+    /**
+     * 删除指定用户的全部绑定
+     */
+    async removeAll(db, platform, userId) {
+        await db.remove('tmp_guild_bind', {
+            platform,
+            user_id: userId
         });
     }
 };

package/lib/database/model.js

@@ -26,6 +26,12 @@ const modelArray = {
             length: 50,
             nullable: false,
             comment: 'TMP ID'
+        },
+        tmp_name: {
+            type: 'string',
+            length: 100,
+            nullable: true,
+            comment: 'TMP玩家名称（绑定时记录，用于多绑定列表展示）'
         }
     },
     tmp_translate_cache: {

package/lib/index.js

@@ -8,6 +8,7 @@ const model = require('./database/model');
 const { ServerType } = require('./util/constant');
 const { MileageRankingType } = require('./util/constant');
 const { LeadRoleCallMessage, LeadRoleCallTime } = require('./util/constant');
+const tmpIdPicker = require('./util/tmpIdPicker');
 
 const commands = {
     tmpQuery: require('./command/tmpQuery/tmpQuery'),
@@ -258,8 +259,44 @@ function registerBaseCommands(ctx, cfg) {
 
     if (cfg.commands?.tmpQuery) {
         ctx.command('绑定 <tmpId>')
-            .usage("绑定TmpId")
+            .usage("绑定TmpId（可绑定多个，查询时会列出序号供选择）")
             .action(async ({ session }, tmpId) => await commands.tmpBind(ctx, cfg, session, tmpId));
+
+        ctx.command('我的绑定')
+            .usage("查看已绑定的全部TMP编号")
+            .action(async ({ session }) => {
+                const bindings = await guildBind.list(ctx.database, session.platform, session.userId);
+                if (bindings.length === 0) {
+                    return '还没有绑定编号，使用「绑定 tmpId」添加';
+                }
+                const lines = bindings.map((b, i) => `${i + 1}. ${b.tmp_name || '未知'} (${b.tmp_id})`);
+                return `已绑定 ${bindings.length} 个编号：\n${lines.join('\n')}${bindings.length > 1 ? '\n查询时会列出序号供选择；使用「解绑 序号」可删除' : ''}`;
+            });
+
+        ctx.command('解绑 <index:string>')
+            .usage("删除已绑定的编号（序号见「我的绑定」，all 为全部删除）")
+            .example("解绑 2")
+            .example("解绑 all")
+            .action(async ({ session }, index) => {
+                const bindings = await guildBind.list(ctx.database, session.platform, session.userId);
+                if (bindings.length === 0) {
+                    return '还没有绑定编号';
+                }
+                if (!index) {
+                    return '请输入要解绑的序号或 all（序号见「我的绑定」）';
+                }
+                if (/^all$/i.test(index.trim())) {
+                    await guildBind.removeAll(ctx.database, session.platform, session.userId);
+                    return `已删除全部 ${bindings.length} 个绑定`;
+                }
+                const idx = parseInt(index, 10);
+                if (isNaN(idx) || idx < 1 || idx > bindings.length) {
+                    return `序号无效，可用范围 1-${bindings.length}（序号见「我的绑定」）`;
+                }
+                const row = bindings[idx - 1];
+                await guildBind.remove(ctx.database, row.id);
+                return `已解绑 ${idx}. ${row.tmp_name || '未知'} (${row.tmp_id})`;
+            });
     }
 
     if (cfg.commands?.tmpTraffic) {
@@ -338,6 +375,36 @@ function registerBaseCommands(ctx, cfg) {
             .example("近一年足迹p 12345")
             .action(async ({ session }, tmpId) => await commands.tmpFootprint(ctx, session, ServerType.promods, tmpId, 'year'));
 
+        ctx.command('近一年足迹美 [tmpId:string]')
+            .usage("查询美卡(ATS)服务器足迹")
+            .example("近一年足迹美")
+            .example("近一年足迹美 12345")
+            .action(async ({ session }, tmpId) => await commands.tmpFootprint(ctx, session, ServerType.ats, tmpId, 'year'));
+
+        ctx.command('近一个月足迹美 [tmpId:string]')
+            .usage("查询美卡(ATS)服务器足迹")
+            .example("近一个月足迹美")
+            .example("近一个月足迹美 12345")
+            .action(async ({ session }, tmpId) => await commands.tmpFootprint(ctx, session, ServerType.ats, tmpId, 'month'));
+
+        ctx.command('近七日足迹美 [tmpId:string]')
+            .usage("查询美卡(ATS)服务器足迹")
+            .example("近七日足迹美")
+            .example("近七日足迹美 12345")
+            .action(async ({ session }, tmpId) => await commands.tmpFootprint(ctx, session, ServerType.ats, tmpId, 'sevenday'));
+
+        ctx.command('昨日足迹美 [tmpId:string]')
+            .usage("查询美卡(ATS)服务器足迹")
+            .example("昨日足迹美")
+            .example("昨日足迹美 12345")
+            .action(async ({ session }, tmpId) => await commands.tmpFootprint(ctx, session, ServerType.ats, tmpId, 'yesterday'));
+
+        ctx.command('今日足迹美 [tmpId:string]')
+            .usage("查询美卡(ATS)服务器今日足迹")
+            .example("今日足迹美")
+            .example("今日足迹美 12345")
+            .action(async ({ session }, tmpId) => await commands.tmpFootprint(ctx, session, ServerType.ats, tmpId, 'today'));
+
         ctx.command('近一个月足迹 [tmpId:string]')
             .usage("查询ETS服务器今日足迹")
             .example("近一个月足迹")
@@ -419,6 +486,9 @@ function apply(ctx, cfg) {
     // 初始化 API 请求日志（调试模式开启后，truckersmp/trucky 等接口会输出请求与错误日志）
     apiLog.init(ctx, cfg.debugMode, cfg.apiRetryCount);
 
+    // 多绑定选择器中间件（捕获用户回复的序号，完成"列出绑定→序号选择"交互）
+    tmpIdPicker.register(ctx);
+
     try {
         model(ctx);
         if (cfg.debugMode) {

package/lib/resource/footprint.html

@@ -98,8 +98,8 @@
       z-index: 1001;
       display: flex;
       align-items: center;
-      gap: 18px;
-      padding: 11px 20px;
+      gap: 12px;
+      padding: 10px 16px;
       border-radius: 14px;
       box-sizing: border-box;
     }
@@ -107,16 +107,17 @@
       display: flex;
       flex-direction: column;
       gap: 2px;
-      min-width: 110px;
     }
     .mileage-block .label {
-      font-size: 11px;
-      letter-spacing: 2px;
+      font-size: 10px;
+      letter-spacing: 1.5px;
       color: #8fa3c8;
+      white-space: nowrap;
     }
     .mileage-block .value {
-      font-size: 21px;
+      font-size: 18px;
       font-weight: 800;
+      white-space: nowrap;
       background: linear-gradient(90deg, #4ade80, #a3e635);
       -webkit-background-clip: text;
       background-clip: text;
@@ -136,14 +137,15 @@
     .legend {
       display: flex;
       align-items: center;
-      gap: 14px;
+      gap: 10px;
     }
     .legend .item {
       display: flex;
       align-items: center;
-      gap: 6px;
-      font-size: 11.5px;
+      gap: 5px;
+      font-size: 10.5px;
       color: #9fb3d9;
+      white-space: nowrap;
     }
     .legend .line-sample {
       width: 20px;
@@ -165,13 +167,15 @@
     /* 数据说明（近一年足迹时显示统计开始日期） */
     .note {
       margin-left: auto;
-      font-size: 11px;
+      font-size: 10.5px;
       color: #fcd34d;
       background: rgba(251, 191, 36, .1);
       border: 1px solid rgba(251, 191, 36, .32);
-      padding: 5px 12px;
+      padding: 4px 10px;
       border-radius: 8px;
       letter-spacing: .5px;
+      white-space: nowrap;
+      flex-shrink: 0;
     }
     .hidden { display: none; }
   </style>
@@ -201,6 +205,11 @@
         <span class="label">总里程</span>
         <span class="value" id="total-distance">0.0 km</span>
       </div>
+      <div class="v-divider" id="game-mileage-divider"></div>
+      <div class="mileage-block" id="game-mileage-block">
+        <span class="label" id="game-mileage-label">欧卡总里程</span>
+        <span class="value" id="game-mileage-distance">0.0 km</span>
+      </div>
       <div class="v-divider"></div>
       <div class="legend">
         <div class="item"><span class="line-sample"></span>行驶轨迹</div>
@@ -233,10 +242,24 @@
         document.getElementById('distance').classList.add('cyan');
         const totalKm = Number(((data.totalMileage || 0) / 1000).toFixed(1)).toLocaleString('zh-CN');
         document.getElementById('total-distance').innerText = `${totalKm} km`;
+        // 本游戏总里程：美卡足迹显示美卡总里程，欧卡/Promods 足迹显示欧卡总里程
+        const gameBlock = document.getElementById('game-mileage-block');
+        const gameDivider = document.getElementById('game-mileage-divider');
+        const gameValue = data.mapType === 'ats' ? data.atsMileage : data.etsMileage;
+        if (gameValue != null) {
+          document.getElementById('game-mileage-label').innerText = data.mapType === 'ats' ? '美卡总里程' : '欧卡总里程';
+          const gameKm = Number((gameValue / 1000).toFixed(1)).toLocaleString('zh-CN');
+          document.getElementById('game-mileage-distance').innerText = `${gameKm} km`;
+        } else {
+          gameBlock.classList.add('hidden');
+          gameDivider.classList.add('hidden');
+        }
       } else {
         // 今日足迹不显示总里程块
         document.getElementById('total-mileage-block').classList.add('hidden');
         document.getElementById('total-divider').classList.add('hidden');
+        document.getElementById('game-mileage-block').classList.add('hidden');
+        document.getElementById('game-mileage-divider').classList.add('hidden');
       }
 
       // 近一年足迹显示统计开始日期

package/lib/resource/package/ets-map.js

@@ -50,6 +50,29 @@ let mapConfig = {
         y / 2.598541 + mapConfig.promods.multipliers.y
       ]
     }
+  },
+  // 美卡（ATS）：换算参数来自瓦片导出配置 TileMapInfo.json
+  // （游戏坐标 x∈[-120098.891, 41144.094] y∈[-79127.37, 82115.62] 线性铺满 131072 网格）
+  ats: {
+    tileUrl: 'https://ets_tiles.cnly.top/20260903/tmp-ats-yellow/Tiles/{z}/{x}/{y}.png',
+    multipliers: {
+      x: 97626.58,
+      y: 64321.45
+    },
+    breakpoints: {},
+    bounds: {
+      y: 131072,
+      x: 131072
+    },
+    maxZoom: 8,
+    minZoom: 0,
+    // 游戏地转地图坐标
+    calculateMapCoordinate (x, y) {
+      return [
+        x / 1.230185 + mapConfig.ats.multipliers.x,
+        y / 1.230185 + mapConfig.ats.multipliers.y
+      ];
+    }
   }
 }
 

package/lib/resource/query.html

@@ -505,6 +505,47 @@
       --acc-tint: rgba(52, 211, 153, 0.06);
     }
 
+    /* 里程明细（欧卡/美卡）：一行两个小格，与遥测网格同一套视觉 */
+    .mini-grid {
+      display: grid;
+      gap: 6px 8px;
+      margin-top: 6px;
+      position: relative;
+      z-index: 1;
+    }
+
+    .mini-grid.cols-2 {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+
+    .mini-cell {
+      min-width: 0;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 8px;
+      min-height: 26px;
+      padding: 4px 9px;
+      border-radius: var(--r-sm);
+      background: rgba(255, 255, 255, 0.04);
+      border: 1px solid rgba(255, 255, 255, 0.06);
+      box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05);
+    }
+
+    .mini-k {
+      font-size: 11px;
+      color: var(--t2);
+      white-space: nowrap;
+    }
+
+    .mini-v {
+      font-size: 12.5px;
+      font-weight: 600;
+      color: var(--t1);
+      text-align: right;
+      font-variant-numeric: tabular-nums;
+    }
+
     /* ===== GLASS BAR ===== */
     .glass-bar {
       margin: 11px 14px;
@@ -922,13 +963,33 @@
     <div class="section mileage-section" id="mileage-section" style="display:none;">
       <div class="section-title">🚩 里程信息</div>
       <div class="info-row" id="mileage-row" style="display:none;">
-        <div class="info-label">🚩 历史里程</div>
+        <div class="info-label">🚩 总里程</div>
         <div class="info-value" id="tmp-mileage"></div>
       </div>
+      <div class="mini-grid cols-2" id="mileage-detail" style="display:none;">
+        <div class="mini-cell">
+          <span class="mini-k">欧卡</span>
+          <span class="mini-v" id="tmp-mileage-ets2"></span>
+        </div>
+        <div class="mini-cell">
+          <span class="mini-k">美卡</span>
+          <span class="mini-v" id="tmp-mileage-ats"></span>
+        </div>
+      </div>
       <div class="info-row" id="today-mileage-row" style="display:none;">
         <div class="info-label">🚩 今日里程</div>
         <div class="info-value" id="tmp-today-mileage"></div>
       </div>
+      <div class="mini-grid cols-2" id="today-mileage-detail" style="display:none;">
+        <div class="mini-cell">
+          <span class="mini-k">欧卡</span>
+          <span class="mini-v" id="tmp-today-mileage-ets2"></span>
+        </div>
+        <div class="mini-cell">
+          <span class="mini-k">美卡</span>
+          <span class="mini-v" id="tmp-today-mileage-ats"></span>
+        </div>
+      </div>
     </div>
 
     <!-- Game Time Section -->
@@ -990,10 +1051,24 @@
 
     function formatMileage(val) {
       if (!val) return null;
-      if (val > 1000) return (val / 1000).toFixed(1) + ' 公里';
+      if (val > 1000) return Number((val / 1000).toFixed(1)).toLocaleString('en-US') + ' 公里';
       return val + ' 米';
     }
 
+    // 单款游戏的里程：0 也照常显示成「0 公里」（表示这款没跑过），只有 null/空 才不显示
+    function formatMileageZero(val) {
+      if (val === null || val === undefined || val === '') return null;
+      var n = Number(val);
+      if (!isFinite(n)) return null;
+      if (n <= 0) return '0 公里';
+      return n >= 1000 ? Number((n / 1000).toFixed(1)).toLocaleString('en-US') + ' 公里' : n + ' 米';
+    }
+
+    // 两款游戏里程是否值得单独列出（都为 0 就不占地方）
+    function hasMileageDetail(ets2, ats) {
+      return Number(ets2) > 0 || Number(ats) > 0;
+    }
+
     /* ==================================================================
      * V1 车队平台 · 实时遥测
      * 仅渲染「有值」的字段（null / undefined / 空串一律不显示）
@@ -1388,19 +1463,31 @@
       banCountEl.innerText = banCount + '次';
       banCountEl.className = banCount > 0 ? 'info-value has-bans' : 'info-value no-bans';
 
-      // Mileage
+      // Mileage：总里程 / 今日里程是欧卡+美卡合计，另附两款游戏的单独里程
       const mileage = formatMileage(data.mileage);
       const todayMileage = formatMileage(data.todayMileage);
-      if (mileage || todayMileage) {
+      const hasMileageBreakdown = hasMileageDetail(data.mileageEts2, data.mileageAts);
+      const hasTodayBreakdown = hasMileageDetail(data.todayMileageEts2, data.todayMileageAts);
+      if (mileage || todayMileage || hasMileageBreakdown || hasTodayBreakdown) {
         document.getElementById('mileage-section').style.display = '';
         if (mileage) {
           document.getElementById('mileage-row').style.display = '';
           document.getElementById('tmp-mileage').innerText = mileage;
         }
+        if (hasMileageBreakdown) {
+          document.getElementById('mileage-detail').style.display = '';
+          document.getElementById('tmp-mileage-ets2').innerText = formatMileageZero(data.mileageEts2) || '';
+          document.getElementById('tmp-mileage-ats').innerText = formatMileageZero(data.mileageAts) || '';
+        }
         if (todayMileage) {
           document.getElementById('today-mileage-row').style.display = '';
           document.getElementById('tmp-today-mileage').innerText = todayMileage;
         }
+        if (hasTodayBreakdown) {
+          document.getElementById('today-mileage-detail').style.display = '';
+          document.getElementById('tmp-today-mileage-ets2').innerText = formatMileageZero(data.todayMileageEts2) || '';
+          document.getElementById('tmp-today-mileage-ats').innerText = formatMileageZero(data.todayMileageAts) || '';
+        }
       }
 
       // Game Time

package/lib/resource/traffic.html

@@ -264,6 +264,17 @@
         calculateMapCoordinate(x, y) {
           return [x / 2.598541 + mapConfig.promods.multipliers.x, y / 2.598541 + mapConfig.promods.multipliers.y];
         }
+      },
+      // 美卡（ATS）：换算参数来自瓦片导出配置 TileMapInfo.json
+      ats: {
+        tileUrl: 'https://ets_tiles.cnly.top/20260903/tmp-ats-yellow/Tiles/{z}/{x}/{y}.png',
+        multipliers: { x: 97626.58, y: 64321.45 },
+        breakpoints: {},
+        bounds: { y: 131072, x: 131072 },
+        maxZoom: 8, minZoom: 0,
+        calculateMapCoordinate(x, y) {
+          return [x / 1.230185 + mapConfig.ats.multipliers.x, y / 1.230185 + mapConfig.ats.multipliers.y];
+        }
       }
     };
 

package/lib/util/constant.js

@@ -26,12 +26,21 @@ module.exports = {
    * P服务器ID集合
    */
   PromodsIds: [50, 51],
+  /**
+   * 美卡（ATS）服务器ID集合
+   */
+  AtsIds: [8, 10, 45],
+  /**
+   * 美卡足迹记录开始日期（接口自 2026-09-30 19:00 起记录美卡轨迹）
+   */
+  AtsFootprintStartDate: '2026-09-30',
   /**
    * 服务器类型
    */
   ServerType: {
     ets: 1,
-    promods: 2
+    promods: 2,
+    ats: 3
   },
   /**
    * 联运部接龙：每天发布的时间

package/lib/util/tmpIdPicker.js

@@ -0,0 +1,94 @@
+/**
+ * 多绑定选择器：用户绑定了多个 tmpId 时，列出序号让用户回复选择（支持多选）。
+ * 原理：需要选择的指令先回复编号列表并挂起（pending），由前置中间件捕获用户下一条
+ * "纯序号"消息后解析并继续执行；超时/取消/其他内容均视为放弃。
+ */
+const MAX_PICK = 5;            // 单次多选上限
+const PICK_TIMEOUT = 60_000;   // 等待回复时长（毫秒）
+
+/**
+ * key: `${platform}:${channelId}:${userId}` → { bindings, allowMulti, max, finish }
+ * 按平台+频道+用户隔离，避免群里其他人误触发。
+ */
+const pending = new Map();
+
+function keyOf(session) {
+    return `${session.platform}:${session.channelId || 'private'}:${session.userId}`;
+}
+
+/**
+ * 注册选择器中间件（在插件 apply 中调用一次，前置执行）
+ */
+function register(ctx) {
+    ctx.middleware((session, next) => {
+        const key = keyOf(session);
+        const record = pending.get(key);
+        if (!record) return next();
+        const content = (session.content || '').trim();
+        // 取消
+        if (/^取消$/.test(content)) {
+            record.finish(null);
+            return;
+        }
+        // 纯序号消息（支持 1,3 / 1 3 / 1、3 等分隔写法）
+        if (/^\d{1,6}(?:\s*[,，、 ]\s*\d{1,6})*$/.test(content)) {
+            const indexes = [...content.matchAll(/\d{1,6}/g)].map(m => parseInt(m[0], 10));
+            const picked = [...new Set(indexes)]
+                .filter(i => i >= 1 && i <= record.bindings.length)
+                .slice(0, record.allowMulti ? record.max : 1)
+                .map(i => String(record.bindings[i - 1].tmp_id));
+            if (picked.length === 0) {
+                record.finish(null);
+                session.send('没有有效的序号，已取消').catch(() => { });
+                return;
+            }
+            record.finish(picked);
+            return;
+        }
+        // 其他内容：视为放弃挂起，消息继续按正常流程处理
+        record.finish(null);
+        return next();
+    }, true);
+}
+
+/**
+ * 需要绑定 tmpId 的指令调用：绑定数 ≤1 时直接返回不打扰，≥2 时列出序号并等待选择。
+ * @param bindings guildBind.list() 的结果
+ * @param opts { allowMulti?: boolean } 是否允许多选（默认允许）
+ * @returns 选中的 tmpId 字符串数组；返回 null 表示已在等待用户回复，调用方应直接 return
+ */
+async function pick(ctx, session, bindings, opts = {}) {
+    if (!bindings || bindings.length === 0) return [];
+    if (bindings.length === 1) return [String(bindings[0].tmp_id)];
+    const allowMulti = opts.allowMulti !== false;
+    const max = allowMulti ? MAX_PICK : 1;
+    const lines = bindings.map((b, i) => `${i + 1}. ${b.tmp_name || '未知'} (${b.tmp_id})`);
+    const tip = allowMulti
+        ? `请回复序号选择（最多 ${max} 个，多选用逗号分隔，如 1,3）`
+        : '请回复一个序号';
+    await session.send(`您绑定了多个编号：\n${lines.join('\n')}\n${tip}\n回复"取消"放弃，60 秒内有效`);
+    return await new Promise(resolve => {
+        const key = keyOf(session);
+        const record = {
+            bindings,
+            allowMulti,
+            max,
+            timer: null,
+            finish(result) {
+                clearTimeout(record.timer);
+                pending.delete(key);
+                resolve(result);
+            }
+        };
+        record.timer = setTimeout(() => {
+            if (pending.get(key) === record) {
+                pending.delete(key);
+                resolve(null);
+                session.send('选择超时，已取消').catch(() => { });
+            }
+        }, PICK_TIMEOUT);
+        pending.set(key, record);
+    });
+}
+
+module.exports = { register, pick, MAX_PICK, PICK_TIMEOUT };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-ets2-tools-tmp",
   "description": "欧卡2 TruckersMP信息查询、车队平台查询及活动提醒",
-  "version": "3.3.65",
+  "version": "3.4.0",
   "contributors": [
     "opwop <slhp1013@qq.com>"
   ],