fdb2 1.0.36 → 1.0.38

package/dist/server/core/schema/diff.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 结构化差异：reconcile(canonical(原始态), canonical(目标态)) → TableChangeSet
+ *
+ * 单归属（与前端旧实现的关键差异）：
+ *   - 改名且同时改定义的列，只出现在 renamed 桶（携带 modifiedFields），
+ *     不再像旧前端那样同时进 renamedColumns + modifiedColumns 双重记账；
+ *   - 主键不参与列级比较，独立成桶；纯重命名主键列不构成主键变更（先做改名映射）；
+ *   - added / dropped / renamed / modified 按列名互斥。
+ *
+ * 幂等保证：diffTable(c, c) 为空 ChangeSet；任何往返操作后终态==初态 ⟹ 空 ChangeSet。
+ * 重命名检测沿用前端既有启发式（前缀关系 / 少量编辑），行为不回退。
+ */
+import type { CanonicalTable, TableChangeSet } from '../../model/ddl-spec';
+/** 表结构 diff：输入两侧均为归一化后的 CanonicalTable */
+export declare function diffTable(original: CanonicalTable, desired: CanonicalTable): TableChangeSet;
+//# sourceMappingURL=diff.d.ts.map

package/dist/server/core/schema/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../server/core/schema/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAmB,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA4C5F,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,cAAc,CA4E3F"}

