@camscanner/mcp-language-server 1.0.0 → 1.2.0

package/README.md

@@ -37,6 +37,27 @@ claude plugin install i18n@camscanner-plugins
 - 浏览器数据持久化在 `~/.language-mcp/browser-data/`，保存的密码下次自动填充
 - 认证信息保存在 `~/.language-mcp/credentials.json`，有效期 24 小时
 
+## 开发者指南
+
+### 发布新版本
+
+```bash
+# 1. 修改代码并构建
+npm run build
+
+# 2. 更新版本号并发布到 npm
+npm version patch   # bug fix: 1.0.0 → 1.0.1
+npm version minor   # 新功能: 1.0.0 → 1.1.0
+npm version major   # 破坏性变更: 1.0.0 → 2.0.0
+
+npm publish --registry https://registry.npmjs.org/ --access public
+
+# 3. 推送 tag 到远端
+git push && git push --tags
+```
+
+用户下次启动 Claude Code 时，`npx -y @camscanner/mcp-language-server@latest` 会自动拉取新版本。
+
 ## 常用产品 ID
 
 | ID | 产品 |

package/dist/index.js

@@ -163,6 +163,71 @@ server.tool('search-string', '按关键词搜索多语言字符串。可指定
     }
     return { content: [{ type: 'text', text: output }] };
 });
