@ttmg/cli 0.4.4-beta.1 → 0.4.5

package/CHANGELOG.md

@@ -245,16 +245,6 @@ API 预检建议文案统一收敛，避免重复提示，阅读更清晰
 
 1. 启动模式新增 `inbox` 场景，支持在调试链路中模拟消息入口启动小游戏。
 
-## 0.4.0-beta.1
-
-本次测试版本主要补充直玩卡调试与上线链路，并优化能力接入助手体验：
-
-1. 能力接入助手的直玩卡联调流程扩展为三个阶段：先调试游戏包本身，再生成预览二维码验证卡面和承接路径，最后管理已验证直玩卡的上线状态。
-2. 阶段三新增「上线 / 下线直玩卡」能力，复用阶段二选中的直玩卡内容，调用平台接口修改直玩卡线上状态。
-3. 阶段三保留卡片名称、Content ID、场景、启动包、Queries 等信息，并单独展示「上线状态」，避免与阶段二「审核状态」混淆。
-4. 已上线卡片会展示「下线直玩卡」操作，未上线卡片展示「上线直玩卡」操作，确认后刷新最新线上状态。
-5. 优化直玩卡调试页面的区块间距，修复操作按钮与信息面板贴得过近的问题。
-
 ## 0.4.0
 
 修复游戏无开发权限时提示信息展示异常的问题，引导更准确。
@@ -266,12 +256,22 @@ API 预检建议文案统一收敛，避免重复提示，阅读更清晰
 1. 上传后的平台处理提示改为更易理解的文案，不再向开发者暴露平台内部状态码及 asset / ready 等技术字段，进度与失败原因表达更清晰。
 2. 重构上传成功卡片布局：二维码与版本信息分区展示并以分隔线区隔，新增成功状态标识，排版更紧凑协调。
 
-## 0.4.3
+## 0.4.4-beta.1
+
+支持版本：TikTok iOS 46.0+、TikTok Android 45.9+。
 
 新增子包收集能力：通过真机预览记录启动阶段实际预下载的子包，并生成预加载配置，帮助减少后续资源加载等待。当前仅支持非 Unity 小游戏。
 
 使用指南：https://bytedance.my.larkoffice.com/docx/MIyMdmzb0oOQAKxNHGNmR5hDyAh
 
-## 0.4.4-beta.1
+## 0.4.4
+
+支持版本：TikTok iOS 46.0+、TikTok Android 45.9+。
+
+正式开放子包收集能力：通过真机预览记录启动阶段实际预下载的子包，并生成预加载配置，帮助减少后续资源加载等待。当前仅支持非 Unity 小游戏。
+
+子包收集使用指南：https://bytedance.my.larkoffice.com/docx/MIyMdmzb0oOQAKxNHGNmR5hDyAh
+
+修复部分企业网络使用非标准局域网网段时，可扫码地址被误判为不可用的问题。
 
-开放直玩调试入口。开发者可以在能力接入页进入直玩调试，配置直玩启动模式、选择或创建直玩卡，并扫码验证直玩启动效果。
+提升本地调试连接稳定性：启动阶段短暂断连会自动恢复，刷新调试页面后可继续使用已连接设备。

package/dist/index.js

@@ -8726,169 +8726,94 @@ function listen$1() {
     });
 }
 
