@tmagic/editor 1.8.0-beta.3 → 1.8.0-beta.4

package/dist/tmagic-editor.umd.cjs

@@ -4331,12 +4331,15 @@
 			await (0, vue.nextTick)();
 			codeBlockEditorRef.value?.show();
 		};
-		const deleteCode = async (key) => {
-			codeBlockService.deleteCodeDslByIds([key]);
+		const deleteCode = async (key, { historySource } = {}) => {
+			codeBlockService.deleteCodeDslByIds([key], { historySource });
 		};
 		const submitCodeBlockHandler = async (values, eventData) => {
 			if (!codeId.value) return;
-			await codeBlockService.setCodeDslById(codeId.value, values, { changeRecords: eventData?.changeRecords });
+			await codeBlockService.setCodeDslById(codeId.value, values, {
+				changeRecords: eventData?.changeRecords,
+				historySource: "props"
+			});
 			codeBlockEditorRef.value?.hide();
 		};
 		return {
@@ -5213,6 +5216,7 @@
 				newContent: payload.newContent ? cloneDeep$1(payload.newContent) : null,
 				changeRecords: payload.changeRecords?.length ? cloneDeep$1(payload.changeRecords) : void 0,
 				historyDescription: payload.historyDescription,
+				source: payload.source,
 				timestamp: Date.now()
 			};
 			this.getCodeBlockUndoRedo(codeBlockId).pushElement(step);
@@ -5231,6 +5235,7 @@
 				newSchema: payload.newSchema ? cloneDeep$1(payload.newSchema) : null,
 				changeRecords: payload.changeRecords?.length ? cloneDeep$1(payload.changeRecords) : void 0,
 				historyDescription: payload.historyDescription,
+				source: payload.source,
 				timestamp: Date.now()
 			};
 			this.getDataSourceUndoRedo(dataSourceId).pushElement(step);
@@ -6330,7 +6335,7 @@
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @returns 添加后的节点
 		*/
-		async add(addNode, parent, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false, historyDescription } = {}) {
+		async add(addNode, parent, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false, historyDescription, historySource } = {}) {
 			this.captureSelectionBeforeOp();
 			const stage = this.get("stage");
 			const addNodes = [];
@@ -6364,16 +6369,21 @@
 			if (!((0, _tmagic_utils.isPage)(newNodes[0]) || (0, _tmagic_utils.isPageFragment)(newNodes[0]))) {
 				const pageForOp = this.getNodeInfo(newNodes[0].id, false).page;
 				if (!doNotPushHistory) this.pushOpHistory("add", {
-					nodes: newNodes.map((n) => cloneDeep$1((0, vue.toRaw)(n))),
-					parentId: (this.getParentById(newNodes[0].id, false) ?? this.get("root")).id,
-					indexMap: Object.fromEntries(newNodes.map((n) => {
-						const p = this.getParentById(n.id, false);
-						return [n.id, p ? getNodeIndex(n.id, p) : -1];
-					}))
-				}, {
-					name: pageForOp?.name || "",
-					id: pageForOp.id
-				}, historyDescription);
+					extra: {
+						nodes: newNodes.map((n) => cloneDeep$1((0, vue.toRaw)(n))),
+						parentId: (this.getParentById(newNodes[0].id, false) ?? this.get("root")).id,
+						indexMap: Object.fromEntries(newNodes.map((n) => {
+							const p = this.getParentById(n.id, false);
+							return [n.id, p ? getNodeIndex(n.id, p) : -1];
+						}))
+					},
+					pageData: {
+						name: pageForOp?.name || "",
+						id: pageForOp.id
+					},
+					historyDescription,
+					source: historySource
+				});
 				else this.selectionBeforeOp = null;
 			}
 			this.emit("add", newNodes);
@@ -6440,7 +6450,7 @@
 		* @param options.doNotSwitchPage 删除后是否不切换当前页面（默认 false；删除页面 / 页面片段时为 true 会跳过自动切换到首个剩余页面）
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		*/
-		async remove(nodeOrNodeList, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false, historyDescription } = {}) {
+		async remove(nodeOrNodeList, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false, historyDescription, historySource } = {}) {
 			this.captureSelectionBeforeOp();
 			const nodes = Array.isArray(nodeOrNodeList) ? nodeOrNodeList : [nodeOrNodeList];
 			const removedItems = [];
@@ -6464,7 +6474,12 @@
 				doNotSelect,
 				doNotSwitchPage
 			})));
-			if (removedItems.length > 0 && pageForOp) if (!doNotPushHistory) this.pushOpHistory("remove", { removedItems }, pageForOp, historyDescription);
+			if (removedItems.length > 0 && pageForOp) if (!doNotPushHistory) this.pushOpHistory("remove", {
+				extra: { removedItems },
+				pageData: pageForOp,
+				historyDescription,
+				source: historySource
+			});
 			else this.selectionBeforeOp = null;
 			this.emit("remove", nodes);
 		}
