@jjlmoya/utils-games-development 1.52.0 → 1.53.0

package/src/tool/localizationSanitizer/i18n/sv.ts

@@ -0,0 +1,176 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { LocalizationSanitizerUI } from '../ui';
+
+export const content: ToolLocaleContent<LocalizationSanitizerUI> = {
+  slug: 'sanering-lokaliseringsfiler-godot-unity',
+  title: 'Sanering av CSV och JSON lokaliseringsfiler för Godot och Unity',
+  description: 'Inspektera CSV och JSON översättningsfiler för tomma celler, duplicerade nycklar och felaktiga rader samt exportera en ren kopia för spelmotorn.',
+  ui: {
+    csvTab: 'CSV fil',
+    jsonTab: 'JSON fil',
+    dropTitle: 'Släpp en översättningsfil här',
+    dropSubtitle: 'Inspektera strukturen i webbläsaren och behåll källfilen på din enhet.',
+    browseButton: 'Bläddra filer',
+    sampleButton: 'Ladda exempel',
+    clearButton: 'Rensa',
+    inputLabel: 'Inmatningsfil för översättning',
+    formatLabel: 'Format',
+    healthLabel: 'Filstatus',
+    readyStatus: 'Redo för import',
+    reviewStatus: 'Kräver granskning',
+    emptyCellsLabel: 'Tomma celler',
+    duplicateKeysLabel: 'Duplicerade nycklar',
+    malformedRowsLabel: 'Felaktiga rader',
+    cleanRowsLabel: 'Rena rader',
+    issueListTitle: 'Resultat',
+    noIssues: 'Inga fel hittades i denna analys.',
+    previewTitle: 'Översättningsvisning',
+    previewSubtitle: 'De första raderna visar den normaliserade strukturen som exporteras.',
+    exportTitle: 'Exportera ren fil',
+    exportSubtitle: 'Duplikater tas bort saknade kolumner fylls i och CSV värden escapar korrekt.',
+    downloadButton: 'Ladda ner ren fil',
+    copyButton: 'Kopiera resultat',
+    copiedMessage: 'Rent resultat kopierat till urklipp.',
+    emptyIssue: 'Tom översättningscell',
+    duplicateIssue: 'Duplicerad nyckels rad borttagen',
+    malformedIssue: 'Kolumn eller citatteckenfel',
+    parseIssue: 'Kunde inte läsa filen.',
+    rowLabel: 'Rad',
+    columnLabel: 'Kolumn',
+    keyLabel: 'Nyckel',
+    sampleFileName: 'lokalisering-exempel.csv',
+    privacyNote: 'Lokal behandling i webbläsaren',
+    waitingTitle: 'Väntar på fil',
+    waitingSubtitle: 'Släpp en CSV eller JSON fil för att starta granskningen.',
+    fileTypeNote: 'UTF8 CSV eller strukturerad JSON',
+  },
+  seo: [
+    { type: 'title', level: 2, text: 'Varför lokaliseringsfiler misslyckas vid import' },
+    {
+      type: 'paragraph',
+      html: 'Översättningstabeller är enkla att redigera men lätta att förstöra. Ett kommatecken inuti en mening eller saknade citattecken kan förskjuta språkkolumnerna.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Godots CSV importör och Unity Localization kräver konsekvent struktur. Detta verktyg kontrollerar filen innan import.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: 'CSV', label: 'Kommakontroll' },
+        { value: 'JSON', label: 'Array & map support' },
+        { value: '0 uppladdningar', label: 'Helt lokalt' },
+        { value: '1 klick', label: 'Ren export' },
+      ],
+    },
+    { type: 'title', level: 2, text: 'Vad verktyget kontrollerar' },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Upptäckts före import',
+          description: 'Svårupptäckta fel i stora filer',
+          points: ['Tomma celler', 'Duplicerade nycklar', 'Rader med fel antal kolumner', 'Ogiltiga citattecken'],
+        },
+        {
+          title: 'Normaliserat vid export',
+          description: 'Säkra automatiska korrigeringar',
+          points: ['Saknade kolumner fylls i', 'Extra fält slås ihop i sista kolumnen', 'Första nyckeln behålls', 'Originalfilen påverkas inte'],
+        },
+      ],
+    },
+    { type: 'title', level: 2, text: 'Att granska den sanerade filen' },
+    {
+      type: 'paragraph',
+      html: 'Strukturell sanering ersätter inte språkgranskning. Använd resultatlistan för att komplettera saknade översättningar.',
+    },
+    {
+      type: 'table',
+      headers: ['Fynd', 'Betydelse', 'Rekommenderad åtgärd'],
+      rows: [
+        ['Tom cell', 'En språkkolumn saknar text', 'Översätt eller bekräfta avsiktlig tomhet'],
+        ['Duplicerad nyckel', 'Flera rader använder samma nyckel', 'Jämför rader och behåll den första'],
+        ['Felaktig rad', 'Kolumnantal avviker från rubriken', 'Kontrollera den sammanslagna kolumnen'],
+        ['Läsfel', 'JSON ogiltig', 'Korrigera syntaxen före import'],
+      ],
+    },
+    { type: 'title', level: 2, text: 'CSV konventioner för spel' },
+    {
+      type: 'paragraph',
+      html: 'Text som innehåller kommatecken eller radbrytningar måste omges av dubbla citattecken.',
+    },
+    {
+      type: 'tip',
+      title: 'Spara originalet',
+      html: 'Behåll alltid översättarens originalfil som reservkopia.',
+    },
+    {
+      type: 'glossary',
+      items: [
+        { term: 'Översättningsnyckel', definition: 'Unik identifierare som används i spelkoden.' },
+        { term: 'CSV fält', definition: 'Enskilt värde mellan avskiljare.' },
+        { term: 'Escaping', definition: 'Användning av citattecken för att behålla skiljetecken som text.' },
+        { term: 'Locale', definition: 'Språk och regionkod som sv, en eller ja.' },
+      ],
+    },
+  ],
+  faq: [
+    {
+      question: 'Laddas filer upp till en server?',
+      answer: 'Nej, all bearbetning sker lokalt i webbläsaren.',
+    },
+    {
+      question: 'Vad händer om en CSV rad har extra kommatecken?',
+      answer: 'Raden markeras som felaktig och extra fält slås ihop i sista kolumnen.',
+    },
+    {
+      question: 'Hur rensas duplicerade nycklar?',
+      answer: 'Den första förekomsten behålls och följande ignoreras.',
+    },
+    {
+      question: 'Kontrollerar verktyget översättningskvalitet?',
+      answer: 'Nej, det kontrollerar endast filstruktur och tomma celler.',
+    },
+  ],
+  howTo: [
+    { name: 'Välj format', text: 'Välj CSV eller JSON.' },
+    { name: 'Granska resultat', text: 'Släpp filen och kontrollera fel listan.' },
+    { name: 'Exportera och testa', text: 'Ladda ner den rena filen och importera i motorn.' },
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Sanering av CSV och JSON lokaliseringsfiler för Godot och Unity',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'SEK' },
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [{
+        '@type': 'Question',
+        name: 'Laddas filer upp till en server?',
+        acceptedAnswer: { '@type': 'Answer', text: 'Nej, all bearbetning sker lokalt i webbläsaren.' },
+      }],
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: 'Hur man sanerar en lokaliseringsfil',
+      step: [
+        { '@type': 'HowToStep', name: 'Välj format', text: 'Välj CSV eller JSON.' },
+        { '@type': 'HowToStep', name: 'Granska resultat', text: 'Släpp filen och kontrollera fel listan.' },
+        { '@type': 'HowToStep', name: 'Exporteera och testa', text: 'Ladda ner den rena filen och importera i motorn.' },
+      ],
+    },
+  ],
+  bibliography: [
+    { name: 'Godot ResourceImporterCSVTranslation Dokumentation', url: 'https://docs.godotengine.org/en/stable/classes/class_resourceimportercsvtranslation.html' },
+    { name: 'Unity Localization CSV Import Dokumentation', url: 'https://docs.unity3d.com/Packages/com.unity.localization@1.5/manual/CSV.html' },
+    { name: 'RFC 4180 CSV Specifikation', url: 'https://datatracker.ietf.org/doc/html/rfc4180' },
+  ],
+};

