🐛 fix(driver): 修复驱动代理校验与 DuckDB 表预览超时

- 校验可选 driver-agent revision，避免重装后复用旧代理
- DuckDB 表预览默认不再追加兜底 ORDER BY
- 优化 DuckDB 超时中断提示并补充回归测试

frontend/src/utils/sql.test.ts

@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest';
+
+import { buildOrderBySQL } from './sql';
+
+describe('buildOrderBySQL', () => {
+  it('does not add fallback ORDER BY for DuckDB without explicit sort', () => {
+    expect(buildOrderBySQL('duckdb', [], ['ID'])).toBe('');
+  });
+
+  it('keeps explicit DuckDB sort', () => {
+    expect(buildOrderBySQL('duckdb', { columnKey: 'ID', order: 'descend' }, ['NAME'])).toBe(' ORDER BY "ID" DESC');
+  });
+});

frontend/src/utils/sql.ts

@@ -150,10 +150,10 @@ export const buildOrderBySQL = (
     return ` ORDER BY ${sortParts.join(', ')}`;
   }
 
-  // MySQL/MariaDB 大表在无显式排序需求时强制 ORDER BY（即使按主键）可能触发 filesort，
-  // 导致 `Error 1038 (HY001): Out of sort memory`。
+  // 部分数据源在无显式排序需求时强制 ORDER BY（即使按主键）会显著放大大表预览成本：
+  // MySQL/MariaDB 可能触发 filesort 和 sort memory 错误，DuckDB 大文件可能被排序拖到连接超时。
   // 因此仅在用户主动点击排序时下发 ORDER BY，默认分页查询不加兜底排序。
-  if (dbTypeLower === 'mysql' || dbTypeLower === 'mariadb' || dbTypeLower === 'oceanbase' || dbTypeLower === 'diros') {
+  if (dbTypeLower === 'mysql' || dbTypeLower === 'mariadb' || dbTypeLower === 'oceanbase' || dbTypeLower === 'diros' || dbTypeLower === 'duckdb') {
     return '';
   }