@@ -6525,7 +6540,7 @@
 		*/
 		async update(config, data = {}) {
 			this.captureSelectionBeforeOp();
-			const { doNotPushHistory = false, changeRecordList, changeRecords, historyDescription } = data;
+			const { doNotPushHistory = false, changeRecordList, changeRecords, historyDescription, historySource } = data;
 			const nodes = Array.isArray(config) ? config : [config];
 			const updateData = await Promise.all(nodes.map((node, index) => {
 				const recordsForNode = changeRecordList ? changeRecordList[index] ?? [] : changeRecords ?? [];
@@ -6534,14 +6549,19 @@
 			if (updateData[0].oldNode?.type !== _tmagic_core.NodeType.ROOT) {
 				if (this.get("nodes").length) if (!doNotPushHistory) {
 					const pageForOp = this.getNodeInfo(nodes[0].id, false).page;
-					this.pushOpHistory("update", { updatedItems: updateData.map((d) => ({
-						oldNode: cloneDeep$1(d.oldNode),
-						newNode: cloneDeep$1((0, vue.toRaw)(d.newNode)),
-						changeRecords: d.changeRecords?.length ? cloneDeep$1(d.changeRecords) : void 0
-					})) }, {
-						name: pageForOp?.name || "",
-						id: pageForOp.id
-					}, historyDescription);
+					this.pushOpHistory("update", {
+						extra: { updatedItems: updateData.map((d) => ({
+							oldNode: cloneDeep$1(d.oldNode),
+							newNode: cloneDeep$1((0, vue.toRaw)(d.newNode)),
+							changeRecords: d.changeRecords?.length ? cloneDeep$1(d.changeRecords) : void 0
+						})) },
+						pageData: {
+							name: pageForOp?.name || "",
+							id: pageForOp.id
+						},
+						historyDescription,
+						source: historySource
+					});
 				} else this.selectionBeforeOp = null;
 			}
 			this.emit("update", updateData);
@@ -6557,7 +6577,7 @@
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @returns void
 		*/
-		async sort(id1, id2, { doNotSelect = false, doNotPushHistory = false } = {}) {
+		async sort(id1, id2, { doNotSelect = false, doNotPushHistory = false, historySource } = {}) {
 			this.captureSelectionBeforeOp();
 			const root = this.get("root");
 			if (!root) throw new Error("root为空");
@@ -6569,7 +6589,10 @@
 			if (index2 < 0) return;
 			const index1 = parent.items.findIndex((node) => `${node.id}` === `${id1}`);
 			parent.items.splice(index2, 0, ...parent.items.splice(index1, 1));
-			await this.update(parent, { doNotPushHistory });
+			await this.update(parent, {
+				doNotPushHistory,
+				historySource
+			});
 			if (!doNotSelect) await this.select(node);
 			this.get("stage")?.update({
 				config: cloneDeep$1(node),
@@ -6605,7 +6628,7 @@
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @returns 添加后的组件节点配置
 		*/
-		async paste(position = {}, collectorOptions, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false } = {}) {
+		async paste(position = {}, collectorOptions, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const config = storage_default.getItem(COPY_STORAGE_KEY);
 			if (!Array.isArray(config)) return;
 			const node = this.get("node");
@@ -6619,7 +6642,9 @@
 			return this.add(pasteConfigs, parent, {
 				doNotSelect,
 				doNotSwitchPage,
-				doNotPushHistory
+				doNotPushHistory,
+				historyDescription,
+				historySource
 			});
 		}
 		async doPaste(config, position = {}) {
@@ -6647,11 +6672,15 @@
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @returns 当前组件节点配置
 		*/
-		async alignCenter(config, { doNotSelect = false, doNotPushHistory = false } = {}) {
+		async alignCenter(config, { doNotSelect = false, doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const nodes = Array.isArray(config) ? config : [config];
 			const stage = this.get("stage");
 			const newNodes = await Promise.all(nodes.map((node) => this.doAlignCenter(node)));
-			const newNode = await this.update(newNodes, { doNotPushHistory });
+			const newNode = await this.update(newNodes, {
+				doNotPushHistory,
+				historyDescription,
+				historySource
+			});
 			if (!doNotSelect) if (newNodes.length > 1) await stage?.multiSelect(newNodes.map((node) => node.id));
 			else await stage?.select(newNodes[0].id);
 			return newNode;
@@ -6662,7 +6691,7 @@
 		* @param options 可选配置
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		*/
-		async moveLayer(offset, { doNotPushHistory = false } = {}) {
+		async moveLayer(offset, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 			this.captureSelectionBeforeOp();
 			const root = this.get("root");
 			if (!root) throw new Error("root为空");
@@ -6687,12 +6716,17 @@
 			this.addModifiedNodeId(parent.id);
 			if (!doNotPushHistory) {
 				const pageForOp = this.getNodeInfo(node.id, false).page;
-				this.pushOpHistory("update", { updatedItems: [{
-					oldNode: oldParent,
-					newNode: cloneDeep$1((0, vue.toRaw)(parent))
-				}] }, {
-					name: pageForOp?.name || "",
-					id: pageForOp.id
+				this.pushOpHistory("update", {
+					extra: { updatedItems: [{
+						oldNode: oldParent,
+						newNode: cloneDeep$1((0, vue.toRaw)(parent))
+					}] },
+					pageData: {
+						name: pageForOp?.name || "",
+						id: pageForOp.id
+					},
+					historyDescription,
+					source: historySource
 				});
 			} else this.selectionBeforeOp = null;
 			this.emit("move-layer", offset);
@@ -6711,7 +6745,7 @@
 		* @param options.doNotSwitchPage 移动后是否不切换当前页面（默认 false；目标容器位于其它页面时为 true 会跳过自动选中以避免页面切换）
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		*/
-		async moveToContainer(config, targetId, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false } = {}) {
+		async moveToContainer(config, targetId, { doNotSelect = false, doNotSwitchPage = false, doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const isBatch = Array.isArray(config);
 			const configs = (isBatch ? config : [config]).filter((item) => !((0, _tmagic_utils.isPage)(item) || (0, _tmagic_utils.isPageFragment)(item)));
 			if (configs.length === 0) throw new Error("没有可移动的节点");
@@ -6759,11 +6793,16 @@
 					name: "",
 					id: target.id
 				};
-				this.pushOpHistory("update", { updatedItems }, historyPage);
+				this.pushOpHistory("update", {
+					extra: { updatedItems },
+					pageData: historyPage,
+					historyDescription,
+					source: historySource
+				});
 			} else this.selectionBeforeOp = null;
 			return isBatch ? newConfigs : newConfigs[0];
 		}
-		async dragTo(config, targetParent, targetIndex, { doNotPushHistory = false } = {}) {
+		async dragTo(config, targetParent, targetIndex, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 			this.captureSelectionBeforeOp();
 			if (!targetParent || !Array.isArray(targetParent.items)) return;
 			const configs = Array.isArray(config) ? config : [config];
@@ -6805,9 +6844,14 @@
 			}
 			if (!doNotPushHistory) {
 				const pageForOp = this.getNodeInfo(configs[0].id, false).page;
-				this.pushOpHistory("update", { updatedItems }, {
-					name: pageForOp?.name || "",
-					id: pageForOp.id
+				this.pushOpHistory("update", {
+					extra: { updatedItems },
+					pageData: {
+						name: pageForOp?.name || "",
+						id: pageForOp.id
+					},
+					historyDescription,
+					source: historySource
 				});
 			} else this.selectionBeforeOp = null;
 			this.emit("drag-to", {
@@ -6855,6 +6899,10 @@
 			if (!entry?.applied) return null;
 			const { step } = entry;
 			if (!this.get("root")) return null;
+			if (step.opType === "update") {
+				const items = step.updatedItems ?? [];
+				if (!items.length || !items.every((item) => item.changeRecords?.length)) return null;
+			}
 			let revertedStep = null;
 			const captureRevert = (s) => {
 				revertedStep = s;
@@ -6864,7 +6912,8 @@
 			const opts = {
 				doNotSelect: true,
 				doNotSwitchPage: true,
-				historyDescription
+				historyDescription,
+				historySource: "rollback"
 			};
 			try {
 				switch (step.opType) {
@@ -6900,7 +6949,10 @@
 							}
 							return cloneDeep$1(oldNode);
 						});
-						if (configs.length) await this.update(configs, { historyDescription });
+						if (configs.length) await this.update(configs, {
+							historyDescription,
+							historySource: "rollback"
+						});
 						break;
 					}
 				}
@@ -6934,7 +6986,7 @@
 			}
 			return cursor;
 		}
-		async move(left, top, { doNotPushHistory = false } = {}) {
+		async move(left, top, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const node = (0, vue.toRaw)(this.get("node"));
 			if (!node || (0, _tmagic_utils.isPage)(node)) return;
 			const newStyle = calcMoveStyle(node.style || {}, left, top);
@@ -6943,7 +6995,11 @@
 				id: node.id,
 				type: node.type,
 				style: newStyle
-			}, { doNotPushHistory });
+			}, {
+				doNotPushHistory,
+				historyDescription,
+				historySource
+			});
 		}
 		resetState() {
 			this.set("root", null);
@@ -6983,7 +7039,7 @@
 			if (this.selectionBeforeOp) return;
 			this.selectionBeforeOp = this.get("nodes").map((n) => n.id);
 		}
-		pushOpHistory(opType, extra, pageData, historyDescription) {
+		pushOpHistory(opType, { extra, pageData, historyDescription, source }) {
 			const step = {
 				data: pageData,
 				opType,
@@ -6993,6 +7049,7 @@
 				...extra
 			};
 			if (historyDescription) step.historyDescription = historyDescription;
+			if (source) step.source = source;
 			history_default.push(step, pageData.id);
 			this.selectionBeforeOp = null;
 		}
@@ -7319,14 +7376,17 @@
 				changeRecordList.push(buildChangeRecords(style, "style"));
 			});
 			if (configs.length === 0) return;
-			editor_default.update(configs, { changeRecordList });
+			editor_default.update(configs, {
+				changeRecordList,
+				historySource: "stage"
+			});
 		});
 		stage.on("sort", (ev) => {
-			editor_default.sort(ev.src, ev.dist);
+			editor_default.sort(ev.src, ev.dist, { historySource: "stage" });
 		});
 		stage.on("remove", (ev) => {
 			const nodes = ev.data.map(({ el }) => editor_default.getNodeById((0, _tmagic_utils.getIdFromEl)()(el) || ""));
-			editor_default.remove(nodes.filter((node) => Boolean(node)));
+			editor_default.remove(nodes.filter((node) => Boolean(node)), { historySource: "stage" });
 		});
 		stage.on("select-parent", () => {
 			const parent = editor_default.get("parent");
@@ -9433,6 +9493,28 @@
 			default: return "修改";
 		}
 	};
+	/** 内置操作途径的中文文案；自定义来源直接回显原值，未知 / 缺省返回空串（UI 据此不渲染）。 */
+	var HISTORY_SOURCE_LABELS = {
+		stage: "画布",
+		tree: "树面板",
+		"component-panel": "组件面板",
+		props: "配置面板",
+		code: "源码",
+		"stage-contextmenu": "画布菜单",
+		"tree-contextmenu": "树菜单",
+		toolbar: "工具栏",
+		shortcut: "快捷键",
+		rollback: "回滚",
+		api: "接口",
+		ai: "AI",
+		unknown: "未知"
+	};
+	/** 操作途径文案：用于历史面板展示「画布 / 树面板 / 配置面板…」标签。 */
+	var sourceLabel = (source = "unknown") => {
+		return HISTORY_SOURCE_LABELS[source] ?? `${source}`;
+	};
+	/** 取一组历史步骤里最后一步（最近一次）的操作途径，用于组头部展示。 */
+	var groupSource = (group) => group.steps[group.steps.length - 1]?.step.source;
 	var nameOf = (node) => node?.name || node?.type || `${node?.id ?? ""}`;
 	/**
 	* 默认描述里展示「名称 (id: xxx)」，便于区分同名实体。
@@ -9528,27 +9610,59 @@
 		const target = labelWithId(group.steps[group.steps.length - 1].step.newContent?.name || group.steps[0].step.oldContent?.name, group.id);
 		return pathList ? `修改 ${target} · ${pathList}${paths.size > 3 ? "…" : ""}` : `修改 ${target}`;
 	};
+	/**
+	* 页面 step 是否支持「回滚」（类 git revert）：
+	* - 新增 / 删除：不依赖 changeRecords，反向应用即删除 / 加回，始终可回滚；
+	* - 更新：必须每个被更新节点都带有 changeRecords，才支持按 propPath 局部反向 patch。
+	*   缺失 changeRecords 的更新只能整节点替换，会冲掉该节点后续的无关变更，因此不支持回滚。
+	*/
+	var isPageStepRevertable = (step) => {
+		if (step.opType !== "update") return true;
+		const items = step.updatedItems ?? [];
+		if (!items.length) return false;
+		return items.every((item) => Boolean(item.changeRecords?.length));
+	};
+	/**
+	* 数据源 step 是否支持「回滚」：
+	* - 新增（oldSchema=null）/ 删除（newSchema=null）：不依赖 changeRecords，始终可回滚；
+	* - 更新（前后 schema 都存在）：必须有 changeRecords 才支持局部反向 patch，否则不支持回滚。
+	*/
+	var isDataSourceStepRevertable = (step) => {
+		if (step.oldSchema === null || step.newSchema === null) return true;
+		return Boolean(step.changeRecords?.length);
+	};
+	/**
+	* 代码块 step 是否支持「回滚」：
+	* - 新增（oldContent=null）/ 删除（newContent=null）：不依赖 changeRecords，始终可回滚；
+	* - 更新（前后 content 都存在）：必须有 changeRecords 才支持局部反向 patch，否则不支持回滚。
+	*/
+	var isCodeBlockStepRevertable = (step) => {
+		if (step.oldContent === null || step.newContent === null) return true;
+		return Boolean(step.changeRecords?.length);
+	};
 	//#endregion
 	//#region packages/editor/src/layouts/history-list/GroupRow.vue?vue&type=script&setup=true&lang.ts
 	var _hoisted_1$61 = ["title"];
 	var _hoisted_2$21 = ["title"];
 	var _hoisted_3$8 = { class: "m-editor-history-list-item-desc" };
 	var _hoisted_4$7 = ["title"];
-	var _hoisted_5$3 = {
-		key: 1,
+	var _hoisted_5$3 = ["title"];
+	var _hoisted_6$3 = {
+		key: 2,
 		class: "m-editor-history-list-item-merge"
 	};
-	var _hoisted_6$3 = {
+	var _hoisted_7$1 = {
 		key: 0,
 		class: "m-editor-history-list-substeps"
 	};
-	var _hoisted_7$1 = ["title"];
-	var _hoisted_8 = { class: "m-editor-history-list-item-index" };
-	var _hoisted_9 = { class: "m-editor-history-list-substep-desc" };
-	var _hoisted_10 = ["title"];
-	var _hoisted_11 = ["onClick"];
-	var _hoisted_12 = ["onClick"];
+	var _hoisted_8 = ["title"];
+	var _hoisted_9 = { class: "m-editor-history-list-item-index" };
+	var _hoisted_10 = { class: "m-editor-history-list-substep-desc" };
+	var _hoisted_11 = ["title"];
+	var _hoisted_12 = ["title"];
 	var _hoisted_13 = ["onClick"];
+	var _hoisted_14 = ["onClick"];
+	var _hoisted_15 = ["onClick"];
 	var GroupRow_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		name: "MEditorHistoryListGroupRow",
 		__name: "GroupRow",
@@ -9558,6 +9672,7 @@
 			merged: { type: Boolean },
 			opType: {},
 			desc: {},
+			source: {},
 			time: {},
 			timeTitle: {},
 			stepCount: {},
@@ -9656,35 +9771,40 @@
 					}, (0, vue.toDisplayString)(headIndexLabel.value), 9, _hoisted_2$21),
 					(0, vue.createElementVNode)("span", { class: (0, vue.normalizeClass)(["m-editor-history-list-item-op", `op-${__props.opType}`]) }, (0, vue.toDisplayString)((0, vue.unref)(opLabel)(__props.opType)), 3),
 					(0, vue.createElementVNode)("span", _hoisted_3$8, (0, vue.toDisplayString)(__props.desc), 1),
-					__props.time ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
+					!__props.merged && (0, vue.unref)(sourceLabel)(__props.source) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
 						key: 0,
+						class: "m-editor-history-list-item-source",
+						title: `操作途径：${(0, vue.unref)(sourceLabel)(__props.source)}`
+					}, (0, vue.toDisplayString)((0, vue.unref)(sourceLabel)(__props.source)), 9, _hoisted_4$7)) : (0, vue.createCommentVNode)("v-if", true),
+					!__props.merged && __props.time ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
+						key: 1,
 						class: "m-editor-history-list-item-time",
 						title: __props.timeTitle || __props.time
-					}, (0, vue.toDisplayString)(__props.time), 9, _hoisted_4$7)) : (0, vue.createCommentVNode)("v-if", true),
-					__props.merged ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_5$3, "合并 " + (0, vue.toDisplayString)(__props.stepCount) + " 步", 1)) : (0, vue.createCommentVNode)("v-if", true),
+					}, (0, vue.toDisplayString)(__props.time), 9, _hoisted_5$3)) : (0, vue.createCommentVNode)("v-if", true),
+					__props.merged ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_6$3, "合并 " + (0, vue.toDisplayString)(__props.stepCount) + " 步", 1)) : (0, vue.createCommentVNode)("v-if", true),
 					!__props.merged && headRevertable.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
