@ttmg/cli 0.4.4 → 0.4.5

package/CHANGELOG.md

@@ -0,0 +1,277 @@
+## 0.1.0
+
+发布正式版本，支持 H5 小游戏和原生小游戏的初始化、开发调试和打包构建。支持 Windows 系统
+
+## 0.1.0-beta.1
+
+移除 Client WS 端口和 Http 端口默认 -1 的配置，变成通过和 Node CLI 通信显示发端口
+
+## 0.1.0-beta.8
+
+支持自动打开浏览器，且聚焦在 devTools 窗口
+
+## 0.1.0-beta.9
+
+1. 支持文件上传进度显示
+2. 支持自动打开浏览器调试模式
+
+## 0.1.0-beta.10
+
+fix: 修复还未完成新编译就直接上传了的问题
+
+## 0.1.0-beta.11
+
+feat: 先关闭自动上传能力
+
+## 0.1.0-beta.12
+
+feat: 支持文件变更监听，告知浏览器文件变更，提醒开发者重新加载游戏
+
+## 0.1.0-beta.13
+
+1. 支持 sourcemap
+2. 优化上传环节产物，过滤 sourcemap 文件，提高上传效率
+
+## 0.1.0-beta.14
+
+1. 修复 client key 未成功写入 mock meta 的问题，导致不一致
+
+## 0.1.0-beta.15
+
+1. 还原 open url 历史方法
+
+## 0.1.1
+
+发布最新版本，提醒开发者升级最新版本
+
+## 0.1.2
+
+发布最新版本，支持 sourcemap
+
+## 0.1.3-beta.1
+
+优化显示二维码问题
+
+## 0.1.3-beta.2
+
+彻底修复二维码兼容问题
+
+## 0.1.3-beta.3
+
+修复 sourcemap 错乱问题
+
+## 0.1.3-beta.4
+
+修复循环依赖问题
+
+## 0.1.3-beta.5
+
+修复监听文件变化报错问题
+
+## 0.1.3
+
+发布优化版本 CLI
+
+## 0.1.4
+
+优化页面交互
+
+## 0.1.5
+
+1.fix: 控制台报错问题 2. feat: 优化
+
+## 0.1.6
+
+1. 优化控制台报错日志
+2. 优化调试启动环节耗时
+
+## 0.1.7
+
+- 修复 Windows 调试资源加载失败问题
+
+## 0.1.8
+
+优化 DevTool 网页端启动时间
+
+## 0.1.9-beta.1
+
+发布测试版本，供客户端调试使用
+
+## 0.1.9-beta.2
+
+发布测试版本，用于 Windows 测试
+
+## 0.1.9
+
+发布正式版本，支持
+
+- login
+- 支持上传游戏包
+- 支持启动模式
+- 支持 Debug Settings
+
+## 0.2.0-beta.1
+
+发布测试版本，用于 Windows 测试 login 登录异常逻辑
+
+## 0.2.0
+
+发布正式版本，支持 Windows 登录加载报错提示
+
+## 0.2.1
+
+1. 移除项目详情部分，比较冗余，不常用，融合到代码预检中
+2. 打开调试页面地址增加 version 参数，来规避新老版本缓存问题和不同网页之间的隔离（未来支持）
+3. 优化登录失败提示，增加网络检查提示，并给出如何修改网络设置的文档链接
+4. 补充发送 meta 至客户端链路，增加调试链路日志信息，便于排查问题
+
+## 0.2.2
+
+1. 修复访问无权限的小游戏，顶部报错问题
+
+## 0.2.3
+
+优化扫码连接不上问题，支持手动绑定电脑本地 IP 地址
+
+## 0.2.4
+
+支持新的 DevTool 平台
+
+## 0.2.5
+
+1. 增加不在游戏根目录启动调试校验
+2. 支持手动绑定客户端 IP 地址和端口
+3. 调整启动模式中的场景列表表达文案
+4. 修复文件上传问题，避免偶现上传失败
+5. 支持展示游戏详情模块，支持开发者查看当前小游戏基本信息
+6. 支持调试环节消费平台配置的域名
+7. 升级 ttmg-pack 0.1.7，修复构建环节对开发者 JS 代码降级的问题
+8. 文档新增常见问题部分，替换原有的开发文档
+
+## 0.2.6
+
+修复启动模式中场景列表展示问题，重复展示默认启动模式
+
+## 0.2.7
+1. 升级 ttmg-pack 0.2.3，调整 esbuild 配置，目标 es2020
+2. 支持校验子包配置文件名是否符合规范，对于非法文件名，提示开发者修改
+3. 调整域名校验默认逻辑，默认开启，校验失败时，提示开发者修改
+
+## 0.2.8
+1. 升级 ttmg-pack 0.2.4，修复 open data context 文件丢失问题
+
+## 0.2.9
+1. 升级 ttmg-pack 0.2.5，修复 open data context 打包问题
+## 0.3.0
+新增/优化功能适用 TikTok 版本 iOS >=43.1 | Android>=43.1
+支持了开发信息蒙层，打开后可以查看游戏 FPS、设备信息、调试开关等信息，便于查看游戏运行状态 了解如何使用
+支持删除历史启动模式，便于管理历史启动模式
+调整调试设置模块名称为开发选项，和客户端内调开发者选项保持一致 了解如何使用
+调试设置新增定义 vConsole 和 开发信息浮层设置
+支持了变更日志，用户可以在调试环境下查看游戏的变更记录，部分新功能可通过更多信息查看使用
+支持了调试设置开关本地缓存，避免每次都需要重新设置
+修复上传名称为中文的游戏时，平台展示乱码的问题
+修复启动模式模块，自定义query 参数无法持久化的问题
+修复扫描二维码模块，内容过多，纵向无法滚动问题
+
+## 0.3.1
+- 支持 unity 小游戏本地一些列调试功能，如 Wasm 分包、包大小校验、一键上传代码包至平台等 了解如何使用
+- 增加用户登录过期的异常提示，提醒开发者重新登录
+- 优化上传代码包至平台功能，开发者只用添加描述后点击上传便可自动压缩当前目录下的代码包上传至开发者平台
+- 优化 ttmg login 终端网络代理异常导致无法登录的报错引导，提示用户检查网络设置
+
+## 0.3.2-beta.1
+支持 cocos 2.0 openDataContext 相关适配
+
+## 0.3.2
+- 小游戏详情查询升级到 TikTok DevPortal v4 `devtool/info` 接口，字段映射更完整
+- 支持一键打包当前目录并上传代码包到开发者平台；上传失败提示更明确，文件名非法字符自动处理
+- Unity Wasm 分包：更新 `game.json` 子包配置写入逻辑（兼容 `subpackages`/`subPackages` 字段），Android/iOS main/sub 配置去重合并
+- 启动校验增强：检查是否在小游戏根目录执行，并提示 `subPackages` 拼写错误
+增加对 unity 是否需要分包的检查，对于需要分包的 unity 项目，给出明确提示
+支持通过 `ttmg setup` 配置 CLI 语言，调试环境会跟随语言设置展示文案，首次调试时会自动同步默认语言，后续 CLI 与 IDE 语言保持一致，减少反复切换
+调试与预检支持多语言展示，关键提示与校验信息更易理解
+支持 Cocos 2.0 openDataContext 配置
+变更记录新增提醒功能，当有新版本发布时，会通过弹窗提醒开发者更新
+ttmg login 支持 ttmg login --verbose 参数，打印更多登录信息
+API 预检建议文案统一收敛，避免重复提示，阅读更清晰
+顶部区域透出项目预检错误与警告信息，便于开发者及时发现问题并修复
+语言选择策略优化：优先使用 CLI 本地设置，未设置时自动回退浏览器语言
+启动校验增强：检查是否在小游戏根目录执行，对于分包配置 subPackages 给出明确报错，引导开发者修改为 subpackages
+修复项目详情中展示的主包大小限制和代码预检不一致的情况
+
+## 0.3.3
+升级 ttmg-pack 到 0.4.5，解决安卓无法调试 unity 项目问题
+
+## 0.3.4
+优化校验逻辑，给出提示
+
+## 0.3.5
+优化连接和代理，帮助开发者自助解决问题
+
+## 0.3.6
+修复分包过程超时问题
+
+## 0.3.7
+新增/优化功能适用 TikTok 版本 iOS >=43.1 | Android >=43.1
+
+1. 新增能力接入助手，帮助开发者基于小游戏变现类型获取关键能力的接入引导。
+2. 优化上传发布环节，将代码预检与代码上传整合为完整的上传发布流程。
+3. 扩充包体大小预检说明，补充整包、主包、独立分包限制规则与详细文档入口，便于开发者理解和处理包体超限问题。
+
+## 0.3.8
+修复 `ttmg login` 后接口鉴权异常的问题：
+
+1. 登录时把 `Set-Cookie` 响应头中的 `Path / Domain / Max-Age / Expires / Secure / HttpOnly / SameSite` 等属性被当成 cookie 拼接到 `Cookie` 字段，导致 CLI 发请求时把属性当成"假 cookie"一并带上。
+2. 同一域名下同名 cookie（例如服务端用 `Max-Age=0` 显式删除的占位 cookie）也会被一起发送，污染掉真正有效的同名 cookie，浏览器会自动过滤这种情况，CLI 不会，造成登录态接口异常。
+3. 修复后与浏览器行为保持一致：剥离 cookie 属性、过滤 `Max-Age<=0` 或 `Expires` 已过期的 cookie，仅保留 `name=value` 用于请求。
+4. 已登录用户无需重新登录，下次发起请求时会自动清洗 rc 中已存的脏数据。
+
+## 0.3.9
+本次主要优化调试 IDE 的视觉、交互与多语言一致性：
+
+1. 调试 IDE 默认使用浅色主题，暗色模式改为开发者手动开启并记忆选择，避免跟随系统强制进入暗色导致不适应。
+2. 优化暗色模式下二维码显示，调整背景避免过亮刺眼，同时保证扫码识别率。
+3. Wasm 分包页面及相关组件补齐多语言，修复此前页面文案中英文混排的问题。
+4. 能力接入助手页面视觉升级：变现模式卡片新增图标与强调色，关键能力标签按「必需 / 可选 / 实验」分级展示，信息层级更清晰。
+5. 完成扫码连接后，首页标题与说明文案会切换为「已连接」状态，状态反馈更明确。
+6. 新版本提示由红点改为「有更新」文字标签，含义更直观。
+7. 上传游戏包按钮配色与产品主题色统一。
+8. 修复多个页面中标题与正文内容未对齐的问题，整体排版更整齐。
+9. 文案细节调整：「身份与授权」更名为「登录与授权」；移除侧边栏冗余的「查看文档」入口。
+
+## 0.3.9-beta.1
+本次测试版本主要补充启动模式场景能力，并优化场景命名可理解性：
+
+1. 启动模式新增 `inbox` 场景，支持在调试链路中模拟消息入口启动小游戏。
+
+## 0.4.0
+
+修复游戏无开发权限时提示信息展示异常的问题，引导更准确。
+
+## 0.4.1
+
+优化上传代码包流程：
+
+1. 上传后的平台处理提示改为更易理解的文案，不再向开发者暴露平台内部状态码及 asset / ready 等技术字段，进度与失败原因表达更清晰。
+2. 重构上传成功卡片布局：二维码与版本信息分区展示并以分隔线区隔，新增成功状态标识，排版更紧凑协调。
+
+## 0.4.4-beta.1
+
+支持版本：TikTok iOS 46.0+、TikTok Android 45.9+。
+
+新增子包收集能力：通过真机预览记录启动阶段实际预下载的子包，并生成预加载配置，帮助减少后续资源加载等待。当前仅支持非 Unity 小游戏。
+
+使用指南：https://bytedance.my.larkoffice.com/docx/MIyMdmzb0oOQAKxNHGNmR5hDyAh
+
+## 0.4.4
+
+支持版本：TikTok iOS 46.0+、TikTok Android 45.9+。
+
+正式开放子包收集能力：通过真机预览记录启动阶段实际预下载的子包，并生成预加载配置，帮助减少后续资源加载等待。当前仅支持非 Unity 小游戏。
+
+子包收集使用指南：https://bytedance.my.larkoffice.com/docx/MIyMdmzb0oOQAKxNHGNmR5hDyAh
+
+修复部分企业网络使用非标准局域网网段时，可扫码地址被误判为不可用的问题。
+
+提升本地调试连接稳定性：启动阶段短暂断连会自动恢复，刷新调试页面后可继续使用已连接设备。

