@szjy/ai-coms 0.1.12 → 0.1.13

package/README.md

@@ -309,6 +309,46 @@ const handleMessagePostRender = (container: HTMLElement, textContent: string) =>
 > 完整教程见 [`docs/message-post-render.md`](docs/message-post-render.md)。
 
 
+---
+
+### szjy-ui fence：AI 结构化输出渲染为可交互组件（驱动 BIM 沙盘等外部页面）
+
+AI 响应中的 ```` ```szjy-ui ```` fence 块（JSON）会渲染为可交互组件（内置 `list` 容器 / `button`），用户点击触发动作（内置 `postMessage`），把 `actionParams` 原样作为消息体发送到目标窗口——典型场景为 BIM 沙盘构件定位（`BIM_SANDBOX` 协议，详见《BIM沙盘外部通信文档》）。
+
+```vue
+<template>
+  <!-- 聊天与沙盘同窗口：target 默认 self 即可 -->
+  <sz-ai-chat llmName="dify-openai" ... />
+
+  <!-- 宿主页嵌沙盘 iframe：指定目标窗口与真实源 -->
+  <sz-ai-chat
+    :customUi="{ postMessage: { target: () => sandboxIframe.contentWindow, targetOrigin: 'http://172.17.102.17:5174' } }"
+  />
+</template>
+```
+
+````
+```szjy-ui
+{
+  "title": "构件列表",
+  "type": "list",
+  "gap": 12,
+  "items": [
+    { "type": "button", "props": { "type": "primary", "content": "查看构件1" },
+      "action": "postMessage",
+      "actionParams": { "type": "BIM_SANDBOX", "action": "locateComponent", "payload": { "wbsCode": "CHKSLDY-SD-001" } } }
+  ]
+}
+```
+````
+
+特性：流式中 JSON 未完整时降级为代码块、完成后自动切换；回执反馈（成功/失败就地展示，未就绪自动重试）；组件/动作均注册表模式，宿主可用 `registerSzjyUiComponent` / `registerSzjyUiAction` 扩展。
+
+配套 **Mock 模式**（不调真实后端）：`llmName="standard"` + `:mockResponse="文本"` 即可流式输出自定义响应（内置样例 `DEFAULT_MOCK_RESPONSE`），examples 第 4 个 tab「BIM 沙盘 Mock 联调」提供完整联调环境（mock 编辑 + 沙盘 iframe + 协议消息日志）。
+
+> 完整文档见 [`docs/szjy-ui-fence.md`](docs/szjy-ui-fence.md)。
+
+
 ---
 
 ### 项目维护规范

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export * from './packages/common/custom-render/index';
 export * from './packages/common/audio/opfs-cache';
 export * from './packages/common/audio/voice-manager';
 export * from './packages/common/audio/recorder';
+export * from './packages/components/AiChat/src/custom-ui';
+export { createMockStylized, DEFAULT_MOCK_RESPONSE } from './packages/api/mock';
 export { default as create } from './packages/components/create';
 declare const _default: {
     install(app: App): void;