yugoo-design 0.2.6 → 0.2.8

package/payload/shared/bundles/function_modules/schema.yaml

@@ -10,6 +10,10 @@ type: object
 additional_properties: false
 properties:
   skill_name: { knowledge: { role: metadata }, type: string }
+  function_order:
+    knowledge: { role: metadata }
+    type: array
+    items: { type: string }
   functions:
     type: map
     value:

package/payload/shared/bundles/integration_design/locales/en-US.json

@@ -7,6 +7,8 @@
   "newIntegration": "New system integration",
   "newIntegrationNumbered": "New system integration {index}",
   "title": "Name",
+  "connectionDetails": "Connection details",
+  "usageAndNotes": "Usage and notes",
   "description": "Capability description",
   "descriptionHelp": "In one sentence, explain what this connection does for the product.",
   "descriptionExample": "For example: create a warehouse shipment and return its identifier.",
@@ -15,7 +17,7 @@
   "secrets": "Credential requirements",
   "secretsHelp": "Record credential names and purposes only. Configure actual secrets through the host credential service, never in Design Files. Leave this empty if authentication is unnecessary.",
   "secret": "Credential",
-  "secretName": "Credential name (uppercase letters, digits and underscores)",
+  "secretName": "Credential name or configuration key",
   "secretDescription": "Purpose",
   "prompt": "Usage instructions",
   "promptHelp": "Explain when to use the connection, what to do, and which results to return.",

package/payload/shared/bundles/integration_design/locales/zh-CN.json

@@ -7,6 +7,8 @@
   "newIntegration": "新系统集成",
   "newIntegrationNumbered": "新系统集成 {index}",
   "title": "名称",
+  "connectionDetails": "连接信息",
+  "usageAndNotes": "使用与说明",
   "description": "能力说明",
   "descriptionHelp": "用一句话说明这个连接替产品完成什么事情。",
   "descriptionExample": "例如：向仓储系统创建发货任务，并返回任务编号",
@@ -15,7 +17,7 @@
   "secrets": "凭据需求",
   "secretsHelp": "这里只记录宿主需要配置的凭据名称和用途。实际密钥必须通过宿主应用凭据服务提供，不能写入设计文件。如果服务不需要密钥，可以保持为空。",
   "secret": "凭据",
-  "secretName": "凭据名称（大写字母、数字和下划线）",
+  "secretName": "凭据名称或配置项",
   "secretDescription": "用途说明",
   "prompt": "使用方法",
   "promptHelp": "告诉 Agent 何时使用这个连接、需要完成什么，以及应该返回哪些结果。",

package/payload/shared/bundles/integration_design/panel.yaml

@@ -7,7 +7,23 @@ initial_values: {schema_version: 8}
 empty_description: $t:empty
 sections:
   - id: integrations
-    form: {header: {variant: detail, title: {field: title, editable: true}}}
+    form:
+      header: {variant: detail, title: {field: title, editable: true}}
+      body:
+        - kind: group
+          title: $t:connectionDetails
+          items:
+            - {kind: field, field: description}
+            - {kind: field, field: url}
+        - kind: group
+          title: $t:secrets
+          items:
+            - {kind: field, field: secrets, label: visually_hidden}
+        - kind: group
+          title: $t:usageAndNotes
+          items:
+            - {kind: field, field: prompt_content}
+            - {kind: field, field: business_rules}
     title: $t:integrations
     item_name: $t:integration
     order: integration_order
@@ -46,7 +62,7 @@ fields:
     order_field: secret_order
     max_rows: 10
     columns:
-      - {key: name, label: '$t:secretName', control: text, format: upper_identifier}
+      - {key: name, label: '$t:secretName', control: text}
       - {key: description, label: '$t:secretDescription', control: text}
     applies_to: [integrations]
   - key: prompt_content

package/payload/shared/bundles/notification_design/locales/en-US.json

@@ -7,6 +7,8 @@
   "newNotification": "New notification 1",
   "newNotificationNumbered": "New notification {index}",
   "title": "Notification name",
+  "deliveryGroup": "Notification delivery",
+  "messageAndAction": "Message and action",
   "trigger": "Trigger",
   "recipients": "Recipients",
   "channels": "Channels",

package/payload/shared/bundles/notification_design/locales/zh-CN.json

@@ -7,6 +7,8 @@
   "newNotification": "新通知 1",
   "newNotificationNumbered": "新通知 {index}",
   "title": "通知名称",
+  "deliveryGroup": "通知安排",
+  "messageAndAction": "内容与操作",
   "trigger": "触发时机",
   "recipients": "接收对象",
   "channels": "通知方式",

package/payload/shared/bundles/notification_design/panel.yaml

@@ -14,11 +14,17 @@ sections:
       reorder: false
       header: {variant: detail, title: {field: title, editable: true}}
       body:
-        - {kind: field, field: trigger}
-        - {kind: field, field: recipients}
-        - {kind: field, field: channels}
-        - {kind: field, field: message}
-        - {kind: field, field: action_target}
+        - kind: group
+          title: $t:deliveryGroup
+          items:
+            - {kind: field, field: trigger}
+            - {kind: field, field: recipients}
+            - {kind: field, field: channels}
+        - kind: group
+          title: $t:messageAndAction
+          items:
+            - {kind: field, field: message}
+            - {kind: field, field: action_target}
     create:
       id_field: id
       defaults: {title: '', channels: [in_app]}