package/dist/index.js

@@ -8726,186 +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));
-    }
-    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);
-    }
-    // 兼容不同 Node 版本中 family 的类型（'IPv4' | 4）
-    function isIPv4Family(f) {
-        return f === 4 || f === 'IPv4';
+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 nets = os.networkInterfaces();
+    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 of Object.keys(nets)) {
-        const addrs = nets[name] || [];
-        // 先粗略排除明显虚拟接口
-        if (isVirtualInterface(name))
+    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))
-                continue;
-            if (net.internal)
-                continue;
-            if (!net.address)
+            if (!isIPv4Family(net.family) ||
+                net.internal ||
+                !net.address) {
                 continue;
-            if (isPrivateIPv4(net.address)) {
-                // 若名称判断不通过，但地址是私有网段、且非回环/非内网，考虑接纳
-                // 但排除明显虚拟（已经在上面过滤 name）
-                if (matchedPhysicalName || shouldAcceptByHeuristic(name)) {
-                    privateResults.push({ name, address: net.address });
-                }
             }
-            else if (matchedPhysicalName && isUsableFallbackIPv4(net.address)) {
-                // 部分企业网络会给物理网卡分配非 RFC1918 地址。仅在没有私网地址时兜底，
-                // 避免把真实 Wi-Fi / 有线网卡误判为“没有可供手机访问的地址”。
-                physicalFallbacks.push({ name, address: net.address });
+            const target = isPrivateIPv4(net.address)
+                ? privateResults
+                : physicalFallbacks;
+            if (isPrivateIPv4(net.address) ||
+                isUsableFallbackIPv4(net.address)) {
+                target.push({ name, address: net.address });
             }
         }
     }
-    const results = privateResults.length > 0 ? privateResults : physicalFallbacks;
-    // 去重（同名+同地址）
-    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) {
-        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);
-            }
-        }
-        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 = {}) {
@@ -9412,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: {
@@ -9420,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,
@@ -9482,6 +9392,40 @@ const gameCheckRoute = {
 };
 
 const changelog = [
+    {
+        title: '0.4.5',
+        target: {
+            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: {
@@ -9507,6 +9451,13 @@ const changelog = [
                     },
                     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',
+                },
             ],
         },
     },
@@ -14034,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};