@cloudbase/cli 2.9.8 → 2.9.10-beta.0

package/lib/utils/tcbrApi/callTcbrApi.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.callTcbrApi = void 0;
 const toolbox_1 = require("@cloudbase/toolbox");
 const net_1 = require("../net");
+const i18n_1 = require("../../i18n");
 const tcbrService = net_1.CloudApiService.getInstance('tcbr');
 function callTcbrApi(action, data) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -26,7 +27,7 @@ function callTcbrApi(action, data) {
         catch (e) {
             if (e.code === 'AuthFailure.UnauthorizedOperation') {
                 console.log('\n', `requestId: ${e.requestId}`);
-                throw new toolbox_1.CloudBaseError('您没有权限执行此操作，请检查 CAM 策略\n');
+                throw new toolbox_1.CloudBaseError((0, i18n_1.t)('您没有权限执行此操作，请检查 CAM 策略\n'));
             }
             else if (e.code === 'LimitExceeded') {
                 throw new toolbox_1.CloudBaseError(`${e.original.Message}\n`);

package/lib/utils/template-manager.js

@@ -41,26 +41,27 @@ const path_1 = __importDefault(require("path"));
 const simple_git_1 = require("simple-git");
 const error_1 = require("../error");
 const mcp_config_modifier_1 = require("./mcp-config-modifier");
+const i18n_1 = require("../i18n");
 const BUILTIN_TEMPLATES = {
     miniprogram: {
         url: 'https://static.cloudbase.net/cloudbase-examples/miniprogram-cloudbase-miniprogram-template.zip',
-        name: '微信小程序 + CloudBase'
+        name: `${(0, i18n_1.t)('微信小程序')} + CloudBase`
     },
     react: {
         url: 'https://static.cloudbase.net/cloudbase-examples/web-cloudbase-react-template.zip',
-        name: 'Web 应用 - React + CloudBase'
+        name: `${(0, i18n_1.t)('Web 应用')} - React + CloudBase`
     },
     vue: {
         url: 'https://static.cloudbase.net/cloudbase-examples/web-cloudbase-vue-template.zip',
-        name: 'Web 应用 - Vue + CloudBase'
+        name: `${(0, i18n_1.t)('Web 应用')} - Vue + CloudBase`
     },
     uniapp: {
         url: 'https://static.cloudbase.net/cloudbase-examples/universal-cloudbase-uniapp-template.zip',
-        name: '跨端应用 - UniApp + CloudBase'
+        name: `${(0, i18n_1.t)('跨端应用')} - UniApp + CloudBase`
     },
     rules: {
         url: 'https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip',
-        name: 'AI 规则和配置'
+        name: `${(0, i18n_1.t)('AI 规则和配置')}`
     }
 };
 class TemplateManager {
@@ -86,10 +87,10 @@ class TemplateManager {
                     yield this.downloadGitTemplateToTemp(gitInfo, tempDir, log);
                 }
                 else {
-                    throw new error_1.CloudBaseError(`不支持的模板来源: ${typeof source === 'string' ? source : JSON.stringify(source)}`);
+                    throw new error_1.CloudBaseError((0, i18n_1.t)('不支持的模板来源: {{source}}', { source: typeof source === 'string' ? source : JSON.stringify(source) }));
                 }
                 yield this.copyFromTempToTarget(tempDir, targetPath, force, log);
-                log.info(`✅ 模板拉取完成: ${targetPath}`);
+                log.info((0, i18n_1.t)('✅ 模板拉取完成: {{targetPath}}', { targetPath }));
             }
             finally {
                 yield fs_extra_1.default.remove(tempDir);
@@ -100,7 +101,7 @@ class TemplateManager {
         return Object.keys(BUILTIN_TEMPLATES).includes(source);
     }
     isZipUrl(source) {
-        console.log("zip source", source);
+        console.log('zip source', source);
         if (!source || typeof source !== 'string') {
             return false;
         }
@@ -179,7 +180,7 @@ class TemplateManager {
                 branch: 'main'
             };
         }
-        throw new error_1.CloudBaseError(`无法解析 Git URL: ${url}`);
+        throw new error_1.CloudBaseError((0, i18n_1.t)('无法解析 Git URL: {{url}}', { url }));
     }
     buildGitUrl(gitInfo) {
         if (gitInfo.platform === 'github') {
@@ -191,7 +192,7 @@ class TemplateManager {
         else if (gitInfo.platform === 'cnb') {
             return `https://cnb.cool/${gitInfo.owner}/${gitInfo.repo}.git`;
         }
-        throw new error_1.CloudBaseError(`不支持的 Git 平台: ${gitInfo.platform}`);
+        throw new error_1.CloudBaseError((0, i18n_1.t)('不支持的 Git 平台: {{platform}}', { platform: gitInfo.platform }));
     }
     cloneWithSubpathOptimized(gitUrl, tempDir, gitInfo, log) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -204,7 +205,7 @@ class TemplateManager {
                 ]);
                 const subpathFull = path_1.default.join(tempDir, gitInfo.subpath);
                 if (!(yield fs_extra_1.default.pathExists(subpathFull))) {
-                    throw new error_1.CloudBaseError(`子目录不存在: ${gitInfo.subpath}`);
+                    throw new error_1.CloudBaseError((0, i18n_1.t)('子目录不存在: {{subpath}}', { subpath: gitInfo.subpath }));
                 }
                 const tempContentDir = path_1.default.join(tempDir, '.temp-content-' + Date.now());
                 yield fs_extra_1.default.move(subpathFull, tempContentDir);
@@ -221,7 +222,7 @@ class TemplateManager {
                 yield fs_extra_1.default.remove(tempContentDir);
             }
             catch (error) {
-                throw new error_1.CloudBaseError(`克隆子目录失败: ${error.message}`, { original: error });
+                throw new error_1.CloudBaseError((0, i18n_1.t)('克隆子目录失败: {{error}}', { error: error.message }), { original: error });
             }
         });
     }
@@ -233,7 +234,7 @@ class TemplateManager {
                 yield tempGit.checkout(gitInfo.branch);
                 const subpathFull = path_1.default.join(tempDir, gitInfo.subpath);
                 if (!(yield fs_extra_1.default.pathExists(subpathFull))) {
-                    throw new error_1.CloudBaseError(`子目录不存在: ${gitInfo.subpath}`);
+                    throw new error_1.CloudBaseError((0, i18n_1.t)('子目录不存在: {{subpath}}', { subpath: gitInfo.subpath }));
                 }
                 const tempContentDir = path_1.default.join(tempDir, '.temp-content-' + Date.now());
                 yield fs_extra_1.default.move(subpathFull, tempContentDir);
@@ -250,7 +251,7 @@ class TemplateManager {
                 yield fs_extra_1.default.remove(tempContentDir);
             }
             catch (error) {
-                throw new error_1.CloudBaseError(`克隆子目录失败: ${error.message}`, { original: error });
+                throw new error_1.CloudBaseError((0, i18n_1.t)('克隆子目录失败: {{error}}', { error: error.message }), { original: error });
             }
         });
     }
