fix: markdown-enhancer CSS/hljs, add loadCSS/loadHighlightJS to plugin utils

- Framework: loadCSS for .css deps, skip hljs-* in manifest (plugin loads on-demand)
- markdown-enhancer: call loadHighlightJS() before hljs lang packs
- Expose loadCSS and loadHighlightJS in ChatRawPlugin.utils
- Update Plugins README with utils docs and lib loading notes

Author: massif-01

Plugins/Plugin_market/markdown-enhancer/main.js

@@ -163,6 +163,11 @@
     async function initExtraLanguages() {
         if (extraLangsLoaded || !window.hljs) return;
 
+        // Ensure hljs core is loaded first (app loads it lazily; plugin may run before that)
+        const loadHLJS = ChatRawPlugin?.utils?.loadHighlightJS;
+        if (loadHLJS) await loadHLJS();
+        if (!window.hljs) return;  // Cannot load lang packs without hljs core
+        
         const languages = [
             'typescript', 'go', 'rust', 'java', 'c', 'cpp', 'csharp',
             'ruby', 'php', 'swift', 'kotlin', 'sql', 'yaml', 'xml', 'shell'

Plugins/README.md

@@ -474,6 +474,12 @@ Helper functions for plugin developers:
 // Load external script
 await ChatRaw.utils.loadScript('https://cdn.example.com/lib.js');
 
+// Load external CSS (e.g. for bundled lib styles)
+await ChatRaw.utils.loadCSS('/api/plugins/your-plugin/lib/styles.min.css');
+
+// Ensure highlight.js core is loaded (call before loading hljs language packs)
+await ChatRaw.utils.loadHighlightJS();
+
 // Show toast notification
 ChatRaw.utils.showToast('Operation completed', 'success');
 
@@ -718,7 +724,7 @@ To distribute your plugin:
 
 For plugins that need to work completely offline, you can bundle dependencies in the `lib/` directory.
 
-**Important for plugin market**: If your plugin uses `lib/` files and will be installed from the market (GitHub URL), you **must** declare them in manifest `dependencies` using the format `/api/plugins/{plugin_id}/lib/{filename}`. Otherwise users get 404/MIME errors. Example:
+**Important for plugin market**: If your plugin uses `lib/` files and will be installed from the market (GitHub URL), you **must** declare them in manifest `dependencies` using the format `/api/plugins/{plugin_id}/lib/{filename}`. Otherwise users get 404/MIME errors. The framework loads `.css` files with `<link>` and `.js` files with `<script>`. Files named `hljs-*` are skipped (plugins load them on-demand after calling `ChatRaw.utils.loadHighlightJS()`). Example:
 
 ```json
 "dependencies": {
@@ -1418,6 +1424,12 @@ API 密钥安全存储在后端，会自动添加到请求中。
 // 加载外部脚本
 await ChatRaw.utils.loadScript('https://cdn.example.com/lib.js');
 
+// 加载外部 CSS（如 bundled 的样式）
+await ChatRaw.utils.loadCSS('/api/plugins/your-plugin/lib/styles.min.css');
+
+// 确保 highlight.js 核心已加载（使用 hljs 语言包前需先调用）
+await ChatRaw.utils.loadHighlightJS();
+
 // 显示提示消息
 ChatRaw.utils.showToast('操作完成', 'success');
 

RELEASE_v2.1.2.md

@@ -11,6 +11,8 @@
 ### Markdown 渲染增强 (v1.0.1)
 - 添加 manifest dependencies，解决从市场安装时 KaTeX/Mermaid/lib 404
 - 安装时自动下载全部 18 个 lib 文件
+- 修复：CSS 依赖用 loadCSS 加载（不再误用 loadScript）
+- 修复：hljs 语言包在 hljs 核心加载后再加载，避免 "hljs is not defined"
 
 ### 插件设置
 - 修复 select 类型 options 为对象数组时的 Alpine x-for key 警告

backend/static/app.js

@@ -1623,6 +1623,12 @@ function app() {
                     // Load external script dynamically
                     loadScript: (url) => appInstance.loadScript(url),
 
+                    // Load external CSS dynamically
+                    loadCSS: (url) => appInstance.loadCSS(url),
+                    
+                    // Ensure highlight.js is loaded (for plugins that use hljs language packs)
+                    loadHighlightJS: () => typeof loadHighlightJS === 'function' ? loadHighlightJS() : Promise.resolve(),
+                    
                     // Show toast notification
                     showToast: (message, type = '') => appInstance.showToast(message, type),
 
@@ -1900,14 +1906,25 @@ function app() {
                     for (const [name, url] of Object.entries(plugin.dependencies)) {
                         if (!this.loadedPluginDeps[name]) {
                             try {
-                                await this.loadScript(url);
-                                // Common library detection patterns
-                                if (name === 'xlsx' && window.XLSX) {
-                                    this.loadedPluginDeps[name] = window.XLSX;
-                                } else if (name === 'pdfjs' && window.pdfjsLib) {
-                                    this.loadedPluginDeps[name] = window.pdfjsLib;
-                                } else if (window[name]) {
-                                    this.loadedPluginDeps[name] = window[name];
+                                // CSS must use loadCSS, not loadScript
+                                if (typeof url === 'string' && url.endsWith('.css')) {
+                                    await this.loadCSS(url);
+                                    this.loadedPluginDeps[name] = true;
+                                } else if (name.startsWith('hljs-')) {
+                                    // hljs language packs loaded on-demand by plugin (need hljs core first)
+                                    continue;
+                                } else {
+                                    await this.loadScript(url);
+                                    // Common library detection patterns
+                                    if (name === 'xlsx' && window.XLSX) {
+                                        this.loadedPluginDeps[name] = window.XLSX;
+                                    } else if (name === 'pdfjs' && window.pdfjsLib) {
+                                        this.loadedPluginDeps[name] = window.pdfjsLib;
+                                    } else if (window[name]) {
+                                        this.loadedPluginDeps[name] = window[name];
+                                    } else {
+                                        this.loadedPluginDeps[name] = true;
+                                    }
                                 }
                             } catch (depError) {
                                 console.error(`[Plugin] Failed to load dependency ${name} for ${plugin.id}:`, depError);
@@ -1950,6 +1967,22 @@ function app() {
             });
         },
 
+        loadCSS(url) {
+            return new Promise((resolve, reject) => {
+                const existing = document.querySelector(`link[href="${url}"]`);
+                if (existing) {
+                    resolve();
+                    return;
+                }
+                const link = document.createElement('link');
+                link.rel = 'stylesheet';
+                link.href = url;
+                link.onload = resolve;
+                link.onerror = () => reject(new Error(`Failed to load CSS: ${url}`));
+                document.head.appendChild(link);
+            });
+        },
+        
         // Register a hook handler
         registerHook(hookName, handler) {
             if (!this.pluginHooks[hookName]) {