yugoo-design 0.2.6 → 0.2.8

package/payload/shared/authoring/studio-creators/source/docs/system-design-baseline.md

@@ -101,7 +101,7 @@ Every host assembles the same instruction layers in this order: the host's own b
 
 DeepSeek Harness registers these layers and tools as native Cordis plugin contributions and embeds the shared Design UI in the Web application. Its Host Provider uses `agent.inject()` for durable, non-waking model context, exposes `ctx.userQuestions` for an in-turn blocking question when Bundle policy or the Agent requires native ask-user, creates each required Producer through the public Agent factory, and exposes native nested delegation to that Producer as an optional acceleration capability. It supplies package-owned `dsh.client` modules plus Remote services for the Design panel and Studio. Persistent asynchronous continuation is presented by the plugin continuation UI, and acceptance enters as an ordinary logged user turn; advisory dispositions remain plugin-owned review decisions rather than `ctx.userQuestions` interactions. The provider resolves the active Design Project through the Design System binding store instead of a Design Project, Kit, Design File, or clarity projection. Its standard `designAdvisoryInbox` projection is only a refresh/read-model mechanism and is not Design authority. CLI adapters render clarity and lifecycle state as deterministic text.
 
-Every embedded client stylesheet participates in the Host's plugin-module lifecycle. The DSH provider tags its Panel-shell, trusted-provider, and third-party panel styles with the owning `dsh.client` plugin id at module materialization, so reload and HMR replace the complete style set atomically. A late injected service scope must not privately create or dispose global stylesheet tags; provider-specific styling and shared Panel chrome cannot therefore disappear independently. Component-local inline styles remain permissible only when their DOM lifetime intentionally owns them.
+Every embedded client stylesheet participates in the Host's plugin-module lifecycle. The DSH provider tags its Panel-shell, trusted-provider, and third-party panel styles with the owning `dsh.client` package id, including its published scope, so reload and HMR replace the complete style set atomically. This ownership metadata is distinct from stable Cordis and RPC identities. On materialization, an existing tag with the same stylesheet key receives the current text and package owner; its presence alone must not retain an older revision. Independent ESM renderers retain explicit stylesheet ownership outside synchronous Host factory materialization. A late injected service scope must not privately create or dispose global stylesheet tags; provider-specific styling and shared Panel chrome cannot therefore disappear independently. Component-local inline styles remain permissible only when their DOM lifetime intentionally owns them.
 
 Codex and Claude Code integrations begin with capability discrimination, not assumed native APIs. Each adapter proves which session identity, tool, filesystem, human-question, Agent, nested-delegation, and UI capabilities are available in the installed Host version and selects only supported mappings. MCP, Skills, hooks, commands, or a companion browser may carry those mappings. Subagent placement requires an isolated Producer runtime; main placement requires equivalent invocation-scoped Design capabilities in the existing conversation. An adapter must reject an unsupported requested placement, not silently replace it. Nested delegation remains a separate optional capability. Detached execution negotiation applies only to G/R/A advisories. These presentation and execution differences cannot change selection, validation, publication, foreground attachment, or handoff semantics.
 

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/bundles/flow_design/SKILL.md

@@ -218,8 +218,10 @@ with pending records; never claim it is complete
 before the BPMN artifacts settle.
 
 1. **PLAN.** FIRST decide the product-wide role cast. It includes the built-in
-   `{"id":"System","name":"系统"}` role whenever the product has an active
-   responsibility in the process. THEN maintain ALL process
+   role with stable `id: "System"` whenever the product has an active
+   responsibility in the process. Its canonical display name follows the authored
+   language (`系统` in the Chinese example below, `System` in English); IDs and
+   display names remain unique. THEN maintain ALL process
    descriptors in ONE complete canonical state. The
    cast is decided once so every process + BPMN lane reuses the SAME names
    (no 主管/审批主管 drift). `process.stakeholders` MUST be drawn from
