dsh-db-tool 1.7.0 → 1.7.2

package/dist/adapters/dmdb/index.js

@@ -9,9 +9,10 @@
  *  - DM 事务隐式开始，无需 SET TRANSACTION。
  *
  * 驱动要点：
- *  - db.createPool({ connectString: 'dm://user:pass@host:5236', poolMin: 1, poolMax: 10,
- *    poolTimeout: 60, queueTimeout: 60000 })；不启用压缩（默认 compress=0，规避
- *    @napi-rs/snappy 跨平台坑）。
+ *  - db.createPool({ connectString: 'dm://user:pass@host:5236', poolAlias: <逐池唯一>,
+ *    poolMin: 1, poolMax: 10, poolTimeout: 60, queueTimeout: 60000 })；不启用压缩
+ *    （默认 compress=0，规避 @napi-rs/snappy 跨平台坑）。
+ *  - poolAlias 必须逐池唯一（不传即撞驱动缺省 'default' 并抛 [20006]；见 nextPoolAlias 注释）。
  *  - execute 必须显式 maxRows（默认 0=无限制）；autoCommit 显式传 true 使语义
  *    不依赖驱动默认（驱动连接属性默认已是自动提交：dmdb connection.js
  *    conn_prop_autoCommit = !0；d.ts 三级优先链 执行选项 > dmdb.autoCommit > 连接属性）。
@@ -84,6 +85,39 @@ export function resolveDmConn(conn) {
     const password = typeof f.password === 'string' ? f.password : '';
     return { connectString: `dm://${encodeURIComponent(user)}:${encodeURIComponent(password)}@${host}:${port}`, user, password };
 }
+/**
+ * 连接池别名：dmdb 把池登记在模块级全局 Map（dmdb.pools），key 即 poolAlias。
+ * 驱动缺省别名恒为 'default'（driver/pool.js `_poolAlias = "default"`，仅显式传参才覆盖），
+ * 且判重无条件执行 → 不传别名时第二个池必抛 [20006] 连接池别名已存在（src/dm.js:236）。
+ * 本插件同进程内可并存多个池（连接的 ro/rw 各一份缓存、testConnection/testDraft 的
+ * 一次性池、控制台事务会话、数据传输独立池），故必须逐池唯一。
+ * 别名同时是 close 的回收键：正常路径 driver/pool.js 会 `pools.delete(alias)`，
+ * 但 close 抛错的异常分支会跳过该删除（登记项残留，插件侧无可观测点）。
+ */
+let poolSeq = 0;
+function nextPoolAlias(conn) {
+    return `dsh-dm-${conn.meta.id}-${++poolSeq}`;
+}
+/** 建池（连接串解析、池参数与别名单点维护，供适配器与数据传输入口共用） */
+async function createDmPool(conn) {
+    const { connectString } = resolveDmConn(conn);
+    try {
+        // 注意：实参对象不要直接包进 `as unknown as` 断言——变异工具不为该形态生成
+        // ObjectLiteral 变异体，「删掉 poolAlias」这类关键退化会在变异报告中不可见（已验证）。
+        const pool = await db.createPool({
+            connectString,
+            poolAlias: nextPoolAlias(conn),
+            poolMin: 1,
+            poolMax: 10,
+            poolTimeout: 60,
+            queueTimeout: 60000,
+        });
+        return pool;
+    }
+    catch (e) {
+        throw humanizeDmError(e);
+    }
+}
 export async function createDmAdapter(conn, opts) {
     const mode = opts?.mode ?? 'rw';
     let pool;
@@ -91,19 +125,7 @@ export async function createDmAdapter(conn, opts) {
         pool = opts.pool;
     }
     else {
-        const { connectString } = resolveDmConn(conn);
-        try {
-            pool = (await db.createPool({
-                connectString,
-                poolMin: 1,
-                poolMax: 10,
-                poolTimeout: 60,
-                queueTimeout: 60000,
-            }));
-        }
-        catch (e) {
-            throw humanizeDmError(e);
-        }
+        pool = await createDmPool(conn);
     }
     /** 默认 execute 选项：显式 maxRows（dmdb 默认 0=无限制，必须覆盖）+ 显式 autoCommit:true
      *  （驱动连接属性默认已是 true，显式传递仅让语义不依赖驱动默认；SELECT 立即结束隐式事务，避免 ro 事务悬挂） */
@@ -335,19 +357,7 @@ export async function createDmAdapter(conn, opts) {
     return adapter;
 }
 export const factory = async (conn) => createDmAdapter(conn);
-/** 数据传输读写端用的独立连接池 */
+/** 数据传输读写端用的独立连接池（别名逐池唯一，可与主连接池并存） */
 export async function openDmPool(conn) {
-    const { connectString } = resolveDmConn(conn);
-    try {
-        return (await db.createPool({
-            connectString,
-            poolMin: 1,
-            poolMax: 10,
-            poolTimeout: 60,
-            queueTimeout: 60000,
-        }));
-    }
-    catch (e) {
-        throw humanizeDmError(e);
-    }
+    return await createDmPool(conn);
 }

package/dist/adapters/oracle/index.js

@@ -2,8 +2,10 @@
  * Oracle 适配器（oracledb v7 thin 模式，DB 12.1+）。
  *
  * 设计要点（依据官方文档调研）：
- *  - oracledb.createPool({ user, password, connectString, poolMin: 1, poolMax: 10, poolTimeout: 60 })。
+ *  - oracledb.createPool({ user, password, connectString, poolAlias: <逐池唯一>,
+ *    poolMin: 1, poolMax: 10, poolTimeout: 60 })。
  *    禁止 SYSDBA 等特权连接（不透传 privilege）。
+ *  - poolAlias 显式传唯一值：不传则落到匿名池（不可经 getPool() 检索），见 createOraPool 注释。
  *  - CLOB 经全局 fetchAsString 转字符串；BLOB 经全局 fetchAsBuffer 转 Buffer。
  *    （fetchInfo 的键是【列名】而非类型名，按类型统一转换只能用全局 fetchXXX 属性——
  *    官方 connection.rst「fetchInfo」节：「Each column is specified by name」）
@@ -129,6 +131,37 @@ export function resolveOracleConn(conn) {
         connectString: `${host}:${port}/${service}`,
     };
 }