@@ -30,7 +36,13 @@ sections:
 fields:
   - {key: title, label: $t:title, control: text, required: true, applies_to: [notifications]}
   - {key: trigger, label: $t:trigger, control: textarea, required: true, applies_to: [notifications]}
-  - {key: recipients, label: $t:recipients, control: token_list, required: true, applies_to: [notifications]}
+  - key: recipients
+    label: $t:recipients
+    control: token_list
+    token_add_mode: menu
+    required: true
+    options_from_panel: {panel_type: role_access, section_id: roles}
+    applies_to: [notifications]
   - key: channels
     required: true
     label: $t:channels

package/payload/shared/bundles/page_design/locales/en-US.json

@@ -30,5 +30,16 @@
   "members": "Pages in group",
   "map": "Page map",
   "guidance": "Walk through the user task and check that page content, actions and navigation form a coherent path without gaps or dead ends. Map positions and groups only organize the view.",
-  "shared": "Shared specification"
+  "shared": "Shared styles",
+  "sharedLayout": "Layout",
+  "sharedBrand": "Brand identity",
+  "sharedBrandName": "Brand name",
+  "sharedBrandDescription": "Appearance",
+  "sharedMarkRef": "Mark reference",
+  "sharedNavigation": "Navigation",
+  "sharedNavigationGroup": "Navigation group",
+  "sharedIconRef": "Icon reference",
+  "sharedNavigationId": "Navigation ID",
+  "sharedComponents": "Shared components",
+  "sharedSource": "Visual style source"
 }

package/payload/shared/bundles/page_design/locales/zh-CN.json

@@ -30,5 +30,16 @@
   "members": "分区内页面",
   "map": "页面地图",
   "guidance": "从用户要完成的任务出发，检查页面内容、操作和跳转是否连贯，有没有遗漏或死路；地图位置和分区只影响组织方式。",
-  "shared": "公共规格"
+  "shared": "公共样式",
+  "sharedLayout": "布局",
+  "sharedBrand": "品牌标识",
+  "sharedBrandName": "品牌名称",
+  "sharedBrandDescription": "外观说明",
+  "sharedMarkRef": "标识引用",
+  "sharedNavigation": "导航",
+  "sharedNavigationGroup": "导航分组",
+  "sharedIconRef": "图标引用",
+  "sharedNavigationId": "导航编号",
+  "sharedComponents": "共享组件",
+  "sharedSource": "视觉风格来源"
 }

package/payload/shared/bundles/page_design/panel.yaml

@@ -55,4 +55,26 @@ ui:
     edges: {path: connections, order: connection_order, source: source_page_id, target: target_page_id, label: label, hotspot: source_element_id, hotspot_label: source_element_label, context: preview_context, new_label: '$t:newConnectionLabel'}
     frames: {path: canvas_sections, label: label, members: page_ids, position: canvas_position, size: canvas_size}
   children:
-    - {component: structured_data, id: shared-specification, title: $t:shared, source: common_spec}
+    - component: structured_data
+      id: shared-specification
+      title: $t:shared
+      source: common_spec
+      read_fields:
+        - {key: layout, label: '$t:sharedLayout'}
+        - key: logo
+          label: $t:sharedBrand
+          fields:
+            - {key: name, label: '$t:sharedBrandName'}
+            - {key: description, label: '$t:sharedBrandDescription'}
+            - {key: mark_ref, label: '$t:sharedMarkRef', collapsed: true}
+        - key: navigation
+          label: $t:sharedNavigation
+          item_label_field: label
+          fields:
+            - {key: target_page_id, label: '$t:target', options_from_section: pages}
+            - {key: group, label: '$t:sharedNavigationGroup'}
+            - {key: icon_ref, label: '$t:sharedIconRef', collapsed: true}
+            - {key: id, label: '$t:sharedNavigationId', collapsed: true}
+        - {key: shared_components, label: '$t:sharedComponents'}
+        - {key: visual_pattern_refs, label: '$t:patterns', collapsed: true}
+        - {key: source, label: '$t:sharedSource', collapsed: true}

package/payload/shared/bundles/quality_acceptance/locales/en-US.json

@@ -13,9 +13,9 @@
   "criteria": "What counts as passing?",
   "criteriaHelp": "Use observable or measurable criteria; avoid vague statements such as “a good experience”.",
   "criteriaExample": "For example: an order number is created and Pending is displayed",
-  "verification": "How will this be verified? (optional)",
+  "verification": "How will this be verified?",
   "verificationHelp": "Add a method only when it is not obvious. Test code is not required.",
   "workspace": "Acceptance criteria",
-  "group": "Group (optional)",
+  "group": "Group",
   "groupExample": "For example: Business flow, AI capabilities"
 }

package/payload/shared/bundles/quality_acceptance/locales/zh-CN.json

