feihong-code 7.5.0 → 7.6.0

package/dist/web/public/js/monaco-editor.js

@@ -1,363 +1,363 @@
-/**
- * 飞虹 Code - Monaco Editor 封装模块
- * VSCode 同款编辑器内核，提供语法高亮、智能补全、内联 ghost text 等能力
- *
- * 依赖：index.html 中已加载 vendor/monaco/vs/loader.js（AMD loader）
- */
-(function (global) {
-  'use strict';
-
-  let monacoInstance = null;
-  let initPromise = null;
-  const editors = new Map(); // containerId -> editor instance
-  let activeEditor = null; // 最近创建的编辑器（供 lint/诊断反馈定位）
-  let inlineCompletionProvider = null;
-  let completionItemProvider = null;
-
-  /** 获取当前活跃编辑器（P6-1 lint 反馈定位） */
-  function getActiveEditor() {
-    return activeEditor;
-  }
-
-  /** 根据文件扩展名推断 Monaco language id */
-  function detectLanguage(filePath) {
-    const ext = filePath.split('.').pop().toLowerCase();
-    const map = {
-      ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
-      json: 'json', md: 'markdown', html: 'html', css: 'css', scss: 'scss',
-      less: 'less', py: 'python', java: 'java', c: 'c', cpp: 'cpp', h: 'cpp',
-      cs: 'csharp', go: 'go', rs: 'rust', php: 'php', rb: 'ruby', swift: 'swift',
-      kt: 'kotlin', scala: 'scala', sh: 'shell', bash: 'shell', zsh: 'shell',
-      sql: 'sql', yaml: 'yaml', yml: 'yaml', xml: 'xml', vue: 'html', svelte: 'html',
-      proto: 'protobuf', dockerfile: 'dockerfile', toml: 'ini', ini: 'ini',
-    };
-    if (filePath.toLowerCase().endsWith('dockerfile')) return 'dockerfile';
-    return map[ext] || 'plaintext';
-  }
-
-  /** 初始化 Monaco（只执行一次，返回 Promise） */
-  function initMonaco() {
-    if (monacoInstance) return Promise.resolve(monacoInstance);
-    if (initPromise) return initPromise;
-
-    initPromise = new Promise((resolve, reject) => {
-      if (typeof global.require === 'undefined') {
-        reject(new Error('Monaco loader.js 未加载，请检查 vendor/monaco/vs/loader.js'));
-        return;
-      }
-      global.require.config({ paths: { vs: 'vendor/monaco/vs' } });
-      global.require(['vs/editor/editor.main'], function () {
-        monacoInstance = global.monaco;
-        // 配置默认主题（跟随系统深色/浅色）
-        const isDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
-        monacoInstance.editor.setTheme(isDark ? 'vs-dark' : 'vs');
-        resolve(monacoInstance);
-      }, reject);
-    });
-    return initPromise;
-  }
-
-  /**
-   * 在指定容器中创建 Monaco 编辑器
-   * @param {HTMLElement|string} container - 容器元素或 ID
-   * @param {string} value - 初始内容
-   * @param {string} filePath - 文件路径（用于推断语言）
-   * @param {object} options - 额外选项
-   * @returns {Promise<monaco.editor.IStandaloneCodeEditor>}
-   */
-  async function createEditor(container, value, filePath, options = {}) {
-    const monaco = await initMonaco();
-    const el = typeof container === 'string' ? document.getElementById(container) : container;
-    if (!el) throw new Error('编辑器容器不存在: ' + container);
-
-    // 如果该容器已有编辑器，先销毁
-    const existing = editors.get(el.id || container);
-    if (existing) {
-      existing.dispose();
-      editors.delete(el.id || container);
-    }
-
-    const language = detectLanguage(filePath);
-    const editor = monaco.editor.create(el, {
-      value: value || '',
-      language: language,
-      theme: undefined, // 使用全局主题
-      automaticLayout: true,
-      fontSize: 13,
-      lineNumbers: 'on',
-      minimap: { enabled: true },
-      scrollBeyondLastLine: false,
-      wordWrap: 'on',
-      bracketPairColorization: { enabled: true },
-      guides: { bracketPairs: true, indentation: true },
-      tabSize: 2,
-      renderWhitespace: 'selection',
-      smoothScrolling: true,
-      cursorBlinking: 'smooth',
-      // P0-1: 启用内联补全（ghost text，Tab 接受）
-      inlineSuggest: { enabled: true, showToolbar: 'always' },
-      // 启用快速建议（输入时自动触发补全弹窗）
-      quickSuggestions: { other: true, comments: false, strings: true },
-      quickSuggestionsDelay: 200,
-      ...options,
-    });
-
-    const key = el.id || container;
-    editors.set(key, editor);
-    activeEditor = editor; // P6-1: 记录最近活跃编辑器供 lint 反馈定位
-    return editor;
-  }
-
-  /** 获取编辑器实例 */
-  function getEditor(container) {
-    const key = typeof container === 'string' ? container : container.id;
-    return editors.get(key);
-  }
-
-  /** 销毁编辑器 */
-  function disposeEditor(container) {
-    const key = typeof container === 'string' ? container : container.id;
-    const editor = editors.get(key);
-    if (editor) {
-      editor.dispose();
-      editors.delete(key);
-    }
-  }
-
-  /**
-   * 注册内联补全 Provider（ghost text，Tab 接受）
-   * @param {function} fetchFn - 异步补全函数，参数 {filePath, content, offset}，返回 {text: string}
-   */
-  /**
-   * 注册行内补全 Provider（ghost text）
-   * @param {function} fetchFn - 异步补全函数，参数 {filePath, content, offset, token}，返回 {text} 或 null
-   * @param {{getActiveEditor?:function, onAccept?:function}} [opts] - P6-1: getActiveEditor 取当前编辑器；onAccept 在补全被接受（插入）时回调插入文本
-   */
-  function registerInlineCompletions(fetchFn, opts) {
-    const o = opts || {};
-    initMonaco().then((monaco) => {
-      if (inlineCompletionProvider) {
-        inlineCompletionProvider.dispose();
-      }
-      let lastText = '';
-      inlineCompletionProvider = monaco.languages.registerInlineCompletionsProvider('*', {
-        provideInlineCompletions: async function (model, position, context, token) {
-          try {
-            const filePath = model.uri.path || 'untitled';
-            const content = model.getValue();
-            const offset = model.getOffsetAt(position);
-            const result = await fetchFn({ filePath, content, offset, token });
-            if (!result || !result.text) return { items: [] };
-            const item = {
-              range: new monaco.Range(position.lineNumber, position.column, position.lineNumber, position.column),
-              insertText: result.text,
-              filterText: result.text.slice(0, 20),
-            };
-            lastText = result.text;
-            return { items: [item] };
-          } catch (e) {
-            return { items: [] };
-          }
-        },
-        freeInlineCompletions: function () {},
-      });
-
-      // P6-1: accept 检测——编辑器内容变化且插入文本匹配最近补全 → onAccept(插入文本)
-      const bindAccept = function () {
-        const editor = typeof o.getActiveEditor === 'function' ? o.getActiveEditor() : null;
-        if (!editor || editor.__fhInlineAcceptBound) return;
-        editor.__fhInlineAcceptBound = true;
-        editor.onDidChangeModelContent((e) => {
-          if (!lastText) return;
-          for (const ch of e.changes || []) {
-            const ins = ch.text || '';
-            if (ins && (ins.startsWith(lastText) || lastText.startsWith(ins))) {
-              const accepted = ins.length >= lastText.length ? ins : lastText;
-              if (typeof o.onAccept === 'function') {
-                try { o.onAccept(accepted); } catch { /* lint 回调失败不阻塞编辑 */ }
-              }
-              lastText = '';
-              break;
-            }
-          }
-        });
-      };
-      bindAccept();
-    });
-  }
-
-  /**
-   * 注册补全项 Provider（Ctrl+Space 触发弹窗，↑↓选择，Enter接受）
-   * @param {function} fetchFn - 异步补全函数，参数 {filePath, content, offset, prefix}，返回数组 [{label, kind, insertText, detail}]
-   */
-  function registerCompletionItems(fetchFn) {
-    initMonaco().then((monaco) => {
-      if (completionItemProvider) {
-        completionItemProvider.dispose();
-      }
-      completionItemProvider = monaco.languages.registerCompletionItemProvider('*', {
-        triggerCharacters: ['.', '(', ',', ' '],
-        provideCompletionItems: async function (model, position, context, token) {
-          try {
-            const filePath = model.uri.path || 'untitled';
-            const content = model.getValue();
-            const offset = model.getOffsetAt(position);
-            const word = model.getWordUntilPosition(position);
-            const prefix = word.word || '';
-            const suggestions = await fetchFn({ filePath, content, offset, prefix, token });
-            if (!Array.isArray(suggestions) || !suggestions.length) return { suggestions: [] };
-            const range = new monaco.Range(
-              position.lineNumber, word.startColumn,
-              position.lineNumber, position.column
-            );
-            return {
-              suggestions: suggestions.map((s) => ({
-                label: s.label || s.insertText || '',
-                kind: monaco.languages.CompletionItemKind[s.kind] || monaco.languages.CompletionItemKind.Text,
-                insertText: s.insertText || '',
-                detail: s.detail || '',
-                range: range,
-              })),
-            };
-          } catch (e) {
-            return { suggestions: [] };
-          }
-        },
-      });
-    });
-  }
-
-  /**
-   * 注册语义诊断 Provider（P4-2：编辑时错误波浪线）
-   * @param {function} fetchFn - 异步诊断函数，参数 {filePath, content}，返回 [{line, column, endLine, endColumn, message, severity}]
-   * @param {function} [getEditor] - 获取当前编辑器实例（默认遍历已注册编辑器）
-   */
-  function registerDiagnostics(fetchFn, getActiveEditor) {
-    initMonaco().then((monaco) => {
-      // P5-2: 诊断 hover 提示——hover 到有 marker 的行时展示错误/警告详情
-      const langSet = [
-        'typescript', 'javascript', 'json', 'markdown', 'html', 'css', 'scss', 'less',
-        'python', 'java', 'c', 'cpp', 'csharp', 'go', 'rust', 'php', 'ruby', 'swift',
-        'kotlin', 'scala', 'shell', 'sql', 'yaml', 'xml', 'protobuf', 'dockerfile',
-        'ini', 'plaintext',
-      ];
-      const hoverDisp = monaco.languages.registerHoverProvider(langSet, {
-        provideHover(model, position) {
-          let editor;
-          try { editor = typeof getActiveEditor === 'function' ? getActiveEditor() : null; } catch { editor = null; }
-          if (!editor || editor.isDisposed?.()) return null;
-          const cur = editor.getModel();
-          if (!cur || model.uri.toString() !== cur.uri.toString()) return null;
-          const markers = monaco.editor.getModelMarkers({ resource: model.uri })
-            .filter((x) => x.startLineNumber <= position.lineNumber && position.lineNumber <= x.endLineNumber);
-          if (markers.length === 0) return null;
-          const md = markers.map((x) => {
-            const sevName = x.severity === monaco.MarkerSeverity.Error ? '错误' : x.severity === monaco.MarkerSeverity.Warning ? '警告' : '提示';
-            const icon = x.severity === monaco.MarkerSeverity.Error ? '⛔' : x.severity === monaco.MarkerSeverity.Warning ? '⚠️' : 'ℹ️';
-            return '**' + icon + ' ' + sevName + '** (L' + x.startLineNumber + ':' + x.startColumn + ')  \n' + x.message;
-          }).join('\n\n---\n\n');
-          return {
-            contents: [{ value: '#### 飞虹 Code 诊断\n\n' + md, isTrusted: true }],
-            range: new monaco.Range(position.lineNumber, 1, position.lineNumber, 1),
-          };
-        },
-      });
-      hoverDisp; // 引用保持存活（Monaco 内部维护）
-
-      // 防抖 + 单飞，避免编辑时高频请求
-      let timer = null;
-      let inflight = false;
-      let queued = false;
-      const run = async function () {
-        if (inflight) { queued = true; return; }
-        const editor = typeof getActiveEditor === 'function' ? getActiveEditor() : null;
-        if (!editor || editor.isDisposed?.()) return;
-        const model = editor.getModel();
-        if (!model) return;
-        inflight = true;
-        try {
-          const filePath = model.uri.path || 'untitled';
-          const content = model.getValue();
-          const result = await fetchFn({ filePath, content });
-          if (!result || !Array.isArray(result.diagnostics)) {
-            monaco.editor.setModelMarkers(model, 'fhcode', []);
-            return;
-          }
-          const markers = result.diagnostics.map((d) => {
-            const sev = d.severity === 1 || d.severity === 'error'
-              ? monaco.MarkerSeverity.Error
-              : d.severity === 2 || d.severity === 'warning'
-                ? monaco.MarkerSeverity.Warning
-                : monaco.MarkerSeverity.Info;
-            return {
-              severity: sev,
-              message: d.message || '',
-              startLineNumber: d.line ?? 1,
-              startColumn: d.column ?? 1,
-              endLineNumber: d.endLine ?? (d.line ?? 1),
-              endColumn: d.endColumn ?? (d.column ?? 1) + (d.message?.length || 8),
-            };
-          });
-          monaco.editor.setModelMarkers(model, 'fhcode', markers);
-        } catch {
-          /* 诊断失败静默（不阻塞编辑） */
-        } finally {
-          inflight = false;
-          if (queued) { queued = false; timer = setTimeout(run, 200); }
-        }
-      };
-      const schedule = function () {
-        clearTimeout(timer);
-        timer = setTimeout(run, 350);
-      };
-      // 绑定现有编辑器（createEditor 后由 ui 层调用 attachDiagnostics 触发监听）
-      const editor = typeof getActiveEditor === 'function' ? getActiveEditor() : null;
-      if (editor && !editor.__fhDiagnosticsBound) {
-        editor.__fhDiagnosticsBound = true;
-        editor.onDidChangeModelContent(schedule);
-        editor.onDidChangeModel(() => schedule());
-      }
-      return { run, schedule };
-    });
-  }
-
-  /**
-   * P6-1: 补全接受后的 lint 反馈——把 /api/lint 结果追加为编辑器波浪线（owner: fhcode-lint）
-   * @param {Array} issues - [{severity, line, column, message}]
-   */
-  function showLintFeedback(issues) {
-    initMonaco().then((monaco) => {
-      const editor = activeEditor;
-      if (!editor || editor.isDisposed?.()) return;
-      const model = editor.getModel();
-      if (!model) return;
-      if (!Array.isArray(issues) || issues.length === 0) {
-        monaco.editor.setModelMarkers(model, 'fhcode-lint', []);
-        return;
-      }
-      const markers = issues.map((d) => ({
-        severity: d.severity === 1 ? monaco.MarkerSeverity.Error : d.severity === 2 ? monaco.MarkerSeverity.Warning : monaco.MarkerSeverity.Info,
-        message: '补全校验：' + (d.message || ''),
-        startLineNumber: d.line ?? 1,
-        startColumn: d.column ?? 1,
-        endLineNumber: d.line ?? 1,
-        endColumn: (d.column ?? 1) + (d.message?.length || 20),
-      }));
-      monaco.editor.setModelMarkers(model, 'fhcode-lint', markers);
-    });
-  }
-
-  /** 暴露全局 API */
-  global.FHMonaco = {
-    init: initMonaco,
-    createEditor: createEditor,
-    getEditor: getEditor,
-    disposeEditor: disposeEditor,
-    detectLanguage: detectLanguage,
-    getActiveEditor: getActiveEditor,
-    registerInlineCompletions: registerInlineCompletions,
-    registerCompletionItems: registerCompletionItems,
-    registerDiagnostics: registerDiagnostics,
-    showLintFeedback: showLintFeedback,
-  };
-})(window);
+/**
+ * 飞虹 Code - Monaco Editor 封装模块
+ * VSCode 同款编辑器内核，提供语法高亮、智能补全、内联 ghost text 等能力
+ *
+ * 依赖：index.html 中已加载 vendor/monaco/vs/loader.js（AMD loader）
+ */
+(function (global) {
+  'use strict';
+
+  let monacoInstance = null;
+  let initPromise = null;
+  const editors = new Map(); // containerId -> editor instance
+  let activeEditor = null; // 最近创建的编辑器（供 lint/诊断反馈定位）
+  let inlineCompletionProvider = null;
+  let completionItemProvider = null;
+
+  /** 获取当前活跃编辑器（P6-1 lint 反馈定位） */
+  function getActiveEditor() {
+    return activeEditor;
+  }
+
+  /** 根据文件扩展名推断 Monaco language id */
+  function detectLanguage(filePath) {
+    const ext = filePath.split('.').pop().toLowerCase();
+    const map = {
+      ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
+      json: 'json', md: 'markdown', html: 'html', css: 'css', scss: 'scss',
+      less: 'less', py: 'python', java: 'java', c: 'c', cpp: 'cpp', h: 'cpp',
+      cs: 'csharp', go: 'go', rs: 'rust', php: 'php', rb: 'ruby', swift: 'swift',
+      kt: 'kotlin', scala: 'scala', sh: 'shell', bash: 'shell', zsh: 'shell',
+      sql: 'sql', yaml: 'yaml', yml: 'yaml', xml: 'xml', vue: 'html', svelte: 'html',
+      proto: 'protobuf', dockerfile: 'dockerfile', toml: 'ini', ini: 'ini',
+    };
+    if (filePath.toLowerCase().endsWith('dockerfile')) return 'dockerfile';
+    return map[ext] || 'plaintext';
+  }
+
+  /** 初始化 Monaco（只执行一次，返回 Promise） */
+  function initMonaco() {
+    if (monacoInstance) return Promise.resolve(monacoInstance);
+    if (initPromise) return initPromise;
+
+    initPromise = new Promise((resolve, reject) => {
+      if (typeof global.require === 'undefined') {
+        reject(new Error('Monaco loader.js 未加载，请检查 vendor/monaco/vs/loader.js'));
+        return;
+      }
+      global.require.config({ paths: { vs: 'vendor/monaco/vs' } });
+      global.require(['vs/editor/editor.main'], function () {
+        monacoInstance = global.monaco;
+        // 配置默认主题（跟随系统深色/浅色）
+        const isDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+        monacoInstance.editor.setTheme(isDark ? 'vs-dark' : 'vs');
+        resolve(monacoInstance);
+      }, reject);
+    });
+    return initPromise;
+  }
+
+  /**
+   * 在指定容器中创建 Monaco 编辑器
+   * @param {HTMLElement|string} container - 容器元素或 ID
+   * @param {string} value - 初始内容
+   * @param {string} filePath - 文件路径（用于推断语言）
+   * @param {object} options - 额外选项
+   * @returns {Promise<monaco.editor.IStandaloneCodeEditor>}
+   */
+  async function createEditor(container, value, filePath, options = {}) {
+    const monaco = await initMonaco();
+    const el = typeof container === 'string' ? document.getElementById(container) : container;
+    if (!el) throw new Error('编辑器容器不存在: ' + container);
+
+    // 如果该容器已有编辑器，先销毁
+    const existing = editors.get(el.id || container);
+    if (existing) {
+      existing.dispose();
+      editors.delete(el.id || container);
+    }
+
+    const language = detectLanguage(filePath);
+    const editor = monaco.editor.create(el, {
+      value: value || '',
+      language: language,
+      theme: undefined, // 使用全局主题
+      automaticLayout: true,
+      fontSize: 13,
+      lineNumbers: 'on',
+      minimap: { enabled: true },
+      scrollBeyondLastLine: false,
+      wordWrap: 'on',
+      bracketPairColorization: { enabled: true },
+      guides: { bracketPairs: true, indentation: true },
+      tabSize: 2,
+      renderWhitespace: 'selection',
+      smoothScrolling: true,
+      cursorBlinking: 'smooth',
+      // P0-1: 启用内联补全（ghost text，Tab 接受）
+      inlineSuggest: { enabled: true, showToolbar: 'always' },
+      // 启用快速建议（输入时自动触发补全弹窗）
+      quickSuggestions: { other: true, comments: false, strings: true },
+      quickSuggestionsDelay: 200,
+      ...options,
+    });
+
+    const key = el.id || container;
+    editors.set(key, editor);
+    activeEditor = editor; // P6-1: 记录最近活跃编辑器供 lint 反馈定位
+    return editor;
+  }
+
+  /** 获取编辑器实例 */
+  function getEditor(container) {
+    const key = typeof container === 'string' ? container : container.id;
+    return editors.get(key);
+  }
+
+  /** 销毁编辑器 */
+  function disposeEditor(container) {
+    const key = typeof container === 'string' ? container : container.id;
+    const editor = editors.get(key);
+    if (editor) {
+      editor.dispose();
+      editors.delete(key);
+    }
+  }
+
+  /**
+   * 注册内联补全 Provider（ghost text，Tab 接受）
+   * @param {function} fetchFn - 异步补全函数，参数 {filePath, content, offset}，返回 {text: string}
+   */
+  /**
+   * 注册行内补全 Provider（ghost text）
+   * @param {function} fetchFn - 异步补全函数，参数 {filePath, content, offset, token}，返回 {text} 或 null
+   * @param {{getActiveEditor?:function, onAccept?:function}} [opts] - P6-1: getActiveEditor 取当前编辑器；onAccept 在补全被接受（插入）时回调插入文本
+   */
+  function registerInlineCompletions(fetchFn, opts) {
+    const o = opts || {};
+    initMonaco().then((monaco) => {
+      if (inlineCompletionProvider) {
+        inlineCompletionProvider.dispose();
+      }
+      let lastText = '';
+      inlineCompletionProvider = monaco.languages.registerInlineCompletionsProvider('*', {
+        provideInlineCompletions: async function (model, position, context, token) {
+          try {
+            const filePath = model.uri.path || 'untitled';
+            const content = model.getValue();
+            const offset = model.getOffsetAt(position);
+            const result = await fetchFn({ filePath, content, offset, token });
+            if (!result || !result.text) return { items: [] };
+            const item = {
+              range: new monaco.Range(position.lineNumber, position.column, position.lineNumber, position.column),
+              insertText: result.text,
+              filterText: result.text.slice(0, 20),
+            };
+            lastText = result.text;
+            return { items: [item] };
+          } catch (e) {
+            return { items: [] };
+          }
+        },
+        freeInlineCompletions: function () {},
+      });
+
+      // P6-1: accept 检测——编辑器内容变化且插入文本匹配最近补全 → onAccept(插入文本)
+      const bindAccept = function () {
+        const editor = typeof o.getActiveEditor === 'function' ? o.getActiveEditor() : null;
+        if (!editor || editor.__fhInlineAcceptBound) return;
+        editor.__fhInlineAcceptBound = true;
+        editor.onDidChangeModelContent((e) => {
+          if (!lastText) return;
+          for (const ch of e.changes || []) {
+            const ins = ch.text || '';
+            if (ins && (ins.startsWith(lastText) || lastText.startsWith(ins))) {
+              const accepted = ins.length >= lastText.length ? ins : lastText;
+              if (typeof o.onAccept === 'function') {
+                try { o.onAccept(accepted); } catch { /* lint 回调失败不阻塞编辑 */ }
+              }
+              lastText = '';
+              break;
+            }
+          }
+        });
+      };
+      bindAccept();
+    });
+  }
+
+  /**
+   * 注册补全项 Provider（Ctrl+Space 触发弹窗，↑↓选择，Enter接受）
+   * @param {function} fetchFn - 异步补全函数，参数 {filePath, content, offset, prefix}，返回数组 [{label, kind, insertText, detail}]
+   */
+  function registerCompletionItems(fetchFn) {
+    initMonaco().then((monaco) => {
+      if (completionItemProvider) {
+        completionItemProvider.dispose();
+      }
+      completionItemProvider = monaco.languages.registerCompletionItemProvider('*', {
+        triggerCharacters: ['.', '(', ',', ' '],
+        provideCompletionItems: async function (model, position, context, token) {
+          try {
+            const filePath = model.uri.path || 'untitled';
+            const content = model.getValue();
+            const offset = model.getOffsetAt(position);
+            const word = model.getWordUntilPosition(position);
+            const prefix = word.word || '';
+            const suggestions = await fetchFn({ filePath, content, offset, prefix, token });
+            if (!Array.isArray(suggestions) || !suggestions.length) return { suggestions: [] };
+            const range = new monaco.Range(
+              position.lineNumber, word.startColumn,
+              position.lineNumber, position.column
+            );
+            return {
+              suggestions: suggestions.map((s) => ({
+                label: s.label || s.insertText || '',
+                kind: monaco.languages.CompletionItemKind[s.kind] || monaco.languages.CompletionItemKind.Text,
+                insertText: s.insertText || '',
+                detail: s.detail || '',
+                range: range,
+              })),
+            };
+          } catch (e) {
+            return { suggestions: [] };
+          }
+        },
+      });
+    });
+  }
+
+  /**
+   * 注册语义诊断 Provider（P4-2：编辑时错误波浪线）
+   * @param {function} fetchFn - 异步诊断函数，参数 {filePath, content}，返回 [{line, column, endLine, endColumn, message, severity}]
+   * @param {function} [getEditor] - 获取当前编辑器实例（默认遍历已注册编辑器）
+   */
+  function registerDiagnostics(fetchFn, getActiveEditor) {
+    initMonaco().then((monaco) => {
+      // P5-2: 诊断 hover 提示——hover 到有 marker 的行时展示错误/警告详情
+      const langSet = [
+        'typescript', 'javascript', 'json', 'markdown', 'html', 'css', 'scss', 'less',
+        'python', 'java', 'c', 'cpp', 'csharp', 'go', 'rust', 'php', 'ruby', 'swift',
+        'kotlin', 'scala', 'shell', 'sql', 'yaml', 'xml', 'protobuf', 'dockerfile',
+        'ini', 'plaintext',
+      ];
+      const hoverDisp = monaco.languages.registerHoverProvider(langSet, {
+        provideHover(model, position) {
+          let editor;
+          try { editor = typeof getActiveEditor === 'function' ? getActiveEditor() : null; } catch { editor = null; }
+          if (!editor || editor.isDisposed?.()) return null;
+          const cur = editor.getModel();
+          if (!cur || model.uri.toString() !== cur.uri.toString()) return null;
+          const markers = monaco.editor.getModelMarkers({ resource: model.uri })
+            .filter((x) => x.startLineNumber <= position.lineNumber && position.lineNumber <= x.endLineNumber);
+          if (markers.length === 0) return null;
+          const md = markers.map((x) => {
+            const sevName = x.severity === monaco.MarkerSeverity.Error ? '错误' : x.severity === monaco.MarkerSeverity.Warning ? '警告' : '提示';
+            const icon = x.severity === monaco.MarkerSeverity.Error ? '⛔' : x.severity === monaco.MarkerSeverity.Warning ? '⚠️' : 'ℹ️';
+            return '**' + icon + ' ' + sevName + '** (L' + x.startLineNumber + ':' + x.startColumn + ')  \n' + x.message;
+          }).join('\n\n---\n\n');
+          return {
+            contents: [{ value: '#### 飞虹 Code 诊断\n\n' + md, isTrusted: true }],
+            range: new monaco.Range(position.lineNumber, 1, position.lineNumber, 1),
+          };
+        },
+      });
+      hoverDisp; // 引用保持存活（Monaco 内部维护）
+
+      // 防抖 + 单飞，避免编辑时高频请求
+      let timer = null;
+      let inflight = false;
+      let queued = false;
+      const run = async function () {
+        if (inflight) { queued = true; return; }
+        const editor = typeof getActiveEditor === 'function' ? getActiveEditor() : null;
+        if (!editor || editor.isDisposed?.()) return;
+        const model = editor.getModel();
+        if (!model) return;
+        inflight = true;
+        try {
+          const filePath = model.uri.path || 'untitled';
+          const content = model.getValue();
+          const result = await fetchFn({ filePath, content });
+          if (!result || !Array.isArray(result.diagnostics)) {
+            monaco.editor.setModelMarkers(model, 'fhcode', []);
+            return;
+          }
+          const markers = result.diagnostics.map((d) => {
+            const sev = d.severity === 1 || d.severity === 'error'
+              ? monaco.MarkerSeverity.Error
+              : d.severity === 2 || d.severity === 'warning'
+                ? monaco.MarkerSeverity.Warning
+                : monaco.MarkerSeverity.Info;
+            return {
+              severity: sev,
+              message: d.message || '',
+              startLineNumber: d.line ?? 1,
+              startColumn: d.column ?? 1,
+              endLineNumber: d.endLine ?? (d.line ?? 1),
+              endColumn: d.endColumn ?? (d.column ?? 1) + (d.message?.length || 8),
+            };
+          });
+          monaco.editor.setModelMarkers(model, 'fhcode', markers);
+        } catch {
+          /* 诊断失败静默（不阻塞编辑） */
+        } finally {
+          inflight = false;
+          if (queued) { queued = false; timer = setTimeout(run, 200); }
+        }
+      };
+      const schedule = function () {
+        clearTimeout(timer);
+        timer = setTimeout(run, 350);
+      };
+      // 绑定现有编辑器（createEditor 后由 ui 层调用 attachDiagnostics 触发监听）
+      const editor = typeof getActiveEditor === 'function' ? getActiveEditor() : null;
+      if (editor && !editor.__fhDiagnosticsBound) {
+        editor.__fhDiagnosticsBound = true;
+        editor.onDidChangeModelContent(schedule);
+        editor.onDidChangeModel(() => schedule());
+      }
+      return { run, schedule };
+    });
+  }
+
+  /**
+   * P6-1: 补全接受后的 lint 反馈——把 /api/lint 结果追加为编辑器波浪线（owner: fhcode-lint）
+   * @param {Array} issues - [{severity, line, column, message}]
+   */
+  function showLintFeedback(issues) {
+    initMonaco().then((monaco) => {
+      const editor = activeEditor;
+      if (!editor || editor.isDisposed?.()) return;
+      const model = editor.getModel();
+      if (!model) return;
+      if (!Array.isArray(issues) || issues.length === 0) {
+        monaco.editor.setModelMarkers(model, 'fhcode-lint', []);
+        return;
+      }
+      const markers = issues.map((d) => ({
+        severity: d.severity === 1 ? monaco.MarkerSeverity.Error : d.severity === 2 ? monaco.MarkerSeverity.Warning : monaco.MarkerSeverity.Info,
+        message: '补全校验：' + (d.message || ''),
+        startLineNumber: d.line ?? 1,
+        startColumn: d.column ?? 1,
+        endLineNumber: d.line ?? 1,
+        endColumn: (d.column ?? 1) + (d.message?.length || 20),
+      }));
+      monaco.editor.setModelMarkers(model, 'fhcode-lint', markers);
+    });
+  }
+
+  /** 暴露全局 API */
+  global.FHMonaco = {
+    init: initMonaco,
+    createEditor: createEditor,
+    getEditor: getEditor,
+    disposeEditor: disposeEditor,
+    detectLanguage: detectLanguage,
+    getActiveEditor: getActiveEditor,
+    registerInlineCompletions: registerInlineCompletions,
+    registerCompletionItems: registerCompletionItems,
+    registerDiagnostics: registerDiagnostics,
+    showLintFeedback: showLintFeedback,
+  };
+})(window);