# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ハンドラー名
============
lang - 多言語対応と翻訳管理

説明
============
LANG ハンドラーは、BACH の多言語コンテンツを管理します。彼はコードをスキャンします
ドイツ語の文字列、翻訳の実行、欠落している文字列の検証
119 のドイツ語用語を含む基本辞書を翻訳および管理します。
SQLite データベース (bach.db) とテーブルを使用します: language_config、
言語翻訳、言語辞書。

操作
===========
  ステータス 言語設定と統計の表示
  scan ドイツ語文字列のコード ディレクトリを検索します。
  scan --namespace 特定の領域 (cli、gui、ヘルプ、スキル) のみをスキャンします。
  リスト すべての翻訳を表示
  list --lang <code> 特定の言語のみ (例: de/en/es/ru/ja/zh)
  missing 翻訳がありません (デフォルト: en なしの de)
  missing --target es スペイン語の翻訳がありません
  翻訳 自動翻訳を開始します（辞書に基づいて）
  translation --target en ターゲット言語の自動翻訳
  add <key> 手動で翻訳を追加します (--de、--en、--es ... または --lang/--text)
  add- language <code> 新しい言語を登録します (例: fr、es、pt)
  エクスポート LLM レビュー用にエクスポート (JSON 形式、標準: de -> en)
  export --target zh 中国への輸出の場合
  import <file> LLM レビュー ファイルをインポートして統合する
  set <lang> デフォルト言語を設定します (例: de/en/es/ru/ja/zh)
  dict status 辞書のステータスを表示します。
  dict init 基本辞書 (119 用語) を読み込みます。
  dict add <src> <dst> [--source-lang de --target-lang es]
  dict search <term> 辞書内の用語を検索

例
=========
# 言語ステータスを表示
  bach lang status

# ドイツ語テキストのコードを検索
  bach lang scan
  bach lang scan --namespace cli

# 不足している翻訳を特定
  bach lang missing
  bach lang missing --target es

# 手動で翻訳
  bach lang add "speichern" --de "Speichern" --en "Save"
  bach lang add "speichern" --es "Guardar" --ru "Sohranit"

# LLM レビューを準備
  bach lang export
  bach lang export --target zh
  [... LLM 編集ファイル ...]
  bach lang import export.json

# 新しい言語を追加 (フランス語)
  bach lang add-language fr

# デフォルト言語を英語に設定
  bach lang set en
  bach lang set ja

# 辞書ベースをロード (119 エントリ)
  bach lang dict init

ファイル
=======
実装: Hub/lang.py (LangHandler クラス)
データベース: data/bach.db (SQLite)
  - language_config テーブル: デフォルト言語、フォールバック、自動翻訳フラグ
  - テーブル language_translations: メタデータ付きのすべての翻訳
  - テーブル language_dictionary : 基本辞書 (119 用語)
エクスポート形式: JSON (翻訳 + メタデータ、LLM ツールと互換性あり)
リリース アーティファクト: system/exports/translations/ (マニフェスト、ロケール ファイル、シード SQL)

関連項目
==========
  bach cli        - コマンド ライン インターフェイス
  bach backup     - データベース バックアップ (変換を bach.db に書き込む)
  bach help       - すべてのハンドラーのヘルプ システム
