Skip to content

feat: 管理器和命令行的英文界面 - #192

Merged
qiyinxi merged 3 commits into
ModAVD:mainfrom
qiyinxi:feat/i18n-165
Nov 18, 2026
Merged

qiyinxi merged 3 commits into
ModAVD:mainfrom
qiyinxi:feat/i18n-165

Conversation

@qiyinxi

@qiyinxi qiyinxi commented Nov 18, 2026 •

Copy link
Copy Markdown
Member

改了什么

管理器和命令行有了英文界面(Refs ModAVD/ModAVD#165)。

  • 语言怎么选:MODAVD_LANG 环境变量 → 设置里选的(存在 %LOCALAPPDATA%\ModAVD\language.json)→ 系统界面语言。Windows 用 GetUserDefaultUILanguage,zh-* 是中文,其他一律英文;macOS / Linux 看 LANG 等和 AppleLanguages。设置页里可以选「跟随系统 / 中文 / English」,改了立即生效,页面重新加载。
  • 只有新装的跟随系统:第一次运行带语言的版本时定一次、写进 language.json。这个用户的 %LOCALAPPDATA%\ModAVD 里已经有旧版写的东西(管理器窗口状态 ui-*、update-settings.json、开机时的 affinity.lock 等)就算升级,定成中文;目录是空的才是新装,定成跟随系统。升级的人界面不会突然变成英文,想要英文去设置里改。
  • 表:新包 internal/i18n。代码里照旧写中文,中文原文就是键,locales/en/<包>.json 按包分(web.json 是页面自己的字符串)。格式串(实例 %d 正在关机)和拼接("实例 " + name + " 已存在" → 实例 %v 已存在)按模式反向匹配,参数再各自翻;整句没有键的,按「:」「;」「。」、括号、行、词拆开翻。加别的语言就是加一个 locales/<代码>/ 目录。
  • 在哪翻:只在给人看的地方。
    • 管理器:HTTP 回答和事件流里的人读字段(message、advice、warnings、检查项的 title / reason 等,见 i18n/json.go),页面自己的字符串走 t();托盘菜单、消息框、会话通知。
    • 命令行:不带 --json 时,输出到控制台的 stdout / stderr(结果先按字段翻,再排版,表格列宽按译文算)。
  • 一个字节都不变的:--json 的输出(信封里的 message 照旧是中文)、MCP、adb、shell 的输出、退出码、错误码、mas-avd.json 和实例文件、日志文件、问题包。输出重定向到文件或管道时(比如管理器自动更新写的 logs\modavd-update.log)也不翻,除非设了 MODAVD_LANG。中文时管理器的回答不重新编码,和原来逐字节相同。
  • AUTO-MAS 调命令行一律带 --json,读的是信封,不受影响。
  • update.js 里写死的 zh-CN 时间格式改成跟着语言走。

TestCatalog 查表:源码和页面里每条中文都有译文(或 null 表示故意不翻,比如问题包正文)、没有过期的键、译文参数和原文对得上、同一个键各包里译法一致、页面没有写在 t() 外面的中文。改了中文字符串以后 go test ./internal/i18n -run TestCatalog -update 把缺的键加进表,见 internal/i18n/README.md。

测试

  • go test ./... 通过。
  • 管理器:在测试根上起了一个英文的管理器(不开窗口),看了主页、电脑检查、设置(含语言切换:切中文、切回英文)、实例菜单、实例设置、动态面板和一次「查看磁盘占用」任务,页面上没有剩下中文。
  • 命令行:MODAVD_LANG=en 下跑 help、各命令的 help、check、list、info、status(缺参数报错),输出是英文;同样的命令带 --json 输出和原来一样是中文信封。

没做 / 以后

  • 文档站和 README 里引用按钮名的地方,等这版发出去再改成英文名。

代码里照旧写中文,中文原文就是键:internal/i18n 按包放英文表,格式串和拼接按模式反向匹配。
只在给人看的地方翻:管理器的回答和事件、页面自己的字符串、托盘和消息框、命令行输出到控制台的人读输出。
--json、MCP、日志、问题包、mas-avd.json 不变。语言按 MODAVD_LANG、设置里选的、系统界面语言依次决定,
设置页可以切换。TestCatalog 查漏翻、过期、参数对不上和页面里写在 t() 外面的中文。

Refs ModAVD/ModAVD#165
@qiyinxi qiyinxi added the enhancement New feature or request label Nov 18, 2026
页面模块在 node 测试里没有 document / fetch / location:i18n.js 只在页面里读语言表;data: URL 和 vm 加载的测试改成导入真的 i18n.js。更新确认框里的实例名照旧连在一起写。

Refs ModAVD/ModAVD#165
@qiyinxi
qiyinxi added this pull request to the merge queue Nov 18, 2026
Merged via the queue into ModAVD:main with commit c919751 Nov 18, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant