dsh-db-tool 1.3.0 → 1.3.1

package/README.md

@@ -38,6 +38,26 @@ dsh plugin --profile web add "link:E:\path\to\dsh-db-tool"
 
 GaussDB 官方驱动未发布 npm，需先构建 vendor：`npm run build:gaussdb`（PowerShell）或 `bash scripts/build-gaussdb.sh`；运行要求 Node ≥ 22.12（产物依赖 p-limit@7 纯 ESM）。oracledb 安装脚本需 `npm approve-scripts oracledb`。mongodb 驱动已 bundle 进发布包（`vendor/mongodb-driver.cjs`，esbuild 构建，`npm run build:mongodb` 可重建），依赖树中不含 mongodb/punycode，详见 [docs/install.md](docs/install.md)。
 
+### 桌面端安装
+
+DSH 桌面端 0.2.0-rc.2+ 捆绑了 `dsh` 命令，全程无需另装 Node 或 pnpm：
+
+1. **首次使用**：打开桌面端菜单栏，点 **"Manage dsh command"（管理 dsh 命令）**，安装捆绑的 CLI——该操作把 `dsh` 命令注册到系统 PATH。
+2. **安装插件**（必须钉精确版本：`@latest` 会因 release-age 校验回落到旧版）：
+
+   ```bash
+   dsh plugin --profile desktop add dsh-db-tool@1.3.1 --registry=https://registry.npmjs.org/
+   ```
+
+   已有 npm 镜像源偏好的用户，可把 `--registry` 替换为自己的镜像地址。
+3. **重启桌面端**生效。
+
+桌面端补充说明：
+
+- **免补丁路径**：桌面端宿主代码打包在 `app.asar` 内，无法应用 `patch:dsh` 热补丁；但本插件 0.1.9+ 走免补丁路径（mongodb 驱动已 bundle 为 `vendor/mongodb-driver.cjs` 随包发布，依赖树不含 punycode），桌面端可直接安装加载，无需任何补丁。
+- **GaussDB**：npm 发布包不含 GaussDB vendor 驱动。需要 GaussDB 的用户请改从源码安装（`dsh plugin --profile desktop add "dsh-db-tool@github:mengqi1436/dsh-db-tool"`），并在插件目录自行 `npm run build:gaussdb`（要求 Node ≥ 22.12）。
+- **Oracle**：安装后需 `npm approve-scripts oracledb` 放行 oracledb 安装脚本（或按 DSH 插件安装界面的脚本审批提示放行）。
+
 ## 安全模型
 
 - HTTP API 仅同源（`ctx.webServer` prefix `/dsh-db-tool/api`）+ 宿主 Connection 栅栏（`ctx.connection.requestRejection`：Host/Origin + 浏览器 token 鉴权。0.2.0-rc.1 起插件前缀路由不经宿主栅栏，故在 handler 顶层显式应用；宿主无 connection 服务时回退 loopback/Origin trust 校验，等价 ssh-tunnel `http-trust`），body 限 2MB
@@ -52,7 +72,7 @@ GaussDB 官方驱动未发布 npm，需先构建 vendor：`npm run build:gaussdb
 
 症状：DSH 启动后插件加载报 `failed to import`，伴随 `TypeError: Cannot read properties of null (reading 'Symbol(Symbol.iterator)')`，栈指向 `dsh-app-boot` 的 `routeScoped`。
 
-根因：上游 `@deepseek-ai/dsh-app-boot` 对 `createRequire(parent).resolve.paths(name)` 直接做 `for..of`，而 Node 对 core-module 同名包（`punycode` 等）返回 `null`，hoisted profile 下凡依赖树含此类 npm 包的插件都会炸。`0.1.7-rc.2` 与 `0.2.0-rc.1` 中同型缺陷两处（锚点行逐字节一致，仅整体行号偏移 1 行）：`routeScoped()` 与 `nativePackageDir()`，本补丁一并修复（两处分别独立判定，已打过旧版单处补丁的机器只会补上缺的那处）。
+根因：上游 `@deepseek-ai/dsh-app-boot` 对 `createRequire(parent).resolve.paths(name)` 直接做 `for..of`，而 Node 对 core-module 同名包（`punycode` 等）返回 `null`，hoisted profile 下凡依赖树含此类 npm 包的插件都会炸。`0.1.7-rc.2`、`0.2.0-rc.1` 与 `0.2.0-rc.2` 中同型缺陷两处（`0.2.0-rc.2` 的 `lib/index.js` 与 `0.2.0-rc.1` 逐字节相同，尚未修复；锚点行均与 `0.1.7-rc.2` 一致，仅整体行号偏移 1 行）：`routeScoped()` 与 `nativePackageDir()`，本补丁一并修复（两处分别独立判定，已打过旧版单处补丁的机器只会补上缺的那处）。
 
 一键修复（幂等，应用前自动备份为 `index.js.bak-hotfix`；`--revert` 可还原）：
 
@@ -61,7 +81,7 @@ npm run patch:dsh        # Windows（PowerShell）
 npm run patch:dsh:sh     # macOS / Linux
 ```
 