package/src/tool/localizationSanitizer/i18n/tr.ts

@@ -0,0 +1,176 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { LocalizationSanitizerUI } from '../ui';
+
+export const content: ToolLocaleContent<LocalizationSanitizerUI> = {
+  slug: 'yerellestirme-csv-temizleyici-godot-unity',
+  title: 'Godot ve Unity Yerellestirme CSV ve JSON Temizleyici',
+  description: 'Ceviri CSV veya JSON dosyalarinizdaki bos hucreleri, yinelenen anahtarlari ve bozuk satirlari inceleyin ve motor aktarimina hazir temiz bir kopya disari aktarin.',
+  ui: {
+    csvTab: 'CSV Dosyasi',
+    jsonTab: 'JSON Dosyasi',
+    dropTitle: 'Ceviri dosyasini buraya birakin',
+    dropSubtitle: 'Yapiyi tarayicinizda inceleyin, kaynak dosyayi cihazinizda tutun.',
+    browseButton: 'Dosya sec',
+    sampleButton: 'Ornek yukle',
+    clearButton: 'Temizle',
+    inputLabel: 'Ceviri dosyasi girdisi',
+    formatLabel: 'Format',
+    healthLabel: 'Dosya sagligi',
+    readyStatus: 'Aktarima hazir',
+    reviewStatus: 'Inceleme gerekli',
+    emptyCellsLabel: 'Bos hucreler',
+    duplicateKeysLabel: 'Yinelenen anahtarlar',
+    malformedRowsLabel: 'Bozuk satirlar',
+    cleanRowsLabel: 'Temiz satirlar',
+    issueListTitle: 'Bulgular',
+    noIssues: 'Bu taramada sorun bulunamadi.',
+    previewTitle: 'Ceviri onizlemesi',
+    previewSubtitle: 'Ilk satirlar disari aktarilacak normalize edilmis yapiyi gosterir.',
+    exportTitle: 'Temiz dosyayi disari aktar',
+    exportSubtitle: 'Yinelenenler kaldirilir, eksik sutunlar doldurulur ve CSV degerleri duzenlenir.',
+    downloadButton: 'Temiz dosyayi indir',
+    copyButton: 'Sonucu kopyala',
+    copiedMessage: 'Temiz sonuc panoya kopyalandi.',
+    emptyIssue: 'Bos ceviri bucresi',
+    duplicateIssue: 'Yinelenen anahtar kaldirildi',
+    malformedIssue: 'Sutun veya tirnak uyumsuzlugu',
+    parseIssue: 'Dosya okunamadi.',
+    rowLabel: 'Satir',
+    columnLabel: 'Sutun',
+    keyLabel: 'Anahtar',
+    sampleFileName: 'yerellestirme-ornek.csv',
+    privacyNote: 'Yerel tarayici islemi',
+    waitingTitle: 'Dosya bekleniyor',
+    waitingSubtitle: 'Incelemeyi baslatmak icin bir CSV veya JSON dosyasi birakin.',
+    fileTypeNote: 'UTF-8 CSV veya yapilandirilmis JSON',
+  },
+  seo: [
+    { type: 'title', level: 2, text: 'Yerellestirme dosyalari motor aktariminda neden bozulur' },
+    {
+      type: 'paragraph',
+      html: 'Ceviri tablolari kolayca duzenlenebilir ancak bicimlendirme hatalarina karsi hassastir. Cumle icindeki bir virgül veya eksik tirnak isareti sutunlarin kaymasina neden olabilir.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Godot CSV aktarici ve Unity Localization paketi tutarli bir yapi gerektirir. Bu arac, dosyalarinizi aktarim öncesinde denetler.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: 'CSV', label: 'Virgül denetimi' },
+        { value: 'JSON', label: 'Dizi ve nesne destegi' },
+        { value: '0 yukleme', label: 'Tamamen yerel' },
+        { value: '1 tik', label: 'Temiz aktarim' },
+      ],
+    },
+    { type: 'title', level: 2, text: 'Aracin denetledigi hususlar' },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Aktarim öncesi tespit edilenler',
+          description: 'Büyük dosyalarda fark edilmesi zor hatalar',
+          points: ['Bos ceviri hucreleri', 'Yinelenen ceviri anahtarlari', 'Eksik veya fazla sutunlu satirlar', 'Gecersiz tirnak sözdizimi'],
+        },
+        {
+          title: 'Aktarimda normalize edilenler',
+          description: 'Guvenli otomatik düzeltmeler',
+          points: ['Eksik sutunlarin doldurulmasi', 'Fazla alanlarin son sutunda birlestirilmesi', 'Ilk anahtar kaydinin korunmasi', 'Orijinal dosyanin korunmasi'],
+        },
+      ],
+    },
+    { type: 'title', level: 2, text: 'Temizlenen dosyanin incelenmesi' },
+    {
+      type: 'paragraph',
+      html: 'Yapisal temizleme dil kontrolünün yerini almaz. Eksik cevirileri tamamlamak icin bulgu listesini kullanin.',
+    },
+    {
+      type: 'table',
+      headers: ['Bulgu', 'Anlami', 'Onerilen eylem'],
+      rows: [
+        ['Bos hucre', 'Dil sutununda metin yok', 'Cevirin veya bilerek bos birakildigini onaylayin'],
+        ['Yinelenen anahtar', 'Birden fazla satir ayni anahtari kullaniyor', 'Satirlari karsilastirip ilkini koruyun'],
+        ['Bozuk satir', 'Sutun sayisi baslikla uyuşmuyor', 'Birlesik son sutunu kontrol edin'],
+        ['Okuma hatasi', 'JSON gecersiz', 'Aktarmadan önce sözdizimini düzeltin'],
+      ],
+    },
+    { type: 'title', level: 2, text: 'Oyunlar icin CSV kurallari' },
+    {
+      type: 'paragraph',
+      html: 'Virgül veya satir sonu iceren metinler cift tirnak icine alinmalidir.',
+    },
+    {
+      type: 'tip',
+      title: 'Orijinali saklayin',
+      html: 'Cevirmenden gelen orijinal dosyayi daima yedek olarak saklayin.',
+    },
+    {
+      type: 'glossary',
+      items: [
+        { term: 'Ceviri anahtari', definition: 'Oyun kodunda kullanilan benzersiz tanimlayici.' },
+        { term: 'CSV alani', definition: 'Ayiricilar arasindaki tekil deger.' },
+        { term: 'Escaping', definition: 'Noktalama isaretlerini korumak icin tirnak kullanimi.' },
+        { term: 'Locale', definition: 'tr, en veya ja gibi dil ve bölge kodu.' },
+      ],
+    },
+  ],
+  faq: [
+    {
+      question: 'Dosyalar sunucuya yukleniyor mu?',
+      answer: 'Hayir, tum islemler tamamen tarayici icinde yerel olarak yapilir.',
+    },
+    {
+      question: 'CSV satirinda fazla virgül varsa ne olur?',
+      answer: 'Satir bozuk olarak isaretlenir ve fazla alanlar son sutunda birlestirilir.',
+    },
+    {
+      question: 'Yinelenen anahtarlar nasil temizlenir?',
+      answer: 'Ilk kayit korunur, sonraki yinelenenler disari aktarilan dosyadan cikarilir.',
+    },
+    {
+      question: 'Arac ceviri kalitesini kontrol eder mi?',
+      answer: 'Hayir, yalnızca dosya yapisini ve bos hucreleri denetler.',
+    },
+  ],
+  howTo: [
+    { name: 'Format secin', text: 'CSV veya JSON secin.' },
+    { name: 'Bulgulari inceleyin', text: 'Dosyayi birakin ve hata listesini kontrol edin.' },
+    { name: 'Disari aktarin ve test edin', text: 'Temiz dosyayi indirin ve motorunuzda test edin.' },
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Godot ve Unity Yerellestirme CSV ve JSON Temizleyici',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'TRY' },
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [{
+        '@type': 'Question',
+        name: 'Dosyalar sunucuya yukleniyor mu?',
+        acceptedAnswer: { '@type': 'Answer', text: 'Hayir, tum islemler tamamen tarayici icinde yerel olarak yapilir.' },
+      }],
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: 'Yerellestirme dosyasi nasil temizlenir',
+      step: [
+        { '@type': 'HowToStep', name: 'Format secin', text: 'CSV veya JSON secin.' },
+        { '@type': 'HowToStep', name: 'Bulgulari inceleyin', text: 'Dosyayi birakin ve hata listesini kontrol edin.' },
+        { '@type': 'HowToStep', name: 'Disari aktarin ve test edin', text: 'Temiz dosyayi indirin ve motorunuzda test edin.' },
+      ],
+    },
+  ],
+  bibliography: [
+    { name: 'Godot ResourceImporterCSVTranslation Dokumantasyonu', url: 'https://docs.godotengine.org/en/stable/classes/class_resourceimportercsvtranslation.html' },
+    { name: 'Unity Localization CSV Import Dokumantasyonu', url: 'https://docs.unity3d.com/Packages/com.unity.localization@1.5/manual/CSV.html' },
+    { name: 'RFC 4180 CSV Spesifikasyonu', url: 'https://datatracker.ietf.org/doc/html/rfc4180' },
+  ],
+};