@@ -287,7 +289,8 @@ policy. G/R/A owns ongoing cross-Bundle drift detection after this check.
 - The plan must carry COMPLETE descriptors (description, stakeholders,
   system_responsibilities, trigger_hints, business_rules, exception_handling)
   — BPMN is authored only from this established state and the role cast.
-- Every active process includes `系统` and at least one concrete
+- Every active process includes the canonical display name of role `id: "System"`
+  and at least one concrete
   `system_responsibilities` item. If the product has no responsibility in the
   procedure, omit that procedure rather than drawing human-only choreography.
 - `trigger_hints` records only established asynchronous or event-waiting
@@ -364,7 +367,7 @@ when no exception is established.
 - **Element ids without process prefix** — causes id collisions when multiple processes render together. Always use `{ElementType}_{process_id}_{num}`.
 - **Process without a start or end event** — BPMN requires both. Every process has exactly one `<bpmn:startEvent>` and at least one `<bpmn:endEvent>`.
 - **Infrastructure "processes"** — do NOT propose processes for deployment, server setup, database migrations, CI/CD, log rotation, etc. Those are platform-managed. Only propose product user-facing / business-facing behavior.
-- **Human-only procedure presented as a product flow** — every process must reveal an actual product responsibility in the `系统` role.
+- **Human-only procedure presented as a product flow** — every process must reveal an actual product responsibility in the role with stable `id: "System"`, using its canonical display name.
 - **Known automation flattened into generic tasks** — state product work in `system_responsibilities`; author it with the appropriate BPMN activity type.
 - **Decorative BPMN events** — only express timer/message/error/conditional/signal facts established in `trigger_hints`.
 - **Inventing stakeholder roles not mentioned by the user** — use a generic name only for an evidenced participant; neither an organization title nor `管理员` is a default extra actor.

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/bundles/flow_design/reference/artifact-contract.md

@@ -6,10 +6,14 @@ new design and reconstruction without replacing domain-specific rules.
 
 Shared by authoring and reconstruction; convert established behavior into BPMN without inventing policy. Canonical state is `flow_design/flow_design.json`; active processes are listed by `process_order`, stakeholders reuse `roles[].name`. The installed schema/validation are unchanged.
 
-For product automation, the existing built-in role is
-`{"id":"System","name":"系统"}`. `System` is its ID, not its stakeholder or
-lane label: process stakeholders and BPMN lanes use the exact name `系统`.
-Check this in the canonical plan as well as the XML before accepting a file.
+For product automation, keep exactly one built-in role with stable `id: "System"`
+and a non-empty display name in the authored language, for example
+`{"id":"System","name":"系统"}` in Chinese or
+`{"id":"System","name":"System"}` in English. Role IDs and display names
+remain unique. Process stakeholders and BPMN lanes reuse the exact canonical
+`roles[].name`; resolve the product's display name by its `System` ID, never by
+a translated-name whitelist or lane ID. Check the cast, participating roles and
+automated/human task ownership before accepting a file.
 
 Bind serial/delegated activity using `artifact_kind: "flow_bpmn"`, the stable process ID and `artifact_file: "flow_design/<process_id>.bpmn"`. A Worker receives the matching process descriptor, focused evidence and this shared contract; the Producer integrates its returned file reference.
 
@@ -25,10 +29,13 @@ model tool arguments.
 Validate the file with `run_skill_script`: use `path: "bpmn-validator.mjs"`,
 `args: ["validate-bpmn-file"]`, `input_file` equal to the pre-bound BPMN path,
 and `input_context` containing
-`{"process_id":"P-...","process":{...}}`. The bounded `process` object is the
+`{"process_id":"P-...","process":{...},"roles":[...]}`. `roles` is the existing
+canonical role cast, not a new process field. The bounded `process` object is the
 matching canonical descriptor; it needs the supplied stakeholders,
 system_responsibilities, trigger_hints, and process_type. The validator returns
 only validity and diagnostics. Repair the same file and retry until it passes.
