@ttmg/cli 0.3.2-beta.5 → 0.3.2-beta.6

package/dist/index.js

@@ -3,205 +3,59 @@
 
 var commander = require('commander');
 var inquirer = require('inquirer');
-var fs = require('fs');
-var jsdom = require('jsdom');
-var prettier = require('prettier');
-var chalk = require('chalk');
-var express = require('express');
 var path = require('path');
-var cheerio = require('cheerio');
 var os = require('os');
-var worker_threads = require('worker_threads');
 var axios = require('axios');
-var qs = require('qs');
+var fs = require('fs');
 var handlebars = require('handlebars');
 var esbuild = require('esbuild');
+var chalk = require('chalk');
+var boxen = require('boxen');
+var semver = require('semver');
+var jsdom = require('jsdom');
+var prettier = require('prettier');
+var express = require('express');
+var cheerio = require('cheerio');
 var archiver = require('archiver');
 var chokidar = require('chokidar');
 var WebSocket = require('ws');
+var worker_threads = require('worker_threads');
 var glob = require('glob');
 var got = require('got');
 var FormData$1 = require('form-data');
 var stream = require('stream');
 var ttmgPack = require('ttmg-pack');
-var boxen = require('boxen');
 var http = require('http');
+var expressStaticGzip = require('express-static-gzip');
+var fileUpload = require('express-fileupload');
 var fs$1 = require('node:fs');
 var path$1 = require('node:path');
 var zlib = require('zlib');
 var promises = require('fs/promises');
-var expressStaticGzip = require('express-static-gzip');
-var fileUpload = require('express-fileupload');
+var qs = require('qs');
 
 function _interopNamespaceDefault(e) {
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
         });
-      }
-    });
-  }
-  n.default = e;
-  return Object.freeze(n);
+    }
+    n.default = e;
+    return Object.freeze(n);
 }
 
-var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 var os__namespace = /*#__PURE__*/_interopNamespaceDefault(os);
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
 var glob__namespace = /*#__PURE__*/_interopNamespaceDefault(glob);
 
-const CONFIG_FILE_NAME = 'minigame.config.json';
-const SDK_URL = 'https://connect.tiktok-minis.com/game/sdk.js';
-const VCONSOLE_URL = 'https://connect.tiktok-minis.com/libs/vConsole.js';
-const VCONSOLE_INIT = `
-    if(typeof VConsole === 'function') {
-      window.vConsole = new VConsole();
-    }
-  `;
-const MINIS_MANIFEST_FILE_NAME = 'minis.manifest.json';
-const MINIS_RUNTIME_URL = 'https://www.tiktok.com/minigames/runtime';
-
-const { JSDOM } = jsdom;
-const CONFIG_PATH$1 = `${process.cwd()}/${CONFIG_FILE_NAME}`;
-const INDEX_HTML_PATH = `${process.cwd()}/index.html`;
-function isSandbox(clientKey) {
-    /**
-     * sb 开头的 clientKey 都是 sandbox 环境
-     */
-    return clientKey.startsWith('sb');
-}
-// 判断是否是 TTMinis.game.init 的初始化脚本
-function isTTMinisInitScript(script, clientKey) {
-    if (!script.innerHTML) {
-        return false;
-    }
-    return (script.innerHTML.includes('TTMinis.game.init') &&
-        script.innerHTML.includes(clientKey));
-}
-async function injectScripts({ config, clientKey }) {
-    // 1. 检查 config 文件是否已存在
-    fs.writeFileSync(CONFIG_PATH$1, JSON.stringify(config, null, 2));
-    // 2. 读取 index.html
-    if (!fs.existsSync(INDEX_HTML_PATH)) {
-        console.error('index.html does not exist');
-        return;
-    }
-    const indexHtml = fs.readFileSync(INDEX_HTML_PATH, 'utf8');
-    const dom = new JSDOM(indexHtml);
-    const { document } = dom.window;
-    // 3. head 标签
-    let head = document.querySelector('head');
-    if (!head) {
-        head = document.createElement('head');
-        document.documentElement.insertBefore(head, document.body);
-    }
-    // 4. 检查是否已注入 SDK
-    const scriptList = Array.from(document.querySelectorAll('script'));
-    const hasSDK = scriptList.some(script => script.src && script.src.includes(SDK_URL));
-    // 5. 检查是否已注入 vConsole
-    const hasVConsole = scriptList.some(script => script.src && script.src.includes('vConsole.js'));
-    let lastInitScript = null;
-    if (!hasSDK) {
-        // 插入 SDK 脚本
-        const sdkScript = document.createElement('script');
-        sdkScript.src = SDK_URL;
-        head.insertBefore(sdkScript, head.firstChild);
-        // 插入 SDK init 脚本
-        const initScript = document.createElement('script');
-        initScript.innerHTML = `
-      window.TTMinis = TTMinis;
-      TTMinis.game.init({
-        clientKey: "${clientKey}",
-      });
-    `;
-        head.insertBefore(initScript, sdkScript.nextSibling);
-        lastInitScript = initScript;
-    }
-    else {
-        // 已经有 SDK，查找 TTMinis.game.init 脚本
-        const headScripts = Array.from(head.querySelectorAll('script'));
-        lastInitScript = headScripts.find(script => isTTMinisInitScript(script, clientKey));
-        if (lastInitScript) {
-            console.log('JS SDK 已接入，跳过 SDK 相关脚本注入');
-        }
-        else {
-            // 没有 TTMinis.game.init，则查找最后一个 SDK 脚本
-            const sdkScripts = headScripts.filter(script => script.src && script.src.includes(SDK_URL));
-            if (sdkScripts.length > 0) {
-                lastInitScript = sdkScripts[sdkScripts.length - 1];
-            }
-        }
-    }
-    /**
-     * 只有 Sandbox 环境才需要注入 vConsole
-     */
-    if (isSandbox(clientKey)) {
-        console.log('Sandbox 环境，跳过 vConsole 相关脚本注入');
-        // 8. 插入 vConsole 相关脚本（如果需要）
-        if (!hasVConsole) {
-            // vConsole 相关脚本的插入点
-            let insertAfterNode = lastInitScript;
-            if (insertAfterNode) {
-                insertAfterNode = insertAfterNode.nextSibling;
-            }
-            else {
-                insertAfterNode = head.firstChild;
-            }
-            // vConsole 源码
-            const vconsoleSourceScript = document.createElement('script');
-            vconsoleSourceScript.src = VCONSOLE_URL;
-            // vConsole 初始化
-            const vconsoleInitScript = document.createElement('script');
-            vconsoleInitScript.innerHTML = VCONSOLE_INIT;
-            head.insertBefore(vconsoleSourceScript, insertAfterNode);
-            head.insertBefore(vconsoleInitScript, insertAfterNode);
-        }
-    }
-    // 9. 格式化并写回 index.html
-    const formattedHtml = await prettier.format(dom.serialize(), {
-        parser: 'html',
-    });
-    fs.writeFileSync(INDEX_HTML_PATH, formattedHtml);
-    console.log(chalk.green.bold('TikTok H5 Mini Game initialization has been completed...'));
-}
-
-function init$1() {
-    const promptModule = inquirer.createPromptModule();
-    promptModule([
-        {
-            type: 'input',
-            name: 'clientKey',
-            message: 'Please input client key',
-        },
-        {
-            type: 'input',
-            name: 'devPort',
-            message: 'Please input dev port',
-            default: 9527,
-        },
-    ])
-        .then(async (answers) => {
-        const { clientKey, devPort } = answers;
-        const config = {
-            _comment: 'orientation is the orientation of the game. It can be either \'VERTICAL\' or \'HORIZONTAL\'.our game default is VERTICAL; minigame.config.json dev is a configuration file for minigame development. You can use it to configure the minigame.',
-            orientation: 'VERTICAL',
-            dev: {
-                port: devPort,
-            },
-        };
-        await injectScripts({ clientKey, config });
-        process.exit(0);
-    })
-        .catch(() => {
-        process.exit(1);
-    });
-}
-
 async function openUrl(url) {
     const { launch } = await import('chrome-launcher');
     try {
@@ -209,7 +63,7 @@ async function openUrl(url) {
         await launch({
             startingUrl: url,
             chromeFlags: [
-                '--auto-open-devtools-for-tabs', // 自动打开 DevTools
+                '--auto-open-devtools-for-tabs',
                 '--no-default-browser-check',
                 '--allow-insecure-localhost',
                 '--allow-running-insecure-content',
@@ -217,6 +71,7 @@ async function openUrl(url) {
                 `--user-data-dir=${userDataDir}`,
                 '--disk-cache-size=0',
                 '--media-cache-size=0',
+                '--disable-web-security',
             ],
         });
         await new Promise(resolve => { });
@@ -224,46 +79,18 @@ async function openUrl(url) {
     }
     catch (e) {
         return false;
-        // return Promise.reject(e);
-    }
-}
-
-function getLocalIP() {
-    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;
-            }
-        }
     }
 }
 
