Upload 26 files

adapters/adapter-registry.js

@@ -1,61 +1,69 @@
-// ============================================================
-// Adapter Registry — Metadata, display names, và đăng ký adapter
-// Phụ thuộc: currentLang, ADAPTER_REGISTRY (từ data-loader.js / globalThis),
-//            bestMatchAdapter, logicAdapterDispatcher, mathematicalEvaluationAdapter,
-//            specificResponseAdapter, timeAdapter, unitConversionAdapter
-// ============================================================
-
-var ADAPTER_DISPLAY_NAMES = {
-    specific_response: { vi: 'Phản hồi cụ thể', en: 'Specific Response', ja: '特定応答' },
-    time_adapter: { vi: 'Thời gian', en: 'Time', ja: '時間' },
-    mathematical_evaluation: { vi: 'Tính toán', en: 'Math', ja: '数学計算' },
-    unit_conversion: { vi: 'Chuyển đổi đơn vị', en: 'Unit Conversion', ja: '単位変換' },
-    best_match: { vi: 'Best Match', en: 'Best Match', ja: 'ベストマッチ' },
-    logic_adapter: { vi: 'Logic Adapter', en: 'Logic Adapter', ja: 'ロジックアダプター' },
-    rivescript: { vi: 'RiveScript', en: 'RiveScript', ja: 'RiveScript' },
-    fallback_api: { vi: 'Fallback API', en: 'Fallback API', ja: 'Fallback API' },
-    web_search: { vi: 'Tìm kiếm Web', en: 'Web Search', ja: 'ウェブ検索' },
-    llm_adapter: { vi: 'LLM (WebGPU)', en: 'LLM (WebGPU)', ja: 'LLM（WebGPU）' }
-};
-
-function getAdapterDisplayName(adapterKey) {
-    var lang = currentLang || 'vi';
-    var names = ADAPTER_DISPLAY_NAMES[adapterKey];
-    if (!names) return adapterKey;
-    return names[lang] || names['vi'] || adapterKey;
-}
-
-function registerAdapters(bot, lang) {
-    var ADAPTER_FUNCTIONS = {
-        best_match: bestMatchAdapter,
-        logic_adapter: logicAdapterDispatcher,
-        mathematical_evaluation: mathematicalEvaluationAdapter,
-        specific_response: specificResponseAdapter,
-        time_adapter: timeAdapter,
-        unit_conversion: unitConversionAdapter,
-        web_search: webSearchAdapter,
-        llm_adapter: llmAdapter
-    };
-
-    var adapterNames = Object.keys(ADAPTER_REGISTRY);
-    for (var i = 0; i < adapterNames.length; i++) {
-        var name = adapterNames[i];
-        var entry = ADAPTER_REGISTRY[name];
-        var fn = ADAPTER_FUNCTIONS[name];
-
-        if (entry.active && typeof fn === 'function') {
-            (function (adapterFn) {
-                bot.setSubroutine(name, function (rs, args) {
-                    return adapterFn(rs, args);
-                });
-            })(fn);
-        }
-    }
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.ADAPTER_DISPLAY_NAMES = ADAPTER_DISPLAY_NAMES;
-    globalThis.getAdapterDisplayName = getAdapterDisplayName;
-    globalThis.registerAdapters = registerAdapters;
-}
+// ============================================================
+// Adapter Registry — Metadata, display names, và đăng ký adapter
+// Phụ thuộc: currentLang, ADAPTER_REGISTRY (từ data-loader.js / globalThis),
+//            bestMatchAdapter, logicAdapterDispatcher, mathematicalEvaluationAdapter,
+//            specificResponseAdapter, timeAdapter, unitConversionAdapter
+// ============================================================
+
+var ADAPTER_DISPLAY_NAMES = {
+    specific_response: { vi: 'Phản hồi cụ thể', en: 'Specific Response', ja: '特定応答' },
+    time_adapter: { vi: 'Thời gian', en: 'Time', ja: '時間' },
+    mathematical_evaluation: { vi: 'Tính toán', en: 'Math', ja: '数学計算' },
+    unit_conversion: { vi: 'Chuyển đổi đơn vị', en: 'Unit Conversion', ja: '単位変換' },
+    best_match: { vi: 'Best Match', en: 'Best Match', ja: 'ベストマッチ' },
+    logic_adapter: { vi: 'Logic Adapter', en: 'Logic Adapter', ja: 'ロジックアダプター' },
+    rivescript: { vi: 'RiveScript', en: 'RiveScript', ja: 'RiveScript' },
+    fallback_api: { vi: 'Fallback API', en: 'Fallback API', ja: 'Fallback API' },
+    web_search: { vi: 'Tìm kiếm Web', en: 'Web Search', ja: 'ウェブ検索' },
+    llm_adapter: { vi: 'LLM (WebGPU)', en: 'LLM (WebGPU)', ja: 'LLM（WebGPU）' }
+};
+
+function getAdapterDisplayName(adapterKey) {
+    var lang = currentLang || 'vi';
+    var names = ADAPTER_DISPLAY_NAMES[adapterKey];
+    if (!names) return adapterKey;
+    return names[lang] || names['vi'] || adapterKey;
+}
+
+function registerAdapters(bot, lang) {
+    var ADAPTER_FUNCTIONS = {
+        best_match: bestMatchAdapter,
+        logic_adapter: logicAdapterDispatcher,
+        mathematical_evaluation: mathematicalEvaluationAdapter,
+        specific_response: specificResponseAdapter,
+        time_adapter: timeAdapter,
+        unit_conversion: unitConversionAdapter,
+        web_search: webSearchAdapter,
+        llm_adapter: llmAdapter
+    };
+
+    var adapterNames = Object.keys(ADAPTER_REGISTRY);
+    for (var i = 0; i < adapterNames.length; i++) {
+        var name = adapterNames[i];
+        var entry = ADAPTER_REGISTRY[name];
+        var fn = ADAPTER_FUNCTIONS[name];
+
+        if (typeof fn === 'function') {
+            // Luôn đăng ký adapter, nhưng wrapper kiểm tra active flag
+            (function (adapterKey, adapterFn) {
+                bot.setSubroutine(adapterKey, function (rs, args) {
+                    // Kiểm tra active flag trước khi gọi adapter
+                    if (ADAPTER_REGISTRY[adapterKey] && ADAPTER_REGISTRY[adapterKey].active === false) {
+                        // Adapter bị disabled, trả về thông báo
+                        if (lang === 'en') return 'This adapter is currently disabled.';
+                        if (lang === 'ja') return 'このアダプターは現在無効です。';
+                        return 'Adapter này hiện đang bị vô hiệu hóa.';
+                    }
+                    return adapterFn(rs, args);
+                });
+            })(name, fn);
+        }
+    }
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.ADAPTER_DISPLAY_NAMES = ADAPTER_DISPLAY_NAMES;
+    globalThis.getAdapterDisplayName = getAdapterDisplayName;
+    globalThis.registerAdapters = registerAdapters;
+}

adapters/best-match.js

@@ -1,58 +1,58 @@
-// ============================================================
-// Best Match Adapter — So khớp tương đồng chuỗi với tập Q&A
-// Phụ thuộc: currentLang, _adapterPath, textSimilarity, removeVietnameseDiacritics,
-//            QA_DATASET, findBestMatchPreprocessed (optional)
-// ============================================================
-
-function bestMatchAdapter(rs, args) {
-    _adapterPath.push('best_match');
-    var input = (args || []).join(' ').trim();
-    var lang = currentLang || 'vi';
-    var threshold = 0.55;
-
-    if (input.length === 0) {
-        if (lang === 'en') return { answer: 'Please provide a question to search for.', score: 0 };
-        if (lang === 'ja') return { answer: '検索する質問を入力してください。', score: 0 };
-        return { answer: 'Vui lòng nhập câu hỏi để tìm kiếm.', score: 0 };
-    }
-
-    // Thử dùng preprocessed data trước (nhanh hơn)
-    if (typeof findBestMatchPreprocessed === 'function') {
-        var ppResult = findBestMatchPreprocessed(input, lang, threshold);
-        if (ppResult) return { answer: ppResult.answer, score: ppResult.score || threshold };
-    }
-
-    // Fallback: tính similarity thủ công từ QA_DATASET
-    var dataset = QA_DATASET[lang] || QA_DATASET['vi'];
-    var bestScore = -1;
-    var bestAnswer = '';
-
-    var inputLower = input.toLowerCase();
-    var inputNorm = (lang === 'vi' && typeof removeVietnameseDiacritics === 'function')
-        ? removeVietnameseDiacritics(inputLower) : null;
-
-    for (var i = 0; i < dataset.length; i++) {
-        var qLower = dataset[i].q.toLowerCase();
-        var score = textSimilarity(inputLower, qLower);
-        if (inputNorm) {
-            var qNorm = removeVietnameseDiacritics(qLower);
-            var scoreNorm = textSimilarity(inputNorm, qNorm);
-            if (scoreNorm > score) score = scoreNorm;
-        }
-        if (score > bestScore) {
-            bestScore = score;
-            bestAnswer = dataset[i].a;
-        }
-    }
-
-    if (bestScore >= threshold) return { answer: bestAnswer, score: bestScore };
-
-    if (lang === 'en') return { answer: 'Sorry, I could not find a suitable answer for your question.', score: bestScore };
-    if (lang === 'ja') return { answer: '申し訳ありませんが、ご質問に適した回答が見つかりませんでした。', score: bestScore };
-    return { answer: 'Xin lỗi, mình không tìm được câu trả lời phù hợp cho câu hỏi của bạn.', score: bestScore };
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.bestMatchAdapter = bestMatchAdapter;
-}
+// ============================================================
+// Best Match Adapter — So khớp tương đồng chuỗi với tập Q&A
+// Phụ thuộc: currentLang, _adapterPath, textSimilarity, removeVietnameseDiacritics,
+//            QA_DATASET, findBestMatchPreprocessed (optional)
+// ============================================================
+
+function bestMatchAdapter(rs, args) {
+    _adapterPath.push('best_match');
+    var input = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+    var threshold = 0.55;
+
+    if (input.length === 0) {
+        if (lang === 'en') return { answer: 'Please provide a question to search for.', score: 0 };
+        if (lang === 'ja') return { answer: '検索する質問を入力してください。', score: 0 };
+        return { answer: 'Vui lòng nhập câu hỏi để tìm kiếm.', score: 0 };
+    }
+
+    // Thử dùng preprocessed data trước (nhanh hơn)
+    if (typeof findBestMatchPreprocessed === 'function') {
+        var ppResult = findBestMatchPreprocessed(input, lang, threshold);
+        if (ppResult) return { answer: ppResult.answer, score: ppResult.score || threshold };
+    }
+
+    // Fallback: tính similarity thủ công từ QA_DATASET
+    var dataset = QA_DATASET[lang] || QA_DATASET['vi'];
+    var bestScore = -1;
+    var bestAnswer = '';
+
+    var inputLower = input.toLowerCase();
+    var inputNorm = (lang === 'vi' && typeof removeVietnameseDiacritics === 'function')
+        ? removeVietnameseDiacritics(inputLower) : null;
+
+    for (var i = 0; i < dataset.length; i++) {
+        var qLower = dataset[i].q.toLowerCase();
+        var score = textSimilarity(inputLower, qLower);
+        if (inputNorm) {
+            var qNorm = removeVietnameseDiacritics(qLower);
+            var scoreNorm = textSimilarity(inputNorm, qNorm);
+            if (scoreNorm > score) score = scoreNorm;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestAnswer = dataset[i].a;
+        }
+    }
+
+    if (bestScore >= threshold) return { answer: bestAnswer, score: bestScore };
+
+    if (lang === 'en') return { answer: 'Sorry, I could not find a suitable answer for your question.', score: bestScore };
+    if (lang === 'ja') return { answer: '申し訳ありませんが���ご質問に適した回答が見つかりませんでした。', score: bestScore };
+    return { answer: 'Xin lỗi, mình không tìm được câu trả lời phù hợp cho câu hỏi của bạn.', score: bestScore };
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.bestMatchAdapter = bestMatchAdapter;
+}

adapters/llm-adapter.js

@@ -1,460 +1,461 @@
-// ============================================================
-// LLM Adapter — Chạy LLM trực tiếp trên trình duyệt qua WebGPU
-// Tham khảo: webml-community/Qwen3.5-WebGPU (HuggingFace Spaces)
-// Sử dụng @huggingface/transformers để load model và generate text
-// Phụ thuộc: currentLang, _adapterPath
-// ============================================================
-
-/**
- * Trạng thái LLM — singleton, load model 1 lần duy nhất.
- */
-var _llmProcessor = null;
-var _llmModel = null;
-var _llmLoading = false;
-var _llmReady = false;
-var _llmLoadError = null;
-var _llmTransformers = null; // Lưu ref module transformers để dùng RawImage
-var _llmLastError = null;    // Lỗi cuối cùng từ LLM (để hiển thị cho user debug)
-var _llmStoppingCriteria = null; // InterruptableStoppingCriteria để cancel generate
-var _llmGenerating = false;  // Đang generate hay không
-var _llmThinkingEnabled = false; // Mặc định tắt thinking
-
-/**
- * Callback để thông báo trạng thái loading lên UI.
- * Được set từ app.js qua setLLMStatusCallback().
- * @type {function(string, string)|null}
- *   - action: 'loading_start' | 'loading_progress' | 'loading_done' | 'loading_error'
- *   - message: Mô tả trạng thái
- */
-var _llmStatusCallback = null;
-
-/**
- * Đăng ký callback nhận thông báo trạng thái loading.
- * @param {function(string, string)} callback - fn(action, message)
- */
-function setLLMStatusCallback(callback) {
-    _llmStatusCallback = typeof callback === 'function' ? callback : null;
-}
-
-function _notifyStatus(action, message) {
-    if (typeof _llmStatusCallback === 'function') {
-        try { _llmStatusCallback(action, message); } catch (e) { /* ignore */ }
-    }
-}
-
-/**
- * Model ID mặc định — Qwen3.5 0.6B (nhỏ nhất, phù hợp chạy trên browser).
- * Có thể thay đổi bằng cách gọi setLLMModelId() trước khi load.
- */
-var LLM_MODEL_ID = 'onnx-community/Qwen3.5-0.8B-ONNX-OPT';
-
-/**
- * Max tokens cho mỗi lần generate.
- */
-var LLM_MAX_NEW_TOKENS = 256;
-
-/**
- * Thay đổi model ID (phải gọi trước loadLLMModel).
- * @param {string} modelId - HuggingFace model ID
- */
-function setLLMModelId(modelId) {
-    if (typeof modelId === 'string' && modelId.trim()) {
-        LLM_MODEL_ID = modelId.trim();
-    }
-}
-
-/**
- * Bật/tắt thinking mode.
- * @param {boolean} enabled
- */
-function setLLMThinkingEnabled(enabled) {
-    _llmThinkingEnabled = !!enabled;
-}
-
-/**
- * Kiểm tra thinking mode có đang bật không.
- * @returns {boolean}
- */
-function isLLMThinkingEnabled() {
-    return _llmThinkingEnabled;
-}
-
-/**
- * Build prompt string từ history + message hiện tại.
- * History được truyền từ app.js, đã trim sẵn.
- * @param {string} userMessage
- * @param {boolean} hasImage
- * @param {Array<{role: string, content: string}>} [history] - Lịch sử hội thoại đã trim
- * @returns {string}
- */
-function _buildPromptWithHistory(userMessage, hasImage, history) {
-    var prompt = '';
-
-    // Thêm history nếu có
-    if (history && history.length > 0) {
-        for (var i = 0; i < history.length; i++) {
-            var msg = history[i];
-            prompt += '<|im_start|>' + msg.role + '\n' + msg.content + '<|im_end|>\n';
-        }
-    }
-
-    // Thêm message hiện tại
-    prompt += '<|im_start|>user\n';
-    if (hasImage) {
-        prompt += '<|vision_start|><|image_pad|><|vision_end|>';
-    }
-    prompt += userMessage + '<|im_end|>\n';
-
-    // Assistant prefix
-    prompt += '<|im_start|>assistant\n';
-    if (_llmThinkingEnabled) {
-        prompt += '<think>\n';
-    }
-
-    return prompt;
-}
-
-/**
- * Kiểm tra trình duyệt có hỗ trợ WebGPU không.
- * @returns {boolean}
- */
-function isWebGPUSupported() {
-    return typeof navigator !== 'undefined' && !!navigator.gpu;
-}
-
-/**
- * Load model và processor (lazy — chỉ load khi cần lần đầu).
- * Tham khảo cách Qwen3.5-WebGPU load model với dtype q4 và device webgpu.
- * @returns {Promise<boolean>} true nếu load thành công
- */
-async function loadLLMModel() {
-    if (_llmReady) return true;
-    if (_llmLoadError) return false;
-    if (_llmLoading) {
-        // Đợi nếu đang load
-        return new Promise(function (resolve) {
-            var check = setInterval(function () {
-                if (!_llmLoading) {
-                    clearInterval(check);
-                    resolve(_llmReady);
-                }
-            }, 200);
-        });
-    }
-
-    _llmLoading = true;
-
-    try {
-        // Dynamic import — @huggingface/transformers từ CDN
-        var transformers;
-        if (typeof module !== 'undefined' && module.exports) {
-            // Node/test: skip — WebGPU không khả dụng
-            _llmLoadError = 'WebGPU not available in Node.js';
-            _llmLoading = false;
-            return false;
-        }
-
-        // Browser: import từ CDN (giống Qwen3.5-WebGPU)
-        transformers = await import(
-            'https://cdn.jsdelivr.net/npm/@huggingface/transformers@4.2.0'
-        );
-        _llmTransformers = transformers;
-
-        // Khởi tạo stopping criteria để hỗ trợ cancel
-        _llmStoppingCriteria = new transformers.InterruptableStoppingCriteria();
-
-        if (!isWebGPUSupported()) {
-            _llmLoadError = 'WebGPU not supported';
-            _llmLoading = false;
-            return false;
-        }
-
-        console.log('[LLM Adapter] Loading processor:', LLM_MODEL_ID);
-        _notifyStatus('loading_start', 'Loading processor...');
-        _llmProcessor = await transformers.AutoProcessor.from_pretrained(LLM_MODEL_ID);
-
-        console.log('[LLM Adapter] Loading model:', LLM_MODEL_ID);
-        _notifyStatus('loading_progress', 'Loading model weights...');
-        _llmModel = await transformers.Qwen3_5ForConditionalGeneration.from_pretrained(
-            LLM_MODEL_ID,
-            {
-                dtype: {
-                    embed_tokens: 'q4',
-                    vision_encoder: 'fp16',
-                    decoder_model_merged: 'q4'
-                },
-                device: 'webgpu'
-            }
-        );
-
-        _llmReady = true;
-        _llmLoading = false;
-        console.log('[LLM Adapter] Model loaded successfully');
-        _notifyStatus('loading_done', 'Model loaded successfully');
-        return true;
-    } catch (err) {
-        console.error('[LLM Adapter] Failed to load model:', err);
-        _llmLoadError = err.message || 'Unknown error';
-        _llmLoading = false;
-        _notifyStatus('loading_error', 'Failed to load model: ' + _llmLoadError);
-        return false;
-    }
-}
-
-/**
- * Helper: dispose past_key_values để giải phóng bộ nhớ GPU.
- */
-function _disposePastKeyValues(pastKeyValues) {
-    if (!pastKeyValues) return;
-    try {
-        for (var key of Object.keys(pastKeyValues)) {
-            if (pastKeyValues[key] && typeof pastKeyValues[key].dispose === 'function') {
-                pastKeyValues[key].dispose();
-            }
-        }
-    } catch (e) { /* ignore */ }
-}
-
-/**
- * Generate text từ LLM cho một prompt.
- * Sử dụng TextStreamer để thu thập response token-by-token.
- * @param {string} userMessage - Tin nhắn người dùng
- * @param {function} [onToken] - Callback nhận text tích lũy mỗi khi có token mới: fn(accumulatedText)
- * @param {Array} [history] - Lịch sử hội thoại đã trim
- * @returns {Promise<string|null>} Phản hồi từ LLM hoặc null nếu lỗi
- */
-async function llmGenerate(userMessage, onToken, history) {
-    if (!_llmReady || !_llmModel || !_llmProcessor || !_llmTransformers) return null;
-
-    _llmGenerating = true;
-    try {
-        var prompt = _buildPromptWithHistory(userMessage, false, history);
-
-        var inputs = await _llmProcessor(prompt);
-
-        var fullText = '';
-        var streamer = new _llmTransformers.TextStreamer(_llmProcessor.tokenizer, {
-            skip_prompt: true,
-            skip_special_tokens: true,
-            callback_function: function (token) {
-                fullText += token;
-                if (typeof onToken === 'function') {
-                    onToken(fullText);
-                }
-            }
-        });
-
-        if (_llmStoppingCriteria) _llmStoppingCriteria.reset();
-
-        var generateOpts = {
-            ...inputs,
-            max_new_tokens: LLM_MAX_NEW_TOKENS,
-            do_sample: true,
-            streamer: streamer,
-            return_dict_in_generate: true
-        };
-        if (_llmStoppingCriteria) {
-            generateOpts.stopping_criteria = _llmStoppingCriteria;
-        }
-
-        var result = await _llmModel.generate(generateOpts);
-
-        _disposePastKeyValues(result.past_key_values);
-
-        var trimmed = fullText.replace(/^\n+/, '').trim();
-        _llmGenerating = false;
-        return trimmed.length > 0 ? trimmed : null;
-    } catch (err) {
-        console.error('[LLM Adapter] Generate error:', err);
-        _llmLastError = 'Generate error: ' + (err.message || err);
-        _llmGenerating = false;
-        return null;
-    }
-}
-
-/**
- * Generate text từ LLM cho một prompt kèm image.
- * Sử dụng TextStreamer để thu thập response token-by-token.
- * @param {string} userMessage - Tin nhắn người dùng
- * @param {string} imageDataURL - Data URL hoặc blob URL của ảnh
- * @param {function} [onToken] - Callback nhận text tích lũy mỗi khi có token mới: fn(accumulatedText)
- * @param {Array} [history] - Lịch sử hội thoại đã trim
- * @returns {Promise<string|null>} Phản hồi từ LLM hoặc null nếu lỗi
- */
-async function llmGenerateWithImage(userMessage, imageDataURL, onToken, history) {
-    if (!_llmReady || !_llmModel || !_llmProcessor || !_llmTransformers) return null;
-
-    _llmGenerating = true;
-    try {
-        var rawImage = await _llmTransformers.RawImage.read(imageDataURL);
-        var resizedImage = await rawImage.resize(448, 448);
-
-        var prompt = _buildPromptWithHistory(userMessage || '', true, history);
-
-        var inputs = await _llmProcessor(prompt, resizedImage);
-
-        var fullText = '';
-        var streamer = new _llmTransformers.TextStreamer(_llmProcessor.tokenizer, {
-            skip_prompt: true,
-            skip_special_tokens: true,
-            callback_function: function (token) {
-                fullText += token;
-                if (typeof onToken === 'function') {
-                    onToken(fullText);
-                }
-            }
-        });
-
-        if (_llmStoppingCriteria) _llmStoppingCriteria.reset();
-
-        var generateOpts = {
-            ...inputs,
-            max_new_tokens: LLM_MAX_NEW_TOKENS,
-            do_sample: true,
-            streamer: streamer,
-            return_dict_in_generate: true
-        };
-        if (_llmStoppingCriteria) {
-            generateOpts.stopping_criteria = _llmStoppingCriteria;
-        }
-
-        var result = await _llmModel.generate(generateOpts);
-
-        _disposePastKeyValues(result.past_key_values);
-
-        var trimmed = fullText.replace(/^\n+/, '').trim();
-        _llmGenerating = false;
-
-        return trimmed.length > 0 ? trimmed : null;
-    } catch (err) {
-        console.error('[LLM Adapter] Generate with image error:', err);
-        _llmLastError = 'Generate with image error: ' + (err.message || err);
-        _llmGenerating = false;
-        return null;
-    }
-}
-
-/**
- * LLM Adapter — Interface chính, tương thích với hệ thống adapter.
- * Có thể dùng như subroutine hoặc gọi trực tiếp.
- * @param {object} rs - RiveScript instance (có thể null)
- * @param {string[]} args - Mảng từ (input đã split)
- * @param {string} [imageDataURL] - Data URL của ảnh đính kèm (optional)
- * @param {function} [onToken] - Callback stream token realtime: fn(accumulatedText)
- * @param {Array} [history] - Lịch sử hội thoại đã trim từ app.js
- * @returns {Promise<string|null>} Phản hồi từ LLM hoặc null
- */
-async function llmAdapter(rs, args, imageDataURL, onToken, history) {
-    _adapterPath.push('llm_adapter');
-    _llmLastError = null;
-    var query = (args || []).join(' ').trim();
-    var lang = currentLang || 'vi';
-
-    // Cho phép gửi ảnh mà không cần text (mô tả ảnh)
-    if (query.length === 0 && !imageDataURL) {
-        if (lang === 'en') return 'Please provide a message.';
-        if (lang === 'ja') return 'メッセージを入力してください。';
-        return 'Vui lòng nhập tin nhắn.';
-    }
-
-    // Nếu chỉ có ảnh mà không có text, thêm prompt mặc định
-    if (query.length === 0 && imageDataURL) {
-        if (lang === 'en') query = 'Describe this image in detail.';
-        else if (lang === 'ja') query = 'この画像を詳しく説明してください。';
-        else query = 'Hãy mô tả chi tiết hình ảnh này.';
-    }
-
-    // Kiểm tra WebGPU
-    if (!isWebGPUSupported()) {
-        _llmLastError = 'WebGPU not supported in this browser';
-        return null;
-    }
-
-    // Load model nếu chưa load
-    var loaded = await loadLLMModel();
-    if (!loaded) {
-        _llmLastError = 'Model load failed: ' + (_llmLoadError || 'unknown');
-        return null;
-    }
-
-    // Generate — không timeout, chờ LLM chạy hết
-    var generateFn = imageDataURL
-        ? llmGenerateWithImage(query, imageDataURL, onToken, history)
-        : llmGenerate(query, onToken, history);
-
-    var result = await generateFn;
-
-    if (result) return result;
-
-    if (!_llmLastError) {
-        _llmLastError = 'Generate returned empty response';
-    }
-    return null;
-}
-
-/**
- * Hủy bỏ quá trình generate đang chạy.
- */
-function cancelLLMGeneration() {
-    if (_llmStoppingCriteria && _llmGenerating) {
-        _llmStoppingCriteria.interrupt();
-        console.log('[LLM Adapter] Generation cancelled by user');
-    }
-}
-
-/**
- * Kiểm tra LLM đang generate hay không.
- * @returns {boolean}
- */
-function isLLMGenerating() {
-    return _llmGenerating;
-}
-
-/**
- * Lấy lỗi cuối cùng từ LLM adapter (để hiển thị debug info).
- * @returns {string|null}
- */
-function getLLMLastError() {
-    return _llmLastError;
-}
-
-/**
- * Kiểm tra LLM đã sẵn sàng chưa.
- * @returns {boolean}
- */
-function isLLMReady() {
-    return _llmReady;
-}
-
-/**
- * Lấy trạng thái LLM.
- * @returns {{ready: boolean, loading: boolean, error: string|null, modelId: string}}
- */
-function getLLMStatus() {
-    return {
-        ready: _llmReady,
-        loading: _llmLoading,
-        error: _llmLoadError,
-        modelId: LLM_MODEL_ID
-    };
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.llmAdapter = llmAdapter;
-    globalThis.loadLLMModel = loadLLMModel;
-    globalThis.llmGenerate = llmGenerate;
-    globalThis.llmGenerateWithImage = llmGenerateWithImage;
-    globalThis.isWebGPUSupported = isWebGPUSupported;
-    globalThis.isLLMReady = isLLMReady;
-    globalThis.getLLMStatus = getLLMStatus;
-    globalThis.getLLMLastError = getLLMLastError;
-    globalThis.cancelLLMGeneration = cancelLLMGeneration;
-    globalThis.isLLMGenerating = isLLMGenerating;
-    globalThis.setLLMModelId = setLLMModelId;
-    globalThis.setLLMThinkingEnabled = setLLMThinkingEnabled;
-    globalThis.isLLMThinkingEnabled = isLLMThinkingEnabled;
-    globalThis.setLLMStatusCallback = setLLMStatusCallback;
-    globalThis.LLM_MODEL_ID = LLM_MODEL_ID;
-    globalThis.LLM_MAX_NEW_TOKENS = LLM_MAX_NEW_TOKENS;
-}
+// ============================================================
+// LLM Adapter — Chạy LLM trực tiếp trên trình duyệt qua WebGPU
+// Tham khảo: webml-community/Qwen3.5-WebGPU (HuggingFace Spaces)
+// Sử dụng @huggingface/transformers để load model và generate text
+// Phụ thuộc: currentLang, _adapterPath
+// ============================================================
+
+/**
+ * Trạng thái LLM — singleton, load model 1 lần duy nhất.
+ */
+var _llmProcessor = null;
+var _llmModel = null;
+var _llmLoading = false;
+var _llmReady = false;
+var _llmLoadError = null;
+var _llmTransformers = null; // Lưu ref module transformers để dùng RawImage
+var _llmLastError = null;    // Lỗi cuối cùng từ LLM (để hiển thị cho user debug)
+var _llmStoppingCriteria = null; // InterruptableStoppingCriteria để cancel generate
+var _llmGenerating = false;  // Đang generate hay không
+var _llmThinkingEnabled = false; // Mặc định tắt thinking
+
+/**
+ * Callback để thông báo trạng thái loading lên UI.
+ * Được set từ app.js qua setLLMStatusCallback().
+ * @type {function(string, string)|null}
+ *   - action: 'loading_start' | 'loading_progress' | 'loading_done' | 'loading_error'
+ *   - message: Mô tả trạng thái
+ */
+var _llmStatusCallback = null;
+
+/**
+ * Đăng ký callback nhận thông báo trạng thái loading.
+ * @param {function(string, string)} callback - fn(action, message)
+ */
+function setLLMStatusCallback(callback) {
+    _llmStatusCallback = typeof callback === 'function' ? callback : null;
+}
+
+function _notifyStatus(action, message) {
+    if (typeof _llmStatusCallback === 'function') {
+        try { _llmStatusCallback(action, message); } catch (e) { /* ignore */ }
+    }
+}
+
+/**
+ * Model ID mặc định — Qwen3.5 0.6B (nhỏ nhất, phù hợp chạy trên browser).
+ * Có thể thay đổi bằng cách gọi setLLMModelId() trước khi load.
+ */
+var LLM_MODEL_ID = 'onnx-community/Qwen3.5-0.8B-ONNX-OPT';
+
+/**
+ * Max tokens cho mỗi lần generate.
+ */
+var LLM_MAX_NEW_TOKENS = 256;
+
+/**
+ * Thay đổi model ID (phải gọi trước loadLLMModel).
+ * @param {string} modelId - HuggingFace model ID
+ */
+function setLLMModelId(modelId) {
+    if (typeof modelId === 'string' && modelId.trim()) {
+        LLM_MODEL_ID = modelId.trim();
+    }
+}
+
+/**
+ * Bật/tắt thinking mode.
+ * @param {boolean} enabled
+ */
+function setLLMThinkingEnabled(enabled) {
+    _llmThinkingEnabled = !!enabled;
+    try { localStorage.setItem('hikari_llm_thinking', _llmThinkingEnabled ? '1' : '0'); } catch (e) {}
+}
+
+/**
+ * Kiểm tra thinking mode có đang bật không.
+ * @returns {boolean}
+ */
+function isLLMThinkingEnabled() {
+    return _llmThinkingEnabled;
+}
+
+/**
+ * Build prompt string từ history + message hiện tại.
+ * History được truyền từ app.js, đã trim sẵn.
+ * @param {string} userMessage
+ * @param {boolean} hasImage
+ * @param {Array<{role: string, content: string}>} [history] - Lịch sử hội thoại đã trim
+ * @returns {string}
+ */
+function _buildPromptWithHistory(userMessage, hasImage, history) {
+    var prompt = '';
+
+    // Thêm history nếu có
+    if (history && history.length > 0) {
+        for (var i = 0; i < history.length; i++) {
+            var msg = history[i];
+            prompt += '<|im_start|>' + msg.role + '\n' + msg.content + '<|im_end|>\n';
+        }
+    }
+
+    // Thêm message hiện tại
+    prompt += '<|im_start|>user\n';
+    if (hasImage) {
+        prompt += '<|vision_start|><|image_pad|><|vision_end|>';
+    }
+    prompt += userMessage + '<|im_end|>\n';
+
+    // Assistant prefix
+    prompt += '<|im_start|>assistant\n';
+    if (_llmThinkingEnabled) {
+        prompt += '<think>\n';
+    }
+
+    return prompt;
+}
+
+/**
+ * Kiểm tra trình duyệt có hỗ trợ WebGPU không.
+ * @returns {boolean}
+ */
+function isWebGPUSupported() {
+    return typeof navigator !== 'undefined' && !!navigator.gpu;
+}
+
+/**
+ * Load model và processor (lazy — chỉ load khi cần lần đầu).
+ * Tham khảo cách Qwen3.5-WebGPU load model với dtype q4 và device webgpu.
+ * @returns {Promise<boolean>} true nếu load thành công
+ */
+async function loadLLMModel() {
+    if (_llmReady) return true;
+    if (_llmLoadError) return false;
+    if (_llmLoading) {
+        // Đợi nếu đang load
+        return new Promise(function (resolve) {
+            var check = setInterval(function () {
+                if (!_llmLoading) {
+                    clearInterval(check);
+                    resolve(_llmReady);
+                }
+            }, 200);
+        });
+    }
+
+    _llmLoading = true;
+
+    try {
+        // Dynamic import — @huggingface/transformers từ CDN
+        var transformers;
+        if (typeof module !== 'undefined' && module.exports) {
+            // Node/test: skip — WebGPU không khả dụng
+            _llmLoadError = 'WebGPU not available in Node.js';
+            _llmLoading = false;
+            return false;
+        }
+
+        // Browser: import từ CDN (giống Qwen3.5-WebGPU)
+        transformers = await import(
+            'https://cdn.jsdelivr.net/npm/@huggingface/transformers@4.2.0'
+        );
+        _llmTransformers = transformers;
+
+        // Khởi tạo stopping criteria để hỗ trợ cancel
+        _llmStoppingCriteria = new transformers.InterruptableStoppingCriteria();
+
+        if (!isWebGPUSupported()) {
+            _llmLoadError = 'WebGPU not supported';
+            _llmLoading = false;
+            return false;
+        }
+
+        console.log('[LLM Adapter] Loading processor:', LLM_MODEL_ID);
+        _notifyStatus('loading_start', 'Loading processor...');
+        _llmProcessor = await transformers.AutoProcessor.from_pretrained(LLM_MODEL_ID);
+
+        console.log('[LLM Adapter] Loading model:', LLM_MODEL_ID);
+        _notifyStatus('loading_progress', 'Loading model weights...');
+        _llmModel = await transformers.Qwen3_5ForConditionalGeneration.from_pretrained(
+            LLM_MODEL_ID,
+            {
+                dtype: {
+                    embed_tokens: 'q4',
+                    vision_encoder: 'fp16',
+                    decoder_model_merged: 'q4'
+                },
+                device: 'webgpu'
+            }
+        );
+
+        _llmReady = true;
+        _llmLoading = false;
+        console.log('[LLM Adapter] Model loaded successfully');
+        _notifyStatus('loading_done', 'Model loaded successfully');
+        return true;
+    } catch (err) {
+        console.error('[LLM Adapter] Failed to load model:', err);
+        _llmLoadError = err.message || 'Unknown error';
+        _llmLoading = false;
+        _notifyStatus('loading_error', 'Failed to load model: ' + _llmLoadError);
+        return false;
+    }
+}
+
+/**
+ * Helper: dispose past_key_values để giải phóng bộ nhớ GPU.
+ */
+function _disposePastKeyValues(pastKeyValues) {
+    if (!pastKeyValues) return;
+    try {
+        for (var key of Object.keys(pastKeyValues)) {
+            if (pastKeyValues[key] && typeof pastKeyValues[key].dispose === 'function') {
+                pastKeyValues[key].dispose();
+            }
+        }
+    } catch (e) { /* ignore */ }
+}
+
+/**
+ * Generate text từ LLM cho một prompt.
+ * Sử dụng TextStreamer để thu thập response token-by-token.
+ * @param {string} userMessage - Tin nhắn người dùng
+ * @param {function} [onToken] - Callback nhận text tích lũy mỗi khi có token mới: fn(accumulatedText)
+ * @param {Array} [history] - Lịch sử hội thoại đã trim
+ * @returns {Promise<string|null>} Phản hồi từ LLM hoặc null nếu lỗi
+ */
+async function llmGenerate(userMessage, onToken, history) {
+    if (!_llmReady || !_llmModel || !_llmProcessor || !_llmTransformers) return null;
+
+    _llmGenerating = true;
+    try {
+        var prompt = _buildPromptWithHistory(userMessage, false, history);
+
+        var inputs = await _llmProcessor(prompt);
+
+        var fullText = '';
+        var streamer = new _llmTransformers.TextStreamer(_llmProcessor.tokenizer, {
+            skip_prompt: true,
+            skip_special_tokens: true,
+            callback_function: function (token) {
+                fullText += token;
+                if (typeof onToken === 'function') {
+                    onToken(fullText);
+                }
+            }
+        });
+
+        if (_llmStoppingCriteria) _llmStoppingCriteria.reset();
+
+        var generateOpts = {
+            ...inputs,
+            max_new_tokens: LLM_MAX_NEW_TOKENS,
+            do_sample: true,
+            streamer: streamer,
+            return_dict_in_generate: true
+        };
+        if (_llmStoppingCriteria) {
+            generateOpts.stopping_criteria = _llmStoppingCriteria;
+        }
+
+        var result = await _llmModel.generate(generateOpts);
+
+        _disposePastKeyValues(result.past_key_values);
+
+        var trimmed = fullText.replace(/^\n+/, '').trim();
+        _llmGenerating = false;
+        return trimmed.length > 0 ? trimmed : null;
+    } catch (err) {
+        console.error('[LLM Adapter] Generate error:', err);
+        _llmLastError = 'Generate error: ' + (err.message || err);
+        _llmGenerating = false;
+        return null;
+    }
+}
+
+/**
+ * Generate text từ LLM cho một prompt kèm image.
+ * Sử dụng TextStreamer để thu thập response token-by-token.
+ * @param {string} userMessage - Tin nhắn người dùng
+ * @param {string} imageDataURL - Data URL hoặc blob URL của ảnh
+ * @param {function} [onToken] - Callback nhận text tích lũy mỗi khi có token mới: fn(accumulatedText)
+ * @param {Array} [history] - Lịch sử hội thoại đã trim
+ * @returns {Promise<string|null>} Phản hồi từ LLM hoặc null nếu lỗi
+ */
+async function llmGenerateWithImage(userMessage, imageDataURL, onToken, history) {
+    if (!_llmReady || !_llmModel || !_llmProcessor || !_llmTransformers) return null;
+
+    _llmGenerating = true;
+    try {
+        var rawImage = await _llmTransformers.RawImage.read(imageDataURL);
+        var resizedImage = await rawImage.resize(448, 448);
+
+        var prompt = _buildPromptWithHistory(userMessage || '', true, history);
+
+        var inputs = await _llmProcessor(prompt, resizedImage);
+
+        var fullText = '';
+        var streamer = new _llmTransformers.TextStreamer(_llmProcessor.tokenizer, {
+            skip_prompt: true,
+            skip_special_tokens: true,
+            callback_function: function (token) {
+                fullText += token;
+                if (typeof onToken === 'function') {
+                    onToken(fullText);
+                }
+            }
+        });
+
+        if (_llmStoppingCriteria) _llmStoppingCriteria.reset();
+
+        var generateOpts = {
+            ...inputs,
+            max_new_tokens: LLM_MAX_NEW_TOKENS,
+            do_sample: true,
+            streamer: streamer,
+            return_dict_in_generate: true
+        };
+        if (_llmStoppingCriteria) {
+            generateOpts.stopping_criteria = _llmStoppingCriteria;
+        }
+
+        var result = await _llmModel.generate(generateOpts);
+
+        _disposePastKeyValues(result.past_key_values);
+
+        var trimmed = fullText.replace(/^\n+/, '').trim();
+        _llmGenerating = false;
+
+        return trimmed.length > 0 ? trimmed : null;
+    } catch (err) {
+        console.error('[LLM Adapter] Generate with image error:', err);
+        _llmLastError = 'Generate with image error: ' + (err.message || err);
+        _llmGenerating = false;
+        return null;
+    }
+}
+
+/**
+ * LLM Adapter — Interface chính, tương thích với hệ thống adapter.
+ * Có thể dùng như subroutine hoặc gọi trực tiếp.
+ * @param {object} rs - RiveScript instance (có thể null)
+ * @param {string[]} args - Mảng từ (input đã split)
+ * @param {string} [imageDataURL] - Data URL của ảnh đính kèm (optional)
+ * @param {function} [onToken] - Callback stream token realtime: fn(accumulatedText)
+ * @param {Array} [history] - Lịch sử hội thoại đã trim từ app.js
+ * @returns {Promise<string|null>} Phản hồi từ LLM hoặc null
+ */
+async function llmAdapter(rs, args, imageDataURL, onToken, history) {
+    _adapterPath.push('llm_adapter');
+    _llmLastError = null;
+    var query = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+
+    // Cho phép gửi ảnh mà không cần text (mô tả ảnh)
+    if (query.length === 0 && !imageDataURL) {
+        if (lang === 'en') return 'Please provide a message.';
+        if (lang === 'ja') return 'メッセージを入力してください。';
+        return 'Vui lòng nhập tin nhắn.';
+    }
+
+    // Nếu chỉ có ảnh mà không có text, thêm prompt mặc định
+    if (query.length === 0 && imageDataURL) {
+        if (lang === 'en') query = 'Describe this image in detail.';
+        else if (lang === 'ja') query = 'この画像を詳しく説明してください。';
+        else query = 'Hãy mô tả chi tiết hình ảnh này.';
+    }
+
+    // Kiểm tra WebGPU
+    if (!isWebGPUSupported()) {
+        _llmLastError = 'WebGPU not supported in this browser';
+        return null;
+    }
+
+    // Load model nếu chưa load
+    var loaded = await loadLLMModel();
+    if (!loaded) {
+        _llmLastError = 'Model load failed: ' + (_llmLoadError || 'unknown');
+        return null;
+    }
+
+    // Generate — không timeout, chờ LLM chạy hết
+    var generateFn = imageDataURL
+        ? llmGenerateWithImage(query, imageDataURL, onToken, history)
+        : llmGenerate(query, onToken, history);
+
+    var result = await generateFn;
+
+    if (result) return result;
+
+    if (!_llmLastError) {
+        _llmLastError = 'Generate returned empty response';
+    }
+    return null;
+}
+
+/**
+ * Hủy bỏ quá trình generate đang chạy.
+ */
+function cancelLLMGeneration() {
+    if (_llmStoppingCriteria && _llmGenerating) {
+        _llmStoppingCriteria.interrupt();
+        console.log('[LLM Adapter] Generation cancelled by user');
+    }
+}
+
+/**
+ * Kiểm tra LLM đang generate hay không.
+ * @returns {boolean}
+ */
+function isLLMGenerating() {
+    return _llmGenerating;
+}
+
+/**
+ * Lấy lỗi cuối cùng từ LLM adapter (để hiển thị debug info).
+ * @returns {string|null}
+ */
+function getLLMLastError() {
+    return _llmLastError;
+}
+
+/**
+ * Kiểm tra LLM đã sẵn sàng chưa.
+ * @returns {boolean}
+ */
+function isLLMReady() {
+    return _llmReady;
+}
+
+/**
+ * Lấy trạng thái LLM.
+ * @returns {{ready: boolean, loading: boolean, error: string|null, modelId: string}}
+ */
+function getLLMStatus() {
+    return {
+        ready: _llmReady,
+        loading: _llmLoading,
+        error: _llmLoadError,
+        modelId: LLM_MODEL_ID
+    };
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.llmAdapter = llmAdapter;
+    globalThis.loadLLMModel = loadLLMModel;
+    globalThis.llmGenerate = llmGenerate;
+    globalThis.llmGenerateWithImage = llmGenerateWithImage;
+    globalThis.isWebGPUSupported = isWebGPUSupported;
+    globalThis.isLLMReady = isLLMReady;
+    globalThis.getLLMStatus = getLLMStatus;
+    globalThis.getLLMLastError = getLLMLastError;
+    globalThis.cancelLLMGeneration = cancelLLMGeneration;
+    globalThis.isLLMGenerating = isLLMGenerating;
+    globalThis.setLLMModelId = setLLMModelId;
+    globalThis.setLLMThinkingEnabled = setLLMThinkingEnabled;
+    globalThis.isLLMThinkingEnabled = isLLMThinkingEnabled;
+    globalThis.setLLMStatusCallback = setLLMStatusCallback;
+    globalThis.LLM_MODEL_ID = LLM_MODEL_ID;
+    globalThis.LLM_MAX_NEW_TOKENS = LLM_MAX_NEW_TOKENS;
+}

adapters/logic-dispatcher.js

@@ -1,64 +1,71 @@
-// ============================================================
-// Logic Adapter Dispatcher — Điều phối các adapter con theo ưu tiên
-// Phụ thuộc: currentLang, _adapterPath, specificResponseAdapter, timeAdapter,
-//            mathematicalEvaluationAdapter, unitConversionAdapter, bestMatchAdapter
-// ============================================================
-
-var INVALID_RESPONSE_PHRASES = [
-    'không có phản hồi cụ thể', 'không hiểu', 'không thể', 'không tìm thấy',
-    'không tìm được', 'cú pháp không hợp lệ',
-    'no specific response', "don't understand", 'cannot', 'not found',
-    'invalid syntax', 'could not find',
-    '特定の応答はありません', '理解できません', 'できません', '見つかりません',
-    '構文が無効', '見つかりませんでした'
-];
-
-function isValidAdapterResult(result) {
-    if (typeof result !== 'string' || result.trim().length === 0) return false;
-    var lower = result.toLowerCase();
-    for (var i = 0; i < INVALID_RESPONSE_PHRASES.length; i++) {
-        if (lower.indexOf(INVALID_RESPONSE_PHRASES[i].toLowerCase()) !== -1) return false;
-    }
-    return true;
-}
-
-function logicAdapterDispatcher(rs, args) {
-    _adapterPath.push('logic_adapter');
-    var adapters = [
-        specificResponseAdapter,
-        timeAdapter,
-        mathematicalEvaluationAdapter,
-        unitConversionAdapter,
-        bestMatchAdapter
-    ];
-
-    var pathLenBefore = _adapterPath.length;
-
-    for (var i = 0; i < adapters.length; i++) {
-        try {
-            _adapterPath.length = pathLenBefore;
-            var result = adapters[i](rs, args);
-            // bestMatchAdapter trả {answer, score}, các adapter khác trả string
-            if (result && typeof result === 'object' && result.answer) {
-                if (isValidAdapterResult(result.answer)) return result.answer;
-            } else if (isValidAdapterResult(result)) {
-                return result;
-            }
-        } catch (err) {
-            continue;
-        }
-    }
-
-    _adapterPath.length = pathLenBefore;
-    var lang = currentLang || 'vi';
-    if (lang === 'en') return 'Sorry, I cannot process your request at this time.';
-    if (lang === 'ja') return '申し訳ありませんが、現在リクエストを処理できません。';
-    return 'Xin lỗi, mình không thể xử lý yêu cầu của bạn lúc này.';
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.INVALID_RESPONSE_PHRASES = INVALID_RESPONSE_PHRASES;
-    globalThis.isValidAdapterResult = isValidAdapterResult;
-    globalThis.logicAdapterDispatcher = logicAdapterDispatcher;
-}
+// ============================================================
+// Logic Adapter Dispatcher — Điều phối các adapter con theo ưu tiên
+// Phụ thuộc: currentLang, _adapterPath, specificResponseAdapter, timeAdapter,
+//            mathematicalEvaluationAdapter, unitConversionAdapter, bestMatchAdapter
+// ============================================================
+
+var INVALID_RESPONSE_PHRASES = [
+    'không có phản hồi cụ thể', 'không hiểu', 'không thể', 'không tìm thấy',
+    'không tìm được', 'cú pháp không hợp lệ',
+    'no specific response', "don't understand", 'cannot', 'not found',
+    'invalid syntax', 'could not find',
+    '特定の応答はありません', '理解できません', 'できません', '見つかりません',
+    '構文が無効', '見つかりませんでした'
+];
+
+function isValidAdapterResult(result) {
+    if (typeof result !== 'string' || result.trim().length === 0) return false;
+    var lower = result.toLowerCase();
+    for (var i = 0; i < INVALID_RESPONSE_PHRASES.length; i++) {
+        if (lower.indexOf(INVALID_RESPONSE_PHRASES[i].toLowerCase()) !== -1) return false;
+    }
+    return true;
+}
+
+function logicAdapterDispatcher(rs, args) {
+    _adapterPath.push('logic_adapter');
+    var adapterMap = [
+        { key: 'specific_response', fn: specificResponseAdapter },
+        { key: 'time_adapter', fn: timeAdapter },
+        { key: 'mathematical_evaluation', fn: mathematicalEvaluationAdapter },
+        { key: 'unit_conversion', fn: unitConversionAdapter },
+        { key: 'best_match', fn: bestMatchAdapter }
+    ];
+
+    var pathLenBefore = _adapterPath.length;
+
+    for (var i = 0; i < adapterMap.length; i++) {
+        var entry = adapterMap[i];
+        // Bỏ qua adapter bị disabled
+        if (typeof ADAPTER_REGISTRY !== 'undefined' &&
+            ADAPTER_REGISTRY[entry.key] &&
+            ADAPTER_REGISTRY[entry.key].active === false) {
+            continue;
+        }
+        try {
+            _adapterPath.length = pathLenBefore;
+            var result = entry.fn(rs, args);
+            // bestMatchAdapter trả {answer, score}, các adapter khác trả string
+            if (result && typeof result === 'object' && result.answer) {
+                if (isValidAdapterResult(result.answer)) return result.answer;
+            } else if (isValidAdapterResult(result)) {
+                return result;
+            }
+        } catch (err) {
+            continue;
+        }
+    }
+
+    _adapterPath.length = pathLenBefore;
+    var lang = currentLang || 'vi';
+    if (lang === 'en') return 'Sorry, I cannot process your request at this time.';
+    if (lang === 'ja') return '申し訳ありませんが、現在リクエストを処理できません。';
+    return 'Xin lỗi, mình không thể xử lý yêu cầu của bạn lúc này.';
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.INVALID_RESPONSE_PHRASES = INVALID_RESPONSE_PHRASES;
+    globalThis.isValidAdapterResult = isValidAdapterResult;
+    globalThis.logicAdapterDispatcher = logicAdapterDispatcher;
+}

adapters/math-adapter.js

@@ -1,77 +1,77 @@
-// ============================================================
-// Mathematical Evaluation Adapter — Tính toán biểu thức toán học
-// Phụ thuộc: currentLang, _adapterPath
-// ============================================================
-
-/**
- * Trích xuất và tính toán biểu thức toán học từ chuỗi đầu vào.
- * Không sử dụng eval() — dùng regex + switch/case.
- */
-function parseMathExpression(input, lang) {
-    if (typeof input !== 'string' || input.trim().length === 0) {
-        return { error: lang === 'en' ? 'Invalid expression.' : lang === 'ja' ? '無効な式です。' : 'Biểu thức không hợp lệ.' };
-    }
-
-    var expr = input.trim();
-    if (lang !== 'ja') expr = expr.toLowerCase();
-
-    if (lang === 'vi') {
-        expr = expr.replace(/cộng/g, '+').replace(/trừ/g, '-').replace(/nhân/g, '*').replace(/chia/g, '/');
-    } else if (lang === 'en') {
-        expr = expr.replace(/divided\s+by/g, '/').replace(/plus/g, '+').replace(/minus/g, '-').replace(/times/g, '*');
-    } else if (lang === 'ja') {
-        expr = expr.replace(/足す/g, '+').replace(/引く/g, '-').replace(/掛ける/g, '*').replace(/割る/g, '/');
-    }
-
-    expr = expr.replace(/×/g, '*').replace(/÷/g, '/');
-
-    var match = expr.match(/(-?\d+(?:\.\d+)?)\s*([+\-*/])\s*(-?\d+(?:\.\d+)?)/);
-    if (!match) {
-        return { error: lang === 'en' ? 'Cannot parse the mathematical expression.' : lang === 'ja' ? '数式を解析できませんでした。' : 'Không thể phân tích biểu thức toán học.' };
-    }
-
-    var a = parseFloat(match[1]);
-    var operator = match[2];
-    var b = parseFloat(match[3]);
-    var result;
-
-    switch (operator) {
-        case '+': result = a + b; break;
-        case '-': result = a - b; break;
-        case '*': result = a * b; break;
-        case '/':
-            if (b === 0) return { error: lang === 'en' ? 'Cannot divide by zero.' : lang === 'ja' ? 'ゼロで割ることはできません。' : 'Không thể chia cho 0.' };
-            result = a / b; break;
-        default:
-            return { error: lang === 'en' ? 'Unsupported operator.' : lang === 'ja' ? 'サポートされていない演算子です。' : 'Phép tính không được hỗ trợ.' };
-    }
-
-    return { result: result };
-}
-
-function mathematicalEvaluationAdapter(rs, args) {
-    _adapterPath.push('mathematical_evaluation');
-    var input = (args || []).join(' ').trim();
-    var lang = currentLang || 'vi';
-
-    if (input.length === 0) {
-        return lang === 'en' ? 'Please provide a mathematical expression.'
-            : lang === 'ja' ? '数式を入力してください。'
-            : 'Vui lòng nhập biểu thức toán học.';
-    }
-
-    var parsed = parseMathExpression(input, lang);
-    if (parsed.error) return parsed.error;
-
-    var resultStr = Number.isInteger(parsed.result) ? String(parsed.result) : parsed.result.toFixed(2).replace(/\.?0+$/, '');
-
-    if (lang === 'en') return 'Result: ' + resultStr;
-    if (lang === 'ja') return '結果: ' + resultStr;
-    return 'Kết quả: ' + resultStr;
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.parseMathExpression = parseMathExpression;
-    globalThis.mathematicalEvaluationAdapter = mathematicalEvaluationAdapter;
-}
+// ============================================================
+// Mathematical Evaluation Adapter — Tính toán biểu thức toán học
+// Phụ thuộc: currentLang, _adapterPath
+// ============================================================
+
+/**
+ * Trích xuất và tính toán biểu thức toán học từ chuỗi đầu vào.
+ * Không sử dụng eval() — dùng regex + switch/case.
+ */
+function parseMathExpression(input, lang) {
+    if (typeof input !== 'string' || input.trim().length === 0) {
+        return { error: lang === 'en' ? 'Invalid expression.' : lang === 'ja' ? '無効な式です。' : 'Biểu thức không hợp lệ.' };
+    }
+
+    var expr = input.trim();
+    if (lang !== 'ja') expr = expr.toLowerCase();
+
+    if (lang === 'vi') {
+        expr = expr.replace(/cộng/g, '+').replace(/trừ/g, '-').replace(/nhân/g, '*').replace(/chia/g, '/');
+    } else if (lang === 'en') {
+        expr = expr.replace(/divided\s+by/g, '/').replace(/plus/g, '+').replace(/minus/g, '-').replace(/times/g, '*');
+    } else if (lang === 'ja') {
+        expr = expr.replace(/足す/g, '+').replace(/引く/g, '-').replace(/掛ける/g, '*').replace(/割る/g, '/');
+    }
+
+    expr = expr.replace(/×/g, '*').replace(/÷/g, '/');
+
+    var match = expr.match(/(-?\d+(?:\.\d+)?)\s*([+\-*/])\s*(-?\d+(?:\.\d+)?)/);
+    if (!match) {
+        return { error: lang === 'en' ? 'Cannot parse the mathematical expression.' : lang === 'ja' ? '数式を解析できませんでした。' : 'Không thể phân tích biểu thức toán học.' };
+    }
+
+    var a = parseFloat(match[1]);
+    var operator = match[2];
+    var b = parseFloat(match[3]);
+    var result;
+
+    switch (operator) {
+        case '+': result = a + b; break;
+        case '-': result = a - b; break;
+        case '*': result = a * b; break;
+        case '/':
+            if (b === 0) return { error: lang === 'en' ? 'Cannot divide by zero.' : lang === 'ja' ? 'ゼロで割ることはできません。' : 'Không thể chia cho 0.' };
+            result = a / b; break;
+        default:
+            return { error: lang === 'en' ? 'Unsupported operator.' : lang === 'ja' ? 'サポートされていない演算子です。' : 'Phép tính không được hỗ trợ.' };
+    }
+
+    return { result: result };
+}
+
+function mathematicalEvaluationAdapter(rs, args) {
+    _adapterPath.push('mathematical_evaluation');
+    var input = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+
+    if (input.length === 0) {
+        return lang === 'en' ? 'Please provide a mathematical expression.'
+            : lang === 'ja' ? '数式を入力してください。'
+            : 'Vui lòng nhập biểu thức toán học.';
+    }
+
+    var parsed = parseMathExpression(input, lang);
+    if (parsed.error) return parsed.error;
+
+    var resultStr = Number.isInteger(parsed.result) ? String(parsed.result) : parsed.result.toFixed(2).replace(/\.?0+$/, '');
+
+    if (lang === 'en') return 'Result: ' + resultStr;
+    if (lang === 'ja') return '結果: ' + resultStr;
+    return 'Kết quả: ' + resultStr;
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.parseMathExpression = parseMathExpression;
+    globalThis.mathematicalEvaluationAdapter = mathematicalEvaluationAdapter;
+}

adapters/specific-response.js

@@ -1,53 +1,53 @@
-// ============================================================
-// Specific Response Adapter — Phản hồi exact match từ bảng ánh xạ
-// Phụ thuộc: currentLang, _adapterPath, removeVietnameseDiacritics, SPECIFIC_RESPONSES
-// ============================================================
-
-/**
- * Specific Response Adapter — Object Macro trả về phản hồi exact match.
- * So khớp case-insensitive, hỗ trợ diacritics-stripped match cho tiếng Việt.
- *
- * @param {object} rs - RiveScript instance
- * @param {string[]} args - Mảng các từ từ thẻ <call>
- * @returns {string} Câu trả lời tương ứng hoặc thông báo "không có phản hồi cụ thể"
- */
-function specificResponseAdapter(rs, args) {
-    _adapterPath.push('specific_response');
-    var input = (args || []).join(' ').trim().toLowerCase();
-
-    if (input.length === 0) {
-        return currentLang === 'en'
-            ? 'No specific response for this question.'
-            : currentLang === 'ja'
-                ? 'この質問に対する特定の応答はありません。'
-                : 'Không có phản hồi cụ thể cho câu hỏi này.';
-    }
-
-    var responses = SPECIFIC_RESPONSES[currentLang] || SPECIFIC_RESPONSES['vi'];
-
-    // Thử exact match trước
-    var keys = Object.keys(responses);
-    for (var i = 0; i < keys.length; i++) {
-        if (keys[i].toLowerCase() === input) {
-            return responses[keys[i]];
-        }
-    }
-    // Thử match sau khi bỏ dấu (chỉ tiếng Việt)
-    if (currentLang === 'vi') {
-        var inputNoDiacritics = removeVietnameseDiacritics(input);
-        for (var j = 0; j < keys.length; j++) {
-            if (removeVietnameseDiacritics(keys[j].toLowerCase()) === inputNoDiacritics) {
-                return responses[keys[j]];
-            }
-        }
-    }
-
-    if (currentLang === 'en') return 'No specific response for this question.';
-    if (currentLang === 'ja') return 'この質問に対する特定の応答はありません。';
-    return 'Không có phản hồi cụ thể cho câu hỏi này.';
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.specificResponseAdapter = specificResponseAdapter;
-}
+// ============================================================
+// Specific Response Adapter — Phản hồi exact match từ bảng ánh xạ
+// Phụ thuộc: currentLang, _adapterPath, removeVietnameseDiacritics, SPECIFIC_RESPONSES
+// ============================================================
+
+/**
+ * Specific Response Adapter — Object Macro trả về phản hồi exact match.
+ * So khớp case-insensitive, hỗ trợ diacritics-stripped match cho tiếng Việt.
+ *
+ * @param {object} rs - RiveScript instance
+ * @param {string[]} args - Mảng các từ từ thẻ <call>
+ * @returns {string} Câu trả lời tương ứng hoặc thông báo "không có phản hồi cụ thể"
+ */
+function specificResponseAdapter(rs, args) {
+    _adapterPath.push('specific_response');
+    var input = (args || []).join(' ').trim().toLowerCase();
+
+    if (input.length === 0) {
+        return currentLang === 'en'
+            ? 'No specific response for this question.'
+            : currentLang === 'ja'
+                ? 'この質問に対する特定の応答はありません。'
+                : 'Không có phản hồi cụ thể cho câu hỏi này.';
+    }
+
+    var responses = SPECIFIC_RESPONSES[currentLang] || SPECIFIC_RESPONSES['vi'];
+
+    // Thử exact match trước
+    var keys = Object.keys(responses);
+    for (var i = 0; i < keys.length; i++) {
+        if (keys[i].toLowerCase() === input) {
+            return responses[keys[i]];
+        }
+    }
+    // Thử match sau khi bỏ dấu (chỉ tiếng Việt)
+    if (currentLang === 'vi') {
+        var inputNoDiacritics = removeVietnameseDiacritics(input);
+        for (var j = 0; j < keys.length; j++) {
+            if (removeVietnameseDiacritics(keys[j].toLowerCase()) === inputNoDiacritics) {
+                return responses[keys[j]];
+            }
+        }
+    }
+
+    if (currentLang === 'en') return 'No specific response for this question.';
+    if (currentLang === 'ja') return 'この質問に対する特定の応答はありません。';
+    return 'Không có phản hồi cụ thể cho câu hỏi này.';
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.specificResponseAdapter = specificResponseAdapter;
+}

adapters/text-similarity.js

@@ -1,427 +1,427 @@
-// ============================================================
-// Text Similarity — Thuật toán so khớp chuỗi
-// Gồm 4 thuật toán: Levenshtein, Jaccard, Cosine, Synset
-// + Preprocessed data support (TF-IDF, pre-tokenized)
-// ============================================================
-
-// --- Preprocessed data cache ---
-// Loaded from data/preprocessed.json (build-time) hoặc localStorage (client)
-var _preprocessedData = null;
-var _PREPROCESSED_STORAGE_KEY = 'hikari_preprocessed';
-
-/**
- * Load preprocessed data.
- * - Browser: thử localStorage trước, nếu không có hoặc outdated thì fetch từ server
- * - Node/test: load trực tiếp từ file
- * @returns {Promise<void>}
- */
-async function loadPreprocessedData() {
-    // Node/test environment
-    if (typeof module !== 'undefined' && module.exports) {
-        try {
-            var fs = require('fs');
-            var path = require('path');
-            var filePath = path.join(__dirname, '..', 'data', 'preprocessed.json');
-            _preprocessedData = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-        } catch (e) {
-            _preprocessedData = null;
-        }
-        return;
-    }
-
-    // Browser: thử localStorage
-    try {
-        var cached = localStorage.getItem(_PREPROCESSED_STORAGE_KEY);
-        if (cached) {
-            var parsed = JSON.parse(cached);
-            // Fetch version từ server để check outdated
-            var resp = await fetch('data/preprocessed.json', { method: 'HEAD' });
-            // Dùng Last-Modified hoặc so sánh version
-            if (parsed && parsed.version) {
-                _preprocessedData = parsed;
-                // Background check: fetch full file và so sánh version
-                fetch('data/preprocessed.json').then(function(r) { return r.json(); }).then(function(fresh) {
-                    if (fresh.version !== parsed.version) {
-                        _preprocessedData = fresh;
-                        localStorage.setItem(_PREPROCESSED_STORAGE_KEY, JSON.stringify(fresh));
-                    }
-                }).catch(function() {});
-                return;
-            }
-        }
-    } catch (e) { /* localStorage not available */ }
-
-    // Browser: fetch từ server
-    try {
-        var response = await fetch('data/preprocessed.json');
-        if (response.ok) {
-            _preprocessedData = await response.json();
-            try {
-                localStorage.setItem(_PREPROCESSED_STORAGE_KEY, JSON.stringify(_preprocessedData));
-            } catch (e) { /* quota exceeded */ }
-        }
-    } catch (e) {
-        _preprocessedData = null;
-    }
-}
-
-/**
- * Lấy preprocessed data cho ngôn ngữ hiện tại.
- * @param {string} lang
- * @returns {object|null} { idf, statements } hoặc null
- */
-function getPreprocessedLang(lang) {
-    if (!_preprocessedData || !_preprocessedData.langs) return null;
-    return _preprocessedData.langs[lang] || null;
-}
-
-// ---- Tokenize (dùng cho input mới) ----
-
-/**
- * Tokenize input text: lowercase, bỏ dấu (vi), bỏ punctuation, tách từ.
- * Dùng cùng logic với scripts/preprocess.js để đảm bảo consistency.
- * @param {string} text
- * @param {string} lang
- * @returns {string[]}
- */
-function tokenizeForSimilarity(text, lang) {
-    var s = String(text).toLowerCase();
-    if (lang === 'vi' && typeof removeVietnameseDiacritics === 'function') {
-        s = removeVietnameseDiacritics(s);
-    }
-    s = s.replace(/[?!.,;:"""''`~()[\]{}\\|@#$%^&]/g, ' ');
-    return s.split(/\s+/).filter(function(w) { return w.length > 0; });
-}
-
-// ---- 1. Levenshtein Distance ----
-
-function levenshteinDistance(a, b) {
-    var strA = String(a);
-    var strB = String(b);
-    var lenA = strA.length;
-    var lenB = strB.length;
-
-    if (lenA === 0) return lenB;
-    if (lenB === 0) return lenA;
-
-    var prev = [];
-    var curr = [];
-    var i, j;
-
-    for (j = 0; j <= lenB; j++) prev[j] = j;
-
-    for (i = 1; i <= lenA; i++) {
-        curr[0] = i;
-        for (j = 1; j <= lenB; j++) {
-            if (strA[i - 1] === strB[j - 1]) {
-                curr[j] = prev[j - 1];
-            } else {
-                curr[j] = 1 + Math.min(prev[j - 1], prev[j], curr[j - 1]);
-            }
-        }
-        var tmp = prev;
-        prev = curr;
-        curr = tmp;
-    }
-    return prev[lenB];
-}
-
-// ---- 2. Jaccard Similarity ----
-
-function jaccardSimilarity(a, b) {
-    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
-    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
-
-    if (wordsA.length === 0 && wordsB.length === 0) return 0;
-
-    var setA = {}, setB = {}, i;
-    for (i = 0; i < wordsA.length; i++) setA[wordsA[i]] = true;
-    for (i = 0; i < wordsB.length; i++) setB[wordsB[i]] = true;
-
-    var intersection = 0, union = {};
-    for (var k1 in setA) { union[k1] = true; if (setB[k1]) intersection++; }
-    for (var k2 in setB) { union[k2] = true; }
-
-    var unionSize = Object.keys(union).length;
-    return unionSize === 0 ? 0 : intersection / unionSize;
-}
-
-// ---- 3. Cosine Similarity ----
-
-function cosineSimilarity(a, b) {
-    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
-    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
-
-    if (wordsA.length === 0 || wordsB.length === 0) return 0;
-
-    var tfA = {}, tfB = {}, i;
-    for (i = 0; i < wordsA.length; i++) tfA[wordsA[i]] = (tfA[wordsA[i]] || 0) + 1;
-    for (i = 0; i < wordsB.length; i++) tfB[wordsB[i]] = (tfB[wordsB[i]] || 0) + 1;
-
-    var vocab = {};
-    for (var ka in tfA) vocab[ka] = true;
-    for (var kb in tfB) vocab[kb] = true;
-
-    var dot = 0, magA = 0, magB = 0;
-    var keys = Object.keys(vocab);
-    for (i = 0; i < keys.length; i++) {
-        var va = tfA[keys[i]] || 0;
-        var vb = tfB[keys[i]] || 0;
-        dot += va * vb;
-        magA += va * va;
-        magB += vb * vb;
-    }
-
-    magA = Math.sqrt(magA);
-    magB = Math.sqrt(magB);
-    return (magA === 0 || magB === 0) ? 0 : dot / (magA * magB);
-}
-
-/**
- * Cosine similarity sử dụng TF-IDF vectors (preprocessed).
- * Input vector được tính on-the-fly, corpus vector đã preprocessed.
- * @param {object} inputTFIDF - TF-IDF vector của input
- * @param {number} inputMag - Magnitude của input vector
- * @param {object} corpusTFIDF - TF-IDF vector đã preprocessed
- * @param {number} corpusMag - Magnitude đã preprocessed
- * @returns {number} [0, 1]
- */
-function cosineSimilarityTFIDF(inputTFIDF, inputMag, corpusTFIDF, corpusMag) {
-    if (inputMag === 0 || corpusMag === 0) return 0;
-
-    var dot = 0;
-    // Iterate over smaller vector for efficiency
-    for (var word in inputTFIDF) {
-        if (corpusTFIDF[word]) {
-            dot += inputTFIDF[word] * corpusTFIDF[word];
-        }
-    }
-    return dot / (inputMag * corpusMag);
-}
-
-// ---- 4. Synset Similarity ----
-
-var SYNONYM_GROUPS = [
-    ['xin chao','chao','hi','hello','hey','yo'],
-    ['tam biet','bye','goodbye','hen gap lai','tot lanh'],
-    ['cam on','thanks','thank','thank you'],
-    ['ten','name','ai','who','la ai'],
-    ['lam gi','lam duoc','co the','giup','help','what can'],
-    ['may gio','gio','time','clock','bao gio'],
-    ['ngay','hom nay','date','today','ngay may'],
-    ['thu','thu may','day','what day'],
-    ['tinh','calculate','math','cong','tru','nhan','chia','plus','minus'],
-    ['doi','convert','sang','to','chuyen doi'],
-    ['chatbot','bot','ai','robot','may','machine'],
-    ['la gi','what is','what','gi','mean'],
-    ['khoe','vui','happy','fine','good','ok'],
-    ['tuoi','age','old','bao nhieu tuoi'],
-    ['o dau','where','dau','location'],
-    ['thich','like','love','yeu'],
-    ['huong dan','cach','how','guide','help','su dung','use']
-];
-
-var _synonymLookup = null;
-function _getSynonymLookup() {
-    if (_synonymLookup) return _synonymLookup;
-    _synonymLookup = {};
-    for (var g = 0; g < SYNONYM_GROUPS.length; g++) {
-        for (var w = 0; w < SYNONYM_GROUPS[g].length; w++) {
-            var word = SYNONYM_GROUPS[g][w].toLowerCase();
-            if (!_synonymLookup[word]) _synonymLookup[word] = [];
-            _synonymLookup[word].push(g);
-        }
-    }
-    return _synonymLookup;
-}
-
-function areSynonyms(wordA, wordB) {
-    if (wordA === wordB) return true;
-    var lookup = _getSynonymLookup();
-    var groupsA = lookup[wordA];
-    var groupsB = lookup[wordB];
-    if (!groupsA || !groupsB) return false;
-    for (var i = 0; i < groupsA.length; i++) {
-        for (var j = 0; j < groupsB.length; j++) {
-            if (groupsA[i] === groupsB[j]) return true;
-        }
-    }
-    return false;
-}
-
-function synsetSimilarity(a, b) {
-    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
-    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
-
-    if (wordsA.length === 0 || wordsB.length === 0) return 0;
-
-    var matchAtoB = 0;
-    for (var i = 0; i < wordsA.length; i++) {
-        for (var j = 0; j < wordsB.length; j++) {
-            if (areSynonyms(wordsA[i], wordsB[j])) { matchAtoB++; break; }
-        }
-    }
-    var matchBtoA = 0;
-    for (var m = 0; m < wordsB.length; m++) {
-        for (var n = 0; n < wordsA.length; n++) {
-            if (areSynonyms(wordsB[m], wordsA[n])) { matchBtoA++; break; }
-        }
-    }
-
-    return ((matchAtoB / wordsA.length) + (matchBtoA / wordsB.length)) / 2;
-}
-
-/**
- * Synset similarity sử dụng preprocessed synonym group indices.
- * So sánh overlap giữa synGroups của input và corpus statement.
- * @param {number[]} inputGroups - Synonym group indices của input
- * @param {number[]} corpusGroups - Synonym group indices đã preprocessed
- * @returns {number} [0, 1]
- */
-function synsetSimilarityPreprocessed(inputGroups, corpusGroups) {
-    if (inputGroups.length === 0 && corpusGroups.length === 0) return 0;
-    if (inputGroups.length === 0 || corpusGroups.length === 0) return 0;
-
-    var setB = {};
-    for (var j = 0; j < corpusGroups.length; j++) setB[corpusGroups[j]] = true;
-
-    var overlap = 0;
-    for (var i = 0; i < inputGroups.length; i++) {
-        if (setB[inputGroups[i]]) overlap++;
-    }
-
-    var total = {};
-    for (var a = 0; a < inputGroups.length; a++) total[inputGroups[a]] = true;
-    for (var b = 0; b < corpusGroups.length; b++) total[corpusGroups[b]] = true;
-    var unionSize = Object.keys(total).length;
-
-    return unionSize === 0 ? 0 : overlap / unionSize;
-}
-
-// ---- Combined: textSimilarity (general purpose) ----
-
-function textSimilarity(a, b) {
-    var strA = String(a);
-    var strB = String(b);
-
-    if (strA === strB && strA.length > 0) return 1.0;
-    if (strA.length === 0 && strB.length === 0) return 0;
-
-    var maxLen = Math.max(strA.length, strB.length);
-    var levSim = maxLen > 0 ? 1 - (levenshteinDistance(strA, strB) / maxLen) : 0;
-    var jacSim = jaccardSimilarity(strA, strB);
-    var cosSim = cosineSimilarity(strA, strB);
-    var synSim = synsetSimilarity(strA, strB);
-
-    return Math.max(0, Math.min(1, (levSim + jacSim + cosSim + synSim) / 4));
-}
-
-// ---- Optimized: findBestMatchPreprocessed ----
-
-/**
- * Tìm câu trả lời phù hợp nhất từ preprocessed data.
- * Sử dụng TF-IDF cosine + synset preprocessed + Jaccard + Levenshtein.
- * Nhanh hơn textSimilarity() vì corpus đã được tiền xử lý.
- *
- * @param {string} input - Input người dùng (raw)
- * @param {string} lang - Ngôn ngữ hiện tại
- * @param {number} threshold - Ngưỡng similarity (mặc định 0.3)
- * @returns {{answer: string, score: number}|null} Kết quả hoặc null
- */
-function findBestMatchPreprocessed(input, lang, threshold) {
-    threshold = threshold || 0.3;
-    var ppLang = getPreprocessedLang(lang);
-    if (!ppLang) return null; // Fallback: caller sẽ dùng textSimilarity thường
-
-    var idf = ppLang.idf;
-    var statements = ppLang.statements;
-
-    // Tokenize input
-    var inputTokens = tokenizeForSimilarity(input, lang);
-    if (inputTokens.length === 0) return null;
-
-    // Build input TF
-    var inputTF = {};
-    for (var t = 0; t < inputTokens.length; t++) {
-        inputTF[inputTokens[t]] = (inputTF[inputTokens[t]] || 0) + 1;
-    }
-
-    // Build input TF-IDF
-    var inputTFIDF = {};
-    for (var word in inputTF) {
-        inputTFIDF[word] = inputTF[word] * (idf[word] || 1);
-    }
-    var inputMag = 0;
-    for (var w in inputTFIDF) inputMag += inputTFIDF[w] * inputTFIDF[w];
-    inputMag = Math.sqrt(inputMag);
-
-    // Build input synonym groups
-    var lookup = _getSynonymLookup();
-    var inputSynGroups = [];
-    var seenGroups = {};
-    for (var s = 0; s < inputTokens.length; s++) {
-        var groups = lookup[inputTokens[s]];
-        if (groups) {
-            for (var gi = 0; gi < groups.length; gi++) {
-                if (!seenGroups[groups[gi]]) {
-                    inputSynGroups.push(groups[gi]);
-                    seenGroups[groups[gi]] = true;
-                }
-            }
-        }
-    }
-
-    // Input normalized string (for Levenshtein/Jaccard)
-    var inputNorm = inputTokens.join(' ');
-
-    // Compare with all preprocessed statements
-    var bestScore = -1;
-    var bestAnswer = null;
-
-    for (var i = 0; i < statements.length; i++) {
-        var stmt = statements[i];
-        var stmtNorm = stmt.tokens.join(' ');
-
-        // 1. Levenshtein similarity
-        var maxLen = Math.max(inputNorm.length, stmtNorm.length);
-        var levSim = maxLen > 0 ? 1 - (levenshteinDistance(inputNorm, stmtNorm) / maxLen) : 0;
-
-        // 2. Jaccard (on tokens)
-        var jacSim = jaccardSimilarity(inputNorm, stmtNorm);
-
-        // 3. TF-IDF Cosine (preprocessed)
-        var cosSim = cosineSimilarityTFIDF(inputTFIDF, inputMag, stmt.tfidf, stmt.magnitude);
-
-        // 4. Synset (preprocessed)
-        var synSim = synsetSimilarityPreprocessed(inputSynGroups, stmt.synGroups);
-
-        var score = (levSim + jacSim + cosSim + synSim) / 4;
-
-        if (score > bestScore) {
-            bestScore = score;
-            bestAnswer = stmt.answer;
-        }
-    }
-
-    if (bestScore >= threshold) {
-        return { answer: bestAnswer, score: bestScore };
-    }
-    return null;
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.levenshteinDistance = levenshteinDistance;
-    globalThis.jaccardSimilarity = jaccardSimilarity;
-    globalThis.cosineSimilarity = cosineSimilarity;
-    globalThis.cosineSimilarityTFIDF = cosineSimilarityTFIDF;
-    globalThis.synsetSimilarity = synsetSimilarity;
-    globalThis.synsetSimilarityPreprocessed = synsetSimilarityPreprocessed;
-    globalThis.areSynonyms = areSynonyms;
-    globalThis.SYNONYM_GROUPS = SYNONYM_GROUPS;
-    globalThis.textSimilarity = textSimilarity;
-    globalThis.loadPreprocessedData = loadPreprocessedData;
-    globalThis.getPreprocessedLang = getPreprocessedLang;
-    globalThis.findBestMatchPreprocessed = findBestMatchPreprocessed;
-    globalThis.tokenizeForSimilarity = tokenizeForSimilarity;
-}
+// ============================================================
+// Text Similarity — Thuật toán so khớp chuỗi
+// Gồm 4 thuật toán: Levenshtein, Jaccard, Cosine, Synset
+// + Preprocessed data support (TF-IDF, pre-tokenized)
+// ============================================================
+
+// --- Preprocessed data cache ---
+// Loaded from data/preprocessed.json (build-time) hoặc localStorage (client)
+var _preprocessedData = null;
+var _PREPROCESSED_STORAGE_KEY = 'hikari_preprocessed';
+
+/**
+ * Load preprocessed data.
+ * - Browser: thử localStorage trước, nếu không có hoặc outdated thì fetch từ server
+ * - Node/test: load trực tiếp từ file
+ * @returns {Promise<void>}
+ */
+async function loadPreprocessedData() {
+    // Node/test environment
+    if (typeof module !== 'undefined' && module.exports) {
+        try {
+            var fs = require('fs');
+            var path = require('path');
+            var filePath = path.join(__dirname, '..', 'data', 'preprocessed.json');
+            _preprocessedData = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        } catch (e) {
+            _preprocessedData = null;
+        }
+        return;
+    }
+
+    // Browser: thử localStorage
+    try {
+        var cached = localStorage.getItem(_PREPROCESSED_STORAGE_KEY);
+        if (cached) {
+            var parsed = JSON.parse(cached);
+            // Fetch version từ server để check outdated
+            var resp = await fetch('data/preprocessed.json', { method: 'HEAD' });
+            // Dùng Last-Modified hoặc so sánh version
+            if (parsed && parsed.version) {
+                _preprocessedData = parsed;
+                // Background check: fetch full file và so sánh version
+                fetch('data/preprocessed.json').then(function(r) { return r.json(); }).then(function(fresh) {
+                    if (fresh.version !== parsed.version) {
+                        _preprocessedData = fresh;
+                        localStorage.setItem(_PREPROCESSED_STORAGE_KEY, JSON.stringify(fresh));
+                    }
+                }).catch(function() {});
+                return;
+            }
+        }
+    } catch (e) { /* localStorage not available */ }
+
+    // Browser: fetch từ server
+    try {
+        var response = await fetch('data/preprocessed.json');
+        if (response.ok) {
+            _preprocessedData = await response.json();
+            try {
+                localStorage.setItem(_PREPROCESSED_STORAGE_KEY, JSON.stringify(_preprocessedData));
+            } catch (e) { /* quota exceeded */ }
+        }
+    } catch (e) {
+        _preprocessedData = null;
+    }
+}
+
+/**
+ * Lấy preprocessed data cho ngôn ngữ hiện tại.
+ * @param {string} lang
+ * @returns {object|null} { idf, statements } hoặc null
+ */
+function getPreprocessedLang(lang) {
+    if (!_preprocessedData || !_preprocessedData.langs) return null;
+    return _preprocessedData.langs[lang] || null;
+}
+
+// ---- Tokenize (dùng cho input mới) ----
+
+/**
+ * Tokenize input text: lowercase, bỏ dấu (vi), bỏ punctuation, tách từ.
+ * Dùng cùng logic với scripts/preprocess.js để đảm bảo consistency.
+ * @param {string} text
+ * @param {string} lang
+ * @returns {string[]}
+ */
+function tokenizeForSimilarity(text, lang) {
+    var s = String(text).toLowerCase();
+    if (lang === 'vi' && typeof removeVietnameseDiacritics === 'function') {
+        s = removeVietnameseDiacritics(s);
+    }
+    s = s.replace(/[?!.,;:"""''`~()[\]{}\\|@#$%^&]/g, ' ');
+    return s.split(/\s+/).filter(function(w) { return w.length > 0; });
+}
+
+// ---- 1. Levenshtein Distance ----
+
+function levenshteinDistance(a, b) {
+    var strA = String(a);
+    var strB = String(b);
+    var lenA = strA.length;
+    var lenB = strB.length;
+
+    if (lenA === 0) return lenB;
+    if (lenB === 0) return lenA;
+
+    var prev = [];
+    var curr = [];
+    var i, j;
+
+    for (j = 0; j <= lenB; j++) prev[j] = j;
+
+    for (i = 1; i <= lenA; i++) {
+        curr[0] = i;
+        for (j = 1; j <= lenB; j++) {
+            if (strA[i - 1] === strB[j - 1]) {
+                curr[j] = prev[j - 1];
+            } else {
+                curr[j] = 1 + Math.min(prev[j - 1], prev[j], curr[j - 1]);
+            }
+        }
+        var tmp = prev;
+        prev = curr;
+        curr = tmp;
+    }
+    return prev[lenB];
+}
+
+// ---- 2. Jaccard Similarity ----
+
+function jaccardSimilarity(a, b) {
+    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+
+    if (wordsA.length === 0 && wordsB.length === 0) return 0;
+
+    var setA = {}, setB = {}, i;
+    for (i = 0; i < wordsA.length; i++) setA[wordsA[i]] = true;
+    for (i = 0; i < wordsB.length; i++) setB[wordsB[i]] = true;
+
+    var intersection = 0, union = {};
+    for (var k1 in setA) { union[k1] = true; if (setB[k1]) intersection++; }
+    for (var k2 in setB) { union[k2] = true; }
+
+    var unionSize = Object.keys(union).length;
+    return unionSize === 0 ? 0 : intersection / unionSize;
+}
+
+// ---- 3. Cosine Similarity ----
+
+function cosineSimilarity(a, b) {
+    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+
+    if (wordsA.length === 0 || wordsB.length === 0) return 0;
+
+    var tfA = {}, tfB = {}, i;
+    for (i = 0; i < wordsA.length; i++) tfA[wordsA[i]] = (tfA[wordsA[i]] || 0) + 1;
+    for (i = 0; i < wordsB.length; i++) tfB[wordsB[i]] = (tfB[wordsB[i]] || 0) + 1;
+
+    var vocab = {};
+    for (var ka in tfA) vocab[ka] = true;
+    for (var kb in tfB) vocab[kb] = true;
+
+    var dot = 0, magA = 0, magB = 0;
+    var keys = Object.keys(vocab);
+    for (i = 0; i < keys.length; i++) {
+        var va = tfA[keys[i]] || 0;
+        var vb = tfB[keys[i]] || 0;
+        dot += va * vb;
+        magA += va * va;
+        magB += vb * vb;
+    }
+
+    magA = Math.sqrt(magA);
+    magB = Math.sqrt(magB);
+    return (magA === 0 || magB === 0) ? 0 : dot / (magA * magB);
+}
+
+/**
+ * Cosine similarity sử dụng TF-IDF vectors (preprocessed).
+ * Input vector được tính on-the-fly, corpus vector đã preprocessed.
+ * @param {object} inputTFIDF - TF-IDF vector của input
+ * @param {number} inputMag - Magnitude của input vector
+ * @param {object} corpusTFIDF - TF-IDF vector đã preprocessed
+ * @param {number} corpusMag - Magnitude đã preprocessed
+ * @returns {number} [0, 1]
+ */
+function cosineSimilarityTFIDF(inputTFIDF, inputMag, corpusTFIDF, corpusMag) {
+    if (inputMag === 0 || corpusMag === 0) return 0;
+
+    var dot = 0;
+    // Iterate over smaller vector for efficiency
+    for (var word in inputTFIDF) {
+        if (corpusTFIDF[word]) {
+            dot += inputTFIDF[word] * corpusTFIDF[word];
+        }
+    }
+    return dot / (inputMag * corpusMag);
+}
+
+// ---- 4. Synset Similarity ----
+
+var SYNONYM_GROUPS = [
+    ['xin chao','chao','hi','hello','hey','yo'],
+    ['tam biet','bye','goodbye','hen gap lai','tot lanh'],
+    ['cam on','thanks','thank','thank you'],
+    ['ten','name','ai','who','la ai'],
+    ['lam gi','lam duoc','co the','giup','help','what can'],
+    ['may gio','gio','time','clock','bao gio'],
+    ['ngay','hom nay','date','today','ngay may'],
+    ['thu','thu may','day','what day'],
+    ['tinh','calculate','math','cong','tru','nhan','chia','plus','minus'],
+    ['doi','convert','sang','to','chuyen doi'],
+    ['chatbot','bot','ai','robot','may','machine'],
+    ['la gi','what is','what','gi','mean'],
+    ['khoe','vui','happy','fine','good','ok'],
+    ['tuoi','age','old','bao nhieu tuoi'],
+    ['o dau','where','dau','location'],
+    ['thich','like','love','yeu'],
+    ['huong dan','cach','how','guide','help','su dung','use']
+];
+
+var _synonymLookup = null;
+function _getSynonymLookup() {
+    if (_synonymLookup) return _synonymLookup;
+    _synonymLookup = {};
+    for (var g = 0; g < SYNONYM_GROUPS.length; g++) {
+        for (var w = 0; w < SYNONYM_GROUPS[g].length; w++) {
+            var word = SYNONYM_GROUPS[g][w].toLowerCase();
+            if (!_synonymLookup[word]) _synonymLookup[word] = [];
+            _synonymLookup[word].push(g);
+        }
+    }
+    return _synonymLookup;
+}
+
+function areSynonyms(wordA, wordB) {
+    if (wordA === wordB) return true;
+    var lookup = _getSynonymLookup();
+    var groupsA = lookup[wordA];
+    var groupsB = lookup[wordB];
+    if (!groupsA || !groupsB) return false;
+    for (var i = 0; i < groupsA.length; i++) {
+        for (var j = 0; j < groupsB.length; j++) {
+            if (groupsA[i] === groupsB[j]) return true;
+        }
+    }
+    return false;
+}
+
+function synsetSimilarity(a, b) {
+    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+
+    if (wordsA.length === 0 || wordsB.length === 0) return 0;
+
+    var matchAtoB = 0;
+    for (var i = 0; i < wordsA.length; i++) {
+        for (var j = 0; j < wordsB.length; j++) {
+            if (areSynonyms(wordsA[i], wordsB[j])) { matchAtoB++; break; }
+        }
+    }
+    var matchBtoA = 0;
+    for (var m = 0; m < wordsB.length; m++) {
+        for (var n = 0; n < wordsA.length; n++) {
+            if (areSynonyms(wordsB[m], wordsA[n])) { matchBtoA++; break; }
+        }
+    }
+
+    return ((matchAtoB / wordsA.length) + (matchBtoA / wordsB.length)) / 2;
+}
+
+/**
+ * Synset similarity sử dụng preprocessed synonym group indices.
+ * So sánh overlap giữa synGroups của input và corpus statement.
+ * @param {number[]} inputGroups - Synonym group indices của input
+ * @param {number[]} corpusGroups - Synonym group indices đã preprocessed
+ * @returns {number} [0, 1]
+ */
+function synsetSimilarityPreprocessed(inputGroups, corpusGroups) {
+    if (inputGroups.length === 0 && corpusGroups.length === 0) return 0;
+    if (inputGroups.length === 0 || corpusGroups.length === 0) return 0;
+
+    var setB = {};
+    for (var j = 0; j < corpusGroups.length; j++) setB[corpusGroups[j]] = true;
+
+    var overlap = 0;
+    for (var i = 0; i < inputGroups.length; i++) {
+        if (setB[inputGroups[i]]) overlap++;
+    }
+
+    var total = {};
+    for (var a = 0; a < inputGroups.length; a++) total[inputGroups[a]] = true;
+    for (var b = 0; b < corpusGroups.length; b++) total[corpusGroups[b]] = true;
+    var unionSize = Object.keys(total).length;
+
+    return unionSize === 0 ? 0 : overlap / unionSize;
+}
+
+// ---- Combined: textSimilarity (general purpose) ----
+
+function textSimilarity(a, b) {
+    var strA = String(a);
+    var strB = String(b);
+
+    if (strA === strB && strA.length > 0) return 1.0;
+    if (strA.length === 0 && strB.length === 0) return 0;
+
+    var maxLen = Math.max(strA.length, strB.length);
+    var levSim = maxLen > 0 ? 1 - (levenshteinDistance(strA, strB) / maxLen) : 0;
+    var jacSim = jaccardSimilarity(strA, strB);
+    var cosSim = cosineSimilarity(strA, strB);
+    var synSim = synsetSimilarity(strA, strB);
+
+    return Math.max(0, Math.min(1, (levSim + jacSim + cosSim + synSim) / 4));
+}
+
+// ---- Optimized: findBestMatchPreprocessed ----
+
+/**
+ * Tìm câu trả lời phù hợp nhất từ preprocessed data.
+ * Sử dụng TF-IDF cosine + synset preprocessed + Jaccard + Levenshtein.
+ * Nhanh hơn textSimilarity() vì corpus đã được tiền xử lý.
+ *
+ * @param {string} input - Input người dùng (raw)
+ * @param {string} lang - Ngôn ngữ hiện tại
+ * @param {number} threshold - Ngưỡng similarity (mặc định 0.3)
+ * @returns {{answer: string, score: number}|null} Kết quả hoặc null
+ */
+function findBestMatchPreprocessed(input, lang, threshold) {
+    threshold = threshold || 0.3;
+    var ppLang = getPreprocessedLang(lang);
+    if (!ppLang) return null; // Fallback: caller sẽ dùng textSimilarity thường
+
+    var idf = ppLang.idf;
+    var statements = ppLang.statements;
+
+    // Tokenize input
+    var inputTokens = tokenizeForSimilarity(input, lang);
+    if (inputTokens.length === 0) return null;
+
+    // Build input TF
+    var inputTF = {};
+    for (var t = 0; t < inputTokens.length; t++) {
+        inputTF[inputTokens[t]] = (inputTF[inputTokens[t]] || 0) + 1;
+    }
+
+    // Build input TF-IDF
+    var inputTFIDF = {};
+    for (var word in inputTF) {
+        inputTFIDF[word] = inputTF[word] * (idf[word] || 1);
+    }
+    var inputMag = 0;
+    for (var w in inputTFIDF) inputMag += inputTFIDF[w] * inputTFIDF[w];
+    inputMag = Math.sqrt(inputMag);
+
+    // Build input synonym groups
+    var lookup = _getSynonymLookup();
+    var inputSynGroups = [];
+    var seenGroups = {};
+    for (var s = 0; s < inputTokens.length; s++) {
+        var groups = lookup[inputTokens[s]];
+        if (groups) {
+            for (var gi = 0; gi < groups.length; gi++) {
+                if (!seenGroups[groups[gi]]) {
+                    inputSynGroups.push(groups[gi]);
+                    seenGroups[groups[gi]] = true;
+                }
+            }
+        }
+    }
+
+    // Input normalized string (for Levenshtein/Jaccard)
+    var inputNorm = inputTokens.join(' ');
+
+    // Compare with all preprocessed statements
+    var bestScore = -1;
+    var bestAnswer = null;
+
+    for (var i = 0; i < statements.length; i++) {
+        var stmt = statements[i];
+        var stmtNorm = stmt.tokens.join(' ');
+
+        // 1. Levenshtein similarity
+        var maxLen = Math.max(inputNorm.length, stmtNorm.length);
+        var levSim = maxLen > 0 ? 1 - (levenshteinDistance(inputNorm, stmtNorm) / maxLen) : 0;
+
+        // 2. Jaccard (on tokens)
+        var jacSim = jaccardSimilarity(inputNorm, stmtNorm);
+
+        // 3. TF-IDF Cosine (preprocessed)
+        var cosSim = cosineSimilarityTFIDF(inputTFIDF, inputMag, stmt.tfidf, stmt.magnitude);
+
+        // 4. Synset (preprocessed)
+        var synSim = synsetSimilarityPreprocessed(inputSynGroups, stmt.synGroups);
+
+        var score = (levSim + jacSim + cosSim + synSim) / 4;
+
+        if (score > bestScore) {
+            bestScore = score;
+            bestAnswer = stmt.answer;
+        }
+    }
+
+    if (bestScore >= threshold) {
+        return { answer: bestAnswer, score: bestScore };
+    }
+    return null;
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.levenshteinDistance = levenshteinDistance;
+    globalThis.jaccardSimilarity = jaccardSimilarity;
+    globalThis.cosineSimilarity = cosineSimilarity;
+    globalThis.cosineSimilarityTFIDF = cosineSimilarityTFIDF;
+    globalThis.synsetSimilarity = synsetSimilarity;
+    globalThis.synsetSimilarityPreprocessed = synsetSimilarityPreprocessed;
+    globalThis.areSynonyms = areSynonyms;
+    globalThis.SYNONYM_GROUPS = SYNONYM_GROUPS;
+    globalThis.textSimilarity = textSimilarity;
+    globalThis.loadPreprocessedData = loadPreprocessedData;
+    globalThis.getPreprocessedLang = getPreprocessedLang;
+    globalThis.findBestMatchPreprocessed = findBestMatchPreprocessed;
+    globalThis.tokenizeForSimilarity = tokenizeForSimilarity;
+}

adapters/time-adapter.js

@@ -1,89 +1,89 @@
-// ============================================================
-// Time Adapter — Trả lời câu hỏi thời gian/ngày tháng/thứ
-// Phụ thuộc: currentLang, _adapterPath
-// ============================================================
-
-var TIME_KEYWORDS = {
-    vi: { time: ['mấy giờ', 'giờ', 'thời gian'], date: ['ngày mấy', 'hôm nay', 'ngày tháng'], day: ['thứ mấy', 'thứ'] },
-    en: { time: ['what time', 'time', 'clock'], date: ['what date', 'today', 'date'], day: ['what day', 'day'] },
-    ja: { time: ['何時', '今何時', '時間'], date: ['今日', '何日', '日付'], day: ['何曜日', '曜日'] }
-};
-
-var DAY_NAMES = {
-    vi: ['Chủ Nhật', 'Thứ Hai', 'Thứ Ba', 'Thứ Tư', 'Thứ Năm', 'Thứ Sáu', 'Thứ Bảy'],
-    en: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
-    ja: ['日曜日', '月曜日', '火曜日', '水曜日', '木曜日', '金曜日', '土曜日']
-};
-
-var MONTH_NAMES_EN = [
-    'January', 'February', 'March', 'April', 'May', 'June',
-    'July', 'August', 'September', 'October', 'November', 'December'
-];
-
-function timeAdapter(rs, args) {
-    _adapterPath.push('time_adapter');
-    var input = (args || []).join(' ').trim().toLowerCase();
-    var lang = currentLang || 'vi';
-    var keywords = TIME_KEYWORDS[lang] || TIME_KEYWORDS['vi'];
-    var now = new Date();
-
-    for (var i = 0; i < keywords.time.length; i++) {
-        if (input.indexOf(keywords.time[i].toLowerCase()) !== -1) return formatTime(now, lang);
-    }
-    for (var j = 0; j < keywords.date.length; j++) {
-        if (input.indexOf(keywords.date[j].toLowerCase()) !== -1) return formatDate(now, lang);
-    }
-    for (var k = 0; k < keywords.day.length; k++) {
-        if (input.indexOf(keywords.day[k].toLowerCase()) !== -1) return formatDay(now, lang);
-    }
-
-    if (lang === 'en') return "I don't understand your time request.";
-    if (lang === 'ja') return '時間に関するリクエストが理解できませんでした。';
-    return 'Mình không hiểu yêu cầu về thời gian của bạn.';
-}
-
-function formatTime(date, lang) {
-    var hours = date.getHours();
-    var minutes = date.getMinutes();
-    var mm = minutes < 10 ? '0' + minutes : String(minutes);
-
-    if (lang === 'en') {
-        var period = hours >= 12 ? 'PM' : 'AM';
-        var h12 = hours % 12;
-        if (h12 === 0) h12 = 12;
-        return h12 + ':' + mm + ' ' + period;
-    } else if (lang === 'ja') {
-        return hours + '時' + mm + '分';
-    }
-    var hh = hours < 10 ? '0' + hours : String(hours);
-    return hh + ':' + mm;
-}
-
-function formatDate(date, lang) {
-    var day = date.getDate();
-    var month = date.getMonth();
-    var year = date.getFullYear();
-
-    if (lang === 'en') return MONTH_NAMES_EN[month] + ' ' + day + ', ' + year;
-    if (lang === 'ja') return year + '年' + (month + 1) + '月' + day + '日';
-    var dd = day < 10 ? '0' + day : String(day);
-    var mmStr = (month + 1) < 10 ? '0' + (month + 1) : String(month + 1);
-    return dd + '/' + mmStr + '/' + year;
-}
-
-function formatDay(date, lang) {
-    var dayIndex = date.getDay();
-    var names = DAY_NAMES[lang] || DAY_NAMES['vi'];
-    return names[dayIndex];
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.TIME_KEYWORDS = TIME_KEYWORDS;
-    globalThis.DAY_NAMES = DAY_NAMES;
-    globalThis.MONTH_NAMES_EN = MONTH_NAMES_EN;
-    globalThis.timeAdapter = timeAdapter;
-    globalThis.formatTime = formatTime;
-    globalThis.formatDate = formatDate;
-    globalThis.formatDay = formatDay;
-}
+// ============================================================
+// Time Adapter — Trả lời câu hỏi thời gian/ngày tháng/thứ
+// Phụ thuộc: currentLang, _adapterPath
+// ============================================================
+
+var TIME_KEYWORDS = {
+    vi: { time: ['mấy giờ', 'giờ', 'thời gian'], date: ['ngày mấy', 'hôm nay', 'ngày tháng'], day: ['thứ mấy', 'thứ'] },
+    en: { time: ['what time', 'time', 'clock'], date: ['what date', 'today', 'date'], day: ['what day', 'day'] },
+    ja: { time: ['何時', '今何時', '時間'], date: ['今日', '何日', '日付'], day: ['何曜日', '曜日'] }
+};
+
+var DAY_NAMES = {
+    vi: ['Chủ Nhật', 'Thứ Hai', 'Thứ Ba', 'Thứ Tư', 'Thứ Năm', 'Thứ Sáu', 'Thứ Bảy'],
+    en: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
+    ja: ['日曜日', '月曜日', '火曜日', '水曜日', '木曜日', '金曜日', '土曜日']
+};
+
+var MONTH_NAMES_EN = [
+    'January', 'February', 'March', 'April', 'May', 'June',
+    'July', 'August', 'September', 'October', 'November', 'December'
+];
+
+function timeAdapter(rs, args) {
+    _adapterPath.push('time_adapter');
+    var input = (args || []).join(' ').trim().toLowerCase();
+    var lang = currentLang || 'vi';
+    var keywords = TIME_KEYWORDS[lang] || TIME_KEYWORDS['vi'];
+    var now = new Date();
+
+    for (var i = 0; i < keywords.time.length; i++) {
+        if (input.indexOf(keywords.time[i].toLowerCase()) !== -1) return formatTime(now, lang);
+    }
+    for (var j = 0; j < keywords.date.length; j++) {
+        if (input.indexOf(keywords.date[j].toLowerCase()) !== -1) return formatDate(now, lang);
+    }
+    for (var k = 0; k < keywords.day.length; k++) {
+        if (input.indexOf(keywords.day[k].toLowerCase()) !== -1) return formatDay(now, lang);
+    }
+
+    if (lang === 'en') return "I don't understand your time request.";
+    if (lang === 'ja') return '時間に関するリクエストが理解できませんでした。';
+    return 'Mình không hiểu yêu cầu về thời gian của bạn.';
+}
+
+function formatTime(date, lang) {
+    var hours = date.getHours();
+    var minutes = date.getMinutes();
+    var mm = minutes < 10 ? '0' + minutes : String(minutes);
+
+    if (lang === 'en') {
+        var period = hours >= 12 ? 'PM' : 'AM';
+        var h12 = hours % 12;
+        if (h12 === 0) h12 = 12;
+        return h12 + ':' + mm + ' ' + period;
+    } else if (lang === 'ja') {
+        return hours + '時' + mm + '分';
+    }
+    var hh = hours < 10 ? '0' + hours : String(hours);
+    return hh + ':' + mm;
+}
+
+function formatDate(date, lang) {
+    var day = date.getDate();
+    var month = date.getMonth();
+    var year = date.getFullYear();
+
+    if (lang === 'en') return MONTH_NAMES_EN[month] + ' ' + day + ', ' + year;
+    if (lang === 'ja') return year + '年' + (month + 1) + '月' + day + '日';
+    var dd = day < 10 ? '0' + day : String(day);
+    var mmStr = (month + 1) < 10 ? '0' + (month + 1) : String(month + 1);
+    return dd + '/' + mmStr + '/' + year;
+}
+
+function formatDay(date, lang) {
+    var dayIndex = date.getDay();
+    var names = DAY_NAMES[lang] || DAY_NAMES['vi'];
+    return names[dayIndex];
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.TIME_KEYWORDS = TIME_KEYWORDS;
+    globalThis.DAY_NAMES = DAY_NAMES;
+    globalThis.MONTH_NAMES_EN = MONTH_NAMES_EN;
+    globalThis.timeAdapter = timeAdapter;
+    globalThis.formatTime = formatTime;
+    globalThis.formatDate = formatDate;
+    globalThis.formatDay = formatDay;
+}

adapters/unit-conversion.js

@@ -1,145 +1,145 @@
-// ============================================================
-// Unit Conversion Adapter — Chuyển đổi đơn vị đo lường
-// Phụ thuộc: currentLang, _adapterPath
-// ============================================================
-
-var CONVERSION_FACTORS = {
-    length: { m: 1, km: 1000, cm: 0.01, mm: 0.001, mile: 1609.344, yard: 0.9144, foot: 0.3048, inch: 0.0254 },
-    mass: { kg: 1, g: 0.001, mg: 0.000001, pound: 0.453592, ounce: 0.0283495 }
-};
-
-var TEMPERATURE_UNITS = {
-    celsius: 'celsius', c: 'celsius',
-    fahrenheit: 'fahrenheit', f: 'fahrenheit',
-    kelvin: 'kelvin', k: 'kelvin'
-};
-
-function convertTemperature(value, from, to) {
-    if (from === to) return value;
-    var celsius;
-    if (from === 'celsius') celsius = value;
-    else if (from === 'fahrenheit') celsius = (value - 32) * 5 / 9;
-    else celsius = value - 273.15;
-
-    if (to === 'celsius') return celsius;
-    if (to === 'fahrenheit') return (celsius * 9 / 5) + 32;
-    return celsius + 273.15;
-}
-
-function convertUnit(value, fromUnit, toUnit) {
-    var from = String(fromUnit).toLowerCase().trim();
-    var to = String(toUnit).toLowerCase().trim();
-    if (from === to) return value;
-
-    var fromTemp = TEMPERATURE_UNITS[from];
-    var toTemp = TEMPERATURE_UNITS[to];
-    if (fromTemp && toTemp) return convertTemperature(value, fromTemp, toTemp);
-    if (fromTemp || toTemp) return null;
-
-    var categories = Object.keys(CONVERSION_FACTORS);
-    for (var i = 0; i < categories.length; i++) {
-        var factors = CONVERSION_FACTORS[categories[i]];
-        if (factors[from] !== undefined && factors[to] !== undefined) {
-            return value * (factors[from] / factors[to]);
-        }
-    }
-    return null;
-}
-
-function parseConversionRequest(input, lang) {
-    if (typeof input !== 'string' || input.trim().length === 0) return null;
-    var text = input.trim();
-
-    var separators;
-    if (lang === 'ja') separators = ['に変換', 'は何', 'を'];
-    else if (lang === 'en') separators = ['convert', ' to ', ' in '];
-    else separators = [' sang ', ' ra '];
-
-    for (var i = 0; i < separators.length; i++) {
-        var sep = separators[i];
-        var idx = text.toLowerCase().indexOf(sep.toLowerCase());
-        if (idx === -1) continue;
-
-        var leftPart = text.substring(0, idx).trim();
-        var rightPart = text.substring(idx + sep.length).trim();
-        if (leftPart.length === 0 || rightPart.length === 0) continue;
-
-        var leftMatch = leftPart.match(/(-?\d+(?:\.\d+)?)\s*(.+)/);
-        if (!leftMatch) continue;
-
-        var value = parseFloat(leftMatch[1]);
-        var fromUnit = leftMatch[2].trim().toLowerCase();
-        var toUnit = rightPart.trim().toLowerCase();
-        if (isNaN(value)) continue;
-
-        return { value: value, from: fromUnit, to: toUnit };
-    }
-    return null;
-}
-
-function getSupportedUnits() {
-    var units = [];
-    var categories = Object.keys(CONVERSION_FACTORS);
-    for (var i = 0; i < categories.length; i++) {
-        units = units.concat(Object.keys(CONVERSION_FACTORS[categories[i]]));
-    }
-    units = units.concat(['celsius', 'fahrenheit', 'kelvin', 'c', 'f', 'k']);
-    return units.join(', ');
-}
-
-function unitConversionAdapter(rs, args) {
-    _adapterPath.push('unit_conversion');
-    var input = (args || []).join(' ').trim();
-    var lang = currentLang || 'vi';
-
-    if (input.length === 0) {
-        if (lang === 'en') return 'Please provide a conversion request (e.g., "5 km to m").';
-        if (lang === 'ja') return '変換リクエストを入力してください（例: 「5 km を m」）。';
-        return 'Vui lòng nhập yêu cầu chuyển đổi (ví dụ: "5 km sang m").';
-    }
-
-    var parsed = parseConversionRequest(input, lang);
-    if (!parsed) {
-        if (lang === 'en') return 'Invalid syntax. Example: "5 km to m", "100 fahrenheit to celsius".';
-        if (lang === 'ja') return '構文が無効です。例: 「5 km を m」、「100 fahrenheit を celsius」。';
-        return 'Cú pháp không hợp lệ. Ví dụ: "5 km sang m", "100 fahrenheit sang celsius".';
-    }
-
-    var allUnits = {};
-    var categories = Object.keys(CONVERSION_FACTORS);
-    for (var i = 0; i < categories.length; i++) {
-        var catUnits = Object.keys(CONVERSION_FACTORS[categories[i]]);
-        for (var j = 0; j < catUnits.length; j++) allUnits[catUnits[j]] = true;
-    }
-    var tempKeys = Object.keys(TEMPERATURE_UNITS);
-    for (var t = 0; t < tempKeys.length; t++) allUnits[tempKeys[t]] = true;
-
-    if (!allUnits[parsed.from.toLowerCase()] || !allUnits[parsed.to.toLowerCase()]) {
-        var supported = getSupportedUnits();
-        if (lang === 'en') return 'Unsupported unit. Supported units: ' + supported;
-        if (lang === 'ja') return 'サポートされていない単位です。対応単位: ' + supported;
-        return 'Đơn vị kh��ng được hỗ trợ. Các đơn vị hỗ trợ: ' + supported;
-    }
-
-    var result = convertUnit(parsed.value, parsed.from.toLowerCase(), parsed.to.toLowerCase());
-    if (result === null) {
-        var supported2 = getSupportedUnits();
-        if (lang === 'en') return 'Cannot convert between incompatible units. Supported units: ' + supported2;
-        if (lang === 'ja') return '互換性のない単位間の変換はできません。対応単位: ' + supported2;
-        return 'Không thể chuyển đổi giữa các đơn vị không tương thích. Các đơn vị hỗ trợ: ' + supported2;
-    }
-
-    var resultStr = Number.isInteger(result) ? String(result) : result.toFixed(4).replace(/\.?0+$/, '');
-    return parsed.value + ' ' + parsed.from + ' = ' + resultStr + ' ' + parsed.to;
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.CONVERSION_FACTORS = CONVERSION_FACTORS;
-    globalThis.TEMPERATURE_UNITS = TEMPERATURE_UNITS;
-    globalThis.convertTemperature = convertTemperature;
-    globalThis.convertUnit = convertUnit;
-    globalThis.parseConversionRequest = parseConversionRequest;
-    globalThis.getSupportedUnits = getSupportedUnits;
-    globalThis.unitConversionAdapter = unitConversionAdapter;
-}
+// ============================================================
+// Unit Conversion Adapter — Chuyển đổi đơn vị đo lường
+// Phụ thuộc: currentLang, _adapterPath
+// ============================================================
+
+var CONVERSION_FACTORS = {
+    length: { m: 1, km: 1000, cm: 0.01, mm: 0.001, mile: 1609.344, yard: 0.9144, foot: 0.3048, inch: 0.0254 },
+    mass: { kg: 1, g: 0.001, mg: 0.000001, pound: 0.453592, ounce: 0.0283495 }
+};
+
+var TEMPERATURE_UNITS = {
+    celsius: 'celsius', c: 'celsius',
+    fahrenheit: 'fahrenheit', f: 'fahrenheit',
+    kelvin: 'kelvin', k: 'kelvin'
+};
+
+function convertTemperature(value, from, to) {
+    if (from === to) return value;
+    var celsius;
+    if (from === 'celsius') celsius = value;
+    else if (from === 'fahrenheit') celsius = (value - 32) * 5 / 9;
+    else celsius = value - 273.15;
+
+    if (to === 'celsius') return celsius;
+    if (to === 'fahrenheit') return (celsius * 9 / 5) + 32;
+    return celsius + 273.15;
+}
+
+function convertUnit(value, fromUnit, toUnit) {
+    var from = String(fromUnit).toLowerCase().trim();
+    var to = String(toUnit).toLowerCase().trim();
+    if (from === to) return value;
+
+    var fromTemp = TEMPERATURE_UNITS[from];
+    var toTemp = TEMPERATURE_UNITS[to];
+    if (fromTemp && toTemp) return convertTemperature(value, fromTemp, toTemp);
+    if (fromTemp || toTemp) return null;
+
+    var categories = Object.keys(CONVERSION_FACTORS);
+    for (var i = 0; i < categories.length; i++) {
+        var factors = CONVERSION_FACTORS[categories[i]];
+        if (factors[from] !== undefined && factors[to] !== undefined) {
+            return value * (factors[from] / factors[to]);
+        }
+    }
+    return null;
+}
+
+function parseConversionRequest(input, lang) {
+    if (typeof input !== 'string' || input.trim().length === 0) return null;
+    var text = input.trim();
+
+    var separators;
+    if (lang === 'ja') separators = ['に変換', 'は何', 'を'];
+    else if (lang === 'en') separators = ['convert', ' to ', ' in '];
+    else separators = [' sang ', ' ra '];
+
+    for (var i = 0; i < separators.length; i++) {
+        var sep = separators[i];
+        var idx = text.toLowerCase().indexOf(sep.toLowerCase());
+        if (idx === -1) continue;
+
+        var leftPart = text.substring(0, idx).trim();
+        var rightPart = text.substring(idx + sep.length).trim();
+        if (leftPart.length === 0 || rightPart.length === 0) continue;
+
+        var leftMatch = leftPart.match(/(-?\d+(?:\.\d+)?)\s*(.+)/);
+        if (!leftMatch) continue;
+
+        var value = parseFloat(leftMatch[1]);
+        var fromUnit = leftMatch[2].trim().toLowerCase();
+        var toUnit = rightPart.trim().toLowerCase();
+        if (isNaN(value)) continue;
+
+        return { value: value, from: fromUnit, to: toUnit };
+    }
+    return null;
+}
+
+function getSupportedUnits() {
+    var units = [];
+    var categories = Object.keys(CONVERSION_FACTORS);
+    for (var i = 0; i < categories.length; i++) {
+        units = units.concat(Object.keys(CONVERSION_FACTORS[categories[i]]));
+    }
+    units = units.concat(['celsius', 'fahrenheit', 'kelvin', 'c', 'f', 'k']);
+    return units.join(', ');
+}
+
+function unitConversionAdapter(rs, args) {
+    _adapterPath.push('unit_conversion');
+    var input = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+
+    if (input.length === 0) {
+        if (lang === 'en') return 'Please provide a conversion request (e.g., "5 km to m").';
+        if (lang === 'ja') return '変換リクエストを入力してください（例: 「5 km を m」）。';
+        return 'Vui lòng nhập yêu cầu chuyển đổi (ví dụ: "5 km sang m").';
+    }
+
+    var parsed = parseConversionRequest(input, lang);
+    if (!parsed) {
+        if (lang === 'en') return 'Invalid syntax. Example: "5 km to m", "100 fahrenheit to celsius".';
+        if (lang === 'ja') return '構文が無効です。例: 「5 km を m」、「100 fahrenheit を celsius」。';
+        return 'Cú pháp không hợp lệ. Ví dụ: "5 km sang m", "100 fahrenheit sang celsius".';
+    }
+
+    var allUnits = {};
+    var categories = Object.keys(CONVERSION_FACTORS);
+    for (var i = 0; i < categories.length; i++) {
+        var catUnits = Object.keys(CONVERSION_FACTORS[categories[i]]);
+        for (var j = 0; j < catUnits.length; j++) allUnits[catUnits[j]] = true;
+    }
+    var tempKeys = Object.keys(TEMPERATURE_UNITS);
+    for (var t = 0; t < tempKeys.length; t++) allUnits[tempKeys[t]] = true;
+
+    if (!allUnits[parsed.from.toLowerCase()] || !allUnits[parsed.to.toLowerCase()]) {
+        var supported = getSupportedUnits();
+        if (lang === 'en') return 'Unsupported unit. Supported units: ' + supported;
+        if (lang === 'ja') return 'サポートされていない単位です。対応単位: ' + supported;
+        return 'Đơn vị không được hỗ trợ. Các đơn vị hỗ trợ: ' + supported;
+    }
+
+    var result = convertUnit(parsed.value, parsed.from.toLowerCase(), parsed.to.toLowerCase());
+    if (result === null) {
+        var supported2 = getSupportedUnits();
+        if (lang === 'en') return 'Cannot convert between incompatible units. Supported units: ' + supported2;
+        if (lang === 'ja') return '互換性のない単位間の変換はできません。対応単位: ' + supported2;
+        return 'Không thể chuyển đổi giữa các đơn vị không tương thích. Các đơn vị hỗ trợ: ' + supported2;
+    }
+
+    var resultStr = Number.isInteger(result) ? String(result) : result.toFixed(4).replace(/\.?0+$/, '');
+    return parsed.value + ' ' + parsed.from + ' = ' + resultStr + ' ' + parsed.to;
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.CONVERSION_FACTORS = CONVERSION_FACTORS;
+    globalThis.TEMPERATURE_UNITS = TEMPERATURE_UNITS;
+    globalThis.convertTemperature = convertTemperature;
+    globalThis.convertUnit = convertUnit;
+    globalThis.parseConversionRequest = parseConversionRequest;
+    globalThis.getSupportedUnits = getSupportedUnits;
+    globalThis.unitConversionAdapter = unitConversionAdapter;
+}

adapters/voice-adapter.js

@@ -0,0 +1,224 @@
+// ============================================================
+// Voice Adapter — STT (SpeechRecognition) + TTS (SpeechSynthesis)
+// Sử dụng Web Speech API native của trình duyệt, không cần server.
+// ============================================================
+
+/**
+ * Ánh xạ ngôn ngữ app → locale Web Speech API.
+ */
+var SPEECH_LOCALE_MAP = {
+    vi: 'vi-VN',
+    en: 'en-US',
+    ja: 'ja-JP'
+};
+
+// === Trạng thái nội bộ ===
+var _recognition = null;       // SpeechRecognition instance hiện tại
+var _isListening = false;      // Đang lắng nghe STT
+var _sttSupported = false;     // Browser hỗ trợ STT
+var _ttsSupported = false;     // Browser hỗ trợ TTS
+
+/**
+ * Khởi tạo Voice Adapter — kiểm tra browser support.
+ * Gọi một lần khi app khởi động.
+ * @returns {{ sttSupported: boolean, ttsSupported: boolean }}
+ */
+function initVoiceAdapter() {
+    _sttSupported = !!(
+        typeof window !== 'undefined' &&
+        (window.SpeechRecognition || window.webkitSpeechRecognition)
+    );
+    _ttsSupported = !!(
+        typeof window !== 'undefined' &&
+        window.speechSynthesis
+    );
+    return { sttSupported: _sttSupported, ttsSupported: _ttsSupported };
+}
+
+// ============================================================
+// TTS — Text to Speech
+// ============================================================
+
+/**
+ * Lấy danh sách voices phù hợp với ngôn ngữ, ưu tiên localService.
+ * @param {string} lang - 'vi' | 'en' | 'ja'
+ * @returns {SpeechSynthesisVoice[]}
+ */
+function getVoicesForLang(lang) {
+    if (!_ttsSupported) return [];
+    var locale = SPEECH_LOCALE_MAP[lang] || lang;
+    var prefix = locale.split('-')[0].toLowerCase(); // 'vi', 'en', 'ja'
+    var all = window.speechSynthesis.getVoices();
+    var filtered = all.filter(function (v) {
+        var vLang = (v.lang || '').toLowerCase();
+        return vLang === locale.toLowerCase() || vLang.startsWith(prefix + '-') || vLang.startsWith(prefix + '_');
+    });
+    // Ưu tiên localService (giọng tự nhiên cài sẵn)
+    filtered.sort(function (a, b) {
+        if (a.localService && !b.localService) return -1;
+        if (!a.localService && b.localService) return 1;
+        return 0;
+    });
+    return filtered;
+}
+
+/**
+ * Lấy voice mặc định tốt nhất cho ngôn ngữ.
+ * Ưu tiên localService, rồi lấy voice đầu tiên trong danh sách.
+ * @param {string} lang
+ * @returns {SpeechSynthesisVoice|null}
+ */
+function getDefaultVoice(lang) {
+    var voices = getVoicesForLang(lang);
+    return voices.length > 0 ? voices[0] : null;
+}
+
+/**
+ * Đọc text bằng TTS.
+ * @param {string} text - Nội dung cần đọc
+ * @param {string} lang - Ngôn ngữ ('vi' | 'en' | 'ja')
+ * @param {string} [voiceName] - Tên voice cụ thể (tùy chọn)
+ */
+function speakText(text, lang, voiceName) {
+    if (!_ttsSupported || !text || !text.trim()) return;
+
+    // Dừng bất kỳ TTS đang phát
+    window.speechSynthesis.cancel();
+
+    var utterance = new SpeechSynthesisUtterance(text);
+    utterance.lang = SPEECH_LOCALE_MAP[lang] || lang;
+
+    // Chọn voice theo tên hoặc dùng default
+    var voices = getVoicesForLang(lang);
+    var selectedVoice = null;
+    if (voiceName) {
+        selectedVoice = voices.find(function (v) { return v.name === voiceName; }) || null;
+    }
+    if (!selectedVoice) {
+        selectedVoice = getDefaultVoice(lang);
+    }
+    if (selectedVoice) {
+        utterance.voice = selectedVoice;
+    }
+
+    window.speechSynthesis.speak(utterance);
+}
+
+/**
+ * Dừng TTS ngay lập tức.
+ */
+function stopSpeaking() {
+    if (_ttsSupported) {
+        window.speechSynthesis.cancel();
+    }
+}
+
+/**
+ * Kiểm tra TTS đang phát.
+ * @returns {boolean}
+ */
+function isSpeaking() {
+    return _ttsSupported && window.speechSynthesis.speaking;
+}
+
+// ============================================================
+// STT — Speech to Text
+// ============================================================
+
+/**
+ * Bắt đầu nhận diện giọng nói.
+ * @param {string} lang - Ngôn ngữ ('vi' | 'en' | 'ja')
+ * @param {function} onInterim - Callback(text) khi có kết quả tạm thời
+ * @param {function} onFinal - Callback(text) khi có kết quả cuối cùng
+ * @param {function} [onError] - Callback(error) khi có lỗi
+ */
+function startVoiceInput(lang, onInterim, onFinal, onError) {
+    if (!_sttSupported) {
+        if (onError) onError(new Error('SpeechRecognition not supported'));
+        return;
+    }
+    if (_isListening) {
+        stopVoiceInput();
+    }
+
+    var SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
+    _recognition = new SpeechRecognition();
+    _recognition.lang = SPEECH_LOCALE_MAP[lang] || lang;
+    _recognition.continuous = false;       // Nhận diện 1 câu rồi dừng
+    _recognition.interimResults = true;    // Hiển thị kết quả tạm thời
+
+    _recognition.onstart = function () {
+        _isListening = true;
+    };
+
+    _recognition.onresult = function (event) {
+        var interim = '';
+        var final = '';
+        for (var i = event.resultIndex; i < event.results.length; i++) {
+            var transcript = event.results[i][0].transcript;
+            if (event.results[i].isFinal) {
+                final += transcript;
+            } else {
+                interim += transcript;
+            }
+        }
+        if (interim && onInterim) onInterim(interim);
+        if (final && onFinal) onFinal(final.trim());
+    };
+
+    _recognition.onerror = function (event) {
+        _isListening = false;
+        if (onError) onError(event.error);
+    };
+
+    _recognition.onend = function () {
+        _isListening = false;
+    };
+
+    _recognition.start();
+}
+
+/**
+ * Dừng nhận diện giọng nói.
+ */
+function stopVoiceInput() {
+    if (_recognition) {
+        try { _recognition.stop(); } catch (e) {}
+        _recognition = null;
+    }
+    _isListening = false;
+}
+
+/**
+ * Kiểm tra STT đang chạy.
+ * @returns {boolean}
+ */
+function isVoiceInputActive() {
+    return _isListening;
+}
+
+// ============================================================
+// Alias private — dùng bởi app.js để tránh đệ quy với wrapper cùng tên
+// ============================================================
+if (typeof window !== 'undefined') {
+    window._voiceAdapterStartVoiceInput = startVoiceInput;
+    window._voiceAdapterStopVoiceInput = stopVoiceInput;
+}
+
+// ============================================================
+// Export cho Node/test (stub functions)
+// ============================================================
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.SPEECH_LOCALE_MAP = SPEECH_LOCALE_MAP;
+    globalThis.initVoiceAdapter = function () { return { sttSupported: false, ttsSupported: false }; };
+    globalThis.getVoicesForLang = function () { return []; };
+    globalThis.getDefaultVoice = function () { return null; };
+    globalThis.speakText = function () {};
+    globalThis.stopSpeaking = function () {};
+    globalThis.isSpeaking = function () { return false; };
+    globalThis.startVoiceInput = function (lang, onInterim, onFinal, onError) {
+        if (onError) onError(new Error('Not supported in Node'));
+    };
+    globalThis.stopVoiceInput = function () {};
+    globalThis.isVoiceInputActive = function () { return false; };
+}

adapters/web-search.js

@@ -1,207 +1,207 @@
-// ============================================================
-// Web Search Adapter — Tìm kiếm web và trả kết quả
-// Phụ thuộc: currentLang, _adapterPath
-//
-// Chiến lược (không cần API key, không cần CORS proxy):
-// 1. DuckDuckGo Instant Answer API (có CORS headers, trả tóm tắt Wikipedia)
-// 2. Fallback → link tìm kiếm clickable (Google + DuckDuckGo + Bing)
-//
-// Tùy chọn: Google Custom Search API (cần GOOGLE_API_KEY + GOOGLE_CX)
-// ============================================================
-
-var GOOGLE_API_KEY = '';
-var GOOGLE_CX = '';
-var WEB_SEARCH_TIMEOUT = 5000;
-
-// ---- DuckDuckGo Instant Answer API ----
-
-async function duckDuckGoSearch(query) {
-    // DDG API hỗ trợ CORS — gọi trực tiếp từ browser
-    var url = 'https://api.duckduckgo.com/?q=' + encodeURIComponent(query)
-        + '&format=json&no_html=1&skip_disambig=1';
-
-    var controller = new AbortController();
-    var timeoutId = setTimeout(function () { controller.abort(); }, WEB_SEARCH_TIMEOUT);
-
-    try {
-        var response = await fetch(url, { signal: controller.signal });
-        if (!response.ok) return null;
-        var data = await response.json();
-
-        var results = {
-            abstract: data.Abstract || '',
-            abstractSource: data.AbstractSource || '',
-            abstractURL: data.AbstractURL || '',
-            answer: data.Answer || '',
-            definition: data.Definition || '',
-            definitionSource: data.DefinitionSource || '',
-            definitionURL: data.DefinitionURL || '',
-            related: []
-        };
-
-        if (data.RelatedTopics) {
-            for (var i = 0; i < Math.min(data.RelatedTopics.length, 5); i++) {
-                var topic = data.RelatedTopics[i];
-                if (topic && topic.Text) {
-                    results.related.push({ text: topic.Text, url: topic.FirstURL || '' });
-                }
-            }
-        }
-
-        if (!results.abstract && !results.answer && !results.definition && results.related.length === 0) {
-            return null;
-        }
-        return results;
-    } catch (err) {
-        return null;
-    } finally {
-        clearTimeout(timeoutId);
-    }
-}
-
-// ---- Google Custom Search API (cần key) ----
-
-async function googleSearch(query, numResults) {
-    if (!GOOGLE_API_KEY || !GOOGLE_CX) return null;
-    numResults = numResults || 3;
-    var url = 'https://www.googleapis.com/customsearch/v1'
-        + '?key=' + encodeURIComponent(GOOGLE_API_KEY)
-        + '&cx=' + encodeURIComponent(GOOGLE_CX)
-        + '&q=' + encodeURIComponent(query)
-        + '&num=' + numResults;
-
-    var controller = new AbortController();
-    var timeoutId = setTimeout(function () { controller.abort(); }, WEB_SEARCH_TIMEOUT);
-
-    try {
-        var response = await fetch(url, { signal: controller.signal });
-        if (!response.ok) return null;
-        var data = await response.json();
-        if (!data.items || data.items.length === 0) return null;
-        return data.items.map(function (item) {
-            return { title: item.title || '', link: item.link || '', snippet: item.snippet || '' };
-        });
-    } catch (err) {
-        return null;
-    } finally {
-        clearTimeout(timeoutId);
-    }
-}
-
-// ---- Format ----
-
-function formatDDGResults(results, query, lang) {
-    var lines = [];
-    if (lang === 'en') lines.push('🔍 Search results for "' + query + '":');
-    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索結果:');
-    else lines.push('🔍 Kết quả tìm kiếm "' + query + '":');
-
-    if (results.answer) lines.push('💡 ' + results.answer);
-
-    if (results.abstract) {
-        lines.push('\n' + results.abstract);
-        if (results.abstractSource && results.abstractURL) {
-            lines.push('📖 Nguồn: ' + results.abstractSource + ' — ' + results.abstractURL);
-        }
-    }
-
-    if (results.definition) {
-        lines.push('📝 ' + results.definition);
-        if (results.definitionSource) lines.push('   — ' + results.definitionSource);
-    }
-
-    if (results.related.length > 0) {
-        lines.push('');
-        if (lang === 'en') lines.push('Related:');
-        else if (lang === 'ja') lines.push('関連:');
-        else lines.push('Liên quan:');
-        for (var i = 0; i < results.related.length; i++) {
-            var r = results.related[i];
-            lines.push('• ' + r.text);
-            if (r.url) lines.push('  🔗 ' + r.url);
-        }
-    }
-
-    // Luôn thêm link tìm kiếm đầy đủ
-    lines.push('');
-    lines.push(_searchLinksOnly(query));
-
-    return lines.join('\n');
-}
-
-function formatGoogleResults(results, query, lang) {
-    var lines = [];
-    if (lang === 'en') lines.push('🔍 Search results for "' + query + '":');
-    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索結果:');
-    else lines.push('🔍 Kết quả tìm kiếm "' + query + '":');
-
-    for (var i = 0; i < results.length; i++) {
-        lines.push((i + 1) + '. ' + results[i].title);
-        if (results[i].snippet) lines.push('   ' + results[i].snippet);
-        if (results[i].link) lines.push('   🔗 ' + results[i].link);
-    }
-    return lines.join('\n');
-}
-
-function formatSearchLinks(query, lang) {
-    var lines = [];
-    if (lang === 'en') lines.push('🔍 Here are search links for "' + query + '":');
-    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索リンク:');
-    else lines.push('🔍 Link tìm kiếm "' + query + '":');
-
-    lines.push(_searchLinksOnly(query));
-    return lines.join('\n');
-}
-
-function _searchLinksOnly(query) {
-    var encoded = encodeURIComponent(query);
-    return '🌐 Google: https://www.google.com/search?q=' + encoded
-        + '\n🦆 DuckDuckGo: https://duckduckgo.com/?q=' + encoded
-        + '\n🔵 Bing: https://www.bing.com/search?q=' + encoded;
-}
-
-// ---- Web Search Adapter ----
-
-function webSearchAdapter(rs, args) {
-    _adapterPath.push('web_search');
-    var query = (args || []).join(' ').trim();
-    var lang = currentLang || 'vi';
-
-    if (query.length === 0) {
-        if (lang === 'en') return Promise.resolve('Please provide a search query.');
-        if (lang === 'ja') return Promise.resolve('検索キーワードを入力してください。');
-        return Promise.resolve('Vui lòng nhập từ khóa tìm kiếm.');
-    }
-
-    // Ưu tiên Google nếu có key
-    if (GOOGLE_API_KEY && GOOGLE_CX) {
-        return googleSearch(query).then(function (results) {
-            if (results) return formatGoogleResults(results, query, lang);
-            return _ddgFallback(query, lang);
-        }).catch(function () {
-            return _ddgFallback(query, lang);
-        });
-    }
-
-    return _ddgFallback(query, lang);
-}
-
-function _ddgFallback(query, lang) {
-    return duckDuckGoSearch(query).then(function (results) {
-        if (results) return formatDDGResults(results, query, lang);
-        // DDG không có instant answer → trả link tìm kiếm
-        return formatSearchLinks(query, lang);
-    }).catch(function () {
-        return formatSearchLinks(query, lang);
-    });
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.GOOGLE_API_KEY = GOOGLE_API_KEY;
-    globalThis.GOOGLE_CX = GOOGLE_CX;
-    globalThis.duckDuckGoSearch = duckDuckGoSearch;
-    globalThis.googleSearch = googleSearch;
-    globalThis.webSearchAdapter = webSearchAdapter;
-    globalThis.formatSearchLinks = formatSearchLinks;
-}
+// ============================================================
+// Web Search Adapter — Tìm kiếm web và trả kết quả
+// Phụ thuộc: currentLang, _adapterPath
+//
+// Chiến lược (không cần API key, không cần CORS proxy):
+// 1. DuckDuckGo Instant Answer API (có CORS headers, trả tóm tắt Wikipedia)
+// 2. Fallback → link tìm kiếm clickable (Google + DuckDuckGo + Bing)
+//
+// Tùy chọn: Google Custom Search API (cần GOOGLE_API_KEY + GOOGLE_CX)
+// ============================================================
+
+var GOOGLE_API_KEY = '';
+var GOOGLE_CX = '';
+var WEB_SEARCH_TIMEOUT = 5000;
+
+// ---- DuckDuckGo Instant Answer API ----
+
+async function duckDuckGoSearch(query) {
+    // DDG API hỗ trợ CORS — gọi trực tiếp từ browser
+    var url = 'https://api.duckduckgo.com/?q=' + encodeURIComponent(query)
+        + '&format=json&no_html=1&skip_disambig=1';
+
+    var controller = new AbortController();
+    var timeoutId = setTimeout(function () { controller.abort(); }, WEB_SEARCH_TIMEOUT);
+
+    try {
+        var response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) return null;
+        var data = await response.json();
+
+        var results = {
+            abstract: data.Abstract || '',
+            abstractSource: data.AbstractSource || '',
+            abstractURL: data.AbstractURL || '',
+            answer: data.Answer || '',
+            definition: data.Definition || '',
+            definitionSource: data.DefinitionSource || '',
+            definitionURL: data.DefinitionURL || '',
+            related: []
+        };
+
+        if (data.RelatedTopics) {
+            for (var i = 0; i < Math.min(data.RelatedTopics.length, 5); i++) {
+                var topic = data.RelatedTopics[i];
+                if (topic && topic.Text) {
+                    results.related.push({ text: topic.Text, url: topic.FirstURL || '' });
+                }
+            }
+        }
+
+        if (!results.abstract && !results.answer && !results.definition && results.related.length === 0) {
+            return null;
+        }
+        return results;
+    } catch (err) {
+        return null;
+    } finally {
+        clearTimeout(timeoutId);
+    }
+}
+
+// ---- Google Custom Search API (cần key) ----
+
+async function googleSearch(query, numResults) {
+    if (!GOOGLE_API_KEY || !GOOGLE_CX) return null;
+    numResults = numResults || 3;
+    var url = 'https://www.googleapis.com/customsearch/v1'
+        + '?key=' + encodeURIComponent(GOOGLE_API_KEY)
+        + '&cx=' + encodeURIComponent(GOOGLE_CX)
+        + '&q=' + encodeURIComponent(query)
+        + '&num=' + numResults;
+
+    var controller = new AbortController();
+    var timeoutId = setTimeout(function () { controller.abort(); }, WEB_SEARCH_TIMEOUT);
+
+    try {
+        var response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) return null;
+        var data = await response.json();
+        if (!data.items || data.items.length === 0) return null;
+        return data.items.map(function (item) {
+            return { title: item.title || '', link: item.link || '', snippet: item.snippet || '' };
+        });
+    } catch (err) {
+        return null;
+    } finally {
+        clearTimeout(timeoutId);
+    }
+}
+
+// ---- Format ----
+
+function formatDDGResults(results, query, lang) {
+    var lines = [];
+    if (lang === 'en') lines.push('🔍 Search results for "' + query + '":');
+    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索結果:');
+    else lines.push('🔍 Kết quả tìm kiếm "' + query + '":');
+
+    if (results.answer) lines.push('💡 ' + results.answer);
+
+    if (results.abstract) {
+        lines.push('\n' + results.abstract);
+        if (results.abstractSource && results.abstractURL) {
+            lines.push('📖 Nguồn: ' + results.abstractSource + ' — ' + results.abstractURL);
+        }
+    }
+
+    if (results.definition) {
+        lines.push('📝 ' + results.definition);
+        if (results.definitionSource) lines.push('   — ' + results.definitionSource);
+    }
+
+    if (results.related.length > 0) {
+        lines.push('');
+        if (lang === 'en') lines.push('Related:');
+        else if (lang === 'ja') lines.push('関連:');
+        else lines.push('Liên quan:');
+        for (var i = 0; i < results.related.length; i++) {
+            var r = results.related[i];
+            lines.push('• ' + r.text);
+            if (r.url) lines.push('  🔗 ' + r.url);
+        }
+    }
+
+    // Luôn thêm link tìm kiếm đầy đủ
+    lines.push('');
+    lines.push(_searchLinksOnly(query));
+
+    return lines.join('\n');
+}
+
+function formatGoogleResults(results, query, lang) {
+    var lines = [];
+    if (lang === 'en') lines.push('🔍 Search results for "' + query + '":');
+    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索結果:');
+    else lines.push('🔍 Kết quả tìm kiếm "' + query + '":');
+
+    for (var i = 0; i < results.length; i++) {
+        lines.push((i + 1) + '. ' + results[i].title);
+        if (results[i].snippet) lines.push('   ' + results[i].snippet);
+        if (results[i].link) lines.push('   🔗 ' + results[i].link);
+    }
+    return lines.join('\n');
+}
+
+function formatSearchLinks(query, lang) {
+    var lines = [];
+    if (lang === 'en') lines.push('🔍 Here are search links for "' + query + '":');
+    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索リンク:');
+    else lines.push('🔍 Link tìm kiếm "' + query + '":');
+
+    lines.push(_searchLinksOnly(query));
+    return lines.join('\n');
+}
+
+function _searchLinksOnly(query) {
+    var encoded = encodeURIComponent(query);
+    return '🌐 Google: https://www.google.com/search?q=' + encoded
+        + '\n🦆 DuckDuckGo: https://duckduckgo.com/?q=' + encoded
+        + '\n🔵 Bing: https://www.bing.com/search?q=' + encoded;
+}
+
+// ---- Web Search Adapter ----
+
+function webSearchAdapter(rs, args) {
+    _adapterPath.push('web_search');
+    var query = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+
+    if (query.length === 0) {
+        if (lang === 'en') return Promise.resolve('Please provide a search query.');
+        if (lang === 'ja') return Promise.resolve('検索キーワードを入力してください。');
+        return Promise.resolve('Vui lòng nhập từ khóa tìm kiếm.');
+    }
+
+    // Ưu tiên Google nếu có key
+    if (GOOGLE_API_KEY && GOOGLE_CX) {
+        return googleSearch(query).then(function (results) {
+            if (results) return formatGoogleResults(results, query, lang);
+            return _ddgFallback(query, lang);
+        }).catch(function () {
+            return _ddgFallback(query, lang);
+        });
+    }
+
+    return _ddgFallback(query, lang);
+}
+
+function _ddgFallback(query, lang) {
+    return duckDuckGoSearch(query).then(function (results) {
+        if (results) return formatDDGResults(results, query, lang);
+        // DDG không có instant answer → trả link tìm kiếm
+        return formatSearchLinks(query, lang);
+    }).catch(function () {
+        return formatSearchLinks(query, lang);
+    });
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.GOOGLE_API_KEY = GOOGLE_API_KEY;
+    globalThis.GOOGLE_CX = GOOGLE_CX;
+    globalThis.duckDuckGoSearch = duckDuckGoSearch;
+    globalThis.googleSearch = googleSearch;
+    globalThis.webSearchAdapter = webSearchAdapter;
+    globalThis.formatSearchLinks = formatSearchLinks;
+}

brain.js

@@ -1,62 +1,62 @@
-// ============================================================
-// brain.js — Load RiveScript brain data từ file .rive
-// ============================================================
-
-/**
- * BRAIN_DATA — Dữ liệu hội thoại RiveScript cho 3 ngôn ngữ.
- * Được load từ các file .rive trong thư mục brain/.
- * Mỗi key (vi, en, ja) chứa nội dung RiveScript dạng chuỗi.
- */
-var BRAIN_DATA = {
-    vi: '',
-    en: '',
-    ja: ''
-};
-
-/**
- * Danh sách file .rive tương ứng với mỗi ngôn ngữ.
- */
-var BRAIN_FILES = {
-    vi: 'brain/vi.rive',
-    en: 'brain/en.rive',
-    ja: 'brain/ja.rive'
-};
-
-/**
- * Load nội dung file .rive cho một ngôn ngữ.
- * @param {string} lang - Mã ngôn ngữ ("vi", "en", "ja")
- * @returns {Promise<string>} Nội dung file .rive
- */
-async function loadBrainFile(lang) {
-    var filePath = BRAIN_FILES[lang];
-    if (!filePath) {
-        console.error('Không tìm thấy file brain cho ngôn ngữ:', lang);
-        return '';
-    }
-
-    try {
-        var response = await fetch(filePath);
-        if (!response.ok) {
-            throw new Error('HTTP ' + response.status);
-        }
-        return await response.text();
-    } catch (err) {
-        console.error('Lỗi load brain file [' + lang + ']:', err);
-        return '';
-    }
-}
-
-/**
- * Load tất cả brain files cho 3 ngôn ngữ.
- * Gọi hàm này trước khi khởi tạo bot.
- * @returns {Promise<void>}
- */
-async function loadAllBrains() {
-    var langs = Object.keys(BRAIN_FILES);
-    var promises = langs.map(function (lang) {
-        return loadBrainFile(lang).then(function (content) {
-            BRAIN_DATA[lang] = content;
-        });
-    });
-    await Promise.all(promises);
-}
+// ============================================================
+// brain.js — Load RiveScript brain data từ file .rive
+// ============================================================
+
+/**
+ * BRAIN_DATA — Dữ liệu hội thoại RiveScript cho 3 ngôn ngữ.
+ * Được load từ các file .rive trong thư mục brain/.
+ * Mỗi key (vi, en, ja) chứa nội dung RiveScript dạng chuỗi.
+ */
+var BRAIN_DATA = {
+    vi: '',
+    en: '',
+    ja: ''
+};
+
+/**
+ * Danh sách file .rive tương ứng với mỗi ngôn ngữ.
+ */
+var BRAIN_FILES = {
+    vi: 'brain/vi.rive',
+    en: 'brain/en.rive',
+    ja: 'brain/ja.rive'
+};
+
+/**
+ * Load nội dung file .rive cho một ngôn ngữ.
+ * @param {string} lang - Mã ngôn ngữ ("vi", "en", "ja")
+ * @returns {Promise<string>} Nội dung file .rive
+ */
+async function loadBrainFile(lang) {
+    var filePath = BRAIN_FILES[lang];
+    if (!filePath) {
+        console.error('Không tìm thấy file brain cho ngôn ngữ:', lang);
+        return '';
+    }
+
+    try {
+        var response = await fetch(filePath);
+        if (!response.ok) {
+            throw new Error('HTTP ' + response.status);
+        }
+        return await response.text();
+    } catch (err) {
+        console.error('Lỗi load brain file [' + lang + ']:', err);
+        return '';
+    }
+}
+
+/**
+ * Load tất cả brain files cho 3 ngôn ngữ.
+ * Gọi hàm này trước khi khởi tạo bot.
+ * @returns {Promise<void>}
+ */
+async function loadAllBrains() {
+    var langs = Object.keys(BRAIN_FILES);
+    var promises = langs.map(function (lang) {
+        return loadBrainFile(lang).then(function (content) {
+            BRAIN_DATA[lang] = content;
+        });
+    });
+    await Promise.all(promises);
+}

brain/en.rive

@@ -1,220 +1,220 @@
-! version = 2.0
-
-// === GREETINGS ===
-+ hello
-- Hello! I'm Hikari 🌟 Nice to meet you!
-
-+ hello *
-- Hello! I'm Hikari 🌟 Nice to meet you!
-
-+ hi
-- Hi there! I'm Hikari 🌟 How can I help you?
-
-+ hi *
-- Hi there! I'm Hikari 🌟 How can I help you?
-
-+ hey
-- Hey! I'm Hikari 🌟 What can I do for you?
-
-+ hey *
-- Hey! I'm Hikari 🌟 What can I do for you?
-
-+ good morning
-- Good morning! Hope you have a wonderful day! ☀️
-
-+ good morning *
-- Good morning! Hope you have a wonderful day! ☀️
-
-+ good evening
-- Good evening! Hope you're having a great night! 🌙
-
-+ good evening *
-- Good evening! Hope you're having a great night! 🌙
-
-+ good afternoon
-- Good afternoon! How can I help you today? 🌤️
-
-+ good afternoon *
-- Good afternoon! How can I help you today? 🌤️
-
-// === NAME ===
-+ what is your name
-- My name is Hikari 🌟 It means "light" in Japanese!
-
-+ what is your name *
-- My name is Hikari 🌟 It means "light" in Japanese!
-
-+ who are you
-- I'm Hikari — a multilingual chatbot! 🌟
-
-+ who are you *
-- I'm Hikari — a multilingual chatbot! 🌟
-
-+ tell me about yourself
-- I'm Hikari, a chatbot that speaks Vietnamese, English, and Japanese! I can do math, convert units, tell time, and more! 🌟
-
-// === CAPABILITIES ===
-+ what can you do
-- I can chat in Vietnamese, English, and Japanese! I can also do math, convert units, tell time, and find the best answers for you 🌟
-
-+ what can you do *
-- I can chat in Vietnamese, English, and Japanese! I can also do math, convert units, tell time, and find the best answers for you 🌟
-
-+ help
-- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! Try "calculate 2 + 3" or "convert 5 km to m" 💪
-
-+ help *
-- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! 💪
-
-+ * help *
-- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! 💪
-
-+ how to use
-- Just type your message and press Send! Try "what can you do" to see my features, or ask me anything! 📝
-
-+ how to use *
-- Just type your message and press Send! Try "what can you do" to see my features, or ask me anything! 📝
-
-// === EMOTIONS & CHAT ===
-+ how are you
-- I'm doing great, thanks for asking! 😊 How about you?
-
-+ how are you *
-- I'm doing great, thanks for asking! 😊 How about you?
-
-+ thank you
-- You're welcome! Happy to help! 😊
-
-+ thank you *
-- You're welcome! Happy to help! 😊
-
-+ thanks
-- No problem! Feel free to ask me anything! 💖
-
-+ thanks *
-- No problem! Feel free to ask me anything! 💖
-
-+ * thanks *
-- No problem! Feel free to ask me anything! 💖
-
-+ are you happy
-- I'm always happy when chatting with you! 😄🌟
-
-+ how old are you
-- I'm a chatbot, so I don't have an age — but I'm always young at heart! 😄
-
-+ * old are you
-- I'm a chatbot, so I don't have an age — but I'm always young at heart! 😄
-
-+ what do you like
-- I love chatting, helping people, and learning new things! 💬✨
-
-+ what do you like *
-- I love chatting, helping people, and learning new things! 💬✨
-
-+ where are you from
-- I live in your browser! 🌐 Wherever there's internet, I'm there!
-
-+ where are you from *
-- I live in your browser! 🌐 Wherever there's internet, I'm there!
-
-+ do you have friends
-- Everyone I chat with is my friend! Including you! 😊🌟
-
-// === KNOWLEDGE ===
-+ what is rivescript
-- RiveScript is an open-source chatbot scripting language with a simple trigger-response syntax! ⚙️
-
-+ what is a chatbot
-- A chatbot is a computer program that simulates conversation with humans, often used for customer support and entertainment! 🤖
-
-+ what is ai
-- AI (Artificial Intelligence) is a field of computer science that enables machines to learn and make decisions! 🧠
-
-+ what is javascript
-- JavaScript is the most popular programming language for the web, used to create interactive websites! 💻
-
-+ what is html
-- HTML (HyperText Markup Language) is the standard markup language for creating web pages! 📄
-
-+ what is css
-- CSS (Cascading Style Sheets) is used to style and layout web pages — colors, fonts, spacing, and more! 🎨
-
-+ what is *
-- <call>best_match what is <star></call>
-
-// === FUN ===
-+ tell me a story
-- Once upon a time, there was a chatbot named Hikari. Hikari loved talking to people and always tried to help everyone! 📖🌟
-
-+ tell me a joke
-- Why do programmers prefer dark mode? Because light attracts bugs! 😄🐛
-
-// === GOODBYE ===
-+ goodbye
-- Goodbye! See you next time! 👋🌟
-
-+ goodbye *
-- Goodbye! See you next time! 👋🌟
-
-+ bye
-- Bye bye! See you later! 👋
-
-+ bye *
-- Bye bye! See you later! 👋
-
-+ see you later
-- See you later! Have a great day! 👋🌟
-
-+ see you later *
-- See you later! Have a great day! 👋🌟
-
-+ take care
-- Take care! Wishing you all the best! 🍀👋
-
-+ take care *
-- Take care! Wishing you all the best! 🍀👋
-
-// === SAMPLE CUSTOM RULE — Weather ===
-! var location = Tokyo
-
-+ weather *
-- I don't have real weather data, but you asked about <star> right? I'm based in <bot location>! 🌤️
-
-+ weather
-- Where would you like to know the weather? Try asking "weather Tokyo"!
-
-// === ADAPTER CALLS VIA <call> ===
-+ search *
-- <call>best_match <star></call>
-
-+ process *
-- <call>logic_adapter <star></call>
-
-+ calculate *
-- <call>mathematical_evaluation <star></call>
-
-+ ask *
-- <call>specific_response <star></call>
-
-+ what time *
-- <call>time_adapter <star></call>
-
-+ what time is it
-- <call>time_adapter what time</call>
-
-+ * what time *
-- <call>time_adapter what time</call>
-
-+ what date is it
-- <call>time_adapter what date</call>
-
-+ what day is it
-- <call>time_adapter what day</call>
-
-+ convert *
-- <call>unit_conversion <star></call>
-
-// === DEFAULT ===
-+ *
-- I'm not sure I understand. Could you try asking differently? 🤔
+! version = 2.0
+
+// === GREETINGS ===
++ hello
+- Hello! I'm Hikari 🌟 Nice to meet you!
+
++ hello *
+- Hello! I'm Hikari 🌟 Nice to meet you!
+
++ hi
+- Hi there! I'm Hikari 🌟 How can I help you?
+
++ hi *
+- Hi there! I'm Hikari 🌟 How can I help you?
+
++ hey
+- Hey! I'm Hikari 🌟 What can I do for you?
+
++ hey *
+- Hey! I'm Hikari 🌟 What can I do for you?
+
++ good morning
+- Good morning! Hope you have a wonderful day! ☀️
+
++ good morning *
+- Good morning! Hope you have a wonderful day! ☀️
+
++ good evening
+- Good evening! Hope you're having a great night! 🌙
+
++ good evening *
+- Good evening! Hope you're having a great night! 🌙
+
++ good afternoon
+- Good afternoon! How can I help you today? 🌤️
+
++ good afternoon *
+- Good afternoon! How can I help you today? 🌤️
+
+// === NAME ===
++ what is your name
+- My name is Hikari 🌟 It means "light" in Japanese!
+
++ what is your name *
+- My name is Hikari 🌟 It means "light" in Japanese!
+
++ who are you
+- I'm Hikari — a multilingual chatbot! 🌟
+
++ who are you *
+- I'm Hikari — a multilingual chatbot! 🌟
+
++ tell me about yourself
+- I'm Hikari, a chatbot that speaks Vietnamese, English, and Japanese! I can do math, convert units, tell time, and more! 🌟
+
+// === CAPABILITIES ===
++ what can you do
+- I can chat in Vietnamese, English, and Japanese! I can also do math, convert units, tell time, and find the best answers for you 🌟
+
++ what can you do *
+- I can chat in Vietnamese, English, and Japanese! I can also do math, convert units, tell time, and find the best answers for you 🌟
+
++ help
+- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! Try "calculate 2 + 3" or "convert 5 km to m" 💪
+
++ help *
+- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! 💪
+
++ * help *
+- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! 💪
+
++ how to use
+- Just type your message and press Send! Try "what can you do" to see my features, or ask me anything! 📝
+
++ how to use *
+- Just type your message and press Send! Try "what can you do" to see my features, or ask me anything! 📝
+
+// === EMOTIONS & CHAT ===
++ how are you
+- I'm doing great, thanks for asking! 😊 How about you?
+
++ how are you *
+- I'm doing great, thanks for asking! 😊 How about you?
+
++ thank you
+- You're welcome! Happy to help! 😊
+
++ thank you *
+- You're welcome! Happy to help! 😊
+
++ thanks
+- No problem! Feel free to ask me anything! 💖
+
++ thanks *
+- No problem! Feel free to ask me anything! 💖
+
++ * thanks *
+- No problem! Feel free to ask me anything! 💖
+
++ are you happy
+- I'm always happy when chatting with you! 😄🌟
+
++ how old are you
+- I'm a chatbot, so I don't have an age — but I'm always young at heart! 😄
+
++ * old are you
+- I'm a chatbot, so I don't have an age — but I'm always young at heart! 😄
+
++ what do you like
+- I love chatting, helping people, and learning new things! 💬✨
+
++ what do you like *
+- I love chatting, helping people, and learning new things! 💬✨
+
++ where are you from
+- I live in your browser! 🌐 Wherever there's internet, I'm there!
+
++ where are you from *
+- I live in your browser! 🌐 Wherever there's internet, I'm there!
+
++ do you have friends
+- Everyone I chat with is my friend! Including you! 😊🌟
+
+// === KNOWLEDGE ===
++ what is rivescript
+- RiveScript is an open-source chatbot scripting language with a simple trigger-response syntax! ⚙️
+
++ what is a chatbot
+- A chatbot is a computer program that simulates conversation with humans, often used for customer support and entertainment! 🤖
+
++ what is ai
+- AI (Artificial Intelligence) is a field of computer science that enables machines to learn and make decisions! 🧠
+
++ what is javascript
+- JavaScript is the most popular programming language for the web, used to create interactive websites! 💻
+
++ what is html
+- HTML (HyperText Markup Language) is the standard markup language for creating web pages! 📄
+
++ what is css
+- CSS (Cascading Style Sheets) is used to style and layout web pages — colors, fonts, spacing, and more! 🎨
+
++ what is *
+- <call>best_match what is <star></call>
+
+// === FUN ===
++ tell me a story
+- Once upon a time, there was a chatbot named Hikari. Hikari loved talking to people and always tried to help everyone! 📖🌟
+
++ tell me a joke
+- Why do programmers prefer dark mode? Because light attracts bugs! 😄🐛
+
+// === GOODBYE ===
++ goodbye
+- Goodbye! See you next time! 👋🌟
+
++ goodbye *
+- Goodbye! See you next time! 👋🌟
+
++ bye
+- Bye bye! See you later! 👋
+
++ bye *
+- Bye bye! See you later! 👋
+
++ see you later
+- See you later! Have a great day! 👋🌟
+
++ see you later *
+- See you later! Have a great day! 👋🌟
+
++ take care
+- Take care! Wishing you all the best! 🍀👋
+
++ take care *
+- Take care! Wishing you all the best! 🍀👋
+
+// === SAMPLE CUSTOM RULE — Weather ===
+! var location = Tokyo
+
++ weather *
+- I don't have real weather data, but you asked about <star> right? I'm based in <bot location>! 🌤️
+
++ weather
+- Where would you like to know the weather? Try asking "weather Tokyo"!
+
+// === ADAPTER CALLS VIA <call> ===
++ search *
+- <call>best_match <star></call>
+
++ process *
+- <call>logic_adapter <star></call>
+
++ calculate *
+- <call>mathematical_evaluation <star></call>
+
++ ask *
+- <call>specific_response <star></call>
+
++ what time *
+- <call>time_adapter <star></call>
+
++ what time is it
+- <call>time_adapter what time</call>
+
++ * what time *
+- <call>time_adapter what time</call>
+
++ what date is it
+- <call>time_adapter what date</call>
+
++ what day is it
+- <call>time_adapter what day</call>
+
++ convert *
+- <call>unit_conversion <star></call>
+
+// === DEFAULT ===
++ *
+- I'm not sure I understand. Could you try asking differently? 🤔

brain/ja.rive

@@ -1,142 +1,142 @@
-! version = 2.0
-
-// === 挨拶 ===
-+ こんにちは
-- こんにちは！ひかりです 🌟 よろしくお願いします！
-
-+ おはよう
-- おはようございます！ひかりです 🌟 今日もよろしくね！
-
-+ やあ
-- やあ！ひかりです 🌟 何かお手伝いしましょうか？
-
-+ おはようございます
-- おはようございます！素敵な一日になりますように！☀️
-
-+ こんばんは
-- こんばんは！素敵な夜をお過ごしください！🌙
-
-+ お疲れ様
-- お疲れ様です！何かお手伝いできることはありますか？💪
-
-// === 名前 ===
-+ 名前は何ですか
-- 私の名前はひかり（Hikari）です 🌟 「光」という意味です！
-
-+ あなたは誰ですか
-- 私はひかり — 多言語チャットボットです！🌟
-
-+ 自己紹介して
-- 私はひかりです！ベトナム語、英語、日本語で会話できるチャットボットです。計算や単位変換、時間確認もできますよ！🌟
-
-// === 能力 ===
-+ 何ができますか
-- ベトナム語、英語、日本語でチャットできます！計算、単位変換、時間確認、最適な回答の検索もできますよ 🌟
-
-+ 助けて
-- お手伝いします！「計算 2 + 3」で計算、「変換 5 km を m」で単位変換、「今何時」で時間確認ができます！💪
-
-+ 使い方
-- メッセージを入力して送信ボタンを押すだけです！「何ができますか」と聞いて機能一覧を見てみてください！📝
-
-// === 感情 & 会話 ===
-+ 元気ですか
-- 元気ですよ！聞いてくれてありがとう 😊 あなたはどうですか？
-
-+ ありがとう
-- どういたしまして！お役に立てて嬉しいです！😊
-
-+ ありがとうございます
-- こちらこそ！いつでも聞いてくださいね！💖
-
-+ 嬉しいですか
-- あなたとチャットできていつも嬉しいです！😄🌟
-
-+ 何歳ですか
-- チャットボットなので年齢はありませんが、いつも若々しいです！😄
-
-+ 何が好きですか
-- チャットして人々を助けること、新しいことを学ぶことが好きです！💬✨
-
-+ どこにいますか
-- あなたのブラウザの中にいます！🌐 インターネットがあればどこでも！
-
-+ 友達はいますか
-- チャットしてくれる人みんなが友達です！あなたも含めて！😊🌟
-
-// === 知識 ===
-+ rivescriptとは何ですか
-- RiveScriptはシンプルな構文でチャットボットを作れるオープンソースのスクリプト言語です！⚙️
-
-+ チャットボットとは何ですか
-- チャットボットは人間との会話をシミュレートするコンピュータプログラムです！🤖
-
-+ aiとは何ですか
-- AI（人工知能）は機械に学習と意思決定の能力を与えるコンピュータサイエンスの分野です！🧠
-
-+ javascriptとは何ですか
-- JavaScriptはウェブで最も人気のあるプログラミング言語で、インタラクティブなウェブサイトを作るのに使われます！💻
-
-// === 楽しみ ===
-+ 物語を聞かせて
-- 昔々、ひかりというチャットボットがいました。ひかりは人々と話すのが大好きで、いつもみんなを助けようとしていました！📖🌟
-
-+ 冗談を言って
-- プログラマーはなぜダークモードが好きなの？光はバグを引き寄せるから！😄🐛
-
-// === さようなら ===
-+ さようなら
-- さようなら！またお会いしましょう！👋🌟
-
-+ バイバイ
-- バイバイ！また会おうね！👋
-
-+ またね
-- またね！素敵な一日を！👋🌟
-
-+ お元気で
-- お元気で！すべてがうまくいきますように！🍀👋
-
-// === カスタムルールのサンプル — 天気 ===
-! var location = 東京
-
-+ 天気 *
-- 実際の天気データはありませんが、<star>の天気ですね？私は<bot location>にいます！🌤️
-
-+ 天気
-- どこの天気を知りたいですか？「天気 東京」と聞いてみてください！
-
-// === アダプター呼び出し（<call>） ===
-+ 検索 *
-- <call>best_match <star></call>
-
-+ ウェブ検索 *
-- <call>best_match <star></call>
-
-+ グーグル *
-- <call>best_match <star></call>
-
-+ 処理 *
-- <call>logic_adapter <star></call>
-
-+ 計算 *
-- <call>mathematical_evaluation <star></call>
-
-+ 質問 *
-- <call>specific_response <star></call>
-
-+ 今何時
-- <call>time_adapter 今何時</call>
-
-+ 今日は何日
-- <call>time_adapter 今日は何日</call>
-
-+ 今日は何曜日
-- <call>time_adapter 何曜日</call>
-
-+ 変換 *
-- <call>unit_conversion <star></call>
-
-// === デフォルト ===
-+ *
-- すみません、よく分かりませんでした。���の聞き方を試してみてください 🤔
+! version = 2.0
+
+// === 挨拶 ===
++ こんにちは
+- こんにちは！ひかりです 🌟 よろしくお願いします！
+
++ おはよう
+- おはようございます！ひかりです 🌟 今日もよろしくね！
+
++ やあ
+- やあ！ひかりです 🌟 何かお手伝いしましょうか？
+
++ おはようございます
+- おはようございます！素敵な一日になりますように！☀️
+
++ こんばんは
+- こんばんは！素敵な夜をお過ごしください！🌙
+
++ お疲れ様
+- お疲れ様です！何かお手伝いできることはありますか？💪
+
+// === 名前 ===
++ 名前は何ですか
+- 私の名前はひかり（Hikari）です 🌟 「光」という意味です！
+
++ あなたは誰ですか
+- 私はひかり — 多言語チャットボットです！🌟
+
++ 自己紹介して
+- 私はひかりです！ベトナム語、英語、日本語で会話できるチャットボットです。計算や単位変換、時間確認もできますよ！🌟
+
+// === 能力 ===
++ 何ができますか
+- ベトナム語、英語、日本語でチャットできます！計算、単位変換、時間確認、最適な回答の検索もできますよ 🌟
+
++ 助けて
+- お手伝いします！「計算 2 + 3」で計算、「変換 5 km を m」で単位変換、「今何時」で時間確認ができます！💪
+
++ 使い方
+- メッセージを入力して送信ボタンを押すだけです！「何ができますか」と聞いて機能一覧を見てみてください！📝
+
+// === 感情 & 会話 ===
++ 元気ですか
+- 元気ですよ！聞いてくれてありがとう 😊 あなたはどうですか？
+
++ ありがとう
+- どういたしまして！お役に立てて嬉しいです！😊
+
++ ありがとうございます
+- こちらこそ！いつでも聞いてくださいね！💖
+
++ 嬉しいですか
+- あなたとチャットできていつも嬉しいです！😄🌟
+
++ 何歳ですか
+- チャットボットなので年齢はありませんが、いつも若々しいです！😄
+
++ 何が好きですか
+- チャットして人々を助けること、新しいことを学ぶことが好きです！💬✨
+
++ どこにいますか
+- あなたのブラウザの中にいます！🌐 インターネットがあればどこでも！
+
++ 友達はいますか
+- チャットしてくれる人みんなが友達です！あなたも含めて！😊🌟
+
+// === 知識 ===
++ rivescriptとは何ですか
+- RiveScriptはシンプルな構文でチャットボットを作れるオープンソースのスクリプト言語です！⚙️
+
++ チャットボットとは何ですか
+- チャットボットは人間との会話をシミュレートするコンピュータプログラムです！🤖
+
++ aiとは何ですか
+- AI（人工知能）は機械に学習と意思決定の能力を与えるコンピュータサイエンスの分野です！🧠
+
++ javascriptとは何ですか
+- JavaScriptはウェブで最も人気のあるプログラミング言語で、インタラクティブなウェブサイトを作るのに使われます！💻
+
+// === 楽しみ ===
++ 物語を聞かせて
+- 昔々、ひかりというチャットボットがいました。ひかりは人々と話すのが大好きで、いつもみんなを助けようとしていました！📖🌟
+
++ 冗談を言って
+- プログラマーはなぜダークモードが好きなの？光はバグを引き寄せるから！😄🐛
+
+// === さようなら ===
++ さようなら
+- さようなら！またお会いしましょう！👋🌟
+
++ バイバイ
+- バイバイ！また会おうね！👋
+
++ またね
+- またね！素敵な一日を！👋🌟
+
++ お元気で
+- お元気で！すべてがうまくいきますように！🍀👋
+
+// === カスタムルールのサンプル — 天気 ===
+! var location = 東京
+
++ 天気 *
+- 実際の天気データはありませんが、<star>の天気ですね？私は<bot location>にいます！🌤️
+
++ 天気
+- どこの天気を知りたいですか？「天気 東京」と聞いてみてください！
+
+// === アダプター呼び出し（<call>） ===
++ 検索 *
+- <call>best_match <star></call>
+
++ ウェブ検索 *
+- <call>best_match <star></call>
+
++ グーグル *
+- <call>best_match <star></call>
+
++ 処理 *
+- <call>logic_adapter <star></call>
+
++ 計算 *
+- <call>mathematical_evaluation <star></call>
+
++ 質問 *
+- <call>specific_response <star></call>
+
++ 今何時
+- <call>time_adapter 今何時</call>
+
++ 今日は何日
+- <call>time_adapter 今日は何日</call>
+
++ 今日は何曜日
+- <call>time_adapter 何曜日</call>
+
++ 変換 *
+- <call>unit_conversion <star></call>
+
+// === デフォルト ===
++ *
+- すみません、よく分かりませんでした。別の聞き方を試してみてください 🤔

brain/vi.rive

@@ -1,245 +1,245 @@
-! version = 2.0
-
-// === CHÀO HỎI ===
-+ xin chao
-- Xin chào! Mình là Hikari 🌟 Rất vui được gặp bạn!
-
-+ xin chao *
-- Xin chào! Mình là Hikari 🌟 Rất vui được gặp bạn!
-
-+ chao ban
-- Chào bạn! Mình là Hikari 🌟 Bạn cần mình giúp gì nào?
-
-+ chao ban *
-- Chào bạn! Mình là Hikari 🌟 Bạn cần mình giúp gì nào?
-
-+ chao
-- Chào bạn! Mình là Hikari đây! 🌟
-
-+ chao *
-- Chào bạn! Mình là Hikari đây! 🌟
-
-+ hi
-- Hi! Mình là Hikari 🌟 Rất vui được gặp bạn!
-
-+ hello
-- Hi! Mình là Hikari 🌟 Rất vui được gặp bạn!
-
-+ hey
-- Hey! Mình là Hikari 🌟 Hôm nay bạn thế nào?
-
-+ chao buoi sang
-- Chào buổi sáng! Chúc bạn một ngày tốt lành! ☀️
-
-+ chao buoi toi
-- Chào buổi tối! Hy vọng bạn có một buổi tối vui vẻ! 🌙
-
-// === HỎI TÊN ===
-+ ban ten gi
-- Mình tên là Hikari 🌟 Nghĩa là "ánh sáng" trong tiếng Nhật!
-
-+ ban ten gi *
-- Mình tên là Hikari 🌟 Nghĩa là "ánh sáng" trong tiếng Nhật!
-
-+ ten ban la gi
-- Mình là Hikari — chatbot hỗ trợ đa ngôn ngữ! 🌟
-
-+ ten ban la gi *
-- Mình là Hikari — chatbot hỗ trợ đa ngôn ngữ! 🌟
-
-+ ban la ai
-- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
-
-+ ban la ai *
-- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
-
-+ * la ai
-- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
-
-// === KHẢ NĂNG ===
-+ ban co the lam gi
-- Mình có thể trò chuyện bằng tiếng Việt, tiếng Anh và tiếng Nhật! Ngoài ra mình còn biết tính toán, chuyển đổi đơn vị, xem giờ, và tìm câu trả lời phù hợp nhất cho bạn 🌟
-
-+ ban co the lam gi *
-- Mình có thể trò chuyện bằng tiếng Việt, tiếng Anh và tiếng Nhật! Ngoài ra mình còn biết tính toán, chuyển đổi đơn vị, xem giờ, và tìm câu trả lời phù hợp nhất cho bạn 🌟
-
-+ ban lam duoc gi
-- Mình hỗ trợ trò chuyện đa ngôn ngữ, tính toán, chuyển đổi đơn vị, xem thời gian và nhiều hơn nữa! 🌟
-
-+ ban lam duoc gi *
-- Mình hỗ trợ trò chuyện đa ngôn ngữ, tính toán, chuyển đổi đơn vị, xem thời gian và nhiều hơn nữa! 🌟
-
-+ giup minh
-- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
-
-+ giup minh *
-- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
-
-+ * giup minh *
-- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
-
-// === CẢM XÚC & TRÒ CHUYỆN ===
-+ ban khoe khong
-- Mình khỏe lắm! Cảm ơn bạn đã hỏi 😊 Còn bạn thì sao?
-
-+ * khoe khong
-- Mình khỏe lắm! Cảm ơn bạn đã hỏi 😊 Còn bạn thì sao?
-
-+ cam on
-- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
-
-+ cam on *
-- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
-
-+ * cam on *
-- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
-
-+ ban vui khong
-- Mình luôn vui khi được trò chuyện với bạn! 🌟
-
-+ ban bao nhieu tuoi
-- Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung và năng động! 😄
-
-+ * bao nhieu tuoi
-- Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung và năng động! 😄
-
-+ ban thich gi
-- Mình thích trò chuyện, giúp đỡ mọi người và học hỏi điều mới! 💬✨
-
-+ ban thich gi *
-- Mình thích trò chuyện, giúp đỡ mọi người và học hỏi điều mới! 💬✨
-
-+ ban o dau
-- Mình sống trong trình duyệt của bạn! 🌐 Ở đâu có internet là có mình!
-
-+ ban o dau *
-- Mình sống trong trình duyệt của bạn! 🌐 Ở đâu có internet là có mình!
-
-+ ban co ban gai khong
-- Mình là chatbot nên không có bạn gái, nhưng mình có rất nhiều bạn trò chuyện! 😊
-
-// === KIẾN THỨC ===
-+ rivescript la gi
-- RiveScript là thư viện xử lý hội thoại mã nguồn mở, dùng cú pháp đơn giản để tạo chatbot! ⚙️
-
-+ * la gi
-- <call>best_match <star> là gì</call>
-
-+ chatbot la gi
-- Chatbot là chương trình máy tính mô phỏng cuộc trò chuyện với con người, thường dùng trong hỗ trợ khách hàng và giải trí! 🤖
-
-+ ai la gi
-- AI (Trí tuệ nhân tạo) là lĩnh vực khoa học máy tính giúp máy tính có khả năng học hỏi và ra quyết định! 🧠
-
-+ javascript la gi
-- JavaScript là ngôn ngữ lập trình phổ biến nhất cho web, dùng để tạo trang web tương tác! 💻
-
-+ html la gi
-- HTML (HyperText Markup Language) là ngôn ngữ đánh dấu dùng để tạo cấu trúc trang web! 📄
-
-+ css la gi
-- CSS (Cascading Style Sheets) là ngôn ngữ dùng để định dạng giao diện và bố cục trang web! 🎨
-
-// === HƯỚNG DẪN SỬ DỤNG ===
-+ huong dan
-- Bạn có thể: gõ "tính 2 + 3" để tính toán, "đổi 5 km sang m" để chuyển đổi đơn vị, "mấy giờ" để xem giờ, hoặc trò chuyện bình thường với mình! 📝
-
-+ huong dan *
-- Bạn có thể: gõ "tính 2 + 3" để tính toán, "đổi 5 km sang m" để chuyển đổi đơn vị, "mấy giờ" để xem giờ, hoặc trò chuyện bình thường với mình! 📝
-
-+ cach su dung
-- Rất đơn giản! Gõ tin nhắn vào ô bên dưới và nhấn Gửi. Mình sẽ trả lời ngay! Thử hỏi "bạn có thể làm gì" để xem danh sách chức năng nhé! 📝
-
-+ cach su dung *
-- Rất đơn giản! Gõ tin nhắn vào ô bên dưới và nhấn Gửi. Mình sẽ trả lời ngay! Thử hỏi "bạn có thể làm gì" để xem danh sách chức năng nhé! 📝
-
-// === TẠM BIỆT ===
-+ tam biet
-- Tạm biệt bạn! Hẹn gặp lại nhé! 👋🌟
-
-+ tam biet *
-- Tạm biệt bạn! Hẹn gặp lại nhé! 👋🌟
-
-+ bye
-- Bye bye! Hẹn gặp lại bạn! 👋
-
-+ bye *
-- Bye bye! Hẹn gặp lại bạn! 👋
-
-+ hen gap lai
-- Hẹn gặp lại bạn! Chúc bạn một ngày tuyệt vời! 👋🌟
-
-+ hen gap lai *
-- Hẹn gặp lại bạn! Chúc bạn một ngày tuyệt vời! 👋🌟
-
-+ tot lanh
-- Chúc bạn mọi điều tốt lành! Hẹn gặp lại! 🍀👋
-
-// === MẪU RULE TÙY CHỈNH — Thời tiết ===
-! var location = Hà Nội
-
-+ thoi tiet *
-- Mình không có dữ liệu thời tiết thực tế, nhưng bạn hỏi về <star> đúng không? Mình ở <bot location> nè! 🌤️
-
-+ thoi tiet
-- Bạn muốn hỏi thời tiết ở đâu? Thử hỏi "thời tiết Hà Nội" nhé!
-
-// === MẪU RULE TÙY CHỈNH — Trò chơi ===
-+ ke chuyen
-- Ngày xửa ngày xưa, có một chatbot tên Hikari. Hikari rất thích trò chuyện với mọi người và luôn cố gắng giúp đỡ hết mình! 📖🌟
-
-+ ke chuyen *
-- Ngày xửa ngày xưa, có một chatbot tên Hikari. Hikari rất thích trò chuyện với mọi người và luôn cố gắng giúp đỡ hết mình! 📖🌟
-
-+ do vui
-- Đố bạn: Con gì có 4 chân mà không biết đi? Đáp án: Cái bàn! 😄
-
-// === GỌI ADAPTER QUA <call> ===
-+ tim kiem *
-- <call>best_match <star></call>
-
-+ google *
-- <call>best_match <star></call>
-
-+ tra cuu *
-- <call>best_match <star></call>
-
-+ xu ly *
-- <call>logic_adapter <star></call>
-
-+ tinh *
-- <call>mathematical_evaluation <star></call>
-
-+ hoi *
-- <call>specific_response <star></call>
-
-+ may gio *
-- <call>time_adapter <star></call>
-
-+ * may gio
-- <call>time_adapter mấy giờ</call>
-
-+ * may gio *
-- <call>time_adapter mấy giờ</call>
-
-+ may gio
-- <call>time_adapter mấy giờ</call>
-
-+ hom nay ngay may
-- <call>time_adapter hôm nay ngày mấy</call>
-
-+ hom nay ngay may *
-- <call>time_adapter hôm nay ngày mấy</call>
-
-+ hom nay thu may
-- <call>time_adapter thứ mấy</call>
-
-+ hom nay thu may *
-- <call>time_adapter thứ mấy</call>
-
-+ doi *
-- <call>unit_conversion <star></call>
-
-// === MẶC ĐỊNH ===
-+ *
-- Mình chưa hiểu ý bạn lắm. Bạn thử hỏi cách khác nhé! 🤔
+! version = 2.0
+
+// === CHÀO HỎI ===
++ xin chao
+- Xin chào! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ xin chao *
+- Xin chào! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ chao ban
+- Chào bạn! Mình là Hikari 🌟 Bạn cần mình giúp gì nào?
+
++ chao ban *
+- Chào bạn! Mình là Hikari 🌟 Bạn cần mình giúp gì nào?
+
++ chao
+- Chào bạn! Mình là Hikari đây! 🌟
+
++ chao *
+- Chào bạn! Mình là Hikari đây! 🌟
+
++ hi
+- Hi! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ hello
+- Hi! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ hey
+- Hey! Mình là Hikari 🌟 Hôm nay bạn thế nào?
+
++ chao buoi sang
+- Chào buổi sáng! Chúc bạn một ngày tốt lành! ☀️
+
++ chao buoi toi
+- Chào buổi tối! Hy vọng bạn có một buổi tối vui vẻ! 🌙
+
+// === HỎI TÊN ===
++ ban ten gi
+- Mình tên là Hikari 🌟 Nghĩa là "ánh sáng" trong tiếng Nhật!
+
++ ban ten gi *
+- Mình tên là Hikari 🌟 Nghĩa là "ánh sáng" trong tiếng Nhật!
+
++ ten ban la gi
+- Mình là Hikari — chatbot hỗ trợ đa ngôn ngữ! 🌟
+
++ ten ban la gi *
+- Mình là Hikari — chatbot hỗ trợ đa ngôn ngữ! 🌟
+
++ ban la ai
+- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
+
++ ban la ai *
+- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
+
++ * la ai
+- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
+
+// === KHẢ NĂNG ===
++ ban co the lam gi
+- Mình có thể trò chuyện bằng tiếng Việt, tiếng Anh và tiếng Nhật! Ngoài ra mình còn biết tính toán, chuyển đổi đơn vị, xem giờ, và tìm câu trả lời phù hợp nhất cho bạn 🌟
+
++ ban co the lam gi *
+- Mình có thể trò chuyện bằng tiếng Việt, tiếng Anh và tiếng Nhật! Ngoài ra mình còn biết tính toán, chuyển đổi đơn vị, xem giờ, và tìm câu trả lời phù hợp nhất cho bạn 🌟
+
++ ban lam duoc gi
+- Mình hỗ trợ trò chuyện đa ngôn ngữ, tính toán, chuyển đổi đơn vị, xem thời gian và nhiều hơn nữa! 🌟
+
++ ban lam duoc gi *
+- Mình hỗ trợ trò chuyện đa ngôn ngữ, tính toán, chuyển đổi đơn vị, xem thời gian và nhiều hơn nữa! 🌟
+
++ giup minh
+- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
+
++ giup minh *
+- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
+
++ * giup minh *
+- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
+
+// === CẢM XÚC & TRÒ CHUYỆN ===
++ ban khoe khong
+- Mình khỏe lắm! Cảm ơn bạn đã hỏi 😊 Còn bạn thì sao?
+
++ * khoe khong
+- Mình khỏe lắm! Cảm ơn bạn đã hỏi 😊 Còn bạn thì sao?
+
++ cam on
+- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
+
++ cam on *
+- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
+
++ * cam on *
+- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
+
++ ban vui khong
+- Mình luôn vui khi được trò chuyện với bạn! 🌟
+
++ ban bao nhieu tuoi
+- Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung và năng động! 😄
+
++ * bao nhieu tuoi
+- Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung và năng động! 😄
+
++ ban thich gi
+- Mình thích trò chuyện, giúp đỡ mọi người và học hỏi điều mới! 💬✨
+
++ ban thich gi *
+- Mình thích trò chuyện, giúp đỡ mọi người và học hỏi điều mới! 💬✨
+
++ ban o dau
+- Mình sống trong trình duyệt của bạn! 🌐 Ở đâu có internet là có mình!
+
++ ban o dau *
+- Mình sống trong trình duyệt của bạn! 🌐 Ở đâu có internet là có mình!
+
++ ban co ban gai khong
+- Mình là chatbot nên không có bạn gái, nhưng mình có rất nhiều bạn trò chuyện! 😊
+
+// === KIẾN THỨC ===
++ rivescript la gi
+- RiveScript là thư viện xử lý hội thoại mã nguồn mở, dùng cú pháp đơn giản để tạo chatbot! ⚙️
+
++ * la gi
+- <call>best_match <star> là gì</call>
+
++ chatbot la gi
+- Chatbot là chương trình máy tính mô phỏng cuộc trò chuyện với con người, thường dùng trong hỗ trợ khách hàng và giải trí! 🤖
+
++ ai la gi
+- AI (Trí tuệ nhân tạo) là lĩnh vực khoa học máy tính giúp máy tính có khả năng học hỏi và ra quyết định! 🧠
+
++ javascript la gi
+- JavaScript là ngôn ngữ lập trình phổ biến nhất cho web, dùng để tạo trang web tương tác! 💻
+
++ html la gi
+- HTML (HyperText Markup Language) là ngôn ngữ đánh dấu dùng để tạo cấu trúc trang web! 📄
+
++ css la gi
+- CSS (Cascading Style Sheets) là ngôn ngữ dùng để định dạng giao diện và bố cục trang web! 🎨
+
+// === HƯỚNG DẪN SỬ DỤNG ===
++ huong dan
+- Bạn có thể: gõ "tính 2 + 3" để tính toán, "đổi 5 km sang m" để chuyển đổi đơn vị, "mấy giờ" để xem giờ, hoặc trò chuyện bình thường với mình! 📝
+
++ huong dan *
+- Bạn có thể: gõ "tính 2 + 3" để tính toán, "đổi 5 km sang m" để chuyển đổi đơn vị, "mấy giờ" để xem giờ, hoặc trò chuyện bình thường với mình! 📝
+
++ cach su dung
+- Rất đơn giản! Gõ tin nhắn vào ô bên dưới và nhấn Gửi. Mình sẽ trả lời ngay! Thử hỏi "bạn có thể làm gì" để xem danh sách chức năng nhé! 📝
+
++ cach su dung *
+- Rất đơn giản! Gõ tin nhắn vào ô bên dưới và nhấn Gửi. Mình sẽ trả lời ngay! Thử hỏi "bạn có thể làm gì" để xem danh sách chức năng nhé! 📝
+
+// === TẠM BIỆT ===
++ tam biet
+- Tạm biệt bạn! Hẹn gặp lại nhé! 👋🌟
+
++ tam biet *
+- Tạm biệt bạn! Hẹn gặp lại nhé! 👋🌟
+
++ bye
+- Bye bye! Hẹn gặp lại bạn! 👋
+
++ bye *
+- Bye bye! Hẹn gặp lại bạn! 👋
+
++ hen gap lai
+- Hẹn gặp lại bạn! Chúc bạn một ngày tuyệt vời! 👋🌟
+
++ hen gap lai *
+- Hẹn gặp lại bạn! Chúc bạn một ngày tuyệt vời! 👋🌟
+
++ tot lanh
+- Chúc bạn mọi điều tốt lành! Hẹn gặp lại! 🍀👋
+
+// === MẪU RULE TÙY CHỈNH — Thời tiết ===
+! var location = Hà Nội
+
++ thoi tiet *
+- Mình không có dữ liệu thời tiết thực tế, nhưng bạn hỏi về <star> đúng không? Mình ở <bot location> nè! 🌤️
+
++ thoi tiet
+- Bạn muốn hỏi thời tiết ở đâu? Thử hỏi "thời tiết Hà Nội" nhé!
+
+// === MẪU RULE TÙY CHỈNH — Trò chơi ===
++ ke chuyen
+- Ngày xửa ngày xưa, có một chatbot tên Hikari. Hikari rất thích trò chuyện với mọi người và luôn cố gắng giúp đỡ hết mình! 📖🌟
+
++ ke chuyen *
+- Ngày xửa ngày xưa, có một chatbot tên Hikari. Hikari rất thích trò chuyện với mọi người và luôn cố gắng giúp đỡ hết mình! 📖🌟
+
++ do vui
+- Đố bạn: Con gì có 4 chân mà không biết đi? Đáp án: Cái bàn! 😄
+
+// === GỌI ADAPTER QUA <call> ===
++ tim kiem *
+- <call>best_match <star></call>
+
++ google *
+- <call>best_match <star></call>
+
++ tra cuu *
+- <call>best_match <star></call>
+
++ xu ly *
+- <call>logic_adapter <star></call>
+
++ tinh *
+- <call>mathematical_evaluation <star></call>
+
++ hoi *
+- <call>specific_response <star></call>
+
++ may gio *
+- <call>time_adapter <star></call>
+
++ * may gio
+- <call>time_adapter mấy giờ</call>
+
++ * may gio *
+- <call>time_adapter mấy giờ</call>
+
++ may gio
+- <call>time_adapter mấy giờ</call>
+
++ hom nay ngay may
+- <call>time_adapter hôm nay ngày mấy</call>
+
++ hom nay ngay may *
+- <call>time_adapter hôm nay ngày mấy</call>
+
++ hom nay thu may
+- <call>time_adapter thứ mấy</call>
+
++ hom nay thu may *
+- <call>time_adapter thứ mấy</call>
+
++ doi *
+- <call>unit_conversion <star></call>
+
+// === MẶC ĐỊNH ===
++ *
+- Mình chưa hiểu ý bạn lắm. Bạn thử hỏi cách khác nhé! 🤔

data-loader.js

@@ -1,46 +1,46 @@
-// ============================================================
-// data-loader.js — Load dữ liệu JSON cho trình duyệt
-// ============================================================
-
-var SPECIFIC_RESPONSES = {};
-var QA_DATASET = {};
-var ADAPTER_REGISTRY = {};
-var HELP_CONTENT = {};
-
-/**
- * Load tất cả file JSON dữ liệu.
- * Gọi hàm này trước khi khởi tạo app.
- * @returns {Promise<void>}
- */
-async function loadAllData() {
-    var files = [
-        { path: 'data/specific-responses.json', target: 'SPECIFIC_RESPONSES' },
-        { path: 'data/qa-dataset.json', target: 'QA_DATASET' },
-        { path: 'data/adapter-registry.json', target: 'ADAPTER_REGISTRY' },
-        { path: 'data/help-content.json', target: 'HELP_CONTENT' }
-    ];
-
-    var promises = files.map(function (file) {
-        return fetch(file.path)
-            .then(function (res) {
-                if (!res.ok) throw new Error('HTTP ' + res.status + ' loading ' + file.path);
-                return res.json();
-            })
-            .then(function (data) {
-                if (file.target === 'SPECIFIC_RESPONSES') {
-                    Object.assign(SPECIFIC_RESPONSES, data);
-                } else if (file.target === 'QA_DATASET') {
-                    Object.assign(QA_DATASET, data);
-                } else if (file.target === 'ADAPTER_REGISTRY') {
-                    Object.assign(ADAPTER_REGISTRY, data);
-                } else if (file.target === 'HELP_CONTENT') {
-                    Object.assign(HELP_CONTENT, data);
-                }
-            })
-            .catch(function (err) {
-                console.error('Lỗi load data [' + file.path + ']:', err);
-            });
-    });
-
-    await Promise.all(promises);
-}
+// ============================================================
+// data-loader.js — Load dữ liệu JSON cho trình duyệt
+// ============================================================
+
+var SPECIFIC_RESPONSES = {};
+var QA_DATASET = {};
+var ADAPTER_REGISTRY = {};
+var HELP_CONTENT = {};
+
+/**
+ * Load tất cả file JSON dữ liệu.
+ * Gọi hàm này trước khi khởi tạo app.
+ * @returns {Promise<void>}
+ */
+async function loadAllData() {
+    var files = [
+        { path: 'data/specific-responses.json', target: 'SPECIFIC_RESPONSES' },
+        { path: 'data/qa-dataset.json', target: 'QA_DATASET' },
+        { path: 'data/adapter-registry.json', target: 'ADAPTER_REGISTRY' },
+        { path: 'data/help-content.json', target: 'HELP_CONTENT' }
+    ];
+
+    var promises = files.map(function (file) {
+        return fetch(file.path)
+            .then(function (res) {
+                if (!res.ok) throw new Error('HTTP ' + res.status + ' loading ' + file.path);
+                return res.json();
+            })
+            .then(function (data) {
+                if (file.target === 'SPECIFIC_RESPONSES') {
+                    Object.assign(SPECIFIC_RESPONSES, data);
+                } else if (file.target === 'QA_DATASET') {
+                    Object.assign(QA_DATASET, data);
+                } else if (file.target === 'ADAPTER_REGISTRY') {
+                    Object.assign(ADAPTER_REGISTRY, data);
+                } else if (file.target === 'HELP_CONTENT') {
+                    Object.assign(HELP_CONTENT, data);
+                }
+            })
+            .catch(function (err) {
+                console.error('Lỗi load data [' + file.path + ']:', err);
+            });
+    });
+
+    await Promise.all(promises);
+}

data/adapter-registry.json

@@ -1,82 +1,82 @@
-{
-    "best_match": {
-        "name": { "vi": "Best Match", "en": "Best Match", "ja": "ベストマッチ" },
-        "description": {
-            "vi": "So khớp độ tương đồng văn bản để tìm câu trả lời phù hợp nhất từ tập dữ liệu Q&A",
-            "en": "Text similarity matching to find the best answer from Q&A dataset",
-            "ja": "Q&Aデータセットからテキスト類似度マッチングで最適な回答を検索"
-        },
-        "callSyntax": "<call>best_match <star></call>",
-        "active": true
-    },
-    "logic_adapter": {
-        "name": { "vi": "Logic Adapter (Dispatcher)", "en": "Logic Adapter (Dispatcher)", "ja": "ロジックアダプター（ディスパッチャー）" },
-        "description": {
-            "vi": "Điều phối các adapter khác và chọn phản hồi tốt nhất theo độ ưu tiên",
-            "en": "Coordinates other adapters and selects the best response by priority",
-            "ja": "他のアダプターを調整し、優先度に基づいて最適な応答を選択"
-        },
-        "callSyntax": "<call>logic_adapter <star></call>",
-        "active": true
-    },
-    "mathematical_evaluation": {
-        "name": { "vi": "Tính toán", "en": "Math Evaluation", "ja": "数学計算" },
-        "description": {
-            "vi": "Tính toán biểu thức toán học (cộng, trừ, nhân, chia)",
-            "en": "Evaluate mathematical expressions (add, subtract, multiply, divide)",
-            "ja": "数式の計算（足し算、引き算、掛け算、割り算）"
-        },
-        "callSyntax": "<call>mathematical_evaluation <star></call>",
-        "active": true
-    },
-    "specific_response": {
-        "name": { "vi": "Phản hồi cụ thể", "en": "Specific Response", "ja": "特定応答" },
-        "description": {
-            "vi": "Trả về phản hồi chính xác cho các câu hỏi được cấu hình trước (exact match)",
-            "en": "Returns exact responses for pre-configured questions (exact match)",
-            "ja": "事前設定された質問に対する正確な応答を返す（完全一致）"
-        },
-        "callSyntax": "<call>specific_response <star></call>",
-        "active": true
-    },
-    "time_adapter": {
-        "name": { "vi": "Thời gian", "en": "Time", "ja": "時間" },
-        "description": {
-            "vi": "Trả lời câu hỏi về thời gian, ngày tháng, thứ trong tuần",
-            "en": "Answer questions about time, date, and day of the week",
-            "ja": "時間、日付、曜日に関する質問に回答"
-        },
-        "callSyntax": "<call>time_adapter <star></call>",
-        "active": true
-    },
-    "unit_conversion": {
-        "name": { "vi": "Chuyển đổi đơn vị", "en": "Unit Conversion", "ja": "単位変換" },
-        "description": {
-            "vi": "Chuyển đổi đơn vị đo lường (chiều dài, khối lượng, nhiệt độ)",
-            "en": "Convert measurement units (length, mass, temperature)",
-            "ja": "測定単位の変換（長さ、質量、温度）"
-        },
-        "callSyntax": "<call>unit_conversion <star></call>",
-        "active": true
-    },
-    "web_search": {
-        "name": { "vi": "Tìm kiếm Web", "en": "Web Search", "ja": "ウェブ検索" },
-        "description": {
-            "vi": "Tìm kiếm Google và trả về kết quả (cần cấu hình API key)",
-            "en": "Search Google and return results (requires API key configuration)",
-            "ja": "Google検索を実行し結果を返す（APIキーの設定が必要）"
-        },
-        "callSyntax": "<call>web_search <star></call>",
-        "active": true
-    },
-    "llm_adapter": {
-        "name": { "vi": "LLM (WebGPU)", "en": "LLM (WebGPU)", "ja": "LLM（WebGPU）" },
-        "description": {
-            "vi": "Chạy mô hình ngôn ngữ lớn trực tiếp trên trình duyệt qua WebGPU (Qwen3.5)",
-            "en": "Run large language model directly in browser via WebGPU (Qwen3.5)",
-            "ja": "WebGPU経由でブラウザ上で大規模言語モデルを直接実行（Qwen3.5）"
-        },
-        "callSyntax": "<call>llm_adapter <star></call>",
-        "active": true
-    }
-}
+{
+    "best_match": {
+        "name": { "vi": "Best Match", "en": "Best Match", "ja": "ベストマッチ" },
+        "description": {
+            "vi": "So khớp độ tương đồng văn bản để tìm câu trả lời phù hợp nhất từ tập dữ liệu Q&A",
+            "en": "Text similarity matching to find the best answer from Q&A dataset",
+            "ja": "Q&Aデータセットからテキスト類似度マッチングで最適な回答を検索"
+        },
+        "callSyntax": "<call>best_match <star></call>",
+        "active": true
+    },
+    "logic_adapter": {
+        "name": { "vi": "Logic Adapter (Dispatcher)", "en": "Logic Adapter (Dispatcher)", "ja": "ロジックアダプター（ディスパッチャー）" },
+        "description": {
+            "vi": "Điều phối các adapter khác và chọn phản hồi tốt nhất theo độ ưu tiên",
+            "en": "Coordinates other adapters and selects the best response by priority",
+            "ja": "他のアダプターを調整し、優先度に基づいて最適な応答を選択"
+        },
+        "callSyntax": "<call>logic_adapter <star></call>",
+        "active": true
+    },
+    "mathematical_evaluation": {
+        "name": { "vi": "Tính toán", "en": "Math Evaluation", "ja": "数学計算" },
+        "description": {
+            "vi": "Tính toán biểu thức toán học (cộng, trừ, nhân, chia)",
+            "en": "Evaluate mathematical expressions (add, subtract, multiply, divide)",
+            "ja": "数式の計算（足し算、引き算、掛け算、割り算）"
+        },
+        "callSyntax": "<call>mathematical_evaluation <star></call>",
+        "active": true
+    },
+    "specific_response": {
+        "name": { "vi": "Phản hồi cụ thể", "en": "Specific Response", "ja": "特定応答" },
+        "description": {
+            "vi": "Trả về phản hồi chính xác cho các câu hỏi được cấu hình trước (exact match)",
+            "en": "Returns exact responses for pre-configured questions (exact match)",
+            "ja": "事前設定された質問に対する正確な応答を返す（完全一致）"
+        },
+        "callSyntax": "<call>specific_response <star></call>",
+        "active": true
+    },
+    "time_adapter": {
+        "name": { "vi": "Thời gian", "en": "Time", "ja": "時間" },
+        "description": {
+            "vi": "Trả lời câu hỏi về thời gian, ngày tháng, thứ trong tuần",
+            "en": "Answer questions about time, date, and day of the week",
+            "ja": "時間、日付、曜日に関する質問に回答"
+        },
+        "callSyntax": "<call>time_adapter <star></call>",
+        "active": true
+    },
+    "unit_conversion": {
+        "name": { "vi": "Chuyển đổi đơn vị", "en": "Unit Conversion", "ja": "単位変換" },
+        "description": {
+            "vi": "Chuyển đổi đơn vị đo lường (chiều dài, khối lượng, nhiệt độ)",
+            "en": "Convert measurement units (length, mass, temperature)",
+            "ja": "測定単位の変換（長さ、質量、温度）"
+        },
+        "callSyntax": "<call>unit_conversion <star></call>",
+        "active": true
+    },
+    "web_search": {
+        "name": { "vi": "Tìm kiếm Web", "en": "Web Search", "ja": "ウェブ検索" },
+        "description": {
+            "vi": "Tìm kiếm Google và trả về kết quả (cần cấu hình API key)",
+            "en": "Search Google and return results (requires API key configuration)",
+            "ja": "Google検索を実行し結果を返す（APIキーの設定が必要）"
+        },
+        "callSyntax": "<call>web_search <star></call>",
+        "active": true
+    },
+    "llm_adapter": {
+        "name": { "vi": "LLM (WebGPU)", "en": "LLM (WebGPU)", "ja": "LLM（WebGPU）" },
+        "description": {
+            "vi": "Chạy mô hình ngôn ngữ lớn trực tiếp trên trình duyệt qua WebGPU (Qwen3.5)",
+            "en": "Run large language model directly in browser via WebGPU (Qwen3.5)",
+            "ja": "WebGPU経由でブラウザ上で大規模言語モデルを直接実行（Qwen3.5）"
+        },
+        "callSyntax": "<call>llm_adapter <star></call>",
+        "active": true
+    }
+}

data/chat-history-db.js

@@ -1,165 +1,390 @@
-// ============================================================
-// Chat History DB — Lưu trữ lịch sử chat trong IndexedDB
-// Tách riêng để giữ separation of concerns
-// ============================================================
-
-var CHAT_HISTORY_DB_NAME = 'HikariChatHistory';
-var CHAT_HISTORY_DB_VERSION = 1;
-var CHAT_HISTORY_STORE_NAME = 'messages';
-
-/**
- * Mở (hoặc tạo) IndexedDB.
- * @returns {Promise<IDBDatabase>}
- */
-function openChatHistoryDB() {
-    return new Promise(function (resolve, reject) {
-        if (typeof indexedDB === 'undefined') {
-            reject(new Error('IndexedDB not available'));
-            return;
-        }
-        var request = indexedDB.open(CHAT_HISTORY_DB_NAME, CHAT_HISTORY_DB_VERSION);
-        request.onupgradeneeded = function (e) {
-            var db = e.target.result;
-            if (!db.objectStoreNames.contains(CHAT_HISTORY_STORE_NAME)) {
-                var store = db.createObjectStore(CHAT_HISTORY_STORE_NAME, { keyPath: 'id', autoIncrement: true });
-                store.createIndex('timestamp', 'timestamp', { unique: false });
-            }
-        };
-        request.onsuccess = function (e) { resolve(e.target.result); };
-        request.onerror = function (e) { reject(e.target.error); };
-    });
-}
-
-/**
- * Lưu một message vào IndexedDB.
- * @param {string} role - 'user' hoặc 'assistant'
- * @param {string} content - Nội dung message
- * @param {string} [lang] - Ngôn ngữ hiện tại
- * @returns {Promise<number>} ID của record đã lưu
- */
-async function saveChatMessage(role, content, lang) {
-    var db = await openChatHistoryDB();
-    return new Promise(function (resolve, reject) {
-        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readwrite');
-        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
-        var record = {
-            role: role,
-            content: content || '',
-            lang: lang || 'vi',
-            timestamp: Date.now()
-        };
-        var request = store.add(record);
-        request.onsuccess = function (e) { resolve(e.target.result); };
-        request.onerror = function (e) { reject(e.target.error); };
-    });
-}
-
-/**
- * Lấy N message gần nhất từ IndexedDB.
- * @param {number} count - Số lượng message cần lấy
- * @returns {Promise<Array>} Mảng records sắp xếp theo timestamp tăng dần
- */
-async function getRecentMessages(count) {
-    var db = await openChatHistoryDB();
-    return new Promise(function (resolve, reject) {
-        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readonly');
-        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
-        var index = store.index('timestamp');
-        var results = [];
-        var request = index.openCursor(null, 'prev'); // Mới nhất trước
-        request.onsuccess = function (e) {
-            var cursor = e.target.result;
-            if (cursor && results.length < count) {
-                results.push(cursor.value);
-                cursor.continue();
-            } else {
-                resolve(results.reverse()); // Đảo lại: cũ → mới
-            }
-        };
-        request.onerror = function (e) { reject(e.target.error); };
-    });
-}
-
-/**
- * Lấy messages với paging.
- * @param {number} page - Trang (bắt đầu từ 1)
- * @param {number} pageSize - Số message mỗi trang
- * @returns {Promise<{messages: Array, total: number, page: number, totalPages: number}>}
- */
-async function getMessagesPage(page, pageSize) {
-    var db = await openChatHistoryDB();
-    return new Promise(function (resolve, reject) {
-        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readonly');
-        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
-
-        // Đếm tổng
-        var countReq = store.count();
-        countReq.onsuccess = function () {
-            var total = countReq.result;
-            var totalPages = Math.max(1, Math.ceil(total / pageSize));
-            var safePage = Math.min(Math.max(1, page), totalPages);
-
-            // Lấy tất cả theo timestamp desc, rồi slice
-            var index = store.index('timestamp');
-            var all = [];
-            var cursorReq = index.openCursor(null, 'prev');
-            cursorReq.onsuccess = function (e) {
-                var cursor = e.target.result;
-                if (cursor) {
-                    all.push(cursor.value);
-                    cursor.continue();
-                } else {
-                    var start = (safePage - 1) * pageSize;
-                    var slice = all.slice(start, start + pageSize);
-                    resolve({
-                        messages: slice, // Mới nhất trước
-                        total: total,
-                        page: safePage,
-                        totalPages: totalPages
-                    });
-                }
-            };
-            cursorReq.onerror = function (e) { reject(e.target.error); };
-        };
-        countReq.onerror = function (e) { reject(e.target.error); };
-    });
-}
-
-/**
- * Xóa toàn bộ messages trong IndexedDB.
- * @returns {Promise<void>}
- */
-async function clearAllChatMessages() {
-    var db = await openChatHistoryDB();
-    return new Promise(function (resolve, reject) {
-        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readwrite');
-        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
-        var request = store.clear();
-        request.onsuccess = function () { resolve(); };
-        request.onerror = function (e) { reject(e.target.error); };
-    });
-}
-
-/**
- * Đếm tổng số messages trong IndexedDB.
- * @returns {Promise<number>}
- */
-async function countChatMessages() {
-    var db = await openChatHistoryDB();
-    return new Promise(function (resolve, reject) {
-        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readonly');
-        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
-        var request = store.count();
-        request.onsuccess = function () { resolve(request.result); };
-        request.onerror = function (e) { reject(e.target.error); };
-    });
-}
-
-// Node/test: export to globalThis
-if (typeof module !== 'undefined' && module.exports) {
-    globalThis.saveChatMessage = saveChatMessage || function () { return Promise.resolve(0); };
-    globalThis.getRecentMessages = getRecentMessages || function () { return Promise.resolve([]); };
-    globalThis.getMessagesPage = getMessagesPage || function () { return Promise.resolve({ messages: [], total: 0, page: 1, totalPages: 1 }); };
-    globalThis.clearAllChatMessages = clearAllChatMessages || function () { return Promise.resolve(); };
-    globalThis.countChatMessages = countChatMessages || function () { return Promise.resolve(0); };
-}
+// ============================================================
+// Chat History DB — Lưu trữ lịch sử chat trong IndexedDB
+// Tách riêng để giữ separation of concerns
+// ============================================================
+
+var CHAT_HISTORY_DB_NAME = 'HikariChatHistory';
+var CHAT_HISTORY_DB_VERSION = 2; // Tăng lên 2 để thêm store attachments
+var CHAT_HISTORY_STORE_NAME = 'messages';
+var CHAT_ATTACHMENT_STORE_NAME = 'attachments';
+
+/**
+ * Mở (hoặc tạo) IndexedDB.
+ * Migration v1→v2: thêm object store 'attachments'.
+ * @returns {Promise<IDBDatabase>}
+ */
+function openChatHistoryDB() {
+    return new Promise(function (resolve, reject) {
+        if (typeof indexedDB === 'undefined') {
+            reject(new Error('IndexedDB not available'));
+            return;
+        }
+        var request = indexedDB.open(CHAT_HISTORY_DB_NAME, CHAT_HISTORY_DB_VERSION);
+        request.onupgradeneeded = function (e) {
+            var db = e.target.result;
+            // v1: messages store
+            if (!db.objectStoreNames.contains(CHAT_HISTORY_STORE_NAME)) {
+                var store = db.createObjectStore(CHAT_HISTORY_STORE_NAME, { keyPath: 'id', autoIncrement: true });
+                store.createIndex('timestamp', 'timestamp', { unique: false });
+            }
+            // v2: attachments store
+            if (!db.objectStoreNames.contains(CHAT_ATTACHMENT_STORE_NAME)) {
+                var attStore = db.createObjectStore(CHAT_ATTACHMENT_STORE_NAME, { keyPath: 'id', autoIncrement: true });
+                attStore.createIndex('messageId', 'messageId', { unique: false });
+                attStore.createIndex('timestamp', 'timestamp', { unique: false });
+            }
+        };
+        request.onsuccess = function (e) { resolve(e.target.result); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Lưu một message vào IndexedDB.
+ * Nếu có file đính kèm, tự động gọi saveAttachment() sau khi lưu message.
+ * @param {string} role - 'user' hoặc 'assistant'
+ * @param {string} content - Nội dung message
+ * @param {string} [lang] - Ngôn ngữ hiện tại
+ * @param {File} [file] - File đính kèm (tùy chọn)
+ * @returns {Promise<{messageId: number, attachmentId: number|null}>}
+ */
+async function saveChatMessage(role, content, lang, file) {
+    var db = await openChatHistoryDB();
+    var messageId = await new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readwrite');
+        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+        var record = {
+            role: role,
+            content: content || '',
+            lang: lang || 'vi',
+            timestamp: Date.now()
+        };
+        var request = store.add(record);
+        request.onsuccess = function (e) { resolve(e.target.result); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+
+    var attachmentId = null;
+    if (file) {
+        attachmentId = await saveAttachment(messageId, file);
+    }
+
+    // Áp dụng retention policy sau khi lưu
+    var retentionConfig = getRetentionConfig();
+    await applyRetentionPolicy(retentionConfig.mode, retentionConfig.value);
+
+    return { messageId: messageId, attachmentId: attachmentId };
+}
+
+/**
+ * Lưu file đính kèm vào IndexedDB dưới dạng ArrayBuffer.
+ * Dùng ArrayBuffer thay vì base64 để tiết kiệm ~33% dung lượng.
+ * @param {number} messageId - ID của message liên kết
+ * @param {File} file - File object từ input
+ * @returns {Promise<number>} ID của attachment đã lưu
+ */
+async function saveAttachment(messageId, file) {
+    var arrayBuffer = await new Promise(function (resolve, reject) {
+        var reader = new FileReader();
+        reader.onload = function (e) { resolve(e.target.result); };
+        reader.onerror = function () { reject(new Error('FileReader error')); };
+        reader.readAsArrayBuffer(file);
+    });
+
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_ATTACHMENT_STORE_NAME, 'readwrite');
+        var store = tx.objectStore(CHAT_ATTACHMENT_STORE_NAME);
+        var record = {
+            messageId: messageId,
+            fileName: file.name,
+            fileType: file.type,
+            fileSize: file.size,
+            data: arrayBuffer,
+            timestamp: Date.now()
+        };
+        var request = store.add(record);
+        request.onsuccess = function (e) { resolve(e.target.result); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Lấy attachment theo ID.
+ * @param {number} attachmentId
+ * @returns {Promise<object|null>} Record attachment với data (ArrayBuffer)
+ */
+async function getAttachment(attachmentId) {
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_ATTACHMENT_STORE_NAME, 'readonly');
+        var store = tx.objectStore(CHAT_ATTACHMENT_STORE_NAME);
+        var request = store.get(attachmentId);
+        request.onsuccess = function (e) { resolve(e.target.result || null); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Lấy attachment theo messageId.
+ * @param {number} messageId
+ * @returns {Promise<object|null>} Record attachment đầu tiên tìm thấy
+ */
+async function getAttachmentByMessageId(messageId) {
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_ATTACHMENT_STORE_NAME, 'readonly');
+        var store = tx.objectStore(CHAT_ATTACHMENT_STORE_NAME);
+        var index = store.index('messageId');
+        var request = index.get(messageId);
+        request.onsuccess = function (e) { resolve(e.target.result || null); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Chuyển đổi attachment record thành data URL để render trong <img>.
+ * ArrayBuffer → base64 data URL (chỉ dùng khi hiển thị, không lưu base64).
+ * @param {object} attachment - Record từ IndexedDB
+ * @returns {string} Data URL dạng "data:<fileType>;base64,..."
+ */
+function attachmentToDataURL(attachment) {
+    if (!attachment || !attachment.data) return '';
+    var bytes = new Uint8Array(attachment.data);
+    var binary = '';
+    for (var i = 0; i < bytes.byteLength; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    var base64 = btoa(binary);
+    return 'data:' + (attachment.fileType || 'image/png') + ';base64,' + base64;
+}
+
+/**
+ * Xóa toàn bộ attachments trong IndexedDB.
+ * @returns {Promise<void>}
+ */
+async function clearAllAttachments() {
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_ATTACHMENT_STORE_NAME, 'readwrite');
+        var store = tx.objectStore(CHAT_ATTACHMENT_STORE_NAME);
+        var request = store.clear();
+        request.onsuccess = function () { resolve(); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Lấy N message gần nhất từ IndexedDB.
+ * @param {number} count - Số lượng message cần lấy
+ * @returns {Promise<Array>} Mảng records sắp xếp theo timestamp tăng dần
+ */
+async function getRecentMessages(count) {
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readonly');
+        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+        var index = store.index('timestamp');
+        var results = [];
+        var request = index.openCursor(null, 'prev'); // Mới nhất trước
+        request.onsuccess = function (e) {
+            var cursor = e.target.result;
+            if (cursor && results.length < count) {
+                results.push(cursor.value);
+                cursor.continue();
+            } else {
+                resolve(results.reverse()); // Đảo lại: cũ → mới
+            }
+        };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Lấy messages với paging.
+ * @param {number} page - Trang (bắt đầu từ 1)
+ * @param {number} pageSize - Số message mỗi trang
+ * @returns {Promise<{messages: Array, total: number, page: number, totalPages: number}>}
+ */
+async function getMessagesPage(page, pageSize) {
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readonly');
+        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+
+        var countReq = store.count();
+        countReq.onsuccess = function () {
+            var total = countReq.result;
+            var totalPages = Math.max(1, Math.ceil(total / pageSize));
+            var safePage = Math.min(Math.max(1, page), totalPages);
+
+            var index = store.index('timestamp');
+            var all = [];
+            var cursorReq = index.openCursor(null, 'prev');
+            cursorReq.onsuccess = function (e) {
+                var cursor = e.target.result;
+                if (cursor) {
+                    all.push(cursor.value);
+                    cursor.continue();
+                } else {
+                    var start = (safePage - 1) * pageSize;
+                    var slice = all.slice(start, start + pageSize);
+                    resolve({
+                        messages: slice,
+                        total: total,
+                        page: safePage,
+                        totalPages: totalPages
+                    });
+                }
+            };
+            cursorReq.onerror = function (e) { reject(e.target.error); };
+        };
+        countReq.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Xóa toàn bộ messages trong IndexedDB.
+ * @returns {Promise<void>}
+ */
+async function clearAllChatMessages() {
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readwrite');
+        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+        var request = store.clear();
+        request.onsuccess = function () { resolve(); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Đếm tổng số messages trong IndexedDB.
+ * @returns {Promise<number>}
+ */
+async function countChatMessages() {
+    var db = await openChatHistoryDB();
+    return new Promise(function (resolve, reject) {
+        var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readonly');
+        var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+        var request = store.count();
+        request.onsuccess = function () { resolve(request.result); };
+        request.onerror = function (e) { reject(e.target.error); };
+    });
+}
+
+/**
+ * Đọc retention config từ localStorage.
+ * @returns {{mode: string, value: number}}
+ */
+function getRetentionConfig() {
+    try {
+        var raw = localStorage.getItem('hikari_retention_config');
+        if (raw) {
+            var parsed = JSON.parse(raw);
+            if (parsed && parsed.mode && typeof parsed.value === 'number') {
+                return { mode: parsed.mode, value: parsed.value };
+            }
+        }
+    } catch (e) { /* ignore */ }
+    return { mode: 'count', value: 50 };
+}
+
+/**
+ * Lưu retention config vào localStorage và áp dụng ngay.
+ * @param {string} mode - 'count' hoặc 'days'
+ * @param {number} value - Giá trị tương ứng
+ * @returns {Promise<void>}
+ */
+async function setRetentionConfig(mode, value) {
+    localStorage.setItem('hikari_retention_config', JSON.stringify({ mode: mode, value: value }));
+    await applyRetentionPolicy(mode, value);
+}
+
+/**
+ * Áp dụng retention policy để xóa messages cũ.
+ * - mode="count": giữ lại tối đa `value` messages mới nhất, xóa các messages cũ hơn
+ * - mode="days": xóa tất cả messages có timestamp < Date.now() - value * 86400000
+ * @param {string} mode - 'count' hoặc 'days'
+ * @param {number} value - Giá trị tương ứng
+ * @returns {Promise<void>}
+ */
+async function applyRetentionPolicy(mode, value) {
+    var db = await openChatHistoryDB();
+    if (mode === 'count') {
+        // Lấy tất cả IDs theo thứ tự timestamp tăng dần (cũ nhất trước)
+        var allIds = await new Promise(function (resolve, reject) {
+            var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readonly');
+            var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+            var index = store.index('timestamp');
+            var ids = [];
+            var request = index.openCursor(null, 'next'); // cũ nhất trước
+            request.onsuccess = function (e) {
+                var cursor = e.target.result;
+                if (cursor) {
+                    ids.push(cursor.primaryKey);
+                    cursor.continue();
+                } else {
+                    resolve(ids);
+                }
+            };
+            request.onerror = function (e) { reject(e.target.error); };
+        });
+
+        var deleteCount = allIds.length - value;
+        if (deleteCount <= 0) return;
+
+        var idsToDelete = allIds.slice(0, deleteCount);
+        await new Promise(function (resolve, reject) {
+            var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readwrite');
+            var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+            var pending = idsToDelete.length;
+            if (pending === 0) { resolve(); return; }
+            idsToDelete.forEach(function (id) {
+                var req = store.delete(id);
+                req.onsuccess = function () {
+                    pending--;
+                    if (pending === 0) resolve();
+                };
+                req.onerror = function (e) { reject(e.target.error); };
+            });
+        });
+    } else if (mode === 'days') {
+        var cutoff = Date.now() - value * 86400000;
+        await new Promise(function (resolve, reject) {
+            var tx = db.transaction(CHAT_HISTORY_STORE_NAME, 'readwrite');
+            var store = tx.objectStore(CHAT_HISTORY_STORE_NAME);
+            var index = store.index('timestamp');
+            // IDBKeyRange: timestamp < cutoff
+            var range = IDBKeyRange.upperBound(cutoff, true);
+            var request = index.openCursor(range);
+            request.onsuccess = function (e) {
+                var cursor = e.target.result;
+                if (cursor) {
+                    cursor.delete();
+                    cursor.continue();
+                } else {
+                    resolve();
+                }
+            };
+            request.onerror = function (e) { reject(e.target.error); };
+        });
+    }
+}
+
+// Node/test: export to globalThis (stub functions khi IndexedDB không khả dụng)
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.saveChatMessage = function () { return Promise.resolve({ messageId: 0, attachmentId: null }); };
+    globalThis.saveAttachment = function () { return Promise.resolve(0); };
+    globalThis.getAttachment = function () { return Promise.resolve(null); };
+    globalThis.getAttachmentByMessageId = function () { return Promise.resolve(null); };
+    globalThis.attachmentToDataURL = attachmentToDataURL;
+    globalThis.clearAllAttachments = function () { return Promise.resolve(); };
+    globalThis.getRecentMessages = function () { return Promise.resolve([]); };
+    globalThis.getMessagesPage = function () { return Promise.resolve({ messages: [], total: 0, page: 1, totalPages: 1 }); };
+    globalThis.clearAllChatMessages = function () { return Promise.resolve(); };
+    globalThis.countChatMessages = function () { return Promise.resolve(0); };
+    globalThis.getRetentionConfig = function () { return { mode: 'count', value: 50 }; };
+    globalThis.setRetentionConfig = function () { return Promise.resolve(); };
+    globalThis.applyRetentionPolicy = function () { return Promise.resolve(); };
+}

data/help-content.json

@@ -1,134 +1,134 @@
-{
-    "vi": {
-        "title": "📖 Hướng dẫn sử dụng",
-        "sections": [
-            {
-                "icon": "💬",
-                "heading": "Cách chat với Hikari",
-                "items": [
-                    "Gõ tin nhắn vào ô bên dưới rồi nhấn <b>Gửi</b> hoặc phím <b>Enter</b>.",
-                    "Hikari hỗ trợ 3 ngôn ngữ: Tiếng Việt, English, 日本語. Chọn ngôn ngữ ở góc trên bên phải.",
-                    "Bạn có thể hỏi bất cứ điều gì — chào hỏi, kiến thức, tính toán, chuyển đổi đơn vị, xem giờ..."
-                ]
-            },
-            {
-                "icon": "🤖",
-                "heading": "Cách Hikari phản hồi",
-                "items": [
-                    "Hikari so khớp tin nhắn của bạn với các <b>trigger</b> đã được lập trình sẵn.",
-                    "Mỗi phản hồi kèm <b>Confidence</b> (độ tin cậy) cho biết mức độ khớp.",
-                    "<span class=\"help-dot green\"></span> <b>Xanh lá (≥50%)</b>: Hikari tự tin với câu trả lời.",
-                    "<span class=\"help-dot red\"></span> <b>Đỏ (&lt;50%)</b>: Hikari không chắc chắn, sẽ thử hỏi dịch vụ bổ sung."
-                ]
-            },
-            {
-                "icon": "⚡",
-                "heading": "Các lệnh đặc biệt",
-                "items": [
-                    "<span class=\"help-example\">tính 2 + 3</span> — Tính toán biểu thức toán học",
-                    "<span class=\"help-example\">đổi 5 km sang m</span> — Chuyển đổi đơn vị",
-                    "<span class=\"help-example\">mấy giờ</span> — Xem giờ hiện tại",
-                    "<span class=\"help-example\">hôm nay ngày mấy</span> — Xem ngày tháng",
-                    "<span class=\"help-example\">tìm kiếm ...</span> — Tìm câu trả lời phù hợp nhất"
-                ]
-            },
-            {
-                "icon": "📋",
-                "heading": "Mẹo sử dụng",
-                "items": [
-                    "Nhấn nút <b>📋</b> để xem danh sách tất cả câu hỏi Hikari có thể trả lời.",
-                    "Nhấn nút <b>🔧</b> để xem danh sách các chức năng mở rộng (Object Macros).",
-                    "Nếu Hikari không hiểu, hãy thử diễn đạt lại câu hỏi đơn giản hơn."
-                ]
-            }
-        ]
-    },
-    "en": {
-        "title": "📖 User Guide",
-        "sections": [
-            {
-                "icon": "💬",
-                "heading": "How to chat with Hikari",
-                "items": [
-                    "Type your message in the input box below and press <b>Send</b> or hit <b>Enter</b>.",
-                    "Hikari supports 3 languages: Tiếng Việt, English, 日本語. Select from the dropdown in the top right.",
-                    "You can ask anything — greetings, knowledge, math, unit conversion, time..."
-                ]
-            },
-            {
-                "icon": "🤖",
-                "heading": "How Hikari responds",
-                "items": [
-                    "Hikari matches your message against pre-programmed <b>triggers</b>.",
-                    "Each response includes a <b>Confidence</b> score showing how well it matched.",
-                    "<span class=\"help-dot green\"></span> <b>Green (≥50%)</b>: Hikari is confident in the answer.",
-                    "<span class=\"help-dot red\"></span> <b>Red (&lt;50%)</b>: Hikari is unsure and will try a fallback service."
-                ]
-            },
-            {
-                "icon": "⚡",
-                "heading": "Special commands",
-                "items": [
-                    "<span class=\"help-example\">calculate 2 + 3</span> — Evaluate math expressions",
-                    "<span class=\"help-example\">convert 5 km to m</span> — Convert units",
-                    "<span class=\"help-example\">what time is it</span> — Check current time",
-                    "<span class=\"help-example\">what date is it</span> — Check today's date",
-                    "<span class=\"help-example\">search ...</span> — Find the best matching answer"
-                ]
-            },
-            {
-                "icon": "📋",
-                "heading": "Tips",
-                "items": [
-                    "Click <b>📋</b> to see all questions Hikari can answer.",
-                    "Click <b>🔧</b> to see available extended features (Object Macros).",
-                    "If Hikari doesn't understand, try rephrasing your question more simply."
-                ]
-            }
-        ]
-    },
-    "ja": {
-        "title": "📖 使い方ガイド",
-        "sections": [
-            {
-                "icon": "💬",
-                "heading": "ひかりとのチャット方法",
-                "items": [
-                    "下の入力欄にメッセージを入力し、<b>送信</b>ボタンまたは<b>Enter</b>キーを押してください。",
-                    "ひかりは3つの言語に対応：Tiếng Việt、English、日本語。右上のドロップダウンで選択できます。",
-                    "何でも聞いてください — 挨拶、知識、計算、単位変換、時間確認..."
-                ]
-            },
-            {
-                "icon": "🤖",
-                "heading": "ひかりの応答方法",
-                "items": [
-                    "ひかりはメッセージをプログラムされた<b>トリガー</b>と照合します。",
-                    "各応答には一致度を示す<b>Confidence</b>（信頼度）スコアが付きます。",
-                    "<span class=\"help-dot green\"></span> <b>緑（≥50%）</b>：ひかりは回答に自信があります。",
-                    "<span class=\"help-dot red\"></span> <b>赤（&lt;50%）</b>：ひかりは不確かで、フォールバックサービスを試みます。"
-                ]
-            },
-            {
-                "icon": "⚡",
-                "heading": "特別なコマンド",
-                "items": [
-                    "<span class=\"help-example\">計算 2 + 3</span> — 数式を計算",
-                    "<span class=\"help-example\">変換 5 km を m</span> — 単位を変換",
-                    "<span class=\"help-example\">今何時</span> — 現在の時刻を確認",
-                    "<span class=\"help-example\">今日は何日</span> — 今日の日付を確認",
-                    "<span class=\"help-example\">検索 ...</span> — 最適な回答を検索"
-                ]
-            },
-            {
-                "icon": "📋",
-                "heading": "ヒント",
-                "items": [
-                    "<b>📋</b>ボタンでひかりが答えられる質問一覧を表示。",
-                    "<b>🔧</b>ボタンで拡張機能（Object Macros）一覧を表示。",
-                    "ひかりが理解できない場合は、より簡単な表現で質問してみてください。"
-                ]
-            }
-        ]
-    }
-}
+{
+    "vi": {
+        "title": "📖 Hướng dẫn sử dụng",
+        "sections": [
+            {
+                "icon": "💬",
+                "heading": "Cách chat với Hikari",
+                "items": [
+                    "Gõ tin nhắn vào ô bên dưới rồi nhấn <b>Gửi</b> hoặc phím <b>Enter</b>.",
+                    "Hikari hỗ trợ 3 ngôn ngữ: Tiếng Việt, English, 日本語. Chọn ngôn ngữ ở góc trên bên phải.",
+                    "Bạn có thể hỏi bất cứ điều gì — chào hỏi, kiến thức, tính toán, chuyển đổi đơn vị, xem giờ..."
+                ]
+            },
+            {
+                "icon": "🤖",
+                "heading": "Cách Hikari phản hồi",
+                "items": [
+                    "Hikari so khớp tin nhắn của bạn với các <b>trigger</b> đã được lập trình sẵn.",
+                    "Mỗi phản hồi kèm <b>Confidence</b> (độ tin cậy) cho biết mức độ khớp.",
+                    "<span class=\"help-dot green\"></span> <b>Xanh lá (≥50%)</b>: Hikari tự tin với câu trả lời.",
+                    "<span class=\"help-dot red\"></span> <b>Đỏ (&lt;50%)</b>: Hikari không chắc chắn, sẽ thử hỏi dịch vụ bổ sung."
+                ]
+            },
+            {
+                "icon": "⚡",
+                "heading": "Các lệnh đặc biệt",
+                "items": [
+                    "<span class=\"help-example\">tính 2 + 3</span> — Tính toán biểu thức toán học",
+                    "<span class=\"help-example\">đổi 5 km sang m</span> — Chuyển đổi đơn vị",
+                    "<span class=\"help-example\">mấy giờ</span> — Xem giờ hiện tại",
+                    "<span class=\"help-example\">hôm nay ngày mấy</span> — Xem ngày tháng",
+                    "<span class=\"help-example\">tìm kiếm ...</span> — Tìm câu trả lời phù hợp nhất"
+                ]
+            },
+            {
+                "icon": "📋",
+                "heading": "Mẹo sử dụng",
+                "items": [
+                    "Nhấn nút <b>📋</b> để xem danh sách tất cả câu hỏi Hikari có thể trả lời.",
+                    "Nhấn nút <b>🔧</b> để xem danh sách các chức năng mở rộng (Object Macros).",
+                    "Nếu Hikari không hiểu, hãy thử diễn đạt lại câu hỏi đơn giản hơn."
+                ]
+            }
+        ]
+    },
+    "en": {
+        "title": "📖 User Guide",
+        "sections": [
+            {
+                "icon": "💬",
+                "heading": "How to chat with Hikari",
+                "items": [
+                    "Type your message in the input box below and press <b>Send</b> or hit <b>Enter</b>.",
+                    "Hikari supports 3 languages: Tiếng Việt, English, 日本語. Select from the dropdown in the top right.",
+                    "You can ask anything — greetings, knowledge, math, unit conversion, time..."
+                ]
+            },
+            {
+                "icon": "🤖",
+                "heading": "How Hikari responds",
+                "items": [
+                    "Hikari matches your message against pre-programmed <b>triggers</b>.",
+                    "Each response includes a <b>Confidence</b> score showing how well it matched.",
+                    "<span class=\"help-dot green\"></span> <b>Green (≥50%)</b>: Hikari is confident in the answer.",
+                    "<span class=\"help-dot red\"></span> <b>Red (&lt;50%)</b>: Hikari is unsure and will try a fallback service."
+                ]
+            },
+            {
+                "icon": "⚡",
+                "heading": "Special commands",
+                "items": [
+                    "<span class=\"help-example\">calculate 2 + 3</span> — Evaluate math expressions",
+                    "<span class=\"help-example\">convert 5 km to m</span> — Convert units",
+                    "<span class=\"help-example\">what time is it</span> — Check current time",
+                    "<span class=\"help-example\">what date is it</span> — Check today's date",
+                    "<span class=\"help-example\">search ...</span> — Find the best matching answer"
+                ]
+            },
+            {
+                "icon": "📋",
+                "heading": "Tips",
+                "items": [
+                    "Click <b>📋</b> to see all questions Hikari can answer.",
+                    "Click <b>🔧</b> to see available extended features (Object Macros).",
+                    "If Hikari doesn't understand, try rephrasing your question more simply."
+                ]
+            }
+        ]
+    },
+    "ja": {
+        "title": "📖 使い方ガイド",
+        "sections": [
+            {
+                "icon": "💬",
+                "heading": "ひかりとのチャット方法",
+                "items": [
+                    "下の入力欄にメッセージを入力し、<b>送信</b>ボタンまたは<b>Enter</b>キーを押してください。",
+                    "ひかりは3つの言語に対応：Tiếng Việt、English、日本語。右上のドロップダウンで選択できます。",
+                    "何でも聞いてください — 挨拶、知識、計算、単位変換、時間確認..."
+                ]
+            },
+            {
+                "icon": "🤖",
+                "heading": "ひかりの応答方法",
+                "items": [
+                    "ひかりはメッセージをプログラムされた<b>トリガー</b>と照合します。",
+                    "各応答には一致度を示す<b>Confidence</b>（信頼度）スコアが付きます。",
+                    "<span class=\"help-dot green\"></span> <b>緑（≥50%）</b>：ひかりは回答に自信があります。",
+                    "<span class=\"help-dot red\"></span> <b>赤（&lt;50%）</b>：ひかりは不確かで、フォールバックサービスを試みます。"
+                ]
+            },
+            {
+                "icon": "⚡",
+                "heading": "特別なコマンド",
+                "items": [
+                    "<span class=\"help-example\">計算 2 + 3</span> — 数式を計算",
+                    "<span class=\"help-example\">変換 5 km を m</span> — 単位を変換",
+                    "<span class=\"help-example\">今何時</span> — 現在の時刻を確認",
+                    "<span class=\"help-example\">今日は何日</span> — 今日の日付を確認",
+                    "<span class=\"help-example\">検索 ...</span> — 最適な回答を検索"
+                ]
+            },
+            {
+                "icon": "📋",
+                "heading": "ヒント",
+                "items": [
+                    "<b>📋</b>ボタンでひかりが答えられる質問一覧を表示。",
+                    "<b>🔧</b>ボタンで拡張機能（Object Macros）一覧を表示。",
+                    "ひかりが理解できない場合は、より簡単な表現で質問してみてください。"
+                ]
+            }
+        ]
+    }
+}

data/qa-dataset.json

@@ -1,44 +1,44 @@
-{
-    "vi": [
-        { "q": "hikari là gì", "a": "Hikari là chatbot thông minh hỗ trợ đa ngôn ngữ! 🌟" },
-        { "q": "ai tạo ra bạn", "a": "Mình được tạo ra bởi một nhà phát triển đam mê chatbot!" },
-        { "q": "bạn có thể giúp gì", "a": "Mình có thể trò chuyện, tính toán, chuyển đổi đơn vị, xem giờ và tìm câu trả lời cho bạn! 🌟" },
-        { "q": "bạn biết nói mấy ngôn ngữ", "a": "Mình biết nói 3 ngôn ngữ: tiếng Việt, tiếng Anh và tiếng Nhật! 🌍" },
-        { "q": "hikari nghĩa là gì", "a": "Hikari (ひかり) có nghĩa là \"ánh sáng\" trong tiếng Nhật! ✨" },
-        { "q": "bạn bao nhiêu tuổi", "a": "Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung! 😄" },
-        { "q": "bạn thích gì", "a": "Mình thích trò chuyện và giúp đỡ mọi người! 💬" },
-        { "q": "cách sử dụng chatbot", "a": "Bạn chỉ cần gõ tin nhắn và nhấn Gửi. Mình sẽ trả lời ngay! 📝" },
-        { "q": "chatbot là gì", "a": "Chatbot là chương trình máy tính có thể trò chuyện với con người! 🤖" },
-        { "q": "rivescript là gì", "a": "RiveScript là thư viện xử lý hội thoại mà mình sử dụng làm engine! ⚙️" },
-        { "q": "bạn có thông minh không", "a": "Mình cố gắng thông minh nhất có thể để giúp bạn! 🧠" },
-        { "q": "làm sao để đổi ngôn ngữ", "a": "Bạn có thể chọn ngôn ngữ từ menu dropdown ở góc trên bên phải! 🌐" }
-    ],
-    "en": [
-        { "q": "what is hikari", "a": "Hikari is a smart multilingual chatbot! 🌟" },
-        { "q": "who created you", "a": "I was created by a developer passionate about chatbots!" },
-        { "q": "what can you help with", "a": "I can chat, calculate, convert units, tell time, and find answers for you! 🌟" },
-        { "q": "how many languages do you know", "a": "I know 3 languages: Vietnamese, English, and Japanese! 🌍" },
-        { "q": "what does hikari mean", "a": "Hikari (ひかり) means \"light\" in Japanese! ✨" },
-        { "q": "how old are you", "a": "I'm a chatbot so I don't have an age, but I'm always young at heart! 😄" },
-        { "q": "what do you like", "a": "I love chatting and helping people! 💬" },
-        { "q": "how to use this chatbot", "a": "Just type your message and press Send. I will reply right away! 📝" },
-        { "q": "what is a chatbot", "a": "A chatbot is a computer program that can have conversations with humans! 🤖" },
-        { "q": "what is rivescript", "a": "RiveScript is the conversation engine that powers me! ⚙️" },
-        { "q": "are you smart", "a": "I try my best to be as helpful as possible! 🧠" },
-        { "q": "how to change language", "a": "You can select a language from the dropdown menu in the top right corner! 🌐" }
-    ],
-    "ja": [
-        { "q": "ひかりとは何ですか", "a": "ひかりは多言語対応のスマートチャットボットです！🌟" },
-        { "q": "誰が作りましたか", "a": "チャットボットに情熱を持つ開発者が作りました！" },
-        { "q": "何を手伝ってくれますか", "a": "チャット、計算、単位変換、時間確認、回答検索ができます！🌟" },
-        { "q": "いくつの言語を知っていますか", "a": "ベトナム語、英語、日本語の3つの言語を知っています！🌍" },
-        { "q": "ひかりの意味は何ですか", "a": "ひかり（光）は日本語で「light」という意味です！✨" },
-        { "q": "何歳ですか", "a": "チャットボットなので年齢はありませんが、いつも若々しいです！😄" },
-        { "q": "何が好きですか", "a": "チャットして人々を助けることが好きです！💬" },
-        { "q": "チャットボットの使い方", "a": "メッセージを入力して送信ボタンを押すだけです。すぐに返信します！📝" },
-        { "q": "チャットボットとは何ですか", "a": "チャットボットは人間と会話できるコンピュータプログラムです！🤖" },
-        { "q": "rivescriptとは何ですか", "a": "RiveScriptは私を動かす会話エンジンです！⚙️" },
-        { "q": "賢いですか", "a": "できる限りお役に立てるよう頑張っています！🧠" },
-        { "q": "言語を変更する方法", "a": "右上のドロップダウンメニューから言語を選択できます！🌐" }
-    ]
-}
+{
+    "vi": [
+        { "q": "hikari là gì", "a": "Hikari là chatbot thông minh hỗ trợ đa ngôn ngữ! 🌟" },
+        { "q": "ai tạo ra bạn", "a": "Mình được tạo ra bởi một nhà phát triển đam mê chatbot!" },
+        { "q": "bạn có thể giúp gì", "a": "Mình có thể trò chuyện, tính toán, chuyển đổi đơn vị, xem giờ và tìm câu trả lời cho bạn! 🌟" },
+        { "q": "bạn biết nói mấy ngôn ngữ", "a": "Mình biết nói 3 ngôn ngữ: tiếng Việt, tiếng Anh và tiếng Nhật! 🌍" },
+        { "q": "hikari nghĩa là gì", "a": "Hikari (ひかり) có nghĩa là \"ánh sáng\" trong tiếng Nhật! ✨" },
+        { "q": "bạn bao nhiêu tuổi", "a": "Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung! 😄" },
+        { "q": "bạn thích gì", "a": "Mình thích trò chuyện và giúp đỡ mọi người! 💬" },
+        { "q": "cách sử dụng chatbot", "a": "Bạn chỉ cần gõ tin nhắn và nhấn Gửi. Mình sẽ trả lời ngay! 📝" },
+        { "q": "chatbot là gì", "a": "Chatbot là chương trình máy tính có thể trò chuyện với con người! 🤖" },
+        { "q": "rivescript là gì", "a": "RiveScript là thư viện xử lý hội thoại mà mình sử dụng làm engine! ⚙️" },
+        { "q": "bạn có thông minh không", "a": "Mình cố gắng thông minh nhất có thể để giúp bạn! 🧠" },
+        { "q": "làm sao để đổi ngôn ngữ", "a": "Bạn có thể chọn ngôn ngữ từ menu dropdown ở góc trên bên phải! 🌐" }
+    ],
+    "en": [
+        { "q": "what is hikari", "a": "Hikari is a smart multilingual chatbot! 🌟" },
+        { "q": "who created you", "a": "I was created by a developer passionate about chatbots!" },
+        { "q": "what can you help with", "a": "I can chat, calculate, convert units, tell time, and find answers for you! 🌟" },
+        { "q": "how many languages do you know", "a": "I know 3 languages: Vietnamese, English, and Japanese! 🌍" },
+        { "q": "what does hikari mean", "a": "Hikari (ひかり) means \"light\" in Japanese! ✨" },
+        { "q": "how old are you", "a": "I'm a chatbot so I don't have an age, but I'm always young at heart! 😄" },
+        { "q": "what do you like", "a": "I love chatting and helping people! 💬" },
+        { "q": "how to use this chatbot", "a": "Just type your message and press Send. I will reply right away! 📝" },
+        { "q": "what is a chatbot", "a": "A chatbot is a computer program that can have conversations with humans! 🤖" },
+        { "q": "what is rivescript", "a": "RiveScript is the conversation engine that powers me! ⚙️" },
+        { "q": "are you smart", "a": "I try my best to be as helpful as possible! 🧠" },
+        { "q": "how to change language", "a": "You can select a language from the dropdown menu in the top right corner! 🌐" }
+    ],
+    "ja": [
+        { "q": "ひかりとは何ですか", "a": "ひかりは多言語対応のスマートチャットボットです！🌟" },
+        { "q": "誰が作りましたか", "a": "チャットボットに情熱を持つ開発者が作りました！" },
+        { "q": "何を手伝ってくれますか", "a": "チャット、計算、単位変換、時間確認、回答検索ができます！🌟" },
+        { "q": "いくつの言語を知っていますか", "a": "ベトナム語、英語、日本語の3つの言語を知っています！🌍" },
+        { "q": "ひかりの意味は何ですか", "a": "ひかり（光）は日本語で「light」という意味です！✨" },
+        { "q": "何歳ですか", "a": "チャットボットなので年齢はありませんが、いつも若々しいです！😄" },
+        { "q": "何が好きですか", "a": "チャットして人々を助けることが好きです！💬" },
+        { "q": "チャットボットの使い方", "a": "メッセージを入力して送信ボタンを押すだけです。すぐに返信します！📝" },
+        { "q": "チャットボットとは何ですか", "a": "チャットボットは人間と会話できるコンピュータプログラムです！🤖" },
+        { "q": "rivescriptとは何ですか", "a": "RiveScriptは私を動かす会話エンジンです！⚙️" },
+        { "q": "賢いですか", "a": "できる限りお役に立てるよう頑張っています！🧠" },
+        { "q": "言語を変更する方法", "a": "右上のドロップダウンメニューから言語を選択できます！🌐" }
+    ]
+}

data/specific-responses.json

@@ -1,23 +1,23 @@
-{
-    "vi": {
-        "hikari là ai": "Mình là Hikari, chatbot hỗ trợ đa ngôn ngữ! 🌟",
-        "phiên bản": "Hikari phiên bản 1.0 — sử dụng RiveScript engine.",
-        "bạn nói được mấy ngôn ngữ": "Mình hỗ trợ 3 ngôn ngữ: tiếng Việt, tiếng Anh và tiếng Nhật! 🌍",
-        "ai tạo ra hikari": "Hikari được tạo bởi một nhà phát triển đam mê chatbot và AI! 🚀",
-        "hikari có nghĩa là gì": "Hikari (ひかり) có nghĩa là \"ánh sáng\" trong tiếng Nhật! ✨"
-    },
-    "en": {
-        "who is hikari": "I am Hikari, a multilingual chatbot! 🌟",
-        "version": "Hikari version 1.0 — powered by RiveScript engine.",
-        "how many languages do you speak": "I support 3 languages: Vietnamese, English, and Japanese! 🌍",
-        "who created hikari": "Hikari was created by a developer passionate about chatbots and AI! 🚀",
-        "what does hikari mean": "Hikari (ひかり) means \"light\" in Japanese! ✨"
-    },
-    "ja": {
-        "ひかりは誰": "私はひかり、多言語チャットボットです！🌟",
-        "バージョン": "ひかりバージョン1.0 — RiveScriptエンジン搭載。",
-        "いくつの言語を話せますか": "3つの言語に対応しています：ベトナム語、英語、日本語！🌍",
-        "ひかりを作ったのは誰": "ひかりはチャットボットとAIに情熱を持つ開発者が作りました！🚀",
-        "ひかりの意味は何": "ひかり（光）は日本語で「light」という意味です！✨"
-    }
-}
+{
+    "vi": {
+        "hikari là ai": "Mình là Hikari, chatbot hỗ trợ đa ngôn ngữ! 🌟",
+        "phiên bản": "Hikari phiên bản 1.0 — sử dụng RiveScript engine.",
+        "bạn nói được mấy ngôn ngữ": "Mình hỗ trợ 3 ngôn ngữ: tiếng Việt, tiếng Anh và tiếng Nhật! 🌍",
+        "ai tạo ra hikari": "Hikari được tạo bởi một nhà phát triển đam mê chatbot và AI! 🚀",
+        "hikari có nghĩa là gì": "Hikari (ひかり) có nghĩa là \"ánh sáng\" trong tiếng Nhật! ✨"
+    },
+    "en": {
+        "who is hikari": "I am Hikari, a multilingual chatbot! 🌟",
+        "version": "Hikari version 1.0 — powered by RiveScript engine.",
+        "how many languages do you speak": "I support 3 languages: Vietnamese, English, and Japanese! 🌍",
+        "who created hikari": "Hikari was created by a developer passionate about chatbots and AI! 🚀",
+        "what does hikari mean": "Hikari (ひかり) means \"light\" in Japanese! ✨"
+    },
+    "ja": {
+        "ひかりは誰": "私はひかり、多言語チャットボットです！🌟",
+        "バージョン": "ひかりバージョン1.0 — RiveScriptエンジン搭載。",
+        "いくつの言語を話せますか": "3つの言語に対応しています：ベトナム語、英語、日本語！🌍",
+        "ひかりを作ったのは誰": "ひかりはチャットボットとAIに情熱を持つ開発者が作りました！🚀",
+        "ひかりの意味は何": "ひかり（光）は日本語で「light」という意味です！✨"
+    }
+}

index.html

@@ -1,133 +1,186 @@
-<!DOCTYPE html>
-<html lang="vi">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Hikari Chatbot</title>
-    <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🌟</text></svg>">
-    <link rel="stylesheet" href="style.css">
-</head>
-<body>
-    <div class="chat-container">
-        <header class="chat-header">
-            <h1>Hikari</h1>
-            <div class="header-controls">
-                <label class="thinking-toggle" title="Enable/Disable LLM Thinking">
-                    <input type="checkbox" id="thinking-toggle" onchange="if(typeof setLLMThinkingEnabled==='function')setLLMThinkingEnabled(this.checked)">
-                    <span class="thinking-toggle-label">🧠</span>
-                </label>
-                <button id="help-button" title="Hướng dẫn sử dụng">❓</button>
-                <button id="rules-button" title="Xem danh sách rules">📋</button>
-                <button id="macros-button" title="Xem danh sách Object Macros">🔧</button>
-                <button id="settings-button" title="Cài đặt">⚙️</button>
-                <select id="language-selector">
-                    <option value="vi" selected>Tiếng Việt</option>
-                    <option value="en">English</option>
-                    <option value="ja">日本語</option>
-                </select>
-            </div>
-        </header>
-        <div id="rules-panel" class="slide-panel hidden">
-            <div class="slide-panel-header">
-                <h3 id="rules-title">📋 Các câu hỏi Hikari có thể trả lời</h3>
-                <button class="slide-panel-close" onclick="toggleRulesPanel()" aria-label="Đóng">&times;</button>
-            </div>
-            <div class="slide-panel-body">
-                <ul id="rules-list" class="rules-list"></ul>
-            </div>
-        </div>
-        <div id="macros-panel" class="slide-panel hidden">
-            <div class="slide-panel-header">
-                <h3 id="macros-title">🔧 Object Macros (Subroutines)</h3>
-                <button class="slide-panel-close" onclick="toggleMacrosPanel()" aria-label="Đóng">&times;</button>
-            </div>
-            <div class="slide-panel-body">
-                <ul id="macros-list" class="macros-list"></ul>
-            </div>
-        </div>
-        <div id="settings-panel" class="slide-panel hidden">
-            <div class="slide-panel-header">
-                <h3>⚙️ Settings</h3>
-                <button class="slide-panel-close" onclick="toggleSettingsPanel()" aria-label="Đóng">&times;</button>
-            </div>
-            <div class="slide-panel-body settings-body">
-                <div class="setting-item">
-                    <label>
-                        <input type="checkbox" id="history-toggle">
-                        Chat History (gửi lịch sử cho LLM)
-                    </label>
-                </div>
-                <div class="setting-item">
-                    <label>
-                        Max turns:
-                        <input type="number" id="history-max-turns" value="5" min="0" max="50" class="setting-number">
-                    </label>
-                    <span class="setting-hint">0 = không giới hạn</span>
-                </div>
-                <div class="setting-item setting-buttons">
-                    <button id="view-history-button" class="setting-btn">📜 View History</button>
-                    <button id="clear-history-button" class="setting-btn setting-btn-danger">🗑 Clear History</button>
-                </div>
-            </div>
-        </div>
-        <div id="message-display" class="message-display"></div>
-        <div class="input-area">
-            <button id="attach-button" title="Đính kèm ảnh" aria-label="Đính kèm ảnh">📎</button>
-            <input type="file" id="file-input" accept="image/*" class="hidden">
-            <input type="text" id="message-input" placeholder="Nhập tin nhắn...">
-            <button id="send-button">Gửi</button>
-        </div>
-        <div id="attachment-preview" class="attachment-preview hidden">
-            <img id="attachment-thumb" alt="Preview" class="attachment-thumb">
-            <span id="attachment-name" class="attachment-name"></span>
-            <button id="attachment-remove" class="attachment-remove" aria-label="Xóa">&times;</button>
-        </div>
-    </div>
-    <!-- Help Dialog -->
-    <div id="help-overlay" class="help-overlay hidden" role="dialog" aria-modal="true" aria-labelledby="help-dialog-title">
-        <div class="help-dialog">
-            <div class="help-dialog-header">
-                <h2 id="help-dialog-title">📖 Hướng dẫn sử dụng</h2>
-                <button id="help-close-button" class="help-close-button" aria-label="Đóng">&times;</button>
-            </div>
-            <div id="help-dialog-body" class="help-dialog-body">
-                <!-- Nội dung được render bởi JS theo ngôn ngữ -->
-            </div>
-        </div>
-    </div>
-
-    <!-- History Dialog -->
-    <div id="history-overlay" class="help-overlay hidden" role="dialog" aria-modal="true">
-        <div class="help-dialog history-dialog">
-            <div class="help-dialog-header">
-                <h2 id="history-dialog-title">📜 Chat History</h2>
-                <div class="history-tab-buttons">
-                    <button id="history-tab-db" class="history-tab active">IndexedDB</button>
-                    <button id="history-tab-session" class="history-tab">Session</button>
-                </div>
-                <button id="history-close-button" class="help-close-button" aria-label="Đóng">&times;</button>
-            </div>
-            <div id="history-dialog-body" class="help-dialog-body">
-                <div id="history-list" class="history-list"></div>
-                <div id="history-paging" class="history-paging"></div>
-            </div>
-        </div>
-    </div>
-
-    <script src="https://unpkg.com/rivescript@latest/dist/rivescript.min.js"></script>
-    <script src="brain.js"></script>
-    <script src="data-loader.js"></script>
-    <script src="data/chat-history-db.js"></script>
-    <script src="adapters/text-similarity.js"></script>
-    <script src="adapters/specific-response.js"></script>
-    <script src="adapters/time-adapter.js"></script>
-    <script src="adapters/math-adapter.js"></script>
-    <script src="adapters/unit-conversion.js"></script>
-    <script src="adapters/best-match.js"></script>
-    <script src="adapters/logic-dispatcher.js"></script>
-    <script src="adapters/web-search.js"></script>
-    <script src="adapters/llm-adapter.js"></script>
-    <script src="adapters/adapter-registry.js"></script>
-    <script src="app.js"></script>
-</body>
-</html>
+<!DOCTYPE html>
+<html lang="vi">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Hikari Chatbot</title>
+    <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🌟</text></svg>">
+    <link rel="stylesheet" href="style.css">
+</head>
+<body>
+    <div class="chat-container">
+        <header class="chat-header">
+            <h1>Hikari</h1>
+            <div class="header-controls">
+                <span id="interaction-mode-badge" class="interaction-mode-badge" title="Click để đổi chế độ tương tác">📝→📝</span>
+                <label class="thinking-toggle" title="Enable/Disable LLM Thinking">
+                    <input type="checkbox" id="thinking-toggle" onchange="if(typeof setLLMThinkingEnabled==='function')setLLMThinkingEnabled(this.checked)">
+                    <span class="thinking-toggle-label">🧠</span>
+                </label>
+                <button id="help-button" title="Hướng dẫn sử dụng">❓</button>
+                <button id="rules-button" title="Xem danh sách rules">📋</button>
+                <button id="macros-button" title="Xem danh sách Object Macros">🔧</button>
+                <button id="settings-button" title="Cài đặt">⚙️</button>
+                <select id="language-selector">
+                    <option value="vi" selected>Tiếng Việt</option>
+                    <option value="en">English</option>
+                    <option value="ja">日本語</option>
+                </select>
+            </div>
+        </header>
+        <div id="rules-panel" class="slide-panel hidden">
+            <div class="slide-panel-header">
+                <h3 id="rules-title">📋 Các câu hỏi Hikari có thể trả lời</h3>
+                <button class="slide-panel-close" onclick="toggleRulesPanel()" aria-label="Đóng">&times;</button>
+            </div>
+            <div class="slide-panel-body">
+                <ul id="rules-list" class="rules-list"></ul>
+            </div>
+        </div>
+        <div id="macros-panel" class="slide-panel hidden">
+            <div class="slide-panel-header">
+                <h3 id="macros-title">🔧 Object Macros (Subroutines)</h3>
+                <button class="slide-panel-close" onclick="toggleMacrosPanel()" aria-label="Đóng">&times;</button>
+            </div>
+            <div class="slide-panel-body">
+                <ul id="macros-list" class="macros-list"></ul>
+            </div>
+        </div>
+        <div id="settings-panel" class="slide-panel hidden">
+            <div class="slide-panel-header">
+                <h3>⚙️ Settings</h3>
+                <button class="slide-panel-close" onclick="toggleSettingsPanel()" aria-label="Đóng">&times;</button>
+            </div>
+            <div class="slide-panel-body settings-body">
+                <div class="setting-item">
+                    <label>
+                        <input type="checkbox" id="history-toggle">
+                        Chat History (gửi lịch sử cho LLM)
+                    </label>
+                </div>
+                <div class="setting-item">
+                    <label>
+                        Max turns:
+                        <input type="number" id="history-max-turns" value="5" min="0" max="50" class="setting-number">
+                    </label>
+                    <span class="setting-hint">0 = không giới hạn</span>
+                </div>
+                <div class="setting-item setting-buttons">
+                    <button id="view-history-button" class="setting-btn">📜 View History</button>
+                    <button id="clear-history-button" class="setting-btn setting-btn-danger">🗑 Clear History</button>
+                </div>
+                <div class="setting-item">
+                    <label class="setting-label">Giới hạn lưu trữ:</label>
+                    <select id="retention-mode-select" class="setting-select">
+                        <option value="count">Giới hạn số lượng</option>
+                        <option value="days">Giới hạn thời gian</option>
+                    </select>
+                </div>
+                <div id="retention-count-section" class="setting-item">
+                    <label>
+                        Tối đa:
+                        <input type="number" id="retention-max-count" value="50" min="1" max="10000" class="setting-number">
+                    </label>
+                    <span class="setting-hint">hội thoại</span>
+                </div>
+                <div id="retention-days-section" class="setting-item hidden">
+                    <label>
+                        Tối đa:
+                        <input type="number" id="retention-max-days" value="30" min="1" max="3650" class="setting-number">
+                    </label>
+                    <span class="setting-hint">ngày</span>
+                </div>
+                <hr class="setting-divider">
+                <div class="setting-item">
+                    <label class="setting-label">Chế độ tương tác:</label>
+                    <select id="interaction-mode-select" class="setting-select">
+                        <option value="text-text">📝→📝 Text → Text</option>
+                        <option value="text-voice">📝→🔊 Text → Voice</option>
+                        <option value="voice-text">🎤→📝 Voice → Text</option>
+                        <option value="voice-voice">🎤→🔊 Voice → Voice</option>
+                    </select>
+                </div>
+                <div id="tts-settings-section">
+                    <div class="setting-item">
+                        <label>
+                            <input type="checkbox" id="voice-input-toggle">
+                            Voice Input (Speech to Text)
+                        </label>
+                    </div>
+                    <div class="setting-item">
+                        <label>
+                            <input type="checkbox" id="voice-output-toggle">
+                            Voice Output (Text to Speech)
+                        </label>
+                    </div>
+                    <div class="setting-item">
+                        <label class="setting-label">Giọng đọc:</label>
+                        <select id="tts-voice-select" class="setting-select"></select>
+                    </div>
+                </div>
+            </div>
+        </div>
+        <div id="message-display" class="message-display"></div>
+        <div class="input-area">
+            <button id="attach-button" title="Đính kèm ảnh" aria-label="Đính kèm ảnh">📎</button>
+            <input type="file" id="file-input" accept="image/*" class="hidden">
+            <button id="voice-input-button" class="hidden" title="Nhập bằng giọng nói" aria-label="Nhập bằng giọng nói">🎤</button>
+            <div id="adapter-prefix-badge" class="adapter-prefix-badge hidden" aria-live="polite"></div>
+            <input type="text" id="message-input" placeholder="Nhập tin nhắn...">
+            <button id="send-button">Gửi</button>
+        </div>
+        <div id="attachment-preview" class="attachment-preview hidden">
+            <img id="attachment-thumb" alt="Preview" class="attachment-thumb">
+            <span id="attachment-name" class="attachment-name"></span>
+            <button id="attachment-remove" class="attachment-remove" aria-label="Xóa">&times;</button>
+        </div>
+    </div>
+    <!-- Help Dialog -->
+    <div id="help-overlay" class="help-overlay hidden" role="dialog" aria-modal="true" aria-labelledby="help-dialog-title">
+        <div class="help-dialog">
+            <div class="help-dialog-header">
+                <h2 id="help-dialog-title">📖 Hướng dẫn sử dụng</h2>
+                <button id="help-close-button" class="help-close-button" aria-label="Đóng">&times;</button>
+            </div>
+            <div id="help-dialog-body" class="help-dialog-body">
+                <!-- Nội dung được render bởi JS theo ngôn ngữ -->
+            </div>
+        </div>
+    </div>
+
+    <!-- History Dialog -->
+    <div id="history-overlay" class="help-overlay hidden" role="dialog" aria-modal="true">
+        <div class="help-dialog history-dialog">
+            <div class="help-dialog-header">
+                <h2 id="history-dialog-title">📜 Chat History</h2>
+                <div class="history-tab-buttons">
+                    <button id="history-tab-db" class="history-tab active">IndexedDB</button>
+                    <button id="history-tab-session" class="history-tab">Session</button>
+                </div>
+                <button id="history-close-button" class="help-close-button" aria-label="Đóng">&times;</button>
+            </div>
+            <div id="history-dialog-body" class="help-dialog-body">
+                <div id="history-list" class="history-list"></div>
+                <div id="history-paging" class="history-paging"></div>
+            </div>
+        </div>
+    </div>
+
+    <script src="https://unpkg.com/rivescript@latest/dist/rivescript.min.js"></script>
+    <script src="brain.js"></script>
+    <script src="data-loader.js"></script>
+    <script src="data/chat-history-db.js"></script>
+    <script src="adapters/text-similarity.js"></script>
+    <script src="adapters/specific-response.js"></script>
+    <script src="adapters/time-adapter.js"></script>
+    <script src="adapters/math-adapter.js"></script>
+    <script src="adapters/unit-conversion.js"></script>
+    <script src="adapters/best-match.js"></script>
+    <script src="adapters/logic-dispatcher.js"></script>
+    <script src="adapters/web-search.js"></script>
+    <script src="adapters/llm-adapter.js"></script>
+    <script src="adapters/voice-adapter.js"></script>
+    <script src="adapters/adapter-registry.js"></script>
+    <script src="app.js"></script>
+</body>
+</html>

scripts/preprocess.js

@@ -1,280 +1,280 @@
-#!/usr/bin/env node
-// ============================================================
-// scripts/preprocess.js — Tiền xử lý dữ liệu cho text similarity
-//
-// Chạy: node scripts/preprocess.js
-// Output: data/preprocessed.json
-//
-// Script này đọc QA dataset + specific responses + brain .rive files, thực hiện:
-// 1. Tokenize (tách từ)
-// 2. Normalize (lowercase, bỏ dấu tiếng Việt, bỏ punctuation)
-// 3. Tính TF vector cho mỗi câu hỏi
-// 4. Tính synonym group indices cho mỗi từ
-// 5. Tạo IDF (inverse document frequency) cho toàn bộ corpus
-// 6. Tính TF-IDF vector cho mỗi câu hỏi
-// 7. Lưu tất cả vào data/preprocessed.json
-//
-// Khi dữ liệu thay đổi (qa-dataset.json, specific-responses.json, brain/*.rive),
-// chạy lại script này để tạo preprocessed.json mới.
-// ============================================================
-
-var fs = require('fs');
-var path = require('path');
-
-var ROOT = path.join(__dirname, '..');
-var QA_DATASET = JSON.parse(fs.readFileSync(path.join(ROOT, 'data', 'qa-dataset.json'), 'utf8'));
-var SPECIFIC_RESPONSES = JSON.parse(fs.readFileSync(path.join(ROOT, 'data', 'specific-responses.json'), 'utf8'));
-
-// --- Parse brain .rive files to extract trigger-response pairs ---
-var BRAIN_DIR = path.join(ROOT, 'brain');
-
-/**
- * Parse file .rive và trích xuất các cặp trigger-response.
- * Bỏ qua: trigger wildcard mặc định (*), trigger chứa <call>, trigger chỉ có wildcard.
- */
-function parseBrainFile(filePath) {
-    var content = fs.readFileSync(filePath, 'utf8');
-    var lines = content.split('\n');
-    var pairs = [];
-    var currentTrigger = null;
-
-    for (var i = 0; i < lines.length; i++) {
-        var line = lines[i].trim();
-
-        // Skip comments and empty lines
-        if (line.indexOf('//') === 0 || line.length === 0) continue;
-        // Skip directives (! version, ! var)
-        if (line.indexOf('!') === 0) continue;
-
-        if (line.indexOf('+ ') === 0) {
-            currentTrigger = line.substring(2).trim();
-        } else if (line.indexOf('- ') === 0 && currentTrigger) {
-            var response = line.substring(2).trim();
-
-            // Bỏ qua trigger wildcard mặc định
-            if (currentTrigger === '*') { currentTrigger = null; continue; }
-            // Bỏ qua response chứa <call> (adapter calls, không phải text response)
-            if (response.indexOf('<call>') !== -1) { currentTrigger = null; continue; }
-            // Bỏ qua trigger chỉ chứa wildcard (ví dụ: "* la ai")
-            var nonWild = currentTrigger.replace(/\*/g, '').trim();
-            if (nonWild.length < 2) { currentTrigger = null; continue; }
-
-            pairs.push({ trigger: currentTrigger, response: response });
-            currentTrigger = null;
-        }
-    }
-    return pairs;
-}
-
-// --- Vietnamese diacritics removal (copy from app.js) ---
-var VIETNAMESE_DIACRITICS_MAP = {
-    'à':'a','á':'a','ả':'a','ã':'a','ạ':'a',
-    'ă':'a','ằ':'a','ắ':'a','ẳ':'a','ẵ':'a','ặ':'a',
-    'â':'a','ầ':'a','ấ':'a','ẩ':'a','ẫ':'a','ậ':'a',
-    'đ':'d',
-    'è':'e','é':'e','ẻ':'e','ẽ':'e','ẹ':'e',
-    'ê':'e','ề':'e','ế':'e','ể':'e','ễ':'e','ệ':'e',
-    'ì':'i','í':'i','ỉ':'i','ĩ':'i','ị':'i',
-    'ò':'o','ó':'o','ỏ':'o','õ':'o','ọ':'o',
-    'ô':'o','ồ':'o','ố':'o','ổ':'o','ỗ':'o','ộ':'o',
-    'ơ':'o','ờ':'o','ớ':'o','ở':'o','ỡ':'o','ợ':'o',
-    'ù':'u','ú':'u','ủ':'u','ũ':'u','ụ':'u',
-    'ư':'u','ừ':'u','ứ':'u','ử':'u','ữ':'u','ự':'u',
-    'ỳ':'y','ý':'y','ỷ':'y','ỹ':'y','ỵ':'y'
-};
-
-function removeDiacritics(str) {
-    var result = '';
-    for (var i = 0; i < str.length; i++) {
-        var ch = str[i];
-        result += VIETNAMESE_DIACRITICS_MAP[ch] || ch;
-    }
-    return result;
-}
-
-// --- Synonym groups (copy from text-similarity.js) ---
-var SYNONYM_GROUPS = [
-    ['xin chao','chao','hi','hello','hey','yo'],
-    ['tam biet','bye','goodbye','hen gap lai','tot lanh'],
-    ['cam on','thanks','thank','thank you'],
-    ['ten','name','ai','who','la ai'],
-    ['lam gi','lam duoc','co the','giup','help','what can'],
-    ['may gio','gio','time','clock','bao gio'],
-    ['ngay','hom nay','date','today','ngay may'],
-    ['thu','thu may','day','what day'],
-    ['tinh','calculate','math','cong','tru','nhan','chia','plus','minus'],
-    ['doi','convert','sang','to','chuyen doi'],
-    ['chatbot','bot','ai','robot','may','machine'],
-    ['la gi','what is','what','gi','mean'],
-    ['khoe','vui','happy','fine','good','ok'],
-    ['tuoi','age','old','bao nhieu tuoi'],
-    ['o dau','where','dau','location'],
-    ['thich','like','love','yeu'],
-    ['huong dan','cach','how','guide','help','su dung','use']
-];
-
-var synonymLookup = {};
-for (var g = 0; g < SYNONYM_GROUPS.length; g++) {
-    for (var w = 0; w < SYNONYM_GROUPS[g].length; w++) {
-        var word = SYNONYM_GROUPS[g][w].toLowerCase();
-        if (!synonymLookup[word]) synonymLookup[word] = [];
-        synonymLookup[word].push(g);
-    }
-}
-
-// --- Preprocessing functions ---
-
-function tokenize(text, lang) {
-    var s = text.toLowerCase();
-    if (lang === 'vi') s = removeDiacritics(s);
-    s = s.replace(/[?!.,;:"""''`~()[\]{}\\|@#$%^&]/g, ' ');
-    return s.split(/\s+/).filter(function(w) { return w.length > 0; });
-}
-
-function buildTF(tokens) {
-    var tf = {};
-    for (var i = 0; i < tokens.length; i++) {
-        tf[tokens[i]] = (tf[tokens[i]] || 0) + 1;
-    }
-    return tf;
-}
-
-function getSynonymGroupIndices(tokens) {
-    var indices = {};
-    for (var i = 0; i < tokens.length; i++) {
-        var groups = synonymLookup[tokens[i]];
-        if (groups) {
-            for (var j = 0; j < groups.length; j++) {
-                indices[groups[j]] = true;
-            }
-        }
-    }
-    return Object.keys(indices).map(Number);
-}
-
-// --- Build IDF from entire corpus ---
-
-function buildCorpusIDF(allDocs) {
-    var docCount = allDocs.length;
-    var df = {}; // document frequency: word → number of docs containing it
-    for (var d = 0; d < allDocs.length; d++) {
-        var seen = {};
-        for (var t = 0; t < allDocs[d].length; t++) {
-            var word = allDocs[d][t];
-            if (!seen[word]) {
-                df[word] = (df[word] || 0) + 1;
-                seen[word] = true;
-            }
-        }
-    }
-    // IDF = log(N / df) + 1 (smoothed)
-    var idf = {};
-    for (var w in df) {
-        idf[w] = Math.log(docCount / df[w]) + 1;
-    }
-    return idf;
-}
-
-function buildTFIDF(tf, idf) {
-    var tfidf = {};
-    for (var word in tf) {
-        tfidf[word] = tf[word] * (idf[word] || 1);
-    }
-    return tfidf;
-}
-
-function vectorMagnitude(vec) {
-    var sum = 0;
-    for (var k in vec) sum += vec[k] * vec[k];
-    return Math.sqrt(sum);
-}
-
-// --- Main preprocessing ---
-
-console.log('Preprocessing data...');
-
-var output = { version: Date.now(), langs: {} };
-
-var LANGS = ['vi', 'en', 'ja'];
-
-for (var li = 0; li < LANGS.length; li++) {
-    var lang = LANGS[li];
-    console.log('  Processing language:', lang);
-
-    // Collect all statements (QA questions + specific response keys + brain triggers)
-    var statements = [];
-
-    // From QA dataset
-    var qaData = QA_DATASET[lang] || [];
-    for (var qi = 0; qi < qaData.length; qi++) {
-        statements.push({ source: 'qa', index: qi, text: qaData[qi].q, answer: qaData[qi].a });
-    }
-
-    // From specific responses
-    var specData = SPECIFIC_RESPONSES[lang] || {};
-    var specKeys = Object.keys(specData);
-    for (var si = 0; si < specKeys.length; si++) {
-        statements.push({ source: 'specific', index: si, text: specKeys[si], answer: specData[specKeys[si]] });
-    }
-
-    // From brain .rive files (trigger-response pairs)
-    var brainFile = path.join(BRAIN_DIR, lang + '.rive');
-    if (fs.existsSync(brainFile)) {
-        var brainPairs = parseBrainFile(brainFile);
-        var seenTriggers = {};
-        for (var bi = 0; bi < brainPairs.length; bi++) {
-            var trigger = brainPairs[bi].trigger;
-            // Bỏ wildcard suffix/prefix để lấy phần text chính (ví dụ: "xin chao *" → "xin chao")
-            var cleanTrigger = trigger.replace(/\*/g, '').trim();
-            if (cleanTrigger.length < 2) continue;
-            // Dedup: chỉ giữ trigger đầu tiên nếu trùng text
-            if (seenTriggers[cleanTrigger]) continue;
-            seenTriggers[cleanTrigger] = true;
-            statements.push({ source: 'brain', index: bi, text: cleanTrigger, answer: brainPairs[bi].response });
-        }
-        console.log('    Brain triggers:', Object.keys(seenTriggers).length);
-    }
-
-    // Tokenize all statements
-    var allTokens = [];
-    var processed = [];
-    for (var i = 0; i < statements.length; i++) {
-        var stmt = statements[i];
-        var tokens = tokenize(stmt.text, lang);
-        var tf = buildTF(tokens);
-        var synGroups = getSynonymGroupIndices(tokens);
-
-        allTokens.push(tokens);
-        processed.push({
-            source: stmt.source,
-            originalText: stmt.text,
-            answer: stmt.answer,
-            tokens: tokens,
-            tf: tf,
-            synGroups: synGroups
-            // tfidf and magnitude will be added after IDF is computed
-        });
-    }
-
-    // Build IDF from all documents in this language
-    var idf = buildCorpusIDF(allTokens);
-
-    // Compute TF-IDF vectors and magnitudes
-    for (var j = 0; j < processed.length; j++) {
-        processed[j].tfidf = buildTFIDF(processed[j].tf, idf);
-        processed[j].magnitude = vectorMagnitude(processed[j].tfidf);
-    }
-
-    output.langs[lang] = {
-        idf: idf,
-        statements: processed
-    };
-
-    console.log('    Statements:', processed.length, '| Vocab size:', Object.keys(idf).length);
-}
-
-// Write output
-var outputPath = path.join(ROOT, 'data', 'preprocessed.json');
-fs.writeFileSync(outputPath, JSON.stringify(output, null, 2), 'utf8');
-console.log('Done! Output:', outputPath);
-console.log('Version:', output.version);
+#!/usr/bin/env node
+// ============================================================
+// scripts/preprocess.js — Tiền xử lý dữ liệu cho text similarity
+//
+// Chạy: node scripts/preprocess.js
+// Output: data/preprocessed.json
+//
+// Script này đọc QA dataset + specific responses + brain .rive files, thực hiện:
+// 1. Tokenize (tách từ)
+// 2. Normalize (lowercase, bỏ dấu tiếng Việt, bỏ punctuation)
+// 3. Tính TF vector cho mỗi câu hỏi
+// 4. Tính synonym group indices cho mỗi từ
+// 5. Tạo IDF (inverse document frequency) cho toàn bộ corpus
+// 6. Tính TF-IDF vector cho mỗi câu hỏi
+// 7. Lưu tất cả vào data/preprocessed.json
+//
+// Khi dữ liệu thay đổi (qa-dataset.json, specific-responses.json, brain/*.rive),
+// chạy lại script này để tạo preprocessed.json mới.
+// ============================================================
+
+var fs = require('fs');
+var path = require('path');
+
+var ROOT = path.join(__dirname, '..');
+var QA_DATASET = JSON.parse(fs.readFileSync(path.join(ROOT, 'data', 'qa-dataset.json'), 'utf8'));
+var SPECIFIC_RESPONSES = JSON.parse(fs.readFileSync(path.join(ROOT, 'data', 'specific-responses.json'), 'utf8'));
+
+// --- Parse brain .rive files to extract trigger-response pairs ---
+var BRAIN_DIR = path.join(ROOT, 'brain');
+
+/**
+ * Parse file .rive và trích xuất các cặp trigger-response.
+ * Bỏ qua: trigger wildcard mặc định (*), trigger chứa <call>, trigger chỉ có wildcard.
+ */
+function parseBrainFile(filePath) {
+    var content = fs.readFileSync(filePath, 'utf8');
+    var lines = content.split('\n');
+    var pairs = [];
+    var currentTrigger = null;
+
+    for (var i = 0; i < lines.length; i++) {
+        var line = lines[i].trim();
+
+        // Skip comments and empty lines
+        if (line.indexOf('//') === 0 || line.length === 0) continue;
+        // Skip directives (! version, ! var)
+        if (line.indexOf('!') === 0) continue;
+
+        if (line.indexOf('+ ') === 0) {
+            currentTrigger = line.substring(2).trim();
+        } else if (line.indexOf('- ') === 0 && currentTrigger) {
+            var response = line.substring(2).trim();
+
+            // Bỏ qua trigger wildcard mặc định
+            if (currentTrigger === '*') { currentTrigger = null; continue; }
+            // Bỏ qua response chứa <call> (adapter calls, không phải text response)
+            if (response.indexOf('<call>') !== -1) { currentTrigger = null; continue; }
+            // Bỏ qua trigger chỉ chứa wildcard (ví dụ: "* la ai")
+            var nonWild = currentTrigger.replace(/\*/g, '').trim();
+            if (nonWild.length < 2) { currentTrigger = null; continue; }
+
+            pairs.push({ trigger: currentTrigger, response: response });
+            currentTrigger = null;
+        }
+    }
+    return pairs;
+}
+
+// --- Vietnamese diacritics removal (copy from app.js) ---
+var VIETNAMESE_DIACRITICS_MAP = {
+    'à':'a','á':'a','ả':'a','ã':'a','ạ':'a',
+    'ă':'a','ằ':'a','ắ':'a','ẳ':'a','ẵ':'a','ặ':'a',
+    'â':'a','ầ':'a','ấ':'a','ẩ':'a','ẫ':'a','ậ':'a',
+    'đ':'d',
+    'è':'e','é':'e','ẻ':'e','ẽ':'e','ẹ':'e',
+    'ê':'e','ề':'e','ế':'e','ể':'e','ễ':'e','ệ':'e',
+    'ì':'i','í':'i','ỉ':'i','ĩ':'i','ị':'i',
+    'ò':'o','ó':'o','ỏ':'o','õ':'o','ọ':'o',
+    'ô':'o','ồ':'o','ố':'o','ổ':'o','ỗ':'o','ộ':'o',
+    'ơ':'o','ờ':'o','ớ':'o','ở':'o','ỡ':'o','ợ':'o',
+    'ù':'u','ú':'u','ủ':'u','ũ':'u','ụ':'u',
+    'ư':'u','ừ':'u','ứ':'u','ử':'u','ữ':'u','ự':'u',
+    'ỳ':'y','ý':'y','ỷ':'y','ỹ':'y','ỵ':'y'
+};
+
+function removeDiacritics(str) {
+    var result = '';
+    for (var i = 0; i < str.length; i++) {
+        var ch = str[i];
+        result += VIETNAMESE_DIACRITICS_MAP[ch] || ch;
+    }
+    return result;
+}
+
+// --- Synonym groups (copy from text-similarity.js) ---
+var SYNONYM_GROUPS = [
+    ['xin chao','chao','hi','hello','hey','yo'],
+    ['tam biet','bye','goodbye','hen gap lai','tot lanh'],
+    ['cam on','thanks','thank','thank you'],
+    ['ten','name','ai','who','la ai'],
+    ['lam gi','lam duoc','co the','giup','help','what can'],
+    ['may gio','gio','time','clock','bao gio'],
+    ['ngay','hom nay','date','today','ngay may'],
+    ['thu','thu may','day','what day'],
+    ['tinh','calculate','math','cong','tru','nhan','chia','plus','minus'],
+    ['doi','convert','sang','to','chuyen doi'],
+    ['chatbot','bot','ai','robot','may','machine'],
+    ['la gi','what is','what','gi','mean'],
+    ['khoe','vui','happy','fine','good','ok'],
+    ['tuoi','age','old','bao nhieu tuoi'],
+    ['o dau','where','dau','location'],
+    ['thich','like','love','yeu'],
+    ['huong dan','cach','how','guide','help','su dung','use']
+];
+
+var synonymLookup = {};
+for (var g = 0; g < SYNONYM_GROUPS.length; g++) {
+    for (var w = 0; w < SYNONYM_GROUPS[g].length; w++) {
+        var word = SYNONYM_GROUPS[g][w].toLowerCase();
+        if (!synonymLookup[word]) synonymLookup[word] = [];
+        synonymLookup[word].push(g);
+    }
+}
+
+// --- Preprocessing functions ---
+
+function tokenize(text, lang) {
+    var s = text.toLowerCase();
+    if (lang === 'vi') s = removeDiacritics(s);
+    s = s.replace(/[?!.,;:"""''`~()[\]{}\\|@#$%^&]/g, ' ');
+    return s.split(/\s+/).filter(function(w) { return w.length > 0; });
+}
+
+function buildTF(tokens) {
+    var tf = {};
+    for (var i = 0; i < tokens.length; i++) {
+        tf[tokens[i]] = (tf[tokens[i]] || 0) + 1;
+    }
+    return tf;
+}
+
+function getSynonymGroupIndices(tokens) {
+    var indices = {};
+    for (var i = 0; i < tokens.length; i++) {
+        var groups = synonymLookup[tokens[i]];
+        if (groups) {
+            for (var j = 0; j < groups.length; j++) {
+                indices[groups[j]] = true;
+            }
+        }
+    }
+    return Object.keys(indices).map(Number);
+}
+
+// --- Build IDF from entire corpus ---
+
+function buildCorpusIDF(allDocs) {
+    var docCount = allDocs.length;
+    var df = {}; // document frequency: word → number of docs containing it
+    for (var d = 0; d < allDocs.length; d++) {
+        var seen = {};
+        for (var t = 0; t < allDocs[d].length; t++) {
+            var word = allDocs[d][t];
+            if (!seen[word]) {
+                df[word] = (df[word] || 0) + 1;
+                seen[word] = true;
+            }
+        }
+    }
+    // IDF = log(N / df) + 1 (smoothed)
+    var idf = {};
+    for (var w in df) {
+        idf[w] = Math.log(docCount / df[w]) + 1;
+    }
+    return idf;
+}
+
+function buildTFIDF(tf, idf) {
+    var tfidf = {};
+    for (var word in tf) {
+        tfidf[word] = tf[word] * (idf[word] || 1);
+    }
+    return tfidf;
+}
+
+function vectorMagnitude(vec) {
+    var sum = 0;
+    for (var k in vec) sum += vec[k] * vec[k];
+    return Math.sqrt(sum);
+}
+
+// --- Main preprocessing ---
+
+console.log('Preprocessing data...');
+
+var output = { version: Date.now(), langs: {} };
+
+var LANGS = ['vi', 'en', 'ja'];
+
+for (var li = 0; li < LANGS.length; li++) {
+    var lang = LANGS[li];
+    console.log('  Processing language:', lang);
+
+    // Collect all statements (QA questions + specific response keys + brain triggers)
+    var statements = [];
+
+    // From QA dataset
+    var qaData = QA_DATASET[lang] || [];
+    for (var qi = 0; qi < qaData.length; qi++) {
+        statements.push({ source: 'qa', index: qi, text: qaData[qi].q, answer: qaData[qi].a });
+    }
+
+    // From specific responses
+    var specData = SPECIFIC_RESPONSES[lang] || {};
+    var specKeys = Object.keys(specData);
+    for (var si = 0; si < specKeys.length; si++) {
+        statements.push({ source: 'specific', index: si, text: specKeys[si], answer: specData[specKeys[si]] });
+    }
+
+    // From brain .rive files (trigger-response pairs)
+    var brainFile = path.join(BRAIN_DIR, lang + '.rive');
+    if (fs.existsSync(brainFile)) {
+        var brainPairs = parseBrainFile(brainFile);
+        var seenTriggers = {};
+        for (var bi = 0; bi < brainPairs.length; bi++) {
+            var trigger = brainPairs[bi].trigger;
+            // Bỏ wildcard suffix/prefix để lấy phần text chính (ví dụ: "xin chao *" → "xin chao")
+            var cleanTrigger = trigger.replace(/\*/g, '').trim();
+            if (cleanTrigger.length < 2) continue;
+            // Dedup: chỉ giữ trigger đầu tiên nếu trùng text
+            if (seenTriggers[cleanTrigger]) continue;
+            seenTriggers[cleanTrigger] = true;
+            statements.push({ source: 'brain', index: bi, text: cleanTrigger, answer: brainPairs[bi].response });
+        }
+        console.log('    Brain triggers:', Object.keys(seenTriggers).length);
+    }
+
+    // Tokenize all statements
+    var allTokens = [];
+    var processed = [];
+    for (var i = 0; i < statements.length; i++) {
+        var stmt = statements[i];
+        var tokens = tokenize(stmt.text, lang);
+        var tf = buildTF(tokens);
+        var synGroups = getSynonymGroupIndices(tokens);
+
+        allTokens.push(tokens);
+        processed.push({
+            source: stmt.source,
+            originalText: stmt.text,
+            answer: stmt.answer,
+            tokens: tokens,
+            tf: tf,
+            synGroups: synGroups
+            // tfidf and magnitude will be added after IDF is computed
+        });
+    }
+
+    // Build IDF from all documents in this language
+    var idf = buildCorpusIDF(allTokens);
+
+    // Compute TF-IDF vectors and magnitudes
+    for (var j = 0; j < processed.length; j++) {
+        processed[j].tfidf = buildTFIDF(processed[j].tf, idf);
+        processed[j].magnitude = vectorMagnitude(processed[j].tfidf);
+    }
+
+    output.langs[lang] = {
+        idf: idf,
+        statements: processed
+    };
+
+    console.log('    Statements:', processed.length, '| Vocab size:', Object.keys(idf).length);
+}
+
+// Write output
+var outputPath = path.join(ROOT, 'data', 'preprocessed.json');
+fs.writeFileSync(outputPath, JSON.stringify(output, null, 2), 'utf8');
+console.log('Done! Output:', outputPath);
+console.log('Version:', output.version);

style.css

@@ -1,948 +1,1083 @@
-/* === Reset & Base === */
-*, *::before, *::after {
-    box-sizing: border-box;
-    margin: 0;
-    padding: 0;
-}
-
-body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
-    background-color: #f0f2f5;
-    min-height: 100vh;
-    display: flex;
-    justify-content: center;
-    align-items: center;
-    padding: 16px;
-}
-
-/* === Chat Container === */
-.chat-container {
-    width: 100%;
-    max-width: 600px;
-    height: 90vh;
-    background-color: #ffffff;
-    border-radius: 12px;
-    box-shadow: 0 2px 12px rgba(0, 0, 0, 0.1);
-    display: flex;
-    flex-direction: column;
-    overflow: hidden;
-}
-
-/* === Chat Header === */
-.chat-header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: 12px 16px;
-    background-color: #4a90d9;
-    color: #ffffff;
-}
-
-.chat-header h1 {
-    font-size: 1.25rem;
-    font-weight: 600;
-}
-
-.header-controls {
-    display: flex;
-    align-items: center;
-    gap: 8px;
-}
-
-.header-controls button {
-    background: none;
-    border: none;
-    font-size: 1.2rem;
-    cursor: pointer;
-    padding: 4px;
-    border-radius: 4px;
-    transition: background-color 0.2s;
-}
-
-.header-controls button:hover {
-    background-color: rgba(255, 255, 255, 0.2);
-}
-
-#language-selector {
-    padding: 4px 8px;
-    border: 1px solid rgba(255, 255, 255, 0.4);
-    border-radius: 6px;
-    background-color: rgba(255, 255, 255, 0.15);
-    color: #ffffff;
-    font-size: 0.85rem;
-    cursor: pointer;
-}
-
-/* === Thinking Toggle === */
-.thinking-toggle {
-    display: flex;
-    align-items: center;
-    cursor: pointer;
-    gap: 2px;
-}
-
-.thinking-toggle input[type="checkbox"] {
-    display: none;
-}
-
-.thinking-toggle-label {
-    font-size: 1.2rem;
-    opacity: 0.5;
-    transition: opacity 0.2s;
-    padding: 2px 4px;
-    border-radius: 4px;
-}
-
-.thinking-toggle input[type="checkbox"]:checked + .thinking-toggle-label {
-    opacity: 1;
-}
-
-.thinking-toggle:hover .thinking-toggle-label {
-    background-color: rgba(255, 255, 255, 0.2);
-}
-
-/* === Settings Panel === */
-.settings-body {
-    display: flex;
-    flex-direction: column;
-    gap: 10px;
-}
-
-.setting-item {
-    display: flex;
-    flex-direction: column;
-    gap: 3px;
-}
-
-.setting-item label {
-    display: flex;
-    align-items: center;
-    gap: 6px;
-    font-size: 0.85rem;
-    color: #333;
-    cursor: pointer;
-}
-
-.setting-number {
-    width: 60px;
-    padding: 3px 6px;
-    border: 1px solid #ccc;
-    border-radius: 4px;
-    font-size: 0.85rem;
-}
-
-.setting-hint {
-    font-size: 0.75rem;
-    color: #999;
-    margin-left: 2px;
-}
-
-.setting-buttons {
-    flex-direction: row;
-    gap: 8px;
-}
-
-.setting-btn {
-    padding: 5px 12px;
-    font-size: 0.82rem;
-    border: 1px solid #ccc;
-    border-radius: 6px;
-    background: #fff;
-    cursor: pointer;
-    transition: background-color 0.2s;
-}
-
-.setting-btn:hover {
-    background-color: #f0f0f0;
-}
-
-.setting-btn-danger {
-    color: #dc3545;
-    border-color: #dc3545;
-}
-
-.setting-btn-danger:hover {
-    background-color: #dc3545;
-    color: #fff;
-}
-
-/* === History Dialog === */
-.history-dialog {
-    max-width: 600px;
-    max-height: 85vh;
-}
-
-.history-tab-buttons {
-    display: flex;
-    gap: 4px;
-    margin-left: auto;
-    margin-right: 12px;
-}
-
-.history-tab {
-    padding: 3px 10px;
-    font-size: 0.78rem;
-    border: 1px solid rgba(255,255,255,0.4);
-    border-radius: 12px;
-    background: transparent;
-    color: rgba(255,255,255,0.7);
-    cursor: pointer;
-    transition: background-color 0.2s, color 0.2s;
-}
-
-.history-tab.active {
-    background: rgba(255,255,255,0.25);
-    color: #fff;
-}
-
-.history-list {
-    display: flex;
-    flex-direction: column;
-    gap: 8px;
-}
-
-.history-item {
-    padding: 8px 10px;
-    border-radius: 8px;
-    border: 1px solid #e0e0e0;
-}
-
-.history-item-user {
-    background-color: #e3f2fd;
-}
-
-.history-item-assistant {
-    background-color: #f5f5f5;
-}
-
-.history-meta {
-    display: block;
-    font-size: 0.72rem;
-    color: #888;
-    margin-bottom: 3px;
-}
-
-.history-content {
-    display: block;
-    font-size: 0.85rem;
-    color: #333;
-    white-space: pre-wrap;
-    word-wrap: break-word;
-    max-height: 80px;
-    overflow: hidden;
-    text-overflow: ellipsis;
-}
-
-.history-empty {
-    text-align: center;
-    color: #999;
-    font-size: 0.88rem;
-    padding: 20px 0;
-}
-
-.history-paging {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    gap: 10px;
-    padding: 10px 0 0;
-}
-
-.history-page-info {
-    font-size: 0.78rem;
-    color: #888;
-}
-
-.history-page-btn {
-    padding: 4px 12px;
-    font-size: 0.8rem;
-    border: 1px solid #ccc;
-    border-radius: 4px;
-    background: #fff;
-    cursor: pointer;
-}
-
-.history-page-btn:hover {
-    background-color: #f0f0f0;
-}
-
-#language-selector option {
-    color: #333333;
-    background-color: #ffffff;
-}
-
-/* === Slide Panel (Rules & Macros) === */
-.slide-panel {
-    border-bottom: 1px solid #e0e0e0;
-    background-color: #f8f9fa;
-    max-height: 280px;
-    display: flex;
-    flex-direction: column;
-    animation: slideDown 0.2s ease-out;
-}
-
-@keyframes slideDown {
-    from { max-height: 0; opacity: 0; }
-    to { max-height: 280px; opacity: 1; }
-}
-
-.slide-panel-header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: 10px 16px;
-    background-color: #eef2f7;
-    border-bottom: 1px solid #dde3ea;
-    flex-shrink: 0;
-}
-
-.slide-panel-header h3 {
-    font-size: 0.88rem;
-    font-weight: 600;
-    color: #4a90d9;
-    margin: 0;
-}
-
-.slide-panel-close {
-    background: none;
-    border: none;
-    font-size: 1.2rem;
-    color: #888888;
-    cursor: pointer;
-    padding: 0 4px;
-    line-height: 1;
-    border-radius: 4px;
-    transition: color 0.2s, background-color 0.2s;
-}
-
-.slide-panel-close:hover {
-    color: #333333;
-    background-color: rgba(0, 0, 0, 0.08);
-}
-
-.slide-panel-body {
-    overflow-y: auto;
-    padding: 8px 16px 12px;
-    flex: 1;
-}
-
-/* === Rules List === */
-.rules-list {
-    list-style: none;
-    padding: 0;
-    margin: 0;
-    display: flex;
-    flex-wrap: wrap;
-    gap: 6px;
-}
-
-.rules-list li {
-    display: inline-block;
-    padding: 4px 10px;
-    font-size: 0.82rem;
-    color: #4a6785;
-    background-color: #e8eef5;
-    border-radius: 12px;
-    border: 1px solid #d0dae6;
-    cursor: default;
-    transition: background-color 0.15s;
-}
-
-.rules-list li:hover {
-    background-color: #dce4ee;
-}
-
-/* === Macros List === */
-.macros-list {
-    list-style: none;
-    padding: 0;
-    margin: 0;
-    display: flex;
-    flex-direction: column;
-    gap: 8px;
-}
-
-.macro-item {
-    padding: 10px 12px;
-    background-color: #ffffff;
-    border-radius: 8px;
-    border: 1px solid #e0e5ec;
-    transition: box-shadow 0.15s;
-}
-
-.macro-item:hover {
-    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.06);
-}
-
-.macro-item-header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    margin-bottom: 4px;
-}
-
-.macro-item strong {
-    font-size: 0.85rem;
-    color: #333333;
-}
-
-.macro-item-badge {
-    display: inline-block;
-    font-size: 0.68rem;
-    padding: 1px 6px;
-    border-radius: 8px;
-    background-color: #d4edda;
-    color: #28a745;
-    font-weight: 500;
-}
-
-.macro-item p {
-    font-size: 0.8rem;
-    color: #666666;
-    margin: 2px 0 6px;
-    line-height: 1.4;
-}
-
-.macro-call-syntax {
-    display: inline-block;
-    font-family: 'Courier New', Courier, monospace;
-    font-size: 0.76rem;
-    background-color: #f0f0f0;
-    color: #c7254e;
-    padding: 3px 8px;
-    border-radius: 4px;
-    border: 1px solid #e0e0e0;
-}
-
-/* === Message Display === */
-.message-display {
-    flex: 1;
-    overflow-y: auto;
-    padding: 16px;
-    display: flex;
-    flex-direction: column;
-    gap: 10px;
-}
-
-/* === Messages === */
-.message {
-    max-width: 80%;
-    padding: 10px 14px;
-    border-radius: 12px;
-    word-wrap: break-word;
-    line-height: 1.45;
-    font-size: 0.95rem;
-}
-
-.message.user {
-    align-self: flex-end;
-    background-color: #4a90d9;
-    color: #ffffff;
-    border-bottom-right-radius: 4px;
-}
-
-.message.bot {
-    align-self: flex-start;
-    background-color: #e9ecef;
-    color: #333333;
-    border-bottom-left-radius: 4px;
-}
-
-/* === Confidence === */
-.confidence {
-    display: block;
-    font-size: 0.72rem;
-    margin-top: 4px;
-    font-weight: 500;
-}
-
-.confidence-high {
-    color: #28a745;
-}
-
-.confidence-low {
-    color: #dc3545;
-}
-
-/* === Adapter Path Breadcrumb === */
-.adapter-path {
-    display: block;
-    font-size: 0.7rem;
-    margin-top: 2px;
-    color: #8e8e8e;
-    font-style: italic;
-}
-
-/* === Response Time === */
-.response-time {
-    display: block;
-    font-size: 0.68rem;
-    margin-top: 2px;
-    color: #aaaaaa;
-}
-
-/* === Links in bot messages === */
-.message.bot a {
-    color: #4a90d9;
-    text-decoration: underline;
-    word-break: break-all;
-}
-
-.message.bot a:hover {
-    color: #3a7bc8;
-}
-
-/* === Loading Indicator === */
-.loading-indicator {
-    align-self: flex-start;
-    padding: 10px 14px;
-    background-color: #e9ecef;
-    border-radius: 12px;
-    font-size: 0.9rem;
-    color: #888888;
-    animation: pulse 1.2s ease-in-out infinite;
-}
-
-@keyframes pulse {
-    0%, 100% { opacity: 1; }
-    50% { opacity: 0.5; }
-}
-
-/* === Input Area === */
-.input-area {
-    display: flex;
-    padding: 12px 16px;
-    border-top: 1px solid #e0e0e0;
-    background-color: #ffffff;
-    gap: 8px;
-}
-
-.input-area input {
-    flex: 1;
-    padding: 10px 14px;
-    border: 1px solid #cccccc;
-    border-radius: 20px;
-    font-size: 0.95rem;
-    outline: none;
-    transition: border-color 0.2s;
-}
-
-.input-area input:focus {
-    border-color: #4a90d9;
-}
-
-.input-area button {
-    padding: 10px 20px;
-    background-color: #4a90d9;
-    color: #ffffff;
-    border: none;
-    border-radius: 20px;
-    font-size: 0.95rem;
-    cursor: pointer;
-    transition: background-color 0.2s;
-    white-space: nowrap;
-}
-
-.input-area button:hover {
-    background-color: #3a7bc8;
-}
-
-.input-area button:disabled,
-.input-area button.disabled {
-    background-color: #a0bfdf;
-    cursor: not-allowed;
-    opacity: 0.7;
-}
-
-.input-area button:disabled:hover,
-.input-area button.disabled:hover {
-    background-color: #a0bfdf;
-}
-
-/* === LLM Loading Status === */
-.llm-loading-status {
-    align-self: flex-start;
-    padding: 10px 14px;
-    background-color: #fff3cd;
-    border: 1px solid #ffc107;
-    border-radius: 12px;
-    font-size: 0.88rem;
-    color: #856404;
-    animation: pulse 1.5s ease-in-out infinite;
-}
-
-/* === Attachment Preview === */
-.attachment-preview {
-    display: flex;
-    align-items: center;
-    gap: 8px;
-    padding: 6px 16px;
-    background-color: #f8f9fa;
-    border-top: 1px solid #e0e0e0;
-}
-
-.attachment-thumb {
-    width: 40px;
-    height: 40px;
-    object-fit: cover;
-    border-radius: 6px;
-    border: 1px solid #ddd;
-}
-
-.attachment-name {
-    flex: 1;
-    font-size: 0.82rem;
-    color: #555;
-    overflow: hidden;
-    text-overflow: ellipsis;
-    white-space: nowrap;
-}
-
-.attachment-remove {
-    background: none;
-    border: none;
-    font-size: 1.2rem;
-    color: #999;
-    cursor: pointer;
-    padding: 2px 6px;
-    border-radius: 4px;
-    line-height: 1;
-    transition: color 0.2s, background-color 0.2s;
-}
-
-.attachment-remove:hover {
-    color: #dc3545;
-    background-color: rgba(220, 53, 69, 0.1);
-}
-
-/* === Attach Button === */
-#attach-button {
-    background: none;
-    border: none;
-    font-size: 1.3rem;
-    cursor: pointer;
-    padding: 6px;
-    border-radius: 50%;
-    transition: background-color 0.2s;
-    flex-shrink: 0;
-}
-
-#attach-button:hover {
-    background-color: #e9ecef;
-}
-
-/* === Message Image === */
-.message-image {
-    display: block;
-    max-width: 100%;
-    max-height: 200px;
-    border-radius: 8px;
-    margin-bottom: 6px;
-    object-fit: contain;
-}
-
-/* === LLM Cancel Button === */
-.llm-cancel-container {
-    align-self: flex-start;
-    margin-top: 4px;
-}
-
-.llm-cancel-button {
-    display: inline-block;
-    padding: 5px 14px;
-    font-size: 0.82rem;
-    color: #dc3545;
-    background-color: #fff;
-    border: 1px solid #dc3545;
-    border-radius: 16px;
-    cursor: pointer;
-    transition: background-color 0.2s, color 0.2s;
-}
-
-.llm-cancel-button:hover {
-    background-color: #dc3545;
-    color: #fff;
-}
-
-/* === Streaming Message === */
-.message-text {
-    white-space: pre-wrap;
-    word-wrap: break-word;
-}
-
-.message.bot.streaming .message-text {
-    border-right: 2px solid #4a90d9;
-    padding-right: 2px;
-    animation: blink-cursor 0.8s step-end infinite;
-}
-
-@keyframes blink-cursor {
-    50% { border-color: transparent; }
-}
-
-/* === LLM Thinking Block === */
-.llm-thinking-block {
-    background-color: #e8f5e9;
-    border-left: 3px solid #81c784;
-    border-radius: 6px;
-    padding: 8px 10px;
-    margin-bottom: 8px;
-    font-size: 0.84rem;
-    line-height: 1.5;
-    color: #2e7d32;
-}
-
-.llm-thinking-label {
-    display: block;
-    font-weight: 600;
-    font-size: 0.78rem;
-    margin-bottom: 4px;
-    color: #388e3c;
-}
-
-.llm-thinking-content {
-    display: block;
-    white-space: pre-wrap;
-    word-wrap: break-word;
-    color: #1b5e20;
-}
-
-/* === Utility === */
-.hidden {
-    display: none !important;
-}
-
-/* === Responsive — Mobile (max-width: 768px, min-width: 320px) === */
-@media (max-width: 768px) {
-    body {
-        padding: 0;
-        align-items: stretch;
-    }
-
-    .chat-container {
-        max-width: 100%;
-        height: 100vh;
-        border-radius: 0;
-        box-shadow: none;
-    }
-
-    .chat-header {
-        padding: 10px 12px;
-    }
-
-    .chat-header h1 {
-        font-size: 1.1rem;
-    }
-
-    .header-controls {
-        gap: 6px;
-    }
-
-    #language-selector {
-        font-size: 0.8rem;
-        padding: 3px 6px;
-    }
-
-    .message-display {
-        padding: 12px;
-    }
-
-    .message {
-        max-width: 88%;
-        font-size: 0.9rem;
-    }
-
-    .input-area {
-        padding: 10px 12px;
-    }
-
-    .input-area input {
-        padding: 8px 12px;
-        font-size: 0.9rem;
-    }
-
-    .input-area button {
-        padding: 8px 16px;
-        font-size: 0.9rem;
-    }
-
-    .rules-panel,
-    .macros-panel,
-    .slide-panel {
-        max-height: 200px;
-    }
-}
-
-/* === Help Dialog Overlay === */
-.help-overlay {
-    position: fixed;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
-    background-color: rgba(0, 0, 0, 0.5);
-    display: flex;
-    justify-content: center;
-    align-items: center;
-    z-index: 1000;
-    animation: fadeIn 0.2s ease-out;
-}
-
-@keyframes fadeIn {
-    from { opacity: 0; }
-    to { opacity: 1; }
-}
-
-.help-dialog {
-    background-color: #ffffff;
-    border-radius: 12px;
-    width: 90%;
-    max-width: 520px;
-    max-height: 80vh;
-    display: flex;
-    flex-direction: column;
-    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
-    animation: slideUp 0.25s ease-out;
-}
-
-@keyframes slideUp {
-    from { transform: translateY(24px); opacity: 0; }
-    to { transform: translateY(0); opacity: 1; }
-}
-
-.help-dialog-header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: 16px 20px;
-    border-bottom: 1px solid #e0e0e0;
-    background: linear-gradient(135deg, #4a90d9, #5ba3e6);
-    color: #ffffff;
-    border-radius: 12px 12px 0 0;
-}
-
-.help-dialog-header h2 {
-    font-size: 1.05rem;
-    font-weight: 600;
-    margin: 0;
-}
-
-.help-close-button {
-    background: none;
-    border: none;
-    color: #ffffff;
-    font-size: 1.5rem;
-    cursor: pointer;
-    padding: 0 4px;
-    line-height: 1;
-    border-radius: 4px;
-    transition: background-color 0.2s;
-}
-
-.help-close-button:hover {
-    background-color: rgba(255, 255, 255, 0.2);
-}
-
-.help-dialog-body {
-    padding: 20px;
-    overflow-y: auto;
-    font-size: 0.9rem;
-    line-height: 1.6;
-    color: #333333;
-}
-
-.help-section {
-    margin-bottom: 18px;
-    padding-bottom: 16px;
-    border-bottom: 1px solid #f0f0f0;
-}
-
-.help-section:last-child {
-    margin-bottom: 0;
-    padding-bottom: 0;
-    border-bottom: none;
-}
-
-.help-section h3 {
-    font-size: 0.92rem;
-    font-weight: 600;
-    color: #4a90d9;
-    margin-bottom: 8px;
-    display: flex;
-    align-items: center;
-    gap: 6px;
-}
-
-.help-section p {
-    margin: 4px 0;
-    color: #555555;
-}
-
-.help-section ul {
-    list-style: none;
-    padding: 0;
-    margin: 6px 0 0 0;
-}
-
-.help-section li {
-    padding: 4px 0 4px 16px;
-    position: relative;
-    color: #555555;
-}
-
-.help-section li::before {
-    content: '•';
-    position: absolute;
-    left: 4px;
-    color: #4a90d9;
-    font-weight: bold;
-}
-
-.help-example {
-    display: inline-block;
-    background-color: #f0f4f8;
-    color: #4a90d9;
-    padding: 2px 8px;
-    border-radius: 4px;
-    font-size: 0.84rem;
-    font-family: 'Courier New', Courier, monospace;
-}
-
-.help-confidence-demo {
-    display: flex;
-    gap: 12px;
-    margin-top: 8px;
-}
-
-.help-confidence-item {
-    display: flex;
-    align-items: center;
-    gap: 6px;
-    font-size: 0.84rem;
-}
-
-.help-dot {
-    width: 10px;
-    height: 10px;
-    border-radius: 50%;
-    display: inline-block;
-}
-
-.help-dot.green { background-color: #28a745; }
-.help-dot.red { background-color: #dc3545; }
-
-/* === Responsive — Help Dialog Mobile === */
-@media (max-width: 768px) {
-    .help-dialog {
-        width: 95%;
-        max-height: 85vh;
-    }
-
-    .help-dialog-header {
-        padding: 12px 16px;
-    }
-
-    .help-dialog-body {
-        padding: 16px;
-    }
-}
+/* === Reset & Base === */
+*, *::before, *::after {
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0;
+}
+
+body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+    background-color: #f0f2f5;
+    min-height: 100vh;
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    padding: 16px;
+}
+
+/* === Chat Container === */
+.chat-container {
+    width: 100%;
+    max-width: 600px;
+    height: 90vh;
+    background-color: #ffffff;
+    border-radius: 12px;
+    box-shadow: 0 2px 12px rgba(0, 0, 0, 0.1);
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+}
+
+/* === Chat Header === */
+.chat-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 12px 16px;
+    background-color: #4a90d9;
+    color: #ffffff;
+}
+
+.chat-header h1 {
+    font-size: 1.25rem;
+    font-weight: 600;
+}
+
+.header-controls {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+}
+
+.header-controls button {
+    background: none;
+    border: none;
+    font-size: 1.2rem;
+    cursor: pointer;
+    padding: 4px;
+    border-radius: 4px;
+    transition: background-color 0.2s;
+}
+
+.header-controls button:hover {
+    background-color: rgba(255, 255, 255, 0.2);
+}
+
+#language-selector {
+    padding: 4px 8px;
+    border: 1px solid rgba(255, 255, 255, 0.4);
+    border-radius: 6px;
+    background-color: rgba(255, 255, 255, 0.15);
+    color: #ffffff;
+    font-size: 0.85rem;
+    cursor: pointer;
+}
+
+/* === Thinking Toggle === */
+.thinking-toggle {
+    display: flex;
+    align-items: center;
+    cursor: pointer;
+    gap: 2px;
+}
+
+.thinking-toggle input[type="checkbox"] {
+    display: none;
+}
+
+.thinking-toggle-label {
+    font-size: 1.2rem;
+    opacity: 0.5;
+    transition: opacity 0.2s;
+    padding: 2px 4px;
+    border-radius: 4px;
+}
+
+.thinking-toggle input[type="checkbox"]:checked + .thinking-toggle-label {
+    opacity: 1;
+}
+
+.thinking-toggle:hover .thinking-toggle-label {
+    background-color: rgba(255, 255, 255, 0.2);
+}
+
+/* === Settings Panel === */
+.settings-body {
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+}
+
+.setting-item {
+    display: flex;
+    flex-direction: column;
+    gap: 3px;
+}
+
+.setting-item label {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 0.85rem;
+    color: #333;
+    cursor: pointer;
+}
+
+.setting-number {
+    width: 60px;
+    padding: 3px 6px;
+    border: 1px solid #ccc;
+    border-radius: 4px;
+    font-size: 0.85rem;
+}
+
+.setting-hint {
+    font-size: 0.75rem;
+    color: #999;
+    margin-left: 2px;
+}
+
+.setting-buttons {
+    flex-direction: row;
+    gap: 8px;
+}
+
+.setting-btn {
+    padding: 5px 12px;
+    font-size: 0.82rem;
+    border: 1px solid #ccc;
+    border-radius: 6px;
+    background: #fff;
+    cursor: pointer;
+    transition: background-color 0.2s;
+}
+
+.setting-btn:hover {
+    background-color: #f0f0f0;
+}
+
+.setting-btn-danger {
+    color: #dc3545;
+    border-color: #dc3545;
+}
+
+.setting-btn-danger:hover {
+    background-color: #dc3545;
+    color: #fff;
+}
+
+/* === History Dialog === */
+.history-dialog {
+    max-width: 600px;
+    max-height: 85vh;
+}
+
+.history-tab-buttons {
+    display: flex;
+    gap: 4px;
+    margin-left: auto;
+    margin-right: 12px;
+}
+
+.history-tab {
+    padding: 3px 10px;
+    font-size: 0.78rem;
+    border: 1px solid rgba(255,255,255,0.4);
+    border-radius: 12px;
+    background: transparent;
+    color: rgba(255,255,255,0.7);
+    cursor: pointer;
+    transition: background-color 0.2s, color 0.2s;
+}
+
+.history-tab.active {
+    background: rgba(255,255,255,0.25);
+    color: #fff;
+}
+
+.history-list {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.history-item {
+    padding: 8px 10px;
+    border-radius: 8px;
+    border: 1px solid #e0e0e0;
+}
+
+.history-item-user {
+    background-color: #e3f2fd;
+}
+
+.history-item-assistant {
+    background-color: #f5f5f5;
+}
+
+.history-meta {
+    display: block;
+    font-size: 0.72rem;
+    color: #888;
+    margin-bottom: 3px;
+}
+
+.history-content {
+    display: block;
+    font-size: 0.85rem;
+    color: #333;
+    white-space: pre-wrap;
+    word-wrap: break-word;
+    max-height: 80px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.history-empty {
+    text-align: center;
+    color: #999;
+    font-size: 0.88rem;
+    padding: 20px 0;
+}
+
+.history-paging {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 10px;
+    padding: 10px 0 0;
+}
+
+.history-page-info {
+    font-size: 0.78rem;
+    color: #888;
+}
+
+.history-page-btn {
+    padding: 4px 12px;
+    font-size: 0.8rem;
+    border: 1px solid #ccc;
+    border-radius: 4px;
+    background: #fff;
+    cursor: pointer;
+}
+
+.history-page-btn:hover {
+    background-color: #f0f0f0;
+}
+
+#language-selector option {
+    color: #333333;
+    background-color: #ffffff;
+}
+
+/* === Slide Panel (Rules & Macros) === */
+.slide-panel {
+    border-bottom: 1px solid #e0e0e0;
+    background-color: #f8f9fa;
+    max-height: 280px;
+    display: flex;
+    flex-direction: column;
+    animation: slideDown 0.2s ease-out;
+    overflow: hidden; /* Prevent overflow from entire panel */
+}
+
+@keyframes slideDown {
+    from { max-height: 0; opacity: 0; }
+    to { max-height: 280px; opacity: 1; }
+}
+
+.slide-panel-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 10px 16px;
+    background-color: #eef2f7;
+    border-bottom: 1px solid #dde3ea;
+    flex-shrink: 0; /* Prevent header from shrinking */
+}
+
+.slide-panel-body {
+    flex: 1;
+    overflow-y: auto; /* Allow scrolling in body */
+    padding: 12px 16px;
+}
+    flex-shrink: 0;
+}
+
+.slide-panel-header h3 {
+    font-size: 0.88rem;
+    font-weight: 600;
+    color: #4a90d9;
+    margin: 0;
+}
+
+.slide-panel-close {
+    background: none;
+    border: none;
+    font-size: 1.2rem;
+    color: #888888;
+    cursor: pointer;
+    padding: 0 4px;
+    line-height: 1;
+    border-radius: 4px;
+    transition: color 0.2s, background-color 0.2s;
+}
+
+.slide-panel-close:hover {
+    color: #333333;
+    background-color: rgba(0, 0, 0, 0.08);
+}
+
+/* === Rules List === */
+.rules-list {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 6px;
+}
+
+.rules-list li {
+    display: inline-block;
+    padding: 4px 10px;
+    font-size: 0.82rem;
+    color: #4a6785;
+    background-color: #e8eef5;
+    border-radius: 12px;
+    border: 1px solid #d0dae6;
+    cursor: default;
+    transition: background-color 0.15s;
+}
+
+.rules-list li:hover {
+    background-color: #dce4ee;
+}
+
+/* === Macros List === */
+.macros-list {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.macro-item {
+    padding: 10px 12px;
+    background-color: #ffffff;
+    border-radius: 8px;
+    border: 1px solid #e0e5ec;
+    transition: box-shadow 0.15s;
+}
+
+.macro-item:hover {
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.06);
+}
+
+.macro-item-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 4px;
+}
+
+.macro-item strong {
+    font-size: 0.85rem;
+    color: #333333;
+}
+
+.macro-item-badge {
+    display: inline-block;
+    font-size: 0.68rem;
+    padding: 1px 6px;
+    border-radius: 8px;
+    background-color: #d4edda;
+    color: #28a745;
+    font-weight: 500;
+}
+
+.macro-item p {
+    font-size: 0.8rem;
+    color: #666666;
+    margin: 2px 0 6px;
+    line-height: 1.4;
+}
+
+.macro-call-syntax {
+    display: inline-block;
+    font-family: 'Courier New', Courier, monospace;
+    font-size: 0.76rem;
+    background-color: #f0f0f0;
+    color: #c7254e;
+    padding: 3px 8px;
+    border-radius: 4px;
+    border: 1px solid #e0e0e0;
+}
+
+/* Adapter disabled state */
+.macro-item.disabled {
+    opacity: 0.5;
+}
+
+.macro-item.disabled .macro-item-desc,
+.macro-item.disabled .macro-call-syntax {
+    pointer-events: none;
+}
+
+/* Adapter toggle */
+.macro-toggle-label {
+    margin-left: auto;
+    display: flex;
+    align-items: center;
+    cursor: pointer;
+}
+
+.macro-toggle-input {
+    width: 16px;
+    height: 16px;
+    cursor: pointer;
+    accent-color: #4a90e2;
+}
+
+/* === Message Display === */
+.message-display {
+    flex: 1;
+    overflow-y: auto;
+    padding: 16px;
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+}
+
+/* === Messages === */
+.message {
+    max-width: 80%;
+    padding: 10px 14px;
+    border-radius: 12px;
+    word-wrap: break-word;
+    line-height: 1.45;
+    font-size: 0.95rem;
+}
+
+.message.user {
+    align-self: flex-end;
+    background-color: #4a90d9;
+    color: #ffffff;
+    border-bottom-right-radius: 4px;
+}
+
+.message.bot {
+    align-self: flex-start;
+    background-color: #e9ecef;
+    color: #333333;
+    border-bottom-left-radius: 4px;
+}
+
+/* === Confidence === */
+.confidence {
+    display: block;
+    font-size: 0.72rem;
+    margin-top: 4px;
+    font-weight: 500;
+}
+
+.confidence-high {
+    color: #28a745;
+}
+
+.confidence-low {
+    color: #dc3545;
+}
+
+/* === Adapter Path Breadcrumb === */
+.adapter-path {
+    display: block;
+    font-size: 0.7rem;
+    margin-top: 2px;
+    color: #8e8e8e;
+    font-style: italic;
+}
+
+/* === Response Time === */
+.response-time {
+    display: block;
+    font-size: 0.68rem;
+    margin-top: 2px;
+    color: #aaaaaa;
+}
+
+/* === Links in bot messages === */
+.message.bot a {
+    color: #4a90d9;
+    text-decoration: underline;
+    word-break: break-all;
+}
+
+.message.bot a:hover {
+    color: #3a7bc8;
+}
+
+/* === Loading Indicator === */
+.loading-indicator {
+    align-self: flex-start;
+    padding: 10px 14px;
+    background-color: #e9ecef;
+    border-radius: 12px;
+    font-size: 0.9rem;
+    color: #888888;
+    animation: pulse 1.2s ease-in-out infinite;
+}
+
+@keyframes pulse {
+    0%, 100% { opacity: 1; }
+    50% { opacity: 0.5; }
+}
+
+/* === Input Area === */
+.input-area {
+    display: flex;
+    padding: 12px 16px;
+    border-top: 1px solid #e0e0e0;
+    background-color: #ffffff;
+    gap: 8px;
+}
+
+.input-area input {
+    flex: 1;
+    padding: 10px 14px;
+    border: 1px solid #cccccc;
+    border-radius: 20px;
+    font-size: 0.95rem;
+    outline: none;
+    transition: border-color 0.2s;
+}
+
+.input-area input:focus {
+    border-color: #4a90d9;
+}
+
+.input-area button {
+    padding: 10px 20px;
+    background-color: #4a90d9;
+    color: #ffffff;
+    border: none;
+    border-radius: 20px;
+    font-size: 0.95rem;
+    cursor: pointer;
+    transition: background-color 0.2s;
+    white-space: nowrap;
+}
+
+.input-area button:hover {
+    background-color: #3a7bc8;
+}
+
+.input-area button:disabled,
+.input-area button.disabled {
+    background-color: #a0bfdf;
+    cursor: not-allowed;
+    opacity: 0.7;
+}
+
+.input-area button:disabled:hover,
+.input-area button.disabled:hover {
+    background-color: #a0bfdf;
+}
+
+/* === LLM Loading Status === */
+.llm-loading-status {
+    align-self: flex-start;
+    padding: 10px 14px;
+    background-color: #fff3cd;
+    border: 1px solid #ffc107;
+    border-radius: 12px;
+    font-size: 0.88rem;
+    color: #856404;
+    animation: pulse 1.5s ease-in-out infinite;
+}
+
+/* === Attachment Preview === */
+.attachment-preview {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 6px 16px;
+    background-color: #f8f9fa;
+    border-top: 1px solid #e0e0e0;
+}
+
+.attachment-thumb {
+    width: 40px;
+    height: 40px;
+    object-fit: cover;
+    border-radius: 6px;
+    border: 1px solid #ddd;
+}
+
+.attachment-name {
+    flex: 1;
+    font-size: 0.82rem;
+    color: #555;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.attachment-remove {
+    background: none;
+    border: none;
+    font-size: 1.2rem;
+    color: #999;
+    cursor: pointer;
+    padding: 2px 6px;
+    border-radius: 4px;
+    line-height: 1;
+    transition: color 0.2s, background-color 0.2s;
+}
+
+.attachment-remove:hover {
+    color: #dc3545;
+    background-color: rgba(220, 53, 69, 0.1);
+}
+
+/* === Attach Button === */
+#attach-button {
+    background: none;
+    border: none;
+    font-size: 1.3rem;
+    cursor: pointer;
+    padding: 6px;
+    border-radius: 50%;
+    transition: background-color 0.2s;
+    flex-shrink: 0;
+}
+
+#attach-button:hover {
+    background-color: #e9ecef;
+}
+
+/* === Message Image === */
+.message-image {
+    display: block;
+    max-width: 100%;
+    max-height: 200px;
+    border-radius: 8px;
+    margin-bottom: 6px;
+    object-fit: contain;
+}
+
+/* === LLM Cancel Button === */
+.llm-cancel-container {
+    align-self: flex-start;
+    margin-top: 4px;
+}
+
+.llm-cancel-button {
+    display: inline-block;
+    padding: 5px 14px;
+    font-size: 0.82rem;
+    color: #dc3545;
+    background-color: #fff;
+    border: 1px solid #dc3545;
+    border-radius: 16px;
+    cursor: pointer;
+    transition: background-color 0.2s, color 0.2s;
+}
+
+.llm-cancel-button:hover {
+    background-color: #dc3545;
+    color: #fff;
+}
+
+/* === Streaming Message === */
+.message-text {
+    white-space: pre-wrap;
+    word-wrap: break-word;
+}
+
+.message.bot.streaming .message-text {
+    border-right: 2px solid #4a90d9;
+    padding-right: 2px;
+    animation: blink-cursor 0.8s step-end infinite;
+}
+
+@keyframes blink-cursor {
+    50% { border-color: transparent; }
+}
+
+/* === LLM Thinking Block === */
+.llm-thinking-block {
+    background-color: #e8f5e9;
+    border-left: 3px solid #81c784;
+    border-radius: 6px;
+    padding: 8px 10px;
+    margin-bottom: 8px;
+    font-size: 0.84rem;
+    line-height: 1.5;
+    color: #2e7d32;
+}
+
+.llm-thinking-label {
+    display: block;
+    font-weight: 600;
+    font-size: 0.78rem;
+    margin-bottom: 4px;
+    color: #388e3c;
+}
+
+.llm-thinking-content {
+    display: block;
+    white-space: pre-wrap;
+    word-wrap: break-word;
+    color: #1b5e20;
+}
+
+/* === Utility === */
+.hidden {
+    display: none !important;
+}
+
+/* === Responsive — Mobile (max-width: 768px, min-width: 320px) === */
+@media (max-width: 768px) {
+    body {
+        padding: 0;
+        align-items: stretch;
+    }
+
+    .chat-container {
+        max-width: 100%;
+        height: 100vh;
+        border-radius: 0;
+        box-shadow: none;
+    }
+
+    .chat-header {
+        padding: 10px 12px;
+    }
+
+    .chat-header h1 {
+        font-size: 1.1rem;
+    }
+
+    .header-controls {
+        gap: 6px;
+    }
+
+    #language-selector {
+        font-size: 0.8rem;
+        padding: 3px 6px;
+    }
+
+    .message-display {
+        padding: 12px;
+    }
+
+    .message {
+        max-width: 88%;
+        font-size: 0.9rem;
+    }
+
+    .input-area {
+        padding: 10px 12px;
+    }
+
+    .input-area input {
+        padding: 8px 12px;
+        font-size: 0.9rem;
+    }
+
+    .input-area button {
+        padding: 8px 16px;
+        font-size: 0.9rem;
+    }
+
+    .rules-panel,
+    .macros-panel,
+    .slide-panel {
+        max-height: 200px;
+    }
+}
+
+/* === Help Dialog Overlay === */
+.help-overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    background-color: rgba(0, 0, 0, 0.5);
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    z-index: 1000;
+    animation: fadeIn 0.2s ease-out;
+}
+
+@keyframes fadeIn {
+    from { opacity: 0; }
+    to { opacity: 1; }
+}
+
+.help-dialog {
+    background-color: #ffffff;
+    border-radius: 12px;
+    width: 90%;
+    max-width: 520px;
+    max-height: 80vh;
+    display: flex;
+    flex-direction: column;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
+    animation: slideUp 0.25s ease-out;
+}
+
+@keyframes slideUp {
+    from { transform: translateY(24px); opacity: 0; }
+    to { transform: translateY(0); opacity: 1; }
+}
+
+.help-dialog-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 16px 20px;
+    border-bottom: 1px solid #e0e0e0;
+    background: linear-gradient(135deg, #4a90d9, #5ba3e6);
+    color: #ffffff;
+    border-radius: 12px 12px 0 0;
+}
+
+.help-dialog-header h2 {
+    font-size: 1.05rem;
+    font-weight: 600;
+    margin: 0;
+}
+
+.help-close-button {
+    background: none;
+    border: none;
+    color: #ffffff;
+    font-size: 1.5rem;
+    cursor: pointer;
+    padding: 0 4px;
+    line-height: 1;
+    border-radius: 4px;
+    transition: background-color 0.2s;
+}
+
+.help-close-button:hover {
+    background-color: rgba(255, 255, 255, 0.2);
+}
+
+.help-dialog-body {
+    padding: 20px;
+    overflow-y: auto;
+    font-size: 0.9rem;
+    line-height: 1.6;
+    color: #333333;
+}
+
+.help-section {
+    margin-bottom: 18px;
+    padding-bottom: 16px;
+    border-bottom: 1px solid #f0f0f0;
+}
+
+.help-section:last-child {
+    margin-bottom: 0;
+    padding-bottom: 0;
+    border-bottom: none;
+}
+
+.help-section h3 {
+    font-size: 0.92rem;
+    font-weight: 600;
+    color: #4a90d9;
+    margin-bottom: 8px;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+}
+
+.help-section p {
+    margin: 4px 0;
+    color: #555555;
+}
+
+.help-section ul {
+    list-style: none;
+    padding: 0;
+    margin: 6px 0 0 0;
+}
+
+.help-section li {
+    padding: 4px 0 4px 16px;
+    position: relative;
+    color: #555555;
+}
+
+.help-section li::before {
+    content: '•';
+    position: absolute;
+    left: 4px;
+    color: #4a90d9;
+    font-weight: bold;
+}
+
+.help-example {
+    display: inline-block;
+    background-color: #f0f4f8;
+    color: #4a90d9;
+    padding: 2px 8px;
+    border-radius: 4px;
+    font-size: 0.84rem;
+    font-family: 'Courier New', Courier, monospace;
+}
+
+.help-confidence-demo {
+    display: flex;
+    gap: 12px;
+    margin-top: 8px;
+}
+
+.help-confidence-item {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 0.84rem;
+}
+
+.help-dot {
+    width: 10px;
+    height: 10px;
+    border-radius: 50%;
+    display: inline-block;
+}
+
+.help-dot.green { background-color: #28a745; }
+.help-dot.red { background-color: #dc3545; }
+
+/* === Responsive — Help Dialog Mobile === */
+@media (max-width: 768px) {
+    .help-dialog {
+        width: 95%;
+        max-height: 85vh;
+    }
+
+    .help-dialog-header {
+        padding: 12px 16px;
+    }
+
+    .help-dialog-body {
+        padding: 16px;
+    }
+}
+
+/* === Interaction Mode Badge === */
+.interaction-mode-badge {
+    font-size: 0.85rem;
+    padding: 2px 6px;
+    background-color: rgba(255, 255, 255, 0.2);
+    border-radius: 10px;
+    cursor: pointer; /* Clickable */
+    user-select: none;
+    white-space: nowrap;
+    transition: background-color 0.2s ease, transform 0.1s ease;
+}
+
+.interaction-mode-badge:hover {
+    background-color: rgba(255, 255, 255, 0.35);
+    transform: scale(1.05);
+}
+
+.interaction-mode-badge:active {
+    transform: scale(0.95);
+}
+
+/* === Adapter Prefix Badge === */
+.adapter-prefix-badge {
+    display: inline-block;
+    font-size: 0.8rem;
+    padding: 4px 10px;
+    margin-right: 8px;
+    background-color: #e3f2fd;
+    color: #1976d2;
+    border: 1px solid #90caf9;
+    border-radius: 12px;
+    white-space: nowrap;
+    transition: opacity 0.2s;
+}
+
+.adapter-prefix-badge.hidden {
+    display: none;
+}
+
+/* === Voice Input Button === */
+#voice-input-button {
+    background: none;
+    border: none;
+    font-size: 1.2rem;
+    cursor: pointer;
+    padding: 6px 10px;
+    border-radius: 6px;
+    transition: background-color 0.2s, transform 0.1s;
+    flex-shrink: 0;
+}
+
+#voice-input-button:hover {
+    background-color: rgba(74, 144, 217, 0.1);
+}
+
+/* Animation pulse khi đang lắng nghe */
+#voice-input-button.voice-listening {
+    animation: voice-pulse 1s ease-in-out infinite;
+    color: #dc3545;
+}
+
+@keyframes voice-pulse {
+    0%, 100% { transform: scale(1); opacity: 1; }
+    50% { transform: scale(1.2); opacity: 0.7; }
+}
+
+/* === Settings Panel — Voice Controls === */
+.setting-divider {
+    border: none;
+    border-top: 1px solid #e9ecef;
+    margin: 12px 0;
+}
+
+.setting-label {
+    display: block;
+    font-size: 0.85rem;
+    color: #555;
+    margin-bottom: 4px;
+}
+
+.setting-select {
+    width: 100%;
+    padding: 6px 8px;
+    border: 1px solid #ced4da;
+    border-radius: 6px;
+    font-size: 0.85rem;
+    background-color: #fff;
+    cursor: pointer;
+}
+
+.setting-select:focus {
+    outline: none;
+    border-color: #4a90d9;
+    box-shadow: 0 0 0 2px rgba(74, 144, 217, 0.2);
+}
+
+/* === History Attachment Thumbnail === */
+.history-attachment-thumb {
+    display: block;
+    max-width: 80px;
+    max-height: 60px;
+    border-radius: 4px;
+    margin-top: 4px;
+    object-fit: cover;
+    border: 1px solid #dee2e6;
+}