@szjy/ai-coms 0.1.10 → 0.1.13

package/dist/packages/common/audio/recorder.d.ts

@@ -8,12 +8,25 @@ export interface RecorderOptions {
     /** 每次采集到 16kHz PCM 分片时回调（与内部缓存共享引用，调用方如需 Transferable 请先拷贝） */
     onAudioChunk?: (chunk: Float32Array) => void;
 }
+/**
+ * 跨 ScriptProcessor 缓冲的连续线性重采样，避免每片独立插值在边界产生断裂。
+ */
+export declare class StreamResampler {
+    private ratio;
+    private leftover;
+    private fracOffset;
+    constructor(fromRate: number, toRate: number);
+    reset(): void;
+    process(chunk: Float32Array): Float32Array;
+}
 export declare class AudioRecorder {
     private targetSampleRate;
     private audioContext;
     private mediaStream;
     private sourceNode;
     private processorNode;
+    private muteGain;
+    private resampler;
     private audioChunks;
     private onVolumeChange?;
     private onAudioChunk?;
@@ -33,10 +46,6 @@ export declare class AudioRecorder {
      */
     cancel(): void;
     private cleanup;
-    /**
-     * 线性插值音频重采样
-     */
-    private resampleAudio;
 }
 /**
  * 线性插值音频重采样

package/dist/packages/common/audio/transcript-sanitize.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Whisper 转写后处理：折叠重复、去掉短音频上的常见幻觉。
+ * 实时短分片被右侧补零到 30 秒时，模型常循环输出「三十分」一类时间词。
+ */
+/**
+ * 折叠连续重复的短语与单字（「三十分三十分三十分」→「三十分」）
+ */
+export declare function collapseRepeatedPhrases(text: string): string;
+/**
+ * 按音频时长限制字数，挡住没被折叠掉的超长循环输出。
+ */
+export declare function clampTranscriptToAudio(text: string, durationSec: number): string;
+/**
+ * 清理单次推理结果。短音频上的纯幻觉直接丢弃。
+ */
+export declare function sanitizeTranscript(text: string, durationSec?: number): string;

package/dist/packages/common/audio/voice-manager.d.ts

@@ -27,7 +27,7 @@ export interface VoiceManagerOptions {
     onProgress?: (info: VoiceProgressInfo) => void;
     onVolumeChange?: (volume: number) => void;
     onAudioRecorded?: (audioUrl: string, blob: Blob) => void;
-    /** 流式中间文本（已确认分片 + 当前分片正在生成的字） */
+    /** 转写过程中的中间文本（录音结束后 / 上传文件时按 token 回推） */
     onPartial?: (text: string) => void;
     onResult?: (text: string) => void;
     onError?: (error: string) => void;
@@ -44,13 +44,8 @@ export declare class VoiceInputManager {
     private currentTaskId;
     private pcmParts;
     private pcmLength;
-    private pcmSent;
-    private streamBusy;
-    private streamFinalPending;
     private streamChunkIndex;
     private committedText;
-    private chunkPartialText;
-    private streamPumpTimer;
     constructor(options?: VoiceManagerOptions);
     get currentStatus(): VoiceStatus;
     get ready(): boolean;
@@ -59,7 +54,7 @@ export declare class VoiceInputManager {
      */
     init(customBaseUrl?: string): Promise<void>;
     /**
-     * 开始语音录入
+     * 开始语音录入（只采集，点「完成」后再转写）
      */
     startRecording(): Promise<void>;
     /**
@@ -90,20 +85,15 @@ export declare class VoiceInputManager {
      * 销毁并释放所有资源
      */
     destroy(): void;
-    private startStreamPump;
-    private stopStreamPump;
-    private getNextChunkSize;
     private resetStreamState;
     private appendPcm;
     private mergePcm;
-    private copyPcm;
-    private emitLiveText;
+    private emitPartial;
     private finishStream;
     /**
-     * 将未发送的 PCM 按固定窗口送给 Worker。
-     * isFinal=true 表示采集已结束，发完剩余尾巴后收口。
+     * 录音结束或上传：整段一次送入 Worker。超过 30s 由 Worker 按重叠窗口切分。
      */
-    private tryDispatchStreamChunk;
+    private dispatchFullAudio;
     private handleWorkerMessage;
     private setStatus;
 }

package/dist/packages/components/AiChat/src/components/plugins/markdown.d.ts

@@ -1,3 +1,3 @@
-declare let MarkdownInstance: null;
-export declare function genMarkdownIt(): null;
+declare let MarkdownInstance: MarkdownItInstance | null;
+export declare function genMarkdownIt(): MarkdownItInstance | null;
 export { MarkdownInstance };

package/dist/packages/components/AiChat/src/composables/useChatDeps.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 聊天运行时依赖加载（markdown-it / highlight.js）
+ * 挂件（sz-ai-chat）与嵌入式（sz-ai-chat-plain）两种外壳共用：
+ * 从 /scripts/ai/ 加载 markdown-it 与 highlight 脚本，完成后初始化全局 MarkdownIt 实例。
+ */
+export declare function useChatDeps(): void;

package/dist/packages/components/AiChat/src/custom-ui/actions/postMessage.d.ts

@@ -0,0 +1,12 @@
+import { SzjyUiActionContext } from '../types';
+
+/**
+ * postMessage 动作：把 actionParams 原样作为消息体发送到目标窗口。
+ * 典型消息体即 BIM 沙盘外部通信协议：
+ *   { type: 'BIM_SANDBOX', action: 'locateComponent', payload: { wbsCode } }
+ *
+ * 传输通道（customUi.postMessage.transport，默认 'auto'）：
+ * - 同窗口/同源目标存在 window.$bimSandbox 时优先直调全局方法（同步返回、即时反馈）；
+ * - 否则走 postMessage 并监听回执（跨域 iframe 场景）。
+ */
+export declare function runPostMessageAction(ctx: SzjyUiActionContext): void;

package/dist/packages/components/AiChat/src/custom-ui/components/button.d.ts

@@ -0,0 +1,9 @@
+import { SzjyUiNode, SzjyUiRenderContext } from '../types';
+
+/**
+ * button 组件渲染器。
+ * props: { type?: 按钮类型, size?: 尺寸, content?: 按钮文案 }
+ * action / actionParams 由 renderActionAttrs 统一落到 data-* 属性。
+ * 内部固定包含 .szjy-ui-btn__status 状态位，供 postMessage 回执反馈就地展示。
+ */
+export declare function renderButton(node: SzjyUiNode, _ctx: SzjyUiRenderContext): string;

package/dist/packages/components/AiChat/src/custom-ui/components/list.d.ts

@@ -0,0 +1,8 @@
+import { SzjyUiBlock, SzjyUiRenderContext } from '../types';
+
+/**
+ * list 容器组件渲染器。
+ * { title, type: 'list', gap, items: [节点...] }
+ * items 递归走组件注册表，天然支持未来嵌套其他容器。
+ */
+export declare function renderList(node: SzjyUiBlock, ctx: SzjyUiRenderContext): string;

package/dist/packages/components/AiChat/src/custom-ui/events.d.ts

@@ -0,0 +1,27 @@
+import { SzjyUiConfig } from './types';
+
+export interface SzjyUiEventOptions {
+    /**
+     * 读取宿主 customUi 配置。支持 getter（推荐）——点击时求值，
+     * 避免宿主后续更新配置（如切换沙盘地址/targetOrigin）后仍用旧值导致消息被静默丢弃
+     */
+    getConfig?: () => SzjyUiConfig | null;
+    /**
+     * 宿主拦截钩子：动作执行前调用，返回 false 阻止内置动作执行
+     * （用于宿主自定义路由/改写消息体等场景），点击时求值
+     */
+    getInterceptor?: () => ((action: string, params: any, triggerEl: HTMLElement) => any) | null | undefined;
+    /** 动作触发通知（观察性质，不影响执行），随 ui-action 事件冒泡给宿主 */
+    onAction?: (payload: {
+        action: string;
+        params: any;
+        triggerEl: HTMLElement;
+    }) => void;
+}
+/**
+ * 在容器上绑定 szjy-ui 委托点击事件，返回解绑函数。
+ *
+ * 为什么用事件委托：打字机效果每帧用 v-html 整块重建消息内容，
+ * 直接绑定在按钮节点上的监听器会随之丢失；委托挂在稳定的容器上不受影响。
+ */
+export declare function bindSzjyUiEvents(el: HTMLElement, options?: SzjyUiEventOptions): () => void;

package/dist/packages/components/AiChat/src/custom-ui/index.d.ts

@@ -0,0 +1,7 @@
+
+export * from './types';
+export { SZJY_UI_FENCE_LANG, parseSzjyUiFence } from './parse';
+export { escapeHtml, renderSzjyUiBlock, renderSzjyUiNode, renderActionAttrs } from './render';
+export { registerSzjyUiComponent, registerSzjyUiAction, getSzjyUiComponent, hasSzjyUiComponent, getSzjyUiAction, hasSzjyUiAction } from './registry';
+export { bindSzjyUiEvents } from './events';
+export type { SzjyUiEventOptions } from './events';

package/dist/packages/components/AiChat/src/custom-ui/parse.d.ts

@@ -0,0 +1,11 @@
+import { SzjyUiBlock } from './types';
+
+/** szjy-ui 自定义 fence 的语言标识 */
+export declare const SZJY_UI_FENCE_LANG = "szjy-ui";
+/**
+ * 解析 szjy-ui fence 内容为块描述。
+ * 流式输出中 JSON 尚未输出完整、或结构不合法时返回 null，
+ * 调用方（markdown fence 规则）降级为普通代码块展示；
+ * 待流式推进、JSON 完整后下一次渲染自然切换为组件。
+ */
+export declare function parseSzjyUiFence(content: string): SzjyUiBlock | null;

package/dist/packages/components/AiChat/src/custom-ui/registry.d.ts

@@ -0,0 +1,8 @@
+import { SzjyUiComponentRenderer, SzjyUiActionHandler } from './types';
+
+export declare function registerSzjyUiComponent(type: string, renderer: SzjyUiComponentRenderer): void;
+export declare function registerSzjyUiAction(name: string, handler: SzjyUiActionHandler): void;
+export declare function getSzjyUiComponent(type: string): SzjyUiComponentRenderer | undefined;
+export declare function hasSzjyUiComponent(type: string): boolean;
+export declare function getSzjyUiAction(name: string): SzjyUiActionHandler | undefined;
+export declare function hasSzjyUiAction(name: string): boolean;

package/dist/packages/components/AiChat/src/custom-ui/render.d.ts

@@ -0,0 +1,18 @@
+import { SzjyUiBlock, SzjyUiNode, SzjyUiRenderContext } from './types';
+
+/** 输出进入 v-html，所有动态文本必须经此转义 */
+export declare function escapeHtml(text: unknown): string;
+/**
+ * 渲染整个 szjy-ui 块为 HTML 字符串（含外层标识容器）。
+ * 块内未知类型的子节点在 renderSzjyUiNode 中被跳过，不影响其余节点。
+ */
+export declare function renderSzjyUiBlock(block: SzjyUiBlock): string;
+/** 按注册表分发渲染单个节点；未注册类型返回空字符串 */
+export declare function renderSzjyUiNode(node: SzjyUiNode, ctx: SzjyUiRenderContext): string;
+/**
+ * 构造节点上的动作属性（data-*），供事件委托读取。
+ * - 无 action：普通展示型组件
+ * - action 未注册：渲染为禁用态并提示，避免点击无反馈
+ * - actionParams 经 encodeURIComponent 存入 data 属性，规避引号/换行转义问题
+ */
+export declare function renderActionAttrs(node: SzjyUiNode): string;

package/dist/packages/components/AiChat/src/custom-ui/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * szjy-ui fence 块类型定义
+ *
+ * AI 响应中的 ```szjy-ui fence 块（JSON）经 parseSzjyUiFence 解析为 SzjyUiBlock，
+ * 再按组件注册表渲染为 HTML 字符串（v-html 输出），交互走容器级事件委托。
+ */
+/** 动作参数。postMessage 动作下即消息体本身（如 BIM_SANDBOX 定位协议） */
+export type SzjyUiActionParams = Record<string, any>;
+/** 单个 UI 节点（button、未来的 card/tag 等） */
+export interface SzjyUiNode {
+    type: string;
+    props?: Record<string, any>;
+    action?: string;
+    actionParams?: SzjyUiActionParams;
+    [key: string]: any;
+}
+/** 容器类节点（list 等），items 递归走组件注册表渲染 */
+export interface SzjyUiBlock extends SzjyUiNode {
+    title?: string;
+    gap?: number | string;
+    items?: SzjyUiNode[];
+}
+/** 组件渲染上下文：当前节点所属的根块 */
+export interface SzjyUiRenderContext {
+    block: SzjyUiBlock;
+}
+/**
+ * 组件渲染器：节点 → HTML 字符串。
+ * 输出会进入 v-html，渲染器必须对一切动态文本使用 escapeHtml 转义。
+ */
+export type SzjyUiComponentRenderer = (node: SzjyUiNode, ctx: SzjyUiRenderContext) => string;
+/** postMessage 动作配置（sz-ai-chat 的 customUi.postMessage） */
+export interface SzjyUiPostMessageConfig {
+    /**
+     * 目标窗口：
+     * - 'self'（默认，聊天与 BIM 沙盘同窗口的部署形态）/ 'parent' / 'top'
+     * - Window 或 Window[]（如沙盘 iframe 的 contentWindow）
+     * - 函数：发送前以消息体求值，返回 Window | Window[]
+     */
+    target?: 'self' | 'parent' | 'top' | Window | Window[] | ((message: SzjyUiActionParams) => Window | Window[]);
+    /** postMessage 的 targetOrigin，默认 '*'；生产环境建议配置为沙盘真实源 */
+    targetOrigin?: string;
+    /**
+     * 传输通道：
+     * - 'auto'（默认）：消息为 BIM_SANDBOX 协议且目标窗口存在 window.$bimSandbox 时
+     *   直调全局方法（同步返回、即时反馈，见《BIM沙盘全局方法调用文档》），否则回退 postMessage；
+     *   跨域 iframe 访问不到全局对象，自动回退
+     * - 'global'：强制仅用全局方法，不可用时按钮报「全局方法不可用」
+     * - 'postMessage'：强制仅用 postMessage（与《BIM沙盘外部通信文档》一致）
+     */
+    transport?: 'auto' | 'postMessage' | 'global';
+    /**
+     * 回执失败且原因匹配「未就绪/未加载」时的自动重试；
+     * 默认 { retries: 2, delay: 2000 }，传 false 关闭
+     */
+    retry?: false | {
+        retries?: number;
+        delay?: number;
+    };
+    /** 是否监听回执并在按钮旁展示成功/失败反馈，默认 true */
+    feedback?: boolean;
+}
+/** sz-ai-chat / sz-ai-chat-plain 的 customUi prop 结构 */
+export interface SzjyUiConfig {
+    postMessage?: SzjyUiPostMessageConfig;
+    /**
+     * 动作调试日志：点击时在 console 打印动作名、参数、消息体、目标窗口与回执结果，
+     * 默认 true；生产环境如需安静可传 false
+     */
+    debug?: boolean;
+}
+/** 动作执行上下文 */
+export interface SzjyUiActionContext {
+    /** actionParams 解析结果 */
+    params: SzjyUiActionParams;
+    /** 触发动作的节点（按钮等），供反馈定位 */
+    node?: SzjyUiNode;
+    /** 宿主传入的 customUi 配置 */
+    config: SzjyUiConfig | null;
+    /** 触发动作的 DOM 元素，用于就地展示发送/成功/失败状态 */
+    triggerEl: HTMLElement;
+}
+/** 动作处理器 */
+export type SzjyUiActionHandler = (ctx: SzjyUiActionContext) => void;

package/dist/packages/components/AiChat/src/index.vue.d.ts

@@ -56,7 +56,46 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: StringConstructor;
         default: string;
     };
-}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /**
+     * 是否显示麦克风语音输入入口，默认关闭
+     */
+    enableVoiceInput: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 是否显示上传音频/视频识别入口，默认关闭
+     */
+    enableVoiceUpload: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * szjy-ui fence 自定义 UI 配置，透传给动作处理器。
+     * 例如：{ postMessage: { target: () => sandboxIframe.contentWindow, targetOrigin: 'http://...' } }
+     */
+    customUi: {
+        type: ObjectConstructor;
+        default: null;
+    };
+    /**
+     * szjy-ui 动作拦截钩子：(action, params, triggerEl) => false 可阻止内置动作执行
+     */
+    uiActionHandler: {
+        type: FunctionConstructor;
+        default: null;
+    };
+    /**
+     * Mock 响应内容：llmName 为 standard（模拟数据模型）时不请求真实后端，
+     * 将该内容流式输出，用于联调 szjy-ui fence / postMessage 动作
+     */
+    mockResponse: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "ui-action": (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     token: {
         type: StringConstructor;
         default: string;
@@ -114,15 +153,59 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: StringConstructor;
         default: string;
     };
-}>> & Readonly<{}>, {
+    /**
+     * 是否显示麦克风语音输入入口，默认关闭
+     */
+    enableVoiceInput: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 是否显示上传音频/视频识别入口，默认关闭
+     */
+    enableVoiceUpload: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * szjy-ui fence 自定义 UI 配置，透传给动作处理器。
+     * 例如：{ postMessage: { target: () => sandboxIframe.contentWindow, targetOrigin: 'http://...' } }
+     */
+    customUi: {
+        type: ObjectConstructor;
+        default: null;
+    };
+    /**
+     * szjy-ui 动作拦截钩子：(action, params, triggerEl) => false 可阻止内置动作执行
+     */
+    uiActionHandler: {
+        type: FunctionConstructor;
+        default: null;
+    };
+    /**
+     * Mock 响应内容：llmName 为 standard（模拟数据模型）时不请求真实后端，
+     * 将该内容流式输出，用于联调 szjy-ui fence / postMessage 动作
+     */
+    mockResponse: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    "onUi-action"?: ((...args: any[]) => any) | undefined;
+}>, {
+    title: string;
+    baseUrl: string;
     token: string;
     identifier: string;
-    baseUrl: string;
-    title: string;
     llmName: string;
     messagePostRender: Function;
     extraConfig: Record<string, any>;
     soundBaseUrl: string;
     workerUrl: string;
+    enableVoiceInput: boolean;
+    enableVoiceUpload: boolean;
+    customUi: Record<string, any>;
+    uiActionHandler: Function;
+    mockResponse: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/packages/components/AiChat/src/transform/index.d.ts

@@ -1,17 +1,30 @@
 import { createSparkStylized } from '../../../../api/ai';
+import { createMockStylized } from '../../../../api/mock';
 
 /**
  * 转义处理响应值为 data: 的 json 字符串
  * 如: 科大讯飞星火、Kimi Moonshot 等大模型的 response
  */
 export declare const parseJsonLikeData: (content: any) => any;
+/**
+ * 从大模型原始输出中分离「思考过程」与「正文」，兼容两种格式：
+ * 1. 标准 <think>...</think> 包裹（DeepSeek R1 风格）
+ * 2. Dify 兼容口：思考内容直接输出在前，仅以 </think> 结尾（无开标签）
+ *
+ * isThinkingStreaming 表示流式输出尚未闭合（已出现 <think> 但还没等到 </think>）。
+ */
+export declare const parseThinking: (raw: string) => {
+    thinking: string;
+    content: string;
+    isThinkingStreaming: boolean;
+};
 /**
  * 大模型映射列表
  */
 export declare const LLMTypes: ({
     label: string;
     modelName: string;
-    api: null;
+    api: typeof createMockStylized;
 } | {
     label: string;
     modelName: string;

package/dist/packages/components/AiChatPlain/index.d.ts

@@ -0,0 +1,3 @@
+import { default as SzAiChatPlain } from './src/index.vue';
+
+export { SzAiChatPlain };