koishi-plugin-ets2-tools-tmp 3.4.4 → 3.4.5

package/lib/command/tmpMileageRanking.js

@@ -30,10 +30,10 @@ module.exports = async (ctx, session, rankingType, target) => {
         if (ownerName) tmpIdPicker.cacheAtName(session.platform, ownerKey, ownerName);
     }
     // 排行榜只高亮一个人：直接用默认绑定，不弹序号询问
+    // 这里只用 tmp_id，高亮名字来自排行榜接口返回的数据 → 不必刷新 tmp_name
     const bindings = await guildBind.listOf(ctx.database, session.platform, ownerKey);
     let bindTmpId = null;
     if (bindings.length > 0) {
-        await guildBind.ensureNames(ctx, bindings);
         bindTmpId = String((bindings.find(b => guildBind.isDefault(b)) || bindings[0]).tmp_id);
     }
     let playerMileageRanking = null;

package/lib/command/tmpVersionCheck.js

@@ -3,12 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VersionCheckService = void 0;
 
 const koishi_1 = require("koishi");
+const path_1 = require("path");
+const common_1 = require("../util/common");
+
+// TMP 官方文件清单（含每个文件的 MD5），用于比对版本更新前后哪些文件被替换
+const FILES_API = "https://update.ets2mp.com/files.json";
+// 文字通知里最多列出多少个文件，超出只显示数量，避免消息过长
+const MAX_LISTED_FILES = 30;
 
 class VersionCheckService {
     constructor(ctx, config) {
         this.ctx = ctx;
         this.cfg = config;
         this.currentVersion = null;
+        // 上一次检查时的文件清单快照（FilePath -> {md5, type}），用于比对文件变化
+        this.fileManifest = null;
         this.timers = [];
         this.logger = this.initLogger();
     }
@@ -71,6 +80,7 @@ class VersionCheckService {
             if (response && response.name) {
                 const versionInfo = {
                     name: response.name,
+                    stage: response.stage,
                     time: this.convertToUTC8(response.time),
                     supported_game_version: response.supported_game_version,
                     supported_ats_game_version: response.supported_ats_game_version
@@ -80,7 +90,14 @@ class VersionCheckService {
 
                 if (this.currentVersion && this.currentVersion.name !== versionInfo.name) {
                     this.logger.info(`检测到版本更新: ${this.currentVersion.name} -> ${versionInfo.name}`);
-                    await this.sendVersionUpdateNotification(this.currentVersion, versionInfo);
+
+                    // 比对文件 MD5，找出本次更新实际替换了哪些文件
+                    const changedFiles = await this.detectChangedFiles();
+                    if (changedFiles.length > 0) {
+                        this.logger.info(`本次更新涉及 ${changedFiles.length} 个文件变化`);
+                    }
+
+                    await this.sendVersionUpdateNotification(this.currentVersion, versionInfo, changedFiles);
                 }
 
                 this.currentVersion = versionInfo;
@@ -92,6 +109,108 @@ class VersionCheckService {
         }
     }
 
+    /**
+     * 拉取官方文件清单并转成 { FilePath -> Md5 } 映射。
+     * 失败时返回 null（调用方据此区分“没变化”和“查不到”）。
+     */
+    async fetchFileManifest() {
+        try {
+            const response = await this.ctx.http.get(FILES_API, { timeout: 15000 });
+            const files = response && Array.isArray(response.Files) ? response.Files : null;
+            if (!files) {
+                this.logger.warn("文件清单格式不正确，跳过文件变化比对");
+                return null;
+            }
+
+            const manifest = new Map();
+            for (const file of files) {
+                if (file && file.FilePath) {
+                    manifest.set(file.FilePath, {
+                        md5: String(file.Md5 || "").toLowerCase(),
+                        type: file.Type || ""
+                    });
+                }
+            }
+            this.logger.debug(`文件清单已加载，共 ${manifest.size} 个文件`);
+            return manifest;
+        } catch (error) {
+            this.logger.warn(`获取文件清单失败: ${error.message}`);
+            return null;
+        }
+    }
+
+    /**
+     * 比对「上一次版本的文件清单」与「当前清单」，返回 MD5 变化的文件。
+     *
+     * 说明：files.json 只提供**当前**版本的文件列表，没有历史版本归档
+     * （/0.7.10.0/files.json 等路径均 404）。所以只能在两次检查之间自己留存快照：
+     * - 有上一次快照 → 逐文件比对 MD5，新增/删除/改动都算变化；
+     * - 没有快照（首次运行或重启）→ 退化为“清单中所有文件都视为本次更新内容”，
+     *   并在结果里标注 snapshotMissing，由文案说明这是完整清单而非差异。
+     *
+     * @returns {Array|null} 变化列表；清单获取失败时返回 null（区别于“没有变化”的空数组）
+     */
+    async detectChangedFiles() {
+        const current = await this.fetchFileManifest();
+        if (!current) {
+            // 查不到清单 ≠ 没有变化，不能返回 []，否则会误报“未检测到文件变化”
+            return null;
+        }
+
+        const previous = this.fileManifest;
+        this.fileManifest = current;
+
+        if (!previous) {
+            this.logger.debug("没有上一次的文件清单快照，本次按完整清单输出");
+            return this.buildFullFileList(current, true);
+        }
+
+        const changed = [];
+        for (const [filePath, info] of current) {
+            const old = previous.get(filePath);
+            if (!old) {
+                changed.push({ path: filePath, type: info.type, kind: 'added' });
+            } else if (old.md5 !== info.md5) {
+                changed.push({ path: filePath, type: info.type, kind: 'modified' });
+            }
+        }
+        // 上一次有、这次没有 → 被移除
+        for (const [filePath, info] of previous) {
+            if (!current.has(filePath)) {
+                changed.push({ path: filePath, type: info.type, kind: 'removed' });
+            }
+        }
+
+        // 稳定排序：先 ets2/ats，再 system；同类按路径
+        const typeOrder = { ets2: 0, ats: 1, system: 2 };
+        changed.sort((a, b) => {
+            const ta = typeOrder[a.type] !== undefined ? typeOrder[a.type] : 9;
+            const tb = typeOrder[b.type] !== undefined ? typeOrder[b.type] : 9;
+            if (ta !== tb) return ta - tb;
+            return a.path.localeCompare(b.path);
+        });
+
+        return changed;
+    }
+
+    /** 没有快照时的退化结果：清单内所有文件 */
+    buildFullFileList(manifest, snapshotMissing) {
+        const list = [];
+        for (const [filePath, info] of manifest) {
+            list.push({ path: filePath, type: info.type, kind: 'unknown' });
+        }
+        const typeOrder = { ets2: 0, ats: 1, system: 2 };
+        list.sort((a, b) => {
+            const ta = typeOrder[a.type] !== undefined ? typeOrder[a.type] : 9;
+            const tb = typeOrder[b.type] !== undefined ? typeOrder[b.type] : 9;
+            if (ta !== tb) return ta - tb;
+            return a.path.localeCompare(b.path);
+        });
+        // 用不可枚举标记，避免污染后续 JSON 序列化
+        Object.defineProperty(list, 'snapshotMissing', { value: !!snapshotMissing, enumerable: false });
+        return list;
+    }
+
     convertToUTC8(utcTimeString) {
         try {
             const utcDate = new Date(utcTimeString);
@@ -109,28 +228,175 @@ class VersionCheckService {
         }
     }
 
-    async sendVersionUpdateNotification(oldVersion, newVersion) {
-        const message = `📢 TMP版本更新通知
+    async sendVersionUpdateNotification(oldVersion, newVersion, changedFiles) {
+        // null = 清单查询失败；数组 = 比对结果（可能为空）
+        const fileCount = changedFiles === null ? '查询失败' : `${changedFiles.length}`;
+        this.logger.info(`发送版本更新通知到 ${this.cfg.groups.length} 个群组（变化文件: ${fileCount}）`);
 
-旧版本: ${oldVersion.name}
-新版本: ${newVersion.name}
-
-更新时间: ${newVersion.time}（UTC+8）
-欧卡支持版本: ${newVersion.supported_game_version}
-美卡支持版本: ${newVersion.supported_ats_game_version}`;
-
-        this.logger.info(`发送版本更新通知到 ${this.cfg.groups.length} 个群组`);
+        // 内容只构建一次（图片渲染较慢，不要每个群各渲染一遍）
+        const message = await this.buildUpdateContent(oldVersion, newVersion, changedFiles);
+        const isImage = typeof message === "object" && message !== null;
 
         for (const groupId of this.cfg.groups) {
             try {
                 await this.sendToGroup(groupId, message);
-                this.logger.info(`已发送版本更新通知到群组 ${groupId}`);
+                this.logger.info(`已发送版本更新通知到群组 ${groupId}（${isImage ? "图片" : "文字"}）`);
             } catch (error) {
                 this.logger.error(`发送版本更新通知到群组 ${groupId} 失败:`, error.message);
             }
         }
     }
 
+    /**
+     * 构建通知内容。notifyType：1=文字（默认），2=图片。
+     * 图片渲染失败（如未启用 puppeteer）会**自动回退为文字**，保证通知不丢。
+     * @returns 文字字符串，或图片 segment 元素
+     */
+    async buildUpdateContent(oldVersion, newVersion, changedFiles) {
+        const notifyType = Number(this.cfg.notifyType) || 1;
+        if (notifyType === 2) {
+            const image = await this.renderUpdateImage(oldVersion, newVersion, changedFiles);
+            if (image) {
+                return image;
+            }
+        }
+        return this.buildUpdateText(oldVersion, newVersion, changedFiles);
+    }
+
+    /**
+     * 插件配置里的「更新通知附加文本」，原样追加在通知末尾。
+     * 支持 \n 转义换行，方便在配置面板里写多行。
+     */
+    getExtraText() {
+        const raw = this.cfg.extraText;
+        if (raw == null) return "";
+        const text = String(raw).trim();
+        if (!text) return "";
+        return text.replace(/\\n/g, "\n");
+    }
+
+    buildUpdateText(oldVersion, newVersion, changedFiles) {
+        let message = `📢 TMP版本更新通知
+
+旧版本: ${oldVersion.name}
+新版本: ${newVersion.name}
+
+更新时间: ${newVersion.time}（UTC+8）
+欧卡支持版本: ${this.formatGameVersion(oldVersion.supported_game_version, newVersion.supported_game_version)}
+美卡支持版本: ${this.formatGameVersion(oldVersion.supported_ats_game_version, newVersion.supported_ats_game_version)}`;
+
+        message += this.formatChangedFiles(changedFiles);
+
+        const extra = this.getExtraText();
+        if (extra) {
+            message += `\n\n${extra}`;
+        }
+        return message;
+    }
+
+    /**
+     * 把变化文件列表拼成消息片段。
+     * - files 为 null → 清单获取失败，明确说明“查询失败”，不冒充“无变化”
+     * - 空数组 → 确实没有文件变化
+     * - 超过 MAX_LISTED_FILES 条 → 只列前若干条 + 「等共 N 个」
+     */
+    formatChangedFiles(files) {
+        if (files === null) {
+            return `\n\n更新文件: 文件清单获取失败，无法比对变化`;
+        }
+        if (!files || files.length === 0) {
+            return `\n\n更新文件: 未检测到文件变化`;
+        }
+
+        const snapshotMissing = files.snapshotMissing === true;
+        const title = snapshotMissing
+            ? `更新文件（共 ${files.length} 个，未留存上次清单，以下为完整列表）`
+            : `更新文件（共 ${files.length} 个）`;
+
+        const shown = files.slice(0, MAX_LISTED_FILES);
+        const lines = shown.map((file) => {
+            const mark = file.kind === 'added' ? '[新增] '
+                : file.kind === 'removed' ? '[移除] '
+                : file.kind === 'modified' ? '[更新] '
+                : '';
+            return `· ${mark}${file.path}`;
+        });
+
+        let text = `\n\n${title}\n${lines.join('\n')}`;
+        if (files.length > shown.length) {
+            text += `\n… 等共 ${files.length} 个文件`;
+        }
+        return text;
+    }
+
+    /**
+     * 游戏支持版本：有变化时显示「旧 → 新」，没变则只显示当前值。
+     */
+    formatGameVersion(oldValue, newValue) {
+        if (oldValue && newValue && String(oldValue) !== String(newValue)) {
+            return `${oldValue} → ${newValue}`;
+        }
+        return newValue || oldValue || "未知";
+    }
+
+    /**
+     * 用 puppeteer 渲染版本更新卡片
+     * @returns 图片 segment 元素；渲染不可用时返回 null，由调用方回退文字
+     */
+    async renderUpdateImage(oldVersion, newVersion, changedFiles) {
+        if (!this.ctx.puppeteer) {
+            this.logger.warn("未启用 puppeteer，版本更新通知回退为文字形式");
+            return null;
+        }
+        let page;
+        try {
+            // null = 清单查询失败，交给模板显示对应提示
+            const files = changedFiles === null ? [] : (Array.isArray(changedFiles) ? changedFiles : []);
+            const data = {
+                oldName: oldVersion.name,
+                newName: newVersion.name,
+                time: newVersion.time,
+                stage: newVersion.stage,
+                // 游戏支持版本也带上旧值，卡片才能显示「旧 → 新」对比
+                etsOld: oldVersion.supported_game_version,
+                etsNew: newVersion.supported_game_version,
+                atsOld: oldVersion.supported_ats_game_version,
+                atsNew: newVersion.supported_ats_game_version,
+                // 变化文件：路径 + 变化类型，卡片里按组展示
+                files: files.map((file) => ({
+                    path: file.path,
+                    kind: file.kind || 'unknown',
+                    type: file.type || ''
+                })),
+                filesSnapshotMissing: changedFiles !== null && changedFiles.snapshotMissing === true,
+                filesUnavailable: changedFiles === null,
+                extraText: this.getExtraText()
+            };
+            const htmlPath = path_1.resolve(__dirname, "../resource/version-update.html");
+            this.logger.debug(`渲染版本更新卡片: ${htmlPath}`);
+
+            page = await this.ctx.puppeteer.page();
+            await page.setViewport({ width: 560, height: 900, deviceScaleFactor: 2 });
+            await page.goto(`file:///${htmlPath}`);
+            await page.evaluate(`setData(${JSON.stringify(data)})`);
+            await common_1.sleep(100);
+            await page.waitForNetworkIdle();
+
+            const element = await page.$("#container");
+            if (!element) {
+                throw new Error("未找到 #container");
+            }
+            return koishi_1.segment.image(await element.screenshot({ encoding: "binary" }), "image/jpeg");
+        } catch (error) {
+            this.logger.error(`渲染版本更新卡片失败，回退为文字形式: ${error.message}`);
+            return null;
+        } finally {
+            if (page) {
+                try { await page.close(); } catch { }
+            }
+        }
+    }
+
     async sendToGroup(groupId, message) {
         const onebotBots = this.ctx.bots.filter((bot) => {
             return bot.platform === "onebot";

package/lib/command/tmpVtcMileageRanking.js

@@ -34,10 +34,10 @@ module.exports = async (ctx, cfg, session, rankingType, target) => {
         if (ownerName) tmpIdPicker.cacheAtName(session.platform, ownerKey, ownerName);
     }
     // 排行榜只高亮一个人：直接用默认绑定，不弹序号询问
+    // 这里只用 tmp_id，高亮名字来自排行榜接口返回的数据 → 不必刷新 tmp_name
     const bindings = await guildBind.listOf(ctx.database, session.platform, ownerKey);
     let bindTmpId = null;
     if (bindings.length > 0) {
-        await guildBind.ensureNames(ctx, bindings);
         bindTmpId = String((bindings.find(b => guildBind.isDefault(b)) || bindings[0]).tmp_id);
     }
     let playerMileageRanking = null;

package/lib/database/guildBind.js

@@ -7,23 +7,30 @@ const evmOpenApi = require('../api/evmOpenApi');
  */
 module.exports = {
     /**
-     * 补全缺失的玩家名（旧版本绑定的数据没有 tmp_name）：查接口并写回数据库。
-     * 并发补查，单个失败保持未知（下次遇到再补）。
+     * 刷新玩家名（**总是查接口**，用于玩家改名后的及时同步）：
+     * - 并发查询传入的所有行（含缺名的旧数据）；
+     * - 名字确实变了才写库，避免无谓的写操作；
+     * - 单个查询失败保留旧名（不把已有名字清空），下次再刷新。
+     * 注意：只在**要显示名字**的地方调用（我的绑定 / 序号列表 / 解绑·设为默认文案），
+     * 不显示名字的路径（如 pickAll、排行榜）不要调用，省接口。
      * @returns 原数组（行对象已被就地更新）
      */
-    async ensureNames(ctx, rows) {
-        const missing = (rows || []).filter(r => !r.tmp_name);
-        if (missing.length === 0) {
+    async refreshNames(ctx, rows) {
+        const list = (rows || []).filter(r => r && r.tmp_id != null);
+        if (list.length === 0) {
             return rows;
         }
-        await Promise.all(missing.map(async (row) => {
+        await Promise.all(list.map(async (row) => {
             try {
                 const info = await evmOpenApi.playerInfo(ctx.http, row.tmp_id);
                 if (!info.error && info.data && info.data.name) {
-                    row.tmp_name = info.data.name;
-                    await ctx.database.set('tmp_guild_bind', row.id, { tmp_name: info.data.name });
+                    const name = info.data.name;
+                    if (row.tmp_name !== name) {
+                        row.tmp_name = name;
+                        await ctx.database.set('tmp_guild_bind', row.id, { tmp_name: name });
+                    }
                 }
-            } catch { } // 查询失败保持未知，下次遇到再补
+            } catch { } // 查询失败保留旧名，下次再刷新
         }));
         return rows;
     },

package/lib/database/model.js

@@ -31,7 +31,7 @@ const modelArray = {
             type: 'string',
             length: 100,
             nullable: true,
-            comment: 'TMP玩家名称（绑定时记录，用于多绑定列表展示）'
+            comment: 'TMP玩家名称（列表展示用；每次展示绑定时会查接口刷新，改名可及时同步）'
         },
         is_default: {
             type: 'unsigned',

package/lib/index.js

@@ -129,7 +129,15 @@ exports.Config = koishi_1.Schema.intersect([
 
         tmpVersionCheck: koishi_1.Schema.object({
             checkInterval: koishi_1.Schema.number().description("版本检查间隔（分钟）").default(30),
-            groups: koishi_1.Schema.array(koishi_1.Schema.string()).role("table").description("接收版本更新通知的群组ID列表").default([])
+            groups: koishi_1.Schema.array(koishi_1.Schema.string()).role("table").description("接收版本更新通知的群组ID列表").default([]),
+            notifyType: koishi_1.Schema.union([
+                koishi_1.Schema.const(1).description('文字'),
+                koishi_1.Schema.const(2).description('图片')
+            ]).default(1).description('版本更新通知形式（图片较精美，需启用 puppeteer；渲染失败会自动回退文字）'),
+            extraText: koishi_1.Schema.string()
+                .role('textarea')
+                .description('更新通知末尾附加的文本（留空则不追加）。支持用 \\n 表示换行')
+                .default('')
         }).description("TMP版本更新查询配置"),
         steamApi: koishi_1.Schema.object({
             key: koishi_1.Schema.string().description("Steam API Key，用于查询游戏时长")
@@ -270,8 +278,8 @@ function registerBaseCommands(ctx, cfg) {
                 if (bindings.length === 0) {
                     return '还没有绑定编号，使用「绑定 tmpId」添加';
                 }
-                // 旧绑定缺名字的先补查并写回
-                await guildBind.ensureNames(ctx, bindings);
+                // 展示前刷新名字（玩家改名后可及时同步）
+                await guildBind.refreshNames(ctx, bindings);
                 const lines = bindings.map((b, i) => {
                     const mark = guildBind.isDefault(b) ? '★ ' : '   ';
                     return `${mark}${i + 1}. ${b.tmp_name || '未知'} (${b.tmp_id})`;
@@ -289,7 +297,7 @@ function registerBaseCommands(ctx, cfg) {
                 if (!index || !index.trim()) {
                     return '请输入要设为默认的序号（序号见「我的绑定」）';
                 }
-                await guildBind.ensureNames(ctx, await guildBind.list(ctx.database, session.platform, session.userId));
+                await guildBind.refreshNames(ctx, await guildBind.list(ctx.database, session.platform, session.userId));
                 const { row, changed, total } = await guildBind.setDefaultByIndex(
                     ctx, ctx.database, session.platform, session.userId, index.trim()
                 );
@@ -312,7 +320,6 @@ function registerBaseCommands(ctx, cfg) {
                 if (bindings.length === 0) {
                     return '还没有绑定编号';
                 }
-                await guildBind.ensureNames(ctx, bindings);
                 if (!index) {
                     return '请输入要解绑的序号或 all（序号见「我的绑定」）';
                 }
@@ -324,6 +331,8 @@ function registerBaseCommands(ctx, cfg) {
                 if (isNaN(idx) || idx < 1 || idx > bindings.length) {
                     return `序号无效，可用范围 1-${bindings.length}（序号见「我的绑定」）`;
                 }
+                // 到这一步才需要显示名字（成功文案 / 顶替提示）→ 此时刷新
+                await guildBind.refreshNames(ctx, bindings);
                 const row = bindings[idx - 1];
                 const { promoted } = await guildBind.remove(ctx.database, session.platform, session.userId, row.id);
                 let msg = `已解绑 ${idx}. ${row.tmp_name || '未知'} (${row.tmp_id})`;
@@ -556,6 +565,8 @@ function apply(ctx, cfg) {
         const versionCheckConfig = {
             checkInterval: cfg.tmpVersionCheck.checkInterval,
             groups: cfg.tmpVersionCheck.groups,
+            notifyType: cfg.tmpVersionCheck.notifyType,
+            extraText: cfg.tmpVersionCheck.extraText,
             debugMode: cfg.debugMode,
             debug: cfg.tmpActivityService?.debug
         };

package/lib/resource/version-update.html

@@ -0,0 +1,706 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <title>Version Update</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+
+    body {
+      font-family: 'Segoe UI', 'Microsoft YaHei', sans-serif;
+      background: #06060b;
+      -webkit-font-smoothing: antialiased;
+    }
+
+    #container {
+      width: 560px;
+      background: #0a0a12;
+      position: relative;
+      overflow: hidden;
+      padding-bottom: 16px;
+    }
+
+    /* ===== 背景：网格 + 光晕 ===== */
+    .grid-bg {
+      position: absolute;
+      inset: 0;
+      background-image:
+        linear-gradient(rgba(0, 200, 255, 0.03) 1px, transparent 1px),
+        linear-gradient(90deg, rgba(0, 200, 255, 0.03) 1px, transparent 1px);
+      background-size: 26px 26px;
+      pointer-events: none;
+      z-index: 0;
+    }
+
+    .glow-top {
+      position: absolute;
+      top: -180px;
+      left: 50%;
+      transform: translateX(-50%);
+      width: 620px;
+      height: 360px;
+      background: radial-gradient(ellipse at center, rgba(0, 200, 255, 0.16) 0%, rgba(0, 200, 255, 0.04) 45%, transparent 70%);
+      pointer-events: none;
+      z-index: 0;
+    }
+
+    .scan-line {
+      position: absolute;
+      top: 0; left: 0; right: 0;
+      height: 2px;
+      background: linear-gradient(90deg, transparent, rgba(0, 200, 255, 0.35), transparent);
+      pointer-events: none;
+      z-index: 3;
+    }
+
+    /* ===== 顶部 ===== */
+    .header {
+      position: relative;
+      z-index: 2;
+      padding: 22px 26px 18px;
+      display: flex;
+      align-items: center;
+      gap: 14px;
+      border-bottom: 1px solid rgba(0, 200, 255, 0.1);
+      background: linear-gradient(180deg, rgba(0, 200, 255, 0.07) 0%, transparent 100%);
+    }
+
+    .header-badge {
+      width: 46px;
+      height: 46px;
+      flex-shrink: 0;
+      border-radius: 13px;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 23px;
+      background: linear-gradient(145deg, rgba(0, 200, 255, 0.22), rgba(0, 200, 255, 0.06));
+      border: 1px solid rgba(0, 200, 255, 0.32);
+      box-shadow: 0 0 18px rgba(0, 200, 255, 0.22), inset 0 1px 0 rgba(255, 255, 255, 0.08);
+    }
+
+    .header-text { flex: 1; min-width: 0; }
+
+    .header-title {
+      font-size: 20px;
+      font-weight: 800;
+      color: #eaf6ff;
+      letter-spacing: 1.5px;
+      line-height: 1.25;
+    }
+
+    .header-title em {
+      font-style: normal;
+      color: #00c8ff;
+      text-shadow: 0 0 14px rgba(0, 200, 255, 0.55);
+    }
+
+    .header-sub {
+      margin-top: 3px;
+      font-size: 10px;
+      letter-spacing: 3.2px;
+      color: #3d5570;
+      text-transform: uppercase;
+    }
+
+    .stage-tag {
+      flex-shrink: 0;
+      font-size: 11px;
+      font-weight: 700;
+      letter-spacing: 1px;
+      padding: 6px 12px;
+      border-radius: 20px;
+      color: #ffb545;
+      background: rgba(255, 181, 69, 0.1);
+      border: 1px solid rgba(255, 181, 69, 0.34);
+      box-shadow: 0 0 14px rgba(255, 181, 69, 0.16);
+    }
+
+    .stage-tag:empty { display: none; }
+
+    /* ===== 版本对比 ===== */
+    .hero {
+      position: relative;
+      z-index: 2;
+      margin: 20px 20px 0;
+      padding: 22px 20px 20px;
+      border-radius: 16px;
+      background: linear-gradient(160deg, rgba(0, 200, 255, 0.06) 0%, rgba(0, 200, 255, 0.012) 55%, rgba(0, 255, 136, 0.03) 100%);
+      border: 1px solid rgba(0, 200, 255, 0.14);
+      box-shadow: 0 10px 30px rgba(0, 0, 0, 0.45), inset 0 1px 0 rgba(0, 200, 255, 0.08);
+    }
+
+    /* 四角装饰 */
+    .hero::before,
+    .hero::after {
+      content: '';
+      position: absolute;
+      width: 16px;
+      height: 16px;
+      border: 1.5px solid rgba(0, 200, 255, 0.5);
+    }
+    .hero::before { top: -1px; left: -1px; border-right: 0; border-bottom: 0; border-top-left-radius: 16px; }
+    .hero::after { bottom: -1px; right: -1px; border-left: 0; border-top: 0; border-bottom-right-radius: 16px; }
+
+    .hero-caption {
+      text-align: center;
+      font-size: 10px;
+      letter-spacing: 3px;
+      color: #3d5570;
+      text-transform: uppercase;
+      margin-bottom: 16px;
+    }
+
+    .versus {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      gap: 16px;
+    }
+
+    .ver {
+      flex: 1;
+      min-width: 0;
+      text-align: center;
+      padding: 14px 8px 12px;
+      border-radius: 12px;
+    }
+
+    .ver-label {
+      font-size: 11px;
+      letter-spacing: 1.6px;
+      margin-bottom: 9px;
+      font-weight: 600;
+    }
+
+    .ver-value {
+      font-weight: 800;
+      letter-spacing: 0.5px;
+      font-variant-numeric: tabular-nums;
+      white-space: nowrap;
+    }
+
+    /* 旧版本 */
+    .ver.old {
+      background: rgba(255, 255, 255, 0.018);
+      border: 1px solid rgba(255, 255, 255, 0.06);
+    }
+    .ver.old .ver-label { color: #5a6878; }
+    .ver.old .ver-value {
+      font-size: 24px;
+      color: #8b98a8;
+      text-decoration: line-through;
+      text-decoration-color: rgba(255, 92, 92, 0.6);
+      text-decoration-thickness: 1.5px;
+    }
+
+    /* 新版本 */
+    .ver.new-ver {
+      background: linear-gradient(160deg, rgba(0, 200, 255, 0.16) 0%, rgba(0, 255, 136, 0.05) 100%);
+      border: 1px solid rgba(0, 200, 255, 0.45);
+      box-shadow: 0 0 24px rgba(0, 200, 255, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.1);
+      position: relative;
+    }
+    .ver.new-ver .ver-label { color: #7fe3ff; }
+    .ver.new-ver .ver-value {
+      font-size: 32px;
+      color: #ffffff;
+      text-shadow: 0 0 16px rgba(0, 200, 255, 0.7), 0 0 34px rgba(0, 200, 255, 0.35);
+    }
+
+    .new-flag {
+      position: absolute;
+      top: -9px;
+      right: -7px;
+      font-size: 9px;
+      font-weight: 800;
+      letter-spacing: 1.4px;
+      padding: 3px 8px;
+      border-radius: 9px;
+      color: #04121a;
+      background: linear-gradient(135deg, #00ff88, #00c8ff);
+      box-shadow: 0 0 14px rgba(0, 255, 136, 0.5);
+    }
+
+    /* 中间箭头 */
+    .arrow {
+      flex-shrink: 0;
+      width: 44px;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .arrow svg { display: block; filter: drop-shadow(0 0 7px rgba(0, 200, 255, 0.55)); }
+
+    /* ===== 信息区 ===== */
+    .info {
+      position: relative;
+      z-index: 2;
+      margin: 16px 20px 0;
+      display: flex;
+      flex-direction: column;
+      gap: 8px;
+    }
+
+    .info-row {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      padding: 11px 14px;
+      border-radius: 11px;
+      background: rgba(255, 255, 255, 0.022);
+      border: 1px solid rgba(255, 255, 255, 0.055);
+    }
+
+    .info-icon {
+      width: 30px;
+      height: 30px;
+      flex-shrink: 0;
+      border-radius: 9px;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 15px;
+      background: rgba(0, 200, 255, 0.1);
+      border: 1px solid rgba(0, 200, 255, 0.2);
+    }
+
+    .info-key {
+      font-size: 12px;
+      color: #5d7089;
+      letter-spacing: 0.6px;
+      flex-shrink: 0;
+      min-width: 96px;
+    }
+
+    .info-val {
+      margin-left: auto;
+      font-size: 14px;
+      font-weight: 700;
+      color: #cfe6f7;
+      font-variant-numeric: tabular-nums;
+      letter-spacing: 0.4px;
+      white-space: nowrap;
+      display: flex;
+      align-items: center;
+      gap: 7px;
+    }
+
+    .info-row.hl .info-val { color: #00ff9d; }
+
+    /* 支持版本「旧 → 新」对比 */
+    .v-from {
+      font-size: 12.5px;
+      font-weight: 600;
+      color: #7d8b9c;
+      text-decoration: line-through;
+      text-decoration-color: rgba(255, 92, 92, 0.5);
+      text-decoration-thickness: 1px;
+    }
+
+    .v-to {
+      color: #00ff9d;
+      text-shadow: 0 0 10px rgba(0, 255, 157, 0.38);
+    }
+
+    .v-same { color: #9fb3c6; font-weight: 600; }
+
+    .v-none { color: #3d5570; }
+
+    .mini-arrow { display: block; flex-shrink: 0; }
+
+    .tag-chg {
+      font-size: 10px;
+      font-weight: 800;
+      letter-spacing: 0.6px;
+      padding: 2px 7px;
+      border-radius: 8px;
+      color: #04121a;
+      background: linear-gradient(135deg, #00ff88, #00c8ff);
+      box-shadow: 0 0 10px rgba(0, 255, 136, 0.45);
+    }
+
+    .tag-same {
+      font-size: 10px;
+      letter-spacing: 0.6px;
+      padding: 2px 7px;
+      border-radius: 8px;
+      color: #5d7089;
+      background: rgba(255, 255, 255, 0.03);
+      border: 1px solid rgba(255, 255, 255, 0.07);
+    }
+
+    /* 支持版本有变化 → 整行高亮 + 左侧强调条 */
+    .info-row.changed {
+      position: relative;
+      border-color: rgba(0, 255, 157, 0.32);
+      background: rgba(0, 255, 157, 0.05);
+      box-shadow: inset 0 0 20px rgba(0, 255, 157, 0.07);
+    }
+
+    .info-row.changed::before {
+      content: '';
+      position: absolute;
+      left: 0;
+      top: 7px;
+      bottom: 7px;
+      width: 3px;
+      border-radius: 0 3px 3px 0;
+      background: linear-gradient(180deg, #00ff88, #00c8ff);
+      box-shadow: 0 0 10px rgba(0, 255, 136, 0.6);
+    }
+
+    /* ===== 更新文件列表 ===== */
+    .files {
+      position: relative;
+      z-index: 2;
+      margin: 14px 22px 0;
+      padding: 13px 15px;
+      border-radius: 11px;
+      background: rgba(255, 255, 255, 0.022);
+      border: 1px solid rgba(255, 255, 255, 0.055);
+    }
+
+    .files-head {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      margin-bottom: 9px;
+    }
+
+    .files-icon {
+      width: 26px;
+      height: 26px;
+      flex-shrink: 0;
+      border-radius: 8px;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 13px;
+      background: rgba(0, 200, 255, 0.1);
+      border: 1px solid rgba(0, 200, 255, 0.2);
+    }
+
+    .files-title {
+      font-size: 12px;
+      color: #5d7089;
+      letter-spacing: 0.6px;
+    }
+
+    .files-count {
+      margin-left: auto;
+      font-size: 12px;
+      font-weight: 800;
+      color: #00c8ff;
+      font-variant-numeric: tabular-nums;
+    }
+
+    .files-note {
+      margin-bottom: 8px;
+      font-size: 10.5px;
+      line-height: 1.5;
+      color: #7d8b9c;
+    }
+
+    .file-list {
+      display: flex;
+      flex-direction: column;
+      gap: 5px;
+      max-height: 190px;
+      overflow: hidden;
+    }
+
+    .file-row {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      font-size: 11.5px;
+      font-family: 'Cascadia Mono', 'Consolas', monospace;
+      color: #9fb3c6;
+      line-height: 1.45;
+    }
+
+    .file-kind {
+      flex-shrink: 0;
+      width: 34px;
+      text-align: center;
+      font-size: 9px;
+      font-weight: 800;
+      letter-spacing: 0.4px;
+      padding: 1px 0;
+      border-radius: 5px;
+      font-family: 'Segoe UI', 'Microsoft YaHei', sans-serif;
+    }
+
+    .file-kind.k-modified { color: #04121a; background: linear-gradient(135deg, #00ff88, #00c8ff); }
+    .file-kind.k-added    { color: #04121a; background: #00ff9d; }
+    .file-kind.k-removed  { color: #ffd9d9; background: rgba(255, 92, 92, 0.28); }
+    .file-kind.k-unknown  { color: #5d7089; background: rgba(255, 255, 255, 0.05); }
+
+    .file-path {
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
+    .files-more {
+      margin-top: 7px;
+      font-size: 10.5px;
+      color: #5d7089;
+    }
+
+    .files-empty {
+      font-size: 12px;
+      color: #5d7089;
+    }
+
+    /* ===== 附加文本 ===== */
+    .extra {
+      position: relative;
+      z-index: 2;
+      margin: 12px 22px 0;
+      padding: 11px 14px;
+      border-radius: 11px;
+      font-size: 12px;
+      line-height: 1.6;
+      color: #b9d4e8;
+      white-space: pre-wrap;
+      word-break: break-word;
+      background: rgba(0, 200, 255, 0.05);
+      border: 1px solid rgba(0, 200, 255, 0.16);
+    }
+
+    .extra:empty { display: none; }
+
+    /* ===== 底部 ===== */
+    .footer {
+      position: relative;
+      z-index: 2;
+      margin-top: 16px;
+      padding: 0 22px;
+      text-align: center;
+    }
+
+    .footer-line {
+      height: 1px;
+      background: linear-gradient(90deg, transparent, rgba(0, 200, 255, 0.2), transparent);
+      margin-bottom: 10px;
+    }
+
+    .footer-text {
+      font-size: 9.5px;
+      letter-spacing: 2.6px;
+      color: #22303e;
+      text-transform: uppercase;
+    }
+  </style>
+</head>
+<body>
+<div id="container">
+  <div class="grid-bg"></div>
+  <div class="glow-top"></div>
+  <div class="scan-line"></div>
+
+  <div class="header">
+    <div class="header-badge">📢</div>
+    <div class="header-text">
+      <div class="header-title">TRUCKERS<em>MP</em> 版本更新</div>
+      <div class="header-sub">Version Update Notice</div>
+    </div>
+    <div class="stage-tag" id="stage-tag"></div>
+  </div>
+
+  <div class="hero">
+    <div class="hero-caption">Version Changed</div>
+    <div class="versus">
+      <div class="ver old">
+        <div class="ver-label">旧版本</div>
+        <div class="ver-value" id="old-name">-</div>
+      </div>
+      <div class="arrow">
+        <svg width="52" height="26" viewBox="0 0 52 26" xmlns="http://www.w3.org/2000/svg">
+          <defs>
+            <!-- 注意：水平线的 objectBoundingBox 高度为 0，渐变会塌缩 → 必须用 userSpaceOnUse -->
+            <linearGradient id="arw" gradientUnits="userSpaceOnUse" x1="3" y1="13" x2="32" y2="13">
+              <stop offset="0%" stop-color="rgba(0,200,255,0.35)"/>
+              <stop offset="100%" stop-color="#00c8ff"/>
+            </linearGradient>
+          </defs>
+          <path d="M3 13 H32" stroke="url(#arw)" stroke-width="3" stroke-linecap="round"/>
+          <path d="M29 5 L39 13 L29 21" fill="none" stroke="#00ff88" stroke-width="3"
+                stroke-linecap="round" stroke-linejoin="round"/>
+        </svg>
+      </div>
+      <div class="ver new-ver">
+        <div class="new-flag">NEW</div>
+        <div class="ver-label">新版本</div>
+        <div class="ver-value" id="new-name">-</div>
+      </div>
+    </div>
+  </div>
+
+  <div class="info" id="info">
+    <div class="info-row">
+      <div class="info-icon">🕒</div>
+      <div class="info-key">更新时间</div>
+      <div class="info-val" id="time">-</div>
+    </div>
+    <div class="info-row hl" id="ets-row">
+      <div class="info-icon">🚛</div>
+      <div class="info-key">欧卡支持版本</div>
+      <div class="info-val" id="ets-ver"></div>
+    </div>
+    <div class="info-row hl" id="ats-row">
+      <div class="info-icon">🚚</div>
+      <div class="info-key">美卡支持版本</div>
+      <div class="info-val" id="ats-ver"></div>
+    </div>
+  </div>
+
+  <div class="files" id="files-block">
+    <div class="files-head">
+      <div class="files-icon">📦</div>
+      <div class="files-title">更新文件</div>
+      <div class="files-count" id="files-count"></div>
+    </div>
+    <div class="files-note" id="files-note"></div>
+    <div class="file-list" id="file-list"></div>
+    <div class="files-more" id="files-more"></div>
+  </div>
+
+  <div class="extra" id="extra"></div>
+
+  <div class="footer">
+    <div class="footer-line"></div>
+    <div class="footer-text">TruckersMP · Version Monitor</div>
+  </div>
+</div>
+
+<script>
+  /* 「旧 → 新」小箭头（纯实色描边，避开水平线渐变塌缩的坑） */
+  var MINI_ARROW =
+    '<svg class="mini-arrow" width="19" height="10" viewBox="0 0 19 10" xmlns="http://www.w3.org/2000/svg">' +
+    '<path d="M1 5 H12" stroke="#00c8ff" stroke-width="1.6" stroke-linecap="round"/>' +
+    '<path d="M10.5 1.5 L15 5 L10.5 8.5" fill="none" stroke="#00ff88" stroke-width="1.6"' +
+    ' stroke-linecap="round" stroke-linejoin="round"/></svg>';
+
+  function esc(s) {
+    return String(s == null ? '' : s)
+      .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+  }
+
+  function setText(id, value) {
+    var el = document.getElementById(id);
+    if (el) el.textContent = (value === undefined || value === null || value === '') ? '-' : String(value);
+  }
+
+  /**
+   * 渲染一条「游戏支持版本」：
+   * - 新旧都拿到且不同 → 旧(删除线) → 新(绿) + 「已更新」标签，整行高亮
+   * - 相同 / 拿不到旧值  → 只显示当前版本 + 「未变化」标签
+   */
+  function setGameVersion(valId, rowId, oldV, newV) {
+    var el = document.getElementById(valId);
+    var row = document.getElementById(rowId);
+    if (!el) return;
+    var hasOld = oldV !== undefined && oldV !== null && oldV !== '';
+    var hasNew = newV !== undefined && newV !== null && newV !== '';
+    var changed = hasOld && hasNew && String(oldV) !== String(newV);
+
+    if (changed) {
+      if (row) row.classList.add('changed');
+      el.innerHTML =
+        '<span class="v-from">' + esc(oldV) + '</span>' +
+        MINI_ARROW +
+        '<span class="v-to">' + esc(newV) + '</span>' +
+        '<span class="tag-chg">已更新</span>';
+      return;
+    }
+
+    if (row) row.classList.remove('changed');
+    if (!hasNew && !hasOld) {
+      el.innerHTML = '<span class="v-none">-</span>';
+      return;
+    }
+    el.innerHTML =
+      '<span class="v-same">' + esc(hasNew ? newV : oldV) + '</span>' +
+      '<span class="tag-same">未变化</span>';
+  }
+
+  /* 变化类型 → 展示用标签与样式类 */
+  var KIND_LABEL = { modified: '更新', added: '新增', removed: '移除', unknown: '文件' };
+
+  /* 卡片里最多列多少个文件（超出的用「等共 N 个」收尾，避免卡片无限长） */
+  var MAX_FILES_IN_CARD = 12;
+
+  /**
+   * 渲染更新文件区块。
+   * - filesUnavailable → 清单查询失败（不能显示成「没有变化」）
+   * - files 为空        → 确实没有文件变化
+   */
+  function setChangedFiles(files, snapshotMissing, unavailable) {
+    var list = Array.isArray(files) ? files : [];
+    var listEl = document.getElementById('file-list');
+    var countEl = document.getElementById('files-count');
+    var noteEl = document.getElementById('files-note');
+    var moreEl = document.getElementById('files-more');
+    if (!listEl) return;
+
+    if (countEl) countEl.textContent = list.length > 0 ? list.length + ' 个' : '';
+
+    if (unavailable) {
+      if (noteEl) noteEl.textContent = '';
+      if (moreEl) moreEl.textContent = '';
+      listEl.innerHTML = '<div class="files-empty">文件清单获取失败，无法比对变化</div>';
+      return;
+    }
+
+    if (list.length === 0) {
+      if (noteEl) noteEl.textContent = '';
+      if (moreEl) moreEl.textContent = '';
+      listEl.innerHTML = '<div class="files-empty">未检测到文件变化</div>';
+      return;
+    }
+
+    if (noteEl) {
+      noteEl.textContent = snapshotMissing
+        ? '未留存上次清单，以下为当前版本完整文件列表'
+        : '以下文件相对上次检查发生了 MD5 变化';
+    }
+
+    var shown = list.slice(0, MAX_FILES_IN_CARD);
+    listEl.innerHTML = shown.map(function (f) {
+      var kind = KIND_LABEL[f.kind] ? f.kind : 'unknown';
+      return '<div class="file-row">' +
+        '<span class="file-kind k-' + kind + '">' + KIND_LABEL[kind] + '</span>' +
+        '<span class="file-path" title="' + esc(f.path) + '">' + esc(f.path) + '</span>' +
+        '</div>';
+    }).join('');
+
+    if (moreEl) {
+      moreEl.textContent = list.length > shown.length
+        ? '… 等共 ' + list.length + ' 个文件'
+        : '';
+    }
+  }
+
+  function setData(data) {
+    data = data || {};
+    setText('old-name', data.oldName);
+    setText('new-name', data.newName);
+    setText('time', data.time);
+    setText('stage-tag', data.stage);
+    setGameVersion('ets-ver', 'ets-row', data.etsOld, data.etsNew);
+    setGameVersion('ats-ver', 'ats-row', data.atsOld, data.atsNew);
+    setChangedFiles(data.files, data.filesSnapshotMissing, data.filesUnavailable);
+
+    var extraEl = document.getElementById('extra');
+    if (extraEl) {
+      var extra = data.extraText == null ? '' : String(data.extraText).trim();
+      extraEl.textContent = extra;
+    }
+  }
+</script>
+</body>
+</html>

package/lib/util/tmpIdPicker.js

@@ -45,8 +45,7 @@ async function pickAll(ctx, session, bindingRows) {
     if (list.length === 0) {
         return { ids: [], total: 0, truncated: false, hint: null };
     }
-    // 补全旧数据缺失的玩家名（复用列表展示那套逻辑，保证提示文案准确）
-    await guildBind.ensureNames(ctx, list);
+    // 这里只用到 tmp_id（hint 只报数量，不显示名字）→ 不刷新名字，省接口
     const { ids, total, truncated } = resolveAll(list);
     return {
         ids,
@@ -195,9 +194,10 @@ function register(ctx) {
  */
 async function pick(ctx, session, bindings, opts = {}) {
     if (!bindings || bindings.length === 0) return [];
-    // 旧绑定的行没有名字：先查接口补全并写回，避免列表显示"未知"
-    await guildBind.ensureNames(ctx, bindings);
+    // 单绑定：不显示列表，直接返回 —— 此时没必要刷新名字（查询本身会显示真实名字）
     if (bindings.length === 1) return [String(bindings[0].tmp_id)];
+    // 要显示序号列表了：查接口刷新名字，保证玩家改名后列表及时同步
+    await guildBind.refreshNames(ctx, bindings);
     const allowMulti = opts.allowMulti !== false;
     const allowAll = opts.allowAll !== false;
     const max = allowMulti ? MAX_PICK : 1;

package/package.json

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