@@ -13,9 +13,9 @@
   "criteria": "怎样才算通过？",
   "criteriaHelp": "写出用户能看到、系统能确认或可以衡量的标准，避免“体验良好”一类模糊描述。",
   "criteriaExample": "例如：生成订单号并显示待处理",
-  "verification": "如何确认？（可选）",
+  "verification": "如何确认？",
   "verificationHelp": "只有检查方法不明显时才补充，不需要写测试代码。",
   "workspace": "验收标准",
-  "group": "分组（可选）",
+  "group": "分组",
   "groupExample": "例如：业务流程、AI 能力"
 }

package/payload/shared/bundles/quality_acceptance/panel.yaml

@@ -51,13 +51,16 @@ fields:
     description: $t:verificationHelp
     applies_to: [requirements]
 ui:
-  component: record_workspace
-  guidance: "$t:guidance"
+  component: record_board
+  guidance: $t:guidance
   sidebar_icon: clipboard-check
-  navigation_layout: list
-  navigation_group_by: group
   id: acceptance-workspace
   title: $t:workspace
-  sources: [requirements]
-  children:
-    - {component: record_inspector, id: acceptance-editor}
+  source: requirements
+  board:
+    label: title
+    description: pass_criteria
+    group: group
+    body_fields: [condition, pass_criteria, verification]
+    overview: false
+    detail_fields: []

package/payload/shared/bundles/role_access/locales/en-US.json

@@ -9,8 +9,8 @@
   "newRoleNumbered": "New role {index}",
   "title": "Role name",
   "titleExample": "For example: sales manager",
-  "assignment": "Who receives this role?",
-  "assignmentHelp": "Choose how this role is granted. Only Other requires your own rule.",
+  "assignment": "How is this role assigned?",
+  "assignmentHelp": "Choose how this role is assigned. If you select Other, describe how the role is assigned.",
   "assignmentExample": "For example: granted on invitation and revoked on leaving the project",
   "registered": "Registered users",
   "granted": "Granted by an administrator",
@@ -19,9 +19,9 @@
   "deny": "Denies",
   "capability": "Capability",
   "capabilityExample": "For example: approve orders or view project members",
-  "condition": "Applies when (optional)",
+  "condition": "Applies when",
   "conditionExample": "For example: only customers assigned to this person and still being followed up",
-  "requirements": "Before performing the action (optional)",
+  "requirements": "Before performing the action",
   "confirm": "Confirm again",
   "reauthenticate": "Verify identity again",
   "other": "Other",
@@ -33,7 +33,7 @@
   "inherits": "Inherits permissions",
   "childRole": "Child role",
   "parentRole": "Source role",
-  "inheritanceReason": "Evidence for inheritance (optional)",
+  "inheritanceReason": "Evidence for inheritance",
   "addChildRole": "Add child role",
   "guidance": "Check what each role can do and which data it can access, looking for excessive or missing permissions. Set one source role only when reuse is needed; grants remain independent.",
   "graphHint": "Connect the child to its source role. Return to details for local permissions and read-only inherited sources.",

package/payload/shared/bundles/role_access/locales/zh-CN.json

@@ -9,8 +9,8 @@
   "newRoleNumbered": "新角色 {index}",
   "title": "角色名称",
   "titleExample": "例如：销售经理",
-  "assignment": "谁会拥有这个角色？",
-  "assignmentHelp": "选择这个角色如何获得；只有“其他”需要自己填写规则。",
+  "assignment": "如何授予这个角色？",
+  "assignmentHelp": "选择角色的授予方式；选择“其他”时，请填写授予规则。",
   "assignmentExample": "例如：受邀加入项目后拥有，离开项目时失去",
   "registered": "注册用户",
   "granted": "由管理员授予",
@@ -19,9 +19,9 @@
   "deny": "禁止",
   "capability": "权限内容",
   "capabilityExample": "例如：审批订单、查看项目成员",
-  "condition": "适用条件（可选）",
+  "condition": "适用条件",
   "conditionExample": "例如：仅限自己负责的客户，且客户仍在跟进中",
-  "requirements": "操作前需要（可选）",
+  "requirements": "操作前需要",
   "confirm": "再次确认",
   "reauthenticate": "重新验证身份",
   "other": "其他",
@@ -33,7 +33,7 @@
   "inherits": "继承权限",
   "childRole": "子角色",
   "parentRole": "来源角色",
-  "inheritanceReason": "继承依据（可选）",
+  "inheritanceReason": "继承依据",
   "addChildRole": "添加子角色",
   "guidance": "检查各角色能做什么、作用于哪些数据，是否存在权限过多或遗漏；仅在确需复用时指定一个来源角色，授予规则仍独立。",
   "graphHint": "从子角色连向来源角色；返回详情查看本角色权限及只读的继承来源。",

package/payload/shared/bundles/smart_questions/SKILL.md

@@ -58,8 +58,10 @@ The question panel remains the interaction surface: put a concise proposal,
 its useful context and the decision to make in the card's `prompt`, with
 appropriate `choices` or free-text input. Do not put the proposed answer into
 the user's `answer` or use `detail` as a substitute for visible question text.
