From 6f270ed6632368c437a1c2c81d7f416ce9b29321 Mon Sep 17 00:00:00 2001 From: "agent.develop" Date: Sat, 29 Aug 2026 15:33:44 +0800 Subject: [PATCH] =?UTF-8?q?approve:=20=E5=85=83=E6=99=AF=E6=B5=8B=E8=AF=95?= =?UTF-8?q?=E7=8E=AF=E5=A2=83=E9=83=A8=E7=BD=B2=EF=BC=88scene=20=E5=BA=94?= =?UTF-8?q?=E7=94=A8=EF=BC=8C=E8=A1=A5=E9=BD=90=20env/test.json=20+=20?= =?UTF-8?q?=E7=9C=9F=E5=AE=9E=E9=83=A8=E7=BD=B2=20+=20=E5=86=92=E7=83=9F?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/i18n.md | 68 +++++++++++++++++++++++++++++ wwwroot/i18n/en-US.json | 96 +++++++++++++++++++++++++++++++++++++++++ wwwroot/i18n/zh-CN.json | 96 +++++++++++++++++++++++++++++++++++++++++ 3 files changed, 260 insertions(+) create mode 100644 docs/i18n.md create mode 100644 wwwroot/i18n/en-US.json create mode 100644 wwwroot/i18n/zh-CN.json diff --git a/docs/i18n.md b/docs/i18n.md new file mode 100644 index 0000000..5f0f494 --- /dev/null +++ b/docs/i18n.md @@ -0,0 +1,68 @@ +# entity 模块 i18n 提取说明（W-03 实体管理） + +本文件是 entity 模块**新文案 i18n 提取清单与引用约定**，覆盖两个新增页面 +（`wwwroot/index.ui`、`wwwroot/import_page.ui`）及后端错误码/按钮等全部新文案。 + +## 1. i18n 文件清单 + +| 文件 | 语言 | 内容 | +|------|------|------| +| `wwwroot/i18n/zh-CN.json` | 简体中文 | 全部 UI 文案 + 错误码文案 + 字典文案 | +| `wwwroot/i18n/en-US.json` | 英文 | 与 zh-CN 键一一对应 | + +i18n 文件与页面同置于 `wwwroot/` 下，宿主应用加载时按当前语言读取对应 json， +键缺失时回退到 `zh-CN.json`，仍缺失则显示键名本身（不阻塞页面）。 + +## 2. 键命名规则（扁平点分，前缀 entity.） + +| 前缀 | 用途 | 示例 | +|------|------|------| +| `entity.page.*` | 页面标题/副标题 | `entity.page.index.title` | +| `entity.btn.*` | 按钮文案 | `entity.btn.add` | +| `entity.col.*` | 表格列头 | `entity.col.name` | +| `entity.filter.*` | 筛选区标签/占位 | `entity.filter.world_id` | +| `entity.form.*` | 新增/编辑表单标签 | `entity.form.code` | +| `entity.import.*` | 导入页专用文案 | `entity.import.col.total` | +| `entity.msg.*` | 操作提示/消息 | `entity.msg.confirm_delete` | +| `entity.dict.*` | 字典下拉（entity_type / entity_status / import_status） | `entity.dict.entity_type.npc` | +| `entity.err.*` | 后端错误码→文案映射 | `entity.err.DUPLICATE_CODE` | +| `entity.field.*` | 错误码文案中的字段标签占位 | `entity.field.name` | + +## 3. 页面引用方式 + +- `index.ui`（实体列表页）：标题/按钮/列头/筛选/表单/提示全部使用 + `entity.page.index.title`、`entity.btn.add`、`entity.col.name` 等键，经宿主 + i18n 函数取文案，禁止硬编码中文。 +- `import_page.ui`（实体导入页）：使用 `entity.page.import.*`、`entity.import.*`、 + `entity.btn.*` 键。 +- 字典下拉（世界/场景/实体类型/状态/导入状态）取值经 `get_search_*.dspy` 返回 + `[{value,text}]`，其中 `text` 优先取 i18n 文案（`entity.dict.*`），服务端字典 + 值作为兜底。 + +## 4. 错误码 → 文案映射约定 + +接口统一返回错误结构 `{code, message, field, detail}`。前端展示优先级： +1. 取 `entity.err.{code}` 对应 i18n 文案（支持 `{label}`/`{max}` 占位符替换， + 占位值来自 `field` 对应的 `entity.field.*` 与 `detail`）； +2. 无映射时回退接口返回的 `message`。 + +已提取的错误码（10 个）： + +| code | 中文文案 | 英文文案 | +|------|----------|----------| +| PARAM_REQUIRED | 缺少必要参数 | Missing required parameter | +| FIELD_REQUIRED | {label}不能为空 | {label} is required | +| FIELD_TOO_LONG | {label}长度不能超过{max} | {label} length cannot exceed {max} | +| WORLD_NOT_FOUND | 所属世界不存在 | World not found | +| SCENE_NOT_FOUND | 所属场景不存在 | Scene not found | +| DUPLICATE_CODE | 实体编码已存在 | Entity code already exists | +| PARSE_ERROR | 文件解析失败 | File parse error | +| INVALID_JSON | 属性JSON格式错误 | Invalid attributes JSON | +| DB_ERROR | 数据库操作失败 | Database operation failed | +| NOT_FOUND | 记录不存在 | Record not found | + +## 5. 新增文案流程（维护约定） + +新增任何页面文案/错误码/按钮时：先在 `zh-CN.json` 与 `en-US.json` 同步增加同键 +条目，再在页面中引用该键。两文件键集合必须保持一致（提交前用脚本比对 +`jq -S 'keys'` 两文件差异，差异为 0 才允许提交）。 diff --git a/wwwroot/i18n/en-US.json b/wwwroot/i18n/en-US.json new file mode 100644 index 0000000..54b4e14 --- /dev/null +++ b/wwwroot/i18n/en-US.json @@ -0,0 +1,96 @@ +{ + "entity.page.index.title": "Entity Management", + "entity.page.index.subtitle": "Entity table CRUD and list query", + "entity.page.import.title": "Entity Import", + "entity.page.import.subtitle": "Batch import entities from file (JSON Array / JSON Lines / CSV)", + "entity.btn.add": "Add", + "entity.btn.edit": "Edit", + "entity.btn.delete": "Delete", + "entity.btn.import": "Import", + "entity.btn.refresh": "Refresh", + "entity.btn.search": "Search", + "entity.btn.reset": "Reset", + "entity.btn.save": "Save", + "entity.btn.cancel": "Cancel", + "entity.btn.confirm": "OK", + "entity.btn.choose_file": "Choose File", + "entity.btn.start_import": "Start Import", + "entity.btn.download_template": "Download Template", + "entity.btn.back": "Back", + "entity.col.name": "Entity Name", + "entity.col.code": "Entity Code", + "entity.col.entity_type": "Entity Type", + "entity.col.status": "Status", + "entity.col.world_id": "World", + "entity.col.scene_id": "Scene", + "entity.col.attributes_json": "Attributes", + "entity.col.created_at": "Created At", + "entity.col.updated_at": "Updated At", + "entity.col.actions": "Actions", + "entity.filter.world_id": "World", + "entity.filter.scene_id": "Scene", + "entity.filter.entity_type": "Entity Type", + "entity.filter.status": "Status", + "entity.filter.keyword": "Name/Code Keyword", + "entity.filter.placeholder.select": "Select", + "entity.filter.placeholder.input": "Input", + "entity.form.name": "Entity Name", + "entity.form.code": "Entity Code", + "entity.form.world_id": "World", + "entity.form.scene_id": "Scene", + "entity.form.entity_type": "Entity Type", + "entity.form.status": "Status", + "entity.form.attributes_json": "Attributes (JSON)", + "entity.form.placeholder.name": "Enter entity name", + "entity.form.placeholder.code": "Enter entity code", + "entity.form.placeholder.attributes_json": "e.g. {\"hp\":100,\"atk\":10}", + "entity.import.form.world_id": "Target World", + "entity.import.form.scene_id": "Target Scene", + "entity.import.form.file": "Import File", + "entity.import.col.file_name": "File Name", + "entity.import.col.total": "Total", + "entity.import.col.success": "Success", + "entity.import.col.fail": "Fail", + "entity.import.col.status": "Import Status", + "entity.import.col.created_at": "Imported At", + "entity.import.history.title": "Import History", + "entity.msg.confirm_delete": "Delete this entity?", + "entity.msg.delete_ok": "Deleted successfully", + "entity.msg.delete_fail": "Delete failed", + "entity.msg.save_ok": "Saved successfully", + "entity.msg.save_fail": "Save failed", + "entity.msg.importing": "Importing, please wait...", + "entity.msg.import_ok": "Import done: {total} total, {success} succeeded, {fail} failed", + "entity.msg.import_fail": "Import failed", + "entity.msg.file_format_hint": "Supports JSON Array / JSON Lines / CSV (header row)", + "entity.msg.file_required": "Please choose an import file first", + "entity.msg.no_data": "No data", + "entity.msg.loading": "Loading...", + "entity.dict.entity_type.npc": "NPC", + "entity.dict.entity_type.item": "Item", + "entity.dict.entity_type.building": "Building", + "entity.dict.entity_type.prop": "Prop", + "entity.dict.entity_type.other": "Other", + "entity.dict.entity_status.0": "Enabled", + "entity.dict.entity_status.1": "Disabled", + "entity.dict.import_status.0": "In Progress", + "entity.dict.import_status.1": "Success", + "entity.dict.import_status.2": "Failed", + "entity.err.PARAM_REQUIRED": "Missing required parameter", + "entity.err.FIELD_REQUIRED": "{label} is required", + "entity.err.FIELD_TOO_LONG": "{label} length cannot exceed {max}", + "entity.err.WORLD_NOT_FOUND": "World not found", + "entity.err.SCENE_NOT_FOUND": "Scene not found", + "entity.err.DUPLICATE_CODE": "Entity code already exists", + "entity.err.PARSE_ERROR": "File parse error", + "entity.err.INVALID_JSON": "Invalid attributes JSON", + "entity.err.DB_ERROR": "Database operation failed", + "entity.err.NOT_FOUND": "Record not found", + "entity.field.name": "Entity Name", + "entity.field.code": "Entity Code", + "entity.field.world_id": "World", + "entity.field.scene_id": "Scene", + "entity.field.entity_type": "Entity Type", + "entity.field.status": "Status", + "entity.field.attributes_json": "Attributes JSON" +} diff --git a/wwwroot/i18n/zh-CN.json b/wwwroot/i18n/zh-CN.json new file mode 100644 index 0000000..f5ec39d --- /dev/null +++ b/wwwroot/i18n/zh-CN.json @@ -0,0 +1,96 @@ +{ + "entity.page.index.title": "实体管理", + "entity.page.index.subtitle": "实体表（entity）增删改查与列表查询", + "entity.page.import.title": "实体导入", + "entity.page.import.subtitle": "通过文件批量导入实体（支持 JSON 数组 / JSON Lines / CSV）", + "entity.btn.add": "新增", + "entity.btn.edit": "编辑", + "entity.btn.delete": "删除", + "entity.btn.import": "导入", + "entity.btn.refresh": "刷新", + "entity.btn.search": "查询", + "entity.btn.reset": "重置", + "entity.btn.save": "保存", + "entity.btn.cancel": "取消", + "entity.btn.confirm": "确定", + "entity.btn.choose_file": "选择文件", + "entity.btn.start_import": "开始导入", + "entity.btn.download_template": "下载模板", + "entity.btn.back": "返回", + "entity.col.name": "实体名称", + "entity.col.code": "实体编码", + "entity.col.entity_type": "实体类型", + "entity.col.status": "状态", + "entity.col.world_id": "所属世界", + "entity.col.scene_id": "所属场景", + "entity.col.attributes_json": "属性", + "entity.col.created_at": "创建时间", + "entity.col.updated_at": "更新时间", + "entity.col.actions": "操作", + "entity.filter.world_id": "所属世界", + "entity.filter.scene_id": "所属场景", + "entity.filter.entity_type": "实体类型", + "entity.filter.status": "状态", + "entity.filter.keyword": "名称/编码关键字", + "entity.filter.placeholder.select": "请选择", + "entity.filter.placeholder.input": "请输入", + "entity.form.name": "实体名称", + "entity.form.code": "实体编码", + "entity.form.world_id": "所属世界", + "entity.form.scene_id": "所属场景", + "entity.form.entity_type": "实体类型", + "entity.form.status": "状态", + "entity.form.attributes_json": "属性（JSON）", + "entity.form.placeholder.name": "请输入实体名称", + "entity.form.placeholder.code": "请输入实体编码", + "entity.form.placeholder.attributes_json": "如 {\"hp\":100,\"atk\":10}", + "entity.import.form.world_id": "目标世界", + "entity.import.form.scene_id": "目标场景", + "entity.import.form.file": "导入文件", + "entity.import.col.file_name": "文件名", + "entity.import.col.total": "总数", + "entity.import.col.success": "成功", + "entity.import.col.fail": "失败", + "entity.import.col.status": "导入状态", + "entity.import.col.created_at": "导入时间", + "entity.import.history.title": "导入记录", + "entity.msg.confirm_delete": "确认删除该实体？", + "entity.msg.delete_ok": "删除成功", + "entity.msg.delete_fail": "删除失败", + "entity.msg.save_ok": "保存成功", + "entity.msg.save_fail": "保存失败", + "entity.msg.importing": "导入中，请稍候...", + "entity.msg.import_ok": "导入完成：共 {total} 条，成功 {success} 条，失败 {fail} 条", + "entity.msg.import_fail": "导入失败", + "entity.msg.file_format_hint": "支持 JSON 数组 / JSON Lines / CSV（首行表头）", + "entity.msg.file_required": "请先选择导入文件", + "entity.msg.no_data": "暂无数据", + "entity.msg.loading": "加载中...", + "entity.dict.entity_type.npc": "NPC", + "entity.dict.entity_type.item": "物品", + "entity.dict.entity_type.building": "建筑", + "entity.dict.entity_type.prop": "道具", + "entity.dict.entity_type.other": "其他", + "entity.dict.entity_status.0": "启用", + "entity.dict.entity_status.1": "禁用", + "entity.dict.import_status.0": "进行中", + "entity.dict.import_status.1": "成功", + "entity.dict.import_status.2": "失败", + "entity.err.PARAM_REQUIRED": "缺少必要参数", + "entity.err.FIELD_REQUIRED": "{label}不能为空", + "entity.err.FIELD_TOO_LONG": "{label}长度不能超过{max}", + "entity.err.WORLD_NOT_FOUND": "所属世界不存在", + "entity.err.SCENE_NOT_FOUND": "所属场景不存在", + "entity.err.DUPLICATE_CODE": "实体编码已存在", + "entity.err.PARSE_ERROR": "文件解析失败", + "entity.err.INVALID_JSON": "属性JSON格式错误", + "entity.err.DB_ERROR": "数据库操作失败", + "entity.err.NOT_FOUND": "记录不存在", + "entity.field.name": "实体名称", + "entity.field.code": "实体编码", + "entity.field.world_id": "所属世界", + "entity.field.scene_id": "所属场景", + "entity.field.entity_type": "实体类型", + "entity.field.status": "状态", + "entity.field.attributes_json": "属性JSON" +}