+Older calls without `roles` retain the original Chinese system-lane semantics;
+always include the canonical cast for new or revised localized files.
 
 Next call `run_skill_script` with `path: "layout.mjs"`, the same `input_file`, no
 args, and `output_file` equal to that same BPMN path. On exit 0 the Host writes the

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/bundles/flow_design/reference/bpmn_authoring.md

@@ -26,9 +26,11 @@ not useful.
 
 ## Product boundary and lanes
 
-`系统` is the product being designed, not an invented organization role. The
-brief always states its grounded responsibilities. Realize those
-responsibilities in the `系统` lane; if a proposed process has no product
+The role with stable `id: "System"` is the product being designed, not an invented
+organization role. Its display name comes from the supplied canonical cast
+(`系统` in the Chinese example below, `System` in English). The brief always
+states its grounded responsibilities. Realize those responsibilities in that
+role's exact display-name lane; if a proposed process has no product
 responsibility, it should not have reached this worker.
 
 For two or more participating roles, create exactly one lane per supplied role
@@ -57,14 +59,15 @@ decoration and do not flatten known semantics into generic tasks.
 |---|---|
 | Human works in/with the product | `userTask` in that human role lane |
 | Human performs offline work | `manualTask` in that human role lane |
-| Product runs an automated operation | `serviceTask` in `系统` |
-| Product evaluates a stated decision table/rule | `businessRuleTask` in `系统` |
-| Product sends a message/notification | `sendTask` in `系统` |
-| Product waits for a message | `receiveTask` in `系统` |
+| Product runs an automated operation | `serviceTask` in the System role lane |
+| Product evaluates a stated decision table/rule | `businessRuleTask` in the System role lane |
+| Product sends a message/notification | `sendTask` in the System role lane |
+| Product waits for a message | `receiveTask` in the System role lane |
 | Evidence does not distinguish a more specific activity | `task` |
 
-Never place `userTask`/`manualTask` in `系统`. Never place
-`serviceTask`/`businessRuleTask`/`sendTask`/`receiveTask` in a human lane.
+Never place `userTask`/`manualTask` in the System role lane, and do not use a generic
+`task` for its automated responsibility. Never place
+`serviceTask`/`businessRuleTask`/`scriptTask`/`sendTask`/`receiveTask` in a human lane.
 
 Use gateways by their actual control-flow semantics:
 
@@ -184,7 +187,7 @@ the structure to the brief; never copy its business facts or ids blindly.
 2. All ids are ASCII and process-prefixed; all references resolve.
 3. Lane names exactly match supplied stakeholders; every node belongs to one
    responsible lane.
-4. `系统` responsibilities are typed system activities; human work stays in
+4. The System role's responsibilities are typed system activities; human work stays in
    human lanes.
 5. Every supplied trigger hint is realized, and no ungrounded trigger appears.
 6. Exclusive outcomes are named; parallel/event-driven shapes use the matching

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/bundles/flow_design/reference/canvas-guide.md

@@ -19,7 +19,8 @@ uses the existing SKILL's product-boundary and process-granularity methods.
 Use the installed Bundle's structure-validation → layout → final-validation
 pipeline by file path. The layout script produces BPMN DI; never hand-author a
 second layout or patch truncated output. Lane labels use actual supplied names;
-the built-in System ID and the exact lane/stakeholder name follow the contract.
+resolve the built-in System display name from its stable ID in the canonical
+role cast, and pass that cast to both file validators as the contract specifies.
 Ports/bindings and routing remain BPMN/layout behavior, not the AI midpoint rule.
 Review readable node/condition labels and real branch/return meaning; valid DI
 does not prove readability or correct process semantics. Missing sources stay

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/bundles/flow_design/schema.yaml

@@ -21,7 +21,7 @@ properties:
       type: object
       properties:
         id: { type: string }     # ASCII slug for lane ids, e.g. "Buyer"
-        name: { type: string }   # Chinese display name, e.g. "采购员"
+        name: { type: string }   # Canonical display name in the authored language, e.g. "采购员" or "Buyer"
   processes:
     type: map
     value:

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/bundles/function_modules/reference/artifact-contract.md