-脚本自动探测 DSH 安装根（`--dsh-root` 可显式指定）；补丁文件按安装版本自动选择：`patches/dsh-app-boot-route-scoped-hotfix.patch`（`0.1.7-rc.2`）、`patches/dsh-app-boot-route-scoped-hotfix-0.2.0-rc.1.patch`（`0.2.0-rc.1`，与内建替换路径逐字节等价已验证）；不支持的版本会警告（`--force` 覆盖）。上游 issue：<https://github.com/mengqi1436/dsh-db-tool/issues>（占位，待上游仓库开放后替换）。
+脚本自动探测 DSH 安装根（`--dsh-root` 可显式指定）；补丁文件按安装版本自动选择：`patches/dsh-app-boot-route-scoped-hotfix.patch`（`0.1.7-rc.2`）、`patches/dsh-app-boot-route-scoped-hotfix-0.2.0-rc.1.patch`（`0.2.0-rc.1`）、`patches/dsh-app-boot-route-scoped-hotfix-0.2.0-rc.2.patch`（`0.2.0-rc.2`，其 `lib/index.js` 与 `0.2.0-rc.1` 逐字节相同，故 hunk 完全一致；均与内建替换路径逐字节等价已验证）；不支持的版本会警告（`--force` 覆盖）。上游 issue：<https://github.com/mengqi1436/dsh-db-tool/issues>（占位，待上游仓库开放后替换）。
 
 **本插件的免补丁路径（0.1.9+）**：该 bug 的触发条件是依赖树中出现 core-module 同名包，mongodb 链（`mongodb-connection-string-url → whatwg-url → tr46 → punycode`）正是元凶。0.1.9 起 mongodb 驱动经 esbuild bundle 为 `vendor/mongodb-driver.cjs` 随包发布，生产依赖树不再含 mongodb 与 punycode——在**未修复宿主**（含桌面版 app.asar，无法打补丁）上也能正常安装加载。守卫测试 `tests/guard/deps-core-collision.spec.ts` 断言依赖树永不回退（dependencies 白名单 + lockfile 生产树 core 同名包零交集）。`patch:dsh` 仍保留，用于修复**其他**含同类依赖的插件或宿主自身报错。
 

package/package.json

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

package/patches/dsh-app-boot-route-scoped-hotfix-0.2.0-rc.2.patch

