ibc-ai-web-sdk 2.0.0

package/miniprogram/core/AIChatClient.js

@@ -0,0 +1,326 @@
+/**
+ * AI 聊天客户端 - 微信小程序版本
+ * 使用 wx.request 发送请求
+ */
+
+// 默认超时时间（60 秒，AI 调用可能较慢）
+const DEFAULT_TIMEOUT = 60000
+const ERROR_CODES = require('../utils/errorCodes')
+const { maskSensitiveData } = require('../utils/logger')
+
+function createRequestId() {
+  return 'req_' + Date.now().toString(36) + '_' + Math.random().toString(36).slice(2, 8)
+}
+
+class AIChatClient {
+  /**
+   * 创建客户端实例
+   * @param {Object} config - 配置对象
+   */
+  constructor(config) {
+    this.config = config
+    this.conversationId = null
+  }
+
+  /**
+   * 发送聊天消息
+   * @param {string} prompt - 用户输入
+   * @param {string} token - 可选，Token
+   * @returns {Promise<Object>} 标准响应格式 { success, code, message, data }
+   */
+  sendMessage(prompt, token) {
+    return new Promise((resolve, reject) => {
+      // 参数校验
+      if (!prompt || !prompt.trim()) {
+        resolve(this.createError(ERROR_CODES.PROMPT_EMPTY, '提示词不能为空'))
+        return
+      }
+
+      // 可选鉴权：如果配置了 authFn，先调用用户系统的鉴权接口
+      if (this.config.authFn) {
+        Promise.resolve(this.config.authFn(token || this.config.token, this.config.userId))
+          .then(() => {
+            this._doSend(prompt.trim(), token)
+              .then(resolve)
+              .catch((error) => {
+                // 网络错误统一转换为标准格式
+                if (typeof error === 'string') {
+                  resolve(this.createError(ERROR_CODES.NETWORK_ERROR, error))
+                } else {
+                  resolve(error)
+                }
+              })
+          })
+          .catch(error => {
+            resolve(this.createError(ERROR_CODES.AUTH_FAILED, '鉴权失败，无法使用智能体：' + (error.message || '未知错误')))
+          })
+      } else {
+        this._doSend(prompt.trim(), token)
+          .then(resolve)
+          .catch((error) => {
+            // 网络错误统一转换为标准格式
+            if (typeof error === 'string') {
+              resolve(this.createError(ERROR_CODES.NETWORK_ERROR, error))
+            } else {
+              resolve(error)
+            }
+          })
+      }
+    })
+  }
+
+  /**
+   * 执行实际请求
+   */
+  _doSend(prompt, token) {
+    return new Promise((resolve, reject) => {
+      const that = this
+      
+      // 构建请求参数
+      const payload = {
+        appId: this.config.appId || this.config.agentAppId,
+        prompt: prompt,
+        userId: this.config.userId,
+        bizType: this.config.bizType,
+        requestId: this.config.requestId || createRequestId()
+      }
+
+      // 多轮对话时添加 conversationId
+      if (this.conversationId) {
+        payload.conversationId = this.conversationId
+      }
+
+      // 添加扩展信息
+      const bizParams = this.config.bizParams || this.config.extendInfo
+      if (bizParams) {
+        payload.bizParams = typeof bizParams === 'string' ? bizParams : JSON.stringify(bizParams)
+      }
+
+      // 构建请求头
+      const headers = {
+        'Content-Type': 'application/json'
+      }
+
+      // 添加自定义请求头
+      if (this.config.headers) {
+        Object.assign(headers, this.config.headers)
+      }
+
+      // 添加 Token
+      const authToken = token || this.config.token
+      if (authToken) {
+        headers['Authorization'] = 'Bearer ' + authToken
+      }
+
+      console.log('[AI Request] Sending request to:', this.config.apiEndpoint)
+      console.log('[AI Request] Payload (masked):', JSON.stringify(maskSensitiveData(payload)))
+
+      // 使用 wx.request 发送请求
+      wx.request({
+        url: this.config.apiEndpoint,
+        method: 'POST',
+        data: payload,
+        header: headers,
+        timeout: this.config.timeout || DEFAULT_TIMEOUT,
+        success(res) {
+          console.log('[AI Response] Success:', res.data)
+          resolve(that.parseResponse(res.data))
+        },
+        fail(err) {
+          console.error('[AI Response] Failed:', err)
+          const errorMsg = err.errMsg || '网络请求失败'
+          reject(that.createError(ERROR_CODES.NETWORK_ERROR, errorMsg))
+        }
+      })
+    })
+  }
+
+  /**
+   * 创建错误对象
+   */
+  createError(code, message) {
+    return {
+      success: false,
+      code: code,
+      message: message,
+      data: null
+    }
+  }
+
+  /**
+   * 解析响应为统一标准格式
+   * @param {Object} raw - 原始响应数据
+   * @returns {Object} 标准格式 { success, code, message, data }
+   */
+  parseResponse(raw) {
+    // 如果已经是标准格式，直接返回
+    if (raw.hasOwnProperty('success') && raw.hasOwnProperty('code')) {
+      return {
+        success: raw.success === true,
+        code: raw.code || 200,
+        message: raw.message || '',
+        data: raw.data || null
+      }
+    }
+
+    // 兼容旧格式（rtnCode/bizContent）
+    return {
+      success: raw.rtnCode === 'SUCCESS' || raw.errCode === '000000',
+      code: raw.code || raw.errCode || 0,
+      message: raw.message || raw.errMsg || raw.rtnMsg || '',
+      data: raw.data || raw.bizContent || null
+    }
+  }
+
+  /**
+   * 设置会话 ID
+   * @param {string} conversationId - 会话 ID
+   */
+  setConversationId(conversationId) {
+    this.conversationId = conversationId
+  }
+
+  /**
+   * 查询可用智能体应用列表
+   * @param {Object} options - 查询选项
+   * @param {number} options.applicationType - 应用类型过滤
+   * @param {number} options.pageIndex - 页码，默认1
+   * @param {number} options.pageSize - 每页大小，默认20
+   * @returns {Promise<Object>} 标准响应格式 { success, code, message, data }
+   */
+  listApplications(options = {}) {
+    return new Promise((resolve, reject) => {
+      const appListEndpoint = this.config.appListEndpoint || '/v1/app/list'
+      const payload = {
+        applicationType: options.applicationType,
+        pageIndex: options.pageIndex || 1,
+        pageSize: options.pageSize || 20,
+        userId: this.config.userId
+      }
+      const headers = { 'Content-Type': 'application/json' }
+      if (this.config.headers) {
+        Object.assign(headers, this.config.headers)
+      }
+      const authToken = this.config.token
+      if (authToken) {
+        headers['Authorization'] = 'Bearer ' + authToken
+      }
+      wx.request({
+        url: appListEndpoint,
+        method: 'POST',
+        data: payload,
+        header: headers,
+        timeout: this.config.timeout || DEFAULT_TIMEOUT,
+        success: (res) => resolve(this.parseResponse(res.data)),
+        fail: (err) => {
+          const errorMsg = err.errMsg || '网络请求失败'
+          reject(this.createError(500, errorMsg))
+        }
+      })
+    })
+  }
+
+  /**
+   * 回复权限确认请求（HITL权限交互）
+   */
+  replyPermission(request) {
+    return new Promise((resolve, reject) => {
+      if (!request.sessionId || !request.requestId) {
+        resolve(this.createError(40002, 'sessionId和requestId不能为空'))
+        return
+      }
+      const endpoint = this.config.runtimePermissionReplyEndpoint || '/v1/app/runtime/permission/reply'
+      const payload = {
+        sessionId: request.sessionId,
+        requestId: request.requestId,
+        reply: request.reply || 'once',
+        message: request.message || '',
+        userId: this.config.userId
+      }
+      const headers = { 'Content-Type': 'application/json' }
+      if (this.config.headers) Object.assign(headers, this.config.headers)
+      const authToken = this.config.token
+      if (authToken) headers['Authorization'] = 'Bearer ' + authToken
+      wx.request({
+        url: endpoint, method: 'POST', data: payload, header: headers,
+        timeout: this.config.timeout || DEFAULT_TIMEOUT,
+        success: (res) => resolve(this.parseResponse(res.data)),
+        fail: (err) => reject(this.createError(500, err.errMsg || '网络请求失败'))
+      })
+    })
+  }
+
+  /**
+   * 回复智能体问题（HITL问答交互）
+   */
+  replyQuestion(request) {
+    return new Promise((resolve, reject) => {
+      if (!request.sessionId || !request.requestId) {
+        resolve(this.createError(40002, 'sessionId和requestId不能为空'))
+        return
+      }
+      const endpoint = this.config.runtimeQuestionReplyEndpoint || '/v1/app/runtime/question/reply'
+      const payload = {
+        sessionId: request.sessionId,
+        requestId: request.requestId,
+        answers: request.answers || [],
+        userId: this.config.userId
+      }
+      const headers = { 'Content-Type': 'application/json' }
+      if (this.config.headers) Object.assign(headers, this.config.headers)
+      const authToken = this.config.token
+      if (authToken) headers['Authorization'] = 'Bearer ' + authToken
+      wx.request({
+        url: endpoint, method: 'POST', data: payload, header: headers,
+        timeout: this.config.timeout || DEFAULT_TIMEOUT,
+        success: (res) => resolve(this.parseResponse(res.data)),
+        fail: (err) => reject(this.createError(500, err.errMsg || '网络请求失败'))
+      })
+    })
+  }
+
+  /**
+   * 拒绝智能体问题（HITL问答拒绝）
+   */
+  rejectQuestion(request) {
+    return new Promise((resolve, reject) => {
+      if (!request.sessionId || !request.requestId) {
+        resolve(this.createError(40002, 'sessionId和requestId不能为空'))
+        return
+      }
+      const endpoint = this.config.runtimeQuestionRejectEndpoint || '/v1/app/runtime/question/reject'
+      const payload = {
+        sessionId: request.sessionId,
+        requestId: request.requestId,
+        userId: this.config.userId
+      }
+      const headers = { 'Content-Type': 'application/json' }
+      if (this.config.headers) Object.assign(headers, this.config.headers)
+      const authToken = this.config.token
+      if (authToken) headers['Authorization'] = 'Bearer ' + authToken
+      wx.request({
+        url: endpoint, method: 'POST', data: payload, header: headers,
+        timeout: this.config.timeout || DEFAULT_TIMEOUT,
+        success: (res) => resolve(this.parseResponse(res.data)),
+        fail: (err) => reject(this.createError(500, err.errMsg || '网络请求失败'))
+      })
+    })
+  }
+
+  /**
+   * 清除会话 ID（开始新对话）
+   */
+  clearConversation() {
+    this.conversationId = null
+  }
+
+  /**
+   * 更新配置
+   * @param {Object} newConfig - 新配置
+   */
+  updateConfig(newConfig) {
+    Object.assign(this.config, newConfig)
+  }
+}
+
+module.exports = AIChatClient