@@ -75,6 +75,11 @@ do not send it to a differently pinned validator or rewrite its retained state.
 }
 ```
 
+- Optional `function_order` holds function map keys in the user’s chosen reading order.
+  Preserve it during revisions, remove deleted keys and append new keys without
+  changing unaffected positions. If absent, existing map order is used; the Panel
+  writes an order only when the user actually moves a card. Grouping still comes
+  from `function_epic`, not another membership list.
 - `function_id`, `function_name`, `function_description`, `function_epic`
   are required for every function. `priority` is optional (panel default Medium).
 - `rejected` means the user rejected the function. It remains visible in the

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/bundles/function_modules/reference/preview.json

@@ -1,4 +1,5 @@
 {
+  "function_order": ["F-PREVIEW-001", "F-PREVIEW-002"],
   "functions": {
     "F-PREVIEW-001": {
       "function_id": "F-PREVIEW-001",

package/payload/shared/authoring/studio-creators/source/packages/skills-web-app/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/authoring/studio-creators/source/packages/skills-web-app/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/authoring/studio-creators/source/packages/skills-web-app/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/authoring/studio-creators/source/packages/skills-web-app/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/authoring/studio-creators/source/packages/skills-web-app/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/authoring/studio-creators/source/packages/skills-web-app/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/ai_agent_capabilities/locales/en-US.json

@@ -2,8 +2,8 @@
   "bundleDescription": "- **Capability**: design the AI behavior embedded in a Web App as Agent or direct-model units, with user experience, complete prompts, editable Skills and tools/MCP, and Agent collaboration.\n- **Resolves**: unclear responsibilities, triggers and results, action-condition-result rules, exceptions, materials and long-term memory, and per-Agent handoffs.\n- **Candidate when**: AI behavior needs to be designed, reconstructed from evidence, or revised; required Skills and tool capabilities can be described before selecting an implementation.\n- **Do not infer**: a chat box, dependency or model name alone establishes the needed mechanisms. Saving the design does not install resources, connect services or prove evaluation success.\n- **Output**: an editable AI design panel with linked Agents, Skills and tools; preserve complete instructions, user configuration and confirmation choices.",
   "agents": "AI design units",
   "agent": "Unit",
-  "newAgent": "New Agent",
-  "numberedAgent": "New Agent {index}",
+  "newAgent": "New agent",
+  "numberedAgent": "New agent {index}",
   "empty": "Add an Agent and reference Skills and tools as needed.",
   "guidance": "Check whether the Agent goals, responsibilities and tools fit together, and whether capabilities are missing or unnecessary. Saving here records the design; it does not install or run tools.",
   "name": "Name",
@@ -14,9 +14,9 @@
   "basics": "Goal and outcome",
   "result": "Expected result",
   "boundary": "What must not happen",
-  "entries": "Entries",
-  "entry": "Entry",
-  "entryName": "Entry name",
+  "entries": "Entry points",
+  "entry": "Entry point",
+  "entryName": "Entry point name",
   "trigger": "Trigger method",
   "conversation": "Conversation",
   "action": "Button or menu",
@@ -27,7 +27,7 @@
   "actionLocation": "Action entry location",
   "backgroundCondition": "When it runs",
   "conversationInputs": "Supported input methods",
-  "actionInputs": "Additional user input (optional)",
+  "actionInputs": "Additional user input",
   "autoContext": "Automatically included information",
   "autoContextPlaceholder": "For example, selected text, the current document or the triggering event's content. Leave blank if none.",
   "feedback": "Progress feedback",
@@ -36,7 +36,7 @@
   "voice": "Audio / voice",
   "vision": "Images",
   "selection": "Selected content",
-  "entryHelp": "A unit can have multiple entries. Upload controls do not establish parsing, realtime voice or vision support.",
+  "entryHelp": "A design unit can have multiple entry points. File, voice and image controls alone do not mean the model can parse files, support real-time voice or understand images.",
   "instructions": "Working instructions",
   "systemPrompt": "System prompt",
   "promptHelp": "Complete editable instructions: responsibility, evidence, method, output and exit.",
@@ -49,11 +49,11 @@
   "capabilityPlaceholder": "Describe the ability needed, the information it uses and the useful result it returns.",
   "activation": "When to use",
   "skillBody": "Complete Skill body",
-  "source": "Source (optional)",
+  "source": "Source",
   "sourcePlaceholder": "GitHub URL, local path or provider; leave blank for original content.",
-  "resourceFiles": "Supporting files (optional)",
+  "resourceFiles": "Supporting files",
   "resourceFilesHelp": "List the locations of documents, templates or scripts used by the body. This list does not upload files.",
-  "connectionDetails": "Connection details (optional)",
+  "connectionDetails": "Connection details",
   "resourceEvidence": "Source, example or unknowns",
   "mcp": "MCP connections",
   "mcpSlot": "MCP",
@@ -101,7 +101,7 @@
   "agentRoot": "AI Agents",
   "skillRoot": "Skills",
   "toolRoot": "Tools / MCP",
-  "newskillRoot": "New Skill",
+  "newskillRoot": "New skill",
   "newtoolRoot": "New tool",
   "resourceRefs": "Available methods and capabilities",
   "resourceOrigin": "Source and references",
@@ -113,7 +113,7 @@
   "toolInterface": "Tool description and input/output",
   "connection": "Configuration",
   "toolConnectionHelp": "Keep the function interface or complete MCP connection configuration. Designing does not connect or invoke it.",
-  "authority": "Usage limits (optional)",
+  "authority": "Usage limits",
   "collaboration": "Agent collaboration",
   "delegateRefs": "Other Agents this unit can call",
   "handoff": "Responsibilities and handoff",
@@ -129,10 +129,10 @@
   "agentDesign": "Agent design",
   "experienceTab": "User experience",
   "instructionsTab": "Prompts and resources",
-  "behaviorTab": "Behavior rules",
+  "behaviorTab": "Behavior and exceptions",
   "resourceUse": "Resource use agreements",
   "scopeGroup": "Availability and boundaries",
-  "implementationDetails": "Implementation reference (optional)",
+  "implementationDetails": "Implementation reference",
   "actions": "Behavior rules",
   "actionName": "Action",
   "actionCondition": "Condition",
@@ -152,25 +152,25 @@
   "modelService": "Configuration plan",
   "modelOtherDescription": "Connection description",
   "modelServicePlaceholder": "Describe the intended service and connection approach, or provide a configuration template. Use placeholders such as ${MODEL_API_KEY}, not real keys. Unknown parameters may remain blank.",
-  "integrationRef": "Reference a system integration (optional)",
+  "integrationRef": "Reference a system integration",
   "integrationRefHelp": "Enter a plan below, or select an existing integration without duplicating its configuration.",
   "exceptionCondition": "Exception",
   "exceptionHandling": "Response",
   "collaborator": "Collaborator",
-  "localCollaborator": "Existing Agent (optional)",
-  "collaboratorHelp": "Choose an existing Agent, or leave this blank for an external collaborator. Clearing the selection restores any retained external target.",
+  "localCollaborator": "Existing agent",
+  "collaboratorHelp": "Choose an existing agent, or leave this blank to enter an external collaborator. Clearing the selection restores any external collaborator you entered earlier.",
   "externalCollaborator": "External collaborator",
   "collaborationCondition": "When to hand off",
-  "collaborationHandoff": "Task and material to hand over",
-  "collaborationResult": "Return and failure handling",
-  "modelSourceRoot": "Model entries",
-  "newModelSource": "New model entry",
+  "collaborationHandoff": "Task and context to pass along",
+  "collaborationResult": "Results and failure handling",
+  "modelSourceRoot": "Model connections",
+  "newModelSource": "New model connection",
   "knowledgeResourceRoot": "Knowledge and memory",
   "newKnowledgeResource": "New knowledge resource",
-  "modelSourceRef": "Shared model entry (optional)",
-  "modelSelection": "Model choice (optional)",
-  "modelSelectionHelp": "An intended model, not verified runtime configuration. Agents can select different models through one entry.",
-  "modelSourceHelp": "Select an established entry. The selected entry owns connection intent; retained Agent connection fields are inactive until you clear the selection.",
+  "modelSourceRef": "Shared model connection",
+  "modelSelection": "Model choice",
+  "modelSelectionHelp": "Record the intended model; this is not a verified runtime configuration. Different agents can use different models through the same connection.",
+  "modelSourceHelp": "Select a defined connection to use its settings. The agent’s individual connection settings are kept but inactive until you clear this selection.",
   "resourceDescription": "Purpose and connection intent",
   "knowledgeResourceRefs": "Knowledge and memory used",
   "knowledgeKind": "Resource type",
@@ -184,10 +184,11 @@
   "memoryFormationUpdateHelp": "Describe user-saved or Agent-curated memory, and whether updates or corrections need user confirmation.",
   "memoryUserManagement": "User control",
   "memoryUserManagementHelp": "Describe how users inspect, correct and clear memory, and what happens after clearing. Keep undecided behavior explicit.",
-  "knowledgeAccessScope": "Access and sharing scope (optional)",
+  "knowledgeAccessScope": "Access and sharing scope",
   "knowledgeAccessScopePlaceholder": "For example: private to a user, current project or shared with a team. Leave blank when no extra requirement is needed.",
   "knowledgeResourceHelp": "Resource records own their content and maintenance plan, not access grants or shared user data. Add only this Agent’s use conditions and differences, not a copied resource definition.",
-  "modelSourceLink": "Model entry",
+  "modelSourceLink": "Model connection",
   "knowledgeResourceLink": "Knowledge / memory",
-  "legacyConnectionGroup": "Per-Agent connection (when no shared entry is selected)"
+  "legacyConnectionGroup": "Individual agent connection (when no shared connection is selected)",
+  "knowledgeResource": "Knowledge resource"
 }

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

@@ -2,14 +2,14 @@
   "bundleDescription": "- **能力**：以 Agent 或单次模型调用为单元，设计 Web App 中的 AI 功能，包括使用体验、完整提示词、可编辑的技能与工具/MCP，以及 Agent 协作。\n- **解决**：职责、触发方式和结果不清晰，行为规则中的动作、条件、结果，以及异常处理、资料与长期记忆、Agent 交接缺少设计的问题。\n- **适用时机**：需要设计、基于证据还原或调整 AI 功能时；可以先明确所需技能与工具能力，再选择具体实现。\n- **不要推断**：不能仅凭对话框、依赖或模型名称认定 AI 机制已经明确。保存设计不会安装资源、连接服务，也不代表通过实际评测。\n- **输出**：相互引用的 Agent、技能与工具设计面板，保留完整指令、用户配置和确认选择。",
   "agents": "AI 设计单元",
   "agent": "设计单元",
-  "newAgent": "新 Agent",
-  "numberedAgent": "新 Agent {index}",
-  "empty": "添加一个 Agent，按需引用技能和工具。",
-  "guidance": "核对 Agent 的目标、能力分工和工具是否匹配，有无缺失或不必要的能力；这里保存的是设计，不会安装或执行工具。",
+  "newAgent": "新智能体",
+  "numberedAgent": "新智能体 {index}",
+  "empty": "添加一个智能体，按需引用技能和工具。",
+  "guidance": "核对智能体的目标、能力分工和工具是否匹配，有无缺失或不必要的能力；这里保存的是设计，不会安装或执行工具。",
   "name": "名称",
   "description": "职责与目标",
   "functionRefs": "关联功能",
-  "agentKind": "Agent",
+  "agentKind": "智能体",
   "modelCall": "模型直调",
   "basics": "目标与结果",
   "result": "预期结果",
@@ -27,7 +27,7 @@
   "actionLocation": "操作入口",
   "backgroundCondition": "触发时机",
   "conversationInputs": "支持的输入方式",
-  "actionInputs": "用户补充输入（选填）",
+  "actionInputs": "用户补充输入",
   "autoContext": "自动带入的信息",
   "autoContextPlaceholder": "例如选中的文字、当前文档或触发事件携带的内容；没有则留空。",
   "feedback": "过程反馈",
@@ -40,20 +40,20 @@
   "instructions": "工作说明",
   "systemPrompt": "系统提示词",
   "promptHelp": "完整可编辑的指令正文：职责、证据、方法、输出与退出条件。",
-  "resources": "Skill、MCP 与工具",
+  "resources": "技能、MCP 与工具",
   "resourcesHelp": "选择已定义的资源；完整内容在左侧独立维护。这里补充使用范围。只有用户要求时才搜索推荐，保存不会安装或连接。",
-  "skills": "Skill 配置",
-  "skillSlot": "Skill",
+  "skills": "技能配置",
+  "skillSlot": "技能",
   "slotName": "名称",
   "purpose": "能力说明",
   "capabilityPlaceholder": "说明需要什么能力、会使用什么信息、应给出什么结果。",
   "activation": "适用情形",
-  "skillBody": "完整 Skill 正文",
-  "source": "来源（选填）",
+  "skillBody": "完整技能正文",
+  "source": "来源",
   "sourcePlaceholder": "GitHub 地址、本地路径或提供方；自行编写可留空。",
-  "resourceFiles": "附带文件（可选）",
+  "resourceFiles": "附带文件",
   "resourceFilesHelp": "记录正文会用到的参考文档、模板或脚本的位置；这里维护文件清单，不上传文件。",
-  "connectionDetails": "接入配置（可选）",
+  "connectionDetails": "接入配置",
   "resourceEvidence": "来源、样例或待确认项",
   "mcp": "MCP 配置",
   "mcpSlot": "MCP",
@@ -98,7 +98,7 @@
   "evidence": "设计依据与未确定事项",
   "references": "固定版本来源",
   "other": "已有／自建／其他",
-  "agentRoot": "AI Agent",
+  "agentRoot": "AI 智能体",
   "skillRoot": "技能",
   "toolRoot": "工具 / MCP",
   "newskillRoot": "新技能",
@@ -113,9 +113,9 @@
   "toolInterface": "工具说明与输入输出",
   "connection": "配置内容",
   "toolConnectionHelp": "函数工具保留接口定义；MCP 保留完整连接配置。这里只设计，不调用或连接。",
-  "authority": "使用限制（可选）",
-  "collaboration": "Agent 协作",
-  "delegateRefs": "可以调用的其他 Agent",
+  "authority": "使用限制",
+  "collaboration": "智能体协作",
+  "delegateRefs": "可以调用的其他智能体",
   "handoff": "各自负责什么、如何交接",
   "externalDelegation": "其他协作方（如有）",
   "relationTitle": "AI 资源关系",
@@ -126,13 +126,13 @@
   "modelAccess": "模型使用方式",
   "inheritModelAccess": "沿用已有模型接入",
   "configureModelAccess": "由产品提供模型配置",
-  "agentDesign": "Agent 设计",
+  "agentDesign": "智能体设计",
   "experienceTab": "使用体验",
   "instructionsTab": "提示词与资源",
-  "behaviorTab": "行为规则",
+  "behaviorTab": "行为与异常",
   "resourceUse": "资源使用约定",
   "scopeGroup": "使用条件与边界",
-  "implementationDetails": "实现参考（可选）",
+  "implementationDetails": "实现参考",
   "actions": "行为规则",
   "actionName": "动作",
   "actionCondition": "条件",
@@ -152,25 +152,25 @@
   "modelService": "配置方案",
   "modelOtherDescription": "接入说明",
   "modelServicePlaceholder": "说明拟使用的服务和接入安排，也可填写配置模板；真实密钥请用 ${MODEL_API_KEY} 等占位符。尚未确定的参数可留空。",
-  "integrationRef": "引用系统集成（可选）",
+  "integrationRef": "引用系统集成",
   "integrationRefHelp": "可以直接填写下方配置方案；已有系统集成时选择引用，无需重复填写其配置。",
   "exceptionCondition": "异常情况",
   "exceptionHandling": "处理方式",
   "collaborator": "协作对象",
-  "localCollaborator": "已有 Agent（可选）",
-  "collaboratorHelp": "选择已有 Agent，或留空填写外部协作方。清空选择后可恢复已填的外部对象。",
+  "localCollaborator": "已有智能体",
+  "collaboratorHelp": "选择已有智能体，或留空填写外部协作方。清空选择后可恢复已填的外部对象。",
   "externalCollaborator": "外部协作方",
   "collaborationCondition": "何时交接",
   "collaborationHandoff": "交给它什么",
   "collaborationResult": "返回结果与失败处理",
-  "modelSourceRoot": "模型入口",
-  "newModelSource": "新模型入口",
+  "modelSourceRoot": "模型接入",
+  "newModelSource": "新模型接入",
   "knowledgeResourceRoot": "知识与记忆",
   "newKnowledgeResource": "新知识资源",
-  "modelSourceRef": "共享模型入口（可选）",
-  "modelSelection": "模型选择（可选）",
-  "modelSelectionHelp": "记录期望使用的模型，不是已验证的运行配置。同一入口可以为不同 Agent 选择不同模型。",
-  "modelSourceHelp": "选择已明确的入口后，由入口持有接入意图；原 Agent 接入字段保留但停用，清空选择后恢复。",
+  "modelSourceRef": "共享模型接入",
+  "modelSelection": "模型选择",
+  "modelSelectionHelp": "记录期望使用的模型，不是已验证的运行配置。同一接入方式可以为不同智能体选择不同模型。",
+  "modelSourceHelp": "选择已明确的接入方式后，将使用该方式的配置；原智能体的独立接入配置会保留但停用，清空选择后恢复。",
   "resourceDescription": "用途与接入意图",
   "knowledgeResourceRefs": "使用的知识与记忆",
   "knowledgeKind": "资源类型",
@@ -181,13 +181,14 @@
   "knowledgeSourceMaintenance": "来源与维护",
   "knowledgeSourceMaintenanceHelp": "说明资料来自哪里、由谁更新；内置资料、用户上传或已有业务资料均可，不需要数据库和接口参数。",
   "memoryFormationUpdate": "形成与更新",
-  "memoryFormationUpdateHelp": "说明由用户主动保存还是 Agent 整理，以及更新、纠错是否需要用户确认。",
+  "memoryFormationUpdateHelp": "说明由用户主动保存还是智能体整理，以及更新、纠错是否需要用户确认。",
   "memoryUserManagement": "用户管理",
   "memoryUserManagementHelp": "说明用户如何查看、纠正和清除记忆，以及清除后的行为；尚未确定的保留为待确认项。",
-  "knowledgeAccessScope": "使用与共享范围（选填）",
+  "knowledgeAccessScope": "使用与共享范围",
   "knowledgeAccessScopePlaceholder": "如个人私有、当前项目或团队共享；没有额外要求可以留空。",
-  "knowledgeResourceHelp": "资源条目定义内容与维护方式，不授予访问权限或共享用户数据。这里只补充当前 Agent 的使用条件与差异，不重复整份资源说明。",
-  "modelSourceLink": "模型入口",
+  "knowledgeResourceHelp": "资源条目定义内容与维护方式，不授予访问权限或共享用户数据。这里只补充当前智能体的使用条件与差异，不重复整份资源说明。",
+  "modelSourceLink": "模型接入",
   "knowledgeResourceLink": "知识 / 记忆",
-  "legacyConnectionGroup": "Agent 独立接入（未选择共享入口时）"
+  "legacyConnectionGroup": "智能体独立接入（未选择共享接入方式时）",
+  "knowledgeResource": "知识资源"
 }