-async function checkUpdate() {
-    const worker = new worker_threads.Worker(path.resolve(__dirname, './scripts/worker.js'));
-    worker.on('message', msg => {
-        // console.log(msg);
-    });
-    worker.on('error', err => {
-        console.error(err);
-    });
-    worker.postMessage({
-        type: 'checkUpdate',
-    });
-}
-
-const CONFIG_PATH = process.env.TTMGRC_PATH || path.join(os.homedir(), '.ttmgrc');
+const CONFIG_PATH$1 = process.env.TTMGRC_PATH || path.join(os.homedir(), '.ttmgrc');
 const getTTMGRC = () => {
     // only check one time
-    if (!fs.existsSync(CONFIG_PATH)) {
+    if (!fs.existsSync(CONFIG_PATH$1)) {
         return null;
     }
     else {
         // safe parse
-        let res = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
+        let res = JSON.parse(fs.readFileSync(CONFIG_PATH$1, 'utf8'));
         return res;
     }
 };
@@ -271,198 +98,36 @@ const setTTMGRC = (config) => {
     // updata cache config
     config = config;
     const originConfig = getTTMGRC() || {};
-    fs.writeFileSync(CONFIG_PATH, JSON.stringify({ ...originConfig, ...config }));
+    fs.writeFileSync(CONFIG_PATH$1, JSON.stringify({ ...originConfig, ...config }));
 };
-
-function printMessage(type, message) {
-    const prefix = type === 'Error' ? chalk.red('Error: ') : chalk.yellow('Warning: ');
-    const log = type === 'Error' ? console.error : console.warn;
-    log(prefix + message);
-}
-let spinner$1;
-const LOGIN_TT4D = 'https://developers.tiktok.com/passport/web/email/login';
-const params = {
-    aid: '2471',
-    account_sdk_source: 'web',
-    sdk_version: '2.1.6-tiktok',
+const resetTTMGRC = (config = {}) => {
+    fs.writeFileSync(CONFIG_PATH$1, JSON.stringify(config));
 };
-const prompt = inquirer.createPromptModule();
-async function login(options) {
-    const verbose = options?.verbose === true;
-    const log = (msg, data) => {
-        if (!verbose)
-            return;
-        console.log(chalk.gray('[ttmg login]'), msg, data !== undefined ? data : '');
-    };
-    if (verbose)
-        log('Verbose logging enabled');
-    console.log(chalk.yellowBright('⚠️ Note: Please login with your TikTok Developer Platform account.'));
-    // 增加对邮箱密码的校验
-    const { email, password } = await prompt([
-        {
-            type: 'input',
-            name: 'email',
-            message: 'Email:',
-            validate: input => {
-                if (!input) {
-                    return 'email is required, please input email';
-                }
-                else {
-                    /**
-                     * 邮箱格式校验
-                     */
-                    if (!/^[a-zA-Z0-9_.-]+@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*\.[a-zA-Z0-9]{2,6}$/.test(input)) {
-                        return 'email format is invalid';
-                    }
-                }
-                return true;
-            },
-        },
-        {
-            type: 'password',
-            name: 'password',
-            message: 'Password:',
-            mask: '*',
-            validate: input => {
-                if (!input) {
-                    return 'password is required, please input password';
-                }
-                return true;
-            },
-        },
-    ]);
-    const url = LOGIN_TT4D + '?' + new URLSearchParams(params);
-    log('Request URL', url);
-    log('Request params', { ...params, email: email.replace(/(.{2}).*(@.*)/, '$1***$2') });
-    const headers = {
-        'Content-Type': 'application/x-www-form-urlencoded',
-        Accept: '*/*',
-        'Accept-Encoding': 'gzip, deflate, br',
-        Origin: 'https://developers.tiktok.com',
-        Referer: 'https://developers.tiktok.com/passport/web/email/login',
-        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0 Safari/537.36',
-    };
-    const ora = await import('ora');
-    spinner$1 = ora.default({
-        text: chalk.bold.cyan('Logging in...'),
-        spinner: 'dots',
-    });
-    spinner$1.start();
-    const data = qs.stringify({
-        email,
-        password,
-        mix_mode: '1',
-        fixed_mix_mode: '1',
-    });
-    try {
-        log('Sending POST request...');
-        const response = await axios.post(url, data, {
-            headers,
-            maxRedirects: 20,
-            timeout: 30000,
-        });
-        log('Response status', response.status);
-        log('Response data', response?.data);
-        if (!response?.data?.data?.user_id) {
-            const errCode = response.data?.data?.error_code;
-            const errMsg = response.data?.data?.description;
-            const statusText = response?.statusText ?? '';
-            spinner$1.fail(chalk.red('login failed'));
-            if (verbose) {
-                console.log(chalk.gray('Response status:'), response?.status);
-                console.log(chalk.gray('Response statusText:'), statusText || '(empty)');
-                console.log(chalk.gray('Response data:'), response?.data ?? '(empty)');
-                console.log('');
-            }
-            if (errCode || errMsg) {
-                log('Login failed (api)', { errCode, errMsg, fullData: response?.data });
-                printMessage('Error', `Login failed: ${errMsg}${errCode ? `, error_code: ${errCode}` : ''}`);
-            }
-            else {
-                log('Login failed (no user_id)', { responseBody: response?.data });
-                if (verbose)
-                    log('Full response (for debugging)', response);
-                const looksLikeProxyResponse = statusText === 'Connection established' ||
-                    (response?.status === 200 &&
-                        (response?.data == null ||
-                            typeof response.data !== 'object' ||
-                            !('data' in response.data)));
-                if (looksLikeProxyResponse) {
-                    printMessage('Warning', [
-                        'The response does not look like the login API (e.g. proxy returned "Connection established" instead of forwarding the real response).',
-                        '',
-                        'The API is not reachable from mainland without proxy. Please ensure your proxy correctly forwards HTTPS to developers.tiktok.com: try another proxy node, or check that the proxy is in global/tunnel mode and not intercepting HTTPS.',
-                        '',
-                        'Proxy troubleshooting doc:',
-                        'https://bytedance.larkoffice.com/wiki/ZblJwT0ZNil9jJkS8EgcFlcQnFc',
-                    ].join('\n'));
-                }
-                else {
-                    printMessage('Error', 'Login failed. No user_id in response.');
-                }
-            }
-            spinner$1.stop();
-            process.exit(1);
-        }
-        else {
-            const data = {
-                email,
-                user_id: response?.data?.data?.user_id,
-                cookie: response?.headers['set-cookie'].join('; '),
-            };
-            log('Login success', { user_id: data.user_id, email: data.email });
-            setTTMGRC(data);
-            spinner$1.succeed(chalk.bold.green('login successfully!'));
-            process.exit(0);
-        }
-    }
-    catch (error) {
-        log('Request error', error instanceof Error ? { message: error.message, name: error.name, stack: error.stack } : error);
-        spinner$1.fail(chalk.red.bold('Failed to connect to login service'));
-        printMessage('Error', [
-            "Detected that the current terminal's network proxy settings are preventing external network access.",
-            '',
-            'Please check your local terminal proxy configuration. You can follow this doc to modify your terminal network settings:',
-            'https://bytedance.larkoffice.com/wiki/ZblJwT0ZNil9jJkS8EgcFlcQnFc',
-        ].join('\n'));
-        process.exit(1);
-    }
-}
-
-async function setup(options) {
-    const inputLang = options?.lang;
-    const normalizedLang = inputLang === 'en-US' || inputLang === 'zh-CN' ? inputLang : null;
-    const lang = normalizedLang ??
-        (await inquirer.createPromptModule()([
-            {
-                type: 'list',
-                name: 'lang',
-                message: 'Select language your prefer',
-                choices: [
-                    { name: 'English (en-US)', value: 'en-US' },
-                    { name: '简体中文 (zh-CN)', value: 'zh-CN' },
-                ],
-                default: 'en-US',
-            },
-        ])).lang;
-    setTTMGRC({ lang });
-}
-
-// ppe_dev_tool
-async function request({ url, method, data, headers, params, }) {
-    const config = getTTMGRC();
-    const cookie = config?.cookie;
-    try {
-        const res = await axios({
-            url,
-            method,
-            data,
-            params,
-            headers: {
-                Cookie: cookie,
-                'x-use-ppe': '1',
-                'x-tt-env': 'ppe_upgrade_script',
-                ...(headers || {}),
+const getCurrentUser = () => {
+    try {
+        const config = getTTMGRC();
+        return config;
+    }
+    catch (err) {
+        return null;
+    }
+};
+
+// ppe_dev_tool
+async function request({ url, method, data, headers, params, }) {
+    const config = getTTMGRC();
+    const cookie = config?.cookie;
+    try {
+        const res = await axios({
+            url,
+            method,
+            data,
+            params,
+            headers: {
+                Cookie: cookie,
+                // 'x-use-ppe': '1',
+                // 'x-tt-env': 'ppe_upgrade_script',
+                ...(headers || {}),
             },
         });
         // @ts-ignore
@@ -635,22 +300,6 @@ async function uploadGameToPlatform({ data, name, clientKey, note = '--', appId,
     }
 }
 
-function getCurrentUser() {
-    try {
-        const config = getTTMGRC();
-        return config;
-    }
-    catch (err) {
-        return null;
-    }
-}
-
-function ensureDirSync(dirPath) {
-    if (!fs.existsSync(dirPath)) {
-        fs.mkdirSync(dirPath, { recursive: true });
-    }
-}
-
 const bareToRelativePlugin = {
     name: 'bare-to-relative',
     setup(build) {
@@ -685,8 +334,8 @@ function buildOpenContext(sourcePath) {
 }
 
 function generateOpenContextHtml(openContextPath, appId) {
-    const templatePath = path.join(__dirname, 'template/open_context.html.hbs');
-    const sdkPath = path.join(__dirname, 'template/open_context_sdk.js.hbs');
+    const templatePath = resolveTemplatePath('open_context.html.hbs');
+    const sdkPath = resolveTemplatePath('open_context_sdk.js.hbs');
     const templateSource = fs.readFileSync(templatePath).toString();
     const sdkSource = fs.readFileSync(sdkPath).toString();
     const template = handlebars.compile(templateSource);
@@ -699,127 +348,649 @@ function generateOpenContextHtml(openContextPath, appId) {
     });
     fs.writeFileSync('./open_context.html', openContextRes);
 }
+function resolveTemplatePath(fileName) {
+    const runtimePath = path.join(__dirname, 'openDataContext/template', fileName);
+    if (fs.existsSync(runtimePath)) {
+        return runtimePath;
+    }
+    return path.join(process.cwd(), 'statics/openDataContext/template', fileName);
+}
+
+const messages = {
+    'en-US': {
+        'cli.description': 'TikTok Mini Games Command Line Tool',
+        'cli.version.desc': 'Show version',
+        'cli.option.dev.client': 'Debug TikTok Mini Games for Client',
+        'cli.option.dev.h5': 'Debug TikTok Mini Games for Web',
+        'cli.command.login.desc': 'Login with developer account',
+        'cli.command.login.verbose': 'Print verbose logs for debugging',
+        'cli.command.setup.desc': 'Initialize ttmg environment',
+        'cli.command.setup.lang': 'Language (only supports): en-US | zh-CN',
+        'cli.command.reset.desc': 'Reset local CLI state',
+        'cli.command.init.desc': 'Initialize project',
+        'cli.command.dev.desc': 'Open browser dev environment',
+        'cli.command.build.desc': 'Bundle project',
+        'cli.option.h5': 'H5 Mini Game',
+        'cli.native.init.placeholder': 'Native Mini Game initialize',
+        'cli.native.build.placeholder': 'Native Mini Game bundle',
+        'setup.prompt.selectLanguage': 'Select your preferred language',
+        'setup.choice.en': 'English (en-US)',
+        'setup.choice.zh': '简体中文 (zh-CN)',
+        'notice.versionUpdated': 'TTMG has been updated to v{version}.',
+        'notice.setup.recommend': 'Tip: run setup once to configure your preferred CLI language.',
+        'notice.setup.alreadyConfigured': 'Current language is {lang}. You can update it anytime.',
+        'notice.setup.howTo': 'How to configure language:',
+        'notice.setup.commandInteractive': '• Interactive: ttmg setup',
+        'notice.setup.commandExplicit': '• Explicit: ttmg setup --lang en-US | ttmg setup --lang zh-CN',
+        'notice.setup.commandHint': 'Run: ttmg setup (interactive) or ttmg setup --lang en-US | ttmg setup --lang zh-CN',
+        'setup.error.unsupportedLang': 'Unsupported language: {lang}.',
+        'setup.error.availableLangs': 'Supported languages: en-US, zh-CN.',
+        'setup.error.chooseHint': 'Run `ttmg setup` to choose language interactively.',
+        'setup.success': 'Setup completed. CLI language is now {lang}.',
+        'reset.warning.title': 'Reset will perform these changes:',
+        'reset.warning.lang': 'Language setting will be cleared.',
+        'reset.warning.login': 'Login state will be cleared.',
+        'reset.warning.clientKey': 'Historical debug client keys will be removed.',
+        'reset.confirm.prompt': 'Do you want to continue reset?',
+        'reset.confirm.yes': 'Yes, reset now',
+        'reset.confirm.no': 'No, keep current local state',
+        'reset.cancelled': 'Reset cancelled.',
+        'reset.success': 'Local state has been reset.',
+        'login.error.prefix': 'Error: ',
+        'login.warning.prefix': 'Warning: ',
+        'login.verbose.enabled': 'Verbose logging enabled',
+        'login.note': '⚠️ Note: Please login with your TikTok Developer Platform account.',
+        'login.email.prompt': 'Email:',
+        'login.email.required': 'email is required, please input email',
+        'login.email.invalid': 'email format is invalid',
+        'login.password.prompt': 'Password:',
+        'login.password.required': 'password is required, please input password',
+        'login.spinner.loggingIn': 'Logging in...',
+        'login.failed': 'login failed',
+        'login.success': 'login successfully!',
+        'login.error.withCode': 'Login failed: {message}, error_code: {code}',
+        'login.error.withMessage': 'Login failed: {message}',
+        'login.error.noUserId': 'Login failed. No user_id in response.',
+        'login.warning.proxyIssue': 'The response does not look like the login API (e.g. proxy returned "Connection established" instead of forwarding the real response).\n\nThe API is not reachable from mainland without proxy. Please ensure your proxy correctly forwards HTTPS to developers.tiktok.com: try another proxy node, or check that the proxy is in global/tunnel mode and not intercepting HTTPS.\n\nProxy troubleshooting doc:\nhttps://bytedance.larkoffice.com/wiki/ZblJwT0ZNil9jJkS8EgcFlcQnFc',
+        'login.error.connectService': 'Failed to connect to login service',
+        'login.error.networkBlocked': "Detected that the current terminal's network proxy settings are preventing external network access.\n\nPlease check your local terminal proxy configuration. You can follow this doc to modify your terminal network settings:\nhttps://bytedance.larkoffice.com/wiki/ZblJwT0ZNil9jJkS8EgcFlcQnFc",
+        'h5.dev.configMissing': '{file} is not exist, please run minis game init first',
+        'h5.dev.precheckTips': '⚠️ Before dev, please ensure:\n 1. The account used to login www.tiktok.com is in the sandbox target user range of Minis developer platform, otherwise login authorization will throw an error.\n 2. The browser allows www.tiktok.com <popup and redirect>, because the authorization login linkage needs to open a new tab popup for operation, otherwise the authorization login linkage will not be able to debug normally.',
+        'h5.dev.startingBanner': '\n \n============== start dev your game, it will take a few seconds ============ \n \n',
+        'h5.dev.cspFailed': 'Failed to set CSP header:',
+        'h5.dev.accessUrl': 'you can access {url} to debug your game in browser...',
+        'h5.dev.openBrowserFailed': 'Failed to open browser, you can access it manually',
+        'h5.bundle.configMissing': '{file} is not exist, please run minis game init first',
+        'h5.bundle.prompt.zipName': 'Please input zip name',
+        'h5.bundle.start': 'start build your game, it will take a few minutes...',
+        'h5.bundle.success': 'build {zipName}.zip success, you can find it in desktop, use time {cost} ms',
+        'h5.bundle.fail': 'auto build {zipName}.zip failed: {error}, you should zip it manually',
+        'h5.bundle.desktopFallback': 'Desktop folder not found, using default path: {path}',
+        'h5.init.prompt.clientKey': 'Please input client key',
+        'h5.init.prompt.devPort': 'Please input dev port',
+        'h5.init.indexMissing': 'index.html does not exist',
+        'h5.init.sdkAlreadyInjected': 'JS SDK is already injected, skip SDK script injection',
+        'h5.init.sandboxSkipVconsole': 'Sandbox environment detected, skip vConsole script injection',
+        'h5.init.done': 'TikTok H5 Mini Game initialization has been completed...',
+        'native.server.readyIn': 'ready in',
+        'native.server.portInUse': 'Port {port} is already in use, trying {next}...',
+        'native.server.failedAfterRetries': 'Failed to start server after trying {retries} ports.',
+        'native.check.notWorkspace': 'Current directory is not a Mini Game project entry directory, please enter the game project root directory for debugging',
+        'native.check.subpackagesCaseError': "Error: 'subPackages' (camelCase) is found in {file}. Please use 'subpackages' (all lowercase) instead.",
+        'native.compile.watching': '🔔 Watching game assets for local debugging...',
+        'native.compile.compiling': '🚀 Compiling game assets for local debugging...',
+        'native.compile.success': '✔ Game resources compiled successfully!',
+        'native.upload.spinner.start': 'Uploading game assets to client...',
+        'native.upload.spinner.size': 'Start upload Game assets to client, size: {size} MB',
+        'native.upload.spinner.progress': 'Uploading game assets to client... {percent}%',
+        'native.upload.success': 'Upload game assets to client success! Cost: {cost}ms',
+        'native.upload.fail': 'Upload failed with error: {error}, please check current debug env and try to scan qrcode to reupload again.',
+        'native.upload.serverFail': '✖ Upload failed with server error, please scan qrcode to reupload',
+        'native.upload.compressError': 'Error during compression:',
+        'native.server.upload.packingDir': 'Packing current directory: {cwd} ...',
+        'native.server.upload.packed': 'Pack completed, size: {size} MB',
+        'native.server.upload.failed': 'Upload failed: {error}',
+        'common.unknownError': 'An unknown error occurred.',
+        'native.init.selectClientKey': 'Select game client key for debugging:',
+        'native.init.lastUsed': '{clientKey} (last used)',
+        'native.init.addNew': 'Add a new client key',
+        'native.init.inputNew': 'Input new client key:',
+        'native.init.inputYour': 'Input your Client Key:',
+        'native.init.clientKeyRequired': 'Client key is required, please input client key',
+        'native.tips.1': ' The QR code page will be opened automatically in Chrome.',
+        'native.tips.1.sub': '   If it fails, please open the following link manually:',
+        'native.tips.2': ' The debugging service will automatically compile your game assets.',
+        'native.tips.2.sub1': '   Any changes in your game directory will trigger recompilation.',
+        'native.tips.2.sub2': '   You can debug the updated content when upload is completed.',
+        'native.tips.3': ' After scanning the QR code with your phone for Test User authentication,',
+        'native.tips.3.sub1': '   the compiled code package will be uploaded to the client automatically.',
+        'native.tips.3.sub2': '   Game debugging will start right away.',
+        'native.tips.4': ' Before scanning with TikTok, make sure your phone and computer are on the same Wi-Fi.',
+        'native.tips.4.sub1': '   This is required for stable local connection and debugging.',
+    },
+    'zh-CN': {
+        'cli.description': 'TikTok 小游戏命令行工具',
+        'cli.version.desc': '显示版本号',
+        'cli.option.dev.client': '客户端调试 TikTok 小游戏',
+        'cli.option.dev.h5': 'Web 调试 TikTok 小游戏',
+        'cli.command.login.desc': '使用开发者账号登录',
+        'cli.command.login.verbose': '输出调试用详细日志',
+        'cli.command.setup.desc': '初始化 ttmg 环境',
+        'cli.command.setup.lang': '语言（仅支持）：en-US | zh-CN',
+        'cli.command.reset.desc': '重置本地 CLI 状态',
+        'cli.command.init.desc': '初始化项目',
+        'cli.command.dev.desc': '打开浏览器调试环境',
+        'cli.command.build.desc': '打包项目',
+        'cli.option.h5': 'H5 小游戏',
+        'cli.native.init.placeholder': 'Native 小游戏初始化',
+        'cli.native.build.placeholder': 'Native 小游戏打包',
+        'setup.prompt.selectLanguage': '请选择偏好语言',
+        'setup.choice.en': '英语 (en-US)',
+        'setup.choice.zh': '简体中文 (zh-CN)',
+        'notice.versionUpdated': 'TTMG 已升级到 v{version}。',
+        'notice.setup.recommend': '建议执行一次 setup，配置 CLI 输出语言。',
+        'notice.setup.alreadyConfigured': '当前语言为 {lang}，你可以随时调整。',
+        'notice.setup.howTo': '语言配置方式：',
+        'notice.setup.commandInteractive': '• 交互式：ttmg setup',
+        'notice.setup.commandExplicit': '• 显式指定：ttmg setup --lang en-US | ttmg setup --lang zh-CN',
+        'notice.setup.commandHint': '执行：ttmg setup（交互选择）或 ttmg setup --lang en-US | ttmg setup --lang zh-CN',
+        'setup.error.unsupportedLang': '不支持的语言：{lang}。',
+        'setup.error.availableLangs': '可选语言：en-US、zh-CN。',
+        'setup.error.chooseHint': '可执行 `ttmg setup` 进行交互选择。',
+        'setup.success': '设置完成，CLI 语言已切换为 {lang}。',
+        'reset.warning.title': '重置将执行以下操作：',
+        'reset.warning.lang': '语言设置会被清空。',
+        'reset.warning.login': '登录状态会被清空。',
+        'reset.warning.clientKey': '历史调试的 client key 会被清理。',
+        'reset.confirm.prompt': '是否继续重置？',
+        'reset.confirm.yes': '是，立即重置',
+        'reset.confirm.no': '否，保留当前本地状态',
+        'reset.cancelled': '已取消重置。',
+        'reset.success': '本地状态已重置。',
+        'login.error.prefix': '错误：',
+        'login.warning.prefix': '警告：',
+        'login.verbose.enabled': '已开启详细日志',
+        'login.note': '⚠️ 提示：请使用 TikTok 开发者平台账号登录。',
+        'login.email.prompt': '邮箱：',
+        'login.email.required': '邮箱必填，请输入邮箱',
+        'login.email.invalid': '邮箱格式不正确',
+        'login.password.prompt': '密码：',
+        'login.password.required': '密码必填，请输入密码',
+        'login.spinner.loggingIn': '登录中...',
+        'login.failed': '登录失败',
+        'login.success': '登录成功！',
+        'login.error.withCode': '登录失败：{message}，错误码：{code}',
+        'login.error.withMessage': '登录失败：{message}',
+        'login.error.noUserId': '登录失败，响应中未返回 user_id。',
+        'login.warning.proxyIssue': '当前响应看起来不是登录接口返回（例如代理返回了 "Connection established"，而不是转发真实响应）。\n\n该接口在大陆网络通常需要代理。请确认代理可正确转发 developers.tiktok.com 的 HTTPS 请求：尝试切换节点，或检查代理是否为全局/隧道模式且未拦截 HTTPS。\n\n代理排查文档：\nhttps://bytedance.larkoffice.com/wiki/ZblJwT0ZNil9jJkS8EgcFlcQnFc',
+        'login.error.connectService': '连接登录服务失败',
+        'login.error.networkBlocked': '检测到当前终端代理设置导致无法访问外网。\n\n请检查本地终端代理配置，可参考以下文档修改：\nhttps://bytedance.larkoffice.com/wiki/ZblJwT0ZNil9jJkS8EgcFlcQnFc',
+        'h5.dev.configMissing': '{file} 不存在，请先执行 minis game init',
+        'h5.dev.precheckTips': '⚠️ 开始调试前请确认：\n 1. 当前登录 www.tiktok.com 的账号在小程序开发者平台沙盒目标用户范围内，否则登录授权会报错。\n 2. 浏览器允许 www.tiktok.com 弹窗与重定向，授权登录链路需要新开标签页进行操作，否则无法正常调试。',
+        'h5.dev.startingBanner': '\n \n============== 已开始调试你的游戏，通常需要几秒钟 ============ \n \n',
+        'h5.dev.cspFailed': '设置 CSP 头失败：',
+        'h5.dev.accessUrl': '可访问 {url} 在浏览器中调试游戏...',
+        'h5.dev.openBrowserFailed': '自动打开浏览器失败，请手动访问链接',
+        'h5.bundle.configMissing': '{file} 不存在，请先执行 minis game init',
+        'h5.bundle.prompt.zipName': '请输入压缩包名称',
+        'h5.bundle.start': '开始打包游戏，预计需要几分钟...',
+        'h5.bundle.success': '打包 {zipName}.zip 成功，可在桌面找到，耗时 {cost} ms',
+        'h5.bundle.fail': '自动打包 {zipName}.zip 失败：{error}，请手动压缩',
+        'h5.bundle.desktopFallback': '未找到桌面目录，使用默认路径：{path}',
+        'h5.init.prompt.clientKey': '请输入 client key',
+        'h5.init.prompt.devPort': '请输入调试端口',
+        'h5.init.indexMissing': 'index.html 不存在',
+        'h5.init.sdkAlreadyInjected': '检测到 JS SDK 已接入，跳过 SDK 相关脚本注入',
+        'h5.init.sandboxSkipVconsole': '检测到 Sandbox 环境，跳过 vConsole 相关脚本注入',
+        'h5.init.done': 'TikTok H5 小游戏初始化已完成...',
+        'native.server.readyIn': '启动耗时',
+        'native.server.portInUse': '端口 {port} 已被占用，尝试 {next}...',
+        'native.server.failedAfterRetries': '连续尝试 {retries} 个端口后，服务启动失败。',
+        'native.check.notWorkspace': '当前目录不是小游戏工程入口目录，请进入游戏项目根目录后再进行调试',
+        'native.check.subpackagesCaseError': "错误：在 {file} 中发现 'subPackages'（驼峰），请改为全小写 'subpackages'。",
+        'native.compile.watching': '🔔 正在监听游戏资源变更（本地调试）...',
+        'native.compile.compiling': '🚀 正在编译游戏资源（本地调试）...',
+        'native.compile.success': '✔ 游戏资源编译成功！',
+        'native.upload.spinner.start': '正在上传游戏资源到客户端...',
+        'native.upload.spinner.size': '开始上传游戏资源到客户端，大小：{size} MB',
+        'native.upload.spinner.progress': '正在上传游戏资源到客户端... {percent}%',
+        'native.upload.success': '上传游戏资源到客户端成功！耗时：{cost}ms',
+        'native.upload.fail': '上传失败：{error}，请检查当前调试环境并重新扫码上传。',
+        'native.upload.serverFail': '✖ 上传失败（服务端错误），请重新扫码上传',
+        'native.upload.compressError': '压缩过程中发生错误：',
+        'native.server.upload.packingDir': '正在打包当前目录：{cwd} ...',
+        'native.server.upload.packed': '打包完成，大小：{size} MB',
+        'native.server.upload.failed': '上传失败：{error}',
+        'common.unknownError': '发生未知错误。',
+        'native.init.selectClientKey': '请选择用于调试的游戏 client key：',
+        'native.init.lastUsed': '{clientKey}（上次使用）',
+        'native.init.addNew': '新增一个 client key',
+        'native.init.inputNew': '输入新的 client key：',
+        'native.init.inputYour': '输入你的 Client Key：',
+        'native.init.clientKeyRequired': 'client key 必填，请输入 client key',
+        'native.tips.1': ' 将自动在 Chrome 打开二维码页面。',
+        'native.tips.1.sub': '   若失败，请手动打开以下链接：',
+        'native.tips.2': ' 调试服务会自动编译你的游戏资源。',
+        'native.tips.2.sub1': '   游戏目录内的任何改动都会触发重新编译。',
+        'native.tips.2.sub2': '   上传完成后即可调试最新内容。',
+        'native.tips.3': ' 手机扫码通过 Test User 认证后，',
+        'native.tips.3.sub1': '   编译后的代码包会自动上传到客户端。',
+        'native.tips.3.sub2': '   随即开始游戏调试。',
+        'native.tips.4': ' 在使用 TikTok 扫码前，请确保手机和电脑处于同一个 Wi-Fi。',
+        'native.tips.4.sub1': '   这是本地连接与正常调试的前提条件。',
+    },
+};
 
-const app = express();
-// 1. 检查配置文件是否存在
-function dev$1() {
-    const configPath = path.join(process.cwd(), CONFIG_FILE_NAME);
-    if (!fs.existsSync(configPath)) {
-        console.log(chalk.red.bold(`${CONFIG_FILE_NAME} is not exist, please run minis game init first`));
-        return;
+function resolveSupportedLanguage(lang) {
+    if (!lang) {
+        return undefined;
     }
-    // 2. 读取配置
-    const gameConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    const devPort = gameConfig.dev?.port || 9527;
-    const hasOpenContext = !!gameConfig.openDataContext;
-    if (hasOpenContext) {
-        generateOpenContextHtml(gameConfig.openDataContext, gameConfig.app_id);
+    if (lang in messages) {
+        return lang;
     }
-    // 3. 打印开发前提示
-    console.log(chalk.yellow.bold('⚠️ Before dev, please ensure:\n 1. The account used to login www.tiktok.com is in the sandbox target user range of Minis developer platform, otherwise login authorization will throw an error.\n 2. The browser allows www.tiktok.com <popup and redirect>, because the authorization login linkage needs to open a new tab popup for operation, otherwise the authorization login linkage will not be able to debug normally.'));
-    console.log(chalk.bold.blue('\n \n============== start dev your game, it will take a few seconds ============ \n \n'));
-    /**
-     * 支持 .br 文件, 支持 gzip
-     */
-    app.use((req, res, next) => {
-        if (req.url.endsWith('.br')) {
-            res.setHeader('Content-Encoding', 'br');
-        }
-        else if (req.url.endsWith('.gz')) {
-            res.setHeader('Content-Encoding', 'gzip');
-        }
-        next();
+    const mainLang = lang.split('-')[0];
+    if (mainLang === 'zh') {
+        return 'zh-CN';
+    }
+    if (mainLang === 'en') {
+        return 'en-US';
+    }
+    return undefined;
+}
+function getConfiguredLanguage() {
+    return resolveSupportedLanguage(getTTMGRC()?.lang);
+}
+function getLanguage() {
+    return getConfiguredLanguage() ?? 'en-US';
+}
+function format(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (_, key) => {
+        const value = params[key];
+        return value === undefined ? `{${key}}` : String(value);
     });
-    /**
-     * 给所有的请求返回设置 CSP
-     */
-    app.use((req, res, next) => {
-        /**
-         * 计算 HTML 中的内联脚本生成 hash 插入 CSP 中
-         */
-        try {
-            // 1. 读取 HTML 文件内容
-            const htmlPath = path.join(process.cwd(), 'index.html');
-            const html = fs.readFileSync(htmlPath, 'utf8');
-            // 2. 用 cheerio 解析 HTML
-            const $ = cheerio.load(html);
-            // 3. 提取所有无 src 属性的内联 <script> 内容
-            const scripts = [];
-            $('script:not([src])').each((i, elem) => {
-                const content = $(elem).html();
-                if (content && content.trim()) {
-                    scripts.push(content);
-                }
-            });
-            // 4. 计算每段脚本的 SHA-256 hash 并 base64 编码
-            // const hashes = scripts.map(script => {
-            //   const hash = crypto
-            //     .createHash('sha256')
-            //     .update(script, 'utf8')
-            //     .digest('base64');
-            //   return `'sha256-${hash}'`;
-            // });
-            // 开发者本地调试，信任的域名默认为 * 便于调试
-            const devTrustedDomain = '*';
-            res.setHeader('Content-Security-Policy', `default-src 'self';script-src 'self' data: blob: 'unsafe-eval' 'unsafe-inline' connect.tiktok-minis.com sf-connect.tiktokminis.us;img-src 'self' ${devTrustedDomain} data: blob: *; connect-src 'self' ${devTrustedDomain} data: blob: ; style-src 'self' ${devTrustedDomain} 'unsafe-inline' fonts.googleapis.com data: blob: *; font-src 'self' fonts.gstatic.com blob: data: *; media-src 'self' ${devTrustedDomain} data: blob: *; frame-src 'none'; base-uri 'self'; worker-src 'self' blob: data: ;`);
+}
+function t(key, params, langOverride) {
+    const lang = langOverride ?? getLanguage();
+    const template = messages[lang][key] ?? messages['en-US'][key] ?? key;
+    return format(template, params);
+}
+function getCurrentLanguage() {
+    return getLanguage();
+}
+
+const SETUP_NOTICE_ID = 'setup-language-onboarding';
+const versionNoticeConfigs = [
+    {
+        id: SETUP_NOTICE_ID,
+        sinceVersion: '0.3.2-beta.5',
+        headlineKey: 'notice.versionUpdated',
+        bodyConfiguredKey: 'notice.setup.alreadyConfigured',
+        bodyUnconfiguredKey: 'notice.setup.recommend',
+        guideTitleKey: 'notice.setup.howTo',
+        guideItemKeys: ['notice.setup.commandInteractive', 'notice.setup.commandExplicit'],
+        dismissOnCommands: ['setup', 'reset'],
+    },
+];
+
+const boxenFn = boxen.default ??
+    boxen;
+function maybeShowPostInstallNotice(currentVersion) {
+    if (!process.stdout.isTTY)
+        return;
+    const parsedCurrentVersion = semver.valid(currentVersion);
+    if (!parsedCurrentVersion)
+        return;
+    const argv = process.argv.slice(2);
+    const isHelpOrVersion = argv.includes('-h') ||
+        argv.includes('--help') ||
+        argv.includes('-v') ||
+        argv.includes('--version');
+    if (isHelpOrVersion)
+        return;
+    const config = getTTMGRC() || {};
+    const seenNoticeIds = new Set(config.seenNoticeIds || []);
+    let shouldPersistState = false;
+    // Backward compatibility for old single-key notice status.
+    const legacyVersion = config.lastNotifiedCliVersion;
+    if (legacyVersion &&
+        semver.valid(legacyVersion) &&
+        semver.gte(legacyVersion, '0.3.2-beta.5') &&
+        !seenNoticeIds.has(SETUP_NOTICE_ID)) {
+        seenNoticeIds.add(SETUP_NOTICE_ID);
+        shouldPersistState = true;
+    }
+    const commandName = argv.find(arg => !arg.startsWith('-'));
+    const currentLang = config.lang;
+    const hasConfiguredLang = currentLang === 'en-US' || currentLang === 'zh-CN';
+    const pendingNotices = versionNoticeConfigs.filter(notice => {
+        if (seenNoticeIds.has(notice.id))
+            return false;
+        return semver.gte(parsedCurrentVersion, notice.sinceVersion);
+    });
+    for (const notice of pendingNotices) {
+        if (commandName && notice.dismissOnCommands?.includes(commandName)) {
+            seenNoticeIds.add(notice.id);
+            shouldPersistState = true;
+            continue;
         }
-        catch (e) {
-            // 如果 index.html 不存在或有异常，CSP 头就不设置
-            console.warn(chalk.red('Failed to set CSP header:'), e.message);
+        const lines = [
+            chalk.green.bold(t(notice.headlineKey, { version: currentVersion })),
+        ];
+        if (hasConfiguredLang && notice.bodyConfiguredKey) {
+            lines.push(t(notice.bodyConfiguredKey, { lang: currentLang }));
         }
-        next();
-    });
-    // 4. 静态资源服务
-    app.use(express.static(path.join(process.cwd())));
-    // 5. 启动服务并自动打开浏览器
-    app.listen(devPort, () => {
-        const gameUrl = `http://localhost:${devPort}`;
-        const openContextUrl = `http://localhost:${devPort}/open_context.html`;
-        let devUrl = `${MINIS_RUNTIME_URL}?minis_url=${gameUrl}&enable_log=1`;
-        if (hasOpenContext) {
-            devUrl += `&open_context_url=${openContextUrl}`;
+        else if (!hasConfiguredLang && notice.bodyUnconfiguredKey) {
+            lines.push(chalk.yellow(t(notice.bodyUnconfiguredKey)));
         }
-        console.log(`you can access ${chalk.green.underline.bold(devUrl)} to debug your game in browser...`);
-        try {
-            // 自动打开浏览器，跨平台
-            openUrl(devUrl);
+        if (notice.guideTitleKey) {
+            lines.push('');
+            lines.push(chalk.bold(t(notice.guideTitleKey)));
         }
-        catch (e) {
-            console.warn(chalk.red('Failed to open browser, you can access it manually'), e.message);
+        for (const itemKey of notice.guideItemKeys || []) {
+            lines.push(chalk.cyan(t(itemKey)));
         }
-    });
-}
-
-async function buildMinisManifest() {
-    try {
-        const buildPath = path.join(process.cwd());
-        const resourceList = [];
-        const allFiles = collectAllFiles(buildPath);
-        Object.keys(allFiles)
-            .filter(file => !file.endsWith('.map'))
-            .forEach(file => {
-            const relativeFilePath = allFiles[file];
-            const filePathArr = relativeFilePath.split('/').filter(Boolean); // Split filename
-            const fileName = filePathArr.pop() || ''; // Get filename
-            if (filePathArr.length === 0) {
-                resourceList.push({ type: 'file', name: fileName });
-            }
-            else {
-                const folder = findOrCreateFolder(filePathArr, resourceList);
-                folder.children.push({ type: 'file', name: fileName });
-            }
+        const content = lines.join('\n');
+        console.log(boxenFn(content, {
+            title: 'Notice',
+            titleAlignment: 'left',
+            borderStyle: 'round',
+            borderColor: 'cyan',
+            padding: {
+                top: 0,
+                right: 1,
+                bottom: 0,
+                left: 1,
+            },
+            margin: 1,
+        }));
+        seenNoticeIds.add(notice.id);
+        shouldPersistState = true;
+    }
+    if (shouldPersistState || legacyVersion) {
+        setTTMGRC({
+            seenNoticeIds: Array.from(seenNoticeIds),
+            lastNotifiedCliVersion: undefined,
         });
-        fs.writeFileSync(path.join(buildPath, MINIS_MANIFEST_FILE_NAME), JSON.stringify({ name: MINIS_MANIFEST_FILE_NAME, resource_list: resourceList }, null, 2));
     }
-    catch (error) {
-        console.error(chalk.red(`Error during debug process: ${error.message}`));
-        if (error instanceof Error && error.stack) {
-            console.error(chalk.red(`Stack trace: ${error.stack}`));
-        }
-        process.exit(1);
+}
+
+function ensureDirSync(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
     }
 }
-function findOrCreateFolder(pathArray, currentFolder) {
+
+const CONFIG_FILE_NAME = 'minigame.config.json';
+const SDK_URL = 'https://connect.tiktok-minis.com/game/sdk.js';
+const VCONSOLE_URL = 'https://connect.tiktok-minis.com/libs/vConsole.js';
+const VCONSOLE_INIT = `
+    if(typeof VConsole === 'function') {
+      window.vConsole = new VConsole();
+    }
+  `;
+const MINIS_MANIFEST_FILE_NAME = 'minis.manifest.json';
+const MINIS_RUNTIME_URL = 'https://www.tiktok.com/minigames/runtime';
+
+const { JSDOM } = jsdom;
+const CONFIG_PATH = `${process.cwd()}/${CONFIG_FILE_NAME}`;
+const INDEX_HTML_PATH = `${process.cwd()}/index.html`;
+function isSandbox(clientKey) {
+    /**
+     * sb 开头的 clientKey 都是 sandbox 环境
+     */
+    return clientKey.startsWith('sb');
+}
+// 判断是否是 TTMinis.game.init 的初始化脚本
+function isTTMinisInitScript(script, clientKey) {
+    if (!script.innerHTML) {
+        return false;
+    }
+    return (script.innerHTML.includes('TTMinis.game.init') &&
+        script.innerHTML.includes(clientKey));
+}
+async function injectScripts({ config, clientKey }) {
+    // 1. 检查 config 文件是否已存在
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+    // 2. 读取 index.html
+    if (!fs.existsSync(INDEX_HTML_PATH)) {
+        console.error(t('h5.init.indexMissing'));
+        return;
+    }
+    const indexHtml = fs.readFileSync(INDEX_HTML_PATH, 'utf8');
+    const dom = new JSDOM(indexHtml);
+    const { document } = dom.window;
+    // 3. head 标签
+    let head = document.querySelector('head');
+    if (!head) {
+        head = document.createElement('head');
+        document.documentElement.insertBefore(head, document.body);
+    }
+    // 4. 检查是否已注入 SDK
+    const scriptList = Array.from(document.querySelectorAll('script'));
+    const hasSDK = scriptList.some(script => script.src && script.src.includes(SDK_URL));
+    // 5. 检查是否已注入 vConsole
+    const hasVConsole = scriptList.some(script => script.src && script.src.includes('vConsole.js'));
+    let lastInitScript = null;
+    if (!hasSDK) {
+        // 插入 SDK 脚本
+        const sdkScript = document.createElement('script');
+        sdkScript.src = SDK_URL;
+        head.insertBefore(sdkScript, head.firstChild);
+        // 插入 SDK init 脚本
+        const initScript = document.createElement('script');
+        initScript.innerHTML = `
+      window.TTMinis = TTMinis;
+      TTMinis.game.init({
+        clientKey: "${clientKey}",
+      });
+    `;
+        head.insertBefore(initScript, sdkScript.nextSibling);
+        lastInitScript = initScript;
+    }
+    else {
+        // 已经有 SDK，查找 TTMinis.game.init 脚本
+        const headScripts = Array.from(head.querySelectorAll('script'));
+        lastInitScript = headScripts.find(script => isTTMinisInitScript(script, clientKey));
+        if (lastInitScript) {
+            console.log(t('h5.init.sdkAlreadyInjected'));
+        }
+        else {
+            // 没有 TTMinis.game.init，则查找最后一个 SDK 脚本
+            const sdkScripts = headScripts.filter(script => script.src && script.src.includes(SDK_URL));
+            if (sdkScripts.length > 0) {
+                lastInitScript = sdkScripts[sdkScripts.length - 1];
+            }
+        }
+    }
+    /**
+     * 只有 Sandbox 环境才需要注入 vConsole
+     */
+    if (isSandbox(clientKey)) {
+        console.log(t('h5.init.sandboxSkipVconsole'));
+        // 8. 插入 vConsole 相关脚本（如果需要）
+        if (!hasVConsole) {
+            // vConsole 相关脚本的插入点
+            let insertAfterNode = lastInitScript;
+            if (insertAfterNode) {
+                insertAfterNode = insertAfterNode.nextSibling;
+            }
+            else {
+                insertAfterNode = head.firstChild;
+            }
+            // vConsole 源码
+            const vconsoleSourceScript = document.createElement('script');
+            vconsoleSourceScript.src = VCONSOLE_URL;
+            // vConsole 初始化
+            const vconsoleInitScript = document.createElement('script');
+            vconsoleInitScript.innerHTML = VCONSOLE_INIT;
+            head.insertBefore(vconsoleSourceScript, insertAfterNode);
+            head.insertBefore(vconsoleInitScript, insertAfterNode);
+        }
+    }
+    // 9. 格式化并写回 index.html
+    const formattedHtml = await prettier.format(dom.serialize(), {
+        parser: 'html',
+    });
+    fs.writeFileSync(INDEX_HTML_PATH, formattedHtml);
+    console.log(chalk.green.bold(t('h5.init.done')));
+}
+
+function init$1() {
+    const promptModule = inquirer.createPromptModule();
+    promptModule([
+        {
+            type: 'input',
+            name: 'clientKey',
+            message: t('h5.init.prompt.clientKey'),
+        },
+        {
+            type: 'input',
+            name: 'devPort',
+            message: t('h5.init.prompt.devPort'),
+            default: 9527,
+        },
+    ])
+        .then(async (answers) => {
+        const { clientKey, devPort } = answers;
+        const config = {
+            _comment: 'orientation is the orientation of the game. It can be either \'VERTICAL\' or \'HORIZONTAL\'.our game default is VERTICAL; minigame.config.json dev is a configuration file for minigame development. You can use it to configure the minigame.',
+            orientation: 'VERTICAL',
+            dev: {
+                port: devPort,
+            },
+        };
+        await injectScripts({ clientKey, config });
+        process.exit(0);
+    })
+        .catch(() => {
+        process.exit(1);
+    });
+}
+
+const app = express();
+// 1. 检查配置文件是否存在
+function dev$1() {
+    const configPath = path.join(process.cwd(), CONFIG_FILE_NAME);
+    if (!fs.existsSync(configPath)) {
+        console.log(chalk.red.bold(t('h5.dev.configMissing', { file: CONFIG_FILE_NAME })));
+        return;
+    }
+    // 2. 读取配置
+    const gameConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    const devPort = gameConfig.dev?.port || 9527;
+    const hasOpenContext = !!gameConfig.openDataContext;
+    if (hasOpenContext) {
+        generateOpenContextHtml(gameConfig.openDataContext, gameConfig.app_id);
+    }
+    // 3. 打印开发前提示
+    console.log(chalk.yellow.bold(t('h5.dev.precheckTips')));
+    console.log(chalk.bold.blue(t('h5.dev.startingBanner')));
+    /**
+     * 支持 .br 文件, 支持 gzip
+     */
+    app.use((req, res, next) => {
+        if (req.url.endsWith('.br')) {
+            res.setHeader('Content-Encoding', 'br');
+        }
+        else if (req.url.endsWith('.gz')) {
+            res.setHeader('Content-Encoding', 'gzip');
+        }
+        next();
+    });
+    /**
+     * 给所有的请求返回设置 CSP
+     */
+    app.use((req, res, next) => {
+        /**
+         * 计算 HTML 中的内联脚本生成 hash 插入 CSP 中
+         */
+        try {
+            // 1. 读取 HTML 文件内容
+            const htmlPath = path.join(process.cwd(), 'index.html');
+            const html = fs.readFileSync(htmlPath, 'utf8');
+            // 2. 用 cheerio 解析 HTML
+            const $ = cheerio.load(html);
+            // 3. 提取所有无 src 属性的内联 <script> 内容
+            const scripts = [];
+            $('script:not([src])').each((i, elem) => {
+                const content = $(elem).html();
+                if (content && content.trim()) {
+                    scripts.push(content);
+                }
+            });
+            // 4. 计算每段脚本的 SHA-256 hash 并 base64 编码
+            // const hashes = scripts.map(script => {
+            //   const hash = crypto
+            //     .createHash('sha256')
+            //     .update(script, 'utf8')
+            //     .digest('base64');
+            //   return `'sha256-${hash}'`;
+            // });
+            // 开发者本地调试，信任的域名默认为 * 便于调试
+            const devTrustedDomain = '*';
+            res.setHeader('Content-Security-Policy', `default-src 'self';script-src 'self' data: blob: 'unsafe-eval' 'unsafe-inline' connect.tiktok-minis.com sf-connect.tiktokminis.us;img-src 'self' ${devTrustedDomain} data: blob: *; connect-src 'self' ${devTrustedDomain} data: blob: ; style-src 'self' ${devTrustedDomain} 'unsafe-inline' fonts.googleapis.com data: blob: *; font-src 'self' fonts.gstatic.com blob: data: *; media-src 'self' ${devTrustedDomain} data: blob: *; frame-src 'none'; base-uri 'self'; worker-src 'self' blob: data: ;`);
+        }
+        catch (e) {
+            // 如果 index.html 不存在或有异常，CSP 头就不设置
+            console.warn(chalk.red(t('h5.dev.cspFailed')), e.message);
+        }
+        next();
+    });
+    // 4. 静态资源服务
+    app.use(express.static(path.join(process.cwd())));
+    // 5. 启动服务并自动打开浏览器
+    app.listen(devPort, () => {
+        const gameUrl = `http://localhost:${devPort}`;
+        const openContextUrl = `http://localhost:${devPort}/open_context.html`;
+        let devUrl = `${MINIS_RUNTIME_URL}?minis_url=${gameUrl}&enable_log=1`;
+        if (hasOpenContext) {
+            devUrl += `&open_context_url=${openContextUrl}`;
+        }
+        console.log(t('h5.dev.accessUrl', {
+            url: String(chalk.green.underline.bold(devUrl)),
+        }));
+        try {
+            // 自动打开浏览器，跨平台
+            openUrl(devUrl);
+        }
+        catch (e) {
+            console.warn(chalk.red(t('h5.dev.openBrowserFailed')), e.message);
+        }
+    });
+}
+
+async function buildMinisManifest() {
+    try {
+        const buildPath = path.join(process.cwd());
+        const resourceList = [];
+        const allFiles = collectAllFiles(buildPath);
+        Object.keys(allFiles)
+            .filter(file => !file.endsWith('.map'))
+            .forEach(file => {
+            const relativeFilePath = allFiles[file];
+            const filePathArr = relativeFilePath.split('/').filter(Boolean); // Split filename
+            const fileName = filePathArr.pop() || ''; // Get filename
+            if (filePathArr.length === 0) {
+                resourceList.push({ type: 'file', name: fileName });
+            }
+            else {
+                const folder = findOrCreateFolder(filePathArr, resourceList);
+                folder.children.push({ type: 'file', name: fileName });
+            }
+        });
+        fs.writeFileSync(path.join(buildPath, MINIS_MANIFEST_FILE_NAME), JSON.stringify({ name: MINIS_MANIFEST_FILE_NAME, resource_list: resourceList }, null, 2));
+    }
+    catch (error) {
+        console.error(chalk.red(`Error during debug process: ${error.message}`));
+        if (error instanceof Error && error.stack) {
+            console.error(chalk.red(`Stack trace: ${error.stack}`));
+        }
+        process.exit(1);
+    }
+}
+function findOrCreateFolder(pathArray, currentFolder) {
     let folder = currentFolder.find(item => item.type === 'folder' && item.name === pathArray[0]);
     if (!folder) {
         folder = { type: 'folder', name: pathArray[0], children: [] };
@@ -854,7 +1025,7 @@ async function build() {
     try {
         const configPath = path.join(process.cwd(), CONFIG_FILE_NAME);
         if (!fs.existsSync(configPath)) {
-            console.log(chalk.red.bold(`${CONFIG_FILE_NAME} is not exist, please run minis game init first`));
+            console.log(chalk.red.bold(t('h5.bundle.configMissing', { file: CONFIG_FILE_NAME })));
             return;
         }
         const gameConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
@@ -869,11 +1040,11 @@ async function build() {
             type: 'input',
             name: 'zipName',
             default: 'game',
-            message: 'Please input zip name',
+            message: t('h5.bundle.prompt.zipName'),
         });
         zName = zipNameInput;
         const startTime = Date.now();
-        console.log(chalk.bold.blue('start build your game, it will take a few minutes...'));
+        console.log(chalk.bold.blue(t('h5.bundle.start')));
         /**
          * 移除掉当前根目录下的文件包
          */
@@ -898,11 +1069,17 @@ async function build() {
         await archive.pipe(fs.createWriteStream(zipPath));
         await archive.directory(path.resolve(process.cwd()), false);
         await archive.finalize();
-        console.log(chalk.yellow.bold(`build ${zipNameInput}.zip success, you can find it in desktop, use time ${Date.now() - startTime} ms`));
+        console.log(chalk.yellow.bold(t('h5.bundle.success', {
+            zipName: zipNameInput,
+            cost: Date.now() - startTime,
+        })));
         process.exit(0);
     }
     catch (error) {
-        console.log(chalk.red(`auto build ${zName}.zip failed: ${error.message}, you should zip it manually`));
+        console.log(chalk.red(t('h5.bundle.fail', {
+            zipName: zName,
+            error: error.message,
+        })));
         process.exit(1);
     }
 }
@@ -935,7 +1112,7 @@ function getDesktopPath() {
     //    这是一种安全的默认行为，因为即使文件夹不存在，程序后续创建文件时
     //    也可以选择自动创建这个目录。
     const defaultPath = path.join(homeDir, 'Desktop');
-    console.log(`未找到特定桌面文件夹，使用默认路径: ${defaultPath}`);
+    console.log(t('h5.bundle.desktopFallback', { path: defaultPath }));
     return defaultPath;
 }
 
@@ -1076,6 +1253,7 @@ const store = Store.getInstance({
     nodeWsPort: DEV_WS_PORT,
     packages: {},
     isUnderCompiling: false,
+    isUnderUploading: false,
     isWaitingForUpload: false,
     projectInfo: {
         projectSize: 0,
@@ -1276,10 +1454,6 @@ function getOutputDir() {
 }
 
 async function compile(context) {
-    // const { openDataContext } = getOpenContextConfig();
-    // if (!!openDataContext) {
-    //   buildOpenContextToFile(openDataContext);
-    // }
     const entryDir = process.cwd();
     const outputDir = getOutputDir();
     const { clientKey, msg } = getClientKey();
@@ -1291,8 +1465,8 @@ async function compile(context) {
         console.log(chalk.red.bold(msg));
     }
     const startTip = context?.mode === 'watch'
-        ? '🔔 Watching game assets for local debugging...'
-        : '🚀 Compiling game assets for local debugging...';
+        ? t('native.compile.watching')
+        : t('native.compile.compiling');
     console.log(chalk.bold.cyan(startTip));
     wsServer.sendCompilationStatus('start');
     store.setState({
@@ -1329,7 +1503,7 @@ async function compile(context) {
                     wsServer.sendCompilationStatus('end', {
                         isSuccess: true,
                     });
-                    console.log(chalk.green.bold('✔ Game resources compiled successfully!'));
+                    console.log(chalk.green.bold(t('native.compile.success')));
                     resolve(msg); // 编译结束，返回结果
                 }
                 worker.terminate();
@@ -1351,6 +1525,7 @@ async function compile(context) {
                 outputDir,
                 devPort: store.getState().nodeServerPort,
                 entryDir,
+                lang: getCurrentLanguage(),
             },
         });
     });
@@ -1390,22 +1565,35 @@ async function watch() {
     });
 }
 
-let spinner;
+let spinner$1;
 async function uploadGame(callback) {
     const ora = await import('ora');
-    spinner = ora.default({
-        text: chalk.cyan.bold('Uploading game assets to client...'),
+    spinner$1 = ora.default({
+        text: chalk.cyan.bold(t('native.upload.spinner.start')),
         spinner: 'dots',
     });
-    spinner.start();
+    spinner$1.start();
     const outputDir = getOutputDir();
     callback({
         status: 'start',
         percent: 0,
     });
     const zipPath = path.join(os.homedir(), '__TTMG__', 'upload.zip');
-    await zipDirectory(outputDir, zipPath);
-    await uploadZip(zipPath, callback);
+    try {
+        await zipDirectory(outputDir, zipPath);
+        await uploadZip(zipPath, callback);
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (spinner$1?.isSpinning) {
+            spinner$1.fail(chalk.red.bold(t('native.upload.fail', { error: errorMsg })));
+        }
+        callback({
+            status: 'error',
+            percent: 0,
+            msg: errorMsg,
+        });
+    }
 }
 /**
  * 复制源目录内容到临时目录，然后根据 glob 模式过滤并压缩文件。
@@ -1449,7 +1637,7 @@ async function zipDirectory(sourceDir, outPath) {
         await archivePromise;
     }
     catch (err) {
-        console.error('压缩过程中发生错误:', err);
+        console.error(t('native.upload.compressError'), err);
         throw err;
     }
     finally {
@@ -1466,63 +1654,65 @@ async function uploadZip(zipPath, callback) {
     });
     // 帮我计算下文件大小，变成 MB 为单位
     const fileSize = fs.statSync(zipPath).size / 1024 / 1024;
-    spinner.text = chalk.cyan.bold(`Start upload Game assets to client, size: ${fileSize.toFixed(2)} MB`);
+    spinner$1.text = chalk.cyan.bold(t('native.upload.spinner.size', { size: fileSize.toFixed(2) }));
     const { clientHttpPort, clientHost } = store.getState();
     const url = `http://${clientHost}:${clientHttpPort}/game/upload`;
     try {
         // 1. 创建请求流
-        const stream = got.stream.post(url, {
-            body: form,
-        });
-        const handleProgress = progress => {
-            const percent = progress.percent;
-            // const transferred = progress.transferred;
-            // const total = progress.total;
-            spinner.text = chalk.cyan.bold(`Uploading game assets to client... ${(percent * 100).toFixed(0)}%`);
-            callback({
-                status: 'process',
-                percent,
+        await new Promise(resolve => {
+            const stream = got.stream.post(url, {
+                body: form,
             });
-        };
-        stream.on('uploadProgress', handleProgress);
-        const chunks = [];
-        // 当流传输数据时，收集数据块
-        stream.on('data', chunk => {
-            chunks.push(chunk);
-        });
-        // 当流成功结束时
-        stream.on('end', () => {
-            spinner.succeed(chalk.green.bold(`Upload game assets to client success! Cost: ${Date.now() - startTime}ms`));
-            callback({
-                status: 'success',
-                percent: 1,
+            const handleProgress = progress => {
+                const percent = progress.percent;
+                spinner$1.text = chalk.cyan.bold(t('native.upload.spinner.progress', {
+                    percent: (percent * 100).toFixed(0),
+                }));
+                callback({
+                    status: 'process',
+                    percent,
+                });
+            };
+            const cleanup = () => {
+                stream.off('uploadProgress', handleProgress);
+            };
+            stream.on('uploadProgress', handleProgress);
+            // Consume response body to ensure 'end' is emitted.
+            stream.on('data', () => { });
+            // 当流成功结束时
+            stream.on('end', () => {
+                cleanup();
+                spinner$1.succeed(chalk.green.bold(t('native.upload.success', { cost: Date.now() - startTime })));
+                callback({
+                    status: 'success',
+                    percent: 1,
+                });
+                resolve();
             });
-        });
-        // 当流发生错误时
-        stream.on('error', err => {
-            stream.off('uploadProgress', handleProgress);
-            spinner.fail(chalk.red.bold(`Upload failed with error: ${err.message}, please check current debug env and try to scan qrcode to reupload again.`));
-            callback({
-                status: 'error',
-                percent: 0,
-                msg: err.message,
+            // 当流发生错误时
+            stream.on('error', err => {
+                cleanup();
+                spinner$1.fail(chalk.red.bold(t('native.upload.fail', { error: err.message })));
+                callback({
+                    status: 'error',
+                    percent: 0,
+                    msg: err.message,
+                });
+                resolve();
             });
         });
     }
     catch (err) {
-        callback({
-            status: 'error',
-            percent: 0,
-            msg: err?.message,
-        });
-        process.stdout.write('\n');
-        console.log('\n');
-        console.error(chalk.red.bold('✖ Upload failed with server error, please scan qrcode to reupload'));
+        throw err;
     }
 }
 
-function listen() {
-    eventEmitter.on('startUpload', () => {
+let hasBoundUploadListeners = false;
+function listen$1() {
+    if (hasBoundUploadListeners)
+        return;
+    hasBoundUploadListeners = true;
+    eventEmitter.on('startUpload', async () => {
         /**
          * 如果还在编译中，需要等到编译结束再上传
          */
@@ -1532,30 +1722,53 @@ function listen() {
             });
             return;
         }
-        wsServer.sendUploadStatus('start');
-        uploadGame(({ status, percent, msg }) => {
-            if (status === 'process') {
-                wsServer.sendUploadStatus('process', {
-                    status: 'process',
-                    progress: percent,
-                });
-            }
-            else if (status === 'error') {
-                wsServer.sendUploadStatus('error', {
-                    status: 'error',
-                    errMsg: msg,
-                    isSuccess: false,
-                });
-            }
-            else if (status === 'success') {
-                wsServer.sendUploadStatus('success', {
-                    status: 'success',
-                    packages: store.getState().packages,
-                    clientKey: getClientKey().clientKey,
-                    isSuccess: true,
-                });
-            }
+        /**
+         * 避免重复触发导致并发上传（会触发 ora 多 spinner 警告）
+         */
+        if (store.getState().isUnderUploading) {
+            return;
+        }
+        store.setState({
+            isUnderUploading: true,
         });
+        wsServer.sendUploadStatus('start');
+        try {
+            await uploadGame(({ status, percent, msg }) => {
+                if (status === 'process') {
+                    wsServer.sendUploadStatus('process', {
+                        status: 'process',
+                        progress: percent,
+                    });
+                }
+                else if (status === 'error') {
+                    wsServer.sendUploadStatus('error', {
+                        status: 'error',
+                        errMsg: msg,
+                        isSuccess: false,
+                    });
+                }
+                else if (status === 'success') {
+                    wsServer.sendUploadStatus('success', {
+                        status: 'success',
+                        packages: store.getState().packages,
+                        clientKey: getClientKey().clientKey,
+                        isSuccess: true,
+                    });
+                }
+            });
+        }
+        catch (error) {
+            wsServer.sendUploadStatus('error', {
+                status: 'error',
+                errMsg: error instanceof Error ? error.message : String(error),
+                isSuccess: false,
+            });
+        }
+        finally {
+            store.setState({
+                isUnderUploading: false,
+            });
+        }
     });
     eventEmitter.on('compileSuccess', () => {
         /**
@@ -1712,6 +1925,20 @@ function getLocalIPs() {
     }
 }
 
+function getLocalIP() {
+    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;
+            }
+        }
+    }
+}
+
 async function init() {
     const promptModule = inquirer.createPromptModule();
     const { clientKey: lastUsedClientKey } = getTTMGRC() || {};
@@ -1720,12 +1947,12 @@ async function init() {
             {
                 type: 'list',
                 name: 'selectedClientKey',
-                message: 'Select game client key for debugging:',
+                message: t('native.init.selectClientKey'),
                 choices: [{
-                        name: `${lastUsedClientKey} (last used)`,
+                        name: t('native.init.lastUsed', { clientKey: lastUsedClientKey }),
                         value: lastUsedClientKey,
                     }, {
-                        name: 'Add a new client key',
+                        name: t('native.init.addNew'),
                         value: 'new',
                     }],
             },
@@ -1738,10 +1965,10 @@ async function init() {
                 {
                     type: 'input',
                     name: 'clientKey',
-                    message: 'Input new client key:',
+                    message: t('native.init.inputNew'),
                     validate: input => {
                         if (!input) {
-                            return 'Client key is required, please input client key';
+                            return t('native.init.clientKeyRequired');
                         }
                         return true;
                     },
@@ -1764,10 +1991,10 @@ async function init() {
             {
                 type: 'input',
                 name: 'clientKey',
-                message: 'Input your Client Key:',
+                message: t('native.init.inputYour'),
                 validate: input => {
                     if (!input) {
-                        return 'Client key is required, please input client key';
+                        return t('native.init.clientKeyRequired');
                     }
                     return true;
                 },
@@ -1791,19 +2018,23 @@ function getDevToolVersion() {
 function showTips(context) {
     console.log(chalk.gray('─────────────────────────────────────────────'));
     console.log(chalk.yellow.bold('1.') +
-        ' The QR code page will be opened automatically in Chrome.');
-    console.log('   If it fails, please open the following link manually:');
+        t('native.tips.1'));
+    console.log(t('native.tips.1.sub'));
     console.log('   ' + chalk.cyan.underline(context.server));
     console.log('');
     console.log(chalk.yellow.bold('2.') +
-        ' The debugging service will automatically compile your game assets.');
-    console.log('   Any changes in your game directory will trigger recompilation.');
-    console.log('   You can debug the updated content when upload is completed.');
+        t('native.tips.2'));
+    console.log(t('native.tips.2.sub1'));
+    console.log(t('native.tips.2.sub2'));
     console.log('');
     console.log(chalk.yellow.bold('3.') +
-        ' After scanning the QR code with your phone for Test User authentication,');
-    console.log('   the compiled code package will be uploaded to the client automatically.');
-    console.log('   Game debugging will start right away.');
+        t('native.tips.3'));
+    console.log(t('native.tips.3.sub1'));
+    console.log(t('native.tips.3.sub2'));
+    console.log('');
+    console.log(chalk.red.bold('4. ⚠️') +
+        t('native.tips.4'));
+    console.log(t('native.tips.4.sub1'));
     console.log(chalk.gray('─────────────────────────────────────────────'));
 }
 
@@ -1887,7 +2118,7 @@ async function check() {
     //     process.exit(1);
     // } 
     if (!isWorkspace()) {
-        printBox('Error', `Current directory is not a Mini Game project entry directory, please enter the game project root directory for debugging`);
+        printBox('Error', t('native.check.notWorkspace'));
         process.exit(1);
     }
     // const checkResult = await checkPkgs({
@@ -1937,6 +2168,236 @@ async function check() {
     // }
 }
 
+const devToolVersion$1 = getDevToolVersion();
+async function listen(app, options) {
+    const maxRetries = options?.maxRetries;
+    const version = devToolVersion$1;
+    const server = http.createServer(app);
+    function tryListen(port) {
+        return new Promise(resolve => {
+            const onError = err => {
+                server.removeListener('listening', onListening);
+                if (err.code === 'EADDRINUSE') {
+                    console.log(chalk(t('native.server.portInUse', {
+                        port,
+                        next: port + 1,
+                    })));
+                    resolve(false);
+                }
+                else {
+                    console.log(chalk.red.bold(err.message));
+                    process.exit(1);
+                }
+            };
+            const onListening = () => {
+                server.removeListener('error', onError);
+                resolve(true);
+            };
+            server.once('error', onError);
+            server.once('listening', onListening);
+            server.listen(port);
+        });
+    }
+    let isListening = false;
+    for (let i = 0; i < maxRetries; i++) {
+        const currentPort = store.getState().nodeServerPort;
+        isListening = await tryListen(currentPort);
+        if (isListening) {
+            break;
+        }
+        store.setState({ nodeServerPort: currentPort + 1 });
+    }
+    if (!isListening) {
+        console.log(chalk.red.bold(t('native.server.failedAfterRetries', { retries: maxRetries })));
+        process.exit(1);
+    }
+    // @ts-ignore
+    const port = server.address().port;
+    const url = `http://localhost:${port}?v=${encodeURIComponent(version)}`;
+    return { server, port, url, version };
+}
+
+function setupMiddlewares(app, options) {
+    const { publicPath, outputDir } = options;
+    app.use(fileUpload());
+    app.use(expressStaticGzip(publicPath, {
+        enableBrotli: true,
+        orderPreference: ['br'],
+    }));
+    app.use((req, res, next) => {
+        res.header('Access-Control-Allow-Origin', '*');
+        res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
+        res.header('Cache-Control', 'no-cache, no-store, must-revalidate');
+        res.header('Pragma', 'no-cache');
+        res.header('Expires', '0');
+        res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+        next();
+    });
+    app.use(express.json());
+    app.use(express.urlencoded({ extended: true }));
+    app.use('/game/files', express.static(outputDir));
+}
+
+const successCode = 0;
+const errorCode = -1;
+
+function buildCheckPkgsOptions(outputDir) {
+    return {
+        entry: process.cwd(),
+        output: outputDir,
+        dev: {
+            enable: true,
+            port: store.getState().nodeServerPort,
+            host: 'localhost',
+            enableSourcemap: false,
+            enableLog: false,
+        },
+        build: {
+            enableOdr: false,
+            enableAPICheck: true,
+            ...PKG_SIZE_LIMIT,
+        },
+    };
+}
+
+const outputDir$2 = getOutputDir();
+const devToolVersion = getDevToolVersion();
+const gameConfigRoute = {
+    method: 'get',
+    path: '/game/config',
+    handler: async (req, res) => {
+        const [basic, checkResult] = await Promise.all([
+            ttmgPack.getPkgs({ entryDir: process.cwd() }),
+            ttmgPack.checkPkgs(buildCheckPkgsOptions(outputDir$2), {
+                lang: getCurrentLanguage(),
+            }),
+        ]);
+        const user = getCurrentUser();
+        const { clientKey } = getClientKey();
+        const localLang = getConfiguredLanguage();
+        res.send({
+            error: null,
+            data: {
+                user,
+                code: successCode,
+                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()))}`,
+                ...basic,
+                devToolVersion,
+                checkResult,
+                lang: localLang,
+            },
+        });
+    },
+};
+
+const gameConfigFillbackRoute = {
+    method: 'post',
+    path: '/game/config-fillback',
+    handler: async (req, res) => {
+        const configuredLang = getConfiguredLanguage();
+        if (configuredLang) {
+            res.send({
+                code: successCode,
+                data: {
+                    lang: configuredLang,
+                    updated: false,
+                },
+            });
+            return;
+        }
+        const incomingLang = req.body?.lang;
+        const fallbackLang = resolveSupportedLanguage(incomingLang);
+        if (!fallbackLang) {
+            res.send({
+                code: successCode,
+                data: {
+                    lang: null,
+                    updated: false,
+                },
+            });
+            return;
+        }
+        setTTMGRC({ lang: fallbackLang });
+        res.send({
+            code: successCode,
+            data: {
+                lang: fallbackLang,
+                updated: true,
+            },
+        });
+    },
+};
+
+const outputDir$1 = getOutputDir();
+const gameCheckRoute = {
+    method: 'get',
+    path: '/game/check',
+    handler: async (req, res) => {
+        const checkResult = await ttmgPack.checkPkgs(buildCheckPkgsOptions(outputDir$1), {
+            lang: getCurrentLanguage(),
+        });
+        res.send({ code: successCode, data: checkResult });
+    },
+};
+
+const gameDetailRoute = {
+    method: 'get',
+    path: '/game/detail',
+    handler: async (req, res) => {
+        const basic = await ttmgPack.getPkgs({ entryDir: process.cwd() });
+        const { clientKey } = getClientKey();
+        const { error, data: gameInfo } = await fetchGameInfo(clientKey);
+        store.setState({
+            appId: gameInfo?.app_id,
+        });
+        if (error) {
+            res.send({ error, data: null });
+            return;
+        }
+        res.send({ error: null, data: { ...basic, ...gameInfo } });
+    },
+};
+
+const gameUploadRoute = {
+    method: 'post',
+    path: '/game/upload',
+    handler: async (req, res) => {
+        try {
+            console.log(t('native.server.upload.packingDir', { cwd: process.cwd() }));
+            const gameZipBuffer = await zipCwdToBuffer();
+            console.log(t('native.server.upload.packed', {
+                size: (gameZipBuffer.length / 1024 / 1024).toFixed(2),
+            }));
+            const desc = req.headers['ttmg-game-desc'];
+            const decodedDesc = decodeURIComponent(desc || '--');
+            const { data, error } = await uploadGameToPlatform({
+                // @ts-ignore
+                data: gameZipBuffer,
+                name: 'game.zip',
+                clientKey: getClientKey().clientKey,
+                note: decodedDesc,
+                appId: store.getState().appId,
+            });
+            if (error) {
+                res.send({ code: errorCode, error });
+            }
+            else {
+                res.send({ code: successCode, data });
+            }
+        }
+        catch (error) {
+            let errorMessage = t('common.unknownError');
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            console.error(t('native.server.upload.failed', { error: errorMessage }));
+            res.status(500).send({ code: errorCode, data: errorMessage });
+        }
+    },
+};
+
 const BASE_URL = 'https://developers.tiktok.com';
 const DEV_HEADERS = {
 // 'x-use-ppe': '1',
@@ -2825,212 +3286,56 @@ const getTaskInfo = async (params) => {
     });
 };
 
-const successCode = 0;
-const errorCode = -1;
-const outputDir = getOutputDir();
-const publicPath = path.join(__dirname, 'public');
-const devToolVersion = getDevToolVersion();
-async function start() {
-    const startTime = Date.now();
-    const app = express();
-    app.use(fileUpload()); // 启用 express-fileupload 中间件
-    // --- 中间件和路由设置 ---
-    app.use(expressStaticGzip(publicPath, {
-        enableBrotli: true,
-        orderPreference: ['br'],
-    }));
-    app.use((req, res, next) => {
-        res.header('Access-Control-Allow-Origin', '*');
-        res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
-        res.header('Cache-Control', 'no-cache, no-store, must-revalidate');
-        res.header('Pragma', 'no-cache');
-        res.header('Expires', '0');
-        res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-        next();
-    });
-    app.use(express.json());
-    app.use(express.urlencoded({ extended: true }));
-    app.use('/game/files', express.static(outputDir));
-    app.get('/game/config', async (req, res) => {
-        const [basic, checkResult] = await Promise.all([
-            ttmgPack.getPkgs({ entryDir: process.cwd() }),
-            ttmgPack.checkPkgs({
-                entry: process.cwd(),
-                output: outputDir,
-                dev: {
-                    enable: true,
-                    port: store.getState().nodeServerPort,
-                    host: 'localhost',
-                    enableSourcemap: false,
-                    enableLog: false,
-                },
-                build: {
-                    enableOdr: false,
-                    enableAPICheck: true,
-                    ...PKG_SIZE_LIMIT,
-                },
-            }),
-        ]);
-        const user = getCurrentUser();
-        const { clientKey } = getClientKey();
-        res.send({
-            error: null,
-            data: {
-                user,
-                code: successCode,
-                nodeWsPort: store.getState().nodeWsPort,
-                clientKey: clientKey,
-                schema: `https://www.tiktok.com/ttmg/dev/${clientKey}?host=${getLocalIP()}&port=${store.getState().nodeWsPort}&host_list=${encodeURIComponent(JSON.stringify(getLocalIPs()))}`,
-                ...basic,
-                devToolVersion,
-                checkResult,
-            },
-        });
-    });
-    app.get('/game/detail', async (req, res) => {
-        const basic = await ttmgPack.getPkgs({ entryDir: process.cwd() });
-        const { clientKey } = getClientKey();
-        const { error, data: gameInfo } = await fetchGameInfo(clientKey);
-        store.setState({
-            appId: gameInfo?.app_id,
-        });
-        if (error) {
-            res.send({ error, data: null });
-            return;
-        }
-        else {
-            res.send({ error: null, data: { ...basic, ...gameInfo } });
-        }
-    });
-    app.get('/game/check', async (req, res) => {
-        const checkResult = await ttmgPack.checkPkgs({
-            entry: process.cwd(),
-            output: outputDir,
-            dev: {
-                enable: true,
-                port: store.getState().nodeServerPort,
-                host: 'localhost',
-                enableSourcemap: false,
-                enableLog: false,
-            },
-            build: {
-                enableOdr: false,
-                enableAPICheck: true,
-                ...PKG_SIZE_LIMIT,
-            },
+const gameWasmCancelRoute = {
+    method: 'post',
+    path: '/game/wasm-cancel',
+    handler: async (req, res) => {
+        const { codePath } = req.body;
+        console.log('wasm-cancel', req.body);
+        await cancelSplit({
+            wasmCodePath: codePath,
         });
-        res.send({ code: successCode, data: checkResult });
-    });
-    app.post('/game/upload', async (req, res) => {
-        try {
-            console.log(`正在打包当前目录: ${process.cwd()} ...`);
-            const gameZipBuffer = await zipCwdToBuffer();
-            // 变成 MB
-            console.log(`打包完成，大小: ${(gameZipBuffer.length / 1024 / 1024).toFixed(2)} MB`);
-            const desc = req.headers['ttmg-game-desc'];
-            const decodedDesc = decodeURIComponent(desc || '--');
-            const { data, error } = await uploadGameToPlatform({
-                // @ts-ignore
-                data: gameZipBuffer,
-                name: 'game.zip',
-                clientKey: getClientKey().clientKey,
-                note: decodedDesc,
-                appId: store.getState().appId,
-            });
-            if (error) {
-                res.send({ code: errorCode, error });
-            }
-            else {
-                res.send({ code: successCode, data });
-            }
-        }
-        catch (error) {
-            let errorMessage = 'An unknown error occurred.';
-            if (error instanceof Error) {
-                errorMessage = error.message;
-            }
-            console.error('Upload failed:', errorMessage);
-            res.status(500).send({ code: errorCode, data: errorMessage });
-        }
-    });
-    app.get('/game/wasm-split-config', (req, res) => {
-        const config = getSplitConfig();
-        if (!config) {
-            res.send({ code: errorCode, data: 'Failed to parse split config' });
-        }
-        else {
-            res.send({ code: successCode, data: config });
-        }
-    });
-    app.get('/game/wasm-split-options', (req, res) => {
         res.send({
             code: successCode,
-            data: {
-                options: [
-                    {
-                        md5: '123',
-                        desc: 'test',
-                        version: '1.0.0',
-                        time: '2023-01-01',
-                        funcCounts: 100,
-                    },
-                    {
-                        md5: '456',
-                        desc: 'test2',
-                        version: '1.0.1',
-                        time: '2023-01-02',
-                        funcCounts: 200,
-                    },
-                ],
-            },
+            msg: 'cancel success',
         });
-    });
-    /**
-     * 分包预处理
-     */
-    app.post('/game/wasm-prepare', async (req, res) => {
-        const { codePath, desc, codeMd5, clientKey } = req.body;
-        console.log('wasm-prepare-start', req.body);
-        const result = await startPrepare({
+    },
+};
+
+const gameWasmCollectFuncidsRoute = {
+    method: 'get',
+    path: '/game/wasm-collect-funcids',
+    handler: async (req, res) => {
+        const { clientKey, codeMd5 } = req.query;
+        console.log('wasm-collect-funcids', req.query);
+        const response = await getCollectedFuncIds({
             client_key: clientKey,
-            desc,
             wasm_md5: codeMd5,
-            wasm_file_path: codePath,
         });
-        console.log('wasm-prepare-end', result);
-        if (result.error) {
+        if (response.error) {
             res.send({
                 code: errorCode,
-                error: result.error,
-                ctx: result.ctx,
+                error: response.error,
+                ctx: response.ctx,
             });
         }
         else {
-            const { md5 } = result.data?.result || {};
-            if (!md5) {
-                res.send({
-                    code: errorCode,
-                    error: result.data,
-                    ctx: result.ctx,
-                });
-            }
-            else {
-                res.send({
-                    code: successCode,
-                    data: result.data?.result || {},
-                    ctx: result.ctx,
-                });
-            }
+            res.send({
+                code: successCode,
+                data: response.data?.result || {},
+                ctx: response.ctx,
+            });
         }
-    });
-    /**
-     * @description 分包预处理查询，根据 taskId 查询预处理状态
-     * 前十次返回 process，第11次返回 success
-     */
-    app.post('/game/wasm-prepare-result', async (req, res) => {
-        console.log('wasm-prepare-result-request', req.body);
-        const { clientKey, codeMd5 } = req.body;
-        const response = await getTaskStatus({
+    },
+};
+
+const gameWasmCollectInfoRoute = {
+    method: 'get',
+    path: '/game/wasm-collect-info',
+    handler: async (req, res) => {
+        const { clientKey, codeMd5 } = req.query;
+        console.log('wasm-collect-info', req.query);
+        const response = await getCollecttingInfo({
             client_key: clientKey,
             wasm_md5: codeMd5,
         });
@@ -3048,14 +3353,13 @@ async function start() {
                 ctx: response.ctx,
             });
         }
-    });
-    /**
-     * @description 下载预处理后的 wasm 包
-     */
-    app.post('/game/wasm-prepare-download', async (req, res) => {
-        /**
-         * 下载完成后需要进行 br 并替换 codePath 对应的文件后再返回成功
-         */
+    },
+};
+
+const gameWasmPrepareDownloadRoute = {
+    method: 'post',
+    path: '/game/wasm-prepare-download',
+    handler: async (req, res) => {
         const { clientKey, codeMd5, codePath } = req.body;
         console.log('wasm-prepare-download-start', req.body);
         const response = await downloadPrepared({
@@ -3077,14 +3381,16 @@ async function start() {
                 ctx: response.ctx,
             });
         }
-    });
-    /**
-     * 开始代码分包
-     */
-    app.post('/game/wasm-split', async (req, res) => {
+    },
+};
+
+const gameWasmPrepareResultRoute = {
+    method: 'post',
+    path: '/game/wasm-prepare-result',
+    handler: async (req, res) => {
+        console.log('wasm-prepare-result-request', req.body);
         const { clientKey, codeMd5 } = req.body;
-        console.log('wasm-split-start', req.body);
-        const response = await startSplit({
+        const response = await getTaskStatus({
             client_key: clientKey,
             wasm_md5: codeMd5,
         });
@@ -3098,34 +3404,57 @@ async function start() {
         else {
             res.send({
                 code: successCode,
-                data: response.data,
+                data: response.data?.result || {},
                 ctx: response.ctx,
             });
         }
-    });
-    app.get('/game/wasm-taskinfo', async (req, res) => {
-        const { clientKey, codeMd5 } = req.query;
-        console.log('wasm-taskinfo', req.query);
-        const response = await getTaskInfo({
+    },
+};
+
+const gameWasmPrepareRoute = {
+    method: 'post',
+    path: '/game/wasm-prepare',
+    handler: async (req, res) => {
+        const { codePath, desc, codeMd5, clientKey } = req.body;
+        console.log('wasm-prepare-start', req.body);
+        const result = await startPrepare({
             client_key: clientKey,
+            desc,
             wasm_md5: codeMd5,
+            wasm_file_path: codePath,
         });
-        if (response.error) {
+        console.log('wasm-prepare-end', result);
+        if (result.error) {
             res.send({
                 code: errorCode,
-                error: response.error,
-                ctx: response.ctx,
+                error: result.error,
+                ctx: result.ctx,
             });
         }
         else {
-            res.send({
-                code: successCode,
-                data: response.data?.result || {},
-                ctx: response.ctx,
-            });
+            const { md5 } = result.data?.result || {};
+            if (!md5) {
+                res.send({
+                    code: errorCode,
+                    error: result.data,
+                    ctx: result.ctx,
+                });
+            }
+            else {
+                res.send({
+                    code: successCode,
+                    data: result.data?.result || {},
+                    ctx: result.ctx,
+                });
+            }
         }
-    });
-    app.post('/game/wasm-set-collect', async (req, res) => {
+    },
+};
+
+const gameWasmSetCollectRoute = {
+    method: 'post',
+    path: '/game/wasm-set-collect',
+    handler: async (req, res) => {
         const { clientKey, codeMd5 } = req.body;
         console.log('wasm-set-collect', req.body);
         const response = await setCollect({
@@ -3146,13 +3475,19 @@ async function start() {
                 ctx: response.ctx,
             });
         }
-    });
-    app.get('/game/wasm-collect-funcids', async (req, res) => {
-        const { clientKey, codeMd5 } = req.query;
-        console.log('wasm-collect-funcids', req.query);
-        const response = await getCollectedFuncIds({
+    },
+};
+
+const gameWasmSplitDownloadResultRoute = {
+    method: 'post',
+    path: '/game/wasm-split-download-result',
+    handler: async (req, res) => {
+        const { clientKey, codeMd5, codePath } = req.body;
+        console.log('game/wasm-split-download-result-start', req.body);
+        const response = await getSplitResult({
             client_key: clientKey,
             wasm_md5: codeMd5,
+            wasm_path: codePath,
         });
         if (response.error) {
             res.send({
@@ -3162,20 +3497,47 @@ async function start() {
             });
         }
         else {
+            const splitResult = (response.data?.result || {});
+            const requiredDownloadFields = [
+                'main_wasm_download_url',
+                'main_wasm_h5_download_url',
+                // 'sub_wasm_download_url',
+                // 'sub_js_download_url',
+                // 'sub_js_data_download_url',
+                // 'sub_js_range_download_url',
+            ];
+            const missingFields = requiredDownloadFields.filter(field => {
+                const value = splitResult[field];
+                return typeof value !== 'string' || value.trim() === '';
+            });
+            if (missingFields.length > 0) {
+                res.send({
+                    code: errorCode,
+                    error: {
+                        message: `Missing required wasm split fields: ${missingFields.join(', ')}`,
+                    },
+                    data: response.data || {},
+                    ctx: response.ctx,
+                });
+                return;
+            }
             res.send({
                 code: successCode,
-                data: response.data?.result || {},
+                data: response.data || {},
+                msg: 'download success',
                 ctx: response.ctx,
             });
         }
-    });
-    app.get('/game/wasm-collect-info', async (req, res) => {
-        const { clientKey, codeMd5 } = req.query;
-        console.log('wasm-collect-info', req.query);
-        const response = await getCollecttingInfo({
-            client_key: clientKey,
-            wasm_md5: codeMd5,
-        });
+    },
+};
+
+const gameWasmSplitDownloadRoute = {
+    method: 'post',
+    path: '/game/wasm-split-download',
+    handler: async (req, res) => {
+        console.log('game/wasm-split-download-start', req.body);
+        const response = await downloadSplited(req.body);
+        console.log('game/wasm-split-download-end', response);
         if (response.error) {
             res.send({
                 code: errorCode,
@@ -3186,21 +3548,51 @@ async function start() {
         else {
             res.send({
                 code: successCode,
-                data: response.data?.result || {},
+                data: response.data || {},
+                msg: 'download success',
                 ctx: response.ctx,
             });
         }
-    });
-    /**
-     * 获取代码分包结果
-     */
-    app.post('/game/wasm-split-result', async (req, res) => {
-        const { codeMd5, clientKey } = req.body;
-        console.log('wasm-split-result', req.body);
-        const response = await getTaskStatus({
-            client_key: clientKey,
-            wasm_md5: codeMd5,
+    },
+};
+
+const gameWasmSplitOptionsRoute = {
+    method: 'get',
+    path: '/game/wasm-split-options',
+    handler: (req, res) => {
+        res.send({
+            code: successCode,
+            data: {
+                options: [
+                    {
+                        md5: '123',
+                        desc: 'test',
+                        version: '1.0.0',
+                        time: '2023-01-01',
+                        funcCounts: 100,
+                    },
+                    {
+                        md5: '456',
+                        desc: 'test2',
+                        version: '1.0.1',
+                        time: '2023-01-02',
+                        funcCounts: 200,
+                    },
+                ],
+            },
         });
+    },
+};
+
+const gameWasmSplitResetRoute = {
+    method: 'post',
+    path: '/game/wasm-split-reset',
+    handler: async (req, res) => {
+        const { clientKey, codeMd5, codePath } = req.body;
+        console.log('wasm-split-reset', req.body);
+        const response = await resetWasmSplit({
+            clientkey: clientKey,
+            wasmMd5: codeMd5});
         if (response.error) {
             res.send({
                 code: errorCode,
@@ -3211,21 +3603,22 @@ async function start() {
         else {
             res.send({
                 code: successCode,
-                data: response.data?.result || {},
+                data: response.data || {},
                 ctx: response.ctx,
             });
         }
-    });
-    /**
-     * @description 下载分包产物后，查询并返回下载结果
-     */
-    app.post('/game/wasm-split-download-result', async (req, res) => {
-        const { clientKey, codeMd5, codePath } = req.body;
-        console.log('game/wasm-split-download-result-start', req.body);
-        const response = await getSplitResult({
+    },
+};
+
+const gameWasmSplitResultRoute = {
+    method: 'post',
+    path: '/game/wasm-split-result',
+    handler: async (req, res) => {
+        const { codeMd5, clientKey } = req.body;
+        console.log('wasm-split-result', req.body);
+        const response = await getTaskStatus({
             client_key: clientKey,
             wasm_md5: codeMd5,
-            wasm_path: codePath,
         });
         if (response.error) {
             res.send({
@@ -3237,16 +3630,37 @@ async function start() {
         else {
             res.send({
                 code: successCode,
-                data: response.data || {},
-                msg: 'download success',
+                data: response.data?.result || {},
                 ctx: response.ctx,
             });
         }
-    });
-    app.post('/game/wasm-split-download', async (req, res) => {
-        console.log('game/wasm-split-download-start', req.body);
-        const response = await downloadSplited(req.body);
-        console.log('game/wasm-split-download-end', response);
+    },
+};
+
+const gameWasmSplitConfigRoute = {
+    method: 'get',
+    path: '/game/wasm-split-config',
+    handler: (req, res) => {
+        const config = getSplitConfig();
+        if (!config) {
+            res.send({ code: errorCode, data: 'Failed to parse split config' });
+        }
+        else {
+            res.send({ code: successCode, data: config });
+        }
+    },
+};
+
+const gameWasmSplitRoute = {
+    method: 'post',
+    path: '/game/wasm-split',
+    handler: async (req, res) => {
+        const { clientKey, codeMd5 } = req.body;
+        console.log('wasm-split-start', req.body);
+        const response = await startSplit({
+            client_key: clientKey,
+            wasm_md5: codeMd5,
+        });
         if (response.error) {
             res.send({
                 code: errorCode,
@@ -3257,29 +3671,23 @@ async function start() {
         else {
             res.send({
                 code: successCode,
-                data: response.data || {},
-                msg: 'download success',
+                data: response.data,
                 ctx: response.ctx,
             });
         }
-    });
-    app.post('/game/wasm-cancel', async (req, res) => {
-        const { clientKey, codePath } = req.body;
-        console.log('wasm-cancel', req.body);
-        await cancelSplit({
-            wasmCodePath: codePath,
-        });
-        res.send({
-            code: successCode,
-            msg: 'cancel success',
+    },
+};
+
+const gameWasmTaskinfoRoute = {
+    method: 'get',
+    path: '/game/wasm-taskinfo',
+    handler: async (req, res) => {
+        const { clientKey, codeMd5 } = req.query;
+        console.log('wasm-taskinfo', req.query);
+        const response = await getTaskInfo({
+            client_key: clientKey,
+            wasm_md5: codeMd5,
         });
-    });
-    app.post('/game/wasm-split-reset', async (req, res) => {
-        const { clientKey, codeMd5, codePath } = req.body;
-        console.log('wasm-split-reset', req.body);
-        const response = await resetWasmSplit({
-            clientkey: clientKey,
-            wasmMd5: codeMd5});
         if (response.error) {
             res.send({
                 code: errorCode,
@@ -3290,133 +3698,352 @@ async function start() {
         else {
             res.send({
                 code: successCode,
-                data: response.data || {},
+                data: response.data?.result || {},
                 ctx: response.ctx,
             });
         }
+    },
+};
+
+function getGameFallbackRoute(publicPath) {
+    return {
+        method: 'get',
+        path: '*',
+        handler: (req, res) => {
+            res.sendFile(path.join(publicPath, 'index.html'));
+        },
+    };
+}
+
+const routes = [
+    gameConfigRoute,
+    gameConfigFillbackRoute,
+    gameDetailRoute,
+    gameCheckRoute,
+    gameUploadRoute,
+    gameWasmSplitConfigRoute,
+    gameWasmSplitOptionsRoute,
+    gameWasmPrepareRoute,
+    gameWasmPrepareResultRoute,
+    gameWasmPrepareDownloadRoute,
+    gameWasmSplitRoute,
+    gameWasmTaskinfoRoute,
+    gameWasmSetCollectRoute,
+    gameWasmCollectFuncidsRoute,
+    gameWasmCollectInfoRoute,
+    gameWasmSplitResultRoute,
+    gameWasmSplitDownloadResultRoute,
+    gameWasmSplitDownloadRoute,
+    gameWasmCancelRoute,
+    gameWasmSplitResetRoute,
+];
+function registerRoutes(app, options) {
+    const allRoutes = [...routes, getGameFallbackRoute(options.publicPath)];
+    for (const route of allRoutes) {
+        if (route.method === 'get') {
+            app.get(route.path, route.handler);
+        }
+        else if (route.method === 'post') {
+            app.post(route.path, route.handler);
+        }
+    }
+}
+
+const outputDir = getOutputDir();
+const publicPath = path.join(__dirname, 'public');
+async function start() {
+    const startTime = Date.now();
+    const app = express();
+    setupMiddlewares(app, { publicPath, outputDir });
+    registerRoutes(app, { publicPath });
+    const { url, version } = await listen(app, { maxRetries: 20 });
+    console.log(chalk.green.bold(`TTMG`), chalk.green(`v${version}`), chalk.gray(t('native.server.readyIn')), chalk.bold(`${Date.now() - startTime}ms`));
+    showTips({ server: url });
+    openUrl(url);
+}
+
+async function dev() {
+    await check();
+    await init();
+    await start();
+    await compile();
+    listen$1();
+    watch();
+}
+
+function printMessage(type, message) {
+    const prefix = type === 'Error'
+        ? chalk.red(t('login.error.prefix'))
+        : chalk.yellow(t('login.warning.prefix'));
+    const log = type === 'Error' ? console.error : console.warn;
+    log(prefix + message);
+}
+let spinner;
+const LOGIN_TT4D = 'https://developers.tiktok.com/passport/web/email/login';
+const params = {
+    aid: '2471',
+    account_sdk_source: 'web',
+    sdk_version: '2.1.6-tiktok',
+};
+const prompt = inquirer.createPromptModule();
+async function login(options) {
+    const verbose = options?.verbose === true;
+    const log = (msg, data) => {
+        if (!verbose)
+            return;
+        console.log(chalk.gray('[ttmg login]'), msg, data !== undefined ? data : '');
+    };
+    if (verbose)
+        log(t('login.verbose.enabled'));
+    console.log(chalk.yellowBright(t('login.note')));
+    const { email, password } = await prompt([
+        {
+            type: 'input',
+            name: 'email',
+            message: t('login.email.prompt'),
+            validate: input => {
+                if (!input) {
+                    return t('login.email.required');
+                }
+                else {
+                    if (!/^[a-zA-Z0-9_.-]+@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*\.[a-zA-Z0-9]{2,6}$/.test(input)) {
+                        return t('login.email.invalid');
+                    }
+                }
+                return true;
+            },
+        },
+        {
+            type: 'password',
+            name: 'password',
+            message: t('login.password.prompt'),
+            mask: '*',
+            validate: input => {
+                if (!input) {
+                    return t('login.password.required');
+                }
+                return true;
+            },
+        },
+    ]);
+    const url = LOGIN_TT4D + '?' + new URLSearchParams(params);
+    log('Request URL', url);
+    log('Request params', { ...params, email: email.replace(/(.{2}).*(@.*)/, '$1***$2') });
+    const headers = {
+        'Content-Type': 'application/x-www-form-urlencoded',
+        Accept: '*/*',
+        'Accept-Encoding': 'gzip, deflate, br',
+        Origin: 'https://developers.tiktok.com',
+        Referer: 'https://developers.tiktok.com/passport/web/email/login',
+        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0 Safari/537.36',
+    };
+    const ora = await import('ora');
+    spinner = ora.default({
+        text: chalk.bold.cyan(t('login.spinner.loggingIn')),
+        spinner: 'dots',
     });
-    app.get('*', (req, res) => {
-        res.sendFile(path.join(publicPath, `index.html`));
+    spinner.start();
+    const data = qs.stringify({
+        email,
+        password,
+        mix_mode: '1',
+        fixed_mix_mode: '1',
     });
-    // --- 中间件和路由设置结束 ---
-    // 步骤 2: 用配置好的 app 实例创建一个 http.Server。我们只创建这一次！
-    const server = http.createServer(app);
-    /**
-     * @description 尝试在指定端口启动服务。这是个纯粹的辅助函数。
-     * @param {number} port - 要尝试的端口号。
-     * @returns {Promise<boolean>} 成功返回 true，因端口占用失败则返回 false。
-     */
-    function tryListen(port) {
-        return new Promise(resolve => {
-            // 定义错误处理函数
-            const onError = err => {
-                // 清理掉另一个事件的监听器，防止内存泄漏
-                server.removeListener('listening', onListening);
-                if (err.code === 'EADDRINUSE') {
-                    console.log(chalk(`Port ${port} is already in use, trying ${port + 1}...`));
-                    resolve(false); // 明确表示因端口占用而失败
+    try {
+        log('Sending POST request...');
+        const response = await axios.post(url, data, {
+            headers,
+            maxRedirects: 20,
+            timeout: 30000,
+        });
+        log('Response status', response.status);
+        log('Response data', response?.data);
+        if (!response?.data?.data?.user_id) {
+            const errCode = response.data?.data?.error_code;
+            const errMsg = response.data?.data?.description;
+            const statusText = response?.statusText ?? '';
+            spinner.fail(chalk.red(t('login.failed')));
+            if (verbose) {
+                console.log(chalk.gray('Response status:'), response?.status);
+                console.log(chalk.gray('Response statusText:'), statusText || '(empty)');
+                console.log(chalk.gray('Response data:'), response?.data ?? '(empty)');
+                console.log('');
+            }
+            if (errCode || errMsg) {
+                log('Login failed (api)', { errCode, errMsg, fullData: response?.data });
+                printMessage('Error', errCode
+                    ? t('login.error.withCode', {
+                        message: String(errMsg ?? ''),
+                        code: String(errCode),
+                    })
+                    : errMsg
+                        ? t('login.error.withMessage', { message: String(errMsg) })
+                        : t('login.error.noUserId'));
+            }
+            else {
+                log('Login failed (no user_id)', { responseBody: response?.data });
+                if (verbose)
+                    log('Full response (for debugging)', response);
+                const looksLikeProxyResponse = statusText === 'Connection established' ||
+                    (response?.status === 200 &&
+                        (response?.data == null ||
+                            typeof response.data !== 'object' ||
+                            !('data' in response.data)));
+                if (looksLikeProxyResponse) {
+                    printMessage('Warning', t('login.warning.proxyIssue'));
                 }
                 else {
-                    // 对于其他致命错误，直接退出进程
-                    console.log(chalk.red.bold(err.message));
-                    process.exit(1);
+                    printMessage('Error', t('login.error.noUserId'));
                 }
-            };
-            // 定义成功处理函数
-            const onListening = () => {
-                // 清理掉另一个事件的监听器
-                server.removeListener('error', onError);
-                resolve(true); // 明确表示成功
-            };
-            // 使用 .once() 来确保监听器只执行一次然后自动移除
-            server.once('error', onError);
-            server.once('listening', onListening);
-            // 执行监听动作
-            server.listen(port);
-        });
-    }
-    // 步骤 3: 使用循环来线性、串行地尝试启动服务
-    let isListening = false;
-    const maxRetries = 20; // 设置一个最大重试次数，以防万一
-    for (let i = 0; i < maxRetries; i++) {
-        const currentPort = store.getState().nodeServerPort;
-        isListening = await tryListen(currentPort);
-        if (isListening) {
-            break; // 成功，跳出循环
+            }
+            spinner.stop();
+            process.exit(1);
         }
         else {
-            // 失败（端口占用），更新端口号，准备下一次循环
-            store.setState({ nodeServerPort: currentPort + 1 });
+            const loginData = {
+                email,
+                user_id: response?.data?.data?.user_id,
+                cookie: response?.headers['set-cookie'].join('; '),
+            };
+            log('Login success', { user_id: loginData.user_id, email: loginData.email });
+            setTTMGRC(loginData);
+            spinner.succeed(chalk.bold.green(t('login.success')));
+            process.exit(0);
         }
     }
-    // 步骤 4: 检查最终结果，如果所有尝试都失败了，则退出
-    if (!isListening) {
-        console.log(chalk.red.bold(`Failed to start server after trying ${maxRetries} ports.`));
+    catch (error) {
+        log('Request error', error instanceof Error ? { message: error.message, name: error.name, stack: error.stack } : error);
+        spinner.fail(chalk.red.bold(t('login.error.connectService')));
+        printMessage('Error', t('login.error.networkBlocked'));
         process.exit(1);
     }
-    // --- 服务启动成功后的逻辑 ---
-    // @ts-ignore
-    const finalPort = server.address().port; // 从成功的 server 实例安全地获取最终端口
-    console.log(chalk.green.bold(`TTMG`), chalk.green(`v${devToolVersion}`), chalk.gray(`ready in`), chalk.bold(`${Date.now() - startTime}ms`));
-    const baseUrl = `http://localhost:${finalPort}?v=${devToolVersion}`;
-    showTips({ server: baseUrl });
-    openUrl(baseUrl);
 }
 
-async function dev() {
-    await check();
-    await init();
-    await start();
-    await compile();
-    listen();
-    watch();
+const supportedLangs = ['en-US', 'zh-CN'];
+function isSupportedLang(lang) {
+    return supportedLangs.includes(lang);
+}
+async function setup(options) {
+    const inputLang = options?.lang;
+    if (inputLang !== undefined && !isSupportedLang(inputLang)) {
+        console.error(chalk.red(t('setup.error.unsupportedLang', { lang: inputLang })));
+        console.error(chalk.yellow(t('setup.error.availableLangs')));
+        console.error(chalk.cyan(t('setup.error.chooseHint')));
+        process.exit(1);
+    }
+    const lang = inputLang ??
+        (await inquirer.createPromptModule()([
+            {
+                type: 'list',
+                name: 'lang',
+                message: t('setup.prompt.selectLanguage'),
+                choices: [
+                    { name: t('setup.choice.en'), value: 'en-US' },
+                    { name: t('setup.choice.zh'), value: 'zh-CN' },
+                ],
+                default: 'en-US',
+            },
+        ])).lang;
+    setTTMGRC({ lang });
+    console.log(chalk.green.bold(t('setup.success', { lang }, lang)));
+    process.exit(0);
 }
 
-var version = "0.3.2-beta.5";
+async function checkUpdate() {
+    const worker = new worker_threads.Worker(path.resolve(__dirname, './scripts/worker.js'));
+    worker.on('message', msg => {
+        // console.log(msg);
+    });
+    worker.on('error', err => {
+        console.error(err);
+    });
+    worker.postMessage({
+        type: 'checkUpdate',
+        lang: getCurrentLanguage(),
+    });
+}
+
+async function reset() {
+    console.log(chalk.yellow.bold(t('reset.warning.title')));
+    console.log(chalk.yellow(`1. ${t('reset.warning.lang')}`));
+    console.log(chalk.yellow(`2. ${t('reset.warning.login')}`));
+    console.log(chalk.yellow(`3. ${t('reset.warning.clientKey')}`));
+    console.log('');
+    const prompt = inquirer.createPromptModule();
+    const { confirmed } = await prompt([
+        {
+            type: 'list',
+            name: 'confirmed',
+            message: t('reset.confirm.prompt'),
+            choices: [
+                { name: t('reset.confirm.yes'), value: true },
+                { name: t('reset.confirm.no'), value: false },
+            ],
+            default: false,
+        },
+    ]);
+    if (!confirmed) {
+        console.log(chalk.gray(t('reset.cancelled')));
+        process.exit(0);
+    }
+    // Reset to an empty local state.
+    resetTTMGRC({});
+    console.log(chalk.green.bold(t('reset.success')));
+    process.exit(0);
+}
+
+var version = "0.3.2-beta.6";
 var pkg = {
 	version: version};
 
 const program = new commander.Command();
+maybeShowPostInstallNotice(pkg.version);
 program
     .name('ttmg')
-    .description('TikTok Mini Games Command Line Tool')
-    .version(pkg.version, '-v, --version', '显示版本号')
-    .option('dev', 'Debug TikTok Mini Games for Client')
-    .option('dev --h5', 'Debug TikTok Mini Games for Web');
+    .description(t('cli.description'))
+    .version(pkg.version, '-v, --version', t('cli.version.desc'))
+    .option('dev', t('cli.option.dev.client'))
+    .option('dev --h5', t('cli.option.dev.h5'));
 program
     .command('login')
-    .description('User Dev Portal Account to Login')
-    .option('--verbose', 'Print verbose logs for debugging')
+    .description(t('cli.command.login.desc'))
+    .option('--verbose', t('cli.command.login.verbose'))
     .action(async (cmd) => {
     await login({ verbose: cmd.verbose });
 });
 program
     .command('setup')
-    .description('Initialize ttmg environment')
-    .option('--lang <lang>', 'Language: en-US | zh-CN')
+    .description(t('cli.command.setup.desc'))
+    .option('--lang <lang>', t('cli.command.setup.lang'))
     .action(async (cmd) => {
     await setup({ lang: cmd.lang });
 });
 program
-    .option('--h5', 'H5 Mini Game')
+    .command('reset')
+    .description(t('cli.command.reset.desc'))
+    .action(async () => {
+    await reset();
+});
+program
+    .option('--h5', t('cli.option.h5'))
     .command('init')
-    .description('Initialize project')
+    .description(t('cli.command.init.desc'))
     .action(() => {
     const options = program.opts(); // 获取 options
     if (options.h5) {
         init$1();
     }
     else {
-        console.log('Native Mini Game initialize');
+        console.log(t('cli.native.init.placeholder'));
     }
 });
 /**
  * ttmg dev 命令
  */
 program
-    .option('--h5', 'H5 Mini Game')
+    .option('--h5', t('cli.option.h5'))
     .command('dev')
-    .description('Open browser dev environment')
+    .description(t('cli.command.dev.desc'))
     .action(async () => {
     const options = program.opts();
     if (options.h5) {
@@ -3431,16 +4058,16 @@ program
  * ttmg build 命令
  */
 program
-    .option('--h5', 'H5 Mini Game')
+    .option('--h5', t('cli.option.h5'))
     .command('build')
-    .description('Bundle project')
+    .description(t('cli.command.build.desc'))
     .action(() => {
     const options = program.opts(); // 获取 options
     if (options.h5) {
         build();
     }
     else {
-        console.log('Native Mini Game bundle');
+        console.log(t('cli.native.build.placeholder'));
     }
 });
 program.parse(process.argv);