-function getLocalIPs() {
-    // 有线网卡关键词（Windows/macOS 常见 + 一些 Linux 命名）
-    const WIRED_KEYWORDS = [
-        'ethernet',
-        '以太网',
-        '本地连接',
-        'en',
-        'lan',
-        'enp',
-        'eno', // en0/en1, enp0s3...
-    ];
-    // 无线网卡关键词（Windows/macOS 常见 + 一些 Linux 命名）
-    const WIRELESS_KEYWORDS = [
-        'wi-fi',
-        'wifi',
-        '无线',
-        '无线网络连接',
-        'wlan',
-        'wlp',
-        'wl',
-        'airport', // 老旧 macOS/工具里偶见
-    ];
-    // 虚拟/隧道/容器/桥接等常见关键词
-    const VIRTUAL_INTERFACE_KEYWORDS = [
-        'vmware',
-        'virtual',
-        'docker',
-        'vbox',
-        'br-',
-        'bridge',
-        'tun',
-        'tap',
-        'hamachi',
-        'vEthernet',
-        'vnic',
-        'utun',
-        'hyper-v',
-        'loopback',
-        'lo',
-        'ppp',
-        'tailscale',
-        'zerotier',
-        'npcap',
-        'npf',
-        'wg',
-        'wireguard',
-        'anyconnect',
-        'teleport',
-    ];
-    // 判断是否为物理网卡（基于名称的启发式）
-    function isPhysicalInterface(name) {
-        const lower = name.toLowerCase();
-        return (WIRED_KEYWORDS.some(k => lower.includes(k)) ||
-            WIRELESS_KEYWORDS.some(k => lower.includes(k)));
-    }
-    // 判断是否为虚拟/隧道接口
-    function isVirtualInterface(name) {
-        const lower = name.toLowerCase();
-        return VIRTUAL_INTERFACE_KEYWORDS.some(k => lower.includes(k));
-    }
-    // 判断局域网私有 IPv4
-    function isPrivateIPv4(ip) {
-        return (ip.startsWith('10.') ||
-            ip.startsWith('192.168.') ||
-            /^172\.(1[6-9]|2\d|3[01])\./.test(ip));
-    }
-    // 兼容不同 Node 版本中 family 的类型（'IPv4' | 4）
-    function isIPv4Family(f) {
-        return f === 4 || f === 'IPv4';
-    }
-    const nets = os.networkInterfaces();
-    const results = [];
-    for (const name of Object.keys(nets)) {
-        const addrs = nets[name] || [];
-        // 先粗略排除明显虚拟接口
-        if (isVirtualInterface(name))
+const VIRTUAL_INTERFACE_PREFIX = /^(lo\d*|utun\d*|tun\d*|tap\d*|ppp\d*|ipsec\d*|wg\d*|tailscale\d*|zerotier\d*|veth|docker|br-|bridge|vmnet|vbox|anpi|awdl|llw|npf)/i;
+const VIRTUAL_INTERFACE_KEYWORDS = [
+    'vmware',
+    'virtual',
+    'hyper-v',
+    'vethernet',
+    'anyconnect',
+    'teleport',
+    'npcap',
+    'hamachi',
+];
+const WIRELESS_INTERFACE = /^(wl|wlan|wlp|wifi|wi-fi|airport)|无线|无线网络连接/i;
+const WIRED_INTERFACE = /^(en\d+|enp\w+|eno\w+|ens\w+|eth\w+)$|ethernet|\blan\b|以太网|本地连接/i;
+function isVirtualInterface(name) {
+    const lowerName = name.toLowerCase();
+    return (VIRTUAL_INTERFACE_PREFIX.test(lowerName) ||
+        VIRTUAL_INTERFACE_KEYWORDS.some(keyword => lowerName.includes(keyword)));
+}
+function getInterfaceRank(name) {
+    if (WIRELESS_INTERFACE.test(name))
+        return 0;
+    if (WIRED_INTERFACE.test(name))
+        return 1;
+    return 2;
+}
+function isPhysicalInterface(name) {
+    return getInterfaceRank(name) < 2;
+}
+function isPrivateIPv4(ip) {
+    return (ip.startsWith('10.') ||
+        ip.startsWith('192.168.') ||
+        /^172\.(1[6-9]|2\d|3[01])\./.test(ip));
+}
+function isUsableFallbackIPv4(ip) {
+    const parts = ip.split('.').map(Number);
+    if (parts.length !== 4 ||
+        parts.some(part => !Number.isInteger(part) || part < 0 || part > 255)) {
+        return false;
+    }
+    const [first, second] = parts;
+    return (first !== 0 &&
+        first !== 127 &&
+        first < 224 &&
+        !(first === 169 && second === 254));
+}
+function isIPv4Family(family) {
+    return family === 4 || family === 'IPv4';
+}
+function selectLocalIPs(nets) {
+    const privateResults = [];
+    const physicalFallbacks = [];
+    for (const [name, addrs] of Object.entries(nets)) {
+        if (!addrs || isVirtualInterface(name) || !isPhysicalInterface(name)) {
             continue;
-        // 需要看地址再判断是否物理
-        // 有些系统的命名不标准，允许在地址层面兜底
-        let matchedPhysicalName = isPhysicalInterface(name);
+        }
         for (const net of addrs) {
-            if (!isIPv4Family(net.family))
+            if (!isIPv4Family(net.family) ||
+                net.internal ||
+                !net.address) {
                 continue;
-            if (net.internal)
-                continue;
-            if (!net.address || !isPrivateIPv4(net.address))
-                continue;
-            // 若名称判断不通过，但地址是私有网段、且非回环/非内网，考虑接纳
-            // 但排除明显虚拟（已经在上面过滤 name）
-            if (matchedPhysicalName || shouldAcceptByHeuristic(name, net.address)) {
-                results.push({ name, address: net.address });
             }
-        }
-    }
-    // 去重（同名+同地址）
-    const unique = dedupe(results);
-    // 稳定排序：优先无线，再有线，再其他。
-    // 说明：扫码调试场景下，手机通常在 Wi-Fi，优先选择无线网卡的 IP 更不容易踩到
-    // “有线网段不可达/企业网络隔离”的坑。
-    unique.sort((a, b) => {
-        const rank = (n) => {
-            const lower = n.toLowerCase();
-            if (WIRELESS_KEYWORDS.some(k => lower.includes(k)))
-                return 0;
-            if (WIRED_KEYWORDS.some(k => lower.includes(k)))
-                return 1;
-            return 2;
-        };
-        const ra = rank(a.name);
-        const rb = rank(b.name);
-        if (ra !== rb)
-            return ra - rb;
-        // 同级按名称自然排序
-        return a.name.localeCompare(b.name, undefined, { numeric: true });
-    });
-    return unique.map(item => item.address);
-    // 兜底启发式：如果名字不明显，但常见物理命名模式且 IP 为私网，接受
-    function shouldAcceptByHeuristic(name, ip) {
-        name.toLowerCase();
-        // macOS: en0/en1
-        if (/^en\d+$/i.test(name))
-            return true;
-        // Linux: enpXsY / enoX / wlpXsY
-        if (/^(enp|eno|wlp)\w+$/i.test(name))
-            return true;
-        // Windows: 以太网 / Wi-Fi（非虚拟已过滤）
-        if (/(以太网|本地连接|wi-?fi|无线)/.test(name))
-            return true;
-        return false;
-    }
-    function dedupe(arr) {
-        const seen = new Set();
-        const out = [];
-        for (const item of arr) {
-            const key = `${item.name}|${item.address}`;
-            if (!seen.has(key)) {
-                seen.add(key);
-                out.push(item);
+            const target = isPrivateIPv4(net.address)
+                ? privateResults
+                : physicalFallbacks;
+            if (isPrivateIPv4(net.address) ||
+                isUsableFallbackIPv4(net.address)) {
+                target.push({ name, address: net.address });
             }
         }
-        return out;
     }
+    const candidates = privateResults.length > 0 ? privateResults : physicalFallbacks;
+    const seen = new Set();
+    return candidates
+        .sort((a, b) => {
+        const rankDiff = getInterfaceRank(a.name) - getInterfaceRank(b.name);
+        return (rankDiff ||
+            a.name.localeCompare(b.name, undefined, { numeric: true }));
+    })
+        .filter(item => {
+        if (seen.has(item.address))
+            return false;
+        seen.add(item.address);
+        return true;
+    })
+        .map(item => item.address);
 }
-
-function getLocalIP() {
-    // 优先使用 getLocalIPs 的过滤 + 排序结果（更适合扫码调试场景）
-    const preferred = getLocalIPs()[0];
-    if (preferred) {
-        return preferred;
-    }
-    const networkInterfaces = os.networkInterfaces();
-    for (const interfaceName in networkInterfaces) {
-        const interfaceInfo = networkInterfaces[interfaceName];
-        if (!interfaceInfo)
-            continue;
-        for (const addressInfo of interfaceInfo) {
-            if (addressInfo.family === 'IPv4' && !addressInfo.internal) {
-                return addressInfo.address;
-            }
-        }
-    }
-    // 极端场景：无可用 IPv4（例如仅有回环/无网络）。避免返回 undefined 破坏 schema。
-    return '127.0.0.1';
+function getLocalIPs() {
+    return selectLocalIPs(os.networkInterfaces());
 }
 
 async function init(options = {}) {
@@ -9395,6 +9320,8 @@ const gameConfigRoute = {
         const user = getCurrentUser();
         const { clientKey } = getClientKey();
         const localLang = getConfiguredLanguage();
+        const localIPs = getLocalIPs();
+        const localHost = localIPs[0] || '127.0.0.1';
         res.send({
             error: null,
             data: {
@@ -9403,7 +9330,7 @@ const gameConfigRoute = {
                 nodeServerPort: store.getState().nodeServerPort,
                 nodeWsPort: store.getState().nodeWsPort,
                 clientKey,
-                schema: `https://www.tiktok.com/ttmg/dev/${clientKey}?host=${getLocalIP()}&port=${store.getState().nodeWsPort}&host_list=${encodeURIComponent(JSON.stringify(getLocalIPs()))}`,
+                schema: `https://www.tiktok.com/ttmg/dev/${clientKey}?host=${localHost}&port=${store.getState().nodeWsPort}&host_list=${encodeURIComponent(JSON.stringify(localIPs))}`,
                 ...basic,
                 devToolVersion,
                 checkResult,
@@ -9466,28 +9393,79 @@ const gameCheckRoute = {
 
 const changelog = [
     {
-        title: '0.4.4-beta.1',
+        title: '0.4.5',
         target: {
-            iOS: '>=43.1',
-            Android: '>=43.1',
+            iOS: '>=46.0',
+            Android: '>=45.9',
+        },
+        changes: {
+            optimize: [
+                {
+                    desc: {
+                        'zh-CN': '优化调试会话信息展示：开发者选项以独立状态标签呈现，便于快速确认域名校验、vConsole 和开发信息面板的启用状态。',
+                        'en-US': 'Improve debugging session details by showing developer options as separate status tags, making it easier to verify domain validation, vConsole, and the developer information panel.',
+                    },
+                    module: 'devOptions',
+                },
+                {
+                    desc: {
+                        'zh-CN': '优化扫码网络异常提示：未检测到可用局域网地址时不再展示无效二维码，并引导设置连接地址。',
+                        'en-US': 'Improve scan-to-connect network guidance: hide unusable QR codes when no local network address is available and guide developers to set a connection address.',
+                    },
+                    module: 'scanQrcode',
+                },
+            ],
+            bugfix: [
+                {
+                    desc: {
+                        'zh-CN': '修复子包收集页面在部分环境下无法打开的问题。',
+                        'en-US': 'Fix an issue where the Subpackage Collection page could fail to open in some environments.',
+                    },
+                    module: 'new',
+                },
+            ],
+        },
+    },
+    {
+        title: '0.4.4',
+        target: {
+            iOS: '>=46.0',
+            Android: '>=45.9',
         },
         changes: {
             feature: [
                 {
                     desc: {
-                        'zh-CN': '开放直玩调试入口：可在能力接入页配置直玩启动模式、选择或创建直玩卡，并扫码验证直玩启动效果。',
-                        'en-US': 'Open Direct Play debugging: configure a Direct Play launch mode, select or create a Direct Play card, and scan the QR code to validate the launch experience.',
+                        'zh-CN': '正式开放子包收集能力：通过真机预览记录启动阶段实际预下载的子包，并生成预加载配置，帮助减少后续资源加载等待。当前仅支持非 Unity 小游戏。',
+                        'en-US': 'Open Subpackage Collection: use real-device preview to record subpackages downloaded during startup and generate preload configuration, helping reduce subsequent resource loading waits. Currently available for non-Unity mini games only.',
                     },
                     module: 'new',
+                    link: 'https://bytedance.my.larkoffice.com/docx/MIyMdmzb0oOQAKxNHGNmR5hDyAh',
+                },
+            ],
+            bugfix: [
+                {
+                    desc: {
+                        'zh-CN': '修复部分企业网络使用非标准局域网网段时，可扫码地址被误判为不可用的问题。',
+                        'en-US': 'Fix an issue where scannable addresses could be incorrectly reported as unavailable on enterprise networks using non-standard local subnets.',
+                    },
+                    module: 'scanQrcode',
+                },
+                {
+                    desc: {
+                        'zh-CN': '提升本地调试连接稳定性：启动阶段短暂断连会自动恢复，刷新调试页面后可继续使用已连接设备。',
+                        'en-US': 'Improve local debugging connection stability: recover from transient startup disconnects and retain the connected device after the debugging page is refreshed.',
+                    },
+                    module: 'scanQrcode',
                 },
             ],
         },
     },
     {
-        title: '0.4.3',
+        title: '0.4.4-beta.1',
         target: {
-            iOS: '>=43.1',
-            Android: '>=43.1',
+            iOS: '>=46.0',
+            Android: '>=45.9',
         },
         changes: {
             feature: [
@@ -14007,7 +13985,7 @@ async function upload({ clientKey, note = '--', dir, }) {
     }
 }
 
-var version = "0.4.4-beta.1";
+var version = "0.4.5";
 var pkg = {
 	version: version};