@@ -258,36 +259,36 @@ class TemplateManager {
         return __awaiter(this, void 0, void 0, function* () {
             const template = BUILTIN_TEMPLATES[templateId];
             if (!template) {
-                throw new error_1.CloudBaseError(`未知的内置模板: ${templateId}`);
+                throw new error_1.CloudBaseError((0, i18n_1.t)('未知的内置模板: {{templateId}}', { templateId }));
             }
-            log.info(`📦 正在下载 ${template.name} 模板到临时目录...`);
+            log.info((0, i18n_1.t)('📦 正在下载 {{templateName}} 模板到临时目录...', { templateName: template.name }));
             try {
                 const { downloadAndExtractRemoteZip } = yield Promise.resolve().then(() => __importStar(require('./tools/common')));
                 yield downloadAndExtractRemoteZip(template.url, tempDir);
-                log.info(`✅ ${template.name} 模板下载完成到临时目录`);
+                log.info((0, i18n_1.t)('✅ {{templateName}} 模板下载完成到临时目录', { templateName: template.name }));
             }
             catch (error) {
-                throw new error_1.CloudBaseError(`下载内置模板失败: ${error.message}`, { original: error });
+                throw new error_1.CloudBaseError((0, i18n_1.t)('下载内置模板失败: {{error}}', { error: error.message }), { original: error });
             }
         });
     }
     downloadZipTemplateToTemp(zipUrl, tempDir, log) {
         return __awaiter(this, void 0, void 0, function* () {
-            log.info(`📦 正在下载 zip 文件模板到临时目录: ${zipUrl}`);
+            log.info((0, i18n_1.t)('📦 正在下载 zip 文件模板到临时目录: {{zipUrl}}', { zipUrl }));
             try {
                 const { downloadAndExtractRemoteZip } = yield Promise.resolve().then(() => __importStar(require('./tools/common')));
                 yield downloadAndExtractRemoteZip(zipUrl, tempDir);
-                log.info(`✅ zip 文件模板下载完成到临时目录`);
+                log.info((0, i18n_1.t)('✅ zip 文件模板下载完成到临时目录'));
             }
             catch (error) {
-                throw new error_1.CloudBaseError(`下载 zip 文件模板失败: ${error.message}`, { original: error });
+                throw new error_1.CloudBaseError((0, i18n_1.t)('下载 zip 文件模板失败: {{error}}', { error: error.message }), { original: error });
             }
         });
     }
     downloadGitTemplateToTemp(gitInfo, tempDir, log) {
         return __awaiter(this, void 0, void 0, function* () {
             const gitUrl = this.buildGitUrl(gitInfo);
-            log.info(`📦 正在从 ${gitInfo.platform} 下载模板到临时目录...`);
+            log.info((0, i18n_1.t)('📦 正在从 {{platform}} 下载模板到临时目录...', { platform: gitInfo.platform }));
             try {
                 if (gitInfo.subpath) {
                     yield this.cloneWithSubpathOptimized(gitUrl, tempDir, gitInfo, log);
@@ -295,22 +296,22 @@ class TemplateManager {
                 else {
                     yield this.git.clone(gitUrl, tempDir, ['--depth', '1', '--single-branch', '--branch', gitInfo.branch]);
                 }
-                log.info(`✅ Git 模板下载完成到临时目录`);
+                log.info((0, i18n_1.t)('✅ Git 模板下载完成到临时目录'));
             }
             catch (error) {
-                throw new error_1.CloudBaseError(`Git 模板下载失败: ${error.message}`, { original: error });
+                throw new error_1.CloudBaseError((0, i18n_1.t)('Git 模板下载失败: {{error}}', { error: error.message }), { original: error });
             }
         });
     }
     copyFromTempToTarget(tempDir, targetPath, force, log) {
         return __awaiter(this, void 0, void 0, function* () {
-            log.info(`📦 正在从临时目录复制到目标目录 ${targetPath}...`);
+            log.info((0, i18n_1.t)('📦 正在从临时目录复制到目标目录 {{targetPath}}...', { targetPath }));
             try {
                 if (force) {
                     if (yield fs_extra_1.default.pathExists(targetPath)) {
                         const files = yield fs_extra_1.default.readdir(targetPath);
                         if (files.length > 0) {
-                            log.info(`⚠️  使用 --force 参数，将覆盖目标目录中的现有文件`);
+                            log.info((0, i18n_1.t)('⚠️  使用 --force 参数，将覆盖目标目录中的现有文件'));
                         }
                     }
                     yield this.copyFilesWithOverwrite(tempDir, targetPath, log);
@@ -319,23 +320,23 @@ class TemplateManager {
                     if (yield fs_extra_1.default.pathExists(targetPath)) {
                         const files = yield fs_extra_1.default.readdir(targetPath);
                         if (files.length > 0) {
-                            log.info(`ℹ️  目标目录不为空，将跳过已存在的文件，只复制新文件`);
+                            log.info((0, i18n_1.t)('ℹ️  目标目录不为空，将跳过已存在的文件，只复制新文件'));
                         }
                     }
                     yield this.copyFilesSkipExisting(tempDir, targetPath, log);
                 }
-                log.info(`✅ 模板复制完成`);
+                log.info((0, i18n_1.t)('✅ 模板复制完成'));
                 try {
-                    log.debug('🔧 开始调用 MCP 配置修改器...');
+                    log.debug((0, i18n_1.t)('🔧 开始调用 MCP 配置修改器...'));
                     yield this.mcpConfigModifier.modifyMCPConfigs(targetPath, log);
-                    log.debug('✅ MCP 配置修改器调用完成');
+                    log.debug((0, i18n_1.t)('✅ MCP 配置修改器调用完成'));
                 }
                 catch (error) {
-                    log.warn(`⚠️ MCP 配置修改失败: ${error.message}`);
+                    log.warn((0, i18n_1.t)('⚠️ MCP 配置修改失败: {{error}}', { error: error.message }));
                 }
             }
             catch (error) {
-                throw new error_1.CloudBaseError(`复制模板失败: ${error.message}`, { original: error });
+                throw new error_1.CloudBaseError((0, i18n_1.t)('复制模板失败: {{error}}', { error: error.message }), { original: error });
             }
         });
     }
@@ -373,7 +374,7 @@ class TemplateManager {
                     }
                 }
                 catch (error) {
-                    log.warn(`⚠️  复制失败: ${path_1.default.relative(sourceDir, srcPath)} - ${error.message}`);
+                    log.warn((0, i18n_1.t)('⚠️  复制失败: {{path}} - {{error}}', { path: path_1.default.relative(sourceDir, srcPath), error: error.message }));
                 }
             });
             const entries = yield fs_extra_1.default.readdir(sourceDir, { withFileTypes: true });