-						key: 2,
+						key: 3,
 						class: "m-editor-history-list-item-revert",
 						title: "将该步骤的修改作为一次新操作反向应用（不影响后续历史）",
 						onClick: _cache[0] || (_cache[0] = (0, vue.withModifiers)(($event) => onRevertClick(__props.subSteps[0].index), ["stop"]))
 					}, "回滚")) : (0, vue.createCommentVNode)("v-if", true),
 					!__props.merged && __props.gotoEnabled && !__props.isCurrent && __props.subSteps.length ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
-						key: 3,
+						key: 4,
 						class: "m-editor-history-list-item-goto",
 						title: "回到该记录",
 						onClick: _cache[1] || (_cache[1] = (0, vue.withModifiers)(($event) => onGotoClick(__props.subSteps[0].index), ["stop"]))
 					}, "回到")) : (0, vue.createCommentVNode)("v-if", true),
 					!__props.merged && headDiffable.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
-						key: 4,
+						key: 5,
 						class: "m-editor-history-list-item-diff",
 						title: "查看修改差异",
 						onClick: _cache[2] || (_cache[2] = (0, vue.withModifiers)(($event) => onDiffClick(__props.subSteps[0].index), ["stop"]))
 					}, "查看差异")) : (0, vue.createCommentVNode)("v-if", true),
 					__props.merged ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