package/miniprogram/types.ts

@@ -0,0 +1,178 @@
+/**
+ * IBC AI Web SDK - 微信小程序版本 TypeScript 类型定义
+ * 统一定义所有类型和接口，提供完整的类型提示
+ */
+
+/**
+ * AI 聊天配置接口
+ */
+export interface AIChatConfig {
+  // ===== 必填配置 =====
+  
+  /** API 接口地址 */
+  apiEndpoint: string
+
+  /** 应用列表接口地址，默认 /v1/app/list */
+  appListEndpoint?: string
+
+  /** 权限确认回复接口地址，默认 /v1/app/runtime/permission/reply */
+  runtimePermissionReplyEndpoint?: string
+
+  /** 问题回复接口地址，默认 /v1/app/runtime/question/reply */
+  runtimeQuestionReplyEndpoint?: string
+
+  /** 问题拒绝接口地址，默认 /v1/app/runtime/question/reject */
+  runtimeQuestionRejectEndpoint?: string
+  
+  /** 智能体应用 ID */
+  agentAppId: string
+  
+  /** 用户 ID */
+  userId: string
+  
+  /** 业务类型标识 */
+  bizType: string
+  
+  /** 认证 Token */
+  token?: string
+  
+  // ===== 可选配置 =====
+  
+  /** 请求超时时间（毫秒），默认 60000 */
+  timeout?: number
+  
+  /** 自定义请求头 */
+  headers?: Record<string, string>
+  
+  /** 扩展信息 */
+  extendInfo?: Record<string, any> | null
+  
+  // ===== UI 配置 =====
+  
+  /** 对话框标题，默认 'AI 智能助理' */
+  title?: string
+  
+  /** 欢迎文本，默认 '您好！我是 AI 智能助理' */
+  welcomeText?: string
+  
+  /** 欢迎描述，默认 '我可以帮您解答系统使用问题' */
+  welcomeDesc?: string
+  
+  /** 最大消息数量，默认 50 */
+  maxMessages?: number
+  
+  /** 输入框最大字数，默认 500 */
+  maxLength?: number
+  
+  /** 是否允许拖拽，默认 true */
+  enableDrag?: boolean
+  
+  // ===== 可选鉴权 =====
+  
+  /**
+   * 可选鉴权函数
+   * @param token - 当前用户的 token
+   * @param userId - 用户 ID
+   * @returns Promise<void>，resolve 表示通过，reject/throw 表示拒绝
+   */
+  authFn?: (token: string, userId: string) => Promise<void>
+  
+  // ===== 事件回调 =====
+  
+  /** SDK 加载完成回调 */
+  onLoad?: (client: any) => void
+  
+  /** 错误回调 */
+  onError?: (error: Error | string) => void
+  
+  // ===== 主题配置（可选） =====
+  
+  /** 主题配置 */
+  theme?: {
+    /** 主色调 */
+    primaryColor?: string
+    /** 背景色 */
+    backgroundColor?: string
+    /** 气泡背景色 */
+    bubbleColor?: string
+  }
+}
+
+/**
+ * 消息类型枚举
+ */
+export enum MessageType {
+  /** 用户消息 */
+  USER = 'user',
+  /** AI 消息 */
+  AI = 'ai'
+}
+
+/**
+ * 消息接口
+ */
+export interface Message {
+  /** 消息 ID */
+  id: string
+  
+  /** 消息类型 */
+  type: MessageType
+  
+  /** 消息内容 */
+  content: string
+  
+  /** 渲染后的内容（HTML） */
+  renderedContent: string
+  
+  /** 消息时间 */
+  time: string
+  
+  /** 是否失败 */
+  error?: boolean
+}
+
+/**
+ * SDK 事件参数
+ */
+export interface SDKEvents {
+  /** 用户发送消息 */
+  'message-send': { message: string; index: number }
+  
+  /** AI 回复消息 */
+  'message-receive': { response: any; index: number }
+  
+  /** Loading 状态变化 */
+  'loading-change': boolean
+  
+  /** 关闭对话框 */
+  close: void
+  
+  /** 展开/收起 */
+  expand: boolean
+}
+
+/**
+ * 错误码枚举
+ */
+export const ERROR_CODES = {
+  // 成功
+  SUCCESS: 200,
+  
+  // 客户端错误 (40000-49999)
+  AGENT_NOT_FOUND: 40001,
+  PROMPT_EMPTY: 40002,
+  AUTH_FAILED: 40301,
+  
+  // 服务器错误 (50000-59999)
+  NETWORK_ERROR: 500,
+  SERVER_ERROR: 50001,
+  TIMEOUT_ERROR: 50002,
+  
+  // 取消
+  REQUEST_CANCELLED: 0
+} as const
+
+/**
+ * 导出错误码类型
+ */
+export type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES]

