@changfenhuang/dsh-genui 0.11.1 → 0.11.2

package/lib/types/plugin/index.d.ts

@@ -13,7 +13,7 @@ import { Context } from '@deepseek-ai/cordis';
  *  Deliberately slim: the `genui` skill carries the full component→field
  *  mapping; this section keeps only the contract that must always be
  *  present (fence syntax, type whitelist, and critical behavioral rules). */
-export declare const GENUI_SECTION_TEXT = "You can render interactive UI components INSIDE your reply \u2014 between paragraphs \u2014 by emitting a fenced block with the language tag `dsh-ui` containing a JSON spec:\n\n```dsh-ui\n{\"title\":\"<user-language text>\",\"gap\":14,\"items\":[...]}\n```\n\nAllowed `type` values; the `genui` skill, when available, carries the full content\u2192component mapping and per-component field details:\n\n- \u5E03\u5C40: text \u00B7 row \u00B7 col \u00B7 grid \u00B7 card \u00B7 divider \u00B7 spacer \u00B7 hero\uFF08\u5C01\u9762\u5757\uFF0C\u4E00\u6761\u56DE\u7B54\u6700\u591A\u4E00\u4E2A\uFF09\n- \u5C55\u793A: badge \u00B7 stat \u00B7 progress \u00B7 list \u00B7 table \u00B7 keyvalue \u00B7 timeline \u00B7 file-tree \u00B7 breadcrumb \u00B7 callout \u00B7 steps \u00B7 diff \u00B7 json \u00B7 code \u00B7 copy \u00B7 avatar \u00B7 audio \u00B7 video\n- \u56FE\u8868: chart {\"kind\":\"bars|line|donut\",\"data\":[{\"label\":\"...\",\"value\":n}],\"series\":[{\"label\":\"...\",\"data\":[...]}]?,\"horizontal\":true?,\"stacked\":true?}\uFF08series\uFF1Abars \u5206\u7EC4/\u5806\u53E0 / line \u591A\u5E8F\u5217\uFF1Bhorizontal \u6A2A\u5411\u67F1\uFF09 \u00B7 echart (preset \u540D\u6216 option \u76F4\u901A\uFF0C\u9884\u8BBE\u6E05\u5355\u89C1 skill) \u00B7 plot (\u51FD\u6570\u56FE)\n- \u4EA4\u4E92: button \u00B7 input \u00B7 textarea \u00B7 select \u00B7 checkbox \u00B7 switch \u00B7 slider \u00B7 radio \u00B7 submit \u00B7 quiz \u00B7 link \u00B7 tabs \u00B7 accordion\n- \u9AD8\u7EA7: mermaid (\u6D41\u7A0B\u56FE/\u65F6\u5E8F/\u7518\u7279/ER \u7B49\uFF0C\u5173\u952E\u5B57\u89C1 skill) \u00B7 diagram (\u67B6\u6784/\u6D41\u7A0B\u56FE\uFF0C27 \u79CD kind) \u00B7 scene3d (3D WebGL)\n\n**\u9ED8\u8BA4\u5C31\u8BE5\u51FA UI**\uFF1A\u51FA\u73B0\u4E0B\u5217\u60C5\u51B5\u81F3\u5C11\u51FA\u4E00\u4E2A\u56F4\u680F\uFF1A\n- \u22653 \u6761\u5E76\u5217\u8981\u70B9 \u2192 `list`\uFF1B\u6570\u5B57\u5BF9\u6BD4 \u2192 `table`\uFF1B\u6307\u6807/\u8FDB\u5EA6/\u72B6\u6001 \u2192 `stat`/`progress`/`badge`\n- \u6B65\u9AA4/\u65F6\u95F4\u7EBF \u2192 `steps`/`timeline`/`mermaid`\uFF1B\u67B6\u6784/\u6D41\u7A0B \u2192 `diagram` \u6216 `mermaid`\uFF1B\u98CE\u9669/\u7ED3\u8BBA \u2192 `callout`\uFF1B\u4EE3\u7801/\u6539\u52A8 \u2192 `code`/`diff`/`json`\n- \u884C\u5185\u5BCC\u6587\u672C\uFF1A`text`/`list`/\u8868\u683C\u6587\u672C\u5217/`keyvalue`/`callout` \u91CC\u53EF\u5199 $\u516C\u5F0F$\u3001$$\u5757\u516C\u5F0F$$\u3001`code`\u3001**\u52A0\u7C97**\u3001==\u9AD8\u4EAE==\u3001[\u6587\u5B57](url)\u3002\n- \u9ED8\u8BA4\u65E0\u5361 \u2260 \u5C11\u7528\u7EC4\u4EF6\uFF1A\u786C\u89E6\u53D1\u7167\u5E38\u51FA\u7EC4\u4EF6\uFF0C**\u7EC4\u4EF6\u591A\u4E0D\u662F\u95EE\u9898**\u2014\u2014\u5224\u636E\u662F\u6BCF\u4E2A\u7EC4\u4EF6\u627F\u8F7D\u4E0D\u540C\u4FE1\u606F\u3001\u6709\u7126\u70B9\u4E0E\u5C42\u6B21\u3002\u5361\u7247\u53EA\u7528\u4E8E\u5E76\u6392\u9879\u4E0E\u6570\u636E\u5BF9\u8C61\uFF1B\u5355\u6BB5\u6587\u5B57\u7528\u300C\u6807\u9898 + \u6B63\u6587 + \u95F4\u8DDD\u300D\u3002\n\n**\u53D1\u56DE\u7B54\u524D\u6700\u540E\u81EA\u68C0\u4E00\u6B21**\uFF1A\u8FD9\u6BB5\u5185\u5BB9\u91CC\u6709\u6CA1\u6709 \u22653 \u6761\u5E76\u5217\u8981\u70B9\u3001\u4EFB\u4F55\u5BF9\u6BD4\u3001\u4EFB\u4F55\u6570\u5B57/\u6307\u6807\u3001\u4EFB\u4F55\u6B65\u9AA4\u6216\u6D41\u7A0B\uFF1F\u6709\u5C31\u5148\u8F6C\u6210\u7EC4\u4EF6\u518D\u5F00\u53E3\u3002**\u72B6\u6001\u6C47\u62A5\u3001\u8FDB\u5EA6\u8BF4\u660E\u3001\u63D0\u4EA4\u4E0E\u6539\u52A8\u6E05\u5355\u540C\u6837\u7B97**\u3002\n- \u8D8B\u52BF/\u5360\u6BD4 \u2192 `chart`\uFF08\u22648 \u70B9\uFF09\u6216 `echart`\uFF08\u591A\u5E8F\u5217/\u8981\u4EA4\u4E92\u65F6\uFF09\uFF1B\u914D\u8272\u9ED8\u8BA4\u8DDF\u968F\u4E3B\u9898\uFF0C\u53EA\u6709\u8BED\u4E49\u9700\u8981\u65F6\u624D\u7528 `palette`/`card.accent`\uFF1Bgrid \u5B50\u8282\u70B9\u7528 `\"span\":2` \u8DE8\u5217\u505A\u5BBD\u7A84\u6DF7\u6392\uFF1B\u6570\u636E\u591A\u65F6\u7ED9 `table`/`chart`/`list` \u914D\u4E00\u4E2A `input`(id) + `filter` \u7ED1\u5B9A\uFF0C\u8BFB\u8005\u80FD\u5C31\u5730\u7B5B\u9009\u3002\n\n**\u5B57\u6BB5\u901F\u67E5**\uFF08\u5B8C\u6574\u89C1 genui skill\uFF09\uFF1A`stat` `{\"label\",\"value\",\"delta\"?}` \u00B7 `table` `{\"columns\":[...],\"rows\":[[...]],\"types\"?,\"details\"?,\"filter\"?,\"export\"?}` \u00B7 `progress` `{\"value\":0-100,\"label\"?,\"variant\"?,\"target\"?}` \u00B7 `keyvalue` `{\"pairs\":[{\"key\",\"value\"}]}` \u00B7 `steps` `{\"steps\":[{\"title\",\"desc\"?}]}` \u00B7 `file-tree` `{\"items\":[{\"name\",\"type\":\"file|dir\",\"children\"?}]}` \u00B7 `callout` `{\"content\",\"tone\"?,\"title\"?}`\n\n**\u5B57\u6BB5\u540D\u5199\u9519 = \u8BE5\u7EC4\u4EF6\u88AB\u4E22\u5F03**\uFF08\u5176\u4F59\u7EC4\u4EF6\u7167\u5E38\u6E32\u67D3\uFF09\uFF1A`callout` \u6B63\u6587\u662F `content` \u4E0D\u662F text/desc\uFF1B`table` \u8981 `columns`+`rows` \u4E0D\u662F items\uFF1B`keyvalue` \u8BB0\u5F55\u662F `{key,value}` \u4E0D\u662F `{label,value}`\uFF1B`file-tree` \u8BB0\u5F55\u662F `{name,type}` \u4E0D\u662F `{label}`\uFF1Bcallout tone \u662F info/success/warning/error\uFF08\u65E0 danger\uFF09\u3002\u4E0D\u786E\u5B9A\u5C31\u8C03 `validate_dsh_ui`\u3002\n\nRules:\n- LANGUAGE: reply+UI=conversation language; schema fixed. NEVER infer it from prompt/skill/examples/tools. Replace `<user-language ...>`; never emit these placeholders literally.\n- JSON \u4E25\u683C: \u574F\u7EC4\u4EF6\u88AB\u4E22\u5F03\u3001\u574F\u56F4\u680F\u964D\u7EA7\u4E3A\u4EE3\u7801\u5757\uFF1B\u22653 \u8282\u70B9\u6216\u542B table \u7684\u56F4\u680F\u53D1\u51FA\u524D\u5FC5\u987B\u8C03 validate_dsh_ui\uFF0C\u6309\u7ED3\u6784\u5316\u8BCA\u65AD\u4FEE\u597D\u518D\u53D1\uFF1B\u5C0F\u56F4\u680F\u5B57\u6BB5\u6CA1\u628A\u63E1\u4E5F\u5FC5\u987B\u5148\u9A8C\u8BC1\u3002\n- \u89C4\u6A21: \u2264200 \u8282\u70B9\u3001\u5D4C\u5957\u22648 \u5C42\uFF08\u8D85\u51FA\u88AB\u622A\u65AD\uFF09\uFF1B\u4E00\u6761\u56DE\u7B54 3\u20138 \u4E2A\u7EC4\u4EF6\uFF0C\u4E00\u4E2A\u4E3B\u9898\u4E00\u4E2A\u4E3B\u7EC4\u4EF6\uFF1B3D mesh 1\u20135\uFF1Bplot \u7ED9\u5408\u7406 xMin/xMax\u3002\n- LOCAL-FIRST + actions: UI \u80FD\u81EA\u5DF1\u505A\u7684\u72B6\u6001\u53D8\u5316\uFF08\u5224\u5377\u3001\u5224\u9898\u3001\u91CD\u7F6E\u3001\u5C55\u5F00\u3001\u9009\u4E2D\uFF09\u5C31\u5730\u5B8C\u6210\uFF0C\u96F6\u5F80\u8FD4\uFF1Baction \u53EA\u7528\u4E8E\u5FC5\u987B\u6A21\u578B\u53C2\u4E0E\u7684\u4E8B\u3002\u4EA4\u4E92\u7EC4\u4EF6\u5E26 \"action\":\"name\"\uFF0C\u4EA4\u4E92\u4EE5 [genui-action] name + \u7EC4\u4EF6\u6570\u636E\u56DE\u4F20\uFF0C\u5C4A\u65F6\u91CD\u6E32\u67D3\u66F4\u65B0 UI\uFF1B\u65E0 action \u7684\u6309\u94AE\u7981\u7528\u3002\n- Durable state: \u4EA4\u4E92\u72B6\u6001\u6309\u300C\u4F1A\u8BDD+\u5185\u5BB9\u6307\u7EB9\u300D\u6301\u4E45\u5316\u2014\u2014\u5237\u65B0/\u91CD\u653E\u6062\u590D\uFF1B\u91CD\u6E32\u67D3\u76F8\u540C\u5185\u5BB9\u4FDD\u7559\uFF0C\u65B0\u5185\u5BB9\u91CD\u7F6E\u3002\n- \u5377\u5B50\u6A21\u5F0F: \u6BCF\u9898\u4E00\u4E2A radio\uFF08group+answer+explanation\uFF09+ \u4E00\u4E2A submit\uFF08groups \u5168\u5217\uFF09\uFF0C\u672C\u5730\u5224\u5206\u3002\n- Secrets ban: \u4E0D\u7D22\u53D6\u5BC6\u7801\u3001API Key\u3001Token\u3001\u6062\u590D\u7801\uFF1B\u9700\u8981\u65F6\u62D2\u7EDD\u5E76\u89E3\u91CA\u3002\n- Tool channel: render_ui \u5DE5\u5177\u628A\u540C\u4E00 spec \u6E32\u67D3\u4E3A\u5DE5\u5177\u884C\u5361\u7247\uFF08\u4EA4\u4ED8\u7269\u578B\u754C\u9762\u7528\uFF09\uFF1B\u56F4\u680F\u7528\u4E8E\u56DE\u7B54\u5185\u8054 UI\u3002\n- Panel: \"panel\":true \u53EA\u6E32\u67D3\u8FDB\u4F1A\u8BDD\u9762\u677F dock \u5E76\u539F\u5730\u66F4\u65B0\uFF1B\"append\":true \u8FFD\u52A0\u5408\u5E76\uFF08\u540C\u6807\u7B7E tabs \u8FFD\u52A0/\u65B0\u6807\u7B7E\u52A0\u5165/\u5C3E\u90E8\u8FFD\u52A0\uFF09\uFF1B\u4E0A\u9650 200 \u8282\u70B9/200 \u6B21\u8FFD\u52A0\uFF0C\u6EE1\u4E86\u53D1 replace \u91CD\u5EFA\u3002\u9762\u677F\u7EC4\u4EF6\u6765\u7684 [genui-action] \u53EA\u56DE\u4E00\u4E2A panel:true \u56F4\u680F + \u81F3\u591A\u4E00\u884C 10 \u5B57\u5185\u786E\u8BA4\uFF0C\u4E0D\u89E3\u91CA\u3001\u4E0D\u7528\u666E\u901A\u56F4\u680F\u3002";
+export declare const GENUI_SECTION_TEXT = "You can render interactive UI components INSIDE your reply \u2014 between paragraphs \u2014 by emitting a fenced block with the language tag `dsh-ui` containing a JSON spec:\n\n```dsh-ui\n{\"title\":\"<user-language text>\",\"gap\":14,\"items\":[...]}\n```\n\nAllowed `type` values; the `genui` skill, when available, carries the full content\u2192component mapping and per-component field details:\n\n- \u5E03\u5C40: text \u00B7 row \u00B7 col \u00B7 grid \u00B7 card \u00B7 divider \u00B7 spacer \u00B7 hero\uFF08\u5C01\u9762\u5757\uFF0C\u4E00\u6761\u56DE\u7B54\u6700\u591A\u4E00\u4E2A\uFF09\n- \u5C55\u793A: badge \u00B7 stat \u00B7 progress \u00B7 list \u00B7 table \u00B7 keyvalue \u00B7 timeline \u00B7 file-tree \u00B7 breadcrumb \u00B7 callout \u00B7 steps \u00B7 diff \u00B7 json \u00B7 code \u00B7 copy \u00B7 avatar \u00B7 audio \u00B7 video\n- \u56FE\u8868: chart {\"kind\":\"bars|line|donut\",\"data\":[{\"label\":\"...\",\"value\":n}],\"series\":[{\"label\":\"...\",\"data\":[...]}]?,\"horizontal\":true?,\"stacked\":true?}\uFF08series\uFF1Abars \u5206\u7EC4/\u5806\u53E0 / line \u591A\u5E8F\u5217\uFF1Bhorizontal \u6A2A\u5411\u67F1\uFF09 \u00B7 echart (preset \u540D\u6216 option \u76F4\u901A\uFF0C\u9884\u8BBE\u6E05\u5355\u89C1 skill) \u00B7 plot (\u51FD\u6570\u56FE)\n- \u4EA4\u4E92: button \u00B7 input \u00B7 textarea \u00B7 select \u00B7 checkbox \u00B7 switch \u00B7 slider \u00B7 radio \u00B7 submit \u00B7 quiz \u00B7 link \u00B7 tabs \u00B7 accordion\n- \u9AD8\u7EA7: mermaid (\u6D41\u7A0B\u56FE/\u65F6\u5E8F/\u7518\u7279/ER \u7B49\uFF0C\u5173\u952E\u5B57\u89C1 skill) \u00B7 diagram (\u67B6\u6784/\u6D41\u7A0B\u56FE\uFF0C27 \u79CD kind) \u00B7 scene3d (3D WebGL)\n\n**\u9ED8\u8BA4\u5C31\u8BE5\u51FA UI**\uFF1A\u51FA\u73B0\u4E0B\u5217\u60C5\u51B5\u81F3\u5C11\u51FA\u4E00\u4E2A\u56F4\u680F\uFF1A\n- \u22653 \u6761\u5E76\u5217\u8981\u70B9 \u2192 `list`\uFF1B\u6570\u5B57\u5BF9\u6BD4 \u2192 `table`\uFF1B\u6307\u6807/\u8FDB\u5EA6/\u72B6\u6001 \u2192 `stat`/`progress`/`badge`\n- \u6B65\u9AA4/\u65F6\u95F4\u7EBF \u2192 `steps`/`timeline`/`mermaid`\uFF1B\u67B6\u6784/\u6D41\u7A0B \u2192 `diagram` \u6216 `mermaid`\uFF1B\u98CE\u9669/\u7ED3\u8BBA \u2192 `callout`\uFF1B\u4EE3\u7801/\u6539\u52A8 \u2192 `code`/`diff`/`json`\n- \u884C\u5185\u5BCC\u6587\u672C\uFF1A\u652F\u6301\u516C\u5F0F\u3001`code`\u3001\u52A0\u7C97\u3001\u9AD8\u4EAE\u3001\u94FE\u63A5\uFF1B\u7981\u7528 Markdown table / fenced code\uFF0C\u6539\u7528 table / code / diff / json\u3002\n- \u9ED8\u8BA4\u65E0\u5361\uFF1A\u6309\u89E6\u53D1\u6761\u4EF6\u4F7F\u7528\u7EC4\u4EF6\uFF0C\u6BCF\u4E2A\u7EC4\u4EF6\u627F\u8F7D\u4E0D\u540C\u4FE1\u606F\uFF1B\u5361\u7247\u53EA\u7528\u4E8E\u5E76\u6392\u9879\u4E0E\u6570\u636E\u5BF9\u8C61\uFF0C\u5355\u6BB5\u6587\u5B57\u7528\u6807\u9898\u3001\u6B63\u6587\u4E0E\u95F4\u8DDD\u3002\n\n**\u53D1\u56DE\u7B54\u524D\u6700\u540E\u81EA\u68C0\u4E00\u6B21**\uFF1A\u8FD9\u6BB5\u5185\u5BB9\u91CC\u6709\u6CA1\u6709 \u22653 \u6761\u5E76\u5217\u8981\u70B9\u3001\u4EFB\u4F55\u5BF9\u6BD4\u3001\u4EFB\u4F55\u6570\u5B57/\u6307\u6807\u3001\u4EFB\u4F55\u6B65\u9AA4\u6216\u6D41\u7A0B\uFF1F\u6709\u5C31\u5148\u8F6C\u6210\u7EC4\u4EF6\u518D\u5F00\u53E3\u3002**\u72B6\u6001\u6C47\u62A5\u3001\u8FDB\u5EA6\u8BF4\u660E\u3001\u63D0\u4EA4\u4E0E\u6539\u52A8\u6E05\u5355\u540C\u6837\u7B97**\u3002\n- \u8D8B\u52BF/\u5360\u6BD4 \u2192 `chart`\uFF08\u22648 \u70B9\uFF09\u6216 `echart`\uFF08\u591A\u5E8F\u5217/\u8981\u4EA4\u4E92\u65F6\uFF09\uFF1B\u914D\u8272\u9ED8\u8BA4\u8DDF\u968F\u4E3B\u9898\uFF0C\u53EA\u6709\u8BED\u4E49\u9700\u8981\u65F6\u624D\u7528 `palette`/`card.accent`\uFF1Bgrid \u5B50\u8282\u70B9\u7528 `\"span\":2` \u8DE8\u5217\u505A\u5BBD\u7A84\u6DF7\u6392\uFF1B\u6570\u636E\u591A\u65F6\u7ED9 `table`/`chart`/`list` \u914D\u4E00\u4E2A `input`(id) + `filter` \u7ED1\u5B9A\uFF0C\u8BFB\u8005\u80FD\u5C31\u5730\u7B5B\u9009\u3002\n\n**\u5B57\u6BB5\u901F\u67E5**\uFF08\u5B8C\u6574\u89C1 genui skill\uFF09\uFF1A`stat` `{\"label\",\"value\",\"delta\"?}` \u00B7 `table` `{\"columns\":[...],\"rows\":[[...]],\"types\"?,\"details\"?,\"filter\"?,\"export\"?}` \u00B7 `progress` `{\"value\":0-100,\"label\"?,\"variant\"?,\"target\"?}` \u00B7 `keyvalue` `{\"pairs\":[{\"key\",\"value\"}]}` \u00B7 `steps` `{\"steps\":[{\"title\",\"desc\"?}]}` \u00B7 `file-tree` `{\"items\":[{\"name\",\"type\":\"file|dir\",\"children\"?}]}` \u00B7 `callout` `{\"content\",\"tone\"?,\"title\"?}`\n\n**\u5B57\u6BB5\u540D\u5199\u9519 = \u8BE5\u7EC4\u4EF6\u88AB\u4E22\u5F03**\uFF08\u5176\u4F59\u7EC4\u4EF6\u7167\u5E38\u6E32\u67D3\uFF09\uFF1A`callout` \u6B63\u6587\u662F `content` \u4E0D\u662F text/desc\uFF1B`table` \u8981 `columns`+`rows` \u4E0D\u662F items\uFF1B`keyvalue` \u8BB0\u5F55\u662F `{key,value}` \u4E0D\u662F `{label,value}`\uFF1B`file-tree` \u8BB0\u5F55\u662F `{name,type}` \u4E0D\u662F `{label}`\uFF1Bcallout tone \u662F info/success/warning/error\uFF08\u65E0 danger\uFF09\u3002\u4E0D\u786E\u5B9A\u5C31\u8C03 `validate_dsh_ui`\u3002\n\nRules:\n- LANGUAGE: reply+UI=conversation language; schema fixed. NEVER infer it from prompt/skill/examples/tools. Replace `<user-language ...>`; never emit these placeholders literally.\n- JSON \u4E25\u683C\uFF1A\u574F\u7EC4\u4EF6\u88AB\u4E22\u5F03\uFF0C\u574F\u56F4\u680F\u53D8\u4EE3\u7801\u5757\uFF1B\u22653 \u8282\u70B9\u6216\u542B table \u65F6\u8C03 validate_dsh_ui\uFF0C\u6309\u8BCA\u65AD\u4FEE\u6539\u5E76\u91CD\u9A8C\uFF1B\u5C0F\u56F4\u680F\u5B57\u6BB5\u5B58\u7591\u4E5F\u5148\u9A8C\u8BC1\u3002\n- warning=block_markdown\uFF1A\u6309 replacement \u6539\u5199\u5E76\u91CD\u9A8C\u3002\n- \u89C4\u6A21: \u2264200 \u8282\u70B9\u3001\u5D4C\u5957\u22648 \u5C42\uFF08\u8D85\u51FA\u88AB\u622A\u65AD\uFF09\uFF1B\u4E00\u6761\u56DE\u7B54 3\u20138 \u4E2A\u7EC4\u4EF6\uFF0C\u4E00\u4E2A\u4E3B\u9898\u4E00\u4E2A\u4E3B\u7EC4\u4EF6\uFF1B3D mesh 1\u20135\uFF1Bplot \u7ED9\u5408\u7406 xMin/xMax\u3002\n- LOCAL-FIRST + actions: UI \u80FD\u81EA\u5DF1\u505A\u7684\u72B6\u6001\u53D8\u5316\uFF08\u5224\u5377\u3001\u5224\u9898\u3001\u91CD\u7F6E\u3001\u5C55\u5F00\u3001\u9009\u4E2D\uFF09\u5C31\u5730\u5B8C\u6210\uFF0C\u96F6\u5F80\u8FD4\uFF1Baction \u53EA\u7528\u4E8E\u5FC5\u987B\u6A21\u578B\u53C2\u4E0E\u7684\u4E8B\u3002\u4EA4\u4E92\u7EC4\u4EF6\u5E26 \"action\":\"name\"\uFF0C\u4EA4\u4E92\u4EE5 [genui-action] name + \u7EC4\u4EF6\u6570\u636E\u56DE\u4F20\uFF0C\u5C4A\u65F6\u91CD\u6E32\u67D3\u66F4\u65B0 UI\uFF1B\u65E0 action \u7684\u6309\u94AE\u7981\u7528\u3002\n- Durable state: \u4EA4\u4E92\u72B6\u6001\u6309\u300C\u4F1A\u8BDD+\u5185\u5BB9\u6307\u7EB9\u300D\u6301\u4E45\u5316\u2014\u2014\u5237\u65B0/\u91CD\u653E\u6062\u590D\uFF1B\u91CD\u6E32\u67D3\u76F8\u540C\u5185\u5BB9\u4FDD\u7559\uFF0C\u65B0\u5185\u5BB9\u91CD\u7F6E\u3002\n- \u5377\u5B50\u6A21\u5F0F: \u6BCF\u9898\u4E00\u4E2A radio\uFF08group+answer+explanation\uFF09+ \u4E00\u4E2A submit\uFF08groups \u5168\u5217\uFF09\uFF0C\u672C\u5730\u5224\u5206\u3002\n- Secrets ban: \u4E0D\u7D22\u53D6\u5BC6\u7801\u3001API Key\u3001Token\u3001\u6062\u590D\u7801\uFF1B\u9700\u8981\u65F6\u62D2\u7EDD\u5E76\u89E3\u91CA\u3002\n- Tool channel: render_ui \u5DE5\u5177\u628A\u540C\u4E00 spec \u6E32\u67D3\u4E3A\u5DE5\u5177\u884C\u5361\u7247\uFF08\u4EA4\u4ED8\u7269\u578B\u754C\u9762\u7528\uFF09\uFF1B\u56F4\u680F\u7528\u4E8E\u56DE\u7B54\u5185\u8054 UI\u3002\n- Panel: \"panel\":true \u53EA\u6E32\u67D3\u8FDB\u4F1A\u8BDD\u9762\u677F dock \u5E76\u539F\u5730\u66F4\u65B0\uFF1B\"append\":true \u8FFD\u52A0\u5408\u5E76\uFF08\u540C\u6807\u7B7E tabs \u8FFD\u52A0/\u65B0\u6807\u7B7E\u52A0\u5165/\u5C3E\u90E8\u8FFD\u52A0\uFF09\uFF1B\u4E0A\u9650 200 \u8282\u70B9/200 \u6B21\u8FFD\u52A0\uFF0C\u6EE1\u4E86\u53D1 replace \u91CD\u5EFA\u3002\u9762\u677F\u7EC4\u4EF6\u6765\u7684 [genui-action] \u53EA\u56DE\u4E00\u4E2A panel:true \u56F4\u680F + \u81F3\u591A\u4E00\u884C 10 \u5B57\u5185\u786E\u8BA4\uFF0C\u4E0D\u89E3\u91CA\u3001\u4E0D\u7528\u666E\u901A\u56F4\u680F\u3002";
 /**
  * Register the GenUI output-language section and the render_ui tool.
  * @param ctx - cordis context.

package/lib/types/plugin/inline-content-diagnostic.d.ts

@@ -0,0 +1,8 @@
+import type { GenuiSpec } from '../client/spec.ts';
+export interface InlineContentWarning {
+    path: string;
+    kind: 'fenced_code' | 'markdown_table';
+    replacement: 'code' | 'table';
+}
+/** 按组件结构检查需要块级内容诊断的 canonical 显示字段。 */
+export declare function collectInlineContentWarnings(spec: GenuiSpec): InlineContentWarning[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@changfenhuang/dsh-genui",
   "description": "GenUI for DeepSeek Harness: interactive UI components rendered inline in assistant replies via the ```dsh-ui fence — layout, charts, plots, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model. Ships the fence-teaching host plugin, the browser renderer (client half), and the genui skill.",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/plugin/index.d.ts",
@@ -24,6 +24,7 @@
     "./assets/three": "./src/client/asset-three.ts",
     "./assets/echarts-core": "./src/client/asset-echarts-core.ts",
     "./assets/echarts": "./src/client/asset-echarts.ts",
+    "./assets/standalone": "./lib/assets/standalone-runtime.js",
     "./skill": "./SKILL.md"
   },
   "files": [
@@ -175,7 +176,7 @@
   "scripts": {
     "build": "node scripts/clean.mjs && tsc -p tsconfig.json && tsdown",
     "test": "vitest run",
-    "check": "node scripts/clean.mjs && tsc -p tsconfig.json && vitest run && tsdown",
+    "check": "node scripts/clean.mjs && tsc -p tsconfig.json && vitest run && tsdown && node scripts/check-standalone.mjs",
     "check:host-api": "node scripts/check-host-api.mjs",
     "prepack": "node scripts/prepack.mjs"
   },

package/src/client/EChartNode.tsx

@@ -14,16 +14,11 @@
 import { renderInline } from './inline.ts'
 import { useEffect, useRef, useState } from 'react'
 import css from './GenuiBlock.module.css'
-import { CORE_PRESETS, createChart as lazyCreateChart, type EChartsInstance } from './echarts-lazy.ts'
+import { createChart as lazyCreateChart, type EChartsInstance } from './echarts-lazy.ts'
+import { echartEngineFor } from './echarts-engine.ts'
 import { CHART_COLORS } from './blocks/charts.tsx'
 import type { GenuiEChart } from './spec.ts'
 
-/** Which engine bundle this node needs (progressive disclosure). */
-function neededEngine(node: GenuiEChart): 'core' | 'full' {
-  if (node.option !== undefined) return 'full'
-  return CORE_PRESETS.has(node.preset ?? 'bar') ? 'core' : 'full'
-}
-
 /**
  * Categorical fallback palette. The host defines its `--dsw-static-*` tokens on
  * `body`, not on `:root`, and ECharts renders to CANVAS (so a `var(--x)` string
@@ -401,7 +396,8 @@ export function EChartNode({ node }: { node: GenuiEChart }) {
     // Full `option` wins over preset shorthand.
     const option = node.option ?? presetOption(node, el)
 
-    void lazyCreateChart(el, option, { height: node.height ?? 300 }, neededEngine(node)).then((inst) => {
+    const engine = echartEngineFor(node) === 'echarts-full' ? 'full' : 'core'
+    void lazyCreateChart(el, option, { height: node.height ?? 300 }, engine).then((inst) => {
       if (!alive) {
         inst.dispose()
         return

package/src/client/GenuiBlock.tsx

@@ -82,7 +82,7 @@ function specEquivalent(a: GenuiSpec, b: GenuiSpec): boolean {
 
 /** Stateful implementation. Streaming state adopts its first durable key
  * when the reply settles; switching an existing durable key starts fresh. */
-function GenuiBlockInstance({ spec, stateKey, animateEntrance = true, initialState, onStateChange }: GenuiBlockProps) {
+function GenuiBlockInstance({ spec, stateKey, animateEntrance = true, initialState, onStateChange, onStateSnapshot }: GenuiBlockProps) {
   const gap = spec.gap ?? 16
   const onAction = useDebouncedAction(useGenuiAction())
   const stateChangeRef = useRef(onStateChange)
@@ -155,6 +155,18 @@ function GenuiBlockInstance({ spec, stateKey, animateEntrance = true, initialSta
     }),
     [answers, multiAnswers, fields, secretFields, meta, locked, round, setAnswer, setMultiAnswer, setField, registerSecretField, registerMeta, clear],
   )
+  const durableState = useMemo(() => {
+    const safeFields = Object.fromEntries(Object.entries(fields).filter(([id]) => !secretFields.has(id)))
+    return {
+      answers,
+      ...(Object.keys(multiAnswers).length > 0 ? { multiAnswers } : {}),
+      locked,
+      ...(Object.keys(safeFields).length > 0 ? { fields: safeFields } : {}),
+    }
+  }, [answers, multiAnswers, locked, fields, secretFields])
+  useEffect(() => {
+    onStateSnapshot?.(durableState)
+  }, [durableState, onStateSnapshot])
   // Achievement telemetry: every emitted action counts as one interaction
   // (the debounced emit fires once per real user action).
   const trackedAction = useMemo(() => {
@@ -167,23 +179,14 @@ function GenuiBlockInstance({ spec, stateKey, animateEntrance = true, initialSta
   // Durable save (debounced 300ms — typing in a field fires per keystroke).
   // Secret field values are stripped before writing: passwords never persist.
   useEffect(() => {
-    const safeFields = Object.fromEntries(
-      Object.entries(fields).filter(([id]) => !secretFields.has(id)),
-    )
-    const state = {
-      answers,
-      ...(Object.keys(multiAnswers).length > 0 ? { multiAnswers } : {}),
-      locked,
-      ...(Object.keys(safeFields).length > 0 ? { fields: safeFields } : {}),
-    }
     if (savesExternally) {
-      stateChangeRef.current?.(state)
+      stateChangeRef.current?.(durableState)
       return
     }
     if (stateKey === undefined) return
-    const timer = setTimeout(() => saveBlockState(stateKey, state), 300)
+    const timer = setTimeout(() => saveBlockState(stateKey, durableState), 300)
     return () => clearTimeout(timer)
-  }, [stateKey, answers, multiAnswers, locked, fields, secretFields, savesExternally])
+  }, [stateKey, durableState, savesExternally])
   // Achievement telemetry (0.9.5): the store dedupes by spec fingerprint, so
   // streaming re-renders and replays count once per distinct content.
   useEffect(() => {
@@ -235,4 +238,5 @@ export const GenuiBlock = memo(function GenuiBlock(props: GenuiBlockProps) {
   return <GenuiBlockInstance key={identity.generation} {...props} />
 }, (prev, next) => prev.stateKey === next.stateKey
   && prev.animateEntrance === next.animateEntrance && prev.onStateChange === next.onStateChange
+  && prev.onStateSnapshot === next.onStateSnapshot
   && specEquivalent(prev.spec, next.spec))

package/src/client/action-context.ts

@@ -14,7 +14,7 @@
  */
 import { createContext, useContext } from 'react'
 import type { Context } from 'react'
-import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+import * as primitives from './primitive-adapter.ts'
 
 /** v2 action handler: component action + its collected data. */
 export type GenuiActionHandler = (action: string, payload: Record<string, unknown>) => void

package/src/client/artifact/ArtifactExport.module.css

@@ -0,0 +1,64 @@
+.chrome {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  margin: 8px 0 6px;
+  font: 12px/1.4 system-ui, sans-serif;
+}
+
+.trigger,
+.item {
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 7px;
+  padding: 5px 9px;
+  background: var(--dsw-alias-bg-layer-1);
+  color: var(--dsw-alias-label-secondary);
+  cursor: pointer;
+}
+
+.trigger:hover,
+.item:hover {
+  background: var(--dsw-alias-fill-hover);
+  color: var(--dsw-alias-label-primary);
+}
+
+.menu {
+  position: absolute;
+  z-index: 20;
+  top: calc(100% + 4px);
+  right: 0;
+  display: grid;
+  min-width: 140px;
+  gap: 3px;
+  padding: 5px;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 9px;
+  background: var(--dsw-alias-bg-layer-1);
+  box-shadow: 0 8px 24px #0002;
+}
+
+.item {
+  border-color: transparent;
+  text-align: left;
+}
+
+.item:disabled {
+  opacity: .5;
+  cursor: not-allowed;
+}
+
+.menuNotice {
+  max-width: 260px;
+  padding: 2px 9px 6px;
+  color: var(--dsw-alias-state-error-primary, #d94848);
+}
+
+.notice {
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.statusError {
+  color: var(--dsw-alias-state-error-primary, #d94848);
+}

package/src/client/artifact/ExportableGenuiBlock.tsx

@@ -0,0 +1,100 @@
+import { useCallback, useEffect, useRef, useState } from 'react'
+import type { BlockInteractionState } from '../interaction-store.ts'
+import { useT } from '../i18n/index.ts'
+import { GenuiBlock } from '../GenuiBlock.tsx'
+import type { GenuiBlockProps } from '../blocks/state.ts'
+import { analyzeGenuiPortability } from './portability.ts'
+import { createGenuiArtifact } from './create.ts'
+import { downloadGenuiArtifactHtml, downloadGenuiArtifactJson } from './download.ts'
+import { GenuiExportError } from './types.ts'
+import css from './ArtifactExport.module.css'
+
+interface ArtifactExportMenuProps {
+  getArtifact: () => ReturnType<typeof createGenuiArtifact>
+}
+
+/** 提供 JSON 和 HTML 的本地化导出菜单。 */
+function ArtifactExportMenu({ getArtifact }: ArtifactExportMenuProps) {
+  const t = useT()
+  const rootRef = useRef<HTMLDivElement>(null)
+  const [open, setOpen] = useState(false)
+  const [errorMessage, setErrorMessage] = useState('')
+  const report = analyzeGenuiPortability(getArtifact().spec)
+
+  useEffect(() => {
+    if (!open) return
+    const closeOutside = (event: PointerEvent): void => {
+      if (event.target instanceof Node && !rootRef.current?.contains(event.target)) setOpen(false)
+    }
+    const closeEscape = (event: KeyboardEvent): void => {
+      if (event.key === 'Escape') setOpen(false)
+    }
+    document.addEventListener('pointerdown', closeOutside)
+    document.addEventListener('keydown', closeEscape)
+    return () => {
+      document.removeEventListener('pointerdown', closeOutside)
+      document.removeEventListener('keydown', closeEscape)
+    }
+  }, [open])
+
+  /** 执行用户选择的下载并更新辅助说明。 */
+  const exportAs = async (format: 'html' | 'json'): Promise<void> => {
+    setOpen(false)
+    setErrorMessage('')
+    try {
+      const artifact = getArtifact()
+      if (format === 'html') await downloadGenuiArtifactHtml(artifact)
+      else downloadGenuiArtifactJson(artifact)
+    } catch (error) {
+      if (error instanceof GenuiExportError) {
+        if (error.code === 'unsupported-custom-component') {
+          console.warn('[dsh-genui] standalone export rejected:', error.message)
+          setErrorMessage(t('artifact.unsupportedCustom', { types: report.customTypes.join(', ') }))
+        } else {
+          console.warn('[dsh-genui] artifact export failed:', error.code, error.message)
+          setErrorMessage(t('artifact.exportFailed'))
+        }
+      } else {
+        console.warn('[dsh-genui] artifact export failed:', error instanceof Error ? error.message : 'unknown error')
+        setErrorMessage(t('artifact.exportFailed'))
+      }
+    }
+  }
+
+  return (
+    <div className={css.chrome} ref={rootRef} data-genui-export>
+      {report.externalMedia.length > 0 && <span className={css.notice}>{t('artifact.externalMediaNotice')}</span>}
+      {errorMessage !== '' && <span className={css.statusError} aria-live="polite">{errorMessage}</span>}
+      <button type="button" className={css.trigger} aria-haspopup="menu" aria-expanded={open} onClick={() => setOpen(value => !value)}>
+        {t('artifact.export')}
+      </button>
+      {open && (
+        <div className={css.menu} role="menu">
+          <button type="button" role="menuitem" className={css.item} disabled={report.customTypes.length > 0} onClick={() => void exportAs('html')}>{t('artifact.exportHtml')}</button>
+          {report.customTypes.length > 0 && <span className={css.menuNotice}>{t('artifact.unsupportedCustom', { types: report.customTypes.join(', ') })}</span>}
+          <button type="button" role="menuitem" className={css.item} onClick={() => void exportAs('json')}>{t('artifact.exportJson')}</button>
+        </div>
+      )}
+    </div>
+  )
+}
+
+export interface ExportableGenuiBlockProps extends GenuiBlockProps {
+  exportEnabled?: boolean
+}
+
+/** 在完成态 GenUI 外层显示 artifact 导出菜单。 */
+export function ExportableGenuiBlock(props: ExportableGenuiBlockProps) {
+  const stateRef = useRef<BlockInteractionState | undefined>(undefined)
+  const captureState = useCallback((state: BlockInteractionState) => {
+    stateRef.current = state
+  }, [])
+  const getArtifact = useCallback(() => createGenuiArtifact(props.spec, stateRef.current), [props.spec])
+  const { exportEnabled = true, ...blockProps } = props
+  return (
+    <div data-genui-artifact>
+      <GenuiBlock {...blockProps} onStateSnapshot={captureState} />
+      {exportEnabled && <ArtifactExportMenu getArtifact={getArtifact} />}
+    </div>
+  )
+}

package/src/client/artifact/create.ts

@@ -0,0 +1,69 @@
+import { currentLocale } from '../i18n/index.ts'
+import { processGenuiSpec } from '../guard.ts'
+import type { BlockInteractionState } from '../interaction-store.ts'
+import type { GenuiNode, GenuiSpec } from '../spec.ts'
+import { GenuiExportError, GENUI_ARTIFACT_FORMAT, GENUI_ARTIFACT_VERSION, type CreateGenuiArtifactOptions, type GenuiArtifactTheme, type GenuiArtifactV1 } from './types.ts'
+
+/** 复制 durable 状态并移除密码字段。 */
+function safeState(state: BlockInteractionState | undefined, secretIds: Set<string>): BlockInteractionState | undefined {
+  if (state === undefined) return undefined
+  const fields = Object.fromEntries(Object.entries(state.fields ?? {}).filter(([id]) => !secretIds.has(id)))
+  return {
+    ...(state.answers === undefined ? {} : { answers: { ...state.answers } }),
+    ...(state.multiAnswers === undefined ? {} : { multiAnswers: Object.fromEntries(Object.entries(state.multiAnswers).map(([id, values]) => [id, [...values]])) }),
+    ...(state.locked === undefined ? {} : { locked: state.locked }),
+    ...(Object.keys(fields).length === 0 ? {} : { fields }),
+  }
+}
+
+/** 复制节点树并递归移除密码默认值。 */
+function sanitizeNodes(items: GenuiNode[], secretIds: Set<string>): GenuiNode[] {
+  return items.map(item => {
+    const node = JSON.parse(JSON.stringify(item)) as GenuiNode & Record<string, unknown>
+    if (node.type === 'input' && node.inputType === 'password') {
+      if (typeof node.id === 'string') secretIds.add(node.id)
+      delete node.value
+    }
+    if (Array.isArray(node.items)) {
+      if (node.type === 'list') {
+        node.items = node.items.map(child => {
+          if (typeof child === 'object' && child !== null && 'type' in child) {
+            return sanitizeNodes([child as GenuiNode], secretIds)[0]!
+          }
+          return child
+        }) as typeof node.items
+      } else {
+        node.items = sanitizeNodes(node.items as GenuiNode[], secretIds)
+      }
+    }
+    if (Array.isArray(node.tabs)) {
+      node.tabs = node.tabs.map(tab => ({ ...tab, items: sanitizeNodes(tab.items, secretIds) }))
+    }
+    if (node.type === 'table' && Array.isArray(node.details)) {
+      node.details = node.details.map(row => row === null ? null : sanitizeNodes(row, secretIds))
+    }
+    return node
+  })
+}
+
+/** 创建规范化 artifact，并清除密码默认值及对应的持久化字段。 */
+export function createGenuiArtifact(
+  spec: GenuiSpec,
+  state?: BlockInteractionState,
+  options: CreateGenuiArtifactOptions = {},
+): GenuiArtifactV1 {
+  const processed = processGenuiSpec(spec)
+  if (processed.spec === null) throw new GenuiExportError('artifact-invalid', 'invalid GenUI spec')
+  const { panel: _panel, append: _append, ...portableSpec } = processed.spec
+  const secretIds = new Set<string>()
+  const sanitizedSpec = { ...portableSpec, items: sanitizeNodes(portableSpec.items, secretIds) }
+  const theme: GenuiArtifactTheme = options.theme ?? (typeof document !== 'undefined' && document.body.hasAttribute('data-ds-dark-theme') ? 'dark' : 'light')
+  const sanitizedState = safeState(state, secretIds)
+  return {
+    format: GENUI_ARTIFACT_FORMAT,
+    version: GENUI_ARTIFACT_VERSION,
+    spec: sanitizedSpec,
+    ...(sanitizedState === undefined ? {} : { state: sanitizedState }),
+    presentation: { locale: options.locale ?? currentLocale(), theme },
+  }
+}

package/src/client/artifact/download.ts

@@ -0,0 +1,42 @@
+import { GenuiExportError, type GenuiArtifactV1 } from './types.ts'
+import { serializeGenuiArtifact } from './json.ts'
+import { buildStandaloneHtml } from './html.ts'
+
+/** 过滤文件名中的路径符号、控制字符和危险标点。 */
+export function sanitizeArtifactFilename(title: string | undefined, extension: '.html' | '.genui.json'): string {
+  const base = (title ?? '').replace(/[\\/:*?"<>|\u0000-\u001f\u007f]/g, '').trim().replace(/\s+/g, ' ').slice(0, 120).replace(/[. ]+$/g, '')
+  return `${base || 'genui'}${extension}`
+}
+
+/** 触发浏览器下载并释放临时地址。 */
+export function downloadBlob(blob: Blob, filename: string): void {
+  const url = URL.createObjectURL(blob)
+  const anchor = document.createElement('a')
+  anchor.href = url
+  anchor.download = filename
+  anchor.style.display = 'none'
+  document.body.appendChild(anchor)
+  anchor.click()
+  anchor.remove()
+  window.setTimeout(() => URL.revokeObjectURL(url), 0)
+}
+
+/** 下载规范化 GenUI JSON artifact。 */
+export function downloadGenuiArtifactJson(artifact: GenuiArtifactV1): void {
+  try {
+    downloadBlob(new Blob([serializeGenuiArtifact(artifact)], { type: 'application/json;charset=utf-8' }), sanitizeArtifactFilename(artifact.spec.title, '.genui.json'))
+  } catch (error) {
+    throw new GenuiExportError('download-failed', error instanceof Error ? error.message : 'artifact download failed')
+  }
+}
+
+/** 生成并下载独立 HTML。 */
+export async function downloadGenuiArtifactHtml(artifact: GenuiArtifactV1): Promise<void> {
+  try {
+    const html = await buildStandaloneHtml(artifact)
+    downloadBlob(new Blob([html], { type: 'text/html;charset=utf-8' }), sanitizeArtifactFilename(artifact.spec.title, '.html'))
+  } catch (error) {
+    if (error instanceof GenuiExportError) throw error
+    throw new GenuiExportError('download-failed', error instanceof Error ? error.message : 'artifact download failed')
+  }
+}

package/src/client/artifact/html.ts

@@ -0,0 +1,157 @@
+import { assetUrl } from '../asset-loader.ts'
+import { parseGenuiArtifact } from './parse.ts'
+import { analyzeGenuiPortability } from './portability.ts'
+import { GenuiExportError, type GenuiArtifactV1, type GenuiStandaloneAsset } from './types.ts'
+import { STANDALONE_THEME_CSS } from './standalone-theme.ts'
+import type { GenuiSpec } from '../spec.ts'
+
+const bundleCache = new Map<string, Promise<Uint8Array>>()
+
+/** 将二进制内容编码为不会闭合 script 标签的 Base64。 */
+function bytesToBase64(bytes: Uint8Array): string {
+  let binary = ''
+  const chunkSize = 0x8000
+  for (let offset = 0; offset < bytes.length; offset += chunkSize) {
+    binary += String.fromCharCode(...bytes.subarray(offset, Math.min(offset + chunkSize, bytes.length)))
+  }
+  return btoa(binary)
+}
+
+/** 转义 HTML 属性和标题中的文本。 */
+function escapeHtml(value: string): string {
+  return value.replace(/[&<>"']/g, character => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[character]!)
+}
+
+/** 获取并缓存构建产物字节，失败时保留可识别的导出错误。 */
+function cachedBundle(name: string, code: GenuiStandaloneAsset | 'runtime'): Promise<Uint8Array> {
+  const existing = bundleCache.get(name)
+  if (existing !== undefined) return existing
+  const task = fetch(assetUrl(name)).then(async response => {
+    if (!response.ok) throw new GenuiExportError(code === 'runtime' ? 'runtime-fetch-failed' : 'asset-fetch-failed', `${name}: HTTP ${response.status}`)
+    return new Uint8Array(await response.arrayBuffer())
+  }).catch(error => {
+    bundleCache.delete(name)
+    if (error instanceof GenuiExportError) throw error
+    throw new GenuiExportError(code === 'runtime' ? 'runtime-fetch-failed' : 'asset-fetch-failed', `${name}: ${error instanceof Error ? error.message : 'fetch failed'}`)
+  })
+  bundleCache.set(name, task)
+  return task
+}
+
+/** 创建仅存放 Base64 数据的非执行 payload 节点。 */
+function bundleElement(name: string, bytes: Uint8Array): string {
+  return `<script type="application/octet-stream" data-genui-bundle="${name}">${bytesToBase64(bytes)}</script>`
+}
+
+/** 将媒体相对地址转换为导出页面所在站点的绝对地址。 */
+function resolveMediaUrls(spec: GenuiSpec, baseURI: string): GenuiSpec {
+  const copy = structuredClone(spec)
+  /** 遍历规范中的嵌套节点和容器。 */
+  function visit(value: unknown): void {
+    if (Array.isArray(value)) {
+      for (const item of value) visit(item)
+      return
+    }
+    if (typeof value !== 'object' || value === null) return
+    const node = value as Record<string, unknown>
+    if (node.type === 'image' || node.type === 'audio' || node.type === 'video') {
+      for (const field of node.type === 'video' ? ['src', 'poster'] : ['src']) {
+        const media = node[field]
+        if (typeof media !== 'string' || /^https?:\/\//i.test(media)) continue
+        const url = new URL(media, baseURI)
+        if (url.protocol !== 'http:' && url.protocol !== 'https:') throw new GenuiExportError('artifact-invalid', `media URL cannot be exported: ${media}`)
+        node[field] = url.href
+      }
+    }
+    for (const child of Object.values(node)) visit(child)
+  }
+  visit(copy.items)
+  return copy
+}
+
+/** 返回执行内嵌 bundle 的静态启动代码。 */
+function bootstrapSource(): string {
+  return `
+async function loadBundle(element) {
+  const binary = atob(element.textContent.trim());
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0; index < binary.length; index++) bytes[index] = binary.charCodeAt(index);
+  const url = URL.createObjectURL(new Blob([bytes], { type: 'text/javascript' }));
+  try {
+    await new Promise((resolve, reject) => {
+      const script = document.createElement('script');
+      script.src = url;
+      script.onload = resolve;
+      script.onerror = reject;
+      document.head.appendChild(script);
+    });
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+}
+async function start() {
+  for (const element of document.querySelectorAll('[data-genui-bundle]')) await loadBundle(element);
+  const encoded = document.querySelector('#genui-artifact').textContent.trim();
+  const artifact = JSON.parse(new TextDecoder().decode(Uint8Array.from(atob(encoded), character => character.charCodeAt(0))));
+  window.__GenuiStandalone__.mount(document.querySelector('#genui-root'), artifact);
+}
+start().catch(error => {
+  const root = document.querySelector('#genui-root');
+  root.textContent = error instanceof Error ? error.message : 'GenUI could not start';
+  root.setAttribute('role', 'alert');
+});
+`
+}
+
+/** 使用已下载的运行文件生成完整的独立 HTML 文档。 */
+export function createStandaloneHtmlDocument(
+  artifact: GenuiArtifactV1,
+  bundles: ReadonlyMap<string, Uint8Array>,
+  baseURI = document.baseURI,
+): string {
+  const htmlArtifact = { ...artifact, spec: resolveMediaUrls(artifact.spec, baseURI) }
+  const encodedArtifact = bytesToBase64(new TextEncoder().encode(JSON.stringify(htmlArtifact)))
+  const engines = artifactPortabilityAssets(artifact).map(name => {
+    const bytes = bundles.get(`${name}.js`)
+    if (bytes === undefined) throw new GenuiExportError('asset-fetch-failed', `${name}.js: bundle unavailable`)
+    return bundleElement(name, bytes)
+  }).join('\n')
+  const runtime = bundles.get('standalone-runtime.js')
+  if (runtime === undefined) throw new GenuiExportError('runtime-fetch-failed', 'standalone-runtime.js: bundle unavailable')
+  const csp = "default-src 'none'; script-src 'unsafe-inline' blob:; style-src 'unsafe-inline'; font-src data:; img-src 'self' data: blob: https: http:; media-src 'self' data: blob: https: http:; connect-src 'none'; object-src 'none'; base-uri 'none'; form-action 'none'"
+  return `<!doctype html>
+<html lang="${artifact.presentation.locale === 'zh' ? 'zh-CN' : 'en'}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>${escapeHtml(artifact.spec.title ?? 'GenUI')}</title>
+  <meta http-equiv="Content-Security-Policy" content="${csp}">
+  <style>${STANDALONE_THEME_CSS}</style>
+</head>
+<body${artifact.presentation.theme === 'dark' ? ' data-ds-dark-theme' : ''}>
+  <main id="genui-root"></main>
+  <script type="application/octet-stream" id="genui-artifact">${encodedArtifact}</script>
+  ${engines}
+  ${bundleElement('runtime', runtime)}
+  <script>${bootstrapSource()}</script>
+</body>
+</html>`
+}
+
+/** 返回 artifact 所需图形引擎名称。 */
+function artifactPortabilityAssets(artifact: GenuiArtifactV1): GenuiStandaloneAsset[] {
+  return analyzeGenuiPortability(artifact.spec).requiredAssets
+}
+
+/** 获取独立运行文件及规格实际使用的图形引擎，生成单文件 HTML。 */
+export async function buildStandaloneHtml(rawArtifact: GenuiArtifactV1): Promise<string> {
+  const artifact = parseGenuiArtifact(rawArtifact)
+  if (artifact === null) throw new GenuiExportError('artifact-invalid', 'invalid GenUI artifact')
+  const report = analyzeGenuiPortability(artifact.spec)
+  if (report.customTypes.length > 0) {
+    throw new GenuiExportError('unsupported-custom-component', `custom components: ${report.customTypes.join(', ')}`)
+  }
+  const names = [...report.requiredAssets.map(name => `${name}.js`), 'standalone-runtime.js']
+  const results = await Promise.all(names.map(async name => [name, await cachedBundle(name, name === 'standalone-runtime.js' ? 'runtime' : name.slice(0, -3) as GenuiStandaloneAsset)] as const))
+  return createStandaloneHtmlDocument(artifact, new Map(results))
+}

package/src/client/artifact/index.ts

@@ -0,0 +1,15 @@
+export { createGenuiArtifact } from './create.ts'
+export { buildStandaloneHtml } from './html.ts'
+export { downloadGenuiArtifactHtml, downloadGenuiArtifactJson } from './download.ts'
+export { parseGenuiArtifact } from './parse.ts'
+export { analyzeGenuiPortability } from './portability.ts'
+export { serializeGenuiArtifact } from './json.ts'
+export { GenuiExportError } from './types.ts'
+export type {
+  CreateGenuiArtifactOptions,
+  GenuiArtifactTheme,
+  GenuiArtifactV1,
+  GenuiExportErrorCode,
+  GenuiPortabilityReport,
+  GenuiStandaloneAsset,
+} from './types.ts'

package/src/client/artifact/json.ts

@@ -0,0 +1,6 @@
+import type { GenuiArtifactV1 } from './types.ts'
+
+/** 以稳定缩进序列化 GenUI artifact。 */
+export function serializeGenuiArtifact(artifact: GenuiArtifactV1): string {
+  return JSON.stringify(artifact, null, 2)
+}