🧭 fix(docs): show API index in EN/JA by aligning api meta.json with ZH

- Mark `content/docs/en/api` and `content/docs/ja/api` as root folders (`root: true`)
- Add consistent page ordering to include `index`, `ai-model`, and `management`
- Fill in localized title/description/icon so the API section appears in the sidebar tabs

Author: t0ng7u

content/docs/en/api/meta.json

@@ -1,3 +1,7 @@
 {
-  "title": "API"
+  "title": "API Reference",
+  "description": "New API Complete API Documentation",
+  "icon": "Code",
+  "root": true,
+  "pages": ["index", "ai-model", "management"]
 }

content/docs/en/guide/wiki/changelog.mdx

@@ -4,7 +4,7 @@ title: Changelog
 
 import { Callout } from 'fumadocs-ui/components/callout';
 
-<Callout type="warn" title="Version Log Information · Data updated at 2026-1-4 23:18:11">
+<Callout type="warn" title="Version Log Information · Data updated at 2026-1-5 00:07:28">
 To view all historical versions, please visit the [GitHub Releases page](https://github.com/QuantumNous/new-api/releases). This page automatically fetches the latest update information from that page.
 </Callout>
 

content/docs/en/guide/wiki/special-thanks.mdx

@@ -10,7 +10,7 @@ The development of New API would not be possible without the support and contrib
 
 Below is a list of all developers who have contributed to the project. We thank them for their hard work and creativity!
 
-<Callout title="Contributor Information · Data updated at 2026-1-4 23:18:11 (UTC+8)">
+<Callout title="Contributor Information · Data updated at 2026-1-5 00:07:28 (UTC+8)">
 The following contributor data is automatically retrieved from the [GitHub Contributors page](https://github.com/QuantumNous/new-api/graphs/contributors) for the top 50 contributors. The top three contributors are marked with gold, silver, and bronze borders respectively. If you would also like to contribute to the project, you are welcome to submit a Pull Request.
 </Callout>
 

content/docs/ja/api/meta.json

@@ -1,3 +1,7 @@
 {
-  "title": "API"
+  "title": "APIリファレンス",
+  "description": "New API の完全なインターフェースドキュメント",
+  "icon": "Code",
+  "root": true,
+  "pages": ["index", "ai-model", "management"]
 }

content/docs/ja/guide/wiki/changelog.mdx

@@ -4,7 +4,7 @@ title: 変更履歴
 
 import { Callout } from 'fumadocs-ui/components/callout';
 
-<Callout type="warn" title="バージョンログ情報 · データ更新日時 2026-1-4 23:18:11">
+<Callout type="warn" title="バージョンログ情報 · データ更新日時 2026-1-5 00:07:28">
 すべての履歴バージョンを表示するには、[GitHub Releases ページ](https://github.com/QuantumNous/new-api/releases)をご覧ください。このページは定期的に最新の更新情報を取得します。
 </Callout>
 

content/docs/ja/guide/wiki/special-thanks.mdx

@@ -10,7 +10,7 @@ New API の開発は、コミュニティのサポートと貢献なしには実
 
 以下は、プロジェクトに貢献してくださったすべての開発者のリストです。彼らの勤勉な作業と創造性に感謝します！
 
-<Callout title="貢献者情報 · データ更新日時 2026-1-4 23:18:11 (UTC+8)">
+<Callout title="貢献者情報 · データ更新日時 2026-1-5 00:07:28 (UTC+8)">
 以下の貢献者データは、[GitHub Contributors ページ](https://github.com/QuantumNous/new-api/graphs/contributors)から上位50名を自動的に取得します。貢献度上位3名は、それぞれゴールド、シルバー、ブロンズの枠で識別されます。プロジェクトに貢献したい場合は、プルリクエストを送信してください。
 </Callout>
 

content/docs/zh/guide/wiki/changelog.mdx

@@ -4,7 +4,7 @@ title: 更新日志
 
 import { Callout } from 'fumadocs-ui/components/callout';
 
-<Callout type="warn" title="版本日志信息 · 数据更新于 2026-1-4 23:18:11">
+<Callout type="warn" title="版本日志信息 · 数据更新于 2026-1-5 00:07:28">
 如需查看全部历史版本，请访问 [GitHub Releases 页面](https://github.com/QuantumNous/new-api/releases)，本页面从该页面定时获取最新更新信息。
 </Callout>
 

content/docs/zh/guide/wiki/special-thanks.mdx

@@ -10,7 +10,7 @@ New API 的开发离不开社区的支持和贡献。在此特别感谢所有为
 
 以下是所有为项目做出贡献的开发者列表。在此感谢他们的辛勤工作和创意！
 
-<Callout title="贡献者信息 · 数据更新于 2026-1-4 23:18:11 (UTC+8)">
+<Callout title="贡献者信息 · 数据更新于 2026-1-5 00:07:27 (UTC+8)">
 以下贡献者数据从 [GitHub Contributors 页面](https://github.com/QuantumNous/new-api/graphs/contributors) 自动获取前50名。贡献度前三名分别以金、银、铜牌边框标识。如果您也想为项目做出贡献，欢迎提交 Pull Request。
 </Callout>
 

scripts/translate-docs.ts

@@ -69,12 +69,14 @@ interface TranslationResult {
 }
 
 // ============================================================================
-// Validation
+// Validation (deferred)
 // ============================================================================
-
-if (!OPENAI_API_KEY) {
-  console.error('❌ Error: OPENAI_API_KEY environment variable is not set');
-  process.exit(1);
+// NOTE: Do not exit at import time. This file is also imported by tooling/scripts.
+function assertOpenAIKey() {
+  if (!OPENAI_API_KEY) {
+    console.error('❌ Error: OPENAI_API_KEY environment variable is not set');
+    process.exit(1);
+  }
 }
 
 // ============================================================================
@@ -90,7 +92,57 @@ const BASE_TRANSLATION_RULES = `
 5. 图片路径、链接路径保持不变（如果路径中包含中文目录，保持原样）
 6. Front matter (YAML 头部) 中的内容需要翻译
 7. 保持原文的语气和风格
-8. 对于特殊的专有名词（如产品名 "New API"、"Cherry Studio" 等），保持不变`;
+8. 对于特殊的专有名词（如产品名 "New API"、"Cherry Studio" 等），保持不变
+9. 如果文本中出现占位符（例如 @@FD_PROTECT_0@@），必须原样保留，不得翻译、改写、换行或添加空格`;
+
+// ============================================================================
+// MDX Protection (Prevent AI from translating API/OpenAPI paths)
+// ============================================================================
+
+const PROTECT_PREFIX = '@@FD_PROTECT_';
+const PROTECT_SUFFIX = '@@';
+
+function protectMdxSegments(input: string): {
+  protectedText: string;
+  restore: (translated: string) => string;
+  tokens: string[];
+} {
+  const replacements: Array<{ token: string; value: string }> = [];
+  let protectedText = input;
+
+  function protectByRegex(re: RegExp) {
+    protectedText = protectedText.replace(re, (match) => {
+      const token = `${PROTECT_PREFIX}${replacements.length}${PROTECT_SUFFIX}`;
+      replacements.push({ token, value: match });
+      return token;
+    });
+  }
+
+  // Protect the entire <APIPage ... /> component (it often contains OpenAPI JSON paths).
+  protectByRegex(/<APIPage\b[\s\S]*?\/>/g);
+
+  // Extra safety: protect any remaining OpenAPI generated JSON path outside APIPage.
+  protectByRegex(/openapi\/generated\/[^\s"'<>)}\]]+?\.json/g);
+
+  const tokens = replacements.map((r) => r.token);
+  const restore = (translated: string) => {
+    // Ensure model didn't drop/alter tokens. If it did, retry to avoid corrupting paths.
+    for (const t of tokens) {
+      if (!translated.includes(t)) {
+        throw new Error(
+          `Translation output is missing protected token: ${t}. Refusing to write corrupted content.`
+        );
+      }
+    }
+    let out = translated;
+    for (const r of replacements) {
+      out = out.split(r.token).join(r.value);
+    }
+    return out;
+  };
+
+  return { protectedText, restore, tokens };
+}
 
 function getPlainTextTranslationPrompt(
   targetLang: LanguageCode,
@@ -187,8 +239,12 @@ async function translateContent(
         );
       }
 
-      const prompt = getTranslationPrompt(targetLang, content);
-      return await callOpenAI(prompt, targetLang);
+      // Protect critical MDX segments (e.g. <APIPage document={...} />) so AI won't translate paths.
+      const { protectedText, restore } = protectMdxSegments(content);
+
+      const prompt = getTranslationPrompt(targetLang, protectedText);
+      const translated = await callOpenAI(prompt, targetLang);
+      return restore(translated);
     } catch (error) {
       lastError = error as Error;
       retryCount++;
@@ -601,6 +657,7 @@ async function processFiles(
 // ============================================================================
 
 async function translateDocs(specificPaths?: string[]) {
+  assertOpenAIKey();
   console.log('═══════════════════════════════════════════════');
   console.log('🌐 Starting document translation...');
   console.log('═══════════════════════════════════════════════\n');
@@ -711,3 +768,5 @@ if (require.main === module) {
 }
 
 export { translateDocs };
+// Export for testing/tooling (e.g. to verify OpenAPI path protection).
+export { protectMdxSegments };