package/miniprogram/utils/errorCodes.js

@@ -0,0 +1,25 @@
+/**
+ * 错误码常量
+ * 统一定义所有错误码，方便维护
+ */
+
+const ERROR_CODES = {
+  // 成功
+  SUCCESS: 200,
+
+  // 客户端错误 (40000-49999)
+  AGENT_NOT_FOUND: 40001,        // 智能体不存在或已禁用
+  PROMPT_EMPTY: 40002,           // 提示词不能为空
+  AUTH_FAILED: 40301,            // 鉴权失败
+
+  // 服务器错误 (50000-59999)
+  NETWORK_ERROR: 500,            // 网络请求失败
+  SERVER_ERROR: 50001,           // 服务器内部错误
+  TIMEOUT_ERROR: 50002,          // 请求超时
+
+  // 取消
+  REQUEST_CANCELLED: 0           // 请求已取消
+}
+
+// 导出为模块
+module.exports = ERROR_CODES

package/miniprogram/utils/logger.js

@@ -0,0 +1,51 @@
+/**
+ * 日志脱敏工具
+ * 防止敏感信息（如 Token）打印到控制台
+ */
+
+/**
+ * 脱敏对象中的敏感字段
+ * @param {Object} obj - 需要脱敏的对象
+ * @returns {Object} 脱敏后的对象
+ */
+function maskSensitiveData(obj) {
+  if (!obj || typeof obj !== 'object') {
+    return obj
+  }
+
+  // 需要脱敏的字段列表
+  const sensitiveFields = ['token', 'authorization', 'password', 'secret', 'key']
+  
+  const masked = {}
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      const lowerKey = key.toLowerCase()
+      // 检查是否是敏感字段
+      if (sensitiveFields.some(field => lowerKey.includes(field))) {
+        masked[key] = '******'
+      } else {
+        masked[key] = obj[key]
+      }
+    }
+  }
+  
+  return masked
+}
+
+/**
+ * 脱敏字符串中的 Token
+ * @param {string} str - 需要脱敏的字符串
+ * @returns {string} 脱敏后的字符串
+ */
+function maskToken(str) {
+  if (!str || typeof str !== 'string') {
+    return str
+  }
+  // 替换 Bearer Token 格式
+  return str.replace(/(Bearer\s+)([a-zA-Z0-9\-._~+\/]+=*)/g, '$1******')
+}
+
+module.exports = {
+  maskSensitiveData,
+  maskToken
+}

