dsh-db-tool 1.8.0 → 1.8.1

package/client/client.js

@@ -105,6 +105,7 @@ window.__ModuleLoader__.load({
 			urlUser: "用户名（可选，自动注入 URL）",
 			urlPassword: "密码（可选，自动注入 URL；留空保持已存）",
 			fieldsHost: "主机地址",
+			fieldsHostInstance: "主机地址（命名实例填 主机\\实例名，无需端口）",
 			fieldsPort: "端口",
 			fieldsUser: "用户名",
 			fieldsPassword: "密码",
@@ -323,6 +324,7 @@ window.__ModuleLoader__.load({
 			urlUser: "Username (optional, injected into URL)",
 			urlPassword: "Password (optional, injected into URL; blank keeps saved)",
 			fieldsHost: "Host",
+			fieldsHostInstance: "Host (named instance: host\\instance, no port needed)",
 			fieldsPort: "Port",
 			fieldsUser: "User",
 			fieldsPassword: "Password",
@@ -1251,7 +1253,7 @@ window.__ModuleLoader__.load({
 			mongodb: { host: "127.0.0.1", port: 27017, database: "test" },
 			oracle: { host: "127.0.0.1", port: 1521, user: "system" },
 			dmdb: { host: "127.0.0.1", port: 5236, user: "SYSDBA" },
-			sqlserver: { host: "127.0.0.1", port: 1433, user: "sa" },
+			sqlserver: { host: "127.0.0.1", user: "sa" },
 		};
 
 		/**
@@ -1268,6 +1270,24 @@ window.__ModuleLoader__.load({
 			return next;
 		}
 
+		/** URL→分字段的字段反解：只取可信部分。safeUrl 仅脱敏密码段（用户名/主机/端口为真值），
+		 *  密码不可反解——留空走编辑语义，clearUrl 时由服务端迁移 URL 内嵌密码。非法 URL 返回 null。 */
+		function urlToFieldsPatch(url) {
+			if (!url) return null;
+			try {
+				const u = new URL(url);
+				const decoded = (s) => { try { return decodeURIComponent(s); } catch { return s; } };
+				return {
+					host: u.hostname,
+					port: u.port,
+					user: decoded(u.username),
+					database: decoded(u.pathname.replace(/^\//, "")),
+				};
+			} catch {
+				return null;
+			}
+		}
+
 		/** 新建表单初始态：分字段模式 + 当前 kind 的官方默认值 */
 		const freshForm = () => withKindDefaults({ ...EMPTY_FORM, mode: "fields" });
 
@@ -1322,12 +1342,20 @@ window.__ModuleLoader__.load({
 				setDirty(new Set());
 				setDraftTest(null);
 			}
-			/** 从 URL 模式切回分字段：保留表单里已有值（编辑回填场景），只对空字段补官方默认值 */
+			/** 从 URL 模式切回分字段：表单已有值保留；空字段先从已填 URL 反解真实值，仍空的才补官方默认值——
+			 *  直接补默认会把 URL 里的真实主机/端口悄悄换成 127.0.0.1/1433（丢端口 bug）。 */
 			function reenterFields() {
 				setForm((prev) => {
 					const keep = new Set(dirty);
 					for (const k of ["host", "port", "user", "database"]) if (prev[k]) keep.add(k);
-					return withKindDefaults(Object.assign({}, prev, { mode: "fields" }), keep);
+					const next = Object.assign({}, prev, { mode: "fields" });
+					const fromUrl = urlToFieldsPatch(prev.url);
+					if (fromUrl) {
+						for (const k of ["host", "port", "user", "database"]) {
+							if (!prev[k] && fromUrl[k]) { next[k] = fromUrl[k]; keep.add(k); }
+						}
+					}
+					return withKindDefaults(next, keep);
 				});
 				setDraftTest(null);
 			}
@@ -1348,7 +1376,8 @@ window.__ModuleLoader__.load({
 					if (up) body.urlPassword = up;
 				} else {
 					body.fields = { host: form.host, user: form.user, database: form.database || undefined };
-					if (form.port) body.fields.port = Number(form.port);
+					// 端口原样发字符串：Number("abc")=NaN 会被 JSON 序列化成 null，服务端按「未提供端口」静默回退默认值，配置错误被掩盖
+					if (form.port) body.fields.port = form.port;
 					if (form.password) body.fields.password = form.password;
 					// 从 url 方式切到分字段保存 → 服务端清除已存 url（否则连接仍走旧 url）
 					if (props.initial && props.initial.mode === "url") body.clearUrl = true;
@@ -1406,7 +1435,8 @@ window.__ModuleLoader__.load({
 						"div",
 						{ style: { display: "flex", flexDirection: "column", gap: 6 } },
 						React.createElement("div", { className: "dbt-row" },
-							React.createElement("input", { placeholder: t("fieldsHost"), "aria-label": t("fieldsHost") + t("requiredMark"), "aria-required": "true", ref: firstInputRef, value: form.host, onChange: (e) => patch({ host: e.target.value }) }),
+							// sqlserver：官方模型 port 可选（默认 1433）且与命名实例互斥——host 直接填 主机\实例名，端口留空
+							React.createElement("input", { placeholder: form.kind === "sqlserver" ? t("fieldsHostInstance") : t("fieldsHost"), "aria-label": t("fieldsHost") + t("requiredMark"), "aria-required": "true", ref: firstInputRef, value: form.host, onChange: (e) => patch({ host: e.target.value }) }),
 							React.createElement("input", { placeholder: t("fieldsPort"), "aria-label": t("fieldsPort"), value: form.port, onChange: (e) => patch({ port: e.target.value }) }),
 							React.createElement("input", { placeholder: t("fieldsDatabase"), "aria-label": t("fieldsDatabase"), value: form.database, onChange: (e) => patch({ database: e.target.value }) })),
 						React.createElement("div", { className: "dbt-row" },
@@ -3685,6 +3715,7 @@ window.__ModuleLoader__.load({
 			sortRows, slicePage, ResultSetGrid,
 			classifyHead, ConsoleView,
 			Panel, TransferView, TransferLogView,
+			urlToFieldsPatch,
 		};
 		return module.exports;
 	},

package/dist/adapters/dmdb/index.js

@@ -20,6 +20,7 @@
  */
 import db from 'dmdb';
 import { sqlHead, SQL_READ_HEADS } from '../../guard/index.js';
+import { validPort } from '../sql-shared/common.js';
 const ROWS_MAX = 500;
 const CELL_TRUNC = 1000;
 const DDL_KEYWORDS = new Set([
@@ -69,6 +70,10 @@ export function resolveDmConn(conn) {
             throw new Error('DM URL 应以 dm:// 开头，如 dm://user:pass@host:5236');
         }
         const u = new URL(conn.url);
+        // 端口段校验：'dm://host:0' 等非法值抛中文错误，不再透传驱动报晦涩的 EADDRNOTAVAIL
+        // （connectString 仍用原 URL 原样透传，不重组）
+        if (u.port)
+            validPort(u.port, 5236, 'dmdb');
         return {
             connectString: conn.url,
             user: decodeURIComponent(u.username),
@@ -77,7 +82,9 @@ export function resolveDmConn(conn) {
     }
     const f = conn.fields ?? {};
     const host = typeof f.host === 'string' ? f.host : '';
-    const port = typeof f.port === 'number' ? f.port : 5236;
+    // 前端原样发字符串端口：显式校验；历史 typeof==='number' 门把一切字符串（含合法 '14330'）
+    // 静默丢弃回退 5236，且驱动侧 parseInt 对非法形态还有第二重静默回退
+    const port = validPort(f.port, 5236, 'dmdb');
     if (host === '') {
         throw new Error('DM 连接需要 url（dm://user:pass@host:5236）或 fields（host/port）');
     }

package/dist/adapters/mongodb/index.js

@@ -17,6 +17,7 @@
  *    bson 保持 dependencies（bundle 的 external），保证 BSON 类实例与外部一致。
  */
 import { createRequire } from 'node:module';
+import { validPort } from '../sql-shared/common.js';
 let vendorCache;
 /** 容错加载 vendor bundle：缺失时返回 undefined（调用方降级处理），成功后缓存。
  * 失败不缓存 → vendor 构建完成后无需重启即可恢复。 */
@@ -574,7 +575,9 @@ export function reviveEjson(v) {
 }
 export function buildUri(fields, ssl) {
     const host = typeof fields?.host === 'string' && fields.host !== '' ? fields.host : '127.0.0.1';
-    const port = typeof fields?.port === 'number' ? fields.port : 27017;
+    // 前端原样发字符串端口：显式校验；历史 typeof==='number' 门把一切字符串（含合法 '14330'）
+    // 静默丢弃回退 27017，分字段模式用户所填端口实际永不生效
+    const port = validPort(fields?.port, 27017, 'mongodb');
     const user = typeof fields?.user === 'string' ? encodeURIComponent(fields.user) : '';
     const pass = typeof fields?.password === 'string' ? `:${encodeURIComponent(fields.password)}` : '';
     const auth = user !== '' ? `${user}${pass}@` : '';

package/dist/adapters/mysql/index.js

@@ -6,7 +6,7 @@
  * TRANSACTION READ ONLY）+ query 首词只读白名单双保险；服务层拦截 execute。
  */
 import mysql from 'mysql2/promise';
-import { assertIdent, clampLimit, clampOffset, humanize, normalizeCell, quoteIdent } from '../sql-shared/common.js';
+import { assertIdent, clampLimit, clampOffset, humanize, normalizeCell, quoteIdent, validPort } from '../sql-shared/common.js';
 /** ro 模式下 query 允许的读语句首词白名单 */
 const RO_READ_PREFIX = /^(select|show|desc|describe|explain|use|help|table)\b/i;
 /**
@@ -43,7 +43,8 @@ function connOptions(conn) {
     if (conn.url) {
         const u = new URL(conn.url);
         base.host = u.hostname;
-        base.port = Number(u.port) || 3306;
+        // 端口段校验：':0' 等非法值抛中文错误，不再被 Number()|| 静默改写 3306
+        base.port = u.port ? validPort(u.port, 3306, 'mysql') : 3306;
         try {
             if (u.username)
                 base.user = decodeURIComponent(u.username);
@@ -63,7 +64,8 @@ function connOptions(conn) {
     else if (conn.fields) {
         const f = conn.fields;
         base.host = String(f.host ?? '127.0.0.1');
-        base.port = Number(f.port ?? 3306);
+        // 前端原样发字符串端口：显式校验，NaN/0 等不再被驱动 `|| 3306` 静默改写后连错服务
+        base.port = validPort(f.port, 3306, 'mysql');
         base.user = String(f.user ?? f.username ?? 'root');
         if (f.password != null)
             base.password = String(f.password);

package/dist/adapters/oracle/index.js

@@ -18,6 +18,7 @@
  */
 import oracledb from 'oracledb';
 import { sqlHead, SQL_READ_HEADS } from '../../guard/index.js';
+import { validPort } from '../sql-shared/common.js';
 // CLOB 统一按字符串返回；BLOB 统一按 Buffer 返回。均为官方全局按类型转换
 // （fetchInfo 的键是列名而非类型名，`{ BLOB: … }` 只会匹配恰好名为 "BLOB" 的列，
 // 按类型统一转换须用全局 fetchAsString/fetchAsBuffer——官方 connection.rst
@@ -111,12 +112,15 @@ export function resolveOracleConn(conn) {
         return {
             user,
             password: decodeURIComponent(u.password),
-            connectString: `${u.hostname}:${u.port || 1521}/${service}`,
+            // 端口段校验：':0' 等非法值抛中文错误，不再 host:0 直传驱动
+            connectString: `${u.hostname}:${u.port ? validPort(u.port, 1521, 'oracle') : 1521}/${service}`,
         };
     }
     const f = conn.fields ?? {};
     const host = typeof f.host === 'string' ? f.host : '';
-    const port = typeof f.port === 'number' ? f.port : 1521;
+    // 前端原样发字符串端口：显式校验；历史 typeof==='number' 门把一切字符串（含合法 '14330'）
+    // 静默丢弃回退 1521
+    const port = validPort(f.port, 1521, 'oracle');
     const service = typeof f.service === 'string' ? f.service : typeof f.database === 'string' ? f.database : '';
     if (host === '' || service === '') {
         throw new Error('Oracle 连接需要 url（oracle://user:pass@host:1521/SERVICE）或 fields（host/port/service）');

package/dist/adapters/redis/index.js

@@ -10,6 +10,7 @@
  *  - 只读账号建议由用户在服务端配置 ACL 只读用户（见 README/文档）。
  */
 import { createClient } from 'redis';
+import { validPort } from '../sql-shared/common.js';
 /** 危险命令：服务层拦截器在用户确认前拒绝执行（KEYS 同时被 query 白名单禁用）。对齐官方 ACL dangerous 类。 */
 export const DANGEROUS_COMMANDS = new Set([
     'FLUSHALL', 'FLUSHDB', 'SWAPDB', 'CONFIG', 'DEBUG', 'SAVE', 'SHUTDOWN',
@@ -111,9 +112,11 @@ function parseInfo(raw) {
     return rows;
 }
 /** 从 fields 拼接连接 URL（url 缺省时） */
-function buildUrl(fields, ssl) {
+export function buildUrl(fields, ssl) {
     const host = typeof fields?.host === 'string' && fields.host !== '' ? fields.host : '127.0.0.1';
-    const port = typeof fields?.port === 'number' ? fields.port : 6379;
+    // 前端原样发字符串端口：显式校验；历史 typeof==='number' 门把一切字符串（含合法 '14330'）
+    // 静默丢弃回退 6379，属静默错连
+    const port = validPort(fields?.port, 6379, 'redis');
     const user = typeof fields?.user === 'string' && fields.user !== '' ? encodeURIComponent(fields.user) : '';
     const pass = typeof fields?.password === 'string' ? `:${encodeURIComponent(fields.password)}@` : '';
     const db = typeof fields?.database === 'number' && fields.database !== 0 ? `/${fields.database}` : '';

package/dist/adapters/sql-shared/common.js

@@ -27,6 +27,21 @@ export function clampOffset(offset) {
     const n = Math.floor(Number(offset ?? 0));
     return Number.isFinite(n) && n > 0 ? n : 0;
 }
+/**
+ * 端口校验（fail-closed，sqlserver validPort 同口径，各适配器 fields/URL 两路径共用）：
+ * 仅「未提供」（undefined/null/''，表单留空的官方语义）回退该库默认端口；提供了但
+ * Number() 后不是 1-65535 的整数则抛中文错误——绝不静默改写用户配置（各驱动普遍对
+ * falsy 端口 `|| 默认` 静默回退、对非整数静默截断，连错服务/端口后排障会被误导）。
+ */
+export function validPort(v, dflt, label) {
+    if (v === undefined || v === null || v === '')
+        return dflt;
+    const n = Number(v);
+    if (!Number.isInteger(n) || n <= 0 || n > 65535) {
+        throw new Error(`${label} 连接的端口取值非法：${JSON.stringify(v)}（须为 1-65535 的整数；留空才使用默认端口 ${dflt}）`);
+    }
+    return n;
+}
 /** 任意单元格 → NormalizedCell（string | number | null） */
 export function normalizeCell(v) {
     if (v === null || v === undefined)

package/dist/adapters/sql-shared/pg-like.js

@@ -1,4 +1,4 @@
-import { assertIdent, clampLimit, clampOffset, humanize, normalizeCell, quoteIdent } from './common.js';
+import { assertIdent, clampLimit, clampOffset, humanize, normalizeCell, quoteIdent, validPort } from './common.js';
 /** 多主机 authority 逐台重组段（host[:port]） */
 function joinHostSeg(h) {
     return `${h.host}${h.port != null ? ':' + h.port : ''}`;
@@ -20,7 +20,9 @@ function poolConfig(conn, overrideUrl, max = 10) {
         // devg-dist/gaussdb-12-0319）、默认管理用户 gaussdb；postgresql 维持社区默认 5432/postgres 不变。
         const gb = conn.meta.kind === 'gaussdb';
         base.host = String(f.host ?? '127.0.0.1');
-        base.port = Number(f.port ?? (gb ? 8000 : 5432));
+        // 前端原样发字符串端口：显式校验，NaN/'' 经 Number() 变 0 后会被驱动 truthy 检查
+        // 静默回退 defaults 5432（连 gaussdb 想兜底的 8000 都落不到）、小数被 parseInt 截断
+        base.port = validPort(f.port, gb ? 8000 : 5432, conn.meta.kind);
         base.user = String(f.user ?? f.username ?? (gb ? 'gaussdb' : 'postgres'));
         if (f.password != null)
             base.password = String(f.password);
@@ -42,7 +44,7 @@ function poolConfig(conn, overrideUrl, max = 10) {
  * authority（host:port,host:port）端口段含逗号非数字 → new URL 直接抛 Invalid URL。
  * 故自行按文本解析 authority，不经 WHATWG 解析。
  */
-export function normalizeUrl(url) {
+export function normalizeUrl(url, label = 'postgres') {
     const stripped = url.replace(/^jdbc:/i, '');
     const schemeEnd = stripped.indexOf('://');
     // 无 authority（非 URL 形态）：整串原样保留，交由驱动按既有逻辑处理
@@ -60,8 +62,14 @@ export function normalizeUrl(url) {
         const ci = seg.lastIndexOf(':');
         if (ci < 0)
             return { host: seg };
-        const port = Number.parseInt(seg.slice(ci + 1), 10);
-        return Number.isFinite(port) ? { host: seg.slice(0, ci), port } : { host: seg };
+        const host = seg.slice(0, ci);
+        const rawPort = seg.slice(ci + 1);
+        // 空端口段视同未提供（驱动按默认端口探测）；非空则必须为 1-65535 整数——历史 parseInt
+        // 会静默截断 '1433.5'→1433、NaN 时把整段当主机名，均属静默改写端口。dflt 传 0 仅占位：
+        // rawPort 非空不会走到回退分支。
+        if (rawPort === '')
+            return { host };
+        return { host, port: validPort(rawPort, 0, label) };
     });
     const prefix = `${stripped.slice(0, schemeEnd)}://${userinfo}`;
     // 单台不设 hosts（调用方只在多台时探测）
@@ -118,7 +126,7 @@ export async function pickHost(driver, base, hosts, masterOnly) {
  * 返回最终驱动池配置与最终连接 URL。
  */
 export async function pgLikePoolCfg(kind, driver, conn, max) {
-    const norm = conn.url ? normalizeUrl(conn.url) : null;
+    const norm = conn.url ? normalizeUrl(conn.url, kind) : null;
     const cleanUrl = norm ? norm.prefix + (norm.hosts ?? []).map(joinHostSeg).join(',') + norm.suffix : undefined;
     let finalUrl = cleanUrl;
     if (norm?.hosts && norm.hosts.length > 1) {

package/dist/adapters/sqlserver/index.js

@@ -81,9 +81,19 @@ function decodeCred(raw) {
         throw new Error('sqlserver 连接 URL 的用户名或密码 percent 编码非法（如含未编码的 %），请 URL 编码后重试');
     }
 }
+/**
+ * 端口校验（fail-closed，对齐官方语义）：仅「未提供」回退默认端口（tedious 对未提供 port
+ * 默认 1433）；提供了但不是 1-65535 的整数则抛中文错误——与 tedious 对非法 port 抛
+ * RangeError 的行为一致，绝不静默改写用户配置（排障会被假端口误导）。
+ */
 function validPort(v, dflt) {
+    if (v === undefined || v === null || v === '')
+        return dflt;
     const n = Number(v);
-    return Number.isFinite(n) && n > 0 && n <= 65535 ? Math.floor(n) : dflt;
+    if (!Number.isInteger(n) || n <= 0 || n > 65535) {
+        throw new Error(`sqlserver 连接的端口取值非法：${JSON.stringify(v)}（须为 1-65535 的整数；留空才使用默认端口 ${dflt}）`);
+    }
+    return n;
 }
 /**
  * URL 脱敏（错误消息可能进 audit.jsonl 与模型上下文，绝不能回显明文密码）：
@@ -116,7 +126,7 @@ function poolConfig(conn) {
         }
         catch {
             // 脱敏：错误消息会进 audit.jsonl 与模型上下文，绝不回显 userinfo 明文密码
-            throw new Error(`sqlserver 连接 URL 无法解析：${redactUrl(conn.url)}（期望形态 sqlserver://user:pass@host:1433/db?encrypt=true；请检查端口是否在 1-65535、是否有多余字符）`);
+            throw new Error(`sqlserver 连接 URL 无法解析：${redactUrl(conn.url)}（期望形态 sqlserver://user:pass@host:1433/db?encrypt=true；请检查端口是否在 1-65535、是否有多余字符；命名实例请改用 ?instanceName=实例名 参数）`);
         }
         if (!u.hostname)
             throw new Error('sqlserver 连接 URL 缺少主机名（期望形态 sqlserver://user:pass@host:1433/db）');
@@ -140,7 +150,8 @@ function poolConfig(conn) {
             options.tdsVersion = tds;
         }
         const instance = queryParam(u.searchParams, 'instanceName');
-        // 指定命名实例时 tedious 会忽略 port，改由 SQL Server Browser（UDP 1434）解析
+        // instanceName 与 port 互斥：mssql 层在建连前会 delete 掉 port（tedious 对两者共存直接抛
+        // 互斥 Error），端口改由 SQL Server Browser（UDP 1434）按实例名解析
         if (instance !== undefined && instance !== '')
             options.instanceName = instance;
         // fields.database 覆盖 URL 库名：传输端跨库定位（sqlserverLocate）按 pg/mysql 惯例、
@@ -396,7 +407,7 @@ function mssqlReason(e) {
             base = `服务器要求加密连接：当前 encrypt=false 被服务器拒绝，请改用 ?encrypt=true 后重试（${detail}）`;
             break;
         case 'EINSTLOOKUP':
-            base = `实例名解析失败：SQL Server Browser 服务可能未运行或 UDP 1434 不可达（命名实例可改用「主机:端口」直连，如 host,1433）（${detail}）`;
+            base = `实例名解析失败：SQL Server Browser 服务可能未运行或 UDP 1434 不可达（命名实例可改用「主机，端口」直连，如 host,1433）（${detail}）`;
             break;
         case 'ENOTOPEN':
         case 'ECONNCLOSED':
@@ -492,8 +503,10 @@ function rowsOf(res) {
 function makePoolBox(Driver, cfg) {
     const pool = new Driver.ConnectionPool(cfg);
     // 无条件兜底：mssql 的 ConnectionPool 在 acquire 失败（空闲连接被服务器断开等）时会
-    // emit('error', err)，EventEmitter 无监听器时直接抛 → 崩掉宿主进程。
-    pool.on('error', () => { });
+    // emit('error', err)，EventEmitter 无监听器时直接抛 → 崩掉宿主进程。这里只留痕不中断请求。
+    pool.on('error', (e) => {
+        console.error('[sqlserver] 连接池错误（不影响后续请求，连接将按需重建）:', e instanceof Error ? e.message : e);
+    });
     let connecting;
     const ready = () => {
         if (connecting === undefined) {

package/dist/store/connections.js

@@ -264,6 +264,9 @@ export class ConnectionStore {
         if (finalUrl !== undefined) {
             rec.urlSafe = redactUrl(finalUrl);
             this.secrets.set(id, { url: finalUrl });
+            // 对称清理（clearUrl 的反方向）：切到 URL 方式保存即放弃分字段配置；残留 fields 会被
+            // sqlserver 等适配器的 fields.database 幽灵覆盖 URL 库名（safeUrl 显示新库、实际连旧库的静默错库）
+            delete rec.fields;
         }
         if (patch.clearUrl && rec.urlSafe !== undefined) {
             delete rec.urlSafe;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-db-tool",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "DSH community plugin: chat-operated multi-database admin tool with sidebar management, project-scoped grants, ro/rw modes and dangerous-operation confirmation",
   "type": "module",
   "license": "MIT",