@@ -0,0 +1,41 @@
+# DSH dsh-app-boot resolve.paths hotfix (upstream bug: createRequire(parent).resolve.paths(name)
+# returns null for core-module names like "punycode", breaking hoisted profile installs).
+# Covers BOTH unguarded for..of sites in 0.2.0-rc.2: routeScoped() (@@ -1423,14) and
+# nativePackageDir() (@@ -1245,10). lib/index.js is byte-identical to 0.2.0-rc.1
+# (anchor lines identical to 0.1.7-rc.2, overall +1 shift) — hunks shared verbatim.
+# Target-Version: 0.2.0-rc.2
+# Apply manually:  git apply -p1 -d <dsh-app-boot package root> <this file>
+# Or one command:  npm run patch:dsh    (scripts/apply-dsh-hotfix.ps1)
+# Generated from @deepseek-ai/dsh-app-boot@0.2.0-rc.2 npm tarball vs patched local copy.
+diff --git a/lib/index.js b/lib/index.js
+index e60aac4..fcd1a38 100644
+--- a/lib/index.js
++++ b/lib/index.js
+@@ -1245,7 +1245,10 @@ function profileChild(path, treePrefix) {
+ 	return treePrefix + (end < 0 ? rest : rest.slice(0, end));
+ }
+ function nativePackageDir(parent, name) {
+-	for (const searchPath of createRequire(parent).resolve.paths(name)) {
++	/* local hotfix: nativePackageDir: resolve.paths returns null for core-module names
++	   (fs, node:fs, ...); an empty list means no local candidate, matching the
++	   guard in profile.ts:596. */
++	for (const searchPath of createRequire(parent).resolve.paths(name) ?? []) {
+ 		const candidate = join(searchPath, name);
+ 		if (existsSync(join(candidate, "package.json"))) return candidate;
+ 	}
+@@ -1420,7 +1423,14 @@ var ResolutionRouter = class {
+ 		const target = resolution.entries.get(name);
+ 		const candidates = [];
+ 		const localSearchPaths = [];
+-		for (const searchPath of createRequire(parent).resolve.paths(name)) {
++		/* local hotfix: resolve.paths returns null for core-module names (e.g. "punycode"),
++		   which made the for..of throw TypeError and broke every hoisted profile install
++		   whose dependency tree requires such an npm package. Fall back to the standard
++		   node_modules search chain so the local candidate can still be found. */
++		const _hotReq = createRequire(parent);
++		const _hotPaths = _hotReq.resolve.paths(name)
++			?? _hotReq("node:module")._nodeModulePaths(_hotReq("node:path").dirname(parent));
++		for (const searchPath of _hotPaths) {
+ 			if (!searchPath.startsWith(layer.localPrefix)) break;
+ 			localSearchPaths.push(searchPath);
+ 			const candidate = localPackageCandidate(searchPath, name, flavor);

package/scripts/hotfix-core.mjs

@@ -5,9 +5,9 @@
  * 修复的 bug：@deepseek-ai/dsh-app-boot 对
  * `createRequire(parent).resolve.paths(name)` 的 for..of 无保护，而 Node 对
  * core-module 同名包（punycode 等）返回 null，for..of null 直接抛 TypeError，
- * 导致 hoisted profile 下 npm 安装插件导入失败。rc.2 起共两处同型缺陷：
- * 1. routeScoped()（rc.2 L1419 区域 / 0.2.0-rc.1 L1423 区域）—— 症状直接暴露；
- * 2. nativePackageDir()（rc.2 L1244 区域 / 0.2.0-rc.1 L1248 区域）—— 症状相同，一并修复。
+ * 导致 hoisted profile 下 npm 安装插件导入失败。0.1.7-rc.2 起共两处同型缺陷：
+ * 1. routeScoped()（0.1.7-rc.2 L1419 区域 / 0.2.0-rc.1 与 0.2.0-rc.2 L1423 区域）—— 症状直接暴露；
+ * 2. nativePackageDir()（0.1.7-rc.2 L1244 区域 / 0.2.0-rc.1 与 0.2.0-rc.2 L1248 区域）—— 症状相同，一并修复。
  *
  * 版本支持：锚点行在 TARGET_VERSIONS 列出的版本中逐字节一致（仅整体行号偏移），
  * 内建替换路径与版本无关；git-apply 路径按安装版本选择 patches/ 下行号匹配的补丁。
@@ -23,12 +23,13 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 
 /** 补丁文件里的目标版本声明行（patches/*.patch 注释头）。 */
 export const TARGET_VERSION = '0.1.7-rc.2';
-/** 锚点行逐字节一致的受支持版本列表（仅整体行号偏移；0.2.0-rc.1 = rc.2 行号 +1）。 */
-export const TARGET_VERSIONS = ['0.1.7-rc.2', '0.2.0-rc.1'];
+/** 锚点行逐字节一致的受支持版本列表（仅整体行号偏移；0.2.0-rc.1/0.2.0-rc.2 的 lib/index.js 逐字节相同）。 */
+export const TARGET_VERSIONS = ['0.1.7-rc.2', '0.2.0-rc.1', '0.2.0-rc.2'];
 /** 各受支持版本对应的默认补丁文件名（patches/ 下；git-apply 路径按版本选择）。 */
 export const PATCH_BY_VERSION = {
 	'0.1.7-rc.2': 'dsh-app-boot-route-scoped-hotfix.patch',
 	'0.2.0-rc.1': 'dsh-app-boot-route-scoped-hotfix-0.2.0-rc.1.patch',
+	'0.2.0-rc.2': 'dsh-app-boot-route-scoped-hotfix-0.2.0-rc.2.patch',
 };
 /** 判断目标文件是否已打补丁的标识串（hotfix 注释首行片段）。 */
 export const HOTFIX_MARKER = 'local hotfix: resolve.paths returns null';

package/docs/api-contract.md

@@ -1,76 +0,0 @@
-# dsh-db-tool HTTP API 契约（v1）
-
-侧边栏 client 与 lib/http 实现共同遵守。API 仅监听 loopback（127.0.0.1），校验 `Origin`/`Referer` 必须来自 DSH 本地 web（同源 fenced）。所有请求/响应 JSON。
-
-## 通用约定
-
-- 成功：`200 { "ok": true, "data": ... }`
-- 失败：`{ "ok": false, "error": string, "code": string }`，code ∈ `UNAUTHORIZED_PROJECT`（项目未授权该连接）/ `READ_ONLY`（ro 连接拒绝 execute）/ `NEEDS_CONFIRMATION`（危险操作待确认）/ `INVALID_CHALLENGE` / `NOT_FOUND` / `INVALID_ARGUMENT`（参数非法；插件 dispose 后的新请求同样返回此 code，error 为「服务已关闭」）/ `DRIVER_ERROR`
-- `projectPath`：前端传入当前 workspace 绝对路径，服务端用 `normalizeProjectKey` 归一后校验 grants；**不传视为匿名项目**（仅连接管理可用，业务操作一律拒）
-- 人工确认通道：SQL 控制台是人工操作，危险语句同样走 challenge 流程——前端展示确认对话框后携 `challengeId` 重发
-- 除注明外，业务端点均需 projectPath 且该连接已授权
-
-## 路由
-
-### 连接管理（无需 projectPath）
-
-| 方法/路径 | 说明 |
-|---|---|
-| `GET /api/connections` | 全量连接列表（脱敏 ConnectionMeta[]，含每库 kind） |
-| `POST /api/connections` | 创建 `{ id, kind, name?, url?, fields?, ssl? }`；密码自动拆入 secrets |
-| `PUT /api/connections/:id` | 更新（同上字段可选） |
-| `DELETE /api/connections/:id` | 删除（级联 secrets + 全项目 grants） |
-| `POST /api/connections/:id/test` | 测试连接 → `TestConnectResult` |
-
-### 项目授权
-
-| 方法/路径 | 说明 |
-|---|---|
-| `GET /api/grants?project=<path>` | 该项目授权列表 `{ connId, mode }[]` |
-| `PUT /api/grants` | `{ projectPath, connId, mode: "ro"\|"rw" }` 授权/改模式 |
-| `DELETE /api/grants` | `{ projectPath, connId }` 撤销 |
-
-### 浏览（需授权，ro 即可）
-
-| 方法/路径 | 说明 |
-|---|---|
-| `GET /api/databases?project=<path>&connId=` | 库/schema 清单 string[] |
-| `GET /api/tables?project=<path>&connId=&database=` | TableInfo[] |
-| `GET /api/schema?project=<path>&connId=&database=&table=` | ColumnInfo[] |
-| `GET /api/preview?project=<path>&connId=&database=&table=&limit=&offset=` | QueryResult（limit≤50 强制；offset 为行偏移，翻页用，默认 0） |
-
-### SQL 控制台 / 脚本（需授权，execute 需 rw）
-
-| 方法/路径 | 说明 |
-|---|---|
-| `POST /api/query` | `{ projectPath, connId, sql, params?, challengeId? }` → QueryResult；危险读（如 KEYS）同样触发 NEEDS_CONFIRMATION |
-| `POST /api/execute` | `{ projectPath, connId, statement, params?, challengeId? }` → ExecResult 或 `NEEDS_CONFIRMATION { challengeId, statement, danger, reason }` |
-| `POST /api/script` | `{ projectPath, connId, code, challengeId? }` → 子进程沙箱执行（Node permission model 禁 fs + 新 vm realm 双层隔离），60s 强超时；db 句柄经 IPC 走完整 guard/审计链路 |
-
-### 审计
-
-| 方法/路径 | 说明 |
-|---|---|
-| `GET /api/audit?project=<path>&limit=` | AuditEntry[]（最近 n 条，默认 50） |
-
-### 状态
-
-| 方法/路径 | 说明 |
-|---|---|
-| `GET /api/state?project=<path>` | 面板初始化：`{ connections, grants, auditTail }` |
-
-## NEEDS_CONFIRMATION 语义
-
-```json
-{
-  "ok": false,
-  "code": "NEEDS_CONFIRMATION",
-  "challengeId": "c_9f3a…",
-  "statement": "DROP TABLE users",
-  "danger": "danger",
-  "reason": "DDL 不可回滚（隐式提交）"
-}
-```
-
-- `challengeId` 一次性、绑定语句 hash、5 分钟过期；重发请求带同 `challengeId` 且语句 hash 一致才放行
-- 模型工具（对话内）用同一 guard/challenge 实现，确认经 ask_user 完成

package/docs/apple-redesign-spec.md

@@ -1,80 +0,0 @@
-# dsh-db-tool 侧边栏 Apple 风格重设计规范（单一真相）
-
-所有参与者必须遵守本规范。目标：贴合 Apple 官方视觉语言（macOS/iOS 系统 UI、HIG），在 DSH 侧边栏窄容器（约 380-420px）内呈现。
-
-## 硬性约束（所有 teammate）
-- **只改自己分配的行区段**，区段外一律不动（edit 基于 old_string 精确匹配）。
-- **i18n key 冻结**（client/client.js L18-264）：不得新增/删除/改名 key；如确需新文案，在汇报中列出由 Lead 决定。
-- **不新增任何 npm 依赖**（单文件 bundle 无构建步骤）。图标只用极简内联 SVG 几何图形（chevron/加号/三角等 primitives）或纯排版。
-- 保持 `React.createElement` 形态、保持组件对外 props/签名不变、保持 `dbt-` 类名前缀。
-- 保留对宿主变量的 fallback：`var(--dsh-accent, <apple值>)` 形式可保留，但视觉基线以本规范的 Apple token 为准。
-- 尊重 `prefers-color-scheme`（light/dark 双模式）与 `prefers-reduced-motion`。
-- 完成后 `node --check client/client.js` 必须通过。
-
-## 1. Design Tokens（CSS 变量，定义在 .dbt-panel 根）
-
-字体：
-- UI 字体：`-apple-system, BlinkMacSystemFont, "SF Pro Text", "Segoe UI", system-ui, sans-serif`
-- 等宽（SQL/数据）：`ui-monospace, "SF Mono", Menlo, Consolas, monospace`
-- 字号阶梯：caption 11px / 正文 13px / 小标题 13px semibold / 标题 15px semibold。行高 1.45。
-
-颜色（dark 模式为基线，light 模式对应反转）：
-| token | dark | light |
-|---|---|---|
-| --dbt-accent | #0A84FF（系统蓝） | #007AFF |
-| --dbt-bg | 透明（继承宿主） | 同 |
-| --dbt-surface | rgba(120,120,128,.12) | rgba(120,120,128,.08) |
-| --dbt-surface-strong | rgba(120,120,128,.18) | rgba(120,120,128,.14) |
-| --dbt-separator | rgba(120,120,128,.24) | rgba(60,60,67,.18) |
-| --dbt-text-secondary | rgba(235,235,245,.6) | rgba(60,60,67,.6) |
-| --dbt-danger | #FF453A | #FF3B30 |
-| --dbt-success | #30D158 | #34C759 |
-| --dbt-warning | #FFD60A | #FF9F0A |
-
-材质（Apple 毛玻璃近似，非官方 Liquid Glass）：
-- 对话框/粘性表头可用 `backdrop-filter: blur(20px) saturate(180%)` + 半透明背景；提供 `@media (prefers-reduced-transparency: reduce)` 下降级为实色。
-- 阴影一律带色调（不用纯黑）：`0 8px 32px rgba(0,0,0,.28)`（dark）。
-
-圆角系统（Shape Consistency Lock）：
-- 卡片/对话框 12px；按钮/输入/segmented 容器 8px；小 pill 6px。全站只用这三档。
-
-间距：8pt 网格。面板 padding 16px；卡片内 12px；元素间 gap 8px（紧凑 4px）。
-
-动效：`transition: all .18s cubic-bezier(0.25, 0.1, 0.25, 1)`；仅 transform/opacity；`:active` 时 `transform: scale(.97)`；MOTION 强度低（侧边栏工具，动效仅为反馈）。
-
-## 2. 组件契约（类名 → Apple 形态）
-
-类名全部保留，视觉重定义：
-
-- `.dbt-panel`：根容器。font 13px，padding 16px，gap 12px，flex column，overflow-y auto。
-- `.dbt-tabs`：**iOS segmented control**。容器 `background: var(--dbt-surface); border-radius: 8px; padding: 2px; gap: 2px; display: flex;` 内 button `flex: 1; border: none; background: transparent; border-radius: 6px; padding: 5px 8px; font-size: 12px;` active：`background: rgba(255,255,255,.14)`（light 模式 rgba(255,255,255,.9)+细阴影）+ `font-weight: 600`，不用蓝色填充。
-- `.dbt-card`：**inset grouped 卡片**。`background: var(--dbt-surface); border: none; border-radius: 12px; padding: 12px; gap: 10px;`
-- `.dbt-row`：flex row，gap 8px，wrap。
-- 输入（`.dbt-row input/select/textarea`、`.dbt-card` 同类）：**填充式无边框**。`background: var(--dbt-surface-strong); border: none; border-radius: 8px; padding: 6px 10px; font-size: 13px;` focus：`outline: 2px solid var(--dbt-accent); outline-offset: -1px;`（或 box-shadow ring）。
-- `.dbt-btn`：普通= `background: var(--dbt-surface); border: none; border-radius: 8px; padding: 5px 12px; font-size: 13px; font-weight: 500;` hover 提亮（surface-strong）；active scale(.97)。
-- `.dbt-btn.primary`：`background: var(--dbt-accent); color: #fff; border: none;` 无渐变无发光。
-- `.dbt-btn.danger`：`color: var(--dbt-danger); background: transparent; border: 1px solid var(--dbt-danger);`（或 `background: rgba(255,69,58,.12); border: none`，二选一全站统一）。
-- `.dbt-btn:disabled`：opacity .4。
-- `.dbt-muted`：`color: var(--dbt-text-secondary); font-size: 11px;`
-- `.dbt-err`：`color: var(--dbt-danger); font-size: 12px;`（白底黑字对比达标）。
-- `.dbt-msg`：`color: var(--dbt-success); font-size: 12px;`
-- `.dbt-table`：**去全边框，行 hairline 式**。`th, td: border: none; border-bottom: 1px solid var(--dbt-separator); padding: 6px 8px; font-size: 12px;` th `position: sticky; top: 0; backdrop-filter: blur(20px); background: <半透明宿主底色>; font-weight: 600; font-size: 11px; text-transform: uppercase 可选（不强制）`。td 数字/数据列用等宽字体。
-- `.dbt-tablewrap`：`border: none; border-radius: 12px; overflow: auto; max-height: 320px; background: var(--dbt-surface);`
-- `.dbt-overlay`：`background: rgba(0,0,0,.4); backdrop-filter: blur(8px);`
-- `.dbt-dialog`：**macOS alert 风格**。`background: rgba(40,40,44,.85)（light: rgba(252,252,252,.9)）; backdrop-filter: blur(20px) saturate(180%); border: 1px solid var(--dbt-separator); border-radius: 14px; padding: 16px; box-shadow: 0 8px 32px rgba(0,0,0,.28);` 标题 13px semibold 居中可选；按钮区 `.dbt-row` 改为右对齐。
-- `.dbt-grant`：列表行式。`padding: 8px 0; border-bottom: 1px solid var(--dbt-separator);`（去 dashed，实 hairline）。
-- `.dbt-seg`：与 `.dbt-tabs` 同构的 mini segmented（ro/rw/未授权切换）。
-
-## 3. 各面板布局指引（结构重排方向）
-
-- **ManageView**：连接列表改为列表行卡（每连接一张 inset card：kind 徽标（小 pill 6px、surface 底）、名称 13px semibold、safeUrl 等宽 11px muted、右侧「编辑/删除」为图标化次要按钮）；「新建连接」为 accent 主按钮置顶右侧；表单字段分组；审计表保持 resultTable。
-- **GrantsView**：每连接一行（列表行式），ro/rw/未授权用 `.dbt-seg` mini segmented；说明文字 muted。
-- **BrowseView**：库/表选择器用填充式 select；结构/预览切换可用 mini segmented；表格遵循新 table 契约。
-- **ConsoleView**：SQL 输入区用等宽字体 + 填充式输入（min-height 加大、focus ring）；执行按钮 accent 主按钮；结果表新契约；challenge 流程与 DangerDialog 样式统一。
-- DangerDialog：标题不再用 emoji ⚠️，改为纯文字 + danger 色 accent（左侧 3px 色条或标题色）。
-
-## 4. 验收
-- `node --check client/client.js` 通过；
-- 全站只有一个 accent（系统蓝）、一套圆角、一套材质；
-- dark/light 均可读（WCAG AA）；
-- 无 emoji 图标、无渐变、无发光、无多余装饰 pill。

package/docs/architecture.md

@@ -1,154 +0,0 @@
-# dsh-db-tool 项目架构图
-
-> 由 cbm（codebase-memory）索引数据绘制：843 节点 / 2702 边，模块分层见各图。
-> 索引项目名：`E-Code-dsh-dsh-db-tool`。
-
-## 1. 总体分层架构
-
-```mermaid
-flowchart TB
-    subgraph UI["客户端层（DSH 侧边栏）"]
-        CLIENT["client/client.js<br/>连接管理 · 对象树浏览 · SQL 控制台 · 授权面板"]
-    end
-
-    subgraph API["接入层"]
-        HTTP["lib/http<br/>HTTP API（13 条路由）"]
-        TOOL["lib/index.ts<br/>DatabaseManager 工具定义<br/>list_connections / query / execute /<br/>schema / preview / run_script"]
-    end
-
-    subgraph SVC["服务编排层"]
-        MGR["lib/manager.ts<br/>ro/rw 项目授权校验 · 适配器生命周期 · 事务编排"]
-    end
-
-    subgraph SEC["安全层"]
-        GUARD["lib/guard<br/>SQL/命令分类 · 危险操作识别 ·<br/>一次性 challenge 确认（5 分钟有效）"]
-        STORE["lib/store<br/>connections · grants · secrets（脱敏）·<br/>audit 审计 · normalize · io"]
-        SCRIPT["lib/script<br/>runner.ts + worker.cjs<br/>子进程沙箱（vm realm · 禁文件 · 60s 超时）"]
-    end
-
-    subgraph ADPT["适配器层 lib/adapters（8 库）"]
-        REG["index.ts<br/>kind → 工厂注册表 + driverMissingError"]
-        SQLSHARED["sql-shared/<br/>common.ts（标识符/分页/规范化）<br/>pg-like.ts（PostgreSQL + GaussDB 共享）"]
-        A1["mysql"]
-        A2["postgresql"]
-        A3["gaussdb<br/>vendor/gaussdb-pg 驱动加载"]
-        A4["sqlite"]
-        A5["redis"]
-        A6["mongodb"]
-        A7["oracle"]
-        A8["dmdb"]
-        TYPES["types.ts<br/>DatabaseAdapter 契约"]
-    end
-
-    subgraph DRV["驱动层"]
-        D1["pg / mysql2 / sqlite3 / redis<br/>mongodb / oracledb / dmdb"]
-        D2["vendor/gaussdb-pg<br/>openGauss-connector-nodejs 构建产物"]
-    end
-
-    CLIENT -->|HTTP| HTTP
-    CLIENT -.->|注入| TOOL
-    TOOL --> MGR
-    MGR --> GUARD
-    MGR --> STORE
-    MGR --> SCRIPT
-    MGR --> REG
-    REG --> SQLSHARED
-    REG --> A1 & A4 & A5 & A6 & A7 & A8
-    A2 --> SQLSHARED
-    A3 --> SQLSHARED
-    SQLSHARED --> TYPES
-    A1 & A2 & A3 & A4 & A5 & A6 & A7 & A8 -.-> DRV
-    SCRIPT -.->|db.query / db.execute 经完整 guard 链路| MGR
-```
-
-## 2. 请求时序（query 与危险操作确认流）
-
-```mermaid
-sequenceDiagram
-    autonumber
-    participant U as 用户（聊天）
-    participant T as DatabaseManager 工具
-    participant M as lib/manager.ts
-    participant G as lib/guard
-    participant S as lib/store
-    participant A as 适配器（8 库）
-    participant DB as 数据库
-
-    U->>T: query/execute（conn_id, sql）
-    T->>S: 授权校验（项目路径 → 连接 → ro/rw）
-    alt 未授权
-        S-->>T: UNAUTHORIZED_PROJECT
-    else ro 授权 + 写操作
-        S-->>T: READ_ONLY（拒绝）
-    else 通过
-        T->>G: 语句分类
-        alt 危险操作（DDL/DML/维护命令）
-            G-->>T: NEEDS_CONFIRMATION + challengeId（一次性，5 分钟）
-            T-->>U: 说明语句与风险，等待明确同意
-            U->>T: 携同一 challengeId 重试
-            T->>G: 校验 challenge（绑定语句 hash）
-        end
-        T->>M: 执行
-        M->>A: query/execute（可选 database 跨库路由，pg/gaussdb）
-        A->>DB: 参数化 SQL（ro 会话级 READ ONLY 双保险）
-        DB-->>A: 结果
-        A-->>T: 规范化结果（DECIMAL→string 等）
-        T->>S: 审计记录
-        T-->>U: {columns, rows, rowCount} / {affectedRows, message}
-    end
-```
-
-## 3. 适配器体系（8 库 × 共享实现）
-
-```mermaid
-flowchart LR
-    subgraph 契约
-        T["types.ts<br/>DatabaseAdapter / TableInfo / ColumnInfo<br/>DbKind = 8 种"]
-    end
-    subgraph 工厂注册
-        R["adapters/index.ts<br/>kind → lazy import 工厂<br/>缺失驱动 → driverMissingError（附构建提示）"]
-    end
-    subgraph SQL系共享
-        PG["pg-like.ts<br/>PostgreSQL + GaussDB<br/>pool · ro 会话 · 跨库路由 ·<br/>库→schema→表 三层浏览"]
-        CM["common.ts<br/>assertIdent · quoteIdent<br/>clampLimit/Offset · normalizeCell"]
-    end
-    subgraph 独立实现
-        MY["mysql"]
-        SQ["sqlite"]
-        RD["redis（SCAN 禁 KEYS）"]
-        MG["mongodb（强制显式 filter）"]
-        OR["oracle"]
-        DM["dmdb"]
-    end
-    PG --> CM
-    MY & SQ & RD & MG & OR & DM -.-> CM
-    R --> PG & MY & SQ & RD & MG & OR & DM
-    PG -.->|"gaussdb 差异仅驱动加载<br/>createRequire vendor/gaussdb-pg"| G["gaussdb/index.ts"]
-    T --- R
-```
-
-## 4. 模块分层职责（cbm layers 数据）
-
-| 层 | 模块 | 特征 |
-|---|---|---|
-| entry | lib、script、e2e-mock | 仅出边（调用下游） |
-| api | http | 含 13 条 HTTP 路由定义 |
-| core | adapters（4 入 0 出）、store（12 入 0 出） | 高扇入核心，不依赖上层 |
-| internal | manager（7 入 12 出）、tool、http | 编排枢纽 |
-| leaf | guard | 仅入边，纯分类/判定 |
-
-## 5. GaussDB 专项链路
-
-```mermaid
-flowchart TB
-    T["DatabaseManager(query/execute/schema/preview, database=...)"] --> M["manager"]
-    M --> A3["gaussdb/index.ts<br/>loadGaussDriver()：createRequire<br/>vendor/gaussdb-pg/packages/pg（CJS）"]
-    A3 --> PL["sql-shared/pg-like.ts<br/>kind='gaussdb'"]
-    PL -->|poolConfig：host/port 8000/user/password/database/ssl| P["PgLikePool"]
-    PL -->|database 参数| PF["poolFor(db)：按库缓存池（Navicat 式跨库）"]
-    PL -->|ro 模式| SRO["每个新连接 SET SESSION CHARACTERISTICS<br/>AS TRANSACTION READ ONLY（fail-closed）"]
-    P --> DB[("GaussDB 服务端<br/>openGauss 协议")]
-```
-
-- 驱动构建：`scripts/build-gaussdb.sh` / `.ps1` → 克隆 openGauss-connector-nodejs → `vendor/gaussdb-pg/packages/pg`（gitignore）。
-- 测试：`tests/adapters-sql/gaussdb.test.ts`（驱动加载/工厂，mock 离线）+ `pg-like.test.ts`（pg/gaussdb 共享行为）。

package/docs/dsh-db-tool /351/224/231/350/257/257/350/256/260/345/275/225.txt"

@@ -1,66 +0,0 @@
-DSH 插件 dsh-db-tool 加载错误记录
-=====================================
-记录时间：2026-09-28
-当前状态：已从 desktop profile 卸载；卸载后该错误归零，其余 12 个第三方插件全部正常。
-
-一、错误原文
--------------------------------------
-dsh: error: [/197] createRequire.resolve.paths is not a function or its return value is not iterable
-
-对应条目：/197   id=db-tool   name=dsh-db-tool   status=error
-
-出现场景：DSH 0.1.7-rc.2 桌面版，desktop profile 的插件组合检查
-（等价 `dsh --profile desktop --dump-config-schema` 的官方加载路径）。
-同一检查中，其余 12 个第三方插件均无错误。
-
-二、根因（DSH 0.1.7-rc.2 自带代码的 bug）
--------------------------------------
-1) DSH 自带 @deepseek-ai/dsh-app-boot 的 lib/index.js 里有 6 处
-   `createRequire(parent).resolve.paths(name)` 调用，其中 5 处未做空值防护。
-2) Node 对「内置模块同名包」调用该 API 会返回 null
-   （本机实测：resolve.paths('punycode') 返回 null；普通包返回数组）。
-   对 null 做 for..of 即抛 TypeError —— 这就是上面的错误消息。
-3) dsh-db-tool 的依赖链包含 npm 包 punycode：
-   dsh-db-tool → mongodb → mongodb-connection-string-url → whatwg-url → tr46 → punycode
-   因此该插件的加载路径必然触发这个 bug。
-
-三、本机复现证据
--------------------------------------
-运行环境：Electron Node（DeepSeek Harness.exe 加 --expose-internals），可直接访问 asar 内模块。
-
-复现结果（最小用例）：
-  createRequire('.../node_modules/dsh-db-tool/dist/index.js').resolve.paths('punycode')  =>  null
-  createRequire('.../node_modules/tr46/index.js').resolve.paths('punycode')             =>  null
-  createRequire('.../node_modules/dsh-db-tool/dist/index.js').resolve.paths('ssh2')      =>  array[11]
-
-DSH 官方检查的诊断输出：
-  卸载前：F:\DSH\_recon\dump-schema-err.txt      （含 /197 db-tool 错误）
-  卸载后：F:\DSH\_recon\dump-schema-err-2.txt    （该错误消失，只剩 DSH 内置 agent-preset 的 4 条既有诊断）
-
-四、插件作者已知该问题（包内自带 hotfix）
--------------------------------------
-dsh-db-tool 包内提供：
-  scripts/hotfix-core.mjs
-  patches/dsh-app-boot-route-scoped-hotfix.patch
-目标：@deepseek-ai/dsh-app-boot 0.1.7-rc.2 中未防护的那行 for..of。
-修法：resolve.paths 返回 null 时回退到标准 node_modules 搜索链。
-
-限制（本机为何没能直接用）：
-  该脚本按「文件系统安装的 DSH」定位目标（找 DSH_HOME、PATH 上的 dsh、全局 npm 目录），
-  而桌面版把 dsh-app-boot 打包在 F:\DSH\resources\app.asar 内，脚本找不到文件，无法应用。
-
-五、可选修复路径（供向 DSH/插件作者反馈）
--------------------------------------
-1) 等 DSH 上游修复（推荐）：该 bug 属于 0.1.7-rc.2 自带代码，任意「依赖树含 core-module 同名包」的插件都会触发。
-2) 重打包 app.asar 应用该 hotfix：需先关闭 DSH 应用，修改应用安装文件，版本更新时会被覆盖，有风险。
-3) 插件侧规避：依赖树中避免引入 core-module 同名包（例如替换 punycode 的实现）。
-
-六、本次卸载记录
--------------------------------------
-卸载方式：DSH plugin-manager operations（pnpm remove + 从 dsh.profile.bundles 移除，等价插件页卸载）。
-结果核对：依赖 13 → 12；bundles 17 → 16；传递依赖 mongodb / punycode 等已一并清理。
-其余 12 个插件的运行时依赖健康检查全部通过（ssh2 纯 JS 可用、better-sqlite3/oracledb 可用、rtk 0.50.0 可用）。
-
-相关产物：
-  报告目录：F:\DSH\_recon\（install-results.json、各 recon 报告、dump 诊断、验证脚本）
-  安装前备份：F:\DSH\_backup\profile-20260928-162128\

package/docs/dsh-market-submission/mengqi1436__dsh-db-tool.yml

@@ -1,6 +0,0 @@
-url: https://github.com/mengqi1436/dsh-db-tool
-name: mengqi1436/dsh-db-tool
-category: tools
-description:
-  en: Chat-operated database admin for 8 databases (MySQL, PostgreSQL, GaussDB, SQLite, Oracle, DM, Redis, MongoDB): a DatabaseManager tool with read-only/read-write per-connection modes, per-project grants, one-time challenge confirmation for dangerous operations, sandboxed script execution, plus a sidebar with connection management, project authorization, a Navicat-style object browser and an SQL console.
-  zh: 聊天操作数据库的管理插件，支持 8 种数据库（MySQL、PostgreSQL、GaussDB、SQLite、Oracle、达梦、Redis、MongoDB）：DatabaseManager 工具带连接级只读/读写分级、项目级授权、危险操作一次性 challenge 对话内确认与沙箱脚本执行；侧边栏提供连接管理、项目授权、Navicat 式对象树浏览和 SQL 控制台。