-						key: 5,
+						key: 6,
 						class: (0, vue.normalizeClass)(["m-editor-history-list-group-toggle", { "is-expanded": __props.expanded }])
 					}, "▾", 2)) : (0, vue.createCommentVNode)("v-if", true)
-				], 10, _hoisted_1$61), __props.merged && __props.expanded ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("ul", _hoisted_6$3, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(subStepsDisplay.value, (s) => {
+				], 10, _hoisted_1$61), __props.merged && __props.expanded ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("ul", _hoisted_7$1, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(subStepsDisplay.value, (s) => {
 					return (0, vue.openBlock)(), (0, vue.createElementBlock)("li", {
 						key: s.index,
 						class: (0, vue.normalizeClass)({
@@ -9693,32 +9813,37 @@
 						}),
 						title: subStepTitle(s)
 					}, [
-						(0, vue.createElementVNode)("span", _hoisted_8, "#" + (0, vue.toDisplayString)(s.index + 1), 1),
-						(0, vue.createElementVNode)("span", _hoisted_9, (0, vue.toDisplayString)(s.desc), 1),
-						s.time ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
+						(0, vue.createElementVNode)("span", _hoisted_9, "#" + (0, vue.toDisplayString)(s.index + 1), 1),
+						(0, vue.createElementVNode)("span", _hoisted_10, (0, vue.toDisplayString)(s.desc), 1),
+						(0, vue.unref)(sourceLabel)(s.source) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
 							key: 0,
+							class: "m-editor-history-list-item-source",
+							title: `操作途径：${(0, vue.unref)(sourceLabel)(s.source)}`
+						}, (0, vue.toDisplayString)((0, vue.unref)(sourceLabel)(s.source)), 9, _hoisted_11)) : (0, vue.createCommentVNode)("v-if", true),
+						s.time ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
+							key: 1,
 							class: "m-editor-history-list-item-time",
 							title: s.timeTitle || s.time
-						}, (0, vue.toDisplayString)(s.time), 9, _hoisted_10)) : (0, vue.createCommentVNode)("v-if", true),
+						}, (0, vue.toDisplayString)(s.time), 9, _hoisted_12)) : (0, vue.createCommentVNode)("v-if", true),
 						s.revertable ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
-							key: 1,
+							key: 2,
 							class: "m-editor-history-list-item-revert",
 							title: "将该步骤的修改作为一次新操作反向应用（不影响后续历史）",
 							onClick: (0, vue.withModifiers)(($event) => onRevertClick(s.index), ["stop"])
-						}, "回滚", 8, _hoisted_11)) : (0, vue.createCommentVNode)("v-if", true),
+						}, "回滚", 8, _hoisted_13)) : (0, vue.createCommentVNode)("v-if", true),
 						__props.gotoEnabled && !s.isCurrent ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
-							key: 2,
+							key: 3,
 							class: "m-editor-history-list-item-goto",
 							title: "回到该记录",
 							onClick: (0, vue.withModifiers)(($event) => onGotoClick(s.index), ["stop"])
-						}, "回到", 8, _hoisted_12)) : (0, vue.createCommentVNode)("v-if", true),
+						}, "回到", 8, _hoisted_14)) : (0, vue.createCommentVNode)("v-if", true),
 						s.diffable ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", {
-							key: 3,
+							key: 4,
 							class: "m-editor-history-list-item-diff",
 							title: "查看修改差异",
 							onClick: (0, vue.withModifiers)(($event) => onDiffClick(s.index), ["stop"])
-						}, "查看差异", 8, _hoisted_13)) : (0, vue.createCommentVNode)("v-if", true)
-					], 10, _hoisted_7$1);
+						}, "查看差异", 8, _hoisted_15)) : (0, vue.createCommentVNode)("v-if", true)
+					], 10, _hoisted_8);
 				}), 128))])) : (0, vue.createCommentVNode)("v-if", true)], 2);
 			};
 		}
@@ -9802,6 +9927,7 @@
 			describeGroup: {},
 			describeStep: {},
 			isStepDiffable: {},
