更新记录

1.0.1（2026-04-10）

支持FAQ数据管理、知识库管理、产品管理、推荐规则配置、向量检索推荐、多角色客服配置管理

平台兼容性

uni-app(3.7.3)

uni-app x(4.0)

其他

SMA 智能对话浮窗（uni_modules）

开通账号，请联系 v x: hogwartsfan

与 SMA 后端 HTTP 接口对接的悬浮客服 / AI 对话组件，支持 Vue3 + uni-app：微信小程序、App、H5。行为与同源 H5 SDK（SSE 流式 data: {"content":"..."}）一致，支持 被动代码唤起（smaChatOpen）。

兼容性（老项目是否可用？）

注意： sma-chat-float 与 sma-chat-float-vue2 不要同屏同时挂载；被动 API 分别对应 utils/controller（Vue3）与 js_sdk/controller.js（Vue2），混用会导致注册互相覆盖。

Vue2 项目接入

<template>
  <view class="page">
    <sma-chat-float-vue2 :config="chatConfig" />
  </view>
</template>

<script>
export default {
  data() {
    return {
      chatConfig: {
        apiKey: 'YOUR_API_KEY',
        agentCode: 'YOUR_AGENT_CODE',
        apiUrl: 'API_BASE_URL',
        title: 'AI智能客服',
      },
    };
  },
};
</script>

被动打开（需隐藏悬浮球时 :show-launcher="false"）：

import {
  smaChatOpen,
  smaChatClose,
  smaChatToggle,
} from '@/uni_modules/sma-chat/js_sdk/controller.js';

老项目若 不支持 ES import，可在 HBuilderX 中确认已开启 babel 编译，或使用 npm 版 vue-cli 工程 默认配置。

微信小程序说明

微信端 style 只能是字符串。本插件已避免在模板里写 :style="{ ... }" 与 CSS v-bind，若你本地改过样式绑定，请同样改为字符串（例如 'background:' + color）。

Vue2（vue-cli-plugin-uni）：模板里 :style 不要写带参数的方法（如 :style="foo(x)"），请用计算属性在数据里先拼好样式字符串（本组件已用 messageRows[].bubbleStyle）。

电脑正常、真机 / 体验版无回复？

常见原因与排查：

1. 开发者工具「不校验合法域名」
   勾选后电脑端即使未配域名也能请求；真机与体验版一定会校验。请在微信公众平台 → 开发 → 开发管理 → 服务器域名 → request 合法域名 中添加 https://API_BASE_URL 里的主机名：API_BASE_URL（不要带 https://、不要路径）。保存后等几分钟再测。

2. 配置的 apiUrl 与域名不一致
   若 apiUrl 写成其它域名或 IP，白名单必须包含该主机名。

3. 流式分块在真机异常（本插件已处理）
   部分机型上 enableChunked + onChunkReceived 会导致 success 里 body 为空。插件对 微信小程序 已默认 关闭分块，等 SSE 整段结束后再解析（可能略晚于逐字显示，但能出字）。请更新到含该逻辑的 stream-chat 版本。

4. HTTPS / 证书
   真机对证书链更严格；若自有域名，需完整证书链。

5. 超时
   长回答已把 uni.request timeout 设为 120000 ms；仍失败可看 fail 里 errMsg（如 request:fail）。

平台说明

安装

1. 通过 DCloud 插件市场 导入本插件，或解压到项目根目录 uni_modules/sma-chat/（文件夹名须与插件 package.json 中 id 一致）。
2. 无需在 pages.json 注册组件：符合 easycom，模板中直接使用标签 sma-chat-float。

快速使用

在常驻页面（如 Tab 首页或公共布局）挂载一次（全局被动 API 只关联最后一次挂载的实例）：

<template>
  <view class="page">
    <sma-chat-float :config="chatConfig" />
    <!-- 业务内容 -->
  </view>
</template>

<script setup lang="ts">
import { ref } from 'vue';

const chatConfig = ref({
  apiKey: 'YOUR_API_KEY',
  agentCode: 'YOUR_AGENT_CODE',
  apiUrl: 'https://API_BASE_URL', // 可选，默认同左
  title: 'AI 助手',
  themeColor: '#4F46E5',
  position: 'bottom-right', // 或 bottom-left
});
</script>

仅被动打开（隐藏悬浮球）

<sma-chat-float :config="chatConfig" :show-launcher="false" />

import { smaChatOpen, smaChatClose, smaChatToggle } from '@/uni_modules/sma-chat/utils/controller';

// 任意业务逻辑中
smaChatOpen();

或使用组件 ref：defineExpose 已暴露 open / close / toggle。

Props

config 字段

隐私与安全

• 插件通过 HTTPS 将对话内容、apiKey、agentCode 发往使用者配置的 apiUrl，用于调用聊天接口；插件内不落库。
• apiKey 在客户端可见，生产环境强烈建议自建 BFF，小程序只请求自有域名。
• 请在应用隐私政策中说明对话与接口传输范围。

目录结构

sma-chat/
├── package.json
├── readme.md
├── changelog.md
├── license.md
├── components/
│   ├── sma-chat-float/          # Vue3
│   │   └── sma-chat-float.vue
│   └── sma-chat-float-vue2/     # Vue2
│       └── sma-chat-float-vue2.vue
├── js_sdk/                      # Vue2 使用（纯 JS）
│   ├── stream-chat.js
│   ├── controller.js
│   └── launcher-icons.js        # 悬浮球扁平图标（data URI）
└── utils/                       # Vue3 + TS
    ├── types.ts
    ├── stream-chat.ts
    └── controller.ts

截图（插件市场展示）

请将实际运行效果图置于 static/screenshots/（上架时在网页端上传或按 HBuilderX 提示添加）。

开源与仓库

若本插件随 SMA 主仓库分发，仓库路径以作者发布页为准；也可在插件市场「更新日志」中填写 Git 地址。

许可

见 license.md。

使用开通账号，请联系 v x: hogwartsfan