-In forward design, leave new `detail` empty unless it preserves an actual
-user-supplied explanation or a faithful summary of explicit user evidence.
+Free-text questions have one response field: `answer`. Keep their `detail`
+empty; any user-supplied explanation belongs with that answer. Choice questions
+may use `detail` for an actual user-supplied explanation or a faithful summary
+of explicit user evidence. Do not generate a second response area for free text.
 Put your proposed scope, rationale, examples and unresolved questions in
 `prompt`, not in user-response fields. Your earlier proposal, a Producer brief,
 and another Agent's summary do not establish that the user said or confirmed

package/payload/shared/bundles/smart_questions/reference/artifact-contract.md

@@ -60,8 +60,11 @@ overview from representative entry points and user journeys, then include only
 material supporting context. Do not ask the user how many Bundles to scan, or
 replace the overview with component, SEO, billing or deployment inventories.
 
-Put a concise source-supported answer in `answer`; use `detail` for exact
-source locations, observation versus supported inference, and remaining limits.
+Put a concise source-supported answer in `answer`. For a free-text question,
+keep source locations, observation versus supported inference and remaining
+limits with that answer; leave `detail` empty. A choice question may use its
+optional `detail` for those qualifications. Free text has no separate supplement
+input or historical supplement display.
 A supported interpretation may explain the overall product, but label it as
 inferred, not stated user intent. Do not infer commercial positioning or target
 audience merely from the presence of an admin route or a technical capability.
@@ -70,8 +73,9 @@ Reconstruction prefill is reviewable, not user confirmation; it is not a license
 to guess answers during ordinary questioning.
 
 If evidence supports part of the answer, retain that part and identify remaining
-unknowns in `detail`. Split independent topics rather than let one known fact
-mask a separate unknown. Leave genuinely unsupported answers empty. Missing
+unknowns in the same answer (or `detail` for a choice). Split independent topics
+rather than let one known fact mask a separate unknown. Leave genuinely
+unsupported answers empty. Missing
 information in one summary document is not proof of absence in the repository:
 inspect a relevant source when the missing fact matters. Preserve user answers
 and explain conflicting source evidence without replacing their decisions.
@@ -79,8 +83,9 @@ and explain conflicting source evidence without replacing their decisions.
 Before closing, read the cards as a whole: can a reader understand the product's
 purpose, intended users, main scenario and scope to the extent the source permits?
 Are later details supporting that account rather than displacing it? Check that
-`detail` does not contain a verified answer missing from `answer`, that unknowns
-remain honest, and that each inference is supported. This is an Agent self-check,
+free-text `detail` is empty, choice `detail` does not contain a verified answer
+missing from `answer`, unknowns remain honest, and each inference is supported.
+This is an Agent self-check,
 not a new validator or host gate.
 
 ## Fixed-card contract
@@ -172,7 +177,7 @@ existing panel, carry the fixed-card definition and prior user decisions
 forward into the complete canonical state without adding them to the new round.
 
 - `value` is the stable selection token. `label` is visible text. Answers always store `value`, never a label, recommendation suffix, or invented internal token.
-- `single` stores one `value`; `multiple` stores comma-separated `value`s; `text` stores its substantive free-text response in `answer` and has no choices. A known answer must not exist only in `detail`; the answer should remain understandable without opening the supplementary explanation.
+- `single` stores one `value`; `multiple` stores comma-separated `value`s; `text` stores its complete free-text response in `answer`, has no choices and leaves `detail` empty. The answer, including useful qualifications, is read and edited in one place.
 - `recommended` is the only recommendation mechanism. Do not add a question-level `suggest` field or append `(推荐)` to stored labels.
 - Dynamic-card `round` controls the FE's round grouping; the latest round renders
   first. Assign a nonnegative integer explicitly: use 0 for the first dynamic
@@ -183,7 +188,10 @@ forward into the complete canonical state without adding them to the new round.
   values to 0 and truncates fractions for grouping only. Preserve those saved
   values on unrelated edits rather than silently renumbering history. Fixed
   cards do not participate in round-number allocation.
-- `detail` records the user's optional explanation, constraints, or source/provenance notes in reconstruction; it supplements rather than duplicates the answer. Preserve older detail-only records without automatically promoting uncertainty or provenance into an answer. When the user answers
+- For a choice question, `detail` records the user's optional explanation,
+  constraints or source/provenance notes in reconstruction; it supplements rather
+  than duplicates the selection. It is not a second field for free-text questions.
+  Preserve unrelated saved data without automatic answer conversion. When the user answers
   a choice question with wording that does not match a rendered option, keep
   `answer` empty and preserve the exact wording in `detail`; never replace it
   with a recommended option. On dynamic cards, `rejected` means the user

package/payload/shared/bundles/smart_questions/schema.yaml

@@ -66,8 +66,8 @@ properties:
         # in reconstruction belong here too, without implying user confirmation.
         # Leave genuinely unknown answers empty; never promote a proposal as an answer.
         answer: { type: string }