+/**
+ * 连接池别名：oracledb 的规则与 dmdb 不同——只有「显式传入的别名」或
+ * 「'default' 尚空闲时取到的缺省值」会登记进模块级 poolCache；两者都被占用时
+ * 驱动创建的是 poolAlias === undefined 的匿名池（不报错，也无法经 getPool() 检索），
+ * 只有显式重复别名才抛 NJS-046（lib/oracledb.js:640-649、lib/errors.js:352）。
+ * 本插件同进程内可并存多个池（连接的 ro/rw 各一份缓存、testConnection/testDraft 的
+ * 一次性池、控制台事务会话、数据传输独立池），故显式传唯一别名：每池身份可检索，
+ * 且不抢占 getPool() 的缺省键 'default'。回收靠 '_afterPoolClose' 事件（close 抛错则不触发）。
+ */
+let poolSeq = 0;
+function nextPoolAlias(conn) {
+    return `dsh-ora-${conn.meta.id}-${++poolSeq}`;
+}
+/** 建池（连接串解析、池参数与别名单点维护，供适配器与数据传输入口共用） */
+async function createOraPool(conn) {
+    const { user, password, connectString } = resolveOracleConn(conn);
+    try {
+        return await oracledb.createPool({
+            user,
+            password,
+            connectString,
+            poolAlias: nextPoolAlias(conn),
+            poolMin: 1,
+            poolMax: 10,
+            poolTimeout: 60,
+        });
+    }
+    catch (e) {
+        throw humanizeOraError(e);
+    }
+}
 export async function createOracleAdapter(conn, opts) {
     const mode = opts?.mode ?? 'rw';
     let pool;
@@ -136,20 +169,7 @@ export async function createOracleAdapter(conn, opts) {
         pool = opts.pool;
     }
     else {
-        const { user, password, connectString } = resolveOracleConn(conn);
-        try {
-            pool = await oracledb.createPool({
-                user,
-                password,
-                connectString,
-                poolMin: 1,
-                poolMax: 10,
-                poolTimeout: 60,
-            });
-        }
-        catch (e) {
-            throw humanizeOraError(e);
-        }
+        pool = await createOraPool(conn);
     }
     function requireRw(action) {
         if (mode === 'ro') {
@@ -387,20 +407,7 @@ export async function createOracleAdapter(conn, opts) {
     return adapter;
 }
 export const factory = async (conn) => createOracleAdapter(conn);
-/** 数据传输读写端用的独立连接池（复用 resolveOracleConn 与错误包装） */
+/** 数据传输读写端用的独立连接池（别名逐池唯一，可与主连接池并存） */
 export async function openOraclePool(conn) {
-    const { user, password, connectString } = resolveOracleConn(conn);
-    try {
-        return await oracledb.createPool({
-            user,
-            password,
-            connectString,
-            poolMin: 1,
-            poolMax: 10,
-            poolTimeout: 60,
-        });
-    }
-    catch (e) {
-        throw humanizeOraError(e);
-    }
+    return await createOraPool(conn);
 }

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

@@ -202,6 +202,10 @@ export async function createPgLikeAdapter(kind, Driver, conn, opts) {
     setupPool(pool);
     // 事务激活期间所有 query/execute 路由到同一 client
     let txClient = null;
+    /** close 幂等标志：pg-pool 的 end() 二次调用会抛 "Called end on pool more than once"，
+     *  而 manager 的 console 会话在授权复核失败路径会重复关闭同一适配器（见 manager 的
+     *  finish('rollback') 与外层 catch）——重复 close 须为 no-op。 */
+    let closed = false;
     const run = (sql, params) => txClient ? txClient.query(sql, params) : pool.query(sql, params);
     // 跨库浏览（Navicat 行为）：树列出服务器上所有库，展开非连接库时用同一凭据开指向该库的池。
     // 池按库缓存复用；ro 模式下新池同样套会话只读。连接自身的库（fields.database 或 url 库名）直接复用主池。
@@ -387,6 +391,9 @@ export async function createPgLikeAdapter(kind, Driver, conn, opts) {
             return toQueryResult(res);
         }),
         close: () => humanize(`${kind} 关闭连接`, async () => {
+            if (closed)
+                return; // 幂等：重复 close 为 no-op（见 closed 声明处注释）
+            closed = true;
             await Promise.all([pool.end(), ...[...dbPools.values()].map((p) => p.end())]);
         }),
     };

package/dist/adapters/sqlite/index.js

@@ -114,6 +114,10 @@ export function stmtColumns(stmt, raw) {
 export async function createSqliteAdapter(conn, opts) {
     const readOnly = opts?.mode === 'ro';
     const { db, driver } = await openRaw(conn, readOnly);
+    /** close 幂等：node:sqlite 的 DatabaseSync.close() 二次调用抛 "database is not open"，
+     *  而 manager 的 runScript 超时路径会对同一会话适配器重复 close
+     *  （onTimeout 与 finally 各一次）——重复 close 必须为 no-op。 */
+    let closed = false;
     return {
         kind: 'sqlite',
         connId: conn.meta.id,
@@ -175,6 +179,9 @@ export async function createSqliteAdapter(conn, opts) {
             return toQueryResult(raw, stmtColumns(stmt, raw));
         }),
         close: () => humanize('sqlite 关闭连接', async () => {
+            if (closed)
+                return; // 幂等：重复 close 为 no-op（见 closed 声明处注释）
+            closed = true;
             db.close();
         }),
     };

package/dist/adapters/transfer/model.js

@@ -35,8 +35,16 @@ export async function createTransferReader(rc, loc) {
         const pool = kind === 'oracle'
             ? (await (await import('../oracle/index.js')).openOraclePool(rc))
             : (await (await import('../dmdb/index.js')).openDmPool(rc));
-        // owner = 定位第一层（oracle/dm 单库多 schema 模型），缺省连接用户
-        return oralike.createOraLikeTransferReader(kind, pool, loc?.database ?? oralike.ownerOfFromConn(rc));
+        // owner = 定位第一层（oracle/dm 单库多 schema 模型），缺省连接用户。
+        // owner 非法（超长/含 NUL 换行）或缺失在构造期同步抛错，此时池已建而无人持有 →
+        // 登记项永不释放（池泄漏）。故构造期任何抛错都要回收该池。
+        try {
+            return oralike.createOraLikeTransferReader(kind, pool, loc?.database ?? oralike.ownerOfFromConn(rc));
+        }
+        catch (e) {
+            await pool.close().catch(() => { });
+            throw e;
+        }
     }
     if (kind === 'mongodb') {
         const { createMongoTransferReaderFromConn } = await import('./kinds/mongo.js');
@@ -66,8 +74,15 @@ export async function createTransferWriter(rc, writeMode = 'insert', loc) {
         const pool = kind === 'oracle'
             ? (await (await import('../oracle/index.js')).openOraclePool(rc))
             : (await (await import('../dmdb/index.js')).openDmPool(rc));
-        // 写入 owner = 定位第一层，缺省连接用户默认 schema（写端以 owner 前缀显式限定）
-        return oralike.createOraLikeTransferWriter(kind, pool, writeMode, loc?.database ?? oralike.ownerOfFromConn(rc));
+        // 写入 owner = 定位第一层，缺省连接用户默认 schema（写端以 owner 前缀显式限定）。
+        // 与读端同理：owner 非法/缺失在构造期同步抛错，池已建而无人持有 → 必须回收。
+        try {
+            return oralike.createOraLikeTransferWriter(kind, pool, writeMode, loc?.database ?? oralike.ownerOfFromConn(rc));
+        }
+        catch (e) {
+            await pool.close().catch(() => { });
+            throw e;
+        }
     }
     if (kind === 'mongodb') {
         const { createMongoTransferWriterFromConn } = await import('./kinds/mongo.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-db-tool",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "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",

package/scripts/fix-dsh-install.ps1

@@ -0,0 +1,155 @@
+<#
+.SYNOPSIS
+  诊断并修复「npm 上已发新版，但本机装不上 / 装到旧版 / 插件链接失效」。
+.DESCRIPTION
+  三类阻塞：① node_modules\dsh-db-tool 是 link 残留或死链；② minimumReleaseAge
+  未豁免目标版本（pnpm 会静默保留旧版并 exit 0）；③ allowBuilds 缺 oracledb /
+  better-sqlite3（安装报 ERR_PNPM_IGNORED_BUILDS）。默认只诊断，-Apply 才写入。
+.PARAMETER Version
+  目标版本；省略时读包内 package.json 的 version。
+.PARAMETER ProfileDir
+  profile 目录；默认 %USERPROFILE%\.dsh\profiles\desktop。
+.PARAMETER Apply
+  执行修复（默认仅诊断）。写入前自动备份。
+.EXAMPLE
+  pwsh -File scripts\fix-dsh-install.ps1
+  pwsh -File scripts\fix-dsh-install.ps1 -Apply
+#>
+[CmdletBinding()]
+param(
+  [string]$Version,
+  [string]$ProfileDir,
+  [switch]$Apply
+)
+
+$ErrorActionPreference = 'Stop'
+
+$prof = if ($ProfileDir) { $ProfileDir } else { Join-Path $env:USERPROFILE '.dsh\profiles\desktop' }
+if (-not (Test-Path -LiteralPath $prof)) { throw "找不到 DSH profile：$prof（DSH 桌面端是否装过并启动过？）" }
+$ws = Join-Path $prof 'pnpm-workspace.yaml'
+if (-not (Test-Path -LiteralPath $ws)) { throw "找不到 $ws（profile 尚未初始化）" }
+
+if (-not $Version) {
+  $pkg = Join-Path $PSScriptRoot '..\package.json'
+  $Version = if (Test-Path -LiteralPath $pkg) { (Get-Content -LiteralPath $pkg -Raw | ConvertFrom-Json).version } else { '0.0.0' }
+}
+
+# 固定编码，不依赖各 PowerShell 版本的默认值：5.1 的 Get-Content/Set-Content 走 ANSI
+# （会把非 ASCII 写坏），且两者默认都丢 BOM。这两个函数只在脚本自己的读写路径上使用。
+$utf8NoBom = New-Object System.Text.UTF8Encoding($false)
+function Read-Yaml([string]$p) { [System.IO.File]::ReadAllText($p, $utf8NoBom) }
+function Write-Yaml([string]$p, [string]$t) { [System.IO.File]::WriteAllText($p, $t, $utf8NoBom) }
+
+# 换行归一化为 LF：CRLF 文件会让 `(?m)$` 锚点全部失效——豁免静默丢失，并写出重复的
+# YAML 段头（pnpm 报 duplicate mapping key，配置直接不可用）。插入统一用 `n。
+$text = (Read-Yaml $ws) -replace "`r`n", "`n"
+
+$link = Join-Path $prof 'node_modules\dsh-db-tool'
+$pkgs = @('oracledb', 'better-sqlite3')  # 需要执行构建脚本的原生依赖
+$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
+$fix = @()
+
+Write-Host "`n[1/3] 插件链接形态" -ForegroundColor Cyan
+if (Test-Path -LiteralPath $link) {
+  $it = Get-Item -LiteralPath $link -Force
+  $target = [string]$it.Target
+  Write-Host ("      node_modules\dsh-db-tool -> {0} : {1}" -f $it.LinkType, $target)
+  if ($it.LinkType -eq 'SymbolicLink' -or $it.LinkType -eq 'Junction') {
+    # Target 是「as defined」的原样字符串，可能是相对路径；必须按链接所在目录解析，
+    # 否则会按当前工作目录误判为死链并删掉一个完好的链接。
+    $resolved = if ($target -and -not [System.IO.Path]::IsPathRooted($target)) {
+      Join-Path (Split-Path -LiteralPath $link -Parent) $target
+    } else { $target }
+    if ($resolved -and (Test-Path -LiteralPath $resolved)) {
+      Write-Host "      [!] 指向真实目录的 link：npm 更新不会生效（加载的是该目录）" -ForegroundColor Yellow
+      Write-Host "          如该机不做本地开发，先 remove 再 add 改用 npm 包（见结尾）" -ForegroundColor Yellow
+    } else {
+      Write-Host "      [X] link 目标不存在 -> 安装/加载必定失败" -ForegroundColor Red
+      $fix += 'del-dead-link'
+    }
+  } else {
+    Write-Host "      OK：正常安装目录（非链接）" -ForegroundColor Green
+  }
+} else {
+  Write-Host "      未安装（无 node_modules\dsh-db-tool）"
+}
+
+Write-Host "`n[2/3] minimumReleaseAge 豁免" -ForegroundColor Cyan
+$m = [regex]::Match($text, '(?m)^[ \t]*-[ \t]*[''"]?dsh-db-tool@([^\r\n]*)')
+if (-not $m.Success) {
+  Write-Host "      [X] 没有 dsh-db-tool 豁免行 -> 新版本会被年龄窗口拦住" -ForegroundColor Red
+  $fix += 'add-exclude'
+} else {
+  Write-Host ("      现有：dsh-db-tool@" + $m.Groups[1].Value.TrimEnd())
+  # 版本边界：否则 1.7.1 会命中 1.7.10
+  $bound = '(?<![\d.])' + [regex]::Escape($Version) + '(?![\d.])'
+  if ($m.Groups[1].Value -match $bound) {
+    Write-Host "      OK：已豁免 $Version" -ForegroundColor Green
+  } else {
+    Write-Host "      [X] 未豁免 $Version -> pnpm 会静默装旧版或报 MINIMUM_RELEASE_AGE_VIOLATION" -ForegroundColor Red
+    $fix += 'extend-exclude'
+  }
+}
+
+Write-Host "`n[3/3] allowBuilds 原生模块白名单" -ForegroundColor Cyan
+$missingAllow = @($pkgs | Where-Object { $text -notmatch ('(?m)^[ \t]*' + [regex]::Escape($_) + ':[ \t]*true') })
+foreach ($n in $pkgs) {
+  if ($missingAllow -contains $n) {
+    Write-Host "      [X] $n 未获允许 -> 安装会以 ERR_PNPM_IGNORED_BUILDS 失败" -ForegroundColor Red
+    $fix += "allow-$n"
+  } else {
+    Write-Host "      OK：$n" -ForegroundColor Green
+  }
+}
+
+Write-Host "`n===== 结论 =====" -ForegroundColor Cyan
+if ($fix.Count -eq 0) {
+  Write-Host "未发现阻塞项。" -ForegroundColor Green
+} else {
+  Write-Host ("待处理 $($fix.Count) 项（见上方 [X]）") -ForegroundColor Yellow
+}
+
+if (-not $Apply) {
+  Write-Host "`n（诊断模式：未做任何修改。确认后加 -Apply 执行修复）"
+  return
+}
+
+$new = $text
+if ($fix -contains 'del-dead-link') { Remove-Item -LiteralPath $link -Force }
+
+if ($fix -contains 'extend-exclude') {
+  # 保留原行的引号与前缀，只追加版本（pnpm 对同名包只认第一条，故必须改原行）
+  $new = $new -replace '(?m)^([ \t]*-[ \t]*[''"]?dsh-db-tool@[^\r\n]*?)[ \t]*$', ('$1 || ' + $Version)
+}
+if ($fix -contains 'add-exclude') {
+  if ($new -match '(?m)^minimumReleaseAgeExclude:[ \t]*$') {
+    $new = $new -replace '(?m)^(minimumReleaseAgeExclude:[ \t]*)$', ('$1' + "`n  - dsh-db-tool@$Version")
+  } else {
+    # 段头缺失：插入无处可落，必须整段追加，否则静默无变更却报告成功
+    $new = $new.TrimEnd() + "`nminimumReleaseAgeExclude:`n  - dsh-db-tool@$Version`n"
+  }
+}
+if ($missingAllow.Count -gt 0) {
+  # 一次性补齐：逐项插入会各插一次段头，产出重复的 YAML 键
+  $block = ($missingAllow | ForEach-Object { '  ' + $_ + ': true' }) -join "`n"
+  if ($new -match '(?m)^allowBuilds:[ \t]*$') {
+    $new = $new -replace '(?m)^(allowBuilds:[ \t]*)$', ('$1' + "`n" + $block)
+  } else {
+    $new = $new.TrimEnd() + "`nallowBuilds:`n" + $block + "`n"
+  }
+}
+
+if ($new -eq $text) {
+  Write-Host "`n无需写入（配置已是目标状态）。" -ForegroundColor Green
+} else {
+  Copy-Item -LiteralPath $ws -Destination "$ws.bak-$stamp" -Force
+  Write-Yaml $ws $new
+  Write-Host "`n已更新 pnpm-workspace.yaml（备份：pnpm-workspace.yaml.bak-$stamp）" -ForegroundColor Green
+}
+
+Write-Host "`n===== 下一步 =====" -ForegroundColor Cyan
+Write-Host "  1) 完全退出并重启 DSH 桌面端"
+Write-Host "  2) 若上面提示过 link，先移除再安装："
+Write-Host '     & "<DSH安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop remove dsh-db-tool'
+Write-Host "  3) 安装目标版本："
+Write-Host ('     & "<DSH安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-db-tool@' + $Version + ' --registry=https://registry.npmjs.org/')