package/miniprogram/utils/markdownParser.js

@@ -0,0 +1,97 @@
+/**
+ * Markdown 解析工具 - 微信小程序版本
+ * 将 Markdown 文本转换为 rich-text 可用的 HTML
+ */
+
+// Markdown 解析缓存（最多缓存 100 条）
+const markdownCache = new Map()
+const MAX_CACHE_SIZE = 100
+
+function parseMarkdown(text) {
+  if (!text) return ''
+
+  // 1. 检查缓存
+  if (markdownCache.has(text)) {
+    return markdownCache.get(text)
+  }
+
+  let html = text
+
+  // 2. 转义 HTML 特殊字符（防止 XSS）- 最先处理
+  html = html.replace(/&/g, '&')
+  html = html.replace(/</g, '&lt;')
+  html = html.replace(/>/g, '&gt;')
+
+  // 3. 水平线（--- 或 ***）- 在粗体/斜体前处理
+  html = html.replace(/^---$/gm, '<hr />')
+  html = html.replace(/^\*\*\*$/gm, '<hr />')
+
+  // 4. 标题（# H1, ## H2, ...）
+  html = html.replace(/^#### (.+)$/gm, '<h4>$1</h4>')
+  html = html.replace(/^### (.+)$/gm, '<h3>$1</h3>')
+  html = html.replace(/^## (.+)$/gm, '<h2>$1</h2>')
+  html = html.replace(/^# (.+)$/gm, '<h1>$1</h1>')
+
+  // 5. 粗体（**text**）
+  html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
+
+  // 6. 斜体（*text*）
+  html = html.replace(/\*(.+?)\*/g, '<em>$1</em>')
+
+  // 7. 删除线（~~text~~）
+  html = html.replace(/~~(.+?)~~/g, '<del>$1</del>')
+
+  // 8. 图片（![alt](url)）- 在链接前处理
+  html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '<img src="$2" alt="$1" />')
+
+  // 9. 链接（[text](url)）
+  html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" target="_blank">$1</a>')
+
+  // 10. 无序列表（- item 或 * item）
+  html = html.replace(/^[\-\*] (.+)$/gm, '<li>$1</li>')
+  html = html.replace(/(<li>.*<\/li>)/s, '<ul>$1</ul>')
+
+  // 11. 有序列表（1. item）
+  html = html.replace(/^\d+\. (.+)$/gm, '<li>$1</li>')
+
+  // 12. 引用（> text）
+  html = html.replace(/^&gt; (.+)$/gm, '<blockquote>$1</blockquote>')
+
+  // 13. 代码块（```code```）- 最后处理，恢复代码内容
+  html = html.replace(/&lt;pre&gt;&lt;code&gt;([\s\S]*?)&lt;\/code&gt;&lt;\/pre&gt;/g, function(match, code) {
+    return '<pre><code>' + code.trim().replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>') + '</code></pre>'
+  })
+
+  // 14. 行内代码（`code`）- 最后处理，恢复代码内容
+  html = html.replace(/&lt;code&gt;([\s\S]*?)&lt;\/code&gt;/g, function(match, code) {
+    return '<code>' + code.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>') + '</code>'
+  })
+
+  // 15. 换行
+  html = html.replace(/\n/g, '<br>')
+
+  // 16. 清理多余的空行
+  html = html.replace(/<br>\s*<br>/g, '<br>')
+
+  // 17. 存入缓存（限制缓存大小）
+  if (markdownCache.size >= MAX_CACHE_SIZE) {
+    // 删除最旧的缓存项
+    const firstKey = markdownCache.keys().next().value
+    markdownCache.delete(firstKey)
+  }
+  markdownCache.set(text, html)
+
+  return html
+}
+
+/**
+ * 清空缓存
+ */
+function clearMarkdownCache() {
+  markdownCache.clear()
+}
+
+module.exports = {
+  parseMarkdown,
+  clearMarkdownCache
+}

package/miniprogram/utils/messageIdGenerator.js

@@ -0,0 +1,23 @@
+/**
+ * 唯一 ID 生成器
+ * 避免消息 ID 冲突问题
+ */
+
+let idCounter = 0
+
+/**
+ * 生成唯一消息 ID
+ * 格式：{timestamp}-{counter}-{random}
+ * 例如：1713926400000-1-abc123
+ * @returns {string} 唯一 ID
+ */
+function generateMessageId() {
+  const timestamp = Date.now()
+  const counter = ++idCounter
+  const random = Math.random().toString(36).substring(2, 8)
+  return `${timestamp}-${counter}-${random}`
+}
+
+module.exports = {
+  generateMessageId
+}