feat: add glossary presets and init CLI

Author: hackycy

packages/i18n-migrate-cli/README.md

@@ -22,6 +22,9 @@ pnpm exec tmigrate --help
 # 1. 初始化 .tmigrate 配置目录
 pnpm exec tmigrate init
 
+# 1.5. 可选：初始化内置高频词库，减少机器翻译误译
+pnpm exec tmigrate glossary init --preset all
+
 # 2. 扫描源码并生成 .tmigrate/maps 分片映射
 pnpm exec tmigrate scan src --to en
 
@@ -93,6 +96,28 @@ tmigrate scan src --incremental --clean-deprecated
 | `--incremental` | 只扫描 hash 发生变化的文件 |
 | `--clean-deprecated` | 清理已废弃条目 |
 
+### `glossary init`
+
+把内置高频词库合并到 `.tmigrate/glossary.json`。默认使用项目配置里的 `sourceLocale` / `targetLocale`，目前内置支持 `zh -> en` 和 `en -> zh`。
+
+```bash
+tmigrate glossary init
+tmigrate glossary init --preset business
+tmigrate glossary init --preset all --dry-run
+tmigrate glossary init --from en --to zh --preset ui
+tmigrate glossary init --preset all --overwrite
+```
+
+常用选项：
+
+| 选项 | 说明 |
+|---|---|
+| `--preset <name>` | 内置词库：`ui`、`business`、`all`，默认 `ui` |
+| `--from <locale>` | 覆盖源语言，如 `zh`、`en` |
+| `--to <locale>` | 覆盖目标语言，如 `en`、`zh` |
+| `--dry-run` | 只预览新增/更新/跳过数量，不写入文件 |
+| `--overwrite` | 覆盖已有冲突词条；默认保留现有人工词条 |
+
 ### `apply`
 
 把映射文件中已确认的译文回写到源文件。
