feat(ai-completion): Enhance completion system with debounce management and FIM support

Author: SonyLeo

packages/plugins/robot/src/constants/model-config.ts

@@ -121,7 +121,6 @@ export const DEFAULT_LLM_MODELS = [
         }
       },
       {
-        // TODO: https://api.deepseek.com/beta 支持 FIM
         label: 'Deepseek Coder编程模型',
         name: 'deepseek-chat',
         capabilities: {

packages/plugins/script/src/Main.vue

@@ -34,14 +34,15 @@
 /* metaService: engine.plugins.pagecontroller.Main */
 import { onBeforeUnmount, reactive, provide } from 'vue'
 import { Button } from '@opentiny/vue'
-import { registerCompletion } from 'monacopilot'
+import { registerCompletion, type CompletionRegistration } from 'monacopilot'
 import { VueMonaco, PluginPanel } from '@opentiny/tiny-engine-common/component'
 import { useHelp, useLayout } from '@opentiny/tiny-engine-meta-register'
 import { initCompletion } from '@opentiny/tiny-engine-common/js/completion'
 import { initLinter } from '@opentiny/tiny-engine-common/js/linter'
 import useMethod, { saveMethod, highlightMethod, getMethodNameList, getMethods } from './js/method'
-import { shouldTriggerCompletion } from './ai-completion/triggers/completionTrigger'
 import { createCompletionHandler } from './ai-completion/adapters/index'
+import { shouldTriggerCompletion } from './ai-completion/triggers/completionTrigger'
+import { debounceManager } from './ai-completion/utils/debounceManager'
 
 export const api = {
   saveMethod,
@@ -69,6 +70,9 @@ export default {
 
     const { PLUGIN_NAME } = useLayout()
 
+    // 存储 AI 补全注册信息
+    let completionRegistration: CompletionRegistration | null = null
+
     const panelState = reactive({
       emitEvent: emit
     })
@@ -122,17 +126,19 @@ export default {
         const monacoInstance = monacoRef.value.getMonaco()
         const editorInstance = monacoRef.value.getEditor()
 
-        registerCompletion(monacoInstance, editorInstance, {
+        // 配置防抖管理器
+        debounceManager.setDebounceDelay(300) // 防抖延迟 300ms
+        debounceManager.setDebounceEnabled(true)
+
+        completionRegistration = registerCompletion(monacoInstance, editorInstance, {
           language: 'javascript',
-          endpoint: '/app-center/api/chat/completions',
           filename: 'page.js',
-          trigger: 'onTyping',
           maxContextLines: 50,
           enableCaching: true,
           allowFollowUpCompletions: true,
 
           // 🎯 智能触发判断（在请求前执行，避免不必要的请求）
-          triggerIf: (params) => {
+          triggerIf: () => {
             const model = editorInstance.getModel()
             const position = editorInstance.getPosition()
 
@@ -143,13 +149,16 @@ export default {
               position: {
                 lineNumber: position.lineNumber,
                 column: position.column
-              },
-              triggerType: params.triggerType || 'onTyping'
+              }
             })
           },
 
-          // 🚀 请求处理器：支持 DeepSeek 和 Qwen 模型
-          requestHandler: createCompletionHandler() as any
+          requestHandler: debounceManager.createRequestHandler(createCompletionHandler())
+        })
+
+        // 注册快捷键：Ctrl+Space 触发 AI 补全
+        editorInstance.addCommand(monacoInstance.KeyMod.CtrlCmd | monacoInstance.KeyCode.Space, () => {
+          completionRegistration?.trigger?.()
         })
       } catch (error) {
         // eslint-disable-next-line no-console
@@ -158,6 +167,9 @@ export default {
     }
 
     onBeforeUnmount(() => {
+      // 清理 AI 补全
+      completionRegistration?.deregister?.()
+      debounceManager.reset()
       ;(state.completionProvider as any)?.forEach?.((provider: any) => {
         provider?.dispose?.()
       })

packages/plugins/script/src/ai-completion/adapters/index.js

@@ -8,7 +8,7 @@ import { detectModelType, calculateTokens, getStopSequences } from '../utils/mod
 import { cleanCompletion, buildLowcodeMetadata } from '../utils/completionUtils.js'
 import { buildQwenMessages, callQwenAPI } from './qwenAdapter.js'
 import { buildDeepSeekMessages, callDeepSeekAPI } from './deepseekAdapter.js'
-import { QWEN_CONFIG, DEFAULTS, ERROR_MESSAGES, MODEL_CONFIG } from '../constants.js'
+import { QWEN_CONFIG, DEEPSEEK_CONFIG, DEFAULTS, ERROR_MESSAGES, MODEL_CONFIG } from '../constants.js'
 
 /**
  * 创建请求处理器
@@ -71,10 +71,20 @@ export function createCompletionHandler() {
         // ===== DeepSeek 流程（默认） =====
         const { messages } = buildDeepSeekMessages(context, instruction, fileContent)
 
-        const config = { model: completeModel }
+        // DeepSeek 使用 Chat API，也需要 stop 序列
+        const config = {
+          model: completeModel,
+          stopSequences: getStopSequences(null, MODEL_CONFIG.DEEPSEEK.TYPE)
+        }
         const httpClient = getMetaApi(META_SERVICE.Http)
 
-        completionText = await callDeepSeekAPI(messages, config, apiKey, baseUrl, httpClient)
+        // 构建 DeepSeek FIM 端点：将 /v1 替换为 /beta
+        const completionBaseUrl = baseUrl.replace(DEEPSEEK_CONFIG.PATH_REPLACE, DEEPSEEK_CONFIG.COMPLETION_PATH)
+
+        // eslint-disable-next-line no-console
+        console.log('🔧 DeepSeek FIM 端点:', completionBaseUrl)
+
+        completionText = await callDeepSeekAPI(messages, config, apiKey, completionBaseUrl, httpClient)
       }
 
       // 6. 处理补全结果

packages/plugins/script/src/ai-completion/adapters/qwenAdapter.js

@@ -2,7 +2,7 @@
  * Qwen 专用适配器
  * 使用 Completions API + FIM (Fill-In-the-Middle)
  */
-import { QWEN_CONFIG, API_ENDPOINTS, HTTP_CONFIG, ERROR_MESSAGES } from '../constants.js'
+import { QWEN_CONFIG, HTTP_CONFIG, ERROR_MESSAGES } from '../constants.js'
 
 /**
  * 构建 Qwen FIM 格式的 messages
@@ -40,7 +40,8 @@ export function buildQwenMessages(fileContent, fimBuilder) {
  * @returns {Promise<string>} 补全文本
  */
 export async function callQwenAPI(messages, config, apiKey, baseUrl) {
-  const completionsUrl = `${baseUrl}${API_ENDPOINTS.COMPLETIONS_PATH}`
+  // 构建完整的 Completions API URL
+  const completionsUrl = `${baseUrl}${QWEN_CONFIG.COMPLETION_PATH}`
 
   // eslint-disable-next-line no-console
   console.log('📦 模型:', config.model)

packages/plugins/script/src/ai-completion/constants.js

@@ -2,8 +2,7 @@
  * Qwen Coder API 配置（阿里云百炼）
  */
 export const QWEN_CONFIG = {
-  API_URL: 'https://dashscope.aliyuncs.com/compatible-mode/v1/completions',
-  MODEL: 'qwen2.5-coder-32b-instruct',
+  COMPLETION_PATH: '/completions', // Completions API 路径（追加到 baseUrl）
   DEFAULT_TEMPERATURE: 0.05,
   TOP_P: 0.95,
   PRESENCE_PENALTY: 0.2,
@@ -15,13 +14,30 @@ export const QWEN_CONFIG = {
   }
 }
 
+/**
+ * DeepSeek Coder API 配置
+ */
+export const DEEPSEEK_CONFIG = {
+  COMPLETION_PATH: '/beta', // FIM 补全 API 路径
+  PATH_REPLACE: '/v1', // 需要从 baseUrl 中替换的路径
+  DEFAULT_TEMPERATURE: 0,
+  TOP_P: 1.0,
+
+  // FIM (Fill-In-the-Middle) 配置
+  FIM: {
+    MAX_PREFIX_LINES: 100,
+    MAX_SUFFIX_LINES: 50,
+    MAX_TOKENS: 4096 // FIM 最大补全长度 4K
+  }
+}
+
 /**
  * 模型配置
  */
 export const MODEL_CONFIG = {
   QWEN: {
     TYPE: 'qwen',
-    KEYWORDS: ['qwen'] // 移除 'coder'，避免误匹配 deepseek-coder
+    KEYWORDS: ['qwen']
   },
   DEEPSEEK: {
     TYPE: 'deepseek',
@@ -37,8 +53,7 @@ export const MODEL_CONFIG = {
  * API 端点配置
  */
 export const API_ENDPOINTS = {
-  COMPLETIONS_PATH: '/completions',
-  CHAT_COMPLETIONS: '/app-center/api/chat/completions'
+  CHAT_COMPLETIONS: '/app-center/api/chat/completions' // 后端代理端点（DeepSeek 使用）
 }
 
 /**

packages/plugins/script/src/ai-completion/index.js

@@ -3,5 +3,5 @@
  */
 export { createCompletionHandler } from './adapters/index.js'
 export { shouldTriggerCompletion } from './triggers/completionTrigger.js'
-export { requestManager } from './utils/requestManager.js'
+export { debounceManager } from './utils/debounceManager.js'
 export { createSmartPrompt, FIMPromptBuilder } from './builders/index.js'

packages/plugins/script/src/ai-completion/triggers/completionTrigger.js

@@ -1,45 +1,7 @@
 /**
- * 智能补全触发条件判断（JS/TS 专用）
+ * 智能补全触发条件判断
  */
 
-/**
- * 检测是否在注释中
- */
-function isInComment(beforeCursor, fullText) {
-  const trimmed = beforeCursor.trim()
-
-  // 单行注释
-  if (trimmed.startsWith('//') || trimmed.startsWith('*')) {
-    return true
-  }
-
-  // 块注释
-  const lastBlockStart = fullText.lastIndexOf('/*', fullText.indexOf(beforeCursor))
-  const lastBlockEnd = fullText.lastIndexOf('*/', fullText.indexOf(beforeCursor))
-  if (lastBlockStart > lastBlockEnd) {
-    return true
-  }
-
-  return false
-}
-
-/**
- * 检测是否在字符串中
- */
-function isInString(beforeCursor) {
-  const singleQuotes = (beforeCursor.match(/'/g) || []).length
-  const doubleQuotes = (beforeCursor.match(/"/g) || []).length
-  return singleQuotes % 2 === 1 || doubleQuotes % 2 === 1
-}
-
-/**
- * 检测是否在模板字符串中
- */
-function isInTemplateString(beforeCursor) {
-  const backticks = (beforeCursor.match(/`/g) || []).length
-  return backticks % 2 === 1
-}
-
 /**
  * 检测光标是否在语句结束符后（分号后）
  */
@@ -87,42 +49,25 @@ function isAfterBlockEnd(beforeCursor) {
  * @param {Object} params.position - 光标位置
  * @param {number} params.position.lineNumber - 行号
  * @param {number} params.position.column - 列号
- * @param {string} params.triggerType - 触发类型
  * @returns {boolean} 是否触发补全
  */
 export function shouldTriggerCompletion(params) {
   const { text, position } = params
   const lines = text.split('\n')
   const currentLine = lines[position.lineNumber - 1] || ''
   const beforeCursor = currentLine.substring(0, position.column - 1)
-  const trimmedLine = beforeCursor.trim()
-
-  // 1. 避免在注释中触发
-  if (isInComment(beforeCursor, text)) {
-    return false
-  }
-
-  // 2. 避免在普通字符串中触发（但允许模板字符串）
-  if (isInString(beforeCursor) && !isInTemplateString(beforeCursor)) {
-    return false
-  }
-
-  // 3. 代码太短不触发（降低阈值）
-  if (text.trim().length < 5) {
-    return false
-  }
 
-  // 4. 完全空行不触发
-  if (trimmedLine.length === 0) {
+  // 1. 代码太短不触发
+  if (text.trim().length < 2) {
     return false
   }
 
-  // 5. 分号后不触发（语句已结束）
+  // 2. 分号后不触发（语句已结束）
   if (isAfterStatementEnd(beforeCursor)) {
     return false
   }
 
-  // 6. 右花括号后不触发（块已结束）
+  // 3. 右花括号后不触发（块已结束）
   if (isAfterBlockEnd(beforeCursor)) {
     return false
   }

packages/plugins/script/src/ai-completion/utils/debounceManager.js

@@ -0,0 +1,99 @@
+/**
+ * 防抖管理器 - 仅支持防抖功能
+ */
+class DebounceManager {
+  constructor() {
+    this.debounceTimer = null
+    this.debounceDelay = 200 // 防抖延迟（毫秒）
+    this.lastTriggerTime = 0
+    this.isDebounceEnabled = true
+  }
+
+  /**
+   * 设置防抖延迟
+   */
+  setDebounceDelay(delay) {
+    this.debounceDelay = delay
+  }
+
+  /**
+   * 启用/禁用防抖
+   */
+  setDebounceEnabled(enabled) {
+    this.isDebounceEnabled = enabled
+  }
+
+  /**
+   * 清理防抖定时器
+   */
+  clearDebounceTimer() {
+    if (this.debounceTimer) {
+      // eslint-disable-next-line no-console
+      console.log('⏱️ [DebounceManager] 清理防抖定时器')
+      clearTimeout(this.debounceTimer)
+      this.debounceTimer = null
+    }
+  }
+
+  /**
+   * 检查是否应该立即执行（不防抖）
+   * 某些情况下应该立即响应，不需要防抖
+   */
+  shouldExecuteImmediately() {
+    const now = Date.now()
+    const timeSinceLastTrigger = now - this.lastTriggerTime
+
+    // 如果距离上次触发超过 1 秒，立即执行
+    // 这避免了用户停止输入后再次输入时的延迟
+    return timeSinceLastTrigger > 1000
+  }
+
+  /**
+   * 创建带防抖的请求处理器
+   * @param {Function} handler - 实际的请求处理函数
+   */
+  createRequestHandler(handler) {
+    return async (params) => {
+      this.lastTriggerTime = Date.now()
+
+      // 如果启用了防抖且不应该立即执行
+      if (this.isDebounceEnabled && !this.shouldExecuteImmediately()) {
+        // eslint-disable-next-line no-console
+        console.log(`⏳ [DebounceManager] 防抖延迟 ${this.debounceDelay}ms`)
+        // 清理之前的防抖定时器
+        this.clearDebounceTimer()
+
+        // 创建新的防抖 Promise
+        await new Promise((resolve) => {
+          this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null
+            // eslint-disable-next-line no-console
+            console.log('✅ [DebounceManager] 防抖延迟结束，准备执行请求')
+            resolve()
+          }, this.debounceDelay)
+        })
+      } else {
+        // eslint-disable-next-line no-console
+        console.log('⚡ [DebounceManager] 立即执行（无防抖）')
+      }
+
+      // 执行实际的请求处理器
+      if (handler) {
+        return await handler(params)
+      }
+
+      return null
+    }
+  }
+
+  /**
+   * 重置状态（用于清理）
+   */
+  reset() {
+    // eslint-disable-next-line no-console
+    console.log('🔄 [DebounceManager] 重置状态')
+    this.clearDebounceTimer()
+  }
+}
+
+export const debounceManager = new DebounceManager()