oh-my-knowledge 0.20.1 → 0.22.0

package/dist/src/cli/i18n-dict.d.ts

@@ -0,0 +1,56 @@
+/**
+ * CLI 文案字典。
+ *
+ * 命名约定: `cli.<command>.<event>` 或 `cli.common.<event>`。
+ * 占位符用 `{name}` 形式,在 tCli(params) 处替换。
+ *
+ * ============================================================================
+ * 翻译守则 (受 cc-viewer i18n 方案启发)
+ * ============================================================================
+ *
+ * 1. **彻底本地化, 不接受中英混搭**
+ *    "中文用户读到的中文"和"英文用户读到的英文"必须是各自语言里自然的表达,
+ *    不能机械翻译, 不能在中文里塞英文短语解释术语。如果某个英文短语没有
+ *    自然的中文译法, 重新组织句子结构, 而不是混着写。
+ *
+ * 2. **保留原文的白名单 (产品术语 / 命令 / 文件名)**
+ *    以下 token 在两种语言里都保留原文, 不翻译:
+ *    - 产品名: omk, oh-my-knowledge, Claude, npm
+ *    - 子命令空间和命令名: bench, analyze, run, report, init, evolve, gold,
+ *      diff, ci, gen-samples, debias-validate, saturation, verdict,
+ *      diagnose, failures
+ *    - omk 核心业务术语: skill, variant, sample, judge, executor (出现在产品
+ *      UI 里时首字母可大写如 "Skill 评测", 描述句中保持小写)
+ *    - 技术参数: --lang, --control, --treatment, --bootstrap, --judge-repeat,
+ *      OMK_LANG, JUDGE_PROMPT_VERSION_*
+ *    - 文件名 / 路径: eval-samples.json, skills/v1.md, ~/.oh-my-knowledge/...
+ *    - 数学概念缩写: CI, α, RAG (其译法可在配套描述里说明, 但术语本身留原文)
+ *
+ * 3. **必须翻译的内容**
+ *    动作 (run / edit / scaffold / generate), 状态 (success / failed /
+ *    invalid), 引导文案 (next steps / try this / see also), 解释性描述。
+ *
+ * 4. **不要机械直译**
+ *    "Next steps:" 译 "下一步:" 而不是 "下一步骤:"。
+ *    "Run: ..." 译 "运行: ..." 而不是 "跑: ..."。
+ *    选用 omk 项目长期使用的中文措辞 (LLM judge 译"评委" 不译"判官", 见
+ *    feedback_ui_translation.md)。
+ *
+ * 5. **新增 key 流程**
+ *    a. 加到 CliMessageKey union 类型里
+ *    b. 在 CLI_DICT 里同时给出 zh / en (Record 类型强制 zh/en 双写, 漏写
+ *       tsc 直接报错)
+ *    c. 自查: 中文里有没有非白名单的英文? 英文里有没有中文?
+ *    d. 自查: 措辞自然度 — 把中文版念出来, 像不像中文项目的命令行输出?
+ *    e. test/cli-i18n.test.ts 会跑 runtime parity 检查
+ *
+ * 未来扩 Lang (zh-TW / ja / ko ...): 改 src/types/shared.ts 的 Lang union,
+ * Record 类型自动强制每 key 加新语言版本。
+ */
+export type CliMessageKey = 'cli.common.lang_invalid_silent' | 'cli.common.help_hint' | 'cli.common.unknown_domain' | 'cli.common.unknown_bench_command' | 'cli.init.scaffolded' | 'cli.init.next_steps_title' | 'cli.init.next_step_edit_samples' | 'cli.init.next_step_edit_skills' | 'cli.init.next_step_run' | 'cli.update.new_version_available' | 'cli.progress.preflight_starting' | 'cli.progress.sample_retry' | 'cli.progress.sample_error' | 'cli.progress.sample_executing' | 'cli.progress.sample_exec_done' | 'cli.progress.output_preview' | 'cli.progress.judging' | 'cli.progress.judged' | 'cli.progress.skipped' | 'cli.progress.sample_done' | 'cli.run.invalid_repeat' | 'cli.run.invalid_judge_repeat' | 'cli.run.invalid_judge_models_format' | 'cli.run.judge_models_single_warning' | 'cli.run.no_debias_length_active' | 'cli.run.invalid_bootstrap_samples' | 'cli.run.bootstrap_samples_too_large' | 'cli.run.skill_section' | 'cli.run.run_section' | 'cli.run.batch_complete' | 'cli.run.eval_complete' | 'cli.run.report_saved' | 'cli.run.report_server_running' | 'cli.run.report_server_view' | 'cli.run.report_server_stop' | 'cli.run.no_serve_in_non_tty' | 'cli.run.no_serve_view_hint' | 'cli.run.gold_load_failed' | 'cli.run.gold_load_issue' | 'cli.run.contamination_warning' | 'cli.common.error_prefix' | 'cli.analyze.view_in_browser' | 'cli.common.skill_dir_not_found' | 'cli.common.skill_file_not_found' | 'cli.common.report_not_found' | 'cli.common.no_judge_model' | 'cli.common.usage_gold_validate' | 'cli.common.warn_load_samples_failed' | 'cli.gen.skill_skipped_existing' | 'cli.gen.skill_generating' | 'cli.gen.skill_done' | 'cli.gen.skill_failed' | 'cli.gen.batch_none_needed' | 'cli.gen.batch_summary' | 'cli.gen.specify_skill_path' | 'cli.gen.samples_already_exists' | 'cli.gen.single_generating' | 'cli.gen.single_done' | 'cli.gen.review_hint' | 'cli.gen.failed' | 'cli.evolve.specify_skill_path' | 'cli.evolve.section_header' | 'cli.evolve.round_baseline' | 'cli.evolve.round_error' | 'cli.evolve.round_done' | 'cli.evolve.summary' | 'cli.evolve.best_path' | 'cli.evolve.versions_saved' | 'cli.evolve.report_link' | 'cli.gold.created_files' | 'cli.gold.next_step_edit_annotations' | 'cli.gold.validate_ok' | 'cli.debias.warn_cost_doubles' | 'cli.saturation.no_data' | 'cli.saturation.verdict_header' | 'cli.saturation.variant_no_trace' | 'cli.saturation.variant_label' | 'cli.saturation.checkpoints' | 'cli.saturation.last_point' | 'cli.saturation.persisted_verdict' | 'cli.saturation.persisted_verdict_saturated' | 'cli.saturation.persisted_verdict_unsaturated' | 'cli.saturation.skipped_too_few_points' | 'cli.help.main' | 'cli.help.diff_usage' | 'cli.help.analyze_usage' | 'cli.help.gold' | 'cli.help.debias_validate' | 'cli.help.saturation' | 'cli.help.verdict' | 'cli.help.diagnose' | 'cli.help.failures';
+export interface CliMessage {
+    zh: string;
+    en: string;
+}
+export declare const CLI_DICT: Record<CliMessageKey, CliMessage>;
+//# sourceMappingURL=i18n-dict.d.ts.map