package/dist/server/core/schema/diff.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffTable = diffTable;
+const canonical_1 = require("./canonical");
+const query_builder_1 = require("../query-builder");
+/** 两个列名是否可能属于同一次重命名：前缀关系 3 分，少量编辑 1 分，否则 0 */
+function renameNameScore(oldName, newName) {
+    const a = String(oldName || '').trim().toLowerCase();
+    const b = String(newName || '').trim().toLowerCase();
+    if (!a || !b || a === b)
+        return 0;
+    if (a.startsWith(b) || b.startsWith(a))
+        return 3;
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen > 0 && (0, query_builder_1.levenshtein)(a, b) <= Math.max(1, Math.floor(maxLen / 3)))
+        return 1;
+    return 0;
+}
+/** 把新增列与删除列中名称相近的配对（否则改名会被当成 DROP+ADD，导致数据丢失） */
+function matchRenamedColumns(added, dropped) {
+    const pairs = [];
+    const usedOld = new Set();
+    added.forEach((newCol, newIndex) => {
+        let bestScore = 0;
+        let bestOldIndex = -1;
+        dropped.forEach((oldCol, oldIndex) => {
+            if (usedOld.has(oldIndex))
+                return;
+            const score = renameNameScore(oldCol.name, newCol.name);
+            if (score === 0)
+                return;
+            const total = score + (oldIndex === newIndex ? 0.1 : 0); // 顺序位置一致的候选优先
+            if (total > bestScore) {
+                bestScore = total;
+                bestOldIndex = oldIndex;
+            }
+        });
+        if (bestOldIndex >= 0) {
+            usedOld.add(bestOldIndex);
+            const oldCol = dropped[bestOldIndex];
+            if (oldCol)
+                pairs.push({ oldColumn: oldCol, newColumn: newCol });
+        }
+    });
+    return pairs;
+}
+/** 表结构 diff：输入两侧均为归一化后的 CanonicalTable */
+function diffTable(original, desired) {
+    const rename = original.name !== desired.name ? { from: original.name, to: desired.name } : null;
+    const comment = original.comment !== desired.comment
+        ? { from: original.comment, to: desired.comment }
+        : null;
+    const originalMap = new Map(original.columns.map((c) => [c.name, c]));
+    const desiredNames = new Set(desired.columns.map((c) => c.name));
+    const added = desired.columns.filter((c) => !originalMap.has(c.name));
+    const dropped = original.columns.filter((c) => !desiredNames.has(c.name));
+    // 重命名检测
+    const renamedPairs = matchRenamedColumns(added, dropped);
+    const renamedSet = new Set(renamedPairs.map((p) => p.newColumn.name));
+    const droppedSet = new Set(dropped.map((c) => c.name));
+    const renamedFromSet = new Set(renamedPairs.map((p) => p.oldColumn.name));
+    const realAdded = added.filter((c) => !renamedSet.has(c.name));
+    const realDroppedNames = dropped.map((c) => c.name).filter((n) => !renamedFromSet.has(n));
+    const renamed = renamedPairs.map(({ oldColumn, newColumn }) => {
+        const fields = (0, canonical_1.diffColumnFields)(oldColumn, newColumn);
+        return {
+            from: oldColumn.name,
+            to: newColumn.name,
+            definitionChanged: fields.length > 0,
+            modifiedFields: fields
+        };
+    });
+    // 列级修改：同名且定义变化（不含主键——主键在表级）
+    const modified = desired.columns
+        .filter((c) => originalMap.has(c.name) && !renamedSet.has(c.name))
+        .map((c) => {
+        const before = originalMap.get(c.name);
+        if (!before)
+            throw new Error(`diff 内部错误：列 ${c.name} 应存在于原始侧`);
+        const fields = (0, canonical_1.diffColumnFields)(before, c);
+        return { name: c.name, fields, before, after: c };
+    })
+        .filter((m) => m.fields.length > 0);
+    // 幸存列（含改名后的新名）的相对顺序是否变化
+    const renameMap = new Map(renamedPairs.map((p) => [p.oldColumn.name, p.newColumn.name]));
+    const survivorSet = new Set([
+        ...original.columns.filter((c) => !droppedSet.has(c.name)).map((c) => renameMap.get(c.name) ?? c.name),
+        ...renamedSet
+    ]);
+    const originalSurviving = original.columns
+        .map((c) => renameMap.get(c.name) ?? c.name)
+        .filter((n) => survivorSet.has(n));
+    const desiredSurviving = desired.columns
+        .map((c) => c.name)
+        .filter((n) => survivorSet.has(n));
+    const orderChanged = originalSurviving.join(',') !== desiredSurviving.join(',');
+    // 主键比较：先把改名映射应用到原侧——纯重命名主键列不是主键变更
+    const pkRenameMap = renameMap;
+    const originalPkMapped = original.primaryKey.map((n) => pkRenameMap.get(n) ?? n);
+    const primaryKey = originalPkMapped.join(',') !== desired.primaryKey.join(',')
+        ? { from: original.primaryKey, to: desired.primaryKey }
+        : null;
+    return {
+        rename,
+        comment,
+        added: realAdded,
+        dropped: realDroppedNames,
+        renamed,
+        modified,
+        orderChanged,
+        columnOrder: desired.columns.map((c) => c.name),
+        primaryKey
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/server/core/schema/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../../server/core/schema/diff.ts"],"names":[],"mappings":";;AAyDA,8BA4EC;AAxHD,2CAA+C;AAC/C,oDAA+C;AAE/C,8CAA8C;AAC9C,SAAS,eAAe,CAAC,OAAe,EAAE,OAAe;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,CAAC,IAAI,IAAA,2BAAW,EAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACrF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,iDAAiD;AACjD,SAAS,mBAAmB,CAC1B,KAAwB,EACxB,OAA0B;IAE1B,MAAM,KAAK,GAAsE,EAAE,CAAC;IACpF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QACjC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;QACtB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YACnC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAClC,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO;YACxB,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc;YACvE,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,YAAY,GAAG,QAAQ,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;YACrC,IAAI,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0CAA0C;AAC1C,SAAgB,SAAS,CAAC,QAAwB,EAAE,OAAuB;IACzE,MAAM,MAAM,GACV,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,MAAM,OAAO,GACX,QAAQ,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;QAClC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE;QACjD,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjE,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1E,QAAQ;IACR,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1F,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QAC5D,MAAM,MAAM,GAAG,IAAA,4BAAgB,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,EAAE,EAAE,SAAS,CAAC,IAAI;YAClB,iBAAiB,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;YACpC,cAAc,EAAE,MAAM;SACvB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO;SAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAA,4BAAgB,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtC,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS;QAClC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;QACtG,GAAG,UAAU;KACd,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,QAAQ,CAAC,OAAO;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;SAC3C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhF,kCAAkC;IAClC,MAAM,WAAW,GAAG,SAAS,CAAC;IAC9B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,MAAM,UAAU,GACd,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QACzD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE;QACvD,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO;QACL,MAAM;QACN,OAAO;QACP,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,gBAAgB;QACzB,OAAO;QACP,QAAQ;QACR,YAAY;QACZ,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/server/core/schema/diff.ts

@@ -0,0 +1,134 @@
+/**
+ * 结构化差异：reconcile(canonical(原始态), canonical(目标态)) → TableChangeSet
+ *
+ * 单归属（与前端旧实现的关键差异）：
+ *   - 改名且同时改定义的列，只出现在 renamed 桶（携带 modifiedFields），
+ *     不再像旧前端那样同时进 renamedColumns + modifiedColumns 双重记账；
+ *   - 主键不参与列级比较，独立成桶；纯重命名主键列不构成主键变更（先做改名映射）；
+ *   - added / dropped / renamed / modified 按列名互斥。
+ *
+ * 幂等保证：diffTable(c, c) 为空 ChangeSet；任何往返操作后终态==初态 ⟹ 空 ChangeSet。
+ * 重命名检测沿用前端既有启发式（前缀关系 / 少量编辑），行为不回退。
+ */
+import type { CanonicalColumn, CanonicalTable, TableChangeSet } from '../../model/ddl-spec';
+import { diffColumnFields } from './canonical';
+import { levenshtein } from '../query-builder';
+
+/** 两个列名是否可能属于同一次重命名：前缀关系 3 分，少量编辑 1 分，否则 0 */
+function renameNameScore(oldName: string, newName: string): number {
+  const a = String(oldName || '').trim().toLowerCase();
+  const b = String(newName || '').trim().toLowerCase();
+  if (!a || !b || a === b) return 0;
+  if (a.startsWith(b) || b.startsWith(a)) return 3;
+  const maxLen = Math.max(a.length, b.length);
+  if (maxLen > 0 && levenshtein(a, b) <= Math.max(1, Math.floor(maxLen / 3))) return 1;
+  return 0;
+}
+
+/** 把新增列与删除列中名称相近的配对（否则改名会被当成 DROP+ADD，导致数据丢失） */
+function matchRenamedColumns(
+  added: CanonicalColumn[],
+  dropped: CanonicalColumn[]
+): Array<{ oldColumn: CanonicalColumn; newColumn: CanonicalColumn }> {
+  const pairs: Array<{ oldColumn: CanonicalColumn; newColumn: CanonicalColumn }> = [];
+  const usedOld = new Set<number>();
+  added.forEach((newCol, newIndex) => {
+    let bestScore = 0;
+    let bestOldIndex = -1;
+    dropped.forEach((oldCol, oldIndex) => {
+      if (usedOld.has(oldIndex)) return;
+      const score = renameNameScore(oldCol.name, newCol.name);
+      if (score === 0) return;
+      const total = score + (oldIndex === newIndex ? 0.1 : 0); // 顺序位置一致的候选优先
+      if (total > bestScore) {
+        bestScore = total;
+        bestOldIndex = oldIndex;
+      }
+    });
+    if (bestOldIndex >= 0) {
+      usedOld.add(bestOldIndex);
+      const oldCol = dropped[bestOldIndex];
+      if (oldCol) pairs.push({ oldColumn: oldCol, newColumn: newCol });
+    }
+  });
+  return pairs;
+}
+
+/** 表结构 diff：输入两侧均为归一化后的 CanonicalTable */
+export function diffTable(original: CanonicalTable, desired: CanonicalTable): TableChangeSet {
+  const rename =
+    original.name !== desired.name ? { from: original.name, to: desired.name } : null;
+  const comment =
+    original.comment !== desired.comment
+      ? { from: original.comment, to: desired.comment }
+      : null;
+
+  const originalMap = new Map(original.columns.map((c) => [c.name, c]));
+  const desiredNames = new Set(desired.columns.map((c) => c.name));
+
+  const added = desired.columns.filter((c) => !originalMap.has(c.name));
+  const dropped = original.columns.filter((c) => !desiredNames.has(c.name));
+
+  // 重命名检测
+  const renamedPairs = matchRenamedColumns(added, dropped);
+  const renamedSet = new Set(renamedPairs.map((p) => p.newColumn.name));
+  const droppedSet = new Set(dropped.map((c) => c.name));
+  const renamedFromSet = new Set(renamedPairs.map((p) => p.oldColumn.name));
+  const realAdded = added.filter((c) => !renamedSet.has(c.name));
+  const realDroppedNames = dropped.map((c) => c.name).filter((n) => !renamedFromSet.has(n));
+
+  const renamed = renamedPairs.map(({ oldColumn, newColumn }) => {
+    const fields = diffColumnFields(oldColumn, newColumn);
+    return {
+      from: oldColumn.name,
+      to: newColumn.name,
+      definitionChanged: fields.length > 0,
+      modifiedFields: fields
+    };
+  });
+
+  // 列级修改：同名且定义变化（不含主键——主键在表级）
+  const modified = desired.columns
+    .filter((c) => originalMap.has(c.name) && !renamedSet.has(c.name))
+    .map((c) => {
+      const before = originalMap.get(c.name);
+      if (!before) throw new Error(`diff 内部错误：列 ${c.name} 应存在于原始侧`);
+      const fields = diffColumnFields(before, c);
+      return { name: c.name, fields, before, after: c };
+    })
+    .filter((m) => m.fields.length > 0);
+
+  // 幸存列（含改名后的新名）的相对顺序是否变化
+  const renameMap = new Map(renamedPairs.map((p) => [p.oldColumn.name, p.newColumn.name]));
+  const survivorSet = new Set<string>([
+    ...original.columns.filter((c) => !droppedSet.has(c.name)).map((c) => renameMap.get(c.name) ?? c.name),
+    ...renamedSet
+  ]);
+  const originalSurviving = original.columns
+    .map((c) => renameMap.get(c.name) ?? c.name)
+    .filter((n) => survivorSet.has(n));
+  const desiredSurviving = desired.columns
+    .map((c) => c.name)
+    .filter((n) => survivorSet.has(n));
+  const orderChanged = originalSurviving.join(',') !== desiredSurviving.join(',');
+
+  // 主键比较：先把改名映射应用到原侧——纯重命名主键列不是主键变更
+  const pkRenameMap = renameMap;
+  const originalPkMapped = original.primaryKey.map((n) => pkRenameMap.get(n) ?? n);
+  const primaryKey =
+    originalPkMapped.join(',') !== desired.primaryKey.join(',')
+      ? { from: original.primaryKey, to: desired.primaryKey }
+      : null;
+
+  return {
+    rename,
+    comment,
+    added: realAdded,
+    dropped: realDroppedNames,
+    renamed,
+    modified,
+    orderChanged,
+    columnOrder: desired.columns.map((c) => c.name),
+    primaryKey
+  };
+}

package/dist/server/core/schema/type-defaults.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 「缺参即非法」的列类型在各方言下的默认参数。
+ *
+ * 背景：前端表单允许只填基础类型名（如 VARCHAR）而不填长度/精度，直接拼接会生成
+ * 非法 SQL——MySQL 的 `VARCHAR` 必须带长度、`DECIMAL` 必须带精度，否则报
+ * ER_PARSE_ERROR。缺参时按本表补齐，保证生成的 DDL 合法。
+ *
+ * 刻意不列默认的情况：
+ *   - SQLite：VARCHAR/DECIMAL 不带长度同样合法，保持原样输出（避免无意义的类型膨胀）；
+ *   - ClickHouse / SAP / MongoDB：类型体系不要求长度，或改表本就不支持。
+ *
+ * 这是全项目唯一的默认参数来源；service 层的 sql-type.helper 已改为复用本表，
+ * 避免两处参数漂移。
+ */
+import type { DialectKind } from '../dialect';
+export interface TypeParamDefault {
+    length?: number;
+    precision?: number;
+    scale?: number;
+}
+export declare const TYPE_PARAM_DEFAULTS: Record<DialectKind, Record<string, TypeParamDefault>>;
+/**
+ * 取某方言下某类型的默认参数；无默认值返回 undefined（即该类型允许裸写）。
+ * 比较按基础类型名的小写形式，与 canonical 化后的大小写无关。
+ */
+export declare function typeParamDefault(kind: DialectKind, baseType: string): TypeParamDefault | undefined;
+//# sourceMappingURL=type-defaults.d.ts.map

package/dist/server/core/schema/type-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-defaults.d.ts","sourceRoot":"","sources":["../../../../server/core/schema/type-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAqCrF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAGlG"}

package/dist/server/core/schema/type-defaults.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TYPE_PARAM_DEFAULTS = void 0;
+exports.typeParamDefault = typeParamDefault;
+/** PostgreSQL 与 CockroachDB 共用同一套数值/字符默认值 */
+const PG_DEFAULTS = {
+    decimal: { precision: 10, scale: 2 },
+    numeric: { precision: 10, scale: 2 },
+    'character varying': { length: 255 },
+    varchar: { length: 255 },
+    character: { length: 1 },
+    char: { length: 1 }
+};
+exports.TYPE_PARAM_DEFAULTS = {
+    mysql: {
+        // 整数刻意不设默认：MySQL 的 INT/TINYINT 等裸写合法，括号里的"显示宽度"自 8.0.17 起
+        // 已废弃，补成 INT(11) 既是无意义噪音，也会与实时结构里的 `int` 产生假差异。
+        decimal: { precision: 10, scale: 2 },
+        float: { precision: 10, scale: 2 },
+        double: { precision: 16, scale: 4 },
+        bit: { length: 1 },
+        char: { length: 1 },
+        varchar: { length: 255 },
+        binary: { length: 1 },
+        varbinary: { length: 255 }
+    },
+    postgres: PG_DEFAULTS,
+    cockroachdb: PG_DEFAULTS,
+    sqlite: {},
+    oracle: {
+        char: { length: 1 },
+        nchar: { length: 1 },
+        varchar2: { length: 4000 },
+        nvarchar2: { length: 2000 },
+        raw: { length: 2000 }
+    },
+    mssql: {
+        decimal: { precision: 18, scale: 0 },
+        numeric: { precision: 18, scale: 0 },
+        float: { precision: 53 },
+        char: { length: 1 },
+        varchar: { length: 255 },
+        nchar: { length: 1 },
+        nvarchar: { length: 255 },
+        binary: { length: 1 },
+        varbinary: { length: 255 }
+    },
+    mongodb: {},
+    sap: {},
+    clickhouse: {}
+};
+/**
+ * 取某方言下某类型的默认参数；无默认值返回 undefined（即该类型允许裸写）。
+ * 比较按基础类型名的小写形式，与 canonical 化后的大小写无关。
+ */
+function typeParamDefault(kind, baseType) {
+    if (!baseType)
+        return undefined;
+    return exports.TYPE_PARAM_DEFAULTS[kind]?.[String(baseType).trim().toLowerCase()];
+}
+//# sourceMappingURL=type-defaults.js.map

package/dist/server/core/schema/type-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-defaults.js","sourceRoot":"","sources":["../../../../server/core/schema/type-defaults.ts"],"names":[],"mappings":";;;AA2EA,4CAGC;AAxDD,6CAA6C;AAC7C,MAAM,WAAW,GAAqC;IACpD,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;IACpC,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;IACpC,mBAAmB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;IACpC,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;IACxB,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;IACxB,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;CACpB,CAAC;AAEW,QAAA,mBAAmB,GAA0D;IACxF,KAAK,EAAE;QACL,0DAA0D;QAC1D,gDAAgD;QAChD,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;QACpC,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;QAClC,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;QACnC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QAClB,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QACnB,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;QACxB,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QACrB,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;KAC3B;IACD,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,WAAW;IACxB,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QACnB,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QACpB,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAC1B,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAC3B,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;KACtB;IACD,KAAK,EAAE;QACL,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;QACpC,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;QACpC,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACxB,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QACnB,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;QACxB,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QACpB,QAAQ,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;QACzB,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;QACrB,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;KAC3B;IACD,OAAO,EAAE,EAAE;IACX,GAAG,EAAE,EAAE;IACP,UAAU,EAAE,EAAE;CACf,CAAC;AAEF;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,IAAiB,EAAE,QAAgB;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,2BAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/server/core/schema/type-defaults.ts

@@ -0,0 +1,79 @@
+/**
+ * 「缺参即非法」的列类型在各方言下的默认参数。
+ *
+ * 背景：前端表单允许只填基础类型名（如 VARCHAR）而不填长度/精度，直接拼接会生成
+ * 非法 SQL——MySQL 的 `VARCHAR` 必须带长度、`DECIMAL` 必须带精度，否则报
+ * ER_PARSE_ERROR。缺参时按本表补齐，保证生成的 DDL 合法。
+ *
+ * 刻意不列默认的情况：
+ *   - SQLite：VARCHAR/DECIMAL 不带长度同样合法，保持原样输出（避免无意义的类型膨胀）；
+ *   - ClickHouse / SAP / MongoDB：类型体系不要求长度，或改表本就不支持。
+ *
+ * 这是全项目唯一的默认参数来源；service 层的 sql-type.helper 已改为复用本表，
+ * 避免两处参数漂移。
+ */
+import type { DialectKind } from '../dialect';
+
+export interface TypeParamDefault {
+  length?: number;
+  precision?: number;
+  scale?: number;
+}
+
+/** PostgreSQL 与 CockroachDB 共用同一套数值/字符默认值 */
+const PG_DEFAULTS: Record<string, TypeParamDefault> = {
+  decimal: { precision: 10, scale: 2 },
+  numeric: { precision: 10, scale: 2 },
+  'character varying': { length: 255 },
+  varchar: { length: 255 },
+  character: { length: 1 },
+  char: { length: 1 }
+};
+
+export const TYPE_PARAM_DEFAULTS: Record<DialectKind, Record<string, TypeParamDefault>> = {
+  mysql: {
+    // 整数刻意不设默认：MySQL 的 INT/TINYINT 等裸写合法，括号里的"显示宽度"自 8.0.17 起
+    // 已废弃，补成 INT(11) 既是无意义噪音，也会与实时结构里的 `int` 产生假差异。
+    decimal: { precision: 10, scale: 2 },
+    float: { precision: 10, scale: 2 },
+    double: { precision: 16, scale: 4 },
+    bit: { length: 1 },
+    char: { length: 1 },
+    varchar: { length: 255 },
+    binary: { length: 1 },
+    varbinary: { length: 255 }
+  },
+  postgres: PG_DEFAULTS,
+  cockroachdb: PG_DEFAULTS,
+  sqlite: {},
+  oracle: {
+    char: { length: 1 },
+    nchar: { length: 1 },
+    varchar2: { length: 4000 },
+    nvarchar2: { length: 2000 },
+    raw: { length: 2000 }
+  },
+  mssql: {
+    decimal: { precision: 18, scale: 0 },
+    numeric: { precision: 18, scale: 0 },
+    float: { precision: 53 },
+    char: { length: 1 },
+    varchar: { length: 255 },
+    nchar: { length: 1 },
+    nvarchar: { length: 255 },
+    binary: { length: 1 },
+    varbinary: { length: 255 }
+  },
+  mongodb: {},
+  sap: {},
+  clickhouse: {}
+};
+
+/**
+ * 取某方言下某类型的默认参数；无默认值返回 undefined（即该类型允许裸写）。
+ * 比较按基础类型名的小写形式，与 canonical 化后的大小写无关。
+ */
+export function typeParamDefault(kind: DialectKind, baseType: string): TypeParamDefault | undefined {
+  if (!baseType) return undefined;
+  return TYPE_PARAM_DEFAULTS[kind]?.[String(baseType).trim().toLowerCase()];
+}

package/dist/server/index.d.ts

@@ -1,2 +1,2 @@
-export declare function handleDatabaseRoutes(pathname: string, body: any): Promise<any>;
+export declare function handleDatabaseRoutes(pathname: string, body: any, headers?: any): Promise<any>;
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../server/index.ts"],"names":[],"mappings":"AAUA,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBA4ZrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../server/index.ts"],"names":[],"mappings":"AAuQA,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,gBA8dpF"}