Skip to content

语言与翻译维护 ​

Web 面板和 Android App 支持简体中文与 English。首次打开时优先使用浏览器或系统的语言列表;中文和英文之外的语言回退到 English。

登录页和账户菜单的「语言」可以选择「跟随系统」、简体中文或 English。手动选择保存在当前浏览器或 App,不改动其他设备;选择跟随系统后继续使用设备语言。切换语言不更换用户身份或资源权限。

Web 切换时保留当前表单和待确认任务。Android 使用系统应用语言机制刷新页面;提交中的操作应等待结果后再切换。用户填写的站点名称、域名、记录值和对话内容不会自动翻译。

日期和系统控件跟随当前语言。Web 和 App 用 Accept-Language 请求服务端提示;来自 Cloudflare、操作系统或模型的外部错误可能仍使用服务自身的语言。

翻译资源 ​

locales/zh-CN.json 与 locales/en.json 是共享词条。业务代码只引用稳定 ID,动态内容使用 {p0} 等参数,不拼接两套页面。翻译随构建打包,用户访问时不调用在线翻译服务。

修改词条后运行 node tools/i18n/generate.mjs,同步 Android 和后端资源。运行 node --test tools/i18n/*.test.mjs 检查词条与占位符。Android 构建也检查生成资源,防止只更新 Web。

文档内容 ​

文档以 docs/content/<页面>.json 为来源,同一个文件包含 zh-CN 和 en 的 Markdown 正文。构建生成两种语言页面,页面清单和导航共用。不要直接修改生成的 docs/guide/ 或 docs/en/ Markdown。

两种语言的正文仍需要翻译和审核;共同来源消除了重复目录、导航和构建流程,不会自动保证译文准确。运行 npm run content:generate 更新本地页面,再运行 npm run build 验证链接和搜索索引。

Cloudflare Tunnel 可视化管理面板