-        # Optional supplementary explanation, constraints or source locations.
-        # Do not put a known text answer only here. A choice response outside the
+        # Optional choice-question explanation, constraints or source locations.
+        # Text questions use only answer and leave detail empty. A choice response outside the
         # available options may be preserved here without inventing a selection.
         # Supplementary detail alone does not mark the question answered.
         detail: { type: string }

package/payload/shared/bundles/web_app_prd_assembly/SKILL.md

@@ -291,6 +291,10 @@ enters Git history, G/R/A owns ongoing cross-Bundle drift checks.
 
 ### 4. Finalize inside the same agentic loop
 
+Keep `<html lang>` in the authored document's language. Fixed visual labels use
+that language as described in the shared contract; source business names remain
+unchanged and switching the Host UI does not translate the document.
+
 Once prose and provenance are complete, run the shared contract’s file-mode finalization against the already-written HTML. Do not rewrite the document or transport visual bytes through model context.
 
 If the script reports diagnostics, preserve valid content, apply the smallest

package/payload/shared/bundles/web_app_prd_assembly/locales/en-US.json

@@ -1,7 +1,7 @@
 {
   "guidance": "Check that the PRD reflects the agreed scope and key decisions. Follow source labels back to the original design when something is wrong, or request a revision in the conversation.",
   "bundleDescription": "- **Capability**: generate or update one development-ready Web App PRD from current design evidence and user material.\n- **Resolves**: the delivery gap where product, design, engineering, test, and operations still lack one shared implementation-ready specification.\n- **Candidate when**: the user asks to generate, export, update, or inspect a complete PRD.\n- **Do not infer**: PRD assembly is an on-demand delivery action, not a required design gate and not permission to mutate owner Bundles.\n- **Output**: one stable canonical `prd.html`; Git retains history.",
-  "contents": "Contents", "empty": "No PRD yet. Ask in the conversation to generate or revise the complete PRD.",
-  "pending": "Pending confirmation", "legend": "Purple rail: temporary completion to keep the PRD coherent; not yet confirmed by the user",
+  "contents": "Contents", "empty": "No PRD yet. Ask the agent in the conversation to generate or update the complete document.",
+  "pending": "Pending confirmation", "legend": "Purple markers show provisional content added to fill gaps. It still needs your confirmation.",
   "questions": "Requirements", "research": "Research", "functions": "Functions", "flows": "Flows", "style": "Design style", "data": "Business data", "rules": "Business rules", "access": "Roles and access", "integration": "Integrations", "notifications": "Notifications", "quality": "Quality and acceptance", "pages": "Pages", "whiteboard": "Whiteboard", "user": "User input", "upload": "User material"
 }

package/payload/shared/bundles/web_app_prd_assembly/locales/zh-CN.json

@@ -2,6 +2,6 @@
   "guidance": "核对 PRD 是否准确表达已确认的范围和关键决策；发现偏差时通过来源标签回到原设计，或在对话中提出修订。",
   "bundleDescription": "- **能力**：从当前设计证据和用户材料生成或修改一份可直接用于研发的完整 Web App PRD。\n- **解决**：产品仍缺少一份各交付角色都能直接理解、审阅和实施的统一需求文档。\n- **适用时机**：用户要求生成、导出、修改或查看完整 PRD。\n- **不要推断**：PRD 整合是按需交付动作，不是必经设计关卡，也不允许修改证据所属 Bundle。\n- **输出**：唯一稳定的 canonical `prd.html`；Git 保留历史修订。",
   "contents": "文档目录", "empty": "暂无 PRD。可以在对话中要求生成或修订完整 PRD。",
-  "pending": "待确认", "legend": "紫色左轨：为保持 PRD 结构完整而临时补全，尚待用户确认",
+  "pending": "待确认", "legend": "紫色标记表示为补齐文档而暂拟的内容，仍需你确认。",
   "questions": "需求问题", "research": "调研", "functions": "功能模块", "flows": "流程设计", "style": "设计风格", "data": "业务数据", "rules": "业务规则", "access": "角色权限", "integration": "集成设计", "notifications": "通知设计", "quality": "质量验收", "pages": "页面设计", "whiteboard": "自由白板", "user": "用户说明", "upload": "用户材料"
 }

package/payload/shared/bundles/web_app_prd_assembly/reference/artifact-contract.md

@@ -115,6 +115,12 @@ use file-mode scripts for transforms and final checks.
 
 ## File-mode finalization
 
+Keep the document's `<html lang>` aligned with its authored language. The visual
+script uses this existing language for fixed map captions, navigation legends
+and empty-state labels (`en`/`en-*` use English; existing Chinese/default output
+is retained otherwise). It does not translate source business text or follow
+the Host UI language. Materialization and validation use the same document language.
+
 Once the prose and provenance are complete, process the already-written HTML;
 do not rewrite it for finalization. First call `run_skill_script` with
 `path: "prd.mjs"`, `args: ["materialize-visuals"]`, and both `input_file` and

package/payload/shared/bundles/web_app_prd_assembly/scripts/prd.mjs

@@ -61,6 +61,16 @@ const compactLabel = (value, limit = 24) => {
   return text.length <= limit ? text : `${text.slice(0, limit - 1)}…`
 }
 
