+
高级应用 · 浮窗模式
+
本页嵌入的是「高级应用」小助手，右下角为浮窗入口。高级应用的数据源由第三方接口动态返回，需在 SQLBot 中配置接口 URL 与凭证后方可正常使用。
+
+ 未检测到配置：请编辑 example/config.js，填写 SQLBOT_BASE_URL 和 ADVANCED_ASSISTANT_ID，并在小助手跨域设置中包含本页地址（如 http://localhost:3000）。
+
+
+ 若浮窗未出现：请确认 SQLBot 已启动、跨域包含本页地址，并打开控制台（F12）查看报错。
+
+
+
基础应用 · 浮窗模式
+
本页通过 assistant.js 嵌入小助手，右下角会出现浮窗按钮，点击即可打开对话。数据源由 SQLBot 中配置的「基础应用」数据源列表决定。
+
+ 未检测到配置：请编辑 example/config.js，填写 SQLBOT_BASE_URL（如 http://localhost:5173）和 BASIC_ASSISTANT_ID（小助手应用 ID），保存后刷新本页。并在 SQLBot「小助手应用」中将该小助手的跨域设置包含本页地址（如 http://localhost:3000）。
+
+
+ 若浮窗未出现：请确认 SQLBot 前端已启动（与 config 中地址一致）、小助手跨域设置包含本页地址，并打开浏览器控制台（F12）查看是否有报错或「嵌入失败」提示。
+
+
+
+
基础应用 · 浮窗
+
右下角浮窗按钮，点击后打开对话。
+
打开示例
+
+
+
基础应用 · 全屏
+
整页展示小助手对话界面。
+
打开示例
+
+
+
高级应用 · 浮窗
+
浮窗模式，数据源由第三方接口提供。
+
打开示例
+
+
+
高级应用 · 全屏
+
全屏模式，数据源由第三方接口提供。
+
打开示例
+
+
+ 当前配置（来自 config.js）：
+ SQLBOT_BASE_URL: -
+ BASIC_ASSISTANT_ID: -
+ ADVANCED_ASSISTANT_ID: -
+
+
+
+
+
+
diff --git a/example/server.js b/example/server.js
new file mode 100644
index 00000000..aff8fd45
--- /dev/null
+++ b/example/server.js
@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * 静态文件服务，用于运行小助手嵌入示例
+ * 使用方式：node server.js 或 PORT=8080 node server.js
+ */
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+
+const PORT = parseInt(process.env.PORT, 10) || 3000;
+const ROOT = path.join(__dirname);
+
+const MIME = {
+ '.html': 'text/html; charset=utf-8',
+ '.js': 'application/javascript; charset=utf-8',
+ '.json': 'application/json',
+ '.css': 'text/css',
+ '.ico': 'image/x-icon',
+ '.svg': 'image/svg+xml',
+ '.png': 'image/png',
+ '.jpg': 'image/jpeg',
+ '.woff2': 'font/woff2',
+};
+
+const server = http.createServer((req, res) => {
+ let filePath = path.join(ROOT, req.url === '/' ? 'index.html' : req.url);
+ filePath = path.normalize(filePath);
+ if (!filePath.startsWith(ROOT)) {
+ res.writeHead(403);
+ res.end('Forbidden');
+ return;
+ }
+ fs.readFile(filePath, (err, data) => {
+ if (err) {
+ if (err.code === 'ENOENT') {
+ res.writeHead(404);
+ res.end('Not Found');
+ } else {
+ res.writeHead(500);
+ res.end('Server Error');
+ }
+ return;
+ }
+ const ext = path.extname(filePath);
+ res.setHeader('Content-Type', MIME[ext] || 'application/octet-stream');
+ res.end(data);
+ });
+});
+
+server.listen(PORT, () => {
+ const url = `http://localhost:${PORT}`;
+ console.log('');
+ console.log(' 小助手嵌入示例服务已启动');
+ console.log(' 访问地址: ' + url);
+ console.log('');
+ console.log(' 请在 SQLBot「小助手应用」中将跨域设置包含: ' + url);
+ console.log('');
+});
diff --git a/example/start.bat b/example/start.bat
new file mode 100644
index 00000000..fafdade2
--- /dev/null
+++ b/example/start.bat
@@ -0,0 +1,16 @@
+@echo off
+chcp 65001 >nul
+cd /d "%~dp0"
+where node >nul 2>nul
+if %errorlevel% neq 0 (
+ echo 未检测到 Node.js，请先安装: https://nodejs.org/
+ pause
+ exit /b 1
+)
+if not defined PORT set PORT=3000
+echo.
+echo 启动示例服务 (端口: %PORT%)
+echo 启动后请将 SQLBot 小助手跨域设置包含: http://localhost:%PORT%
+echo.
+node server.js
+pause
diff --git a/example/start.sh b/example/start.sh
new file mode 100755
index 00000000..c8c69db2
--- /dev/null
+++ b/example/start.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+# 一键启动小助手嵌入示例服务（Linux / macOS）
+cd "$(dirname "$0")"
+if ! command -v node >/dev/null 2>&1; then
+ echo "未检测到 Node.js，请先安装: https://nodejs.org/"
+ exit 1
+fi
+export PORT="${PORT:-3000}"
+echo ""
+echo " 启动示例服务 (端口: $PORT)"
+echo " 启动后请将 SQLBot 小助手跨域设置包含: http://localhost:$PORT"
+echo ""
+exec node server.js