@fv-ui/ai-chat-core
v2.0.0
Published
@fv-ui/ai-chat 的跨端纯逻辑层:消息树/适配器协议/SSE 解析/存储协议/编排 composables/语言包(零 Element Plus、零 DOM、零 fetch)
Readme
@fv-ui/ai-chat-core
@fv-ui/ai-chat 的跨端纯逻辑层:树形消息模型、ChatAdapter 协议(OpenAI/Fv 系 SSE)、SSE 解析、存储协议、useChat/useMessages/useSend/useXStream/useRecord 编排、语言包。
- 零 Element Plus、零 DOM API、零 fetch——平台能力经
PlatformBridge注入(httpClient/decodeText/recorder/createAudioUrl/revokeAudioUrl)。 - Web 默认实现:
import { createWebBridge } from '@fv-ui/ai-chat-core/platform/web'后setPlatformBridge(createWebBridge())(@fv-ui/ai-chat 包入口已默认注入)。 - uni-app 端请自实现
PlatformHttpClient(uni.request enableChunked)注入。
已知技术债
resolveTextDecoder兜底路径每次new TextDecoder(),与webTextDecoder()单例语义存在差异:每 chunk 独立 decode,多字节字符理论上可能在 chunk 边界分裂。仅 uni-app 注入非流式解码时走兜底路径,不影响 web 端正确性,暂不改动。
已知边界
storage.ts的 localStorage 探测带typeof window !== 'undefined'守卫,SSR/非 DOM 环境自动降级为内存实现。useRecord的URL.createObjectURL/revokeObjectURL已下沉为桥能力createAudioUrl/revokeAudioUrl(core 零 DOM:小程序无 Blob/objectURL);web 桥经URL.createObjectURL实现,uni 桥返回 null(走文件路径)。platform.ts的decodeText兜底使用全局TextDecoder,uni-app 端应显式注入decodeText(经PlatformBridge或resolveTextDecoder参数)。