+// Tool: batch-search-string
+server.tool('batch-search-string', '批量搜索多语言字符串。支持同时搜索多个关键词,每个关键词独立返回结果。适合一次性查询大量字符串是否已在平台录入。', {
+    product_id: v3_1.z.string().describe('产品ID,先调用 list-products 查询'),
+    words: v3_1.z.array(v3_1.z.string()).describe('搜索关键词数组(中文、英文或 key 名)'),
+    version_id: v3_1.z.string().optional().describe('版本ID,不传则搜索所有版本'),
+    fuzzy: v3_1.z.string().optional().default('0').describe('1=模糊匹配,0=精确匹配(默认)'),
+    page_size: v3_1.z.string().optional().default('20').describe('每个关键词的每页条数,最大100'),
+}, async ({ product_id, words, version_id, fuzzy, page_size }) => {
+    const authErr = await requireAuth();
+    if (authErr)
+        return { content: [{ type: 'text', text: authErr }] };
+    const results = [];
+    let foundCount = 0;
+    let notFoundCount = 0;
+    // 并发搜索所有关键词
+    const tasks = words.map(async (word) => {
+        const params = {
+            product_id, word, fuzzy: fuzzy || '0', page: '1', page_size: page_size || '20',
+        };
+        if (version_id)
+            params.version_id = version_id;
+        try {
+            const data = await client.post('/language/mcp-language/get-string-search', params);
+            if (data.errno !== 0) {
+                return { word, found: false, output: `❌ "${word}" — 查询失败: ${data.message || '未知错误'}` };
+            }
+            const versions = Array.isArray(data.data) ? data.data : (data.data?.list || []);
+            if (versions.length === 0) {
+                return { word, found: false, output: `❌ "${word}" — 未找到` };
+            }
+            let output = `✅ "${word}" — ${versions.length} 个版本匹配:\n`;
+            for (const version of versions) {
+                const strings = version.ar_string || version.strings || [];
+                for (const str of strings) {
+                    const keys = str.keys
+                        ? Object.entries(str.keys).map(([p, k]) => `platform_${p}: ${k}`).join(', ')
+                        : '无';
+                    const zhCN = str.values?.['1'] || str.values?.['0'] || '';
+                    const enUS = str.values?.['2'] || str.values?.['0'] || '';
+                    const zhTW = str.values?.['7'] || '';
+                    output += `  - key: ${keys} | 中: ${zhCN} | 英: ${enUS}`;
+                    if (zhTW)
+                        output += ` | 繁: ${zhTW}`;
+                    output += ` (v${version.version_number})\n`;
+                }
+            }
+            return { word, found: true, output };
+        }
+        catch (err) {
+            return { word, found: false, output: `❌ "${word}" — 请求异常: ${err.message}` };
+        }
+    });
+    const settled = await Promise.all(tasks);
+    for (const r of settled) {
+        results.push(r.output);
+        if (r.found)
+            foundCount++;
+        else
+            notFoundCount++;
+    }
+    let output = `## 批量搜索结果\n\n`;
+    output += `共搜索 ${words.length} 个关键词: ✅ ${foundCount} 个找到, ❌ ${notFoundCount} 个未找到\n\n`;
+    output += results.join('\n');
+    return { content: [{ type: 'text', text: output }] };
+});
 // Tool: export-string
 server.tool('export-string', '搜索多语言字符串并导出为兼容 cs-i18n 的 locale JSON 格式。支持单语言或全部语言导出,自动将 %s 替换为 {0}/{1}/{2}。', {
     product_id: v3_1.z.string().describe('产品ID。常用: 1=CamCard, 2=CamScanner, 44=CS Lite, 47=CS PDF, 53=CS Harmony'),
@@ -270,20 +335,54 @@ server.tool('write-locales', '搜索多语言字符串并直接写入项目的 l
             results.push(`${localeName}.json: 无变化 (${Object.keys(newEntries).length} 条已存在)`);
         }
     }
-    // Detect local locale files that got no remote data
+    // Fallback: local locale files with no remote translation use English (langId=2)
+    const englishEntries = allStrings['2'] || {};
     const localLocaleNames = fs_1.default.readdirSync(locales_path)
         .filter(f => f.endsWith('.json'))
         .map(f => f.replace('.json', ''));
     const missingLocales = (0, utils_js_1.findMissingLocales)(localLocaleNames, Object.keys(allStrings));
+    let fallbackCount = 0;
+    if (Object.keys(englishEntries).length > 0) {
+        for (const localeName of missingLocales) {
+            const filePath = path_1.default.join(locales_path, `${localeName}.json`);
+            if (!fs_1.default.existsSync(filePath))
+                continue;
+            let existingObj = {};
+            try {
+                const content = fs_1.default.readFileSync(filePath, 'utf-8');
+                existingObj = JSON.parse(content);
+            }
+            catch {
+                // empty or invalid file
+            }
+            const { merged, keysAdded, keysUpdated } = (0, utils_js_1.mergeLocaleEntries)(existingObj, englishEntries);
+            fs_1.default.writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\n');
+            filesWritten++;
+            fallbackCount++;
+            totalKeys += Object.keys(englishEntries).length;
+            if (keysAdded.length > 0 || keysUpdated.length > 0) {
+                results.push(`${localeName}.json: +${keysAdded.length} 新增, ~${keysUpdated.length} 更新 (英语兜底)`);
+            }
+            else {
+                results.push(`${localeName}.json: 无变化 (${Object.keys(englishEntries).length} 条已存在)`);
+            }
+        }
+    }
+    // Remaining missing locales (no English fallback available)
+    const stillMissing = Object.keys(englishEntries).length > 0
+        ? [] // all missing locales got English fallback
+        : missingLocales;
     let output = `写入完成!\n`;
     output += `- 目录: ${locales_path}\n`;
     output += `- 写入 ${filesWritten} 个文件, 跳过 ${filesSkipped} 个 (项目中不存在)\n`;
+    if (fallbackCount > 0) {
+        output += `- 其中 ${fallbackCount} 个文件使用英语兜底\n`;
+    }
     output += `- 共 ${totalKeys} 条字符串\n\n`;
     output += results.map(r => `  ${r}`).join('\n');
-    if (missingLocales.length > 0) {
-        output += `\n\n⚠️ 以下 ${missingLocales.length} 个本地语言文件未获得远程翻译，未被更新:\n`;
-        output += missingLocales.map(name => `  - ${name}.json`).join('\n');
-        output += `\n请确认远程平台是否已为这些语言提供翻译。`;
+    if (stillMissing.length > 0) {
+        output += `\n\n⚠️ 以下 ${stillMissing.length} 个本地语言文件未获得远程翻译，且无英语兜底:\n`;
+        output += stillMissing.map(name => `  - ${name}.json`).join('\n');
     }
     return { content: [{ type: 'text', text: output }] };
 });

package/dist/utils.d.ts

@@ -1,4 +1,5 @@
 export declare const PLATFORM_MAP: Record<number, string>;