package/src/tool/localizationSanitizer/i18n/zh.ts

@@ -0,0 +1,176 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { LocalizationSanitizerUI } from '../ui';
+
+export const content: ToolLocaleContent<LocalizationSanitizerUI> = {
+  slug: 'localization-sanitizer',
+  title: 'Godot 与 Unity 本地化 CSV 及 JSON 修复工具',
+  description: '检查翻译 CSV 和 JSON 文件中的空单元格、重复键及损坏行，并导出可直接导入游戏引擎的规范化文件。',
+  ui: {
+    csvTab: 'CSV 文件',
+    jsonTab: 'JSON 文件',
+    dropTitle: '拖放翻译文件至此处',
+    dropSubtitle: '在浏览器中检查结构，源文件保留在本地设备上。',
+    browseButton: '浏览文件',
+    sampleButton: '加载示例',
+    clearButton: '清空',
+    inputLabel: '翻译文件输入',
+    formatLabel: '格式',
+    healthLabel: '文件状态',
+    readyStatus: '可直接导入',
+    reviewStatus: '需要检查',
+    emptyCellsLabel: '空单元格',
+    duplicateKeysLabel: '重复键',
+    malformedRowsLabel: '损坏行',
+    cleanRowsLabel: '正常行',
+    issueListTitle: '检查结果',
+    noIssues: '未发现结构问题。',
+    previewTitle: '翻译预览',
+    previewSubtitle: '前几行展示了即将导出的规范化结构。',
+    exportTitle: '导出规范文件',
+    exportSubtitle: '自动移除重复键、补齐缺失列并规范 CSV 转义字符。',
+    downloadButton: '下载规范文件',
+    copyButton: '复制结果',
+    copiedMessage: '已成功复制规范化结果到剪贴板。',
+    emptyIssue: '空翻译单元格',
+    duplicateIssue: '已移除重复键',
+    malformedIssue: '列数或引号不匹配',
+    parseIssue: '无法解析文件。',
+    rowLabel: '行',
+    columnLabel: '列',
+    keyLabel: '键',
+    sampleFileName: 'localization-sample.csv',
+    privacyNote: '本地浏览器处理',
+    waitingTitle: '等待文件',
+    waitingSubtitle: '拖放 CSV 或 JSON 文件开始检查。',
+    fileTypeNote: 'UTF8 CSV 或结构化 JSON',
+  },
+  seo: [
+    { type: 'title', level: 2, text: '本地化文件导入引擎时为何容易出错' },
+    {
+      type: 'paragraph',
+      html: '翻译表格虽然便于编辑，但也容易产生格式错误。包含逗号的文本若缺少转义引号，会导致整行文本错列。',
+    },
+    {
+      type: 'paragraph',
+      html: 'Godot CSV 导入器和 Unity Localization 均需要严格的列格式。本工具在导入前帮助您排查并规范文件。',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: 'CSV', label: '逗号及转义检查' },
+        { value: 'JSON', label: '数组与对象映射' },
+        { value: '0 上传', label: '纯本地处理' },
+        { value: '1 键', label: '一键导出' },
+      ],
+    },
+    { type: 'title', level: 2, text: '工具检查项目' },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: '导入前排查',
+          description: '大文件中难以肉眼发现的问题',
+          points: ['缺失翻译的空单元格', '重复的翻译 Key', '列数不一致的损坏行', '非法的引号语法'],
+        },
+        {
+          title: '导出时规范化',
+          description: '安全的自动修复',
+          points: ['自动补齐缺失列', '合并多余列至末尾列', '保留首次出现的 Key', '源文件安全无损'],
+        },
+      ],
+    },
+    { type: 'title', level: 2, text: '如何审核处理后的文件' },
+    {
+      type: 'paragraph',
+      html: '结构修复无法替代文本校对。请根据检查结果列表补充未完成的翻译。',
+    },
+    {
+      type: 'table',
+      headers: ['检查项', '含义', '建议操作'],
+      rows: [
+        ['空单元格', '语言列缺失文本', '补充翻译或确认是否故意留空'],
+        ['重复键', '多行使用了相同的 Key', '对比文本后采用保留的首次记录'],
+        ['损坏行', '列数与表头不符', '检查合并后的末尾列内容'],
+        ['解析错误', 'JSON 格式非法', '导入前修复 JSON 语法'],
+      ],
+    },
+    { type: 'title', level: 2, text: '游戏本地化 CSV 规范' },
+    {
+      type: 'paragraph',
+      html: '包含逗号或换行符的文本必须使用双引号包裹。',
+    },
+    {
+      type: 'tip',
+      title: '保留原始文件',
+      html: '请务必保留译员交付的原始文件作为备份与对比。',
+    },
+    {
+      type: 'glossary',
+      items: [
+        { term: '翻译键 (Key)', definition: '游戏代码中引用的唯一文本标识符。' },
+        { term: 'CSV 字段', definition: '分隔符之间的单个文本值。' },
+        { term: '转义 (Escaping)', definition: '使用引号包裹以保留标点符号。' },
+        { term: 'Locale', definition: '语言与地区代码，如 zh, en, ja。' },
+      ],
+    },
+  ],
+  faq: [
+    {
+      question: '文件会被上传到服务器吗？',
+      answer: '不会，所有解析与处理均在本地浏览器内存中完成。',
+    },
+    {
+      question: '如果 CSV 行中有多余的逗号会怎样？',
+      answer: '该行会被标记为损坏行，多余字段会在导出时合并至末尾列。',
+    },
+    {
+      question: '如何处理重复键？',
+      answer: '保留第一次出现的记录，后续重复 Key 将被过滤。',
+    },
+    {
+      question: '本工具会检查翻译质量吗？',
+      answer: '不会，本工具仅检查文件结构与单元格完整性。',
+    },
+  ],
+  howTo: [
+    { name: '选择格式', text: '选择 CSV 或 JSON 格式。' },
+    { name: '查看检查结果', text: '拖放文件并排查问题列表。' },
+    { name: '导出并测试', text: '下载规范文件并导入游戏引擎测试。' },
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Godot 与 Unity 本地化 CSV 及 JSON 修复工具',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'CNY' },
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [{
+        '@type': 'Question',
+        name: '文件会被上传到服务器吗？',
+        acceptedAnswer: { '@type': 'Answer', text: '不会，所有解析与处理均在本地浏览器内存中完成。' },
+      }],
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: '如何修复游戏本地化文件',
+      step: [
+        { '@type': 'HowToStep', name: '选择格式', text: '选择 CSV 或 JSON 格式。' },
+        { '@type': 'HowToStep', name: '查看检查结果', text: '拖放文件并排查问题列表。' },
+        { '@type': 'HowToStep', name: '导出并测试', text: '下载规范文件并导入游戏引擎测试。' },
+      ],
+    },
+  ],
+  bibliography: [
+    { name: 'Godot ResourceImporterCSVTranslation 文档', url: 'https://docs.godotengine.org/en/stable/classes/class_resourceimportercsvtranslation.html' },
+    { name: 'Unity Localization CSV Import 文档', url: 'https://docs.unity3d.com/Packages/com.unity.localization@1.5/manual/CSV.html' },
+    { name: 'RFC 4180 CSV 规范', url: 'https://datatracker.ietf.org/doc/html/rfc4180' },
+  ],
+};