+			isStepRevertable: {},
 			expanded: {},
 			gotoEnabled: {
 				type: Boolean,
@@ -9833,6 +9959,7 @@
 							merged: group.steps.length > 1,
 							"op-type": group.opType,
 							desc: __props.describeGroup(group),
+							source: (0, vue.unref)(groupSource)(group),
 							time: (0, vue.unref)(formatHistoryTime)((0, vue.unref)(groupTimestamp)(group)),
 							"time-title": (0, vue.unref)(formatHistoryFullTime)((0, vue.unref)(groupTimestamp)(group)),
 							"step-count": group.steps.length,
@@ -9842,7 +9969,8 @@
 								isCurrent: s.isCurrent,
 								desc: __props.describeStep(s.step),
 								diffable: __props.isStepDiffable ? __props.isStepDiffable(s.step) : false,
-								revertable: s.applied,
+								revertable: s.applied && (__props.isStepRevertable ? __props.isStepRevertable(s.step) : true),
+								source: s.step.source,
 								time: (0, vue.unref)(formatHistoryTime)(s.step.timestamp),
 								timeTitle: (0, vue.unref)(formatHistoryFullTime)(s.step.timestamp)
 							})),
@@ -9859,6 +9987,7 @@
 							"merged",
 							"op-type",
 							"desc",
+							"source",
 							"time",
 							"time-title",
 							"step-count",
@@ -9898,6 +10027,7 @@
 			describeGroup: {},
 			describeStep: {},
 			isStepDiffable: {},
+			isStepRevertable: {},
 			expanded: {},
 			gotoEnabled: {
 				type: Boolean,
@@ -9927,6 +10057,7 @@
 							"describe-group": __props.describeGroup,
 							"describe-step": __props.describeStep,
 							"is-step-diffable": __props.isStepDiffable,
+							"is-step-revertable": __props.isStepRevertable,
 							expanded: __props.expanded,
 							"goto-enabled": __props.gotoEnabled,
 							onToggle: _cache[0] || (_cache[0] = (key) => _ctx.$emit("toggle", key)),
@@ -9942,6 +10073,7 @@
 							"describe-group",
 							"describe-step",
 							"is-step-diffable",
+							"is-step-revertable",
 							"expanded",
 							"goto-enabled"
 						]);
@@ -10030,6 +10162,20 @@
 				}
 				return !isEqual(curValue, lastValue);
 			};
