AskaEth
ce2c42032b
复审 p1：`detect_env()` 在 Windows 上恒为 `en`（`LC_ALL/LC_MESSAGES/LANG` 都不存在）， D28 整条中文链（探测 → 扫 CJK → 需下载）在基线平台永不触发。复审在本机（zh-CN）实测 `lang=en raw=None`，这条我认。 **p1 修法（tower 定路线：子进程读注册表，不碰 FFI、不加依赖）** - 新增 `crates/app-iced/src/platform/locale.rs`：`SystemLocale` 实现 `unlucky_i18n::lang::LocaleSource`，内部 `reg.exe query "HKCU\Control Panel\International" /v LocaleName`（本机实测 `REG_SZ zh-CN`），读不到时退 `/v Locale` 的十六进制 LCID （本机 `00000804`），用一张 20 条的短表翻成标签，表外语言返回 `None`（宁可英文，不猜语种）。 先例同 M73 壁纸探测（`core::platform::wallpaper` 的 `reg.exe` 路线）。 - 子进程走注入的 `RegIo` 接口，单测用 `FakeReg`（不 spawn）；夹具是**本机真机抓的原文** （含 CRLF / 前导空白），另有一条 `#[cfg(windows)]` 真机测试证明 `reg.exe` 这条路真的通。 - i18n 仍是纯函数：`lang::resolve(setting, platform, env)` 是四级优先级的唯一实现—— **`ui.language` 显式值 > 平台源 > POSIX 环境变量 > 英文**，`Detection` 新增 `origin` （`setting` / 源自报的 `label()` / `env` / `default`），启动日志因此能写清 `source=registry`。 配置值不认识时**跳过**继续往下走，不当成任何一种语言。 - `fonts::cjk::probe_with(setting, faces)` 把 `ui.language` 那一级的位置先留好（目前传 `None`： 设置层还没有读取点，写在模块文档的诚实边界里）；`probe()` 走全链。 - `platform::mod` 的模块表补一行说明 locale 也是「零 unsafe」那一类。 **本机（zh-CN）实跑证据**（`--software-renderer --screenshot …`，exit 0）： `[font] … | lang=zh-CN locale=zh-CN source=registry cjk=system:"Microsoft YaHei UI"` ——探测出中文、且走的是「扫 CJK 字体」而不是 `not-needed`。 **p2**：删掉 `catalog` 那条 `compile_fail` 守卫（复审两个变异仍全绿 ⇒ 它守的是「这段代码 编译不过」，不是「编译期校验还在」）。改为陈述事实：「`Key` 是枚举，拼错 `E0599`」， 并写明这里**没有**守卫测试及原因。 未动 `ui.language` 默认值（`core` schema 不在本 mission scope，tower 已另记）。
43 lines
2.7 KiB
Rust
43 lines
2.7 KiB
Rust
//! # unlucky-i18n · 国际化地基（D28）
|
||
//!
|
||
//! 本 crate 只做**地基**，不接任何页面：语言探测、两套消息目录、缺译诊断、中文字体策略、
|
||
//! 以及「core 的中文状态串怎么进 UI」的契约。页面侧接线的 mission 用它，而不是各自硬编码英文
|
||
//! （先硬编码再全量重写就是本 crate 要避免的那条路）。
|
||
//!
|
||
//! | 模块 | 职责 | 不负责 |
|
||
//! |---|---|---|
|
||
//! | [`lang`] | `Lang`（en / zh-CN）+ locale 探测（源可注入）+ **四级优先级** [`lang::resolve`] | 读注册表 / 读配置 / spawn 进程 |
|
||
//! | [`catalog`] | `Key` 枚举 + 中英两套常量表 + 取词 / 占位符渲染 + 缺译诊断 | 排版、字号、断行 |
|
||
//! | [`font`] | 中文环境扫系统 CJK 字体的**判据** + 缺字体时的「需下载」信号 + 注入式下载器接口 | 联网、写文件、装字体 |
|
||
//! | [`bridge`] | core / presenter 的状态串 → `Key` 的**示例契约**（文案边界规则全文在这里） | 改 core 的产出 |
|
||
//!
|
||
//! 语言从哪来的优先级写在 [`lang::resolve`]：**`ui.language` 显式值 > 平台源 > POSIX 环境变量 > 英文**。
|
||
//! 平台源（Windows 上 `reg.exe` 读注册表，零 FFI）在 UI 壳层实现并注入——本 crate 不认平台。
|
||
//!
|
||
//! ## 三条硬规矩（细则见 [`bridge`]）
|
||
//!
|
||
//! 1. **一句话 = 一个 key**。UI 侧不得把片段拼成一句话，尤其不得拼中文：
|
||
//! `"Launch failed · exit0 静默失败"` 这种混排就是拼接的后果。带变量的句子用 `{name}` 占位符，
|
||
//! 由 [`catalog::Catalog::render`] 统一替换。
|
||
//! 2. **core 的中文串不是文案**。core / presenter 里的中文状态串（`原版` / `静默失败（…）`）只用于
|
||
//! 日志与 CLI；UI 要么走结构化出口（枚举）映射到 key，要么走 [`bridge::key_of_legacy_status`] 的
|
||
//! 过渡表。**任何情况下都不许把未知中文串直接画到界面上。**
|
||
//! 3. **英文环境零中文负担**（D28 原话）：`Lang::En` 下不要求任何中文字体、不触发任何下载；
|
||
//! 判据在 [`font::decide`]，是纯函数，可脱机单测。
|
||
//!
|
||
//! ## 与别处的关系
|
||
//!
|
||
//! - **不依赖 iced / slint / presenter / core**：`cargo tree -p unlucky-i18n --edges normal` 只应打印它自己。
|
||
//! 系统字体扫描由 UI 壳层做（iced 版在 `crates/app-iced/src/fonts/cjk.rs`），扫出来的族名喂给
|
||
//! [`font::decide`]；
|
||
//! - 配置里的 `ui.language` 允许值 `zh_cn` / `en_us`（见 `core::setting::keys::LANGUAGES`）与
|
||
//! [`lang::Lang::setting_value`] 必须是同一份词表，由 [`lang`] 的 pin 测试守门。
|
||
|
||
pub mod bridge;
|
||
pub mod catalog;
|
||
pub mod font;
|
||
pub mod lang;
|
||
|
||
pub use catalog::{Catalog, Key};
|
||
pub use lang::Lang;
|