package/src/tool/localizationSanitizer/index.ts

@@ -0,0 +1,12 @@
+import type { ToolDefinition } from '../../types';
+import { localizationSanitizer } from './entry';
+
+export * from './entry';
+export * from './logic';
+
+export const LOCALIZATION_SANITIZER_TOOL: ToolDefinition = {
+  entry: localizationSanitizer,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/localizationSanitizer/json-sanitizer.ts

@@ -0,0 +1,118 @@
+import { emptyResult, issue } from './csv-sanitizer';
+import type { JsonRowRecord, SanitizerIssue, SanitizerResult } from './types';
+
+function textValue(value: unknown): string {
+  if (value === null || value === undefined) return '';
+  if (typeof value === 'string') return value;
+  if (typeof value === 'object') return JSON.stringify(value);
+  return String(value);
+}
+
+function objectRecords(value: unknown): JsonRowRecord[] | null {
+  if (!Array.isArray(value)) return null;
+  return value.map((item, index) => ({
+    source: item !== null && typeof item === 'object' && !Array.isArray(item) ? (item as Record<string, unknown>) : {},
+    row: index + 1,
+  }));
+}
+
+function parseJsonRecords(source: string): { records: JsonRowRecord[]; isMap: boolean; mapValuesAreObjects: boolean } | null {
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(source.replace(/^\uFEFF/, ''));
+  } catch {
+    return null;
+  }
+  const arrayRecords = objectRecords(parsed);
+  const isMap = !Array.isArray(parsed) && parsed !== null && typeof parsed === 'object';
+  const mapEntries = isMap ? Object.entries(parsed as Record<string, unknown>) : [];
+  const mapValuesAreObjects = mapEntries.length > 0 && mapEntries.every(([, value]) => value !== null && typeof value === 'object' && !Array.isArray(value));
+  const records: JsonRowRecord[] = arrayRecords ?? (mapEntries.length > 0
+    ? mapEntries.map(([key, value], index) => ({ source: mapValuesAreObjects ? { ...(value as Record<string, unknown>), key } : { key, value }, row: index + 1 }))
+    : []);
+  return { records, isMap, mapValuesAreObjects };
+}
+
+function buildCleanMapValue(cleanRecords: Record<string, unknown>[], keyHeader: string, mapValuesAreObjects: boolean): Record<string, unknown> {
+  return Object.fromEntries(cleanRecords.map((record) => {
+    const key = String(record[keyHeader]);
+    if (mapValuesAreObjects) {
+      const nested = { ...record };
+      delete nested[keyHeader];
+      return [key, nested];
+    }
+    return [key, record.value ?? ''];
+  }));
+}
+
+interface ProcessRecordParams {
+  record: JsonRowRecord;
+  headers: string[];
+  keyHeader: string;
+  seenKeys: Set<string>;
+  issues: SanitizerIssue[];
+}
+
+function processJsonRecord(params: ProcessRecordParams): { values: string[]; key: string; cleanRecord: Record<string, unknown> } | null {
+  const { record, headers, keyHeader, seenKeys, issues } = params;
+  const values = headers.map((header) => textValue(record.source[header]));
+  const key = (values[0] ?? '').trim();
+
+  if (!key) {
+    issues.push(issue({ kind: 'empty', row: record.row, column: keyHeader, key: '', detail: 'empty_key' }));
+  }
+  values.forEach((value, columnIndex) => {
+    if (columnIndex !== 0 && value.trim() === '') {
+      issues.push(issue({ kind: 'empty', row: record.row, column: headers[columnIndex] ?? '', key, detail: 'empty_translation' }));
+    }
+  });
+
+  if (key && seenKeys.has(key)) {
+    issues.push(issue({ kind: 'duplicate', row: record.row, column: keyHeader, key, detail: 'duplicate_key' }));
+    return null;
+  }
+  if (!key) return null;
+
+  seenKeys.add(key);
+  const cleanRecord: Record<string, unknown> = {};
+  headers.forEach((header, columnIndex) => {
+    cleanRecord[header] = columnIndex === 0 ? key : record.source[header] ?? '';
+  });
+  return { values, key, cleanRecord };
+}
+
+function resolveJsonHeaders(records: JsonRowRecord[]): { headers: string[]; keyHeader: string } {
+  const sourceHeaders = Array.from(new Set(records.flatMap((record) => Object.keys(record.source))));
+  const keyHeader = sourceHeaders.find((header) => /^(key|id|identifier|loc[_-]?key)$/i.test(header)) || sourceHeaders[0] || 'key';
+  return { headers: [keyHeader, ...sourceHeaders.filter((header) => header !== keyHeader)], keyHeader };
+}
+
+export function sanitizeJson(source: string): SanitizerResult {
+  const parsedData = parseJsonRecords(source);
+  if (!parsedData) return emptyResult('json', 'invalid_json');
+  const { records, isMap, mapValuesAreObjects } = parsedData;
+  if (records.length === 0) return emptyResult('json', 'expected_array_or_object');
+
+  const { headers, keyHeader } = resolveJsonHeaders(records);
+  const issues: SanitizerIssue[] = [];
+  const rows: string[][] = [];
+  const seenKeys = new Set<string>();
+  const cleanRecords: Record<string, unknown>[] = [];
+
+  records.forEach((record) => {
+    const res = processJsonRecord({ record, headers, keyHeader, seenKeys, issues });
+    if (res) { rows.push(res.values); cleanRecords.push(res.cleanRecord); }
+  });
+
+  return {
+    format: 'json', valid: true, headers, rows,
+    cleanText: JSON.stringify(isMap ? buildCleanMapValue(cleanRecords, keyHeader, mapValuesAreObjects) : cleanRecords, null, 2),
+    issues,
+    stats: {
+      totalRows: records.length, cleanRows: rows.length,
+      emptyCells: issues.filter((item) => item.kind === 'empty').length,
+      duplicateKeys: issues.filter((item) => item.kind === 'duplicate').length,
+      malformedRows: 0,
+    },
+  };
+}