+const VISUAL_COPY = {
+  zh: { otherFunctions: '其他功能', noFunctions: '暂无功能', functionRoot: '产品功能结构', noPages: '暂无页面结构', functionMap: '功能范围图', pageMap: '页面关系图', primaryNavigation: '主要导航', relatedNavigation: '关联跳转' },
+  en: { otherFunctions: 'Other functions', noFunctions: 'No functions yet', functionRoot: 'Product functions', noPages: 'No page structure yet', functionMap: 'Function scope map', pageMap: 'Page map', primaryNavigation: 'Main navigation', relatedNavigation: 'Related navigation' },
+}
+function visualCopy(html) {
+  // The authored document already owns its language; Host UI never translates facts.
+  const tag = /<html\b[^>]*>/iu.exec(html)?.[0] ?? ''
+  return /^en(?:-|$)/iu.test((attribute(tag, 'lang') ?? '').trim()) ? VISUAL_COPY.en : VISUAL_COPY.zh
+}
+
 function parseSourceJson(sourceFiles, path, diagnostics) {
   const text = sourceFiles[path]
   if (typeof text !== 'string') return undefined
@@ -160,11 +170,11 @@ function svgDocument(content, viewBox) {
   return `<svg class="prd-visual-svg" xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" role="img"><defs><marker id="prd-arrow" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path d="M 0 0 L 10 5 L 0 10 z" fill="#64748b"/></marker></defs>${content}</svg>`
 }
 
-function functionMapSvg(state) {
+function functionMapSvg(state, copy) {
   const active = orderedRecords(state.functions).filter(([, item]) => item.rejected !== true)
   const groups = new Map()
   for (const [id, item] of active) {
-    const epic = String(item.function_epic ?? '').trim() || '其他功能'
+    const epic = String(item.function_epic ?? '').trim() || copy.otherFunctions
     if (!groups.has(epic)) groups.set(epic, [])
     groups.get(epic).push([id, item])
   }
@@ -175,7 +185,7 @@ function functionMapSvg(state) {
   const branches = []
   let cursorY = top
   if (groups.size === 0) {
-    branches.push({ epic: '暂无功能', functions: [], color: palette[0], centerY: 68 })
+    branches.push({ epic: copy.noFunctions, functions: [], color: palette[0], centerY: 68 })
     cursorY = 108
   } else for (const [index, [epic, functions]] of [...groups].entries()) {
     const leaves = functions.map(([id, item], leafIndex) => ({ id, item, y: cursorY + leafIndex * rowHeight }))
@@ -190,7 +200,7 @@ function functionMapSvg(state) {
     parts.push(`<path d="M ${rootX + rootWidth} ${rootY + 34} C 238 ${rootY + 34}, 246 ${branch.centerY}, ${epicX} ${branch.centerY}" fill="none" stroke="${branch.color}" stroke-width="3"/>`)
     for (const leaf of branch.functions) parts.push(`<path d="M ${epicX + epicWidth} ${branch.centerY} C 520 ${branch.centerY}, 530 ${leaf.y + 18}, ${leafX} ${leaf.y + 18}" fill="none" stroke="${branch.color}" stroke-width="2" opacity="0.72"/>`)
   }
-  parts.push(`<rect x="${rootX}" y="${rootY}" width="${rootWidth}" height="68" rx="18" fill="#4c1d95" stroke="#4c1d95"/><text x="${rootX + rootWidth / 2}" y="${rootY + 41}" text-anchor="middle" font-family="system-ui,sans-serif" font-size="17" font-weight="700" fill="#ffffff">${escapeHtml(compactLabel(state.title ?? '产品功能结构', 16))}</text>`)
+  parts.push(`<rect x="${rootX}" y="${rootY}" width="${rootWidth}" height="68" rx="18" fill="#4c1d95" stroke="#4c1d95"/><text x="${rootX + rootWidth / 2}" y="${rootY + 41}" text-anchor="middle" font-family="system-ui,sans-serif" font-size="17" font-weight="700" fill="#ffffff">${escapeHtml(state.title == null ? copy.functionRoot : compactLabel(state.title, 16))}</text>`)
   for (const branch of branches) {
     parts.push(`<rect x="${epicX}" y="${branch.centerY - 24}" width="${epicWidth}" height="48" rx="14" fill="${branch.color}" stroke="${branch.color}"/><text x="${epicX + epicWidth / 2}" y="${branch.centerY + 5}" text-anchor="middle" font-family="system-ui,sans-serif" font-size="15" font-weight="700" fill="#ffffff">${escapeHtml(compactLabel(branch.epic, 18))}</text>`)
     for (const leaf of branch.functions) {
@@ -202,7 +212,7 @@ function functionMapSvg(state) {
   return svgDocument(parts.join(''), `0 0 ${width} ${height}`)
 }
 
-function pageMapSvg(state) {
+function pageMapSvg(state, copy) {
   const pages = record(state.pages)
   const ordered = orderedRecords(pages, state.page_order)
   const ids = ordered.map(([id]) => id)
@@ -254,7 +264,7 @@ function pageMapSvg(state) {
   const maxDepth = Math.max(0, ...depths.values())
   const height = top + (maxDepth + 1) * cardHeight + maxDepth * verticalGap + 72
   const parts = []
-  parts.push('<path d="M 24 18 H 60" stroke="#6d28d9" stroke-width="3" marker-end="url(#prd-arrow)"/><text x="70" y="22" font-family="system-ui,sans-serif" font-size="12" fill="#475569">主要导航</text><path d="M 170 18 H 206" stroke="#94a3b8" stroke-width="1.5" stroke-dasharray="5 5"/><text x="216" y="22" font-family="system-ui,sans-serif" font-size="12" fill="#475569">关联跳转</text>')
+  parts.push(`<path d="M 24 18 H 60" stroke="#6d28d9" stroke-width="3" marker-end="url(#prd-arrow)"/><text x="70" y="22" font-family="system-ui,sans-serif" font-size="12" fill="#475569">${escapeHtml(copy.primaryNavigation)}</text><path d="M 170 18 H 206" stroke="#94a3b8" stroke-width="1.5" stroke-dasharray="5 5"/><text x="216" y="22" font-family="system-ui,sans-serif" font-size="12" fill="#475569">${escapeHtml(copy.relatedNavigation)}</text>`)
   for (const edge of connections.filter(edge => !primaryEdges.has(edge.id))) {
     const from = positions.get(edge.source), to = positions.get(edge.target)
     if (from === undefined || to === undefined) continue
@@ -275,7 +285,7 @@ function pageMapSvg(state) {
     const isRoot = id === primaryRoot
     parts.push(`<g data-prd-page-id="${escapeHtml(id)}"><rect x="${position.x}" y="${position.y}" width="${cardWidth}" height="${cardHeight}" rx="12" fill="${isRoot ? '#f5f3ff' : '#ffffff'}" stroke="${isRoot ? '#6d28d9' : '#94a3b8'}" stroke-width="${isRoot ? '2' : '1.2'}"/><text x="${position.x + 14}" y="${position.y + 31}" font-family="system-ui,sans-serif" font-size="14" font-weight="700" fill="#0f172a">${escapeHtml(compactLabel(page.name ?? id, 14))}</text><rect x="${position.x + 14}" y="${position.y + 45}" width="${Math.max(48, typeLabel.length * 8 + 16)}" height="20" rx="10" fill="#f1f5f9"/><text x="${position.x + 22}" y="${position.y + 59}" font-family="system-ui,sans-serif" font-size="10.5" fill="#475569">${escapeHtml(typeLabel)}</text></g>`)
   }
-  if (ordered.length === 0) parts.push('<rect x="48" y="48" width="864" height="80" rx="12" fill="#f8fafc" stroke="#cbd5e1"/><text x="480" y="96" text-anchor="middle" font-family="system-ui,sans-serif" font-size="14" fill="#64748b">暂无页面结构</text>')
+  if (ordered.length === 0) parts.push(`<rect x="48" y="48" width="864" height="80" rx="12" fill="#f8fafc" stroke="#cbd5e1"/><text x="480" y="96" text-anchor="middle" font-family="system-ui,sans-serif" font-size="14" fill="#64748b">${escapeHtml(copy.noPages)}</text>`)
   return svgDocument(parts.join(''), `0 0 ${width} ${height}`)
 }
 
@@ -304,9 +314,9 @@ function htmlPreview(item) {
   return `<figure class="prd-visual-figure" data-prd-source-ref="${escapeHtml(item.path)}" data-prd-source-digest="${digest(item.content)}" data-prd-projection-digest="${digest(item.screenshot)}"${dependencies}><figcaption class="prd-visual-caption">${escapeHtml(item.title)}</figcaption><img class="prd-page-image" loading="lazy" alt="${escapeHtml(item.title)}" width="${PAGE_VIEWPORT.width * PAGE_VIEWPORT.deviceScaleFactor}" height="${PAGE_VIEWPORT.height * PAGE_VIEWPORT.deviceScaleFactor}" src="${item.screenshot}"></figure>`
 }
 
-function renderVisual(item) {
-  if (item.kind === 'function-map') return `<figure class="prd-visual-figure" data-prd-source-ref="${escapeHtml(item.path)}"><figcaption class="prd-visual-caption">功能范围图</figcaption>${functionMapSvg(item.state)}</figure>`
-  if (item.kind === 'page-map') return `<figure class="prd-visual-figure" data-prd-source-ref="${escapeHtml(item.path)}"><figcaption class="prd-visual-caption">页面关系图</figcaption>${pageMapSvg(item.state)}</figure>`
+function renderVisual(item, copy) {
+  if (item.kind === 'function-map') return `<figure class="prd-visual-figure" data-prd-source-ref="${escapeHtml(item.path)}"><figcaption class="prd-visual-caption">${escapeHtml(copy.functionMap)}</figcaption>${functionMapSvg(item.state, copy)}</figure>`
+  if (item.kind === 'page-map') return `<figure class="prd-visual-figure" data-prd-source-ref="${escapeHtml(item.path)}"><figcaption class="prd-visual-caption">${escapeHtml(copy.pageMap)}</figcaption>${pageMapSvg(item.state, copy)}</figure>`
   if (item.kind === 'bpmn') {
     if (typeof item.renderedSvg !== 'string') throw new Error(`BPMN visual ${JSON.stringify(item.path)} has not been rendered`)
     return `<figure class="prd-visual-figure" data-prd-source-ref="${escapeHtml(item.path)}" data-prd-source-digest="${digest(item.content)}" data-prd-projection-digest="${digest(item.renderedSvg)}"><figcaption class="prd-visual-caption">${escapeHtml(item.title)}</figcaption>${item.renderedSvg}</figure>`
@@ -323,7 +333,7 @@ function replaceVisualRegion(html, name, content) {
 
 const DISTRIBUTED_VISUAL_REGIONS = new Set(['all_bpmn', 'all_page_prototypes'])
 
-function replaceDistributedVisualRegion(html, name, items, diagnostics) {
+function replaceDistributedVisualRegion(html, name, items, diagnostics, copy) {
   const regionExpression = new RegExp(`(<!--\\s*prd-visual:${name}:start\\s*-->)(?<body>[\\s\\S]*?)(<!--\\s*prd-visual:${name}:end\\s*-->)`, 'iu')
   const region = regionExpression.exec(html)
   if (region === null) throw new Error(`prd.html must keep one ordered ${name} visual region`)
@@ -336,7 +346,7 @@ function replaceDistributedVisualRegion(html, name, items, diagnostics) {
       diagnostics.push(`visual region ${JSON.stringify(name)} must place exactly one inline visual reference for ${JSON.stringify(item.path)}`)
       continue
     }
-    body = body.replace(expression, (_match, start, end) => `${start}\n${renderVisual(item)}\n${end}`)
+    body = body.replace(expression, (_match, start, end) => `${start}\n${renderVisual(item, copy)}\n${end}`)
   }
   for (const match of body.matchAll(/<!--\s*prd-visual-item:(?<path>[A-Za-z0-9._/-]+):start\s*-->/giu)) {
     const path = match.groups?.path ?? ''
@@ -346,6 +356,7 @@ function replaceDistributedVisualRegion(html, name, items, diagnostics) {
 }
 
 async function materializeVisuals(html, sourceFiles) {
+  const copy = visualCopy(html)
   const { plan, diagnostics } = visualPlan(sourceFiles)
   if (diagnostics.length > 0) return { html, diagnostics }
   try {
@@ -365,8 +376,8 @@ async function materializeVisuals(html, sourceFiles) {
   try {
     for (const name of VISUAL_REGIONS) {
       outputHtml = DISTRIBUTED_VISUAL_REGIONS.has(name)
-        ? replaceDistributedVisualRegion(outputHtml, name, plan[name], diagnostics)
-        : replaceVisualRegion(outputHtml, name, plan[name].map(renderVisual).join('\n'))
+        ? replaceDistributedVisualRegion(outputHtml, name, plan[name], diagnostics, copy)
+        : replaceVisualRegion(outputHtml, name, plan[name].map(item => renderVisual(item, copy)).join('\n'))
     }
   } catch (error) {
     diagnostics.push(error instanceof Error ? error.message : String(error))
@@ -480,6 +491,7 @@ function protectedBlocks(body) {
 }
 
 function htmlDiagnostics(state, html, template, sourceFiles) {
+  const copy = visualCopy(html)
   const diagnostics = []
   const lower = html.toLowerCase()
   if (!lower.includes('<html') || !lower.includes('</html>') || !lower.includes('<body') || !lower.includes('</body>')) diagnostics.push('prd.html must be a complete HTML document')
@@ -610,7 +622,7 @@ function htmlDiagnostics(state, html, template, sourceFiles) {
     const expected = visual.plan[name] ?? []
     const expectedRefs = expected.map(item => item.path)
     if (!DISTRIBUTED_VISUAL_REGIONS.has(name) && !expected.some(item => item.kind === 'html')) {
-      const expectedMarkup = expected.map(renderVisual).join('\n')
+      const expectedMarkup = expected.map(item => renderVisual(item, copy)).join('\n')
       if (region.trim() !== expectedMarkup.trim()) diagnostics.push(`visual region ${JSON.stringify(name)} does not match its deterministic owner projection`)
     }
     if (DISTRIBUTED_VISUAL_REGIONS.has(name)) {
@@ -661,7 +673,7 @@ function htmlDiagnostics(state, html, template, sourceFiles) {
           if (attribute(figureTag, 'data-prd-projection-digest') !== digest(svg)) diagnostics.push(`BPMN visual ${JSON.stringify(ref)} projection integrity check failed`)
         }
       } else if (item !== undefined) {
-        const expectedSvg = item.kind === 'function-map' ? functionMapSvg(item.state) : pageMapSvg(item.state)
+        const expectedSvg = item.kind === 'function-map' ? functionMapSvg(item.state, copy) : pageMapSvg(item.state, copy)
         if (!figure.includes(expectedSvg)) diagnostics.push(`visual projection ${JSON.stringify(ref)} does not match its deterministic owner projection`)
       }
     }