package/dist/src/cli/i18n-dict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-dict.d.ts","sourceRoot":"","sources":["../../../src/cli/i18n-dict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,MAAM,MAAM,aAAa,GAErB,gCAAgC,GAChC,sBAAsB,GACtB,2BAA2B,GAC3B,kCAAkC,GAElC,qBAAqB,GACrB,2BAA2B,GAC3B,iCAAiC,GACjC,gCAAgC,GAChC,wBAAwB,GAExB,kCAAkC,GAElC,iCAAiC,GACjC,2BAA2B,GAC3B,2BAA2B,GAC3B,+BAA+B,GAC/B,+BAA+B,GAC/B,6BAA6B,GAC7B,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,0BAA0B,GAE1B,wBAAwB,GACxB,8BAA8B,GAC9B,qCAAqC,GACrC,qCAAqC,GACrC,iCAAiC,GACjC,mCAAmC,GACnC,qCAAqC,GAErC,uBAAuB,GACvB,qBAAqB,GACrB,wBAAwB,GACxB,uBAAuB,GACvB,sBAAsB,GACtB,+BAA+B,GAC/B,4BAA4B,GAC5B,4BAA4B,GAC5B,6BAA6B,GAC7B,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,GACzB,+BAA+B,GAC/B,yBAAyB,GAEzB,6BAA6B,GAE7B,gCAAgC,GAChC,iCAAiC,GACjC,6BAA6B,GAC7B,2BAA2B,GAC3B,gCAAgC,GAChC,qCAAqC,GAErC,gCAAgC,GAChC,0BAA0B,GAC1B,oBAAoB,GACpB,sBAAsB,GACtB,2BAA2B,GAC3B,uBAAuB,GACvB,4BAA4B,GAC5B,gCAAgC,GAChC,2BAA2B,GAC3B,qBAAqB,GACrB,qBAAqB,GACrB,gBAAgB,GAEhB,+BAA+B,GAC/B,2BAA2B,GAC3B,2BAA2B,GAC3B,wBAAwB,GACxB,uBAAuB,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,2BAA2B,GAC3B,wBAAwB,GAExB,wBAAwB,GACxB,qCAAqC,GACrC,sBAAsB,GAEtB,8BAA8B,GAE9B,wBAAwB,GACxB,+BAA+B,GAC/B,iCAAiC,GACjC,8BAA8B,GAC9B,4BAA4B,GAC5B,2BAA2B,GAC3B,kCAAkC,GAClC,4CAA4C,GAC5C,8CAA8C,GAC9C,uCAAuC,GAEvC,eAAe,GACf,qBAAqB,GACrB,wBAAwB,GACxB,eAAe,GACf,0BAA0B,GAC1B,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,aAAa,EAAE,UAAU,CAm3BtD,CAAC"}