+			const removeStyleDisplayConfig = (formConfig) => formConfig.map((item) => {
+				if (!("type" in item)) return item;
+				if (item?.type !== "tab" || !Array.isArray(item.items)) return item;
+				return {
+					...item,
+					items: item.items.map((tabPane) => {
+						if (tabPane?.title !== "样式" || !Array.isArray(tabPane.items)) return tabPane;
+						return {
+							...tabPane,
+							display: true
+						};
+					})
+				};
+			});
 			/**
 			* 内置的默认 FormConfig 加载逻辑：按 `category` 从对应 service / 工具取配置。
 			* 作为 ctx.defaultLoadConfig 透传给自定义 `loadConfig`，方便复用与二次加工。
@@ -10038,7 +10184,7 @@
 				switch (props.category) {
 					case "node":
 						if (!props.type) return [];
-						return await propsService.getPropsConfig(props.type);
+						return removeStyleDisplayConfig(await propsService.getPropsConfig(props.type));
 					case "data-source": return dataSourceService.getFormConfig(props.type || "base");
 					case "code-block": return getCodeBlockFormConfig({
 						paramColConfig: codeBlockService.getParamsColConfig(),
@@ -10207,11 +10353,13 @@
 			};
 			const targetText = (0, vue.computed)(() => {
 				if (!payload.value) return "";
-				const prefix = {
+				const categoryText = {
 					node: "节点",
 					"data-source": "数据源",
 					"code-block": "代码块"
-				}[payload.value.category] || "";
+				};
+				const { category } = payload.value;
+				const prefix = category ? categoryText[category] : "";
 				const label = payload.value.targetLabel || payload.value.type || "";
 				const { id } = payload.value;
 				return [prefix, id !== void 0 && id !== "" ? `${label}（${id}）` : label].filter(Boolean).join("：");
@@ -10418,6 +10566,7 @@
 								merged: group.steps.length > 1,
 								"op-type": group.opType,
 								desc: (0, vue.unref)(describePageGroup)(group),
+								source: (0, vue.unref)(groupSource)(group),
 								time: (0, vue.unref)(formatHistoryTime)((0, vue.unref)(groupTimestamp)(group)),
 								"time-title": (0, vue.unref)(formatHistoryFullTime)((0, vue.unref)(groupTimestamp)(group)),
 								"step-count": group.steps.length,
@@ -10427,7 +10576,8 @@
 									isCurrent: s.isCurrent,
 									desc: (0, vue.unref)(describePageStep)(s.step),
 									diffable: isPageStepDiffable(s.step),
-									revertable: s.applied,
+									revertable: s.applied && (0, vue.unref)(isPageStepRevertable)(s.step),
+									source: s.step.source,
 									time: (0, vue.unref)(formatHistoryTime)(s.step.timestamp),
 									timeTitle: (0, vue.unref)(formatHistoryFullTime)(s.step.timestamp)
 								})),
@@ -10443,6 +10593,7 @@
 								"merged",
 								"op-type",
 								"desc",
+								"source",
 								"time",
 								"time-title",
 								"step-count",
@@ -10733,6 +10884,7 @@
 									"describe-group": (0, vue.unref)(describeDataSourceGroup),
 									"describe-step": (0, vue.unref)(describeDataSourceStep),
 									"is-step-diffable": isDataSourceStepDiffable,
+									"is-step-revertable": (0, vue.unref)(isDataSourceStepRevertable),
 									onToggle: (0, vue.unref)(toggleGroup),
 									onGoto: onDataSourceGoto,
 									onGotoInitial: onDataSourceGotoInitial,
@@ -10743,6 +10895,7 @@
 									"expanded",
 									"describe-group",
 									"describe-step",
+									"is-step-revertable",
 									"onToggle"
 								])]),
 								_: 1
@@ -10759,6 +10912,7 @@
 									"describe-group": (0, vue.unref)(describeCodeBlockGroup),
 									"describe-step": (0, vue.unref)(describeCodeBlockStep),
 									"is-step-diffable": isCodeBlockStepDiffable,
+									"is-step-revertable": (0, vue.unref)(isCodeBlockStepRevertable),
 									onToggle: (0, vue.unref)(toggleGroup),
 									onGoto: onCodeBlockGoto,
 									onGotoInitial: onCodeBlockGotoInitial,
@@ -10769,6 +10923,7 @@
 									"expanded",
 									"describe-group",
 									"describe-step",
+									"is-step-revertable",
 									"onToggle"
 								])]),
 								_: 1
@@ -11038,7 +11193,7 @@
 							disabled: () => editorService.get("node")?.type === _tmagic_core.NodeType.PAGE,
 							handler: () => {
 								const node = editorService.get("node");
-								node && editorService.remove(node);
+								node && editorService.remove(node, { historySource: "toolbar" });
 							}
 						});
 						break;
@@ -11402,7 +11557,11 @@
 							if (record.propPath?.startsWith("style") && record.value === "") (0, _tmagic_utils.setValueByKeyPath)(record.propPath, record.value, newValue);
 						});
 					}
-					editorService.update(newValue, { changeRecords: eventData?.changeRecords });
+					const historySource = eventData ? "props" : "code";
+					editorService.update(newValue, {
+						changeRecords: eventData?.changeRecords,
+						historySource
+					});
 				} catch (e) {
 					emit("submit-error", e);
 				}
@@ -12371,7 +12530,7 @@
 			const editCode = (id) => {
 				emit("edit", id);
 			};
-			const deleteCode = async (id) => {
+			const deleteCode = async (id, { historySource } = {}) => {
 				const currentCode = codeList.value.find((codeItem) => codeItem.id === id);
 				const existBinds = Boolean(currentCode?.items?.length);
 				const undeleteableList = codeBlockService.getUndeletableList() || [];
@@ -12381,7 +12540,7 @@
 						cancelButtonText: "取消",
 						type: "warning"
 					});
-					emit("remove", id);
+					emit("remove", id, { historySource });
 				} else if (typeof props.customError === "function") props.customError(id, existBinds ? CodeDeleteErrorType.BIND : CodeDeleteErrorType.UNDELETEABLE);
 				else if (existBinds) _tmagic_design.tMagicMessage.error("代码块存在绑定关系，不可删除");
 				else _tmagic_design.tMagicMessage.error("代码块不可删除");
@@ -12431,7 +12590,7 @@
 							default: (0, vue.withCtx)(() => [(0, vue.createVNode)(Icon_default, {
 								icon: (0, vue.unref)(_element_plus_icons_vue.Close),
 								class: "edit-icon",
-								onClick: (0, vue.withModifiers)(($event) => deleteCode(`${data.key}`), ["stop"])
+								onClick: (0, vue.withModifiers)(($event) => deleteCode(`${data.key}`, { historySource: "tree" }), ["stop"])
 							}, null, 8, ["icon", "onClick"])]),
 							_: 2
 						}, 1024)) : (0, vue.createCommentVNode)("v-if", true),
@@ -12479,7 +12638,7 @@
 					const codeBlock = codeBlockService.getCodeContentById(selectId);
 					if (!codeBlock) return;
 					const newCodeId = await codeBlockService.getUniqueId();
-					codeBlockService.setCodeDslById(newCodeId, cloneDeep$1(codeBlock));
+					codeBlockService.setCodeDslById(newCodeId, cloneDeep$1(codeBlock), { historySource: "tree-contextmenu" });
 				}
 			},
 			{
@@ -12541,7 +12700,7 @@
 				if (codeBlockListRef.value) for (const [, status] of codeBlockListRef.value.nodeStatusMap.entries()) status.selected = false;
 			};
 			const { nodeContentMenuHandler, menuData: contentMenuData, contentMenuHideHandler } = useContentMenu$1((id) => {
-				codeBlockListRef.value?.deleteCode(id);
+				codeBlockListRef.value?.deleteCode(id, { historySource: "tree-contextmenu" });
 			});
 			const menuData = (0, vue.computed)(() => props.customContentMenu(contentMenuData, "code-block"));
 			return (_ctx, _cache) => {
@@ -12629,8 +12788,11 @@
 			editDialog.value.show();
 		};
 		const submitDataSourceHandler = (value, eventData) => {
-			if (value.id) dataSourceService.update(value, { changeRecords: eventData.changeRecords });
-			else dataSourceService.add(value);
+			if (value.id) dataSourceService.update(value, {
+				changeRecords: eventData.changeRecords,
+				historySource: "props"
+			});
+			else dataSourceService.add(value, { historySource: "props" });
 			editDialog.value?.hide();
 		};
 		return {
@@ -12963,7 +13125,7 @@
 					if (!selectId) return;
 					const ds = dataSourceService.getDataSourceById(selectId);
 					if (!ds) return;
-					dataSourceService.add(cloneDeep$1(ds));
+					dataSourceService.add(cloneDeep$1(ds), { historySource: "tree-contextmenu" });
 				}
 			},
 			{
@@ -13040,7 +13202,7 @@
 					cancelButtonText: "取消",
 					type: "warning"
 				});
-				dataSourceService.remove(id);
+				dataSourceService.remove(id, { historySource: "tree-contextmenu" });
 			};
 			const dataSourceListRef = (0, vue.useTemplateRef)("dataSourceList");
 			const filterTextChangeHandler = (val) => {
@@ -13147,7 +13309,12 @@
 	var FolderMinusIcon_default = FolderMinusIcon_vue_vue_type_script_setup_true_lang_default;
 	//#endregion
 	//#region packages/editor/src/utils/content-menu.ts
-	var useDeleteMenu = () => ({
+	/**
+	* 共享的右键菜单项构造器（画布 ViewerMenu 与图层树 LayerMenu 共用）。
+	* `historySource` 用于标记本次操作的途径，调用方按所在面板传入：
+	* 画布传 `'stage-contextmenu'`，树形面板传 `'tree-contextmenu'`。
+	*/
+	var useDeleteMenu = (historySource) => ({
 		type: "button",
 		text: "删除",
 		icon: _element_plus_icons_vue.Delete,
@@ -13157,7 +13324,7 @@
 		},
 		handler: ({ editorService }) => {
 			const nodes = editorService.get("nodes");
-			nodes && editorService.remove(nodes);
+			nodes && editorService.remove(nodes, { historySource });
 		}
 	});
 	var useCopyMenu = () => ({
@@ -13169,7 +13336,7 @@
 			nodes && editorService?.copy(nodes);
 		}
 	});
-	var usePasteMenu = (menu) => ({
+	var usePasteMenu = (historySource, menu) => ({
 		type: "button",
 		text: "粘贴",
 		icon: (0, vue.markRaw)(_element_plus_icons_vue.DocumentCopy),
@@ -13186,17 +13353,20 @@
 				editorService.paste({
 					left: initialLeft,
 					top: initialTop
-				});
-			} else editorService.paste();
+				}, void 0, { historySource });
+			} else editorService.paste(void 0, void 0, { historySource });
 		}
 	});
-	var moveTo = async (id, { editorService }) => {
+	var moveTo = async (id, { editorService }, historySource) => {
 		const nodes = editorService.get("nodes") || [];
 		const parent = editorService.getNodeById(id);
 		if (!parent || nodes.length === 0) return;
-		await editorService.moveToContainer((0, _tmagic_core.cloneDeep)(nodes), parent.id, { doNotSwitchPage: true });
+		await editorService.moveToContainer((0, _tmagic_core.cloneDeep)(nodes), parent.id, {
+			doNotSwitchPage: true,
+			historySource
+		});
 	};
-	var useMoveToMenu = ({ editorService }) => {
+	var useMoveToMenu = ({ editorService }, historySource) => {
 		return {
 			type: "button",
 			text: "移动至",
@@ -13209,7 +13379,7 @@
 				text: `${page.name}(${page.id})`,
 				type: "button",
 				handler: (services) => {
-					moveTo(page.id, services);
+					moveTo(page.id, services, historySource);
 				}
 			}))
 		};