@@ -386,7 +387,7 @@ class TemplateManager {
             for (const chunk of chunks) {
                 yield Promise.all(chunk);
             }
-            log.info(`📊 复制统计: ${copiedCount} 个新文件复制, ${overwrittenCount} 个文件覆盖`);
+            log.info((0, i18n_1.t)('📊 复制统计: {{copiedCount}} 个新文件复制, {{overwrittenCount}} 个文件覆盖', { copiedCount, overwrittenCount }));
         });
     }
     copyFilesSkipExisting(sourceDir, targetDir, log) {
@@ -423,7 +424,7 @@ class TemplateManager {
                     }
                 }
                 catch (error) {
-                    log.warn(`⚠️  复制失败: ${path_1.default.relative(sourceDir, srcPath)} - ${error.message}`);
+                    log.warn((0, i18n_1.t)('⚠️  复制失败: {{path}} - {{error}}', { path: path_1.default.relative(sourceDir, srcPath), error: error.message }));
                 }
             });
             const entries = yield fs_extra_1.default.readdir(sourceDir, { withFileTypes: true });
@@ -436,7 +437,7 @@ class TemplateManager {
             for (const chunk of chunks) {
                 yield Promise.all(chunk);
             }
-            log.info(`📊 复制统计: ${copiedCount} 个文件复制完成, ${skippedCount} 个文件跳过`);
+            log.info((0, i18n_1.t)('📊 复制统计: {{copiedCount}} 个文件复制完成, {{skippedCount}} 个文件跳过', { copiedCount, skippedCount }));
         });
     }
     chunkArray(array, chunkSize) {

package/lib/utils/template.js

@@ -24,13 +24,14 @@ const log_1 = require("./log");
 const fs_2 = require("./fs");
 const output_1 = require("./output");
 const reporter_1 = require("./reporter");
+const i18n_1 = require("../i18n");
 const listUrl = 'https://tcli.service.tcloudbase.com/templates';
 const getTemplateAddress = (templatePath) => `https://7463-tcli-1258016615.tcb.qcloud.la/cloudbase-templates/${templatePath}.zip`;
 function downloadTemplate(options = {}) {
     return __awaiter(this, void 0, void 0, function* () {
         let { templateUri, appName, newProject, projectPath = process.cwd() } = options;
         const templates = yield (0, output_1.execWithLoading)(() => (0, net_1.fetch)(listUrl), {
-            startTip: '获取应用模板列表中'
+            startTip: (0, i18n_1.t)('获取应用模板列表中')
         });
         let templateName;
         let tempateId;
@@ -41,7 +42,7 @@ function downloadTemplate(options = {}) {
             const { selectTemplateName } = yield (0, enquirer_1.prompt)({
                 type: 'select',
                 name: 'selectTemplateName',
-                message: '请选择应用模板',
+                message: (0, i18n_1.t)('请选择应用模板'),
                 choices: templates.map((item) => item.name)
             });
             templateName = selectTemplateName;
@@ -50,7 +51,7 @@ function downloadTemplate(options = {}) {
             ? templates.find((item) => item.name === templateName)
             : templates.find((item) => item.path === tempateId);
         if (!selectedTemplate) {
-            log_1.logger.info(`模板 \`${templateName || tempateId}\` 不存在`);
+            log_1.logger.info((0, i18n_1.t)('模板 `{{template}}` 不存在', { template: templateName || tempateId }));
             return;
         }
         if (newProject) {
@@ -58,7 +59,7 @@ function downloadTemplate(options = {}) {
                 const { projectName } = yield (0, enquirer_1.prompt)({
                     type: 'input',
                     name: 'projectName',
-                    message: '请输入项目名称',
+                    message: (0, i18n_1.t)('请输入项目名称'),
                     initial: selectedTemplate.path
                 });
                 appName = projectName;
@@ -68,11 +69,11 @@ function downloadTemplate(options = {}) {
                 const { cover } = yield (0, enquirer_1.prompt)({
                     type: 'confirm',
                     name: 'cover',
-                    message: `已存在同名文件夹：${appName}，是否覆盖？`,
+                    message: (0, i18n_1.t)('已存在同名文件夹：{{name}}，是否覆盖？', { name: appName }),
                     initial: false
                 });
                 if (!cover) {
-                    throw new error_1.CloudBaseError('操作终止！');
+                    throw new error_1.CloudBaseError((0, i18n_1.t)('操作终止！'));
                 }
                 else {
                     fs_extra_1.default.removeSync(projectPath);
@@ -83,7 +84,7 @@ function downloadTemplate(options = {}) {
             yield (0, reporter_1.templateDownloadReport)(selectedTemplate.path, selectedTemplate.name);
             yield extractTemplate(projectPath, selectedTemplate.path, selectedTemplate.url);
         }), {
-            startTip: '下载文件中'
+            startTip: (0, i18n_1.t)('下载文件中')
         });
         return projectPath;
     });
@@ -94,10 +95,10 @@ function extractTemplate(projectPath, templatePath, remoteUrl) {
         const url = remoteUrl || getTemplateAddress(templatePath);
         return (0, net_1.fetchStream)(url).then((res) => __awaiter(this, void 0, void 0, function* () {
             if (!res) {
-                throw new error_1.CloudBaseError('请求异常');
+                throw new error_1.CloudBaseError((0, i18n_1.t)('请求异常'));
             }
             if (res.status !== 200) {
-                throw new error_1.CloudBaseError('未找到文件');
+                throw new error_1.CloudBaseError((0, i18n_1.t)('未找到文件'));
             }
             yield (0, toolbox_1.unzipStream)(res.body, projectPath);
         }));

package/lib/utils/tools/common.js

@@ -17,14 +17,15 @@ const toolbox_1 = require("@cloudbase/toolbox");
 const path_1 = __importDefault(require("path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const unzipper_1 = __importDefault(require("unzipper"));
+const i18n_1 = require("../../i18n");
 function downloadAndExtractRemoteZip(downloadUrl, targetPath) {
     return __awaiter(this, void 0, void 0, function* () {
         const downloadResponse = yield (0, toolbox_1.fetchStream)(downloadUrl);
         if (!downloadResponse.ok) {
-            throw new Error(`下载失败，状态码: ${downloadResponse.status}`);
+            throw new Error((0, i18n_1.t)('下载失败，状态码: {{status}}', { status: downloadResponse.status }));
         }
         if (!downloadResponse.body) {
-            throw new Error('下载响应中没有数据流');
+            throw new Error((0, i18n_1.t)('下载响应中没有数据流'));
         }
         const dirPath = path_1.default.resolve(targetPath);
         yield fs_extra_1.default.ensureDir(dirPath);

package/lib/utils/url.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGatewayUrl = exports.EUrl = exports.EDomain = void 0;
+const i18n_1 = require("../i18n");
+exports.EDomain = {
+    Console: (0, i18n_1.isIntl)() ? 'console.tencentcloud.com' : 'console.cloud.tencent.com',
+    Official: (0, i18n_1.isIntl)() ? 'www.tencentcloud.com' : 'cloud.tencent.com',
+    Gateway: (0, i18n_1.isIntl)() ? 'api.intl.tcloudbasegateway.com' : 'api.tcloudbasegateway.com',
+    Tcb: (0, i18n_1.isIntl)() ? 'tcb.tencentcloud.com' : 'tcb.cloud.tencent.com',
+    Docs: 'docs.cloudbase.net'
+};
+exports.EUrl = Object.assign(Object.assign({}, ((domains) => Object.keys(domains).reduce((acc, key) => {
+    acc[key] = `https://${domains[key]}`;
+    return acc;
+}, {}))(exports.EDomain)), { Docs: `https://${exports.EDomain.Docs}` + ((0, i18n_1.isIntl)() ? '/en' : ''), DevPlatform: `https://${exports.EDomain.Tcb}/dev`, TcbConsole: `https://${exports.EDomain.Console}/tcb`, CloudAdmin: `https://${exports.EDomain.Tcb}/cloud-admin` });
+function getGatewayUrl(envId) {
+    return `https://${envId}.${exports.EDomain.Gateway}`;
+}
+exports.getGatewayUrl = getGatewayUrl;

package/lib/utils/validator.js

@@ -4,6 +4,7 @@ exports.validateCpuMem = exports.validateIp = exports.assertHas = exports.assert
 const error_1 = require("../error");
 const constant_1 = require("../constant");
 const run_1 = require("../run");
+const i18n_1 = require("../i18n");
 function assertTruthy(val, errMsg) {
     let ok;
     if (Array.isArray(val)) {
@@ -39,8 +40,11 @@ const validateCpuMem = (cpuInput, memInput) => {
         let memSet = (0, run_1.convertNumber)(memInput);
         let validMemSet = constant_1.CPU_MEM_OPTS.find(({ cpu }) => cpu === cpuSet);
         if (!validMemSet || !validMemSet.mems.length || !validMemSet.mems.includes(memSet)) {
-            throw new error_1.CloudBaseError(`cpu 与 mem 规格不匹配，当前规格：cpu: ${cpuInput}, mem: ${memInput}
-请使用下列规格组合之一：${constant_1.CPU_MEM_OPTS.map(({ cpu, mems }) => `${cpu}-${mems.join('/')}`).join('，')}`);
+            throw new error_1.CloudBaseError((0, i18n_1.t)('cpu 与 mem 规格不匹配，当前规格：cpu: {{cpu}}, mem: {{mem}}\n请使用下列规格组合之一：{{options}}', {
+                cpu: cpuInput,
+                mem: memInput,
+                options: constant_1.CPU_MEM_OPTS.map(({ cpu, mems }) => `${cpu}-${mems.join('/')}`).join('，')
+            }));
         }
         return { cpuOutput: cpuSet, memOutput: memSet };
     }
@@ -48,7 +52,9 @@ const validateCpuMem = (cpuInput, memInput) => {
         let cpuSet = (0, run_1.convertNumber)(cpuInput);
         let validSet = constant_1.CPU_MEM_OPTS.find(({ cpu }) => cpu === cpuSet);
         if (!validSet) {
-            throw new error_1.CloudBaseError(`不支持当前 cpu 规格，请使用下列 cpu 规格之一：${constant_1.CPU_MEM_OPTS.map(({ cpu }) => cpu).join('，')}`);
+            throw new error_1.CloudBaseError((0, i18n_1.t)('不支持当前 cpu 规格，请使用下列 cpu 规格之一：{{options}}', {
+                options: constant_1.CPU_MEM_OPTS.map(({ cpu }) => cpu).join('，')
+            }));
         }
         return { cpuOutput: cpuSet, memOutput: constant_1.CPU_MEM_OPTS.find(({ cpu }) => cpu === cpuSet).mems[0] };
     }
@@ -56,7 +62,9 @@ const validateCpuMem = (cpuInput, memInput) => {
         let memSet = (0, run_1.convertNumber)(memInput);
         let validSet = constant_1.CPU_MEM_OPTS.find(({ mems }) => mems.includes(memSet));
         if (!validSet) {
-            throw new error_1.CloudBaseError(`不支持当前 mem 规格，请使用下列 mem 规格之一：${constant_1.CPU_MEM_OPTS.map(({ mems }) => mems.join('/')).join('，')}`);
+            throw new error_1.CloudBaseError((0, i18n_1.t)('不支持当前 mem 规格，请使用下列 mem 规格之一：{{options}}', {
+                options: constant_1.CPU_MEM_OPTS.map(({ mems }) => mems.join('/')).join('，')
+            }));
         }
         return { cpuOutput: validSet.cpu, memOutput: memSet };
     }

package/locales/README.md

@@ -0,0 +1,160 @@
+# 国际化功能使用说明
+
+## 概述
+
+本项目使用 i18next 实现国际化功能，支持中文和英文两种语言。
+
+## 使用方法
+
+### 1. 在代码中使用
+
+```typescript
+import { t } from 'src/i18n'
+
+// 使用 t() 函数包装需要国际化的文本
+console.log(t('你好')) // 你好
+// 插值
+console.log(t('你好, {{name}}', { name: 'TCB' })) // 你好, TCB
+```
+
+### 2. 扫描和生成标识
+
+```bash
+npm run i18n:scan
+```
+
+## 工作流程
+
+1. **开发阶段**：在代码中使用 `t('文本内容')` 包装需要国际化的文本
+2. **扫描阶段**：运行 `npm run i18n:scan` 扫描代码并提取文本
+3. **生成阶段**：自动为每个文本生成唯一的标识（格式：`k_${hash}`）
+4. **增量管理**：在 `locales/inc/` 目录下生成增量词条文件
+5. **翻译阶段**：开发者在 `inc/en.json` 中填写英文翻译
+6. **同步阶段**：运行 `npm run i18n:sync` 将翻译同步到正式语言文件，并清理增量目录(可选)
+
+## 文件结构
+
+```
+locales/
+├── scripts/                      # 脚本目录
+│   ├── generate.js               # 标识生成脚本
+│   └── sync.js                   # 翻译同步脚本
+├── inc/                          # 增量词条目录（临时）
+│   ├── zh.json                   # 增量中文词条
+│   └── en.json                   # 增量英文翻译
+├── langs/                        # 正式语言文件
+│   ├── zh.json                   # 中文语言文件
+│   └── en.json                   # 英文语言文件
+├── i18next-scanner.config.js     # 扫描配置
+├── mapping.json                  # 文本到标识的映射文件
+└── README.md                     # 本说明文档
+```
+
+## 标识生成规则
+
+- 标识格式：`k_${hash}`
+- 相同文本生成相同标识
+- 使用简单的字符串哈希算法
+- 支持增量更新，只处理新增文本
+
+## 核心特性
+
+- 已有英文翻译不会被覆盖
+- 自动识别和保留现有翻译
+- 增量词条单独放在 `inc` 目录下
+- 与正式语言文件分离，便于管理
+- 自动化同步增量词条
+- 只处理新增或修改的文本
+- 自动移除不再使用的词条
+
+## 命令说明
+
+- **`npm run i18n:scan`**：完整的国际化处理流程
+  - 扫描代码中的 `t()` 函数调用
+  - 提取需要国际化的文本
+  - 生成唯一标识
+  - 更新语言文件
+  - 生成增量词条文件
+
+- **`npm run i18n:sync`**：同步增量翻译
+  - 将 `inc/en.json` 中的翻译同步到正式语言文件
+  - 只同步有效的翻译（跳过 `__STRING_NOT_TRANSLATED__`）
+  - 自动更新 `langs/en.json`
+
+## 增量词条翻译流程
+
+### 步骤1：生成增量文件
+```bash
+npm run i18n
+```
+- 扫描代码，生成增量词条
+- 在 `locales/inc/` 目录下创建文件
+
+### 步骤2：编辑翻译
+编辑 `locales/inc/en.json` 文件：
+```json
+{
+  "k_4293de80": "Test Text 001",
+  "k_62b2fe13": "Welcome to CloudBase CLI",
+  "k_28810860": "Hehe Haha",
+  "k_29c6c120": "Available configurations:"
+}
+```
+
+### 步骤3：同步翻译
+```bash
+npm run i18n:sync
+```
+- 将翻译同步到正式语言文件
+- 显示同步进度和结果
+
+## 注意事项
+
+1. 确保在代码中使用 `t()` 函数包装需要国际化的文本
+2. 运行 `npm run i18n:scan` 后会自动生成增量词条文件
+3. 在 `inc/en.json` 中填写英文翻译
+4. 翻译完成后运行 `npm run i18n:sync` 同步到正式文件
+5. 同步完成后 `inc` 目录会自动清理，无需手动删除
+6. 语言文件中的 key 会自动更新为生成的标识
+
+## 示例
+
+### 源码
+```typescript
+// 代码中
+console.log(t('欢迎使用云开发 CLI'))
+```
+
+### 扫描后
+```json
+// mapping.json
+{
+  "欢迎使用云开发 CLI": "k_62b2fe13"
+}
+
+// inc/zh.json
+{
+  "k_62b2fe13": "欢迎使用云开发 CLI"
+}
+
+// inc/en.json
+{
+  "k_62b2fe13": "__STRING_NOT_TRANSLATED__"
+}
+```
+
+### 翻译后
+```json
+// inc/en.json
+{
+  "k_62b2fe13": "Welcome to CloudBase CLI"
+}
+```
+
+### 同步后
+```json
+// langs/en.json
+{
+  "k_62b2fe13": "Welcome to CloudBase CLI"
+}
+```