+export declare function getLocaleName(langId: string | number): string | null;
 export declare const LANGUAGE_LOCALE_MAP: Record<string, string>;
 export declare function fixPlaceholders(value: string): string;
 export declare function extractStrings(versions: any[], platformId: string): Record<string, Record<string, string>>;

package/dist/utils.js

@@ -2,6 +2,7 @@
 // --- Constants ---
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LANGUAGE_LOCALE_MAP = exports.PLATFORM_MAP = void 0;
+exports.getLocaleName = getLocaleName;
 exports.fixPlaceholders = fixPlaceholders;
 exports.extractStrings = extractStrings;
 exports.mergeLocaleEntries = mergeLocaleEntries;
@@ -15,35 +16,54 @@ exports.PLATFORM_MAP = {
     8: 'Harmony',
     9: 'PC',
 };
-exports.LANGUAGE_LOCALE_MAP = {
-    '1': 'ZhCn',
-    '2': 'EnUs',
-    '3': 'JaJp',
-    '4': 'KoKr',
-    '5': 'FrFr',
-    '6': 'DeDe',
-    '7': 'ZhTw',
-    '8': 'PtBr',
-    '9': 'EsEs',
-    '10': 'ItIt',
-    '11': 'RuRu',
-    '12': 'TrTr',
-    '13': 'ArSa',
-    '14': 'ThTh',
-    '15': 'PlPl',
-    '16': 'ViVn',
-    '17': 'InId',
-    '19': 'MsMy',
-    '20': 'NlNl',
-    '22': 'HiDi',
-    '23': 'BnBd',
-    '24': 'CsCs',
-    '25': 'SkSk',
-    '26': 'FilPh',
-    '27': 'ElEl',
-    '28': 'PtPt',
-    '29': 'RoRo',
+// 语言ID → locale 字符串映射（从 operate-main AppConfMacro::$ar_language_map 复制）
+const LANGUAGE_STRING_MAP = {
+    1: 'zh-cn', 2: 'en-us', 3: 'de-de', 4: 'fr-fr',
+    5: 'ja-jp', 6: 'ko-kr', 7: 'zh-tw', 8: 'es-es',
+    9: 'ru-ru', 10: 'sk-sk', 11: 'cs-cs', 12: 'pt-pt',
+    13: 'pl-pl', 14: 'it-it', 15: 'tr-tr', 16: 'ar-ar',
+    17: 'pt-br', 19: 'ag-ag', 20: 'sm-sm', 22: 'id-id',
+    23: 'th-th', 24: 'fil-ph', 25: 'ms-my', 26: 'vi-vn',
+    27: 'bn-bd', 28: 'fa-ir', 29: 'hi-in', 30: 'nl-nl',
+    31: 'el-gr', 32: 'hu-hu', 33: 'uk-ua', 34: 'no-no',
+    35: 'da-dk', 36: 'ur-pk', 37: 'hr-hr', 38: 'hy-am',
+    39: 'bg-bg', 40: 'si-lk', 41: 'is-is', 42: 'kk-kz',
+    43: 'sr-rs', 44: 'ne-np', 45: 'lv-lv', 46: 'sl-si',
+    47: 'sw-ke', 48: 'ka-ge', 49: 'et-ee', 50: 'sv-se',
+    51: 'be-by', 52: 'zu-za', 53: 'lt-lt', 54: 'my-mm',
+    55: 'ro-ro', 56: 'lo-la', 57: 'mn-mn', 58: 'az-az',
+    59: 'am-et', 60: 'sq-al', 61: 'mk-mk', 62: 'gl-es',
+    63: 'ca-es', 64: 'af-za', 65: 'kn-in', 66: 'gu-in',
+    67: 'eu-es', 68: 'iw-il', 69: 'pa-in', 70: 'ky-kg',
+    71: 'te-in', 72: 'ta-in', 73: 'rm-ch', 74: 'mr-in',
+    75: 'ml-in', 76: 'km-kh', 77: 'bs-ba', 78: 'lb-lu',
+    79: 'rw-rw', 80: 'mt-mt', 81: 'uz-uz', 82: 'ga-ie',
 };
+// locale 字符串 → PascalCase 文件名（从 operate-main MacroExport::filter2 复制）
+function toLocaleName(localeStr) {
+    return localeStr.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('');
+}
+// 特殊映射：项目 locale 文件名与 filter2 输出不一致的语言
+const LOCALE_NAME_OVERRIDE = {
+    16: 'ArSa', // filter2: ArAr → 实际: ArSa
+    20: 'FiFi', // filter2: SmSm → 实际: FiFi (芬兰语)
+    22: 'InId', // filter2: IdId → 实际: InId (印尼语)
+    23: 'Th', // filter2: ThTh → 实际: Th (泰语)
+    29: 'HiDi', // filter2: HiIn → 实际: HiDi (印地语)
+    31: 'ElEl', // filter2: ElGr → 实际: ElEl (希腊语)
+};
+// 获取 locale 文件名（优先用 override，否则 filter2 动态生成）
+function getLocaleName(langId) {
+    const id = Number(langId);
+    if (LOCALE_NAME_OVERRIDE[id])
+        return LOCALE_NAME_OVERRIDE[id];
+    const localeStr = LANGUAGE_STRING_MAP[id];
+    if (!localeStr)
+        return null;
+    return toLocaleName(localeStr);
+}
+// 兼容旧接口：动态生成完整映射表
+exports.LANGUAGE_LOCALE_MAP = Object.fromEntries(Object.keys(LANGUAGE_STRING_MAP).map(id => [String(id), getLocaleName(id)]).filter(([, v]) => v));
 // --- Helpers ---
 function fixPlaceholders(value) {
     let cnt = 0;

package/index.js

@@ -116,37 +116,55 @@ const PRODUCT_MAP = {
   53: "CS Harmony",
 };
 
-// 语言ID → locale 文件名映射（兼容 cs-i18n 工具）
-const LANGUAGE_LOCALE_MAP = {
-  "1": "ZhCn",    // 简体中文
-  "2": "EnUs",    // 英语
-  "3": "JaJp",    // 日语
-  "4": "KoKr",    // 韩语
-  "5": "FrFr",    // 法语
-  "6": "DeDe",    // 德语
-  "7": "ZhTw",    // 繁体中文
-  "8": "PtBr",    // 巴西葡萄牙语
-  "9": "EsEs",    // 西班牙语
-  "10": "ItIt",   // 意大利语
-  "11": "RuRu",   // 俄语
-  "12": "TrTr",   // 土耳其语
-  "13": "ArSa",   // 阿拉伯语
-  "14": "ThTh",   // 泰语(Th)
-  "15": "PlPl",   // 波兰语
-  "16": "ViVn",   // 越南语
-  "17": "InId",   // 印度尼西亚语
-  "19": "MsMy",   // 马来语
-  "20": "NlNl",   // 荷兰语
-  "22": "HiDi",   // 印地语
-  "23": "BnBd",   // 孟加拉语
-  "24": "CsCs",   // 捷克语
-  "25": "SkSk",   // 斯洛伐克语
-  "26": "FilPh",  // 菲律宾语
-  "27": "ElEl",   // 希腊语
-  "28": "PtPt",   // 葡萄牙语
-  "29": "RoRo",   // 罗马尼亚语
+// 语言ID → locale 字符串映射（从 operate-main AppConfMacro::$ar_language_map 复制）
+const LANGUAGE_STRING_MAP = {
+  1: "zh-cn",   2: "en-us",   3: "de-de",   4: "fr-fr",
+  5: "ja-jp",   6: "ko-kr",   7: "zh-tw",   8: "es-es",
+  9: "ru-ru",  10: "sk-sk",  11: "cs-cs",  12: "pt-pt",
+  13: "pl-pl",  14: "it-it",  15: "tr-tr",  16: "ar-ar",
+  17: "pt-br",  19: "ag-ag",  20: "sm-sm",  22: "id-id",
+  23: "th-th",  24: "fil-ph", 25: "ms-my",  26: "vi-vn",
+  27: "bn-bd",  28: "fa-ir",  29: "hi-in",  30: "nl-nl",
+  31: "el-gr",  32: "hu-hu",  33: "uk-ua",  34: "no-no",
+  35: "da-dk",  36: "ur-pk",  37: "hr-hr",  38: "hy-am",
+  39: "bg-bg",  40: "si-lk",  41: "is-is",  42: "kk-kz",
+  43: "sr-rs",  44: "ne-np",  45: "lv-lv",  46: "sl-si",
+  47: "sw-ke",  48: "ka-ge",  49: "et-ee",  50: "sv-se",
+  51: "be-by",  52: "zu-za",  53: "lt-lt",  54: "my-mm",
+  55: "ro-ro",  56: "lo-la",  57: "mn-mn",  58: "az-az",
+  59: "am-et",  60: "sq-al",  61: "mk-mk",  62: "gl-es",
+  63: "ca-es",  64: "af-za",  65: "kn-in",  66: "gu-in",
+  67: "eu-es",  68: "iw-il",  69: "pa-in",  70: "ky-kg",
+  71: "te-in",  72: "ta-in",  73: "rm-ch",  74: "mr-in",
+  75: "ml-in",  76: "km-kh",  77: "bs-ba",  78: "lb-lu",
+  79: "rw-rw",  80: "mt-mt",  81: "uz-uz",  82: "ga-ie",
 };
 
+// locale 字符串 → PascalCase 文件名（从 operate-main MacroExport::filter2 复制）
+// 'zh-cn' → 'ZhCn', 'fil-ph' → 'FilPh'
+function toLocaleName(localeStr) {
+  return localeStr.split("-").map(s => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+
+// 特殊映射：项目 locale 文件名与 filter2 输出不一致的语言
+const LOCALE_NAME_OVERRIDE = {
+  16: "ArSa",   // filter2: ArAr → 实际: ArSa
+  20: "FiFi",   // filter2: SmSm → 实际: FiFi (芬兰语)
+  22: "InId",   // filter2: IdId → 实际: InId (印尼语)
+  23: "Th",     // filter2: ThTh → 实际: Th (泰语)
+  29: "HiDi",   // filter2: HiIn → 实际: HiDi (印地语)
+  31: "ElEl",   // filter2: ElGr → 实际: ElEl (希腊语)
+};
+
+// 获取 locale 文件名（优先用 override，否则 filter2 动态生成）
+function getLocaleName(langId) {
+  const id = Number(langId);
+  if (LOCALE_NAME_OVERRIDE[id]) return LOCALE_NAME_OVERRIDE[id];
+  const localeStr = LANGUAGE_STRING_MAP[id];
+  if (!localeStr) return null;
+  return toLocaleName(localeStr);
+}
+
 // %s → {0}, {1}, {2}... 替换
 function fixPlaceholders(value) {
   let cnt = 0;
@@ -460,7 +478,7 @@ function registerTools(server) {
             content: [{ type: "text", text: `找到字符串但语言ID=${language_id} 无翻译内容` }],
           };
         }
-        const localeName = LANGUAGE_LOCALE_MAP[language_id] || `lang_${language_id}`;
+        const localeName = getLocaleName(language_id) || `lang_${language_id}`;
         const json = JSON.stringify(localeObj, null, 2);
         return {
           content: [{
@@ -473,7 +491,7 @@ function registerTools(server) {
       // 全部语言导出
       let output = `共匹配 ${Object.keys(allStrings).length} 种语言:\n\n`;
       for (const [langId, localeObj] of Object.entries(allStrings)) {
-        const localeName = LANGUAGE_LOCALE_MAP[langId] || `lang_${langId}`;
+        const localeName = getLocaleName(langId) || `lang_${langId}`;
         const json = JSON.stringify(localeObj, null, 2);
         output += `### ${localeName}.json (语言ID=${langId}, ${Object.keys(localeObj).length} 条)\n\`\`\`json\n${json}\n\`\`\`\n\n`;
       }
@@ -540,7 +558,7 @@ function registerTools(server) {
       let filesSkipped = 0;
 
       for (const [langId, newEntries] of Object.entries(allStrings)) {
-        const localeName = LANGUAGE_LOCALE_MAP[langId];
+        const localeName = getLocaleName(langId);
         if (!localeName) {
           filesSkipped++;
           continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camscanner/mcp-language-server",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "MCP Server for multi-language string management",
   "main": "dist/index.js",
   "bin": {

package/plugins/i18n/.mcp.json

@@ -1,7 +1,7 @@
 {
   "language": {
     "command": "npx",
-    "args": ["-y", "git+https://github.com/tianmuji/mcp-language-server.git"],
+    "args": ["-y", "@camscanner/mcp-language-server@latest"],
     "env": {
       "OPERATE_BASE_URL": "https://operate.intsig.net",
       "SSO_LOGIN_URL": "https://web-sso.intsig.net/login",

package/plugins/yapi/.mcp.json

@@ -1,7 +1,7 @@
 {
   "yapi": {
     "command": "npx",
-    "args": ["-y", "git+https://gitlab.intsig.net/cs-templates/skills/yapi-mcp-server.git"],
+    "args": ["-y", "@camscanner/yapi-mcp-server@latest"],
     "env": {
       "YAPI_BASE_URL": "https://web-api.intsig.net",
       "SSO_LOGIN_URL": "https://web-sso.intsig.net/login",

package/src/index.ts

@@ -210,6 +210,79 @@ server.tool(
   }
 )
 
+// Tool: batch-search-string
+server.tool(
+  'batch-search-string',
+  '批量搜索多语言字符串。支持同时搜索多个关键词,每个关键词独立返回结果。适合一次性查询大量字符串是否已在平台录入。',
+  {
+    product_id: z.string().describe('产品ID,先调用 list-products 查询'),
+    words: z.array(z.string()).describe('搜索关键词数组(中文、英文或 key 名)'),
+    version_id: z.string().optional().describe('版本ID,不传则搜索所有版本'),
+    fuzzy: z.string().optional().default('0').describe('1=模糊匹配,0=精确匹配(默认)'),
+    page_size: z.string().optional().default('20').describe('每个关键词的每页条数,最大100'),
+  },
+  async ({ product_id, words, version_id, fuzzy, page_size }) => {
+    const authErr = await requireAuth()
+    if (authErr) return { content: [{ type: 'text', text: authErr }] }
+
+    const results: string[] = []
+    let foundCount = 0
+    let notFoundCount = 0
+
+    // 并发搜索所有关键词
+    const tasks = words.map(async (word) => {
+      const params: Record<string, string> = {
+        product_id, word, fuzzy: fuzzy || '0', page: '1', page_size: page_size || '20',
+      }
+      if (version_id) params.version_id = version_id
+
+      try {
+        const data = await client.post('/language/mcp-language/get-string-search', params)
+        if (data.errno !== 0) {
+          return { word, found: false, output: `❌ "${word}" — 查询失败: ${data.message || '未知错误'}` }
+        }
+
+        const versions = Array.isArray(data.data) ? data.data : (data.data?.list || [])
+        if (versions.length === 0) {
+          return { word, found: false, output: `❌ "${word}" — 未找到` }
+        }
+
+        let output = `✅ "${word}" — ${versions.length} 个版本匹配:\n`
+        for (const version of versions) {
+          const strings = version.ar_string || version.strings || []
+          for (const str of strings) {
+            const keys = str.keys
+              ? Object.entries(str.keys).map(([p, k]) => `platform_${p}: ${k}`).join(', ')
+              : '无'
+            const zhCN = str.values?.['1'] || str.values?.['0'] || ''
+            const enUS = str.values?.['2'] || str.values?.['0'] || ''
+            const zhTW = str.values?.['7'] || ''
+            output += `  - key: ${keys} | 中: ${zhCN} | 英: ${enUS}`
+            if (zhTW) output += ` | 繁: ${zhTW}`
+            output += ` (v${version.version_number})\n`
+          }
+        }
+        return { word, found: true, output }
+      } catch (err: any) {
+        return { word, found: false, output: `❌ "${word}" — 请求异常: ${err.message}` }
+      }
+    })
+
+    const settled = await Promise.all(tasks)
+    for (const r of settled) {
+      results.push(r.output)
+      if (r.found) foundCount++
+      else notFoundCount++
+    }
+
+    let output = `## 批量搜索结果\n\n`
+    output += `共搜索 ${words.length} 个关键词: ✅ ${foundCount} 个找到, ❌ ${notFoundCount} 个未找到\n\n`
+    output += results.join('\n')
+
+    return { content: [{ type: 'text', text: output }] }
+  }
+)
+
 // Tool: export-string
 server.tool(
   'export-string',
@@ -341,22 +414,58 @@ server.tool(
       }
     }
 
-    // Detect local locale files that got no remote data
+    // Fallback: local locale files with no remote translation use English (langId=2)
+    const englishEntries = allStrings['2'] || {}
     const localLocaleNames = fs.readdirSync(locales_path)
       .filter(f => f.endsWith('.json'))
       .map(f => f.replace('.json', ''))
     const missingLocales = findMissingLocales(localLocaleNames, Object.keys(allStrings))
+    let fallbackCount = 0
+
+    if (Object.keys(englishEntries).length > 0) {
+      for (const localeName of missingLocales) {
+        const filePath = path.join(locales_path, `${localeName}.json`)
+        if (!fs.existsSync(filePath)) continue
+
+        let existingObj: Record<string, string> = {}
+        try {
+          const content = fs.readFileSync(filePath, 'utf-8')
+          existingObj = JSON.parse(content)
+        } catch {
+          // empty or invalid file
+        }
+
+        const { merged, keysAdded, keysUpdated } = mergeLocaleEntries(existingObj, englishEntries)
+
+        fs.writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\n')
+        filesWritten++
+        fallbackCount++
+        totalKeys += Object.keys(englishEntries).length
+        if (keysAdded.length > 0 || keysUpdated.length > 0) {
+          results.push(`${localeName}.json: +${keysAdded.length} 新增, ~${keysUpdated.length} 更新 (英语兜底)`)
+        } else {
+          results.push(`${localeName}.json: 无变化 (${Object.keys(englishEntries).length} 条已存在)`)
+        }
+      }
+    }
+
+    // Remaining missing locales (no English fallback available)
+    const stillMissing = Object.keys(englishEntries).length > 0
+      ? [] // all missing locales got English fallback
+      : missingLocales
 
     let output = `写入完成!\n`
     output += `- 目录: ${locales_path}\n`
     output += `- 写入 ${filesWritten} 个文件, 跳过 ${filesSkipped} 个 (项目中不存在)\n`
+    if (fallbackCount > 0) {
+      output += `- 其中 ${fallbackCount} 个文件使用英语兜底\n`
+    }
     output += `- 共 ${totalKeys} 条字符串\n\n`
     output += results.map(r => `  ${r}`).join('\n')
 
-    if (missingLocales.length > 0) {
-      output += `\n\n⚠️ 以下 ${missingLocales.length} 个本地语言文件未获得远程翻译，未被更新:\n`
-      output += missingLocales.map(name => `  - ${name}.json`).join('\n')
-      output += `\n请确认远程平台是否已为这些语言提供翻译。`
+    if (stillMissing.length > 0) {
+      output += `\n\n⚠️ 以下 ${stillMissing.length} 个本地语言文件未获得远程翻译，且无英语兜底:\n`
+      output += stillMissing.map(name => `  - ${name}.json`).join('\n')
     }
 
     return { content: [{ type: 'text', text: output }] }

package/src/utils.ts

@@ -10,36 +10,59 @@ export const PLATFORM_MAP: Record<number, string> = {
   9: 'PC',
 }
 
-export const LANGUAGE_LOCALE_MAP: Record<string, string> = {
-  '1': 'ZhCn',
-  '2': 'EnUs',
-  '3': 'JaJp',
-  '4': 'KoKr',
-  '5': 'FrFr',
-  '6': 'DeDe',
-  '7': 'ZhTw',
-  '8': 'PtBr',
-  '9': 'EsEs',
-  '10': 'ItIt',
-  '11': 'RuRu',
-  '12': 'TrTr',
-  '13': 'ArSa',
-  '14': 'ThTh',
-  '15': 'PlPl',
-  '16': 'ViVn',
-  '17': 'InId',
-  '19': 'MsMy',
-  '20': 'NlNl',
-  '22': 'HiDi',
-  '23': 'BnBd',
-  '24': 'CsCs',
-  '25': 'SkSk',
-  '26': 'FilPh',
-  '27': 'ElEl',
-  '28': 'PtPt',
-  '29': 'RoRo',
+// 语言ID → locale 字符串映射（从 operate-main AppConfMacro::$ar_language_map 复制）
+const LANGUAGE_STRING_MAP: Record<number, string> = {
+  1: 'zh-cn',   2: 'en-us',   3: 'de-de',   4: 'fr-fr',
+  5: 'ja-jp',   6: 'ko-kr',   7: 'zh-tw',   8: 'es-es',
+  9: 'ru-ru',  10: 'sk-sk',  11: 'cs-cs',  12: 'pt-pt',
+  13: 'pl-pl',  14: 'it-it',  15: 'tr-tr',  16: 'ar-ar',
+  17: 'pt-br',  19: 'ag-ag',  20: 'sm-sm',  22: 'id-id',
+  23: 'th-th',  24: 'fil-ph', 25: 'ms-my',  26: 'vi-vn',
+  27: 'bn-bd',  28: 'fa-ir',  29: 'hi-in',  30: 'nl-nl',
+  31: 'el-gr',  32: 'hu-hu',  33: 'uk-ua',  34: 'no-no',
+  35: 'da-dk',  36: 'ur-pk',  37: 'hr-hr',  38: 'hy-am',
+  39: 'bg-bg',  40: 'si-lk',  41: 'is-is',  42: 'kk-kz',
+  43: 'sr-rs',  44: 'ne-np',  45: 'lv-lv',  46: 'sl-si',
+  47: 'sw-ke',  48: 'ka-ge',  49: 'et-ee',  50: 'sv-se',
+  51: 'be-by',  52: 'zu-za',  53: 'lt-lt',  54: 'my-mm',
+  55: 'ro-ro',  56: 'lo-la',  57: 'mn-mn',  58: 'az-az',
+  59: 'am-et',  60: 'sq-al',  61: 'mk-mk',  62: 'gl-es',
+  63: 'ca-es',  64: 'af-za',  65: 'kn-in',  66: 'gu-in',
+  67: 'eu-es',  68: 'iw-il',  69: 'pa-in',  70: 'ky-kg',
+  71: 'te-in',  72: 'ta-in',  73: 'rm-ch',  74: 'mr-in',
+  75: 'ml-in',  76: 'km-kh',  77: 'bs-ba',  78: 'lb-lu',
+  79: 'rw-rw',  80: 'mt-mt',  81: 'uz-uz',  82: 'ga-ie',
 }
 
+// locale 字符串 → PascalCase 文件名（从 operate-main MacroExport::filter2 复制）
+function toLocaleName(localeStr: string): string {
+  return localeStr.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('')
+}
+
+// 特殊映射：项目 locale 文件名与 filter2 输出不一致的语言
+const LOCALE_NAME_OVERRIDE: Record<number, string> = {
+  16: 'ArSa',   // filter2: ArAr → 实际: ArSa
+  20: 'FiFi',   // filter2: SmSm → 实际: FiFi (芬兰语)
+  22: 'InId',   // filter2: IdId → 实际: InId (印尼语)
+  23: 'Th',     // filter2: ThTh → 实际: Th (泰语)
+  29: 'HiDi',   // filter2: HiIn → 实际: HiDi (印地语)
+  31: 'ElEl',   // filter2: ElGr → 实际: ElEl (希腊语)
+}
+
+// 获取 locale 文件名（优先用 override，否则 filter2 动态生成）
+export function getLocaleName(langId: string | number): string | null {
+  const id = Number(langId)
+  if (LOCALE_NAME_OVERRIDE[id]) return LOCALE_NAME_OVERRIDE[id]
+  const localeStr = LANGUAGE_STRING_MAP[id]
+  if (!localeStr) return null
+  return toLocaleName(localeStr)
+}
+
+// 兼容旧接口：动态生成完整映射表
+export const LANGUAGE_LOCALE_MAP: Record<string, string> = Object.fromEntries(
+  Object.keys(LANGUAGE_STRING_MAP).map(id => [String(id), getLocaleName(id)!]).filter(([, v]) => v)
+)
+
 // --- Helpers ---
 
 export function fixPlaceholders(value: string): string {