refactor(i18n): 迁移到 rust-i18n 语义键体系（ns.key），废弃中文原文作 key
旧实现的问题（按用户反馈）：
- 中文原文作 key：文案措辞与代码耦合，一词多义撞 key（"主题" Topic/Theme）
- 巨型 match 文案表：重复键靠编译警告暴露；漏翻静默回退，无任何校验
- tf 参数到处 &n.to_string() 噪音
新体系（gpui-kit 官方方案）：
- locales/ui.yml 语言包（rust-i18n v2，en/zh-CN 双语并排），key 为
语义标识符（common.save / conn.connect / status.connected…），
与自然语言彻底解耦；改措辞不动代码
- crate 根 i18n! 编译期内嵌；init_i18n() 经 extend! 并入 gpui-kit
组件内置文案（按钮/空态等随语言切换）
- t/tf 薄门面查 _rust_i18n_translate（运行时 key），模型 label()
改返回语义 key；tf 参数只需 Display
- 四个强制单测：语言包 en/zh-CN 完整、占位符 {x} 两侧一致、
全源码 t()/tf() 字面量必须存在词条、模型 label 必须有真实译文
- 语言中性文案（"QoS"、"/mqtt" 等）去掉 t() 包裹
- 顺带补翻 30 条漏网文案（资源监控统计行/表单校验/阿里云说明段等）
42 测试全绿；中英双语实机截图验证零裸 key。
This commit is contained in:
+261
-376
@@ -1,12 +1,29 @@
|
||||
//! 极简 i18n：以中文原文为 key 的双语文案表。
|
||||
//! i18n 门面：语义键（`ns.key`）+ rust-i18n（gpui-kit 官方方案）。
|
||||
//!
|
||||
//! 设计取舍：
|
||||
//! - 中文是基准语言，`t("订阅")` 直接返回原文，代码里不引入间接 key，
|
||||
//! 漏翻时回落中文而不是出现裸 key；
|
||||
//! - 英文表集中在本文件一个 `match`，新增文案先写中文、补翻英文即可；
|
||||
//! - 带参数的文案用 [`tf`]，占位符 `{name}` 在中英模式中同名替换；
|
||||
//! - 语言是进程级全局（UI 渲染热路径每帧取用，用原子量免锁）。
|
||||
//! # 架构
|
||||
//! - 语言包在 `locales/ui.yml`（en / zh-CN 双语并排，`_version: 2`），
|
||||
//! 由 crate 根的 `rust_i18n::i18n!("locales", fallback = "en")` 编译期内嵌；
|
||||
//! gpui-kit 组件内置文案经 main.rs 的 `rust_i18n::extend!` 随语言切换。
|
||||
//! - 调用点写 `t("common.save")` / `tf("msg.count", &[("n", &count)])`，
|
||||
//! key 是**稳定标识符**，与任何自然语言解耦——改文案措辞不动代码，
|
||||
//! 也不存在「一词多义撞 key」。
|
||||
//! - [`t`]/[`tf`] 直接查 [`crate::_rust_i18n_translate`]（rust-i18n 生成、
|
||||
//! 接受运行时 key 的公开函数），不经 `t!` 宏——`label()` 这类运行时
|
||||
//! 值同样可查。
|
||||
//!
|
||||
//! # 规则（单元测试强制，违反即测试失败）
|
||||
//! 1. 新增文案：调用点 `t("ns.key")`，`locales/ui.yml` 加 key 块（en/zh-CN 必填）。
|
||||
//! 2. 源码每个 `t("…")` / `tf("…")` 字面量必须在语言包中存在。
|
||||
//! 3. 模型 `label()` 返回的 key 必须有**非自映射**的 en 词条。
|
||||
//! 4. 同一 key 的 zh-CN 与 en 占位符 `{name}` 集合必须一致
|
||||
//! （`tf` 按名替换，两侧不一致即静默漏参）。
|
||||
//!
|
||||
//! # 已知限制
|
||||
//! 语言切换对**已打开页签里的下拉框**（QoS / Retain Handling 等）不即时生效——
|
||||
//! 这些 SelectState 在构造时固化了标签列表；重开页签即刷新。其余界面即时生效
|
||||
//! （save_settings 内 `window.refresh()` 兜底整窗重绘）。
|
||||
|
||||
use std::borrow::Cow;
|
||||
use std::sync::atomic::{AtomicU8, Ordering};
|
||||
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
@@ -15,11 +32,20 @@ pub enum Lang {
|
||||
En,
|
||||
}
|
||||
|
||||
/// 0 = 中文，1 = English。默认中文（基准语言）。
|
||||
const LOCALE_ZH: &str = "zh-CN";
|
||||
const LOCALE_EN: &str = "en";
|
||||
|
||||
/// 0 = 中文，1 = English。默认中文。
|
||||
static LANG: AtomicU8 = AtomicU8::new(0);
|
||||
|
||||
/// 切换语言：同时更新 rust-i18n 全局 locale（gpui-kit 组件内置文案随之切换）。
|
||||
/// 已渲染界面的刷新由调用方负责（settings 保存路径带整窗 refresh）。
|
||||
pub fn set_lang(lang: Lang) {
|
||||
LANG.store(lang as u8, Ordering::Relaxed);
|
||||
gpui_kit::component::set_locale(match lang {
|
||||
Lang::Zh => LOCALE_ZH,
|
||||
Lang::En => LOCALE_EN,
|
||||
});
|
||||
}
|
||||
|
||||
pub fn lang() -> Lang {
|
||||
@@ -38,394 +64,253 @@ pub fn from_system() -> Lang {
|
||||
}
|
||||
}
|
||||
|
||||
/// 取当前语言的界面文案。中文原文即 key，英文缺失时回退中文。
|
||||
pub fn t(zh: &'static str) -> &'static str {
|
||||
if lang() == Lang::Zh {
|
||||
return zh;
|
||||
}
|
||||
en(zh)
|
||||
/// 查指定 locale 的词条。
|
||||
fn translate<'k>(locale: &str, key: &'k str) -> Cow<'k, str> {
|
||||
crate::_rust_i18n_translate(locale, key)
|
||||
}
|
||||
|
||||
/// 带参数的界面文案：中英模式均为 `{name}` 占位符，按同名替换。
|
||||
pub fn tf(zh: &'static str, args: &[(&str, &str)]) -> String {
|
||||
let pattern = if lang() == Lang::Zh {
|
||||
zh.to_string()
|
||||
} else {
|
||||
en(zh).to_string()
|
||||
/// 取当前语言的界面文案。miss 时 rust-i18n 原样返回 key（测试会拦截，
|
||||
/// 运行期裸 key 只是最后的安全网）。
|
||||
pub fn t(key: &'static str) -> &'static str {
|
||||
let locale = match lang() {
|
||||
Lang::Zh => LOCALE_ZH,
|
||||
Lang::En => LOCALE_EN,
|
||||
};
|
||||
let mut out = pattern;
|
||||
match translate(locale, key) {
|
||||
// 无参查表只返回 Borrowed（静态表值或原 key）；Owned 视为异常回退 key
|
||||
Cow::Borrowed(s) => s,
|
||||
Cow::Owned(_) => key,
|
||||
}
|
||||
}
|
||||
|
||||
/// 带参数的界面文案：语言包内占位符写作 `{name}`（非 rust-i18n 的 `%{name}`，
|
||||
/// 由本函数按名替换），参数值只需 `Display`。
|
||||
pub fn tf(key: &'static str, args: &[(&str, &dyn std::fmt::Display)]) -> String {
|
||||
let mut out = t(key).to_string();
|
||||
for (name, value) in args {
|
||||
out = out.replace(&format!("{{{name}}}"), value);
|
||||
out = out.replace(&format!("{{{name}}}"), &value.to_string());
|
||||
}
|
||||
out
|
||||
}
|
||||
|
||||
/// 英文文案表。key = 中文原文（与调用处字面量一一对应）。
|
||||
fn en(zh: &'static str) -> &'static str {
|
||||
match zh {
|
||||
// ── 通用 ──
|
||||
"保存" => "Save",
|
||||
"取消" => "Cancel",
|
||||
"删除" => "Delete",
|
||||
"确定" => "OK",
|
||||
"全部" => "All",
|
||||
"清空" => "Clear",
|
||||
"发送" => "Send",
|
||||
"连接" => "Connect",
|
||||
"断开" => "Disconnect",
|
||||
"订阅" => "Subscriptions",
|
||||
"编辑" => "Edit",
|
||||
"高级" => "Advanced",
|
||||
"错误" => "Error",
|
||||
"未连接" => "Disconnected",
|
||||
"连接中" => "Connecting",
|
||||
"连接中…" => "Connecting…",
|
||||
"已连接" => "Connected",
|
||||
"暂停" => "Pause",
|
||||
"恢复" => "Resume",
|
||||
"恢复实时滚动" => "Resume live scrolling",
|
||||
"暂停消息流滚动（消息仍在后台接收）" => {
|
||||
"Pause message stream (messages keep arriving in background)"
|
||||
}
|
||||
"MQTT 调试客户端" => "MQTT debug client",
|
||||
"新建连接" => "New Connection",
|
||||
// ─── 单元测试：语言包完整性由测试强制，而不是靠人工纪律 ──────────────────────
|
||||
|
||||
// ── 标题栏 ──
|
||||
"置顶窗口" => "Pin window on top",
|
||||
"取消窗口置顶" => "Unpin window",
|
||||
"置顶操作失败" => "Failed to set always-on-top",
|
||||
"切换为浅色" => "Switch to light theme",
|
||||
"切换为深色" => "Switch to dark theme",
|
||||
"阿里云设备" => "Alibaba Cloud Devices",
|
||||
"全局变量" => "Global Variables",
|
||||
"资源监控" => "Resource Monitor",
|
||||
"导出连接" => "Export Connections",
|
||||
"导入连接" => "Import Connections",
|
||||
"设置" => "Settings",
|
||||
/// 提取 `{name}` 形式的占位符（ASCII 标识符；`{{x}}` 双括号、`{$builtin}`
|
||||
/// 与中文花括号说明文不算），排序后比较集合。
|
||||
#[cfg(test)]
|
||||
fn placeholders(s: &str) -> Vec<String> {
|
||||
let b = s.as_bytes();
|
||||
let mut out = Vec::new();
|
||||
let mut i = 0;
|
||||
while i < b.len() {
|
||||
if b[i] == b'{' {
|
||||
let before_ok = i == 0 || b[i - 1] != b'{';
|
||||
let mut j = i + 1;
|
||||
while j < b.len() && (b[j].is_ascii_alphanumeric() || b[j] == b'_') {
|
||||
j += 1;
|
||||
}
|
||||
let after_ok = j < b.len() && b[j] == b'}' && (j + 1 == b.len() || b[j + 1] != b'}');
|
||||
let name = &s[i + 1..j];
|
||||
let name_ok = name
|
||||
.chars()
|
||||
.next()
|
||||
.is_some_and(|c| c.is_ascii_alphabetic() || c == '_');
|
||||
if before_ok && after_ok && name_ok {
|
||||
out.push(name.to_string());
|
||||
i = j + 1;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
i += 1;
|
||||
}
|
||||
out.sort();
|
||||
out
|
||||
}
|
||||
|
||||
// ── 侧边栏 ──
|
||||
"搜索连接…" => "Search connections…",
|
||||
"还没有连接，点击上方 + 新建" => "No connections yet. Click + above to create one",
|
||||
"没有匹配的连接" => "No matching connections",
|
||||
"收起侧栏（Ctrl+B）" => "Collapse sidebar (Ctrl+B)",
|
||||
"展开连接侧栏（Ctrl+B）" => "Expand sidebar (Ctrl+B)",
|
||||
"复制连接" => "Duplicate",
|
||||
"删除连接" => "Delete Connection",
|
||||
"未分组" => "Ungrouped",
|
||||
/// 解析生成器产出的规整 YAML（key 行 + 缩进的 en/zh-CN 值行）。
|
||||
/// 格式意外时 panic——语言包是构建产物，格式受控。
|
||||
#[cfg(test)]
|
||||
fn load_ui_yml() -> std::collections::BTreeMap<String, (String, String)> {
|
||||
let text = std::fs::read_to_string(
|
||||
std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("locales/ui.yml"),
|
||||
)
|
||||
.expect("locales/ui.yml 应存在");
|
||||
let unquote = |v: &str| -> String {
|
||||
let v = v.trim();
|
||||
let inner = v
|
||||
.strip_prefix('"')
|
||||
.and_then(|s| s.strip_suffix('"'))
|
||||
.unwrap_or(v);
|
||||
inner.replace("\\\"", "\"").replace("\\\\", "\\")
|
||||
};
|
||||
let mut map = std::collections::BTreeMap::new();
|
||||
let mut key: Option<String> = None;
|
||||
let mut en: Option<String> = None;
|
||||
let mut zh: Option<String> = None;
|
||||
for line in text.lines() {
|
||||
if line.starts_with('#') || line.starts_with("_version") || line.trim().is_empty() {
|
||||
continue;
|
||||
}
|
||||
if !line.starts_with(' ') {
|
||||
if let (Some(k), Some(e), Some(z)) = (key.take(), en.take(), zh.take()) {
|
||||
map.insert(k, (e, z));
|
||||
}
|
||||
key = Some(unquote(line.trim_end_matches(':')));
|
||||
} else if let Some(v) = line.trim().strip_prefix("en:") {
|
||||
en = Some(unquote(v));
|
||||
} else if let Some(v) = line.trim().strip_prefix("zh-CN:") {
|
||||
zh = Some(unquote(v));
|
||||
}
|
||||
}
|
||||
if let (Some(k), Some(e), Some(z)) = (key, en, zh) {
|
||||
map.insert(k, (e, z));
|
||||
}
|
||||
map
|
||||
}
|
||||
|
||||
// ── 主区 / 标签页 ──
|
||||
"开始使用 MQTTX" => "Get started with MQTTX",
|
||||
"从左侧选择一个连接，或新建连接开始调试" => {
|
||||
"Pick a connection on the left, or create a new one to start debugging"
|
||||
}
|
||||
"消息流" => "Messages",
|
||||
"日志" => "Logs",
|
||||
"关闭标签页（Ctrl+W）" => "Close tab (Ctrl+W)",
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
// ── 连接工作区 ──
|
||||
"收起侧栏" => "Collapse sidebar",
|
||||
"收起订阅面板" => "Collapse subscriptions panel",
|
||||
"展开订阅面板" => "Expand subscriptions panel",
|
||||
"订阅主题后，消息会显示在右侧" => "Subscribe to a topic and messages will show up here",
|
||||
"订阅颜色" => "Subscription color",
|
||||
"随机颜色" => "Random color",
|
||||
"清除颜色" => "Clear color",
|
||||
"停用订阅" => "Disable subscription",
|
||||
"启用订阅" => "Enable subscription",
|
||||
"编辑订阅" => "Edit subscription",
|
||||
"取消订阅" => "Unsubscribe",
|
||||
"订阅主题，支持 # +，多个用逗号/空格分隔" => {
|
||||
"Topic filter, supports # +; separate multiple with commas/spaces"
|
||||
/// 每个 key 都必须有非空 en 与 zh-CN；占位符两侧集合一致。
|
||||
#[test]
|
||||
fn yml_complete_and_placeholder_parity() {
|
||||
let map = load_ui_yml();
|
||||
assert!(!map.is_empty(), "语言包不能为空");
|
||||
for (k, (en, zh)) in &map {
|
||||
assert!(!en.trim().is_empty(), "en 为空: {k:?}");
|
||||
assert!(!zh.trim().is_empty(), "zh-CN 为空: {k:?}");
|
||||
assert_eq!(
|
||||
placeholders(zh),
|
||||
placeholders(en),
|
||||
"占位符两侧不一致: {k:?}"
|
||||
);
|
||||
}
|
||||
"别名（可选）" => "Alias (optional)",
|
||||
"订阅标识符" => "Subscription Identifier",
|
||||
"No Local" => "No Local",
|
||||
"Retain As Published" => "Retain As Published",
|
||||
"Retain Handling" => "Retain Handling",
|
||||
"0 每次发送" => "0 Send at every subscribe",
|
||||
"1 仅新订阅" => "1 Send only for new subscription",
|
||||
"2 不发送" => "2 Do not send",
|
||||
"正在编辑：{topic}" => "Editing: {topic}",
|
||||
"订阅主题不能为空" => "Topic filter cannot be empty",
|
||||
"订阅标识符须为正整数" => "Subscription identifier must be a positive integer",
|
||||
"未连接：订阅已保存，连接后自动恢复" => {
|
||||
"Offline: subscription saved, restored on connect"
|
||||
}
|
||||
"未连接：订阅已保存" => "Offline: subscription saved",
|
||||
"QoS 0" => "QoS 0",
|
||||
"QoS 1" => "QoS 1",
|
||||
"QoS 2" => "QoS 2",
|
||||
"更新" => "Update",
|
||||
}
|
||||
|
||||
// ── 消息流 ──
|
||||
"过滤主题或内容…" => "Filter by topic or content…",
|
||||
"{n} 条" => "{n} msgs",
|
||||
"仅显示最新 {n} 条" => "Showing latest {n} only",
|
||||
"清空当前连接的消息" => "Clear messages of this connection",
|
||||
"清空消息" => "Clear Messages",
|
||||
"确定清空当前连接的全部消息吗？此操作不可撤销。" => {
|
||||
"Clear all messages of this connection? This cannot be undone."
|
||||
/// 扫描 src/ 全部源码里的 `t("…")` / `tf("…")` 字面量，
|
||||
/// 逐一断言语言包有词条——漏翻是测试失败，不再是静默回退。
|
||||
#[test]
|
||||
fn call_sites_covered_by_yml() {
|
||||
let map = load_ui_yml();
|
||||
let root = std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("src");
|
||||
let mut files = Vec::new();
|
||||
collect_rs(&root, &mut files);
|
||||
assert!(!files.is_empty(), "应扫描到源码文件");
|
||||
let mut missing = Vec::new();
|
||||
for f in files {
|
||||
if f.ends_with("i18n.rs") {
|
||||
continue;
|
||||
}
|
||||
let src = std::fs::read_to_string(&f).unwrap();
|
||||
for key in extract_t_literals(&src) {
|
||||
if !map.contains_key(&key) {
|
||||
missing.push(format!("{}: {key:?}", f.display()));
|
||||
}
|
||||
}
|
||||
}
|
||||
"接收" => "Received",
|
||||
"发布" => "Published",
|
||||
"没有匹配的消息" => "No matching messages",
|
||||
"暂无消息，订阅主题后消息会显示在这里" => {
|
||||
"No messages yet — they will appear here once you subscribe"
|
||||
}
|
||||
"retain" => "retain",
|
||||
"（非文本，详情可切 Hex）" => " (binary — switch to Hex in details)",
|
||||
"用户属性" => "User Properties",
|
||||
"Content-Type" => "Content-Type",
|
||||
"Response Topic" => "Response Topic",
|
||||
"Correlation Data" => "Correlation Data",
|
||||
"消息过期" => "Message Expiry",
|
||||
"{n} 秒" => "{n}s",
|
||||
"复制主题" => "Copy topic",
|
||||
"复制负载原文" => "Copy raw payload",
|
||||
"复制完整详情（含 v5 属性）" => "Copy full details (incl. MQTT 5 props)",
|
||||
"已复制主题" => "Topic copied",
|
||||
"已复制负载" => "Payload copied",
|
||||
"已复制详情" => "Details copied",
|
||||
"主题" => "Topic",
|
||||
"界面主题" => "Theme",
|
||||
"负载" => "Payload",
|
||||
"详情" => "Details",
|
||||
"自动" => "Auto",
|
||||
"文本" => "Text",
|
||||
"连接日志" => "Connection Logs",
|
||||
"暂无日志" => "No logs yet",
|
||||
assert!(
|
||||
missing.is_empty(),
|
||||
"以下 t()/tf() 字面量没有语言包词条:\n{}",
|
||||
missing.join("\n")
|
||||
);
|
||||
}
|
||||
|
||||
// ── 发布面板 ──
|
||||
"发布主题" => "Publish topic",
|
||||
"输入消息负载，支持 {{变量名}} 与 {{$ts}} {{$uuid}}" => {
|
||||
"Message payload; supports {{variables}} and {{$ts}} {{$uuid}}"
|
||||
}
|
||||
"消息预设" => "Message Presets",
|
||||
"保存当前为预设…" => "Save current as preset…",
|
||||
"管理预设…" => "Manage presets…",
|
||||
"删除预设" => "Delete Preset",
|
||||
"确定删除预设「{name}」吗？此操作不可撤销。" => {
|
||||
"Delete preset \"{name}\"? This cannot be undone."
|
||||
}
|
||||
"预设已保存" => "Preset saved",
|
||||
"已覆盖预设「{name}」" => "Preset \"{name}\" overwritten",
|
||||
"请填写预设名称" => "Preset name is required",
|
||||
"预设名称，如 温度上报" => "Preset name, e.g. temperature-report",
|
||||
"保存消息预设" => "Save Message Preset",
|
||||
"预设名称" => "Preset name",
|
||||
"变量注入" => "Variable injection",
|
||||
"变量注入（{n} 个占位符）" => "Variable injection ({n} placeholders)",
|
||||
"MQTT 5 属性" => "MQTT 5 Properties",
|
||||
"MQTT 5 订阅选项" => "MQTT 5 Subscription Options",
|
||||
"未连接：消息未发送" => "Offline: message not sent",
|
||||
"发布主题不能为空" => "Publish topic cannot be empty",
|
||||
"消息过期须为非负整数（秒）" => "Message expiry must be a non-negative integer (seconds)",
|
||||
"JSON 格式无效: {e}" => "Invalid JSON: {e}",
|
||||
"订阅失败: {e}" => "Subscribe failed: {e}",
|
||||
"Keep Alive" => "Keep Alive",
|
||||
"接收上限" => "Receive Maximum",
|
||||
"主题别名" => "Topic Alias",
|
||||
"需要是 0~65535 的整数" => "must be an integer 0-65535",
|
||||
"必须大于 0（0 是 MQTT 5 协议错误）" => "must be > 0 (0 is an MQTT 5 protocol error)",
|
||||
"需要是非负整数" => "must be a non-negative integer",
|
||||
"已启用" => "Enabled",
|
||||
"添加属性" => "Add property",
|
||||
"删除此属性" => "Remove this property",
|
||||
"收起" => "Collapse",
|
||||
"变量值" => "Value",
|
||||
"主题/负载中没有 {{变量}} 引用" => "No {{variable}} reference in topic/payload",
|
||||
"重新提取占位符" => "Re-extract placeholders",
|
||||
"内置：{{$ts}}（秒） {{$ts_ms}}（毫秒） {{$uuid}} · 发布时注入" => "Built-in: {{$ts}} (s), {{$ts_ms}} (ms), {{$uuid}} · injected on publish",
|
||||
"预览：{tp} | {pl}" => "Preview: {tp} | {pl}",
|
||||
"变量（{n}）" => "Variables ({n})",
|
||||
"清除订阅过滤" => "Clear subscription filter",
|
||||
"取消编辑" => "Cancel editing",
|
||||
"鉴权方式" => "Auth mode",
|
||||
"地域" => "Region",
|
||||
"实例 ID" => "Instance ID",
|
||||
"已保存预设" => "Saved presets",
|
||||
"保存预设" => "Save preset",
|
||||
"生成并连接" => "Generate & connect",
|
||||
"无法生成连接: {e}" => "Failed to build connection: {e}",
|
||||
"分组（可选）" => "Group (optional)",
|
||||
"如 cn-shanghai（可留空）" => "e.g. cn-shanghai (optional)",
|
||||
"设备 ID" => "Device ID",
|
||||
"一机一密：ProductKey" => "Triple: ProductKey",
|
||||
"一机一密：DeviceSecret" => "Triple: DeviceSecret",
|
||||
"阿里云 IoT 设备" => "Alibaba Cloud IoT",
|
||||
"按可用核数归一" => "Normalized by core count",
|
||||
"峰值 {v}" => "Peak {v}",
|
||||
"进程独占的物理页承诺" => "Physical pages committed by the process",
|
||||
"tokio 引擎 + GPUI 渲染" => "tokio engine + GPUI renderer",
|
||||
"暂无连接" => "No connections",
|
||||
"消息与连接" => "Messages & Connections",
|
||||
"{n} 条消息" => "{n} msgs",
|
||||
"运行 {t}" => "Up {t}",
|
||||
"立即刷新" => "Refresh now",
|
||||
"发布主题，支持 {{变量名}}" => "Publish topic; supports {{variables}}",
|
||||
"消息负载，支持 {{变量名}}" => "Message payload; supports {{variables}}",
|
||||
"Payload（原文保存，发送时渲染变量）" => "Payload (stored raw; variables rendered on send)",
|
||||
"Payload 格式" => "Payload format",
|
||||
"暂无发布预设，点击上方「新建」创建" => "No presets yet — click \"New\" above to create one",
|
||||
"请先选择或新建预设" => "Select or create a preset first",
|
||||
"请先选择要删除的预设" => "Select a preset to delete first",
|
||||
"预设「{name}」已保存" => "Preset \"{name}\" saved",
|
||||
"预设名称「{name}」已存在" => "Preset name \"{name}\" already exists",
|
||||
"新预设 {n}" => "New preset {n}",
|
||||
"新预设" => "New preset",
|
||||
"管理发布预设" => "Manage Publish Presets",
|
||||
"在发布主题、消息负载中使用 {{变量名}} 引用。" => "Reference {{variables}} in publish topics and payloads.",
|
||||
"内置变量：{{$ts}}（秒）、{{$ts_ms}}（毫秒）、{{$uuid}}" => "Built-in: {{$ts}} (s), {{$ts_ms}} (ms), {{$uuid}}",
|
||||
"测试任务丢失" => "Test task lost",
|
||||
"Hex 长度必须为偶数（每两个字符一个字节）" => "Hex length must be even (two chars per byte)",
|
||||
"Hex 解码失败: 含非十六进制字符" => "Hex decode failed: non-hex character present",
|
||||
"Hex 解码失败: {e}" => "Hex decode failed: {e}",
|
||||
"Base64 解码失败: {e}" => "Base64 decode failed: {e}",
|
||||
"已发送（被当前过滤条件隐藏，消息流中不显示）" => {
|
||||
"Sent (hidden by current filter — not shown in the stream)"
|
||||
}
|
||||
"收起发布面板" => "Collapse publish panel",
|
||||
"展开发布面板" => "Expand publish panel",
|
||||
"发布面板已收起" => "Publish panel collapsed",
|
||||
"Content-Type（可选）" => "Content-Type (optional)",
|
||||
"秒，如 60" => "seconds, e.g. 60",
|
||||
"Response Topic（可选）" => "Response Topic (optional)",
|
||||
"Correlation Data（可选）" => "Correlation Data (optional)",
|
||||
"消息过期(秒)" => "Expiry (s)",
|
||||
/// 模型 `label()` 返回的 key 必须有真实（非自映射）的 en 词条。
|
||||
#[test]
|
||||
fn model_labels_have_real_translations() {
|
||||
let labels = [
|
||||
crate::model::ConnectionStatus::Disconnected.label(),
|
||||
crate::model::ConnectionStatus::Connecting.label(),
|
||||
crate::model::ConnectionStatus::Connected.label(),
|
||||
crate::model::ConnectionStatus::Error.label(),
|
||||
crate::model::Direction::Received.label(),
|
||||
crate::model::Direction::Published.label(),
|
||||
crate::model::ThemeModePref::System.label(),
|
||||
crate::model::ThemeModePref::Light.label(),
|
||||
crate::model::ThemeModePref::Dark.label(),
|
||||
];
|
||||
let missing: Vec<&str> = labels
|
||||
.iter()
|
||||
.filter(|l| translate(LOCALE_EN, l) == Cow::Borrowed(**l))
|
||||
.copied()
|
||||
.collect();
|
||||
assert!(missing.is_empty(), "模型 label 缺 en 词条: {missing:?}");
|
||||
}
|
||||
|
||||
// ── 变量面板 ──
|
||||
"检测到模板变量，发布时注入全局变量值" => {
|
||||
"Template variables detected — global values injected on publish"
|
||||
fn collect_rs(dir: &std::path::Path, out: &mut Vec<std::path::PathBuf>) {
|
||||
let Ok(rd) = std::fs::read_dir(dir) else { return };
|
||||
for e in rd.flatten() {
|
||||
let p = e.path();
|
||||
if p.is_dir() {
|
||||
collect_rs(&p, out);
|
||||
} else if p.extension().is_some_and(|x| x == "rs") {
|
||||
out.push(p);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// ── 连接表单 ──
|
||||
"连接配置" => "Connection Settings",
|
||||
"基本信息" => "Basics",
|
||||
"主机" => "Host",
|
||||
"端口" => "Port",
|
||||
"名称" => "Name",
|
||||
"协议" => "Protocol",
|
||||
"传输" => "Transport",
|
||||
"分组" => "Group",
|
||||
"新建分组" => "New group",
|
||||
"填写后优先于左侧所选分组" => "Overrides the selected group when filled",
|
||||
"Client ID" => "Client ID",
|
||||
"重新生成 Client ID" => "Regenerate Client ID",
|
||||
"WS 路径" => "WS Path",
|
||||
"broker.example.com" => "broker.example.com",
|
||||
"连接名称" => "Connection name",
|
||||
"无分组" => "No group",
|
||||
"认证与心跳" => "Auth & Keep-alive",
|
||||
"用户名" => "Username",
|
||||
"密码" => "Password",
|
||||
"用户名（可选）" => "Username (optional)",
|
||||
"密码（可选）" => "Password (optional)",
|
||||
"Keep Alive (秒)" => "Keep Alive (s)",
|
||||
"Keep Alive (秒) 需要是 0~65535 的整数" => "Keep Alive must be an integer 0-65535",
|
||||
"连接超时 (秒)" => "Connect timeout (s)",
|
||||
"最大重连次数 (0=无限)" => "Max reconnects (0 = unlimited)",
|
||||
"Clean Start / Clean Session" => "Clean Start / Clean Session",
|
||||
"断线自动重连" => "Auto reconnect on disconnect",
|
||||
"连接后自动恢复订阅" => "Auto-resubscribe on connect",
|
||||
"启动时自动连接" => "Connect on app start",
|
||||
"SSL/TLS" => "SSL/TLS",
|
||||
"CA 证书 (PEM)" => "CA certificate (PEM)",
|
||||
"客户端证书 (PEM)" => "Client certificate (PEM)",
|
||||
"客户端密钥 (PEM)" => "Client key (PEM)",
|
||||
"浏览…" => "Browse…",
|
||||
"选择证书 / 密钥文件" => "Select certificate / key file",
|
||||
"忽略 CA 校验（不验证服务器证书）" => "Skip CA verification (trust any server cert)",
|
||||
"已配置 {n} 项" => "{n} configured",
|
||||
"MQTT 5 属性已配置" => "MQTT 5 properties configured",
|
||||
"遗嘱消息 (Last Will)" => "Last Will",
|
||||
"启用遗嘱消息" => "Enable last will",
|
||||
"遗嘱主题" => "Will topic",
|
||||
"遗嘱内容" => "Will payload",
|
||||
"遗嘱主题不能为空" => "Will topic cannot be empty",
|
||||
"遗嘱主题不能包含通配符 + 或 #" => "Will topic cannot contain wildcards + or #",
|
||||
"遗嘱消息已启用" => "Last will enabled",
|
||||
"Retain" => "Retain",
|
||||
"内容类型 (Content Type)" => "Content Type",
|
||||
"响应主题 (Response Topic)" => "Response Topic",
|
||||
"连接名称不能为空" => "Connection name cannot be empty",
|
||||
"主机地址不能为空" => "Host cannot be empty",
|
||||
"Client ID 不能为空" => "Client ID cannot be empty",
|
||||
"会话过期间隔(秒)" => "Session expiry (s)",
|
||||
"接收最大值" => "Receive Maximum",
|
||||
"最大报文长度" => "Maximum Packet Size",
|
||||
"主题别名上限" => "Topic Alias Maximum",
|
||||
"测试连接" => "Test Connection",
|
||||
"测试中…" => "Testing…",
|
||||
"连接测试成功" => "Connection test succeeded",
|
||||
"配置已保存，重连后生效" => "Saved. Takes effect after reconnect",
|
||||
/// 手写扫描（避免引入 regex 依赖）：找 `::t("` / `::tf("` 后的字面量。
|
||||
/// 两个针互不误伤：`::t("` 要求引号紧跟 t，不会命中 `::tf("`。
|
||||
fn extract_t_literals(src: &str) -> Vec<String> {
|
||||
let b = src.as_bytes();
|
||||
let mut out = Vec::new();
|
||||
for needle in [b"::tf(\"".as_slice(), b"::t(\"".as_slice()] {
|
||||
let mut i = 0;
|
||||
while let Some(rel) = find(b, i, needle) {
|
||||
let start = rel + needle.len();
|
||||
let (lit, end) = read_string(b, start);
|
||||
if let Some(lit) = lit {
|
||||
out.push(lit);
|
||||
}
|
||||
i = end.max(i + 1);
|
||||
}
|
||||
}
|
||||
out
|
||||
}
|
||||
|
||||
// ── 设置 ──
|
||||
"跟随系统" => "Follow system",
|
||||
"浅色" => "Light",
|
||||
"深色" => "Dark",
|
||||
"界面语言" => "Language",
|
||||
"每条连接内存中保留的消息条数（100~100000）" => {
|
||||
"Messages kept in memory per connection (100-100000)"
|
||||
}
|
||||
"另有每连接 {n}MB 的字节预算兜底：大报文流会优先按字节从最旧开始驱逐" => {
|
||||
"Plus a per-connection byte budget of {n} MB: under heavy traffic, oldest messages are evicted by size first"
|
||||
}
|
||||
"时间戳显示毫秒" => "Show milliseconds in timestamps",
|
||||
"自动检查更新（启动时）" => "Check for updates on start",
|
||||
"数据目录" => "Data directory",
|
||||
"日志目录" => "Log directory",
|
||||
"打开目录" => "Open folder",
|
||||
"打开日志目录" => "Open log folder",
|
||||
"打开目录失败: {e}" => "Failed to open folder: {e}",
|
||||
"创建日志目录失败: {e}" => "Failed to create log folder: {e}",
|
||||
"关于" => "About",
|
||||
"版本 {v}（更新源 {src}）" => "Version {v} (update source: {src})",
|
||||
"Apache-2.0 许可证" => "Apache-2.0 license",
|
||||
"对标 MQTTX 的 GPUI 跨平台 MQTT 调试客户端" => {
|
||||
"A cross-platform MQTT debug client built with GPUI, aiming at MQTTX"
|
||||
}
|
||||
"检查更新" => "Check for updates",
|
||||
"检查 GitHub Releases 上的新版本" => "Check GitHub Releases for a new version",
|
||||
"检查中…" => "Checking…",
|
||||
"正在检查更新…" => "Checking for updates…",
|
||||
"重新检查" => "Check again",
|
||||
"已是最新版本" => "You are up to date",
|
||||
"立即更新到 v{v}" => "Update to v{v} now",
|
||||
"发现新版本 v{v}，下载后自动替换重启" => {
|
||||
"New version v{v} found — downloads, replaces itself and restarts"
|
||||
}
|
||||
"新版本 v{v} 已下载并通过校验，等待安装" => {
|
||||
"Version v{v} downloaded and verified, ready to install"
|
||||
}
|
||||
"立即安装" => "Install now",
|
||||
"下次启动安装" => "Install on next start",
|
||||
"已暂存，下次启动时将自动安装" => "Staged — it will install on next start",
|
||||
"放弃此次更新" => "Discard this update",
|
||||
"已删除暂存的更新包" => "Staged update discarded",
|
||||
"下载中 {pct}%（{done} / {total}）" => "Downloading {pct}% ({done} / {total})",
|
||||
"下载中 {done}" => "Downloading {done}",
|
||||
"重试" => "Retry",
|
||||
"更新失败：{e}" => "Update failed: {e}",
|
||||
"更新就绪" => "Update Ready",
|
||||
"新版本 v{v} 已下载完成（已通过 sha256 校验）。" => {
|
||||
"Version v{v} has been downloaded (sha256 verified)."
|
||||
}
|
||||
"暂不更新" => "Not now",
|
||||
"安装失败：{e}" => "Install failed: {e}",
|
||||
fn find(hay: &[u8], from: usize, needle: &[u8]) -> Option<usize> {
|
||||
hay[from..]
|
||||
.windows(needle.len())
|
||||
.position(|w| w == needle)
|
||||
.map(|p| p + from)
|
||||
}
|
||||
|
||||
// ── 导入 / 导出 / 通知 ──
|
||||
"导出 {n} 条连接到 {path}" => "Exported {n} connections to {path}",
|
||||
"导入 {n} 条，跳过 {n2} 条" => "Imported {n}, skipped {n2}",
|
||||
"已保存" => "Saved",
|
||||
|
||||
// ── 预设管理 ──
|
||||
"发布预设" => "Publish Presets",
|
||||
"新建预设" => "New Preset",
|
||||
"预设列表" => "Presets",
|
||||
|
||||
// ── 资源监控 / 其他对话框 ──
|
||||
"自身进程资源采样" => "Self-process resource sampling",
|
||||
|
||||
_ => zh,
|
||||
/// 从 `start`（首字节应为 `"`）读一个 Rust 字符串字面量，
|
||||
/// 处理转义，返回 (解码内容, 结束位置)。
|
||||
fn read_string(b: &[u8], start: usize) -> (Option<String>, usize) {
|
||||
if start >= b.len() || b[start] != b'"' {
|
||||
return (None, start + 1);
|
||||
}
|
||||
let mut out = String::new();
|
||||
let mut i = start + 1;
|
||||
while i < b.len() {
|
||||
match b[i] {
|
||||
b'\\' => {
|
||||
i += 1;
|
||||
if i < b.len() {
|
||||
match b[i] {
|
||||
b'"' => out.push('"'),
|
||||
b'\\' => out.push('\\'),
|
||||
other => {
|
||||
out.push('\\');
|
||||
out.push(other as char);
|
||||
}
|
||||
}
|
||||
i += 1;
|
||||
}
|
||||
}
|
||||
b'"' => return (Some(out), i + 1),
|
||||
_ => {
|
||||
let mut end = i + 1;
|
||||
while end < b.len() && (b[end] & 0xC0) == 0x80 {
|
||||
end += 1;
|
||||
}
|
||||
out.push_str(&String::from_utf8_lossy(&b[i..end]));
|
||||
i = end;
|
||||
}
|
||||
}
|
||||
}
|
||||
(None, i)
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user