@@ -13242,7 +13412,7 @@
 						name: component.text,
 						type: component.type,
 						...component.data || {}
-					});
+					}, void 0, { historySource: "tree-contextmenu" });
 				}
 			}));
 			const getSubMenuData = (0, vue.computed)(() => {
@@ -13251,7 +13421,7 @@
 					type: "button",
 					icon: _element_plus_icons_vue.Files,
 					handler: () => {
-						editorService.add({ type: "tab-pane" });
+						editorService.add({ type: "tab-pane" }, void 0, { historySource: "tree-contextmenu" });
 					}
 				}];
 				if (node.value?.items) return componentList.value.reduce((subMenuData, group, index) => subMenuData.concat(createMenuItems(group), index < componentList.value.length - 1 ? [{
@@ -13278,9 +13448,9 @@
 					items: getSubMenuData.value
 				},
 				useCopyMenu(),
-				usePasteMenu(),
-				useDeleteMenu(),
-				useMoveToMenu(services),
+				usePasteMenu("tree-contextmenu"),
+				useDeleteMenu("tree-contextmenu"),
+				useMoveToMenu(services, "tree-contextmenu"),
 				...props.layerContentMenu
 			], "layer"));
 			const show = (e) => {
@@ -13311,7 +13481,7 @@
 				editorService.update({
 					id: props.data.id,
 					visible
-				});
+				}, { historySource: "tree" });
 			};
 			return (_ctx, _cache) => {
 				return __props.data.type !== "page" ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicButton), {
@@ -13927,7 +14097,7 @@
 					name: text,
 					type,
 					...data
-				});
+				}, void 0, { historySource: "component-panel" });
 			};
 			const dragstartHandler = ({ text, type, data = {} }, e) => {
 				e.dataTransfer?.setData("text/json", (0, serialize_javascript.default)({
@@ -14732,11 +14902,11 @@
 					display: () => canCenter.value,
 					handler: () => {
 						if (!nodes.value) return;
-						editorService.alignCenter(nodes.value);
+						editorService.alignCenter(nodes.value, { historySource: "stage-contextmenu" });
 					}
 				},
 				useCopyMenu(),
-				usePasteMenu(menuRef),
+				usePasteMenu("stage-contextmenu", menuRef),
 				{
 					type: "divider",
 					direction: "horizontal",
@@ -14751,7 +14921,7 @@
 					icon: (0, vue.markRaw)(_element_plus_icons_vue.Top),
 					display: () => !(0, _tmagic_utils.isPage)(node.value) && !(0, _tmagic_utils.isPageFragment)(node.value) && !props.isMultiSelect,
 					handler: () => {
-						editorService.moveLayer(1);
+						editorService.moveLayer(1, { historySource: "stage-contextmenu" });
 					}
 				},
 				{
@@ -14760,7 +14930,7 @@
 					icon: (0, vue.markRaw)(_element_plus_icons_vue.Bottom),
 					display: () => !(0, _tmagic_utils.isPage)(node.value) && !(0, _tmagic_utils.isPageFragment)(node.value) && !props.isMultiSelect,
 					handler: () => {
-						editorService.moveLayer(-1);
+						editorService.moveLayer(-1, { historySource: "stage-contextmenu" });
 					}
 				},
 				{
@@ -14769,7 +14939,7 @@
 					icon: (0, vue.markRaw)(_element_plus_icons_vue.Top),
 					display: () => !(0, _tmagic_utils.isPage)(node.value) && !(0, _tmagic_utils.isPageFragment)(node.value) && !props.isMultiSelect,
 					handler: () => {
-						editorService.moveLayer(LayerOffset.TOP);
+						editorService.moveLayer(LayerOffset.TOP, { historySource: "stage-contextmenu" });
 					}
 				},
 				{
@@ -14778,16 +14948,16 @@
 					icon: (0, vue.markRaw)(_element_plus_icons_vue.Bottom),
 					display: () => !(0, _tmagic_utils.isPage)(node.value) && !(0, _tmagic_utils.isPageFragment)(node.value) && !props.isMultiSelect,
 					handler: () => {
-						editorService.moveLayer(LayerOffset.BOTTOM);
+						editorService.moveLayer(LayerOffset.BOTTOM, { historySource: "stage-contextmenu" });
 					}
 				},
-				useMoveToMenu(services),
+				useMoveToMenu(services, "stage-contextmenu"),
 				{
 					type: "divider",
 					direction: "horizontal",
 					display: () => !(0, _tmagic_utils.isPage)(node.value) && !(0, _tmagic_utils.isPageFragment)(node.value) && !props.isMultiSelect
 				},
-				useDeleteMenu(),
+				useDeleteMenu("stage-contextmenu"),
 				{
 					type: "divider",
 					direction: "horizontal"
@@ -15044,7 +15214,7 @@
 						left: (0, _tmagic_utils.calcValueByFontsize)(doc, left / zoom.value)
 					};
 					config.data.inputEvent = e;
-					editorService.add(config.data, parent);
+					editorService.add(config.data, parent, { historySource: "component-panel" });
 				}
 			};
 			return (_ctx, _cache) => {
@@ -15332,10 +15502,12 @@
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @returns {void}
 		*/
-		async setCodeDslById(id, codeConfig, { changeRecords, doNotPushHistory = false } = {}) {
+		async setCodeDslById(id, codeConfig, { changeRecords, doNotPushHistory = false, historyDescription, historySource } = {}) {
 			this.setCodeDslByIdSync(id, codeConfig, true, {
 				changeRecords,
-				doNotPushHistory
+				doNotPushHistory,
+				historyDescription,
+				historySource
 			});
 		}
 		/**
@@ -15350,7 +15522,7 @@
 		* @param options.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 		* @returns {void}
 		*/
-		setCodeDslByIdSync(id, codeConfig, force = true, { changeRecords, doNotPushHistory = false, historyDescription } = {}) {
+		setCodeDslByIdSync(id, codeConfig, force = true, { changeRecords, doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const codeDsl = this.getCodeDsl();
 			if (!codeDsl) throw new Error("dsl中没有codeBlocks");
 			if (codeDsl[id] && !force) return;
@@ -15369,7 +15541,8 @@
 				oldContent,
 				newContent,
 				changeRecords,
-				historyDescription
+				historyDescription,
+				source: historySource
 			});
 			this.emit("addOrUpdate", id, codeDsl[id]);
 		}
@@ -15450,7 +15623,7 @@
 		* @param options 可选配置
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		*/
-		async deleteCodeDslByIds(codeIds, { doNotPushHistory = false, historyDescription } = {}) {
+		async deleteCodeDslByIds(codeIds, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const currentDsl = await this.getCodeDsl();
 			if (!currentDsl) return;
 			codeIds.forEach((id) => {
@@ -15459,7 +15632,8 @@
 				if (oldContent && !doNotPushHistory) history_default.pushCodeBlock(id, {
 					oldContent,
 					newContent: null,
-					historyDescription
+					historyDescription,
+					source: historySource
 				});
 				this.emit("remove", id);
 			});
@@ -15539,6 +15713,7 @@
 		async revert(id, index) {
 			const entry = history_default.getCodeBlockStepList(id)[index];
 			if (!entry?.applied) return null;
+			if (entry.step.oldContent && entry.step.newContent && !entry.step.changeRecords?.length) return null;
 			const description = `回滚 #${index + 1}: ${describeRevertCodeBlockStep(entry.step)}`;
 			return await this.applyRevertStep(entry.step, description);
 		}
@@ -15609,11 +15784,17 @@
 		async applyRevertStep(step, historyDescription) {
 			const { id, oldContent, newContent, changeRecords } = step;
 			if (oldContent === null && newContent) {
-				await this.deleteCodeDslByIds([id], { historyDescription });
+				await this.deleteCodeDslByIds([id], {
+					historyDescription,
+					historySource: "rollback"
+				});
 				return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
 			}
 			if (oldContent && newContent === null) {
-				this.setCodeDslByIdSync(id, cloneDeep$1(oldContent), true, { historyDescription });
+				this.setCodeDslByIdSync(id, cloneDeep$1(oldContent), true, {
+					historyDescription,
+					historySource: "rollback"
+				});
 				return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
 			}
 			if (!oldContent || !newContent) return null;
@@ -15632,11 +15813,15 @@
 				}
 				this.setCodeDslByIdSync(id, fallbackToFullReplace ? cloneDeep$1(oldContent) : patched, true, {
 					changeRecords,
-					historyDescription
+					historyDescription,
+					historySource: "rollback"
 				});
 				return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
 			}
-			this.setCodeDslByIdSync(id, cloneDeep$1(oldContent), true, { historyDescription });
+			this.setCodeDslByIdSync(id, cloneDeep$1(oldContent), true, {
+				historyDescription,
+				historySource: "rollback"
+			});
 			return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
 		}
 		/**
@@ -15800,7 +15985,7 @@
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @param options.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 		*/
-		add(config, { doNotPushHistory = false, historyDescription } = {}) {
+		add(config, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const newConfig = {
 				...config,
 				id: config.id && !this.getDataSourceById(config.id) ? config.id : this.createId()
@@ -15809,7 +15994,8 @@
 			if (!doNotPushHistory) history_default.pushDataSource(newConfig.id, {
 				oldSchema: null,
 				newSchema: newConfig,
-				historyDescription
+				historyDescription,
+				source: historySource
 			});
 			this.emit("add", newConfig);
 			return newConfig;
@@ -15822,7 +16008,7 @@
 		* @param data.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @param data.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 		*/
-		update(config, { changeRecords = [], doNotPushHistory = false, historyDescription } = {}) {
+		update(config, { changeRecords = [], doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const dataSources = this.get("dataSources");
 			const index = dataSources.findIndex((ds) => ds.id === config.id);
 			const oldConfig = dataSources[index];
@@ -15832,7 +16018,8 @@
 				oldSchema: oldConfig ? cloneDeep$1(oldConfig) : null,
 				newSchema: newConfig,
 				changeRecords,
-				historyDescription
+				historyDescription,
+				source: historySource
 			});
 			this.emit("update", newConfig, {
 				oldConfig,
@@ -15847,7 +16034,7 @@
 		* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 		* @param options.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 		*/
-		remove(id, { doNotPushHistory = false, historyDescription } = {}) {
+		remove(id, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 			const dataSources = this.get("dataSources");
 			const index = dataSources.findIndex((ds) => ds.id === id);
 			const oldConfig = index !== -1 ? dataSources[index] : null;
@@ -15855,7 +16042,8 @@
 			if (oldConfig && !doNotPushHistory) history_default.pushDataSource(id, {
 				oldSchema: cloneDeep$1(oldConfig),
 				newSchema: null,
-				historyDescription
+				historyDescription,
+				source: historySource
 			});
 			this.emit("remove", id);
 		}
@@ -15927,6 +16115,7 @@
 		revert(id, index) {
 			const entry = history_default.getDataSourceStepList(id)[index];
 			if (!entry?.applied) return null;
+			if (entry.step.oldSchema && entry.step.newSchema && !entry.step.changeRecords?.length) return null;
 			const description = `回滚 #${index + 1}: ${describeRevertDataSourceStep(entry.step)}`;
 			return this.applyRevertStep(entry.step, description);
 		}
@@ -15990,11 +16179,17 @@
 		applyRevertStep(step, historyDescription) {
 			const { id, oldSchema, newSchema, changeRecords } = step;
 			if (oldSchema === null && newSchema) {
-				this.remove(`${id}`, { historyDescription });
+				this.remove(`${id}`, {
+					historyDescription,
+					historySource: "rollback"
+				});
 				return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
 			}
 			if (oldSchema && newSchema === null) {
-				this.add(cloneDeep$1(oldSchema), { historyDescription });
+				this.add(cloneDeep$1(oldSchema), {
+					historyDescription,
+					historySource: "rollback"
+				});
 				return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
 			}
 			if (!oldSchema || !newSchema) return null;
@@ -16013,11 +16208,15 @@
 				}
 				this.update(fallbackToFullReplace ? cloneDeep$1(oldSchema) : patched, {
 					changeRecords,
-					historyDescription
+					historyDescription,
+					historySource: "rollback"
 				});
 				return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
 			}
-			this.update(cloneDeep$1(oldSchema), { historyDescription });
+			this.update(cloneDeep$1(oldSchema), {
+				historyDescription,
+				historySource: "rollback"
+			});
 			return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
 		}
 		/**
@@ -16334,7 +16533,7 @@
 			[KeyBindingCommand.DELETE_NODE]: () => {
 				const nodes = editor_default.get("nodes");
 				if (!nodes || (0, _tmagic_utils.isPage)(nodes[0]) || (0, _tmagic_utils.isPageFragment)(nodes[0])) return;
-				editor_default.remove(nodes);
+				editor_default.remove(nodes, { historySource: "shortcut" });
 			},
 			[KeyBindingCommand.COPY_NODE]: () => {
 				const nodes = editor_default.get("nodes");
@@ -16344,13 +16543,13 @@
 				const nodes = editor_default.get("nodes");
 				if (!nodes || (0, _tmagic_utils.isPage)(nodes[0]) || (0, _tmagic_utils.isPageFragment)(nodes[0])) return;
 				editor_default.copy(nodes);
-				editor_default.remove(nodes);
+				editor_default.remove(nodes, { historySource: "shortcut" });
 			},
 			[KeyBindingCommand.PASTE_NODE]: () => {
 				editor_default.get("nodes") && editor_default.paste({
 					offsetX: 10,
 					offsetY: 10
-				});
+				}, void 0, { historySource: "shortcut" });
 			},
 			[KeyBindingCommand.UNDO]: () => {
 				editor_default.undo();