@@ -372,11 +397,13 @@ API 请求体格式：
 ```ts
 import {
   applyTranslations,
+  initGlossary,
   initProject,
   scanProject,
 } from '@translation-master/i18n-migrate-cli'
 
 await initProject({ cwd: process.cwd(), from: 'zh', to: 'en', overwrite: false })
+await initGlossary({ cwd: process.cwd(), preset: 'all' })
 
 await scanProject({
   cwd: process.cwd(),
@@ -391,6 +418,7 @@ await applyTranslations({ cwd: process.cwd(), dryRun: true })
 | 导出 | 说明 |
 |---|---|
 | `initProject()` | 初始化 `.tmigrate` |
+| `initGlossary()` | 合并内置词库到 `.tmigrate/glossary.json` |
 | `scanProject()` | 扫描源码并生成 map |
 | `applyTranslations()` | 回写已确认译文 |
 | `restoreBackups()` | 从备份恢复 |

packages/i18n-migrate-cli/src/__tests__/workflow.test.ts

@@ -3,7 +3,7 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
 import { afterEach, describe, expect, it } from 'vitest'
-import { applyTranslations, approveTranslations, initProject, restoreBackups, scanProject } from '../index'
+import { applyTranslations, approveTranslations, initGlossary, initProject, restoreBackups, scanProject } from '../index'
 import { collectMapStats, formatMapStatsReport } from '../stats'
 
 const tempDirs: string[] = []
@@ -153,6 +153,42 @@ describe('i18n migrate workflow', () => {
     expect(overriddenAppMap.entries['旧文案']?.approved).toBe(true)
   })
 
+  it('seeds glossary presets without clobbering existing manual terms by default', async () => {
+    const cwd = await createTempProject()
+    await initProject({ cwd, overwrite: false, from: 'zh', to: 'en' })
+    const glossaryPath = path.join(cwd, '.tmigrate', 'glossary.json')
+    await writeFile(glossaryPath, JSON.stringify({ 提交: 'Send', 自定义: 'Custom' }, null, 2), 'utf8')
+
+    const preview = await initGlossary({ cwd, preset: 'business', dryRun: true })
+    expect(preview.entries.订单).toBe('Order')
+    expect(JSON.parse(await readFile(glossaryPath, 'utf8')).订单).toBeUndefined()
+
+    const seeded = await initGlossary({ cwd, preset: 'all' })
+    expect(seeded.added).toBeGreaterThan(0)
+    expect(seeded.skipped).toBe(1)
+    expect(seeded.entries.提交).toBe('Send')
+    expect(seeded.entries.自定义).toBe('Custom')
+
+    const saved = JSON.parse(await readFile(glossaryPath, 'utf8')) as Record<string, string>
+    expect(saved.订单).toBe('Order')
+    expect(saved.提交).toBe('Send')
+
+    const overwritten = await initGlossary({ cwd, preset: 'ui', overwrite: true })
+    expect(overwritten.updated).toBe(1)
+    expect(overwritten.entries.提交).toBe('Submit')
+  })
+
+  it('supports English to Chinese glossary presets from project config', async () => {
+    const cwd = await createTempProject()
+    await initProject({ cwd, overwrite: false, from: 'en', to: 'zh' })
+
+    const seeded = await initGlossary({ cwd, preset: 'ui' })
+    expect(seeded.sourceLocale).toBe('en')
+    expect(seeded.targetLocale).toBe('zh')
+    expect(seeded.entries.Submit).toBe('提交')
+    expect(seeded.entries.Search).toBe('搜索')
+  })
+
   it('summarizes map progress and flags orphaned files', async () => {
     const cwd = await createTempProject()
     const appPath = path.join(cwd, 'src', 'App.vue')

packages/i18n-migrate-cli/src/cli.ts

@@ -1,9 +1,11 @@
 import type { ScanProgressEvent, WorkflowProgressEvent } from './types'
+import path from 'node:path'
 import process from 'node:process'
 import { Command } from 'commander'
 import pc from 'picocolors'
 import { applyTranslations, restoreBackups } from './apply'
 import { approveTranslations } from './approve'
+import { initGlossary } from './glossary'
 import { initProject } from './init'
 import { createSpinner } from './prompts'
 import { scanProject } from './scanner'
@@ -97,6 +99,39 @@ export function createCli(options: CreateCliOptions): Command {
       console.log(formatMapStatsReport(report))
     })
 
+  const glossary = program
+    .command('glossary')
+    .description('Manage .tmigrate/glossary.json.')
+
+  glossary
+    .command('init')
+    .description('Seed .tmigrate/glossary.json with built-in terminology presets.')
+    .option('--preset <name>', 'preset glossary: ui, business, all', 'ui')
+    .option('--from <locale>', 'source locale')
+    .option('--to <locale>', 'target locale')
+    .option('--overwrite', 'overwrite conflicting existing glossary entries')
+    .option('--dry-run', 'preview changes without writing glossary.json')
+    .action(async (command: {
+      preset?: string
+      from?: string
+      to?: string
+      overwrite?: boolean
+      dryRun?: boolean
+    }) => {
+      const result = await initGlossary({
+        preset: command.preset,
+        from: command.from,
+        to: command.to,
+        overwrite: command.overwrite,
+        dryRun: command.dryRun,
+      })
+      const verb = result.dryRun ? 'Would seed' : 'Seeded'
+      console.log(pc.green(`${verb} ${pathRelativeToCwd(result.glossaryPath)} using ${result.preset} (${result.sourceLocale}->${result.targetLocale}).`))
+      console.log(pc.dim(`Added ${result.added}, updated ${result.updated}, unchanged ${result.unchanged}, skipped ${result.skipped}.`))
+      if (result.skipped > 0 && !command.overwrite)
+        console.log(pc.dim('Use --overwrite to replace conflicting existing entries.'))
+    })
+
   program
     .command('apply')
     .description('Apply approved translations back to source files.')
@@ -303,3 +338,7 @@ function formatModelLoadMessage(
   const fileProgress = currentFileTotal > 0 ? ` (${currentFileIndex}/${currentFileTotal})` : ''
   return `${filePrefix}${fileProgress} · loading local model`
 }
+
+function pathRelativeToCwd(filePath: string): string {
+  return path.relative(process.cwd(), filePath) || filePath
+}