diff --git a/README.md b/README.md index 6239538..84e922d 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,7 @@ pnpm run build:antdv-next - 系统管理 / 菜单管理维护后端 `admin_menu.sort` 排序字段;`/menu/all` caller 会把后端 `sort` 映射到 Vben 菜单生成器读取的 `meta.order`,保证侧边栏菜单展示以后端返回顺序为准。默认首页入口收敛到环境总览 `/analytics`,不再保留假工作台 `/workspace` 页面。 - 系统管理 / 站内信是日志级通知列表,只展示 API 错误、QQBot 下线、NapCat 离线等后端自动捕获事件;页面提供筛选、处理/重新打开、置顶和删除,不提供人工新增或编辑。 - 系统管理 / 网络管理使用 TSX、KtTable 与统一 Vben 表单维护 API 持久化的 TCP/UDP 单端口转发期望状态,并通过独立页签管理腾讯云云解析 DNS 的 A/AAAA 自动更新绑定。页面展示 Agent、路由同步、UDP Keeper、公网端点租约和 DDNS 同步状态,支持异步 CRUD、重试、Keeper 启停、立即 STUN 刷新及端点历史;A 只使用合格 UDP Keeper 的公网 IPv4,AAAA 只使用 Agent 全局 IPv6,DNS 值不包含端口。首屏读取一次 HTTP 快照,后续只按 API SSE 的资源来源刷新当前活动页签;心跳和其他页签事件不刷新,不使用定时轮询。Admin 不接触路由器、MQTT 或腾讯云凭据;当前已验证切片只执行 UDP 路由器写入,TCP 可保存 CRUD 期望但 Agent 会显示设备协议门禁失败,STUN 操作保持可见且禁用。 +- Vue i18n 文案中的普通 `@` 必须写成字面量插值 `{'@'}`,否则生产消息编译器会把它识别为 linked message 语法。网络管理语言包由 `network-locale.spec.ts` 逐条通过实际 i18n runtime 校验,不能只依赖 JSON 解析或组件测试里的 `$t` mock。 - QQBot / 账号连接页拆分 OneBot 连接、QQ 登录、NapCat 运行和运行说明列;更新登录通过 SSE 展示 quick / password / captcha / new-device / qrcode 每步中文进度,密码登录触发 QQ 安全验证时在弹窗内完成腾讯验证码并回交 API,新设备验证二维码和腾讯验证码分开展示;行操作“运行态”打开只读抽屉,展示 NapCat runtime/protocol/session behavior profile、风险模式和登录事件证据。 - QQBot / 插件平台页保留在线命令能力表,并提供 manifest 校验、本地插件安装、安装记录、运行事件和账号绑定抽屉,接口走 `/qqbot/plugin-platform/*`。 - 博客管理 / 文章管理提供“预览”行操作,打开隐藏二级路由 `/blog/article/:articleId/preview`;预览页按 NapCat WebUI 的微服务嵌入形态实现,iframe 独占容器,文章标题、状态、预览 Host 和返回/刷新/新窗口操作放在右下角悬浮卡片,不占用 iframe 布局空间。新增隐藏路由和按钮权限需要同步 API `blog-menu.sql` / `vben-admin-init.sql` 中的 `BlogArticlePreview` 与 `BlogArticlePreviewButton`。 diff --git a/apps/web-antdv-next/src/locales/langs/en-US/system.json b/apps/web-antdv-next/src/locales/langs/en-US/system.json index e3cb895..6787bd6 100644 --- a/apps/web-antdv-next/src/locales/langs/en-US/system.json +++ b/apps/web-antdv-next/src/locales/langs/en-US/system.json @@ -156,7 +156,7 @@ "ddnsStatusSyncing": "Syncing", "ddnsStatusWaitingSource": "Waiting for Source", "ddnsSubDomain": "Host Record", - "ddnsSubDomainInvalid": "Enter a valid host record; use @ for the root", + "ddnsSubDomainInvalid": "Enter a valid host record; use {'@'} for the root", "ddnsSyncInProgress": "Synchronization is in progress", "ddnsSyncStatus": "DDNS Status", "ddnsTab": "Automatic DDNS", diff --git a/apps/web-antdv-next/src/locales/langs/zh-CN/system.json b/apps/web-antdv-next/src/locales/langs/zh-CN/system.json index 38946a6..835c419 100644 --- a/apps/web-antdv-next/src/locales/langs/zh-CN/system.json +++ b/apps/web-antdv-next/src/locales/langs/zh-CN/system.json @@ -158,7 +158,7 @@ "ddnsStatusSyncing": "同步中", "ddnsStatusWaitingSource": "等待来源", "ddnsSubDomain": "主机记录", - "ddnsSubDomainInvalid": "请输入有效主机记录,根记录使用 @", + "ddnsSubDomainInvalid": "请输入有效主机记录,根记录使用 {'@'}", "ddnsSyncInProgress": "同步正在进行中", "ddnsSyncStatus": "DDNS 状态", "ddnsTab": "自动 DDNS", diff --git a/apps/web-antdv-next/src/views/system/network/network-locale.spec.ts b/apps/web-antdv-next/src/views/system/network/network-locale.spec.ts new file mode 100644 index 0000000..12672d4 --- /dev/null +++ b/apps/web-antdv-next/src/views/system/network/network-locale.spec.ts @@ -0,0 +1,35 @@ +import { i18n } from '@vben/locales'; + +import { afterEach, describe, expect, it, vi } from 'vitest'; + +import enSystem from '#/locales/langs/en-US/system.json'; +import zhSystem from '#/locales/langs/zh-CN/system.json'; + +const testLocales = ['network-en-US', 'network-zh-CN']; + +afterEach(() => { + vi.restoreAllMocks(); + for (const locale of testLocales) { + i18n.global.setLocaleMessage(locale, {}); + } +}); + +describe.each([ + ['network-en-US', enSystem.network], + ['network-zh-CN', zhSystem.network], +])('network locale message syntax: %s', (locale, networkMessages) => { + it('compiles every message through the production i18n runtime', () => { + const consoleError = vi + .spyOn(console, 'error') + .mockImplementation(() => {}); + i18n.global.setLocaleMessage(locale, { + system: { network: networkMessages }, + }); + i18n.global.locale.value = locale; + + for (const key of Object.keys(networkMessages)) { + i18n.global.t(`system.network.${key}`); + } + expect(consoleError).not.toHaveBeenCalled(); + }); +}); diff --git a/skills/references/core/locale.md b/skills/references/core/locale.md index 210531c..bc894ad 100644 --- a/skills/references/core/locale.md +++ b/skills/references/core/locale.md @@ -105,6 +105,12 @@ packages/locales/ } ``` +## 消息语法边界 + +Vue i18n 会把 `@` 解析为 linked message 起始符。文案需要显示普通 `@` 时必须使用字面量插值 `{'@'}`,不能直接写裸 `@`,否则生产消息编译器可能抛出 `SyntaxError: 14`。 + +新增或修改业务语言包后,应通过实际 i18n runtime 逐条调用对应 namespace,并断言没有 message compilation error。网络管理的回归入口为 `apps/web-antdv-next/src/views/system/network/network-locale.spec.ts`。 + ## 远程加载语言包 ```ts