diff --git a/Control.cpp b/Control.cpp
index a0267f3..2f0090d 100644
--- a/Control.cpp
+++ b/Control.cpp
@@ -162,6 +162,14 @@ namespace
 				<< SX_T(" 原因=当前控件禁止该轴 Stretch", " reason=stretch disabled by capability");
 		}
 	}
+
+	void ActivateExplicitLayoutSpecMode(StellarX::LayoutMode& mode)
+	{
+		// 新公开布局 API 明确属于“按边约束解算”的语义层。
+		// 一旦调用，说明外部希望控件进入统一锚定布局模型，
+		// 因此直接切换到 AnchorToEdges，避免出现“策略已设但 layoutMode 仍是 Fixed”的半失效状态。
+		mode = StellarX::LayoutMode::AnchorToEdges;
+	}
 }
 
 StellarX::ControlText& StellarX::ControlText::operator=(const ControlText& text)
@@ -253,6 +261,56 @@ void Control::setAnchor(StellarX::Anchor anchor_1, StellarX::Anchor anchor_2)
 	this->layoutSpec.horizontal = BuildLegacyAxisSpec(anchor_1, anchor_2, StellarX::Anchor::Left, StellarX::Anchor::Right);
 	this->layoutSpec.vertical = BuildLegacyAxisSpec(anchor_1, anchor_2, StellarX::Anchor::Top, StellarX::Anchor::Bottom);
 }
+void Control::setHorizontalLayoutSpec(const StellarX::AxisLayoutSpec& spec)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.horizontal = spec;
+}
+
+void Control::setVerticalLayoutSpec(const StellarX::AxisLayoutSpec& spec)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.vertical = spec;
+}
+
+void Control::setHorizontalAnchors(bool left, bool right)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.horizontal.anchorStart = left;
+	this->layoutSpec.horizontal.anchorEnd = right;
+}
+
+void Control::setVerticalAnchors(bool top, bool bottom)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.vertical.anchorStart = top;
+	this->layoutSpec.vertical.anchorEnd = bottom;
+}
+
+void Control::setHorizontalSizePolicy(StellarX::AxisSizePolicy policy)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.horizontal.sizePolicy = policy;
+}
+
+void Control::setVerticalSizePolicy(StellarX::AxisSizePolicy policy)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.vertical.sizePolicy = policy;
+}
+
+void Control::setHorizontalAlignPolicy(StellarX::AxisAlignPolicy policy)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.horizontal.alignPolicy = policy;
+}
+
+void Control::setVerticalAlignPolicy(StellarX::AxisAlignPolicy policy)
+{
+	ActivateExplicitLayoutSpecMode(this->layoutMode);
+	this->layoutSpec.vertical.alignPolicy = policy;
+}
+
 StellarX::Anchor Control::getAnchor_1() const
 {
 	return this->anchor_1;
@@ -265,6 +323,16 @@ StellarX::LayoutMode Control::getLayoutMode() const
 {
 	return this->layoutMode;
 }
+StellarX::AxisLayoutSpec Control::getHorizontalLayoutSpec() const
+{
+	return layoutSpec.horizontal;
+}
+
+StellarX::AxisLayoutSpec Control::getVerticalLayoutSpec() const
+{
+	return layoutSpec.vertical;
+}
+
 const StellarX::LayoutSpec& Control::getLayoutSpec() const
 {
 	return layoutSpec;
diff --git a/Control.h b/Control.h
index 764dfff..f8f7687 100644
--- a/Control.h
+++ b/Control.h
@@ -177,12 +177,36 @@ public:
 	void setLayoutMode(StellarX::LayoutMode layoutMode_);
 	// 设置旧版双锚点输入，并映射到内部统一 LayoutSpec
 	void setAnchor(StellarX::Anchor anchor_1, StellarX::Anchor anchor_2);
+	// 直接设置水平轴布局规格。
+	// 调用该接口后会自动切换到 AnchorToEdges 布局模式；
+	// 这是新布局模型的公开入口，后设置者会覆盖旧 setAnchor() 对水平轴的映射结果。
+	void setHorizontalLayoutSpec(const StellarX::AxisLayoutSpec& spec);
+	// 直接设置垂直轴布局规格。
+	// 调用该接口后会自动切换到 AnchorToEdges 布局模式；
+	// 这是新布局模型的公开入口，后设置者会覆盖旧 setAnchor() 对垂直轴的映射结果。
+	void setVerticalLayoutSpec(const StellarX::AxisLayoutSpec& spec);
+	// 设置水平轴锚定边集合（left / right）。
+	void setHorizontalAnchors(bool left, bool right);
+	// 设置垂直轴锚定边集合（top / bottom）。
+	void setVerticalAnchors(bool top, bool bottom);
+	// 设置水平轴尺寸策略（Stretch / FixedSize）。
+	void setHorizontalSizePolicy(StellarX::AxisSizePolicy policy);
+	// 设置垂直轴尺寸策略（Stretch / FixedSize）。
+	void setVerticalSizePolicy(StellarX::AxisSizePolicy policy);
+	// 设置水平轴固定尺寸位移策略（Start / End / Center / Proportional）。
+	void setHorizontalAlignPolicy(StellarX::AxisAlignPolicy policy);
+	// 设置垂直轴固定尺寸位移策略（Start / End / Center / Proportional）。
+	void setVerticalAlignPolicy(StellarX::AxisAlignPolicy policy);
 	// 获取旧版锚点 1（兼容读取入口）
 	StellarX::Anchor getAnchor_1() const;
 	// 获取旧版锚点 2（兼容读取入口）
 	StellarX::Anchor getAnchor_2() const;
 	// 获取旧版布局模式
 	StellarX::LayoutMode getLayoutMode() const;
+	// 获取水平轴布局规格；返回的是当前生效的新模型状态，不要求可逆回旧 anchor 语义。
+	StellarX::AxisLayoutSpec getHorizontalLayoutSpec() const;
+	// 获取垂直轴布局规格；返回的是当前生效的新模型状态，不要求可逆回旧 anchor 语义。
+	StellarX::AxisLayoutSpec getVerticalLayoutSpec() const;
 	// 获取内部统一布局规格；供 Window / Canvas 等统一解算入口使用。
 	const StellarX::LayoutSpec& getLayoutSpec() const;
 	// 获取控件能力边界；用于判断某个轴是否允许 Stretch。
diff --git a/z-testDome.cpp b/z-testDome.cpp
index f993570..8c6fa5a 100644
--- a/z-testDome.cpp
+++ b/z-testDome.cpp
@@ -1,8 +1,50 @@
 // StellarX 星垣GUI框架 - 测试用例
+//
+// 当前阶段测试入口说明（2026-04）：
+// 1. KEY1：旧页签链路 + Table 超界残留回归
+//    - 目标：验证 TabControl 重复激活同一页签、切页、关页后的快照/清理链是否稳定。
+//    - 预期：
+//      * 外部重复激活当前页签，不再扰动已激活页的快照链。
+//      * 页签 1 中 Table 超出页区域的部分，在切页或关闭页签时不会残留。
+//      * 触发正常全量重绘后，不应出现额外残影或层级错乱。
+//
+// 2. KEY2：公开布局 API 首个迁移样例
+//    - 目标：验证新的 AxisSizePolicy / AxisAlignPolicy 公开接口在真实场景里可用。
+//    - 预期：
+//      * 32 位选择区中的“位号 + 位按钮”作为单元整体位移，窗口拉伸后保持对齐。
+//      * 位按钮点击、位取反、左移、右移、一键置 0/1、签名切换，会统一刷新十六进制、
+//        十进制、上次值、本次值和 initData。
+//      * 顶层五个区块在正常拉伸/最大化后继续铺满窗口，不再依赖旧双锚点硬凑。
+//      * 当前更偏重横向铺满验证；极窄窗口下功能区是否进一步自适应，不作为本阶段硬指标。
+//
+// 3. KEY3：旧业务大场景保留用例
+//    - 目标：保留历史业务页示例，观察老场景在新主线下是否出现明显倒退。
+//    - 预期：
+//      * 登录页、TabControl、旧业务页基本行为保持可运行。
+//      * 当前不作为本阶段主回归集，不要求覆盖新的布局 API 或 overlay 专项。
+//
+// 4. KEY4：Dialog / MessageBox 专项回归
+//    - 目标：验证模态/非模态对话框、遮挡交互、关闭后 hover 恢复、拖拽 resize 等链路。
+//    - 预期：
+//      * 非模态 Dialog 遮挡底层按钮时，不应出现 hover/tooltip 穿透或残留。
+//      * 模态 Dialog 打开后拖拽窗口，标题、关闭按钮和底层恢复链保持稳定。
+//      * 对话框关闭后，底层按钮 hover 能及时恢复。
+//    - 备注：当前它更适合作为 Dialog 专项补充，不纳入每轮主集。
+//
+// 5. KEY5：第二阶段专项主回归
+//    - 目标：覆盖三层 Canvas、TabControl、Tooltip、overlay、Table、页码与分页按钮等主线风险点。
+//    - 预期：
+//      * 三层 Canvas 嵌套下，深层按钮的 hover / press / release / tooltip 都能正确刷新。
+//      * Window / Canvas / TabControl 的 overlay 补画与 coverage 链闭合，不再出现遮挡错层。
+//      * TabControl 页签按钮与页面层级正确；页签 tooltip 不会再被页面盖掉。
+//      * Table 分页按钮、页码标签、与上层浮层相交时的重绘链保持正确。
+//
+// 当前阶段建议主回归集：KEY1 + KEY2 + KEY5
+// Dialog / MessageBox 补充专项：KEY4
 #include"StellarX.h"
 #include <vector>
 #ifndef KEY
-#define KEY 4
+#define KEY 5
 #endif
 
 #if 5 == KEY
@@ -433,7 +475,7 @@ int main()
 	table->setHeaders({ "name","age","seorc","home" });
 	table->setData({
 		{"zhangsan","20","99.99","wadsacafadsawd"},
-		{"lisi","20","99.99","wadsacafadssssssssssssssssssssssssssssssssssssssssssssssssssawd"},
+		{"lisi","20","99.99","wadsacafadsawd"},
 		{"wangwu","20","99.99","wadsacafadsawd"},
 		{"zhaoliu","20","99.99","wadsacafadsawd"},
 		{"1","20","99.99","wadsacafadsawd" },
@@ -725,108 +767,147 @@ char initData[33] = "00000000000000000000000000000000";//初始数据
 bool gSigned = false;      //是否为有符号数
 int main()
 {
-	StellarX::SxLogger::Get().enableConsole(true);
+	//StellarX::SxLogger::Get().enableConsole(true);
+	StellarX::SxLogger::Get().enableFile("log.txt",true,1024);
 	StellarX::SxLogger::Get().setMinLevel(StellarX::SxLogLevel::Debug);   // Info/Debug/Trace 自己切
 	StellarX::SxLogger::Get().setLanguage(StellarX::SxLogLanguage::ZhCN); // ZhCN / EnUS
 
 	Window mainWindow(700, 510, 1, RGB(255, 255, 255), "寄存器查看工具 V1.0——我在人间做废物                         (同类工具定制：3150131407(Q / V))");
 
-	//选择区控件
-	auto selectionAreaLabel = std::make_unique<Label>(18, 0, "32位选择区");
-	selectionAreaLabel->setTextdisap(true);
-	std::vector<std::unique_ptr<Label>>selectionAreaButtonLabel;
-	std::vector<std::unique_ptr<Button>>selectionAreaButton;
-	std::vector<Button*>selectionAreaButton_ptr;
-	auto  selectionArea = std::make_unique <Canvas>(10, 10, 680, 150);
+	auto setStretchX = [](Control* control) {
+		control->setHorizontalAnchors(true, true);
+		control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::Stretch);
+		control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+	};
+	auto setStretchY = [](Control* control) {
+		control->setVerticalAnchors(true, true);
+		control->setVerticalSizePolicy(StellarX::AxisSizePolicy::Stretch);
+		control->setVerticalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+	};
+	auto setLeftFixed = [](Control* control) {
+		control->setHorizontalAnchors(true, false);
+		control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+		control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+	};
+	auto setRightFixed = [](Control* control) {
+		control->setHorizontalAnchors(false, true);
+		control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+		control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::End);
+	};
+	auto setCenterFixed = [](Control* control) {
+		control->setHorizontalAnchors(true, true);
+		control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+		control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Center);
+	};
+	auto setBottomFixed = [](Control* control) {
+		control->setVerticalAnchors(false, true);
+		control->setVerticalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+		control->setVerticalAlignPolicy(StellarX::AxisAlignPolicy::End);
+	};
+	auto setTopFixed = [](Control* control) {
+		control->setVerticalAnchors(true, false);
+		control->setVerticalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+		control->setVerticalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+	};
+	auto setProportionalX = [](Control* control) {
+		control->setHorizontalAnchors(true, true);
+		control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+		control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Proportional);
+	};
+	auto styleTitleLabel = [](Label* label) {
+		label->setTextdisap(true);
+	};
+	auto styleActionButton = [&](Button* button) {
+		button->textStyle.color = RGB(226, 116, 152);
+		button->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
+	};
+	auto styleInputBox = [&](TextBox* box, int maxChars) {
+		box->setMaxCharLen(maxChars);
+		box->textStyle.color = RGB(226, 116, 152);
+		box->setTextBoxBk(RGB(244, 234, 142));
+		box->setTextBoxshape(StellarX::ControlShape::B_RECTANGLE);
+	};
+	auto styleReadonlyBox = [&](TextBox* box, int maxChars) {
+		box->setMaxCharLen(maxChars);
+		box->textStyle.color = RGB(255, 69, 0);
+		box->setTextBoxBk(RGB(141, 141, 141));
+		box->setTextBoxshape(StellarX::ControlShape::B_RECTANGLE);
+		box->setMode(StellarX::TextBoxmode::READONLY_MODE);
+	};
 
+	//选择区控件
+	auto  selectionArea = std::make_unique <Canvas>(10, 10, 680, 150);
 	selectionArea->setCanvasBkColor(blackColor);
 	selectionArea->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
+	setStretchX(selectionArea.get());
+	setTopFixed(selectionArea.get());
 
-	for (int y = 0; y < 2; y++)
+	auto selectionAreaLabel = std::make_unique<Label>(18, 0, "32位选择区");
+	styleTitleLabel(selectionAreaLabel.get());
+	setLeftFixed(selectionAreaLabel.get());
+
+	auto topRow = std::make_unique<Canvas>(18, 24, 644, 54);
+	topRow->setCanvasBkColor(blackColor);
+	topRow->setShape(StellarX::ControlShape::B_RECTANGLE);
+	setStretchX(topRow.get());
+	setTopFixed(topRow.get());
+
+	auto bottomRow = std::make_unique<Canvas>(18, 88, 644, 54);
+	bottomRow->setCanvasBkColor(blackColor);
+	bottomRow->setShape(StellarX::ControlShape::B_RECTANGLE);
+	setStretchX(bottomRow.get());
+	setBottomFixed(bottomRow.get());
+
+	Canvas* topRowPtr = topRow.get();
+	Canvas* bottomRowPtr = bottomRow.get();
+	std::array<Button*, 32> selectionAreaButton_ptr{};
+
+	auto vecIndexFromBit = [](int bit) { return 31 - bit; };
+	auto makeBitCell = [&](Canvas* row, int visualIndex, int bit)
 	{
+		const int cellX = visualIndex * 38 + (visualIndex / 4) * 10;
+		auto cell = std::make_unique<Canvas>(cellX, 0, 32, 50);
+		cell->setCanvasBkColor(blackColor);
+		cell->setShape(StellarX::ControlShape::B_RECTANGLE);
+		setProportionalX(cell.get());
+
 		std::ostringstream os;
-		for (int x = 0; x < 16; x++)
-		{
-			if (0 == y)
-			{
-				selectionAreaButtonLabel.push_back(std::make_unique<Label>(x * 35 + 25 + 28 * (x / 4), 26, "", RGB(208, 208, 208)));
-				os << std::setw(2) << std::setfill('0') << 31 - x;
-				selectionAreaButtonLabel.back()->setText(os.str());
-				selectionAreaButtonLabel.back()->setTextdisap(true);
+		os << std::setw(2) << std::setfill('0') << bit;
+		auto bitLabel = std::make_unique<Label>(bit >= 10 ? 8 : 12, 0, os.str(), RGB(208, 208, 208));
+		bitLabel->setTextdisap(true);
 
-				selectionAreaButton.push_back(
-					std::make_unique<Button>(x * 35 + 27 + 28 * (x / 4), 58, 25, 30, "0",
-						blackColor, RGB(171, 196, 220), StellarX::ButtonMode::TOGGLE));
-				selectionAreaButton.back()->textStyle.color = RGB(226, 116, 152);
-				selectionAreaButton.back()->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
-				selectionAreaButton_ptr.push_back(selectionAreaButton.back().get());
-				int k = 32 - x - 1;
-				//选择区按钮被点击后在二进制0和1之间切换，并更新initData
-				selectionAreaButton_ptr.back()->setOnToggleOnListener([k, btn = selectionAreaButton_ptr.back()]()
-					{
-						btn->setButtonText("1");
-						initData[k] = '1';
-					});
-				selectionAreaButton_ptr.back()->setOnToggleOffListener([k, btn = selectionAreaButton_ptr.back()]()
-					{
-						btn->setButtonText("0");
-						initData[k] = '0';
-					});
-			}
-			else
-			{
-				selectionAreaButtonLabel.push_back(std::make_unique<Label>(x * 35 + 25 + 28 * (x / 4), 90, "", RGB(208, 208, 208)));
-				os << std::setw(2) << std::setfill('0') << 15 - x;
-				selectionAreaButtonLabel.back()->setText(os.str());
-				selectionAreaButtonLabel.back()->setTextdisap(true);
+		auto bitButton = std::make_unique<Button>(3, 20, 26, 28, "0",
+			blackColor, RGB(171, 196, 220), StellarX::ButtonMode::TOGGLE);
+		styleActionButton(bitButton.get());
+		selectionAreaButton_ptr[vecIndexFromBit(bit)] = bitButton.get();
+
+		cell->addControl(std::move(bitLabel));
+		cell->addControl(std::move(bitButton));
+		row->addControl(std::move(cell));
+	};
+
+	for (int i = 0; i < 16; ++i)
+		makeBitCell(topRowPtr, i, 31 - i);
+	for (int i = 0; i < 16; ++i)
+		makeBitCell(bottomRowPtr, i, 15 - i);
 
-				selectionAreaButton.push_back(
-					std::make_unique<Button>(x * 35 + 27 + 28 * (x / 4), 120, 25, 30, "0",
-						blackColor, RGB(171, 196, 220), StellarX::ButtonMode::TOGGLE));
-				selectionAreaButton.back()->textStyle.color = RGB(226, 116, 152);
-				selectionAreaButton.back()->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
-				selectionAreaButton_ptr.push_back(selectionAreaButton.back().get());
-				int k = 15 - x;
-				selectionAreaButton.back()->setOnToggleOnListener([k, btn = selectionAreaButton_ptr.back()]()
-					{
-						btn->setButtonText("1");
-						initData[k] = '1';
-					});
-				selectionAreaButton.back()->setOnToggleOffListener([k, btn = selectionAreaButton_ptr.back()]()
-					{
-						btn->setButtonText("0");
-						initData[k] = '0';
-					});
-			}
-			os.str("");
-			os.clear();
-		}
-	}
-	selectionAreaLabel->setAnchor(StellarX::Anchor::Right, StellarX::Anchor::Left);
-	selectionAreaLabel->setLayoutMode(StellarX::LayoutMode::AnchorToEdges);
-	
 	selectionArea->addControl(std::move(selectionAreaLabel));
-	for (auto& s : selectionAreaButton)
-	{
-		s->setAnchor(StellarX::Anchor::Right, StellarX::Anchor::Left);
-		s->setLayoutMode(StellarX::LayoutMode::AnchorToEdges);
-		selectionArea->addControl(std::move(s));
-	}
-	for (auto& s : selectionAreaButtonLabel)
-	{
-		s->setAnchor(StellarX::Anchor::Right, StellarX::Anchor::Left);
-		s->setLayoutMode(StellarX::LayoutMode::AnchorToEdges);
-		selectionArea->addControl(std::move(s));
-	}
+	selectionArea->addControl(std::move(topRow));
+	selectionArea->addControl(std::move(bottomRow));
 	//功能区控件
-	//功能区总容器
 	auto function = std::make_unique<Canvas>(10, 170, 680, 70);
 	function->setCanvasfillMode(StellarX::FillMode::Null);
 	function->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
 	function->setCanvasBkColor(blackColor);
+	setStretchX(function.get());
+	setTopFixed(function.get());
+
 	auto bitInvert_que = std::make_unique<Canvas>(0, 0, 220, 70);
 	auto leftShift_que = std::make_unique<Canvas>(230, 0, 220, 70);
 	auto rightShift_que = std::make_unique<Canvas>(460, 0, 220, 70);
+	setLeftFixed(bitInvert_que.get());
+	setCenterFixed(leftShift_que.get());
+	setRightFixed(rightShift_que.get());
 
 	auto bitInvert = bitInvert_que.get();
 	auto leftShift = leftShift_que.get();
@@ -839,347 +920,340 @@ int main()
 	rightShift->setCanvasBkColor(blackColor);
 	rightShift->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
 
-	function->addControl(std::move(bitInvert_que));
-	function->addControl(std::move(leftShift_que));
-	function->addControl(std::move(rightShift_que));
-
 	auto bitInvertLabel = std::make_unique<Label>(13, -10, "位取反");
-	bitInvertLabel->setTextdisap(true);
 	auto leftShiftLabel = std::make_unique<Label>(13, -10, "左移位");
-	leftShiftLabel->setTextdisap(true);
 	auto rightShiftLabel = std::make_unique<Label>(13, -10, "右移位");
-	rightShiftLabel->setTextdisap(true);
+	styleTitleLabel(bitInvertLabel.get());
+	styleTitleLabel(leftShiftLabel.get());
+	styleTitleLabel(rightShiftLabel.get());
+
+	// 数值显示区
+	auto NumericalDisplayArea = std::make_unique<Canvas>(10, 255, 680, 70);
+	NumericalDisplayArea->setCanvasBkColor(blackColor);
+	NumericalDisplayArea->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
+	setStretchX(NumericalDisplayArea.get());
+	setTopFixed(NumericalDisplayArea.get());
+
+	auto numericalTitle = std::make_unique<Label>(18, -10, "数值显示区");
+	styleTitleLabel(numericalTitle.get());
+	setLeftFixed(numericalTitle.get());
+
+	auto hexGroup = std::make_unique<Canvas>(18, 20, 300, 38);
+	hexGroup->setCanvasfillMode(StellarX::FillMode::Null);
+	hexGroup->setShape(StellarX::ControlShape::B_RECTANGLE);
+	setLeftFixed(hexGroup.get());
+
+	auto decGroup = std::make_unique<Canvas>(362, 20, 300, 38);
+	decGroup->setCanvasfillMode(StellarX::FillMode::Null);
+	decGroup->setShape(StellarX::ControlShape::B_RECTANGLE);
+	setRightFixed(decGroup.get());
+
+	auto hexLabel = std::make_unique<Label>(0, 8, "十六进制");
+	styleTitleLabel(hexLabel.get());
+	auto decLabel = std::make_unique<Label>(0, 8, "十进制");
+	styleTitleLabel(decLabel.get());
+
+	auto hexBox = std::make_unique<TextBox>(86, 4, 204, 30, "00000000");
+	auto decBox = std::make_unique<TextBox>(70, 4, 220, 30, "0");
+	styleReadonlyBox(hexBox.get(), 11);
+	styleReadonlyBox(decBox.get(), 11);
+	auto hex = hexBox.get();
+	auto dec = decBox.get();
+
+	hexGroup->addControl(std::move(hexLabel));
+	hexGroup->addControl(std::move(hexBox));
+	decGroup->addControl(std::move(decLabel));
+	decGroup->addControl(std::move(decBox));
+
+	NumericalDisplayArea->addControl(std::move(numericalTitle));
+	NumericalDisplayArea->addControl(std::move(hexGroup));
+	NumericalDisplayArea->addControl(std::move(decGroup));
+
+	// 二进制显示区
+	auto BinaryDisplayArea = std::make_unique<Canvas>(10, 335, 680, 110);
+	BinaryDisplayArea->setCanvasBkColor(blackColor);
+	BinaryDisplayArea->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
+	setStretchX(BinaryDisplayArea.get());
+	BinaryDisplayArea->setVerticalAnchors(true, true);
+	BinaryDisplayArea->setVerticalSizePolicy(StellarX::AxisSizePolicy::Stretch);
+	BinaryDisplayArea->setVerticalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+
+	auto binaryTitle = std::make_unique<Label>(18, -10, "二进制显示区");
+	styleTitleLabel(binaryTitle.get());
+	setLeftFixed(binaryTitle.get());
+
+	auto lastRow = std::make_unique<Canvas>(18, 20, 644, 30);
+	lastRow->setCanvasfillMode(StellarX::FillMode::Null);
+	lastRow->setShape(StellarX::ControlShape::B_RECTANGLE);
+	setStretchX(lastRow.get());
+	setTopFixed(lastRow.get());
+
+	auto thisRow = std::make_unique<Canvas>(18, 67, 644, 30);
+	thisRow->setCanvasfillMode(StellarX::FillMode::Null);
+	thisRow->setShape(StellarX::ControlShape::B_RECTANGLE);
+	setStretchX(thisRow.get());
+	setBottomFixed(thisRow.get());
+
+	auto lastLabel = std::make_unique<Label>(0, 6, "上次值");
+	auto thisLabel = std::make_unique<Label>(0, 6, "本次值");
+	styleTitleLabel(lastLabel.get());
+	styleTitleLabel(thisLabel.get());
+
+	auto lastBox = std::make_unique<TextBox>(80, 0, 564, 30, "0000_0000_0000_0000_0000_0000_0000_0000");
+	auto thisBox = std::make_unique<TextBox>(80, 0, 564, 30, "0000_0000_0000_0000_0000_0000_0000_0000");
+	styleReadonlyBox(lastBox.get(), 40);
+	styleReadonlyBox(thisBox.get(), 40);
+	lastBox->setHorizontalAnchors(true, true);
+	lastBox->setHorizontalSizePolicy(StellarX::AxisSizePolicy::Stretch);
+	lastBox->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+	thisBox->setHorizontalAnchors(true, true);
+	thisBox->setHorizontalSizePolicy(StellarX::AxisSizePolicy::Stretch);
+	thisBox->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+	auto Last = lastBox.get();
+	auto This = thisBox.get();
+
+	lastRow->addControl(std::move(lastLabel));
+	lastRow->addControl(std::move(lastBox));
+	thisRow->addControl(std::move(thisLabel));
+	thisRow->addControl(std::move(thisBox));
+
+	BinaryDisplayArea->addControl(std::move(binaryTitle));
+	BinaryDisplayArea->addControl(std::move(lastRow));
+	BinaryDisplayArea->addControl(std::move(thisRow));
+
+	// 配置区
+	auto configuration = std::make_unique<Canvas>(10, 455, 680, 40);
+	configuration->setCanvasBkColor(blackColor);
+	configuration->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
+	setStretchX(configuration.get());
+	setBottomFixed(configuration.get());
+
+	auto configurationLabel = std::make_unique<Label>(20, -10, "配置区");
+	styleTitleLabel(configurationLabel.get());
+	setLeftFixed(configurationLabel.get());
+
+	auto clearButton = std::make_unique<Button>(420, 10, 90, 20, "一键置0",
+		blackColor, RGB(171, 196, 220));
+	auto fillButton = std::make_unique<Button>(530, 10, 90, 20, "一键置1",
+		blackColor, RGB(171, 196, 220));
+	styleActionButton(clearButton.get());
+	styleActionButton(fillButton.get());
+	setRightFixed(clearButton.get());
+	setRightFixed(fillButton.get());
+
+	auto signedToggle = std::make_unique<Button>(
+		300, 10, 90, 20, "无符号",
+		blackColor, RGB(171, 196, 220), StellarX::ButtonMode::TOGGLE);
+	styleActionButton(signedToggle.get());
+	setCenterFixed(signedToggle.get());
+	auto* signedTogglePtr = signedToggle.get();
 
 	// ====== 公用小工具======
 	auto clamp = [](int v, int lo, int hi) { return v < lo ? lo : (v > hi ? hi : v); };
 	auto toInt = [](const std::string& s, int def = 0) {
 		try { return std::stoi(s); }
 		catch (...) { return def; }
-		};
-	// bit号(31..0) -> selectionAreaButton下标(0..31)
-	auto vecIndexFromBit = [](int bit) { return 31 - bit; };
+	};
 
-	// 读取当前32位点击态
 	auto snapshotBits = [&]() {
-		std::array<bool, 32> a{};
-		for (int b = 0; b < 32; ++b)
-			a[b] = selectionAreaButton_ptr[vecIndexFromBit(b)]->isClicked();
-		return a;
-		};
+		std::array<bool, 32> bits{};
+		for (int bit = 0; bit < 32; ++bit)
+			bits[bit] = selectionAreaButton_ptr[vecIndexFromBit(bit)]->isClicked();
+		return bits;
+	};
 
-	// 应用目标态：仅当不同才 setButtonClick
-	auto applyBits = [&](const std::array<bool, 32>& a) {
-		for (int b = 0; b < 32; ++b) {
-			auto btn = selectionAreaButton_ptr[vecIndexFromBit(b)];
-			if (btn->isClicked() != a[b]) btn->setButtonClick(a[b]);
+	auto valueFromBits = [](const std::array<bool, 32>& bits) -> uint32_t {
+		uint32_t value = 0;
+		for (int bit = 0; bit < 32; ++bit)
+			if (bits[bit]) value |= (1u << bit);
+		return value;
+	};
+
+	auto binaryGroupedFromBits = [](const std::array<bool, 32>& bits) -> std::string {
+		std::string text;
+		text.reserve(39);
+		for (int bit = 31; bit >= 0; --bit) {
+			text.push_back(bits[bit] ? '1' : '0');
+			if (bit % 4 == 0 && bit != 0) text.push_back('_');
 		}
-		};
+		return text;
+	};
 
-	//取反区控件
-	std::array<std::unique_ptr<Label>, 4> bitInvertFunctionLabel;
-	bitInvertFunctionLabel[0] = std::make_unique<Label>(30, 10, "低位");
-	bitInvertFunctionLabel[1] = std::make_unique<Label>(90, 10, "高位");
-	bitInvertFunctionLabel[2] = std::make_unique<Label>(15, 38, "从");
-	bitInvertFunctionLabel[3] = std::make_unique<Label>(75, 38, "到");
+	auto syncInitData = [&](const std::array<bool, 32>& bits) {
+		for (int bit = 31; bit >= 0; --bit)
+			initData[31 - bit] = bits[bit] ? '1' : '0';
+		initData[32] = '\0';
+	};
 
-	std::array<std::unique_ptr<TextBox>, 2> bitInvertFunctionTextBox;
-	bitInvertFunctionTextBox[0] = std::make_unique<TextBox>(35, 35, 35, 30, "0");
-	bitInvertFunctionTextBox[1] = std::make_unique<TextBox>(95, 35, 35, 30, "0");
-	auto invL = bitInvertFunctionTextBox[0].get();
-	auto invH = bitInvertFunctionTextBox[1].get();
-	auto bitInvertFunctionButton = std::make_unique<Button>(135, 35, 80, 30, "位取反",
+	auto refreshDisplaysWithBits = [&](const std::array<bool, 32>& bits, bool pushHistory) {
+		const uint32_t value = valueFromBits(bits);
+		const int32_t signedValue = static_cast<int32_t>(value);
+		char hexbuf[16];
+		std::snprintf(hexbuf, sizeof(hexbuf), "%08X", value);
+
+		if (pushHistory)
+			Last->setText(This->getText());
+
+		hex->setText(hexbuf);
+		dec->setText(gSigned ? std::to_string(signedValue) : std::to_string(value));
+		This->setText(binaryGroupedFromBits(bits));
+		syncInitData(bits);
+	};
+
+	bool batchApplyingBits = false;
+	auto applyBits = [&](const std::array<bool, 32>& bits, bool pushHistory) {
+		batchApplyingBits = true;
+		for (int bit = 0; bit < 32; ++bit) {
+			auto* button = selectionAreaButton_ptr[vecIndexFromBit(bit)];
+			if (button->isClicked() != bits[bit])
+				button->setButtonClick(bits[bit]);
+			button->setButtonText(bits[bit] ? "1" : "0");
+		}
+		batchApplyingBits = false;
+		refreshDisplaysWithBits(bits, pushHistory);
+	};
+
+	// 取反区控件
+	auto invStartLabel = std::make_unique<Label>(18, 12, "从");
+	auto invEndLabel = std::make_unique<Label>(82, 12, "到");
+	styleTitleLabel(invStartLabel.get());
+	styleTitleLabel(invEndLabel.get());
+
+	auto invStartBox = std::make_unique<TextBox>(34, 28, 34, 28, "0");
+	auto invEndBox = std::make_unique<TextBox>(98, 28, 34, 28, "31");
+	styleInputBox(invStartBox.get(), 3);
+	styleInputBox(invEndBox.get(), 3);
+	auto invL = invStartBox.get();
+	auto invH = invEndBox.get();
+
+	auto bitInvertFunctionButton = std::make_unique<Button>(140, 28, 64, 28, "位取反",
 		blackColor, RGB(171, 196, 220));
-	bitInvertFunctionButton->textStyle.color = RGB(226, 116, 152);
-	bitInvertFunctionButton->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
+	styleActionButton(bitInvertFunctionButton.get());
 	auto bitInvertFunctionButton_ptr = bitInvertFunctionButton.get();
 
-	bitInvert->addControl(std::move(bitInvertFunctionButton));
 	bitInvert->addControl(std::move(bitInvertLabel));
-	for (auto& b : bitInvertFunctionTextBox)
-	{
-		b->setMaxCharLen(3);
-		b->textStyle.color = RGB(226, 116, 152);
-		b->setTextBoxBk(RGB(244, 234, 142));
-		b->setTextBoxshape(StellarX::ControlShape::B_RECTANGLE);
-		bitInvert->addControl(std::move(b));
-	}
-	for (auto& b : bitInvertFunctionLabel)
-	{
-		b->setTextdisap(true);
-		bitInvert->addControl(std::move(b));
-	}
-	//左移控件
-	auto leftShiftFunctionLabel = std::make_unique<Label>(198, 30, "位");
-	leftShiftFunctionLabel->setTextdisap(true);
+	bitInvert->addControl(std::move(invStartLabel));
+	bitInvert->addControl(std::move(invEndLabel));
+	bitInvert->addControl(std::move(invStartBox));
+	bitInvert->addControl(std::move(invEndBox));
+	bitInvert->addControl(std::move(bitInvertFunctionButton));
 
-	auto leftShiftFunctionTextBox = std::make_unique<TextBox>(90, 30, 100, 30, "0");
-	leftShiftFunctionTextBox->setMaxCharLen(3);
-	leftShiftFunctionTextBox->textStyle.color = RGB(226, 116, 152);
-	leftShiftFunctionTextBox->setTextBoxBk(RGB(244, 234, 142));
-	leftShiftFunctionTextBox->setTextBoxshape(StellarX::ControlShape::B_RECTANGLE);
+	// 左移控件
+	auto leftShiftFunctionLabel = std::make_unique<Label>(178, 30, "位");
+	styleTitleLabel(leftShiftFunctionLabel.get());
+
+	auto leftShiftFunctionTextBox = std::make_unique<TextBox>(82, 28, 86, 28, "0");
+	styleInputBox(leftShiftFunctionTextBox.get(), 3);
 	auto shlBox = leftShiftFunctionTextBox.get();
-	auto leftShiftFunctionButton = std::make_unique<Button>(15, 30, 60, 30, "左移",
+
+	auto leftShiftFunctionButton = std::make_unique<Button>(16, 28, 56, 28, "左移",
 		blackColor, RGB(171, 196, 220));
-	leftShiftFunctionButton->textStyle.color = RGB(226, 116, 152);
-	leftShiftFunctionButton->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
+	styleActionButton(leftShiftFunctionButton.get());
 	auto leftShiftFunctionButton_ptr = leftShiftFunctionButton.get();
 
+	leftShift->addControl(std::move(leftShiftLabel));
 	leftShift->addControl(std::move(leftShiftFunctionButton));
 	leftShift->addControl(std::move(leftShiftFunctionTextBox));
-
-	leftShift->addControl(std::move(leftShiftLabel));
 	leftShift->addControl(std::move(leftShiftFunctionLabel));
 
-	//右移控件
-	auto rightShiftFunctionLabel = std::make_unique<Label>(198, 30, "位");
-	rightShiftFunctionLabel->setTextdisap(true);
-	auto rightShiftFunctionTextBox = std::make_unique<TextBox>(90, 30, 100, 30, "0");
-	rightShiftFunctionTextBox->setMaxCharLen(3);
-	rightShiftFunctionTextBox->textStyle.color = RGB(226, 116, 152);
-	rightShiftFunctionTextBox->setTextBoxBk(RGB(244, 234, 142));
-	rightShiftFunctionTextBox->setTextBoxshape(StellarX::ControlShape::B_RECTANGLE);
+	// 右移控件
+	auto rightShiftFunctionLabel = std::make_unique<Label>(178, 30, "位");
+	styleTitleLabel(rightShiftFunctionLabel.get());
+
+	auto rightShiftFunctionTextBox = std::make_unique<TextBox>(82, 28, 86, 28, "0");
+	styleInputBox(rightShiftFunctionTextBox.get(), 3);
 	auto shrBox = rightShiftFunctionTextBox.get();
 
-	auto rightShiftFunctionButton = std::make_unique<Button>(15, 30, 60, 30, "右移",
+	auto rightShiftFunctionButton = std::make_unique<Button>(16, 28, 56, 28, "右移",
 		blackColor, RGB(171, 196, 220));
-	rightShiftFunctionButton->textStyle.color = RGB(226, 116, 152);
-	rightShiftFunctionButton->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
+	styleActionButton(rightShiftFunctionButton.get());
 	auto rightShiftFunctionButton_ptr = rightShiftFunctionButton.get();
 
-	rightShift->addControl(std::move(rightShiftFunctionButton));
-
-	rightShift->addControl(std::move(rightShiftFunctionTextBox));
 	rightShift->addControl(std::move(rightShiftLabel));
+	rightShift->addControl(std::move(rightShiftFunctionButton));
+	rightShift->addControl(std::move(rightShiftFunctionTextBox));
 	rightShift->addControl(std::move(rightShiftFunctionLabel));
 
-	//显示区控件
-	//数值显示
-	auto NumericalDisplayArea = std::make_unique<Canvas>(10, 255, 680, 70);
-	NumericalDisplayArea->setCanvasBkColor(blackColor);
-	NumericalDisplayArea->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
-
-	std::array<std::unique_ptr<Label>, 3> NumericalDisplayAreaLabel;
-	NumericalDisplayAreaLabel[0] = std::make_unique<Label>(18, -10, "数值显示区");
-	NumericalDisplayAreaLabel[1] = std::make_unique<Label>(20, 25, "十六进制");
-	NumericalDisplayAreaLabel[2] = std::make_unique<Label>(330, 25, "十进制");
-
-	std::array<std::unique_ptr<TextBox>, 2> NumericalDisplayAreaTextBox;
-	NumericalDisplayAreaTextBox[0] = std::make_unique<TextBox>(110, 25, 200, 30, "0");
-	NumericalDisplayAreaTextBox[1] = std::make_unique<TextBox>(400, 25, 200, 30, "0");
-	auto hex = NumericalDisplayAreaTextBox[0].get();
-	auto dec = NumericalDisplayAreaTextBox[1].get();
-
-	for (auto& b : NumericalDisplayAreaLabel)
-	{
-		b->setTextdisap(true);
-		NumericalDisplayArea->addControl(std::move(b));
-	}
-	for (auto& b : NumericalDisplayAreaTextBox)
-	{
-		b->setMaxCharLen(11);
-		b->textStyle.color = RGB(255, 69, 0);
-		b->setTextBoxBk(RGB(141, 141, 141));
-		b->setTextBoxshape(StellarX::ControlShape::B_RECTANGLE);
-		b->setMode(StellarX::TextBoxmode::READONLY_MODE);
-		NumericalDisplayArea->addControl(std::move(b));
-	}
-	//二进制显示
-	auto BinaryDisplayArea = std::make_unique<Canvas>(10, 335, 680, 110);
-	BinaryDisplayArea->setCanvasBkColor(blackColor);
-	BinaryDisplayArea->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
-
-	std::array<std::unique_ptr<Label>, 3> BinaryDisplayAreaLabel;
-	BinaryDisplayAreaLabel[0] = std::make_unique<Label>(18, -10, "二进制显示区");
-	BinaryDisplayAreaLabel[1] = std::make_unique<Label>(35, 20, "上次值");
-	BinaryDisplayAreaLabel[2] = std::make_unique<Label>(35, 67, "本次值");
-
-	std::array<std::unique_ptr<TextBox>, 2> BinaryDisplayAreaTextBox;
-	BinaryDisplayAreaTextBox[0] = std::make_unique<TextBox>(110, 20, 520, 30, "0000_0000_0000_0000_0000_0000_0000_0000");
-	BinaryDisplayAreaTextBox[1] = std::make_unique<TextBox>(110, 67, 520, 30, "0000_0000_0000_0000_0000_0000_0000_0000");
-	auto Last = BinaryDisplayAreaTextBox[0].get();
-	auto This = BinaryDisplayAreaTextBox[1].get();
-
-	for (auto& b : BinaryDisplayAreaLabel)
-	{
-		b->setTextdisap(true);
-		BinaryDisplayArea->addControl(std::move(b));
-	}
-	for (auto& b : BinaryDisplayAreaTextBox)
-	{
-		b->setMaxCharLen(40);
-		b->textStyle.color = RGB(255, 69, 0);
-		b->setTextBoxBk(RGB(141, 141, 141));
-		b->setTextBoxshape(StellarX::ControlShape::B_RECTANGLE);
-		b->setMode(StellarX::TextBoxmode::READONLY_MODE);
-		BinaryDisplayArea->addControl(std::move(b));
+	// 位按钮与显示区联动
+	for (int bit = 0; bit < 32; ++bit) {
+		auto* button = selectionAreaButton_ptr[vecIndexFromBit(bit)];
+		button->setOnToggleOnListener([&, bit]() {
+			selectionAreaButton_ptr[vecIndexFromBit(bit)]->setButtonText("1");
+			if (!batchApplyingBits)
+				refreshDisplaysWithBits(snapshotBits(), true);
+		});
+		button->setOnToggleOffListener([&, bit]() {
+			selectionAreaButton_ptr[vecIndexFromBit(bit)]->setButtonText("0");
+			if (!batchApplyingBits)
+				refreshDisplaysWithBits(snapshotBits(), true);
+		});
 	}
 
-	// 由位图 bits 生成数值
-	auto valueFromBits = [](const std::array<bool, 32>& bits) -> uint32_t {
-		uint32_t v = 0;
-		for (int b = 0; b < 32; ++b) if (bits[b]) v |= (1u << b);
-		return v;
-		};
+	bitInvertFunctionButton_ptr->setOnClickListener([&]() {
+		int low = clamp(toInt(invL->getText(), 0), 0, 31);
+		int high = clamp(toInt(invH->getText(), 31), 0, 31);
+		if (low > high) std::swap(low, high);
 
-	// 由位图 bits 生成 "0000_0000_..._0000"（MSB→LSB：31..0）
-	auto binaryGroupedFromBits = [](const std::array<bool, 32>& bits) -> std::string {
-		std::string s; s.reserve(39);
-		for (int b = 31; b >= 0; --b) {
-			s.push_back(bits[b] ? '1' : '0');
-			if (b % 4 == 0 && b != 0) s.push_back('_');
-		}
-		return s;
-		};
+		auto bits = snapshotBits();
+		for (int bit = low; bit <= high; ++bit)
+			bits[bit] = !bits[bit];
+		applyBits(bits, true);
+	});
 
-	// 用“目标位图 bits”刷新显示区
-	auto refreshDisplaysWithBits = [&](const std::string& prevThis,
-		const std::array<bool, 32>& bits,
-		TextBox* hex, TextBox* dec, TextBox* Last, TextBox* This)
-		{
-			const uint32_t val = valueFromBits(bits);
-			const int32_t  s = static_cast<int32_t>(val);
-			char hexbuf[16];
-			std::snprintf(hexbuf, sizeof(hexbuf), "%08X", val);
+	leftShiftFunctionButton_ptr->setOnClickListener([&]() {
+		int count = clamp(toInt(shlBox->getText(), 0), 0, 31);
+		auto bits = snapshotBits();
+		std::array<bool, 32> next{};
+		for (int bit = 31; bit >= 0; --bit)
+			next[bit] = (bit >= count) ? bits[bit - count] : false;
+		applyBits(next, true);
+	});
 
-			hex->setText(hexbuf);                   // HEX（大写8位）
-			dec->setText(gSigned ? std::to_string(s) : std::to_string(val));      // DEC
-			Last->setText(prevThis);                // 上次值 ← 刷新前的本次值
-			This->setText(binaryGroupedFromBits(bits)); // 本次值 ← 由“目标位图”生成
-		};
+	rightShiftFunctionButton_ptr->setOnClickListener([&]() {
+		int count = clamp(toInt(shrBox->getText(), 0), 0, 31);
+		auto bits = snapshotBits();
+		std::array<bool, 32> next{};
+		for (int bit = 0; bit < 32; ++bit)
+			next[bit] = (bit + count <= 31) ? bits[bit + count] : false;
+		applyBits(next, true);
+	});
 
-	bitInvertFunctionButton_ptr->setOnClickListener([=, &snapshotBits, &applyBits, &refreshDisplaysWithBits]() {
-		const std::string prevThis = This->getText();
+	clearButton->setOnClickListener([&]() {
+		std::array<bool, 32> bits{};
+		applyBits(bits, true);
+	});
 
-		int L = clamp(toInt(invL->getText(), 0), 0, 31);
-		int H = clamp(toInt(invH->getText(), 0), 0, 31);
-		if (L > H) std::swap(L, H);
-
-		auto cur = snapshotBits();
-		for (int b = L; b <= H; ++b) cur[b] = !cur[b];
-
-		applyBits(cur);                                   // 只改按钮点击态（触发位按钮自回调）
-		refreshDisplaysWithBits(prevThis, cur, hex, dec, Last, This);
-		});
-
-	leftShiftFunctionButton_ptr->setOnClickListener([=, &snapshotBits, &applyBits, &refreshDisplaysWithBits]() {
-		const std::string prevThis = This->getText();
-
-		int n = clamp(toInt(shlBox->getText(), 0), 0, 31);
-		auto cur = snapshotBits();
-		std::array<bool, 32> nxt{};                         // 默认全 0
-
-		// 逻辑左移：高位丢弃、低位补 0
-		for (int b = 31; b >= 0; --b) nxt[b] = (b >= n) ? cur[b - n] : false;
-
-		applyBits(nxt);
-		refreshDisplaysWithBits(prevThis, nxt, hex, dec, Last, This);
-		});
-
-	rightShiftFunctionButton_ptr->setOnClickListener([=, &snapshotBits, &applyBits, &refreshDisplaysWithBits]() {
-		const std::string prevThis = This->getText();
-
-		int n = clamp(toInt(shrBox->getText(), 0), 0, 31);
-		auto cur = snapshotBits();
-		std::array<bool, 32> nxt{};
-
-		// 逻辑右移：低位丢弃、高位补 0
-		for (int b = 0; b < 32; ++b) nxt[b] = (b + n <= 31) ? cur[b + n] : false;
-
-		applyBits(nxt);
-		refreshDisplaysWithBits(prevThis, nxt, hex, dec, Last, This);
-		});
-
-	//配置区控件clearrectangle(10, 440, 690, 490);
-	auto configuration = std::make_unique<Canvas>(10, 455, 680, 40);
-	configuration->setCanvasBkColor(blackColor);
-	configuration->setShape(StellarX::ControlShape::B_ROUND_RECTANGLE);
-
-	auto configurationLabel = std::make_unique<Label>(20, -10, "配置区");
-	configurationLabel->setTextdisap(true);
-
-	std::array<std::unique_ptr<Button>, 2> configurationButton;
-	configurationButton[0] = std::make_unique<Button>(420, 10, 90, 20, "一键置0",
-		blackColor, RGB(171, 196, 220));
-	configurationButton[0]->textStyle.color = RGB(226, 116, 152);
-	configurationButton[0]->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
-
-	configurationButton[1] = std::make_unique<Button>(530, 10, 90, 20, "一键置1",
-		blackColor, RGB(171, 196, 220));
-	configurationButton[1]->textStyle.color = RGB(226, 116, 152);
-	configurationButton[1]->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
-	configurationButton[0]->setOnClickListener(
-		[&]() {
-			for (auto& s : selectionAreaButton_ptr)
-				if (s->isClicked()) s->setButtonClick(false);
-
-			// 刷新显示：prevThis 用当前 This 文本
-			const std::string prevThis = This->getText();
-			auto cur = snapshotBits();
-			{
-				char hexbuf[16];
-				uint32_t u = 0; for (int b = 0; b < 32; ++b) if (cur[b]) u |= (1u << b);
-				int32_t  s = static_cast<int32_t>(u);
-				std::snprintf(hexbuf, sizeof(hexbuf), "%08X", u);
-				hex->setText(hexbuf);
-				dec->setText(gSigned ? std::to_string(s) : std::to_string(u));
-				Last->setText(prevThis);
-				This->setText(binaryGroupedFromBits(cur));
-			}
-		});
-
-	configurationButton[1]->setOnClickListener(
-		[&]() {
-			for (auto& s : selectionAreaButton_ptr)
-				if (!s->isClicked()) s->setButtonClick(true);
-
-			const std::string prevThis = This->getText();
-			auto cur = snapshotBits();
-			char hexbuf[16];
-			uint32_t u = 0; for (int b = 0; b < 32; ++b) if (cur[b]) u |= (1u << b);
-			int32_t  s = static_cast<int32_t>(u);
-			std::snprintf(hexbuf, sizeof(hexbuf), "%08X", u);
-			hex->setText(hexbuf);
-			dec->setText(gSigned ? std::to_string(s) : std::to_string(u));
-			Last->setText(prevThis);
-			This->setText(binaryGroupedFromBits(cur));
-		});
-
-	auto signedToggle = std::make_unique<Button>(
-		330, 10, 80, 20, "无符号",
-		blackColor, RGB(171, 196, 220), StellarX::ButtonMode::TOGGLE);
-	signedToggle->textStyle.color = RGB(226, 116, 152);
-	signedToggle->setButtonShape(StellarX::ControlShape::B_RECTANGLE);
-	auto* signedTogglePtr = signedToggle.get();
+	fillButton->setOnClickListener([&]() {
+		std::array<bool, 32> bits{};
+		bits.fill(true);
+		applyBits(bits, true);
+	});
 
 	signedTogglePtr->setOnToggleOnListener([&]() {
 		gSigned = true;
 		signedTogglePtr->setButtonText("有符号");
 		StellarX::MessageBox::showModal(mainWindow, "有符号模式下，\n最高位为符号位，\n其余位为数值位。", "有符号模式");
-		// 立即刷新十进制显示：用当前位图算出新值，仅改 dec
-		auto cur = snapshotBits();
-		const uint32_t u = [&] { uint32_t v = 0; for (int b = 0; b < 32; ++b) if (cur[b]) v |= (1u << b); return v; }();
-		const int32_t  s = static_cast<int32_t>(u);
-		dec->setText(std::to_string(s));
-		});
+		refreshDisplaysWithBits(snapshotBits(), false);
+	});
 	signedTogglePtr->setOnToggleOffListener([&]() {
 		gSigned = false;
 		signedTogglePtr->setButtonText("无符号");
 		StellarX::MessageBox::showAsync(mainWindow, "无符号模式下，\n所有位均为数值位。", "无符号模式");
-		auto cur = snapshotBits();
-		const uint32_t u = [&] { uint32_t v = 0; for (int b = 0; b < 32; ++b) if (cur[b]) v |= (1u << b); return v; }();
-		dec->setText(std::to_string(u));
-		});
-
+		refreshDisplaysWithBits(snapshotBits(), false);
+	});
 	signedTogglePtr->enableTooltip(true);
 	signedTogglePtr->setTooltipTextsForToggle("切换无符号模式", "切换有符号模式");
 
-	configuration->addControl(std::move(configurationButton[0]));
-	configuration->addControl(std::move(configurationButton[1]));
-	configuration->addControl(std::move(signedToggle));
-	configuration->addControl(std::move(configurationLabel));
+	function->addControl(std::move(bitInvert_que));
+	function->addControl(std::move(leftShift_que));
+	function->addControl(std::move(rightShift_que));
 
-	selectionArea->setAnchor(StellarX::Anchor::Right, StellarX::Anchor::Left);
-	selectionArea->setLayoutMode(StellarX::LayoutMode::AnchorToEdges);
+	configuration->addControl(std::move(configurationLabel));
+	configuration->addControl(std::move(signedToggle));
+	configuration->addControl(std::move(clearButton));
+	configuration->addControl(std::move(fillButton));
+
+	refreshDisplaysWithBits(snapshotBits(), false);
 
 	mainWindow.addControl(std::move(selectionArea));
 	mainWindow.addControl(std::move(function));
diff --git a/开发记录/BUG/BUG-20260410-0004-按钮Tooltip移出后不消失.md b/开发记录/BUG/BUG-20260410-0004-按钮Tooltip移出后不消失.md
new file mode 100644
index 0000000..0d78aa1
--- /dev/null
+++ b/开发记录/BUG/BUG-20260410-0004-按钮Tooltip移出后不消失.md
@@ -0,0 +1,68 @@
+# BUG-20260410-0004
+
+> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
+
+## 基本信息
+
+- ID: `BUG-20260410-0004`
+- 标题: 按钮 Tooltip 显示后，鼠标移出按钮区域提示框不消失
+- 状态：已修复
+- 严重性：S3
+- 优先级：P1
+- 模块: Button / Tooltip / 托管重绘
+- 版本 / 分支: 当前工作区 / 下一版本开发中
+- 环境: Windows + EasyX，本地 GUI Demo
+- 发现人: 用户
+- 关联 Fix ID: `Fix-BUG-20260410-0004`
+
+## 问题描述
+
+- 现象:
+  - 按钮启用 Tooltip 后，提示框成功显示。
+  - 鼠标离开按钮区域后，Tooltip 仍残留在屏幕上，不会及时消失。
+- 影响范围:
+  - 所有启用了 Tooltip 的 `Button`
+  - 典型场景包括 `KEY == 4` 的综合回归用例
+- 期望结果:
+  - 鼠标离开按钮后，Tooltip 应立即回贴并消失，不留下残影
+- 实际结果:
+  - Tooltip 逻辑状态已切换为隐藏，但屏幕上的提示框区域未被及时擦除
+
+## 复现信息
+
+- 前置条件:
+  - 使用启用 Tooltip 的按钮
+- 复现步骤:
+
+1. 运行带 Tooltip 按钮的 Demo
+2. 将鼠标悬停在按钮上，等待 Tooltip 显示
+3. 将鼠标移出按钮区域，观察 Tooltip 是否立即消失
+
+- 复现概率：高概率
+- 最小复现 Demo:
+  - `z-testDome.cpp` 中 `KEY == 4`
+- 证据：现象观察 + 代码链路分析
+
+## 初步分析
+
+- 疑似位置:
+  - [`Button.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Button.cpp)
+  - `Button::hideTooltip()`
+- 触发条件:
+  - Tooltip 已经显示
+  - 鼠标离开按钮，进入 Tooltip 隐藏分支
+- 相关线索:
+  - Tooltip 不是独立控件树成员，而是 `Button::draw()` 末尾补画的内置浮层
+  - 隐藏时若只作废快照而不回贴 Tooltip 自己的背景，按钮本体重绘并不会覆盖 Tooltip 占用区域
+- 最近相关改动:
+  - 事件改状态 / Window 托管重绘收口
+  - 布局系统第一阶段重构
+
+## 跟踪信息
+
+- 首次发现时间: 2026-04-10
+- 最后更新时间: 2026-04-10
+- 修复版本: 待定
+- 验证版本: 当前工作区
+- 备注:
+  - 本文档仅记录问题本身，具体修复方案见关联 Fix 文档
diff --git a/开发记录/BUG/BUG-20260415-0005-局部重绘未补画上层兄弟导致遮挡错误.md b/开发记录/BUG/BUG-20260415-0005-局部重绘未补画上层兄弟导致遮挡错误.md
new file mode 100644
index 0000000..d0de986
--- /dev/null
+++ b/开发记录/BUG/BUG-20260415-0005-局部重绘未补画上层兄弟导致遮挡错误.md
@@ -0,0 +1,73 @@
+# BUG-20260415-0005
+
+> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
+
+## 基本信息
+
+- ID: BUG-20260415-0005
+- 标题: 局部重绘未补画上层兄弟导致遮挡错误
+- 状态：已修复
+- 严重性：S2
+- 优先级：P1
+- 模块: Window / Canvas / TabControl 局部重绘与合成
+- 版本 / 分支: 当前工作区
+- 环境: Windows + EasyX
+- 发现人: 用户回归测试
+- 关联 Fix ID：[可选]
+  - `Fix-BUG-20260415-0005`
+
+## 问题描述
+
+- 现象:
+  - 下层控件发生局部重绘后，位于其上方且与 coverage 相交的兄弟控件没有被补画回来。
+  - 表现为上层 `Canvas / Dialog / 页 / 页签按钮` 被“切掉”或被下层重新盖住。
+- 影响范围:
+  - 顶层普通控件之间
+  - `Canvas` 直接子控件之间
+  - `TabControl` 页签按钮与页面之间
+- 期望结果:
+  - 任意局部重绘提交后，父容器应按实际绘制顺序把 coverage 上方相交的兄弟重新合成回来。
+- 实际结果:
+  - 仅 dirty root 或 dirty child 被重画，上层兄弟未恢复。
+
+## 复现信息
+
+- 前置条件：[可选]
+  - 使用 `KEY5` 测试场景
+- 复现步骤:
+
+1. 进入 `KEY5`
+2. 触发下层控件局部重绘，例如 `Table` 翻页或相交子控件 hover / click
+3. 观察上层相交兄弟区域
+
+- 复现概率：高概率
+- 最小复现 Demo：[可选]
+  - `KEY5` 中 `Table` 与顶层粉色浮层重叠场景
+  - 同父 `Canvas` 兄弟相交场景
+- 证据：截图 / 日志 / 调用栈 / 录屏 / 断点观察
+  - 断点观察显示 dirty root 已提交，但上层 sibling 未重新执行 draw
+
+## 初步分析
+
+- 疑似位置:
+  - [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)
+  - [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)
+  - [`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)
+- 触发条件:
+  - 局部重绘提交写入了下层像素，但没有做 overlay 兄弟补画
+- 相关线索:
+  - 该问题不依赖“是否回贴背景快照”，直接重绘同样会破坏上层合成结果
+  - `Dialog` 之前之所以需要补画，本质上是同一类问题
+- 最近相关改动：[可选]
+  - 第二阶段开始引入更严格的局部重绘与 overlay 收口后，问题被系统性暴露
+
+## 跟踪信息
+
+- 首次发现时间: 2026-04-15
+- 最后更新时间: 2026-04-15
+- 修复版本：[可选]
+  - 当前工作区
+- 验证版本：[可选]
+  - 当前工作区
+- 备注：[可选]
+  - 后续仍需继续关注 `Dialog` 旧 synthetic move 机制与新模型的统一。
diff --git a/开发记录/BUG/BUG-20260415-0006-托管局部重绘未正确提交脏子树导致嵌套Canvas按钮状态不刷新.md b/开发记录/BUG/BUG-20260415-0006-托管局部重绘未正确提交脏子树导致嵌套Canvas按钮状态不刷新.md
new file mode 100644
index 0000000..1195fbb
--- /dev/null
+++ b/开发记录/BUG/BUG-20260415-0006-托管局部重绘未正确提交脏子树导致嵌套Canvas按钮状态不刷新.md
@@ -0,0 +1,53 @@
+# BUG-20260415-0006
+
+> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
+
+## 基本信息
+
+- ID: BUG-20260415-0006
+- 标题: 托管局部重绘未正确提交脏子树导致嵌套 Canvas 按钮状态不刷新
+- 状态：已修复
+- 严重性：S2
+- 优先级：P1
+- 模块: 重绘 / 托管局部提交 / Canvas 嵌套
+- 版本 / 分支: 当前工作区
+- 环境: Windows / EasyX / KEY5 回归场景
+- 发现人: 用户
+- 关联 Fix ID：Fix-BUG-20260415-0006
+
+## 问题描述
+
+- 现象: KEY5 中第二层、第三层 Canvas 内按钮可正常触发 hover / click 回调，但视觉状态不刷新。
+- 影响范围: 嵌套 Canvas 内的深层按钮、页内嵌套容器按钮、所有依赖托管局部重绘的脏后代场景。
+- 期望结果: 只要深层按钮状态变化，最外层托管 root 应能正确提交对应脏子树并把视觉结果画出来。
+- 实际结果: 日志显示事件和回调已执行，但屏幕上不出现 hover / press / release 反馈，直到触发更大范围重绘才会补出来。
+
+## 复现信息
+
+- 前置条件: 使用 KEY5 场景，启用三层 Canvas 嵌套回归区。
+- 复现步骤:
+
+1. 打开 KEY5。
+2. 将鼠标移到第二层或第三层 Canvas 内的按钮上，观察 hover。
+3. 点击按钮并观察按下、松开状态。
+
+- 复现概率：必现
+- 最小复现 Demo：KEY5 A 区三层 Canvas 嵌套
+- 证据：日志显示按钮回调已执行，但按钮视觉状态不刷新
+
+## 初步分析
+
+- 疑似位置: Canvas 托管局部重绘提交链、Window 托管重绘登记 coverage
+- 触发条件: root 的直接子控件本身不 dirty，但其下存在 dirty descendant
+- 相关线索:
+  - 托管局部提交只认直接 dirty child
+  - 深层按钮状态变化未提升到 root 下直接脏分支
+- 最近相关改动：第二阶段布局与托管重绘收口
+
+## 跟踪信息
+
+- 首次发现时间: 2026-04-15
+- 最后更新时间: 2026-04-15
+- 修复版本：当前工作区
+- 验证版本：KEY5 编译级验证通过，待用户手测
+- 备注：该问题已按机制修复，不再使用临时整容器重绘补丁
diff --git a/开发记录/BUG/BUG-20260415-0007-实际绘制coverage低估导致Tooltip与overlay补画漏算.md b/开发记录/BUG/BUG-20260415-0007-实际绘制coverage低估导致Tooltip与overlay补画漏算.md
new file mode 100644
index 0000000..f6089d6
--- /dev/null
+++ b/开发记录/BUG/BUG-20260415-0007-实际绘制coverage低估导致Tooltip与overlay补画漏算.md
@@ -0,0 +1,53 @@
+# BUG-20260415-0007
+
+> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
+
+## 基本信息
+
+- ID: BUG-20260415-0007
+- 标题: 实际绘制 coverage 低估导致 Tooltip 与 overlay 补画漏算
+- 状态：已修复
+- 严重性：S2
+- 优先级：P1
+- 模块: Tooltip / overlay 重组 / 托管 coverage
+- 版本 / 分支: 当前工作区
+- 环境: Windows / EasyX / KEY5 回归场景
+- 发现人: 用户
+- 关联 Fix ID：Fix-BUG-20260415-0007
+
+## 问题描述
+
+- 现象: C 米区容器内按钮 Tooltip 会画到 D 橙区上层；类似问题也可能出现在带附加绘制区域的其他控件上。
+- 影响范围: Tooltip、页签按钮 Tooltip、内部按钮与浮层、overlay 补画依赖 coverage 的所有链路。
+- 期望结果: overlay 补画应按“实际写到屏幕上的区域”判断，而不是只按控件本体 bounds。
+- 实际结果: 按钮本体未与上层控件相交时，Tooltip 超出部分不会触发 overlay 补画，导致 Tooltip 压到不应被压住的上层控件之上。
+
+## 复现信息
+
+- 前置条件: 使用 KEY5，保证 C 米区按钮 Tooltip 会伸进 D 橙区。
+- 复现步骤:
+
+1. 打开 KEY5。
+2. 将鼠标移到 C 米区容器内按钮上，触发 Tooltip。
+3. 观察 Tooltip 与 D 橙区的遮挡关系。
+
+- 复现概率：必现
+- 最小复现 Demo：KEY5 C / D 交界区
+- 证据：Tooltip 可见区域超出按钮 bounds，但 overlay 补画未跟上
+
+## 初步分析
+
+- 疑似位置: Button Tooltip coverage、Window/Canvas/TabControl 的 coverage 计算链
+- 触发条件: 控件本体 bounds 未与 overlay 相交，但附加绘制区域（例如 Tooltip）已伸入 overlay 区
+- 相关线索:
+  - 之前的 coverage 默认等于 `getBoundsRect()`
+  - `Button` 的 Tooltip 由 `tipLabel` 额外绘制，不属于按钮本体矩形
+- 最近相关改动：顶层 overlay 传递式补画机制已补齐，但 coverage 仍按本体矩形计算
+
+## 跟踪信息
+
+- 首次发现时间: 2026-04-15
+- 最后更新时间: 2026-04-15
+- 修复版本：当前工作区
+- 验证版本：KEY5 编译级验证通过，待用户手测
+- 备注：Tooltip 智能选位明确后置，本次只修根因链路
diff --git a/开发记录/BUG/BUG-20260415-0008-TabControl页签层级与重复激活链路导致Tooltip和残影异常.md b/开发记录/BUG/BUG-20260415-0008-TabControl页签层级与重复激活链路导致Tooltip和残影异常.md
new file mode 100644
index 0000000..1d379ce
--- /dev/null
+++ b/开发记录/BUG/BUG-20260415-0008-TabControl页签层级与重复激活链路导致Tooltip和残影异常.md
@@ -0,0 +1,68 @@
+# BUG-20260415-0008
+
+> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
+
+## 基本信息
+
+- ID: BUG-20260415-0008
+- 标题: TabControl 页签层级与重复激活链路导致 Tooltip 和残影异常
+- 状态：已修复
+- 严重性：S2
+- 优先级：P1
+- 模块: TabControl / 页签绘制 / 外部激活页签
+- 版本 / 分支: 当前工作区
+- 环境: Windows / EasyX / KEY1 / KEY5
+- 发现人: 用户
+- 关联 Fix ID：Fix-BUG-20260415-0008
+
+## 问题描述
+
+- 现象:
+  - 有任意页签打开时，页签按钮 Tooltip 无法正常显示，只有全部页签关闭时正常。
+  - KEY1 中页签 1 的表格超出 TabControl 区域，外部按钮重复激活同一页签后，再切页或关闭页签会留下超出部分残影。
+- 影响范围: TabControl 页签按钮 Tooltip、外部 `setActiveIndex()` 重复调用、页内超出页面边界绘制的控件。
+- 期望结果:
+  - 页签按钮应始终位于页面之上，Tooltip 正常显示。
+  - 外部重复激活已激活页签不应破坏当前可见页面的快照链。
+- 实际结果:
+  - 页签按钮 Tooltip 会被页面盖掉。
+  - 外部重复激活同一页签后，页内超出页面区域的 Table 在切页/关页时会残留。
+
+## 复现信息
+
+- 前置条件:
+  - KEY5：存在可见页面和页签按钮 Tooltip
+  - KEY1：页签 1 内的 Table 长于 TabControl 页面区域，存在外部按钮 `test`
+- 复现步骤:
+
+1. 在 KEY5 中打开任意页签，将鼠标移到页签按钮上触发 Tooltip。
+2. 观察 Tooltip 是否被页面盖掉。
+3. 在 KEY1 中点击一次 `test` 激活页签 1。
+4. 再点击一次 `test`，然后切页或关闭页签 1。
+
+- 复现概率：必现
+- 最小复现 Demo：KEY5 TabControl 区、KEY1 页签 1 + 外部 `test` 按钮
+- 证据：Tooltip 被页面覆盖；重复激活后切页/关页出现残影
+
+## 初步分析
+
+- 疑似位置:
+  - `TabControl::draw()`
+  - `TabControl::requestRepaint()`
+  - `TabControl::setActiveIndex()`
+  - `Button::setButtonClick()`
+- 触发条件:
+  - 页签按钮先画、页面后画
+  - `TOGGLE` 同状态重复 set 仍触发 onToggleOn
+- 相关线索:
+  - 页面绘制层级高于页签按钮时，页签 Tooltip 会被后画的页面盖掉
+  - 重复激活已激活页签会重复执行页面 `onWindowResize()` / `setIsVisible(true)` 链
+- 最近相关改动：TabControl overlay / Tooltip 回归专项修复
+
+## 跟踪信息
+
+- 首次发现时间: 2026-04-15
+- 最后更新时间: 2026-04-15
+- 修复版本：当前工作区
+- 验证版本：KEY1 / KEY5 编译级验证通过，待用户手测
+- 备注：本次只修页签层级和重复激活链路，不扩到 TabControl 其它内部布局语义
diff --git a/开发记录/Fix/Fix-BUG-20260410-0004-按钮Tooltip移出后不消失.md b/开发记录/Fix/Fix-BUG-20260410-0004-按钮Tooltip移出后不消失.md
new file mode 100644
index 0000000..a655a6d
--- /dev/null
+++ b/开发记录/Fix/Fix-BUG-20260410-0004-按钮Tooltip移出后不消失.md
@@ -0,0 +1,88 @@
+# Fix-BUG-20260410-0004
+
+> 适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。
+
+## 关联信息
+
+- Fix ID: `Fix-BUG-20260410-0004`
+- 关联 BUG ID: `BUG-20260410-0004`
+- 修复目标: 让按钮 Tooltip 在鼠标移出后立即回贴并消失，不再残留在屏幕上
+- 状态：已验证
+- 负责人: Codex 协作修改
+- 分支 / 版本: 当前工作区 / 下一版本开发中
+
+## 根因分析
+
+- 根因:
+  - Tooltip 由 `Button` 在绘制末尾以内置浮层方式直接补画，不属于独立控件树节点。
+  - 隐藏路径里根据托管分发状态分叉处理，在托管分发阶段仅调用 `invalidateBackgroundSnapshot()`，只作废 Tooltip 快照，不执行回贴。
+  - 当本轮后续重绘只覆盖按钮本体区域时，Tooltip 占用的屏幕区域不会被擦除，因此表现为 Tooltip 留在屏幕上。
+- 触发条件:
+  - Tooltip 已显示
+  - 鼠标移出按钮区域，进入 `hideTooltip()` 分支
+- 为什么之前没发现:
+  - 之前更关注 Tooltip 的显示、Hover 切换和对话框遮挡链路
+  - “逻辑状态已隐藏，但屏幕区域无人回贴”的问题只有在当前托管重绘路径下才更稳定暴露
+- 关键证据:
+  - [`Button.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Button.cpp) 中 `hideTooltip()` 在托管分发阶段只作废快照，不回贴 Tooltip 自身区域
+
+## 修复方案
+
+- 修复思路:
+  - Tooltip 既然是 `Button` 的内置浮层，就按“内置浮层”语义处理隐藏逻辑
+  - 隐藏时直接调用 Tooltip 现有接口回贴背景快照并作废，不再区分托管分发阶段
+- 关键改动:
+  - 简化 `Button::hideTooltip()` 分支
+  - 只要 `tipVisible == true`，统一调用 `tipLabel.hide()`
+  - 保留 `tipHoverTick` 重置逻辑
+- 涉及文件 / 类 / 函数:
+  - [`Button.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Button.cpp)
+  - `Button::hideTooltip()`
+- 影响的 API / 行为:
+  - 无公开 API 变化
+  - 内部行为调整为“Tooltip 隐藏时总是立即回贴其自身区域”
+- 关键约束 / 不变量:
+  - Tooltip 继续作为 `Button` 内置浮层存在
+  - 不引入新的 Tooltip 控件树托管协议
+  - 不扩大 `Window` 托管重绘 coverage
+- 回滚点 / 开关:
+  - 若后续需要回退，只需恢复 `Button::hideTooltip()` 的旧分支逻辑
+
+## 影响评估
+
+- 影响范围:
+  - 启用 Tooltip 的 `Button`
+  - `KEY == 4` 等包含 Tooltip 的回归场景
+- 兼容性影响：无
+- 行为变化：有（Tooltip 隐藏时由“部分路径只作废快照”改为“统一立即回贴并作废”）
+- 性能影响：无
+- 回归风险:
+  - Tooltip 隐藏时会发生一次即时局部回贴
+  - 由于 Tooltip 本身就是按钮内置浮层，这个行为与其显示方式一致，风险相对可控
+
+## 验证结果
+
+- 验证步骤:
+
+1. 修改 [`Button.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Button.cpp) 中 `Button::hideTooltip()` 的 Tooltip 隐藏分支
+2. 编译 `Button.cpp`
+3. 编译 `z-testDome.cpp` 并指定 `KEY=4`，确认 Tooltip 相关 demo 入口可正常编译
+
+- 验证结果:
+  - 代码已完成修改
+  - 源码级编译验证通过
+  - 基于当前代码链路推演，Tooltip 离开按钮后会立即回贴自身区域，不再依赖按钮本体重绘覆盖 Tooltip 区域
+- 回归检查:
+  - 未做 GUI 手动交互回归
+  - 需用户进一步确认实际 Tooltip 行为
+- 验证证据:
+  - `Button.cpp` 编译通过
+  - `z-testDome.cpp /DKEY=4` 编译通过
+
+## 落地信息
+
+- Commit: 当前工作区未提交
+- PR：[可选]
+- 发布版本：[可选]
+- 备注:
+  - 本次修复未改动 Tooltip 对外接口，只调整内部隐藏路径
diff --git a/开发记录/Fix/Fix-BUG-20260415-0005-局部重绘补画上层兄弟修复.md b/开发记录/Fix/Fix-BUG-20260415-0005-局部重绘补画上层兄弟修复.md
new file mode 100644
index 0000000..a0d80a9
--- /dev/null
+++ b/开发记录/Fix/Fix-BUG-20260415-0005-局部重绘补画上层兄弟修复.md
@@ -0,0 +1,83 @@
+# Fix-BUG-20260415-0005
+
+> 适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。
+
+## 关联信息
+
+- Fix ID: Fix-BUG-20260415-0005
+- 关联 BUG ID: BUG-20260415-0005
+- 修复目标: 收口局部重绘提交后的 overlay 兄弟补画机制
+- 状态：已完成
+- 负责人: Codex 协作修改
+- 分支 / 版本: 当前工作区
+
+## 根因分析
+
+- 根因:
+  - 局部重绘提交只重画了 dirty root 或 dirty child，没有按父容器真实绘制顺序把 coverage 上方相交的兄弟补画回来。
+- 触发条件:
+  - 下层区域写入像素后，上层 sibling 与本次 coverage 相交。
+- 为什么之前没发现：[可选]
+  - 旧场景多集中在对话框覆盖链，普通 sibling overlay 问题没有被系统化回归。
+- 关键证据：[可选]
+  - `KEY5` 中 `Table` 翻页覆盖顶层粉色浮层可稳定复现。
+  - 同父 `Canvas` 相交子控件在局部重绘后会出现相同症状。
+
+## 修复方案
+
+- 修复思路:
+  - 不做控件之间的长期联动标记。
+  - 改为由父容器在局部重绘提交后，按真实绘制顺序动态补画 coverage 上方相交的直接绘制单元。
+- 关键改动:
+  - `Window`：补画普通顶层控件 overlay，而不再只补 `Dialog`
+  - `Canvas`：补画 coverage 上方相交的直接子控件
+  - `TabControl`：按自己的真实绘制顺序补画页签按钮与页面
+  - overlay 补画前统一 `invalidateBackgroundSnapshot()`，避免旧快照反贴旧背景
+- 涉及文件 / 类 / 函数:
+  - [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)
+  - [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)
+  - [`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)
+- 影响的 API / 行为：[可选]
+  - 无对外 API 变化
+  - 局部重绘行为更严格遵守视觉合成顺序
+- 关键约束 / 不变量：[可选]
+  - 父容器只处理自己的直接绘制单元
+  - overlay 补画顺序必须与实际 `draw()` 顺序一致
+  - 不升级为整窗 / 整容器重绘，除非父容器自身快照或 dirty 条件不满足
+- 回滚点 / 开关：[可选]
+  - 无单独开关，回滚需回退相关局部重绘提交逻辑
+
+## 影响评估
+
+- 影响范围:
+  - `Window / Canvas / TabControl` 的局部重绘提交路径
+- 兼容性影响：无
+- 行为变化：有（局部重绘后会补画上层 overlay）
+- 性能影响：有（增加必要的 overlay 补画），但仍显著小于整窗 / 整容器重绘
+- 回归风险:
+  - 若 coverage 计算不准，仍可能遗漏或多画
+  - `TabControl` 局部重绘顺序必须和真实 `draw()` 顺序保持一致
+
+## 验证结果
+
+- 验证步骤:
+
+1. 编译 [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)、[`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)、[`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)
+2. 编译 [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp) `KEY=5`
+3. 回归 `Table` 翻页、相交 `Canvas`、`TabControl` 页签/页面遮挡场景
+
+- 验证结果:
+  - 编译级验证通过
+  - GUI 手动回归需继续在本机确认
+- 回归检查：[可选]
+  - `Table` 分页按钮与页码链已同步收口
+- 验证证据：[可选]
+  - `KEY5` 已新增更明确的 overlay 专项场景
+
+## 落地信息
+
+- Commit: 未提交（当前工作区）
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：[可选]
+  - `Dialog` 旧 synthetic move 逻辑本轮保留，后续可再评估是否纳入通用清理模型。
diff --git a/开发记录/Fix/Fix-BUG-20260415-0006-托管局部重绘脏子树提交链修复.md b/开发记录/Fix/Fix-BUG-20260415-0006-托管局部重绘脏子树提交链修复.md
new file mode 100644
index 0000000..3b1e6e5
--- /dev/null
+++ b/开发记录/Fix/Fix-BUG-20260415-0006-托管局部重绘脏子树提交链修复.md
@@ -0,0 +1,69 @@
+# Fix-BUG-20260415-0006
+
+> 适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。
+
+## 关联信息
+
+- Fix ID: Fix-BUG-20260415-0006
+- 关联 BUG ID: BUG-20260415-0006
+- 修复目标: 让托管局部重绘能够正确提交嵌套容器中的脏后代
+- 状态：已完成
+- 负责人: Codex
+- 分支 / 版本: 当前工作区
+
+## 根因分析
+
+- 根因: 托管局部重绘提交只识别 root 的直接 dirty child，不识别“自己不脏，但下面有 dirty descendant”的直接子分支。
+- 触发条件: 深层按钮状态变化后，叶子控件已 dirty，但中间层 Canvas 自己未 dirty。
+- 为什么之前没发现: 第一阶段主要覆盖顶层和浅层容器，三层嵌套专项场景在 KEY5 重构后才稳定暴露。
+- 关键证据:
+  - 按钮 hover / click 回调正常执行
+  - 日志正常，但视觉状态直到更大重绘才补出来
+
+## 修复方案
+
+- 修复思路: 把托管重绘提交从“只认直接 dirty child”改成“识别 dirty descendant，并提升到 root 下直接脏分支提交”。
+- 关键改动:
+  - 新增 `hasManagedDirtySubtree()`
+  - 新增 `getManagedRepaintDirectBranch(root)`
+  - `Canvas / TabControl` 局部提交时，直接子单元若拥有 dirty descendant，也继续 `commitManagedRepaint()`
+  - `Window::requestManagedRepaint()` 的 coverage 从最深叶子提升到 root 下直接脏分支
+- 涉及文件 / 类 / 函数:
+  - `Control.h / Control.cpp`
+  - `Canvas.cpp`
+  - `TabControl.cpp`
+  - `Window.cpp`
+- 影响的 API / 行为：无公开 API 变化
+- 关键约束 / 不变量:
+  - dirty descendant 不能再被中间层漏掉
+  - 托管局部提交顺序仍需保持与真实绘制顺序一致
+- 回滚点 / 开关：无
+
+## 影响评估
+
+- 影响范围: 嵌套 Canvas、页内嵌套容器、深层按钮 hover / click / tooltip 状态刷新
+- 兼容性影响：无
+- 行为变化：有（深层按钮视觉状态会及时刷新）
+- 性能影响：有（coverage 更保守，局部补画可能略增）
+- 回归风险:
+  - 局部提交 coverage 扩大后，上层 overlay 补画次数可能增加
+  - 需重点回归嵌套容器与顶层 overlay 场景
+
+## 验证结果
+
+- 验证步骤:
+
+1. 编译 `Control.cpp / Canvas.cpp / TabControl.cpp / Window.cpp / z-testDome.cpp`
+2. 使用 KEY5 三层嵌套区作为主回归入口
+3. 检查深层按钮 hover / press / release 是否能即时刷新
+
+- 验证结果: 编译通过；逻辑推演闭合；GUI 需用户本机手测
+- 回归检查：KEY5 三层嵌套、页内嵌套、overlay 补画主线
+- 验证证据：编译级验证通过
+
+## 落地信息
+
+- Commit: 未单独提交
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：该修复为机制修正，不是 KEY5 专项补丁
diff --git a/开发记录/Fix/Fix-BUG-20260415-0007-实际绘制coverage与overlay补画链修复.md b/开发记录/Fix/Fix-BUG-20260415-0007-实际绘制coverage与overlay补画链修复.md
new file mode 100644
index 0000000..9f032bf
--- /dev/null
+++ b/开发记录/Fix/Fix-BUG-20260415-0007-实际绘制coverage与overlay补画链修复.md
@@ -0,0 +1,71 @@
+# Fix-BUG-20260415-0007
+
+> 适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。
+
+## 关联信息
+
+- Fix ID: Fix-BUG-20260415-0007
+- 关联 BUG ID: BUG-20260415-0007
+- 修复目标: 让托管 coverage 与 overlay 补画基于实际绘制范围，而非控件本体 bounds
+- 状态：已完成
+- 负责人: Codex
+- 分支 / 版本: 当前工作区
+
+## 根因分析
+
+- 根因: `Window / Canvas / TabControl` 的 coverage 计算链默认使用 `getBoundsRect()`，没有把 Tooltip 这类附加绘制区域纳入。
+- 触发条件: 控件本体未与 overlay 相交，但附加绘制区域超出本体并写入更上层区域。
+- 为什么之前没发现: 第一轮主要解决普通控件和顶层 overlay；Tooltip 属于本体外附加绘制，直到 C / D 交界回归才稳定暴露。
+- 关键证据:
+  - 顶层按钮 Tooltip 正常，但容器内按钮 Tooltip 压到 D 橙区
+  - 根因与按钮本体 bounds 无关，与 Tooltip 超出范围有关
+
+## 修复方案
+
+- 修复思路: 引入“实际绘制 coverage”接口，让托管重绘与局部提交统一走真实覆盖范围。
+- 关键改动:
+  - 在 `Control` 增加 `getManagedRepaintCoverageRect()`
+  - `Button` 在 Tooltip 可见时返回“按钮矩形 + Tooltip 矩形”的并集
+  - `Canvas / TabControl / Table` 将可见内部绘制单元 coverage 递归并入
+  - `Window::requestManagedRepaint()` 和顶层 overlay 重组改为走 coverage 接口
+- 涉及文件 / 类 / 函数:
+  - `Control.h / Control.cpp`
+  - `Button.h / Button.cpp`
+  - `Canvas.h / Canvas.cpp`
+  - `TabControl.h / TabControl.cpp`
+  - `Table.h / Table.cpp`
+  - `Window.cpp`
+- 影响的 API / 行为：新增内部 virtual 接口，无公开 API 变化
+- 关键约束 / 不变量:
+  - Tooltip 智能选位不在本次修复范围内
+  - overlay 补画继续按父容器真实绘制顺序工作
+- 回滚点 / 开关：无
+
+## 影响评估
+
+- 影响范围: Tooltip、overlay 补画、复杂容器内附加绘制区域
+- 兼容性影响：无
+- 行为变化：有（Tooltip 与 overlay 层级恢复正确）
+- 性能影响：有（coverage 更保守，可能触发更多 overlay 补画）
+- 回归风险:
+  - coverage 扩大后顶层/容器层局部提交会多画一些 overlay
+  - 需重点回归 Tooltip 与多跳 overlay 场景
+
+## 验证结果
+
+- 验证步骤:
+
+1. 编译 `Control.cpp / Button.cpp / Canvas.cpp / TabControl.cpp / Table.cpp / Window.cpp / z-testDome.cpp`
+2. 在 KEY5 中验证 C 米区容器内按钮 Tooltip 与 D 橙区的遮挡关系
+3. 回归顶层按钮 Tooltip、页签按钮 Tooltip、浮层按钮 Tooltip
+
+- 验证结果: 编译通过；逻辑推演闭合；GUI 需用户本机手测
+- 回归检查：KEY5 C/D 交界区、TabControl 页签、三层嵌套按钮 Tooltip
+- 验证证据：编译级验证通过
+
+## 落地信息
+
+- Commit: 未单独提交
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：Tooltip 智能选位明确延期，本次只修“coverage 正确性”
diff --git a/开发记录/Fix/Fix-BUG-20260415-0008-TabControl页签层级与重复激活链路修复.md b/开发记录/Fix/Fix-BUG-20260415-0008-TabControl页签层级与重复激活链路修复.md
new file mode 100644
index 0000000..8337ffe
--- /dev/null
+++ b/开发记录/Fix/Fix-BUG-20260415-0008-TabControl页签层级与重复激活链路修复.md
@@ -0,0 +1,75 @@
+# Fix-BUG-20260415-0008
+
+> 适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。
+
+## 关联信息
+
+- Fix ID: Fix-BUG-20260415-0008
+- 关联 BUG ID: BUG-20260415-0008
+- 修复目标: 修正 TabControl 页签层级和重复激活已激活页签的回调链
+- 状态：已完成
+- 负责人: Codex
+- 分支 / 版本: 当前工作区
+
+## 根因分析
+
+- 根因:
+  - `TabControl::draw()` 与局部重绘顺序为“先页签按钮，后页面”，导致页签 Tooltip 被页面盖掉。
+  - `Button::setButtonClick()` 对 `TOGGLE` 没有做“同状态短路”，外部重复激活同一页签会重复触发 `onToggleOnCallback`。
+  - `TabControl::setActiveIndex()` 也没有对“目标已是当前激活页”做保护，导致当前可见页的 `onWindowResize()` / `setIsVisible(true)` 链被重复执行。
+- 触发条件:
+  - 任意页打开时触发页签 Tooltip
+  - 外部对已激活页签再次 `setActiveIndex()`
+- 为什么之前没发现: KEY1 外部按钮重复激活场景和 KEY5 页签 Tooltip 场景是后续专项回归才补出来的。
+- 关键证据:
+  - 所有页关闭时页签 Tooltip 正常，说明问题在页面层级覆盖
+  - 只点一次外部激活正常，重复激活后残影出现，说明问题在重复回调链
+
+## 修复方案
+
+- 修复思路:
+  - 把 TabControl 绘制/局部重绘顺序改为“先页面、后页签按钮”
+  - 给 `TOGGLE` 状态设置和 `setActiveIndex()` 增加同状态短路
+- 关键改动:
+  - `TabControl::draw()` 改成先画页面、后画页签按钮
+  - `TabControl::requestRepaint(this)` 的局部提交顺序同步调整
+  - `Button::setButtonClick()` 在 `TOGGLE` 同状态时直接返回
+  - `TabControl::setActiveIndex()` 若目标已是当前激活页则直接返回
+- 涉及文件 / 类 / 函数:
+  - `TabControl.cpp`
+  - `Button.cpp`
+- 影响的 API / 行为:
+  - 重复设置相同 `TOGGLE` 状态不再重复触发回调
+- 关键约束 / 不变量:
+  - 页签按钮视觉层级应始终高于页面
+  - 外部重复激活同一页签不应重新走页面显示链
+- 回滚点 / 开关：无
+
+## 影响评估
+
+- 影响范围: TabControl 页签 Tooltip、外部页签激活、页内超出页面边界的复合控件
+- 兼容性影响：有（收紧了 TOGGLE 同状态重复 set 的回调语义）
+- 行为变化：有（页签 Tooltip 层级恢复正确；重复激活同一页签不再重复触发回调）
+- 性能影响：无
+- 回归风险:
+  - 如有外部代码依赖“同状态重复 set 也要重复触发回调”，该行为将被收掉
+  - 需重点回归 KEY1 和 KEY5 的 TabControl 场景
+
+## 验证结果
+
+- 验证步骤:
+
+1. 编译 `Button.cpp / TabControl.cpp`
+2. 编译 `z-testDome.cpp` 的 `KEY=1`
+3. 回归 `KEY5` 页签 Tooltip 与 `KEY1` 外部按钮重复激活页签场景
+
+- 验证结果: 编译通过；逻辑推演闭合；GUI 需用户本机手测
+- 回归检查：KEY1 页签 1 表格超出区、KEY5 页签 Tooltip
+- 验证证据：编译级验证通过
+
+## 落地信息
+
+- Commit: 未单独提交
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：此修复不包含 TabControl 其它内部布局专题
diff --git a/开发记录/功能变更/Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md b/开发记录/功能变更/Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md
new file mode 100644
index 0000000..89a9dab
--- /dev/null
+++ b/开发记录/功能变更/Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md
@@ -0,0 +1,78 @@
+# 功能变更 ID: Feature-20260415-0008
+
+> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
+> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。
+
+## 基本信息
+
+- ID: Feature-20260415-0008
+- 标题: KEY5 第二阶段专项回归场景增强
+- 状态：已完成
+- 类型：修改
+- 级别：L2 中等
+- 模块: 测试用例 / 回归场景
+- 版本 / 分支: 当前工作区
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 变更背景
+
+- 背景:
+  - 旧版 `KEY5` 已能覆盖第一阶段布局主线，但场景层次不够集中，说明文字偏长，部分区域排版紧。
+  - 第二阶段引入了内容驱动、overlay 补画、容器职责边界等新验证点，旧 `KEY5` 覆盖不完整。
+- 目标:
+  - 把 `KEY5` 重构成第二阶段专项回归入口。
+  - 增加三层 `Canvas` 嵌套、通用 overlay、跨容器 hover 清理、`Label` 内容驱动规则验证。
+- 不做什么：[可选]
+  - 不追求视觉美化。
+  - 不把测试用例变成完整 demo 页。
+
+## 变更内容
+
+- 变更摘要:
+  - 重构 `KEY5` 的区域布局与说明文案。
+  - 引入三层嵌套 `Canvas` 场景。
+  - 增加 `Window / Canvas / TabControl / Table` 四类关键回归点。
+- 新增项：[可选]
+  - 三层 `Canvas` 嵌套与多层锚点链回归。
+  - `Label` 文本变化 / 样式变化按钮。
+  - 跨容器相邻按钮 hover/tooltip 回归点。
+  - 顶层浮层覆盖 `Table` 的 overlay 回归点。
+- 修改项：[可选]
+  - 缩短说明 `Label` 文案，减少普通排版重叠。
+  - 重新组织分区顺序，提升单区可读性。
+- 删除 / 废弃项：[可选]
+  - 删除过长、重复的说明文案。
+- 受影响的文件 / 类 / 函数:
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 对外 API / 属性变化：[可选]
+  - 无
+
+## 行为对照
+
+- 变更前:
+  - `KEY5` 主要覆盖第一阶段布局规则，层次和交互链回归点相对分散。
+  - 说明文字较长，部分区域排版偏挤。
+- 变更后:
+  - `KEY5` 成为第二阶段主回归入口。
+  - 三层嵌套、overlay、跨容器 hover、`Label` 内容驱动、`Table` 分页与页码都能直接观察。
+- 兼容性说明：兼容
+- 迁移说明：[可选]
+  - 仍然通过 `#define KEY 5` 进入，无额外迁移。
+
+## 验证与落地
+
+- 验证方式:
+  - 编译 `z-testDome.cpp /DKEY=5`
+  - 手动观察窗口 resize、hover、tooltip、overlay、分页和 `Label` 变化
+- 验证结果:
+  - 编译级验证通过
+  - GUI 手动验证待本机执行
+- 关联 BUG / Fix：[可选]
+  - `BUG-20260415-0005`
+  - `Fix-BUG-20260415-0005`
+- Commit: 未提交（当前工作区）
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：[可选]
+  - `Label` 样式变化验证明确依赖 `setDirty(true)` 使用约定。
diff --git a/开发记录/功能变更/Feature-20260416-0009-KEY2-使用新布局API重构与联动刷新.md b/开发记录/功能变更/Feature-20260416-0009-KEY2-使用新布局API重构与联动刷新.md
new file mode 100644
index 0000000..7b10f5e
--- /dev/null
+++ b/开发记录/功能变更/Feature-20260416-0009-KEY2-使用新布局API重构与联动刷新.md
@@ -0,0 +1,87 @@
+# 功能变更 ID: Feature-20260416-0009
+
+> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
+> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。
+
+## 基本信息
+
+- ID: Feature-20260416-0009
+- 标题: KEY2 使用新布局 API 重构与联动刷新
+- 状态：开发中
+- 类型：修改
+- 级别：L2 中等
+- 模块: 测试用例 / Layout API 迁移样例
+- 版本 / 分支: 当前工作区
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 变更背景
+
+- 背景:
+  - `KEY2` 原有布局主要依赖旧 `setAnchor(...)` 语义，无法清晰表达“固定尺寸 + 比例位移”。
+  - 32 位位号标签与位按钮分别按各自尺寸参与比例位移，窗口拉伸后会发生错位。
+  - 位按钮点击后，下面的十六进制、十进制与二进制显示区刷新链散落在多个回调中，维护成本高且容易漏更新。
+- 目标:
+  - 把 `KEY2` 改成新布局 API 的首个完整迁移样例。
+  - 修复位标签与位按钮 resize 后错位问题。
+  - 让位按钮、位操作按钮、配置区按钮共用一条统一的显示刷新链。
+- 不做什么：[可选]
+  - 不重构 `KEY1 / KEY5`
+  - 不引入 `KEY2` 以外的新功能
+
+## 变更内容
+
+- 变更摘要:
+  - 重构 `KEY2` 位选择区为“每一位一个小 Canvas 单元”。
+  - 使用新布局 API 重排 `KEY2` 的选择区、功能区、数值显示区、二进制显示区与配置区。
+  - 抽出统一的 bit 快照、应用、显示刷新链，收口位按钮与功能按钮的联动。
+- 新增项：[可选]
+  - `KEY2` 内部的布局辅助策略函数
+  - `snapshotBits / applyBits / refreshDisplaysWithBits` 这类统一刷新路径
+- 修改项：[可选]
+  - 32 位位标签与位按钮的组织方式
+  - 顶层区域的拉伸策略
+  - 一键置 0 / 一键置 1 / 左移 / 右移 / 位取反 / signed toggle 的显示刷新方式
+- 删除 / 废弃项：[可选]
+  - 废弃旧的“位标签和位按钮分别做比例位移”的选择区组织方式
+  - 废弃散在多个回调中的局部显示刷新
+- 受影响的文件 / 类 / 函数:
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 对外 API / 属性变化：[可选]
+  - 无框架级 API 变化，属于测试用例迁移
+
+## 行为对照
+
+- 变更前:
+  - 32 位位标签与位按钮在窗口拉伸后会发生错位。
+  - 位按钮点击后，显示区更新链不统一，后续维护难度高。
+  - `KEY2` 的多个区域仍依赖旧锚点表达，窗口拉伸时不够稳定。
+- 变更后:
+  - 每一位作为独立单元整体位移，位标签与位按钮不再分离漂移。
+  - 位按钮、一键置 0/1、位取反、左移、右移、signed toggle 均通过统一刷新链更新显示区。
+  - 顶层五个区域在窗口拉伸后继续铺满可用空间，内部小控件保持固定尺寸。
+- 兼容性说明：兼容
+- 迁移说明：[可选]
+  - 这是新布局 API 的示例迁移，不影响其它 `KEY` 入口。
+
+## 验证与落地
+
+- 验证方式:
+  - 编译 `z-testDome.cpp /DKEY=2`
+  - 编译 `z-testDome.cpp /DKEY=5`
+  - 手动验证 `KEY2`：
+    - 窗口横向拉伸
+    - 位按钮点击
+    - 位取反 / 左移 / 右移
+    - 一键置 0 / 一键置 1
+    - 有符号 / 无符号切换
+- 验证结果:
+  - 编译级验证通过。
+  - GUI 手动验证待本机继续确认。
+- 关联 BUG / Fix：[可选]
+  - 无单独 BUG 记录，本次属于布局 API 落地后的示例迁移
+- Commit:
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：[可选]
+  - 当前功能区采用左/中/右固定宽度面板布局；窗口变宽时可稳定铺满，若后续需要进一步适配极窄窗口，再考虑把功能区做成等比分栏。
diff --git a/开发记录/功能变更/Feature-20260418-0010-当前阶段测试用例矩阵与定位.md b/开发记录/功能变更/Feature-20260418-0010-当前阶段测试用例矩阵与定位.md
new file mode 100644
index 0000000..0eebfb8
--- /dev/null
+++ b/开发记录/功能变更/Feature-20260418-0010-当前阶段测试用例矩阵与定位.md
@@ -0,0 +1,156 @@
+# 功能变更 ID: Feature-20260418-0010
+
+> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
+> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。
+
+## 基本信息
+
+- ID: Feature-20260418-0010
+- 标题: 当前阶段测试用例矩阵与定位
+- 状态：已完成
+- 类型：修改
+- 级别：L1 轻量
+- 模块: 测试用例 / 回归策略
+- 版本 / 分支: 当前工作区
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 变更背景
+
+- 背景:
+  - 第二阶段主线、布局策略公开 API、`KEY2` 迁移以及近期重绘 / tooltip / overlay / `TabControl` / `Table` 修复已基本收口。
+  - 当前项目中同时存在 `KEY1 ~ KEY5` 多组测试入口，但各自负责覆盖什么、哪些是主集、哪些是专项补充，若不显式记录，后续容易继续依赖聊天上下文记忆。
+- 目标:
+  - 把当前阶段各测试入口的职责、覆盖范围和预期行为正式写成测试矩阵。
+  - 明确本阶段建议主回归集与补充专项。
+- 不做什么：[可选]
+  - 不新增测试逻辑。
+  - 不修改运行时代码。
+  - 不把测试矩阵扩成自动化测试体系。
+
+## 变更内容
+
+- 变更摘要:
+  - 新增当前阶段测试矩阵记录。
+  - 同步 `KEY1 ~ KEY5` 的阶段定位与行为预期。
+- 新增项：[可选]
+  - 当前阶段建议主回归集：`KEY1 + KEY2 + KEY5`
+  - Dialog / MessageBox 补充专项：`KEY4`
+- 修改项：[可选]
+  - 无代码修改，仅补充测试约定与阶段定位。
+- 删除 / 废弃项：[可选]
+  - 无
+- 受影响的文件 / 类 / 函数:
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 对外 API / 属性变化：[可选]
+  - 无
+
+## 行为对照
+
+- 变更前:
+  - `KEY1 ~ KEY5` 的职责划分主要依赖源码注释和聊天上下文。
+  - 很难快速判断“当前阶段主回归集”与“专项补充集”分别是什么。
+- 变更后:
+  - 每个 `KEY` 入口的阶段定位、覆盖重点和行为预期都有正式记录。
+  - 可以按矩阵组织回归，而不再只靠记忆。
+- 兼容性说明：兼容
+- 迁移说明：[可选]
+  - 无需迁移，属于当前阶段测试约定落地。
+
+## 验证与落地
+
+- 验证方式:
+  - 对照当前 [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp) 中 `KEY1 ~ KEY5` 的实际结构与近期修复范围进行人工核对。
+- 验证结果:
+  - 当前矩阵与现有测试入口和阶段主线一致。
+- 关联 BUG / Fix：[可选]
+  - [Module-20260415-0004-布局系统第二阶段验收与封口.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/模块/Module-20260415-0004-布局系统第二阶段验收与封口.md)
+  - [Module-20260416-0005-布局策略公开API落地.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/模块/Module-20260416-0005-布局策略公开API落地.md)
+- Commit:
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：[可选]
+  - resize 过程中若开启高频 console 日志，可能出现一帧视觉延迟；当前判断属于调试态 I/O 现象，不按 bug 处理。
+
+## 当前阶段测试矩阵
+
+### KEY1：旧页签链路 + Table 超界残留回归
+
+- 覆盖目标:
+  - `TabControl` 重复激活同一页签
+  - 切页 / 关页后的快照与清理链
+  - 页内容超出页范围时的残影与恢复
+- 当前预期:
+  - 外部重复激活当前页签，不再扰动当前页快照链。
+  - 页签 1 中 `Table` 超出页区域的部分，在切页或关闭页签时不会残留。
+  - 正常全量重绘后，不应再出现额外残影或层级错乱。
+- 阶段定位:
+  - 当前主回归集之一。
+
+### KEY2：公开布局 API 首个迁移样例
+
+- 覆盖目标:
+  - 新公开布局 API 的真实使用
+  - 位选择区容器化重构
+  - 显示区统一刷新链
+  - 顶层区块拉伸铺满
+- 当前预期:
+  - 32 位选择区中的“位号 + 位按钮”以单元整体位移，窗口拉伸后保持对齐。
+  - 位按钮点击、位取反、左移、右移、一键置 0/1、签名切换，会统一刷新十六进制、十进制、上次值、本次值和 `initData`。
+  - 顶层五个区块在正常拉伸 / 最大化后继续铺满窗口。
+  - 当前更偏重横向铺满验证；极窄窗口下功能区进一步自适应，不作为本阶段硬指标。
+- 阶段定位:
+  - 当前主回归集之一。
+  - 同时是新布局 API 的首个迁移示例。
+
+### KEY3：旧业务大场景保留用例
+
+- 覆盖目标:
+  - 保留老业务页示例
+  - 观察新主线是否把旧业务场景直接打坏
+- 当前预期:
+  - 登录页、`TabControl`、旧业务页基本行为保持可运行。
+  - 不要求覆盖新布局 API、overlay、tooltip 或第二阶段专项行为。
+- 阶段定位:
+  - 保留用例，不纳入当前主回归集。
+
+### KEY4：Dialog / MessageBox 专项回归
+
+- 覆盖目标:
+  - 模态 / 非模态 `Dialog`
+  - 遮挡交互
+  - 关闭后 hover 恢复
+  - 拖拽 resize
+- 当前预期:
+  - 非模态 `Dialog` 遮挡底层按钮时，不应出现 hover / tooltip 穿透或残留。
+  - 模态 `Dialog` 打开后拖拽窗口，标题、关闭按钮和底层恢复链保持稳定。
+  - 对话框关闭后，底层按钮 hover 能及时恢复。
+- 阶段定位:
+  - 当前补充专项，不纳入每轮主回归集。
+
+### KEY5：第二阶段专项主回归
+
+- 覆盖目标:
+  - 三层 `Canvas` 嵌套
+  - 跨容器 hover / tooltip
+  - overlay 补画与 coverage 链
+  - `TabControl`
+  - `Table`
+  - 页码与分页按钮
+- 当前预期:
+  - 三层 `Canvas` 嵌套下，深层按钮 hover / press / release / tooltip 都能正确刷新。
+  - `Window / Canvas / TabControl` 的 overlay 补画与 coverage 链闭合，不再出现遮挡错层。
+  - `TabControl` 页签按钮与页面层级正确；页签 tooltip 不会再被页面盖掉。
+  - `Table` 分页按钮、页码标签、与上层浮层相交时的重绘链保持正确。
+- 阶段定位:
+  - 当前主回归集之一。
+  - 第二阶段及重绘主线的核心专项入口。
+
+## 当前建议
+
+- 当前阶段建议主回归集:
+  - `KEY1 + KEY2 + KEY5`
+- 当前补充专项:
+  - `KEY4`
+- 暂不纳入每轮主集:
+  - `KEY3`
diff --git a/开发记录/功能变更/Feature-20260509-0011-布局API使用说明与旧接口覆盖规则.md b/开发记录/功能变更/Feature-20260509-0011-布局API使用说明与旧接口覆盖规则.md
new file mode 100644
index 0000000..14f9930
--- /dev/null
+++ b/开发记录/功能变更/Feature-20260509-0011-布局API使用说明与旧接口覆盖规则.md
@@ -0,0 +1,295 @@
+# 功能变更 ID: Feature-20260509-0011
+
+> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
+> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。
+
+## 基本信息
+
+- ID: Feature-20260509-0011
+- 标题: 布局 API 使用说明与旧接口覆盖规则
+- 状态：已验证
+- 类型：新增
+- 级别：L2 中等
+- 模块: Layout API / Control
+- 版本 / 分支: 当前工作区
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 变更背景
+
+- 背景:
+  - 当前布局系统内部已经以 `LayoutSpec` 为统一解算依据。
+  - 旧接口 `setLayoutMode(...)` / `setAnchor(...)` 仍然保留，但只能表达有限的双锚点语义。
+  - 新增公开布局 API 后，需要明确用户应如何设置轴向锚点、尺寸策略和固定尺寸位移策略。
+- 目标:
+  - 说明新布局 API 的职责和使用方式。
+  - 明确新旧接口混用时的覆盖规则。
+  - 给出常见布局组合和 `KEY2` 迁移场景中的推荐写法。
+- 不做什么：[可选]
+  - 不开放 `LayoutCapability` 的普通外部写入接口。
+  - 不修改 `Table` 当前版本 `Y Fixed` 的能力边界。
+  - 不处理 Tooltip 智能选位、`Table` 内部局部重绘、`Dialog` synthetic move 统一等后置项。
+
+## 变更内容
+
+- 变更摘要:
+  - 增加布局 API 使用说明文档。
+  - 明确新接口与旧接口的覆盖关系。
+  - 汇总常见布局模式的代码写法。
+- 新增项：[可选]
+  - 新公开接口说明
+  - 旧接口映射说明
+  - 混用覆盖规则
+  - 常见写法示例
+  - 调试态日志说明
+- 修改项：[可选]
+  - 无运行时代码修改，本文件只记录使用说明。
+- 删除 / 废弃项：[可选]
+  - 无
+- 受影响的文件 / 类 / 函数:
+  - [`Control.h`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)
+  - [`Control.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Control.cpp)
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 对外 API / 属性变化：[可选]
+  - `setHorizontalLayoutSpec(...)`
+  - `setVerticalLayoutSpec(...)`
+  - `setHorizontalAnchors(...)`
+  - `setVerticalAnchors(...)`
+  - `setHorizontalSizePolicy(...)`
+  - `setVerticalSizePolicy(...)`
+  - `setHorizontalAlignPolicy(...)`
+  - `setVerticalAlignPolicy(...)`
+  - `getHorizontalLayoutSpec()`
+  - `getVerticalLayoutSpec()`
+
+## 行为对照
+
+- 变更前:
+  - 用户主要通过 `setLayoutMode(...)` 与 `setAnchor(...)` 设置布局。
+  - 固定尺寸 + 居中、固定尺寸 + 比例位移等组合无法通过旧接口清晰表达。
+  - 旧双锚点在某些测试场景中会被迫承担 Stretch 语义，导致固定按钮和内容驱动标签在 resize 后错位。
+- 变更后:
+  - 用户可按水平轴 / 垂直轴分别设置锚点集合、尺寸策略和固定尺寸位移策略。
+  - 旧接口仍可用，但只作为兼容输入层。
+  - 新旧接口混用时，最后调用的接口覆盖对应轴的布局规格。
+- 兼容性说明：兼容
+- 迁移说明：[可选]
+  - 新代码建议优先使用新布局 API。
+  - 旧代码可以继续使用 `setAnchor(...)`，但复杂布局应逐步迁移到新接口。
+
+## 验证与落地
+
+- 验证方式:
+  - 编译 `Control.cpp`
+  - 编译 `z-testDome.cpp /DKEY=2`
+  - 编译 `z-testDome.cpp /DKEY=5`
+  - 手测 `KEY1 / KEY2 / KEY5`
+- 验证结果:
+  - 编译级验证通过。
+  - 用户手测当前暂未发现问题。
+- 关联 BUG / Fix：[可选]
+  - [Feature-20260416-0009-KEY2-使用新布局API重构与联动刷新.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/功能变更/Feature-20260416-0009-KEY2-使用新布局API重构与联动刷新.md)
+  - [Feature-20260418-0010-当前阶段测试用例矩阵与定位.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/功能变更/Feature-20260418-0010-当前阶段测试用例矩阵与定位.md)
+- Commit:
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：[可选]
+  - resize 收口阶段若开启高频 console 日志，可能出现一帧视觉延迟；当前按调试态 I/O 现象记录，不作为 bug 处理。
+
+## API 总览
+
+### 完整轴向规格接口
+
+```cpp
+void setHorizontalLayoutSpec(const StellarX::AxisLayoutSpec& spec);
+void setVerticalLayoutSpec(const StellarX::AxisLayoutSpec& spec);
+```
+
+- 直接覆盖对应轴的完整布局规格。
+- 调用后自动切换到 `StellarX::LayoutMode::AnchorToEdges`。
+- 适合调用方已经准备好完整 `AxisLayoutSpec` 的场景。
+
+### 锚点集合接口
+
+```cpp
+void setHorizontalAnchors(bool left, bool right);
+void setVerticalAnchors(bool top, bool bottom);
+```
+
+- 水平轴对应 `left / right`。
+- 垂直轴对应 `top / bottom`。
+- 只修改对应轴的锚点集合，不主动改变尺寸策略或位移策略。
+
+### 尺寸策略接口
+
+```cpp
+void setHorizontalSizePolicy(StellarX::AxisSizePolicy policy);
+void setVerticalSizePolicy(StellarX::AxisSizePolicy policy);
+```
+
+- `Stretch`：允许该轴尺寸随父容器变化。
+- `FixedSize`：该轴尺寸保持设计态尺寸。
+- 控件能力边界仍然生效。例如 `Table` 当前版本不允许 `Y Stretch`，即使用户设置垂直 `Stretch`，也会被能力边界降级。
+
+### 固定尺寸位移策略接口
+
+```cpp
+void setHorizontalAlignPolicy(StellarX::AxisAlignPolicy policy);
+void setVerticalAlignPolicy(StellarX::AxisAlignPolicy policy);
+```
+
+- 只在 `FixedSize` 语义下决定位置。
+- 不负责改变尺寸。
+- 常用值：
+  - `Start`：保持起边关系，例如左固定、上固定。
+  - `End`：保持终边关系，例如右固定、下固定。
+  - `Center`：保持居中关系。
+  - `Proportional`：保持设计态相对位置比例，适合固定尺寸控件在可变宽容器中按比例移动。
+
+### 读取接口
+
+```cpp
+StellarX::AxisLayoutSpec getHorizontalLayoutSpec() const;
+StellarX::AxisLayoutSpec getVerticalLayoutSpec() const;
+```
+
+- 返回当前生效的新模型轴向规格。
+- 不保证能完整逆映射回旧 `anchor_1 / anchor_2` 语义。
+
+## 新旧接口覆盖规则
+
+### 旧接口仍然保留
+
+```cpp
+void setLayoutMode(StellarX::LayoutMode layoutMode);
+void setAnchor(StellarX::Anchor anchor1, StellarX::Anchor anchor2);
+```
+
+- 旧接口是兼容入口。
+- `setAnchor(...)` 内部会把旧双锚点映射到新的 `layoutSpec.horizontal` 与 `layoutSpec.vertical`。
+- 旧接口无法表达所有新模型状态，例如固定尺寸 + 比例位移、固定尺寸 + 居中等。
+
+### 后调用者生效
+
+规则：
+
+- 先调用 `setAnchor(...)`，再调用新 API，则新 API 覆盖对应轴规格。
+- 先调用新 API，再调用 `setAnchor(...)`，则旧接口重新覆盖水平轴和垂直轴规格。
+- 新 API 只覆盖自己负责的轴或字段。例如 `setHorizontalSizePolicy(...)` 只修改水平轴尺寸策略，不修改垂直轴。
+
+示例：
+
+```cpp
+button->setLayoutMode(StellarX::LayoutMode::AnchorToEdges);
+button->setAnchor(StellarX::Anchor::Left, StellarX::Anchor::Right);
+
+// 覆盖水平轴：改为固定尺寸 + 居中，不再沿用旧接口映射出的 Stretch。
+button->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+button->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Center);
+```
+
+### 新 API 自动切换布局模式
+
+所有新布局 setter 都会自动将 `layoutMode` 切换为 `AnchorToEdges`。
+因此新代码通常不需要再额外写：
+
+```cpp
+control->setLayoutMode(StellarX::LayoutMode::AnchorToEdges);
+```
+
+## 常见布局写法
+
+### 左固定
+
+```cpp
+control->setHorizontalAnchors(true, false);
+control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+```
+
+### 右固定
+
+```cpp
+control->setHorizontalAnchors(false, true);
+control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::End);
+```
+
+### 水平拉伸
+
+```cpp
+control->setHorizontalAnchors(true, true);
+control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::Stretch);
+control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Start);
+```
+
+### 固定尺寸居中
+
+```cpp
+control->setHorizontalAnchors(true, true);
+control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Center);
+```
+
+### 固定尺寸比例位移
+
+```cpp
+control->setHorizontalAnchors(true, true);
+control->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+control->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Proportional);
+```
+
+适用场景：
+
+- 一组固定尺寸按钮需要随着父容器变宽按比例展开。
+- `KEY2` 中每个 bit 单元就是该策略的典型使用方式。
+
+## KEY2 迁移要点
+
+`KEY2` 原问题不是单纯参数错误，而是布局单元拆分不合理：
+
+- 位号 `Label` 是内容驱动尺寸。
+- 位按钮是固定尺寸。
+- 二者分别使用比例位移时，因为自身尺寸不同，resize 后会出现错位。
+
+当前迁移方式：
+
+- 每一位创建一个小 `Canvas` 单元。
+- 单元内部固定放置位号 `Label` 与位按钮。
+- 单元自身使用 `FixedSize + Proportional`。
+- 这样移动的是整个 bit 单元，而不是标签和按钮分别移动。
+
+示意写法：
+
+```cpp
+auto cell = std::make_unique<Canvas>(cellX, 0, 32, 50);
+cell->setHorizontalAnchors(true, true);
+cell->setHorizontalSizePolicy(StellarX::AxisSizePolicy::FixedSize);
+cell->setHorizontalAlignPolicy(StellarX::AxisAlignPolicy::Proportional);
+```
+
+## 能力边界说明
+
+布局 API 表达的是“调用方希望如何布局”，但控件能力边界仍然优先。
+
+当前关键边界：
+
+- `Canvas`：`X / Y` 均允许 Stretch。
+- `TabControl`：外层允许 Stretch，内部页签栏 / 页面区仍由自身管理。
+- `Table`：当前版本 `X Stretch / Y Fixed`，这是当前实现边界，不是永久产品结论。
+- `TextBox`：默认更适合 `X Stretch / Y FixedSize`。
+- `Label`：默认固定或内容驱动刷新运行态尺寸，不建议做双轴 Stretch。
+- `Dialog`：只居中，不参与父级拉伸。
+
+如果用户设置的策略超出控件能力边界，统一解算层会按现有降级规则处理，并保留必要日志。
+
+## 调试态说明
+
+resize / 最大化 / 还原过程中，如果开启大量 console 日志，可能出现一帧视觉延迟或短暂残影。
+当前判断原因是日志系统同步写控制台且默认逐行 flush，导致主线程 resize 收口绘制被 I/O 拖慢。
+
+处理建议：
+
+- 常规手测可关闭 console 日志。
+- 需要日志时可优先输出到文件。
+- 当前不作为布局或重绘 bug 处理，后续可在官网/API 文档中作为调试说明记录。
diff --git a/开发记录/模块/Module-20260410-0002-锚点与布局系统第一阶段重构.md b/开发记录/模块/Module-20260410-0002-锚点与布局系统第一阶段重构.md
new file mode 100644
index 0000000..6457878
--- /dev/null
+++ b/开发记录/模块/Module-20260410-0002-锚点与布局系统第一阶段重构.md
@@ -0,0 +1,161 @@
+# 新增功能模块 / 模块重构
+
+> 适用场景：新增模块、重大模块重构、核心架构能力演进。
+> 不适用场景：小接口或轻量功能变更，请使用“功能变更”模板。
+
+## 基本信息
+
+- 模块 ID：`Module-20260410-0002`
+- 模块名称: 锚点与布局系统第一阶段重构
+- 状态：已验证
+- 类型：模块重构
+- 所属系统 / 子系统: GUI 框架 / Layout
+- 版本 / 分支: 当前工作区 / 下一版本开发中
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 背景与目标
+
+- 背景:
+  - 原有锚点系统仍依赖 `anchor_1 / anchor_2`
+  - `Window::adaptiveLayout()` 与 `Canvas::onWindowResize()` 长期并存两套布局语义
+  - `Canvas` 布局层存在 `Table` 外部特判
+  - `TabControl` 外层布局与内部布局耦合较深
+- 当前痛点:
+  - 双锚点表达能力不足，难以覆盖更完整的边集合语义
+  - 顶层窗口与容器子控件的解算规则不统一，维护成本高
+  - 特殊控件能力边界没有收回自身语义层
+  - 缺少针对布局系统的专项回归用例
+- 目标:
+  - 建立统一的布局数据模型与统一解算入口
+  - 正式区分设计态矩形与运行态矩形
+  - 保留旧 API 的兼容输入能力
+  - 将 `Table` 的当前能力边界收回控件自身
+  - 增加布局专项回归用例 `KEY == 5`
+- 非目标:
+  - 不做字体随控件缩放
+  - 不做 `Table` 纵向拉伸
+  - 不重构重绘系统
+
+## 模块边界
+
+- 职责:
+  - 提供统一的布局规格描述
+  - 统一顶层窗口与容器子控件的几何解算
+  - 在保持旧 API 可用的前提下，将内部布局实现迁移到新模型
+  - 通过控件能力边界约束非法或暂不支持的拉伸组合
+- 不负责什么:
+  - 字体缩放与内容排版自适应
+  - `Dialog` 内部布局语义重构
+  - `Table` 纵向拉伸能力
+- 外部依赖:
+  - EasyX 绘制环境
+  - 现有 `Control / Window / Canvas / TabControl / Table` 控件体系
+- 对外能力 / API:
+  - 继续保留 `setLayoutMode(...)`
+  - 继续保留 `setAnchor(a1, a2)`
+  - 当前阶段新增能力主要用于内部统一实现，不额外新增用户层 API
+- 关键数据 / 状态:
+  - `localx / localy / localWidth / localHeight`
+  - `x / y / width / height`
+  - `LayoutSpec`
+  - `LayoutCapability`
+  - `ResolvedLayoutRect`
+
+## 设计说明
+
+- 核心流程:
+  - 先在父局部坐标系内按水平轴 / 垂直轴独立解算
+  - 再将局部矩形映射为世界坐标矩形
+  - 由控件内部受控路径应用运行态矩形
+- 关键对象 / 类关系:
+  - [`Control`](D:/programming/imGUI-easyX/imGui-easyX/Control.h) 作为统一布局规格与基础解算入口
+  - [`Window`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp) 负责顶层控件统一收口
+  - [`Canvas`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp) 负责容器子控件重映射
+  - [`TabControl`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp) 外层接入统一解算，内部页签栏 / 页面区仍自管
+  - [`Table`](D:/programming/imGUI-easyX/imGui-easyX/Table.cpp) 通过 `LayoutCapability` 显式禁止 `Y` 轴 Stretch
+- 生命周期:
+  - 设计态矩形 `local*` 在普通 resize / 重排过程中不自动回写
+  - 运行态矩形由统一解算器产出，再通过内部路径应用
+  - 若确需同步设计基线，只能显式调用 `commitCurrentGeometryAsDesignRect()`
+- 事件 / 渲染 / 数据流:
+  - 事件阶段只改状态，不直接扩散成多套布局公式
+  - `Window` 与 `Canvas` 共用 `resolveLayoutRect()`
+  - `onWindowResize()` 收口为“快照失效 + 标脏 + 必要传播”，不再承担布局求解
+- 关键不变量:
+  - `local*` 始终表示设计态父局部矩形
+  - `x / y / width / height` 始终表示运行态绘制矩形
+  - 旧 API 只作兼容输入层，不再作为内部解算依据
+  - `Table` 当前阶段只允许 `X` 轴 Stretch
+- 降级 / 回退策略:
+  - 对不满足能力边界的拉伸请求，自然降级为固定尺寸位移
+  - 旧接口输入通过映射层退回到新模型的有限子集
+
+## 实现与影响
+
+- 关键实现点:
+  - 引入 `AxisSizePolicy / AxisAlignPolicy / AxisLayoutSpec / LayoutSpec / LayoutCapability / ResolvedLayoutRect`
+  - 在 `Control` 中增加统一解算与内部受控应用路径
+  - 将 `Window::adaptiveLayout()` 改为统一解算入口
+  - 将 `Canvas` 子控件布局从旧比例缩放逻辑切换为统一解算
+  - 将 `TabControl` 外层接入统一解算，同时保留内部页签系统专用布局
+  - 将 `Table` 的 `Y` 轴固定能力边界收回控件自身
+  - 在 `z-testDome.cpp` 增加 `KEY == 5` 布局专项回归
+- 涉及文件 / 类 / 函数:
+  - [`CoreTypes.h`](D:/programming/imGUI-easyX/imGui-easyX/CoreTypes.h)
+  - [`Control.h`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)
+  - [`Control.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Control.cpp)
+  - [`Canvas.h`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.h)
+  - [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)
+  - [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)
+  - [`TabControl.h`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.h)
+  - [`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)
+  - [`Table.h`](D:/programming/imGUI-easyX/imGui-easyX/Table.h)
+  - [`Table.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Table.cpp)
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 兼容性影响:
+  - 向后兼容旧锚点 API
+  - 当前阶段未删除旧 getter / setter
+- 性能影响:
+  - 无明显新增性能负担
+  - 主要是布局求解路径从多处分散逻辑收口为统一函数
+- 风险点:
+  - 若某些控件运行态尺寸变化后未明确同步设计基线，后续 resize 仍可能出现“回到旧设计态”的现象
+  - `TabControl` 的外层统一解算与内部专用布局之间存在边界风险
+  - `Table` 纵向仍为固定尺寸，后续若扩展能力需单独立项
+
+## 测试与验证
+
+- 测试范围:
+  - 顶层窗口 resize
+  - `Canvas` 嵌套布局
+  - `TabControl` 外层布局接入
+  - `Table` 横向拉伸与纵向固定
+  - `KEY == 5` 布局专项回归
+- 验证步骤:
+
+1. 编译 `Control.cpp / Canvas.cpp / Table.cpp / TabControl.cpp / Window.cpp`
+2. 编译 `z-testDome.cpp /DKEY=2`
+3. 编译 `z-testDome.cpp /DKEY=5`
+
+- 验证结果:
+  - 源码级编译验证通过
+  - `KEY == 5` 已补齐布局专项回归用例
+  - GUI 交互仍需用户本机手动确认
+- 已知限制 / 遗留问题:
+  - 本轮不包含字体缩放
+  - 本轮不包含 `Table` 纵向拉伸
+  - Tooltip 问题已另外拆分为独立 `BUG / Fix`
+
+## 落地信息
+
+- 关联功能变更 ID：[可选]
+- 关联 BUG / Fix:
+  - `BUG-20260410-0004`
+  - `Fix-BUG-20260410-0004`
+- Commit: 当前工作区未提交
+- PR：[可选]
+- 发布版本：[可选]
+- 相关文档:
+  - [`BUG-20260410-0004-按钮Tooltip移出后不消失.md`](D:/programming/imGUI-easyX/imGui-easyX/开发记录/BUG/BUG-20260410-0004-按钮Tooltip移出后不消失.md)
+  - [`Fix-BUG-20260410-0004-按钮Tooltip移出后不消失.md`](D:/programming/imGUI-easyX/imGui-easyX/开发记录/Fix/Fix-BUG-20260410-0004-按钮Tooltip移出后不消失.md)
diff --git a/开发记录/模块/Module-20260415-0003-布局系统第二阶段收口.md b/开发记录/模块/Module-20260415-0003-布局系统第二阶段收口.md
new file mode 100644
index 0000000..a121661
--- /dev/null
+++ b/开发记录/模块/Module-20260415-0003-布局系统第二阶段收口.md
@@ -0,0 +1,157 @@
+# 新增功能模块 / 模块重构
+
+> 适用场景：新增模块、重大模块重构、核心架构能力演进。
+> 不适用场景：小接口或轻量功能变更，请使用“功能变更”模板。
+
+## 基本信息
+
+- 模块 ID：Module-20260415-0003
+- 模块名称: 布局系统第二阶段收口
+- 状态：已完成
+- 类型：模块重构
+- 所属系统 / 子系统: GUI 框架 / Layout
+- 版本 / 分支: 当前工作区 / 下一版本开发中
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 背景与目标
+
+- 背景:
+  - 第一阶段已经完成统一布局链路打通，但几何写入口、内容驱动控件规则、复合控件职责边界仍有残留混用。
+  - `Label` 曾在 `draw()` 阶段临时决定尺寸，`TabControl` 和 `Canvas` 在子树几何映射上也存在职责重叠。
+  - `WM_MOUSEMOVE` 的容器分发和局部重绘合成，在复杂遮挡场景下容易暴露 hover/tooltip 与 overlay 残留问题。
+- 当前痛点:
+  - 几何语义还不够制度化，后续继续演进布局系统时容易再次混回“draw 阶段改几何”。
+  - 内容驱动控件和复合控件没有完全落成可解释的边界。
+  - 局部重绘与上层兄弟补画机制不完整时，会直接破坏遮挡正确性。
+- 目标:
+  - 收口几何写入口语义，明确公开 setter、统一布局应用路径、内容驱动路径、显式设计基线提交。
+  - 收口 `Label / Table` 的内容驱动规则与设计基线边界。
+  - 收口 `TabControl / Canvas` 的职责边界，不重写页签系统，但消除页内子控件手工回填。
+  - 建立轻量级鼠标瞬时状态清理路径和 overlay 补画机制，保证 hover / tooltip / 局部重绘链正确。
+- 非目标：[可选]
+  - 不做字体缩放。
+  - 不做 `Table` 纵向拉伸。
+  - 不做 `Dialog` 旧 synthetic move 机制统一。
+  - 不做 `Table` 内部局部重绘体系。
+
+## 模块边界
+
+- 职责:
+  - 定义并收口布局系统第二阶段的运行态 / 设计态几何语义。
+  - 为当前主线控件显式写出能力边界和默认策略。
+  - 收口局部重绘下的 overlay 补画规则。
+- 不负责什么:
+  - 不扩展新的布局表达能力。
+  - 不处理字体、图标、DPI 自适应。
+  - 不把所有控件都改造成内容驱动或局部重绘型复合控件。
+- 外部依赖:
+  - EasyX 绘制环境
+  - 现有 `Control / Window / Canvas / TabControl / Table / Label / Button` 体系
+- 对外能力 / API:
+  - 保留 `setLayoutMode(...)`
+  - 保留 `setAnchor(a1, a2)`
+  - 保留 `commitCurrentGeometryAsDesignRect()`
+  - `Label::textStyle` 继续保持公开，但要求样式修改后显式 `setDirty(true)`
+- 关键数据 / 状态:
+  - `localx / localy / localWidth / localHeight`
+  - `x / y / width / height`
+  - `LayoutSpec / LayoutCapability / ResolvedLayoutRect`
+  - `eventVisualChanged`
+
+## 设计说明
+
+- 核心流程:
+  - 先在父局部坐标系内完成统一布局解算。
+  - 再由内部受控路径把运行态矩形应用到控件。
+  - 内容驱动控件在自己的受控路径里刷新运行态尺寸。
+  - 局部重绘提交后，由父容器按实际绘制顺序补画 coverage 上方的 overlay 兄弟。
+- 关键对象 / 类关系:
+  - [`Control`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)：几何语义、解算入口、设计基线提交入口。
+  - [`Label`](D:/programming/imGUI-easyX/imGui-easyX/Label.cpp)：内容驱动尺寸，`draw()` 只消费运行态矩形。
+  - [`Canvas`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)：管理直接子控件的世界坐标映射与局部 overlay 补画。
+  - [`TabControl`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)：外层接统一解算，内部页签栏 / 页面区继续自管。
+  - [`Table`](D:/programming/imGUI-easyX/imGui-easyX/Table.cpp)：当前版本 `X Stretch / Y Fixed`，并保留内部受控结构尺寸基线刷新。
+  - [`Window`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)：顶层托管重绘收口与 overlay 兄弟补画。
+- 生命周期:
+  - 普通 resize / 父容器重排不自动回写 `local*`。
+  - 显式设计基线提交只通过 `commitCurrentGeometryAsDesignRect()` 或控件内部受控结构刷新点发生。
+  - 内容驱动尺寸刷新优先发生在 `draw()` 之前。
+- 事件 / 渲染 / 数据流：[按模块类型填写]
+  - `WM_MOUSEMOVE`：第一个命中的兄弟收到真实消息，后续兄弟只清理瞬时鼠标状态。
+  - 局部重绘：先画本次 dirty 单元，再补画 coverage 上方相交 overlay。
+  - 运行态几何：统一解算或内容驱动路径写入；设计基线不自动漂移。
+- 关键不变量:
+  - `local*` 始终表示设计态父局部矩形。
+  - `x / y / width / height` 始终表示运行态绘制矩形。
+  - `draw()` 不再承担新的几何决策入口。
+  - `Table` 当前版本 `Y Fixed` 是实现边界，不是永久产品结论。
+- 降级 / 回退策略：[可选]
+  - Stretch 条件不满足时自然降级为固定尺寸位置策略。
+  - 控件能力边界禁止 Stretch 时，通过日志输出拦截原因。
+
+## 实现与影响
+
+- 关键实现点:
+  - 在 [`Control.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Control.cpp) 增加布局降级日志、能力边界拦截日志、显式设计基线提交日志。
+  - 在 [`Label.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Label.cpp) 收口内容驱动尺寸刷新，并显式关闭双轴 Stretch。
+  - 在 [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)、[`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)、[`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp) 收口 overlay 补画。
+  - 在 [`Table.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Table.cpp) 收口 `Y Fixed`、分页按钮视觉链与页码重绘。
+- 涉及文件 / 类 / 函数:
+  - [`Control.h`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)
+  - [`Control.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Control.cpp)
+  - [`Label.h`](D:/programming/imGUI-easyX/imGui-easyX/Label.h)
+  - [`Label.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Label.cpp)
+  - [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)
+  - [`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)
+  - [`Table.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Table.cpp)
+  - [`TextBox.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TextBox.cpp)
+  - [`Dialog.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Dialog.cpp)
+  - [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)
+- 兼容性影响:
+  - 对旧锚点 API 保持兼容。
+  - `Label::textStyle` 仍为公开字段，但使用约定更严格。
+- 性能影响:
+  - `WM_MOUSEMOVE` 和 overlay 补画路径增加了必要的状态清理与补画，但避免了整窗级重绘。
+  - `Table` 分页按钮视觉变化当前仍提升为整表重绘，颗粒度偏粗，但正确性优先。
+- 风险点:
+  - `Dialog` 旧 synthetic move 机制仍与新清理模型并存。
+  - `Table` 内部局部重绘体系尚未建立，分页区仍偏重。
+
+## 测试与验证
+
+- 测试范围:
+  - 顶层 resize
+  - 三层 `Canvas` 嵌套
+  - `TabControl` 外层 resize 与页内稳定性
+  - overlay 补画
+  - `Table` 横向拉伸、分页按钮、页码重绘
+  - `Label` 文本 / 字体样式变化
+- 验证步骤:
+
+1. 编译 `Control.cpp / Label.cpp / Canvas.cpp / TabControl.cpp / Table.cpp / TextBox.cpp / Dialog.cpp`
+2. 编译 `z-testDome.cpp /DKEY=5`
+3. 手动回归 `KEY5` 的 hover、tooltip、overlay、分页与页码场景
+
+- 验证结果:
+  - 编译级验证通过。
+  - 手动 GUI 回归依赖本机继续执行。
+- 已知限制 / 遗留问题：[可选]
+  - `Dialog` 旧 synthetic move 机制暂未统一。
+  - `Table` 尚未引入内部局部重绘模型。
+  - 全项目所有控件的能力边界总审计未做。
+
+## 落地信息
+
+- 关联功能变更 ID：[可选]
+  - `Feature-20260415-0008`
+- 关联 BUG / Fix：[可选]
+  - `BUG-20260415-0005`
+  - `Fix-BUG-20260415-0005`
+- Commit: 未提交（当前工作区）
+- PR：[可选]
+- 发布版本：[可选]
+- 相关文档：[可选]
+  - [Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/功能变更/Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md)
+  - [BUG-20260415-0005-局部重绘未补画上层兄弟导致遮挡错误.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/BUG/BUG-20260415-0005-局部重绘未补画上层兄弟导致遮挡错误.md)
+  - [Fix-BUG-20260415-0005-局部重绘补画上层兄弟修复.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/Fix/Fix-BUG-20260415-0005-局部重绘补画上层兄弟修复.md)
diff --git a/开发记录/模块/Module-20260415-0004-布局系统第二阶段验收与封口.md b/开发记录/模块/Module-20260415-0004-布局系统第二阶段验收与封口.md
new file mode 100644
index 0000000..40d8038
--- /dev/null
+++ b/开发记录/模块/Module-20260415-0004-布局系统第二阶段验收与封口.md
@@ -0,0 +1,177 @@
+# 新增功能模块 / 模块重构
+
+> 适用场景：新增模块、重大模块重构、核心架构能力演进。
+> 不适用场景：小接口或轻量功能变更，请使用“功能变更”模板。
+
+## 基本信息
+
+- 模块 ID：Module-20260415-0004
+- 模块名称: 布局系统第二阶段验收与封口
+- 状态：已验证
+- 类型：模块重构
+- 所属系统 / 子系统: GUI 框架 / Layout
+- 版本 / 分支: 当前工作区 / 下一版本开发中
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 背景与目标
+
+- 背景:
+  - 第一阶段已完成统一锚点模型和统一解算入口。
+  - 第二阶段继续围绕“几何所有权收口 + 内容驱动规则收口”推进，实现几何写入口分层、内容驱动控件规则收口、局部重绘与 overlay 补画链修复。
+  - 在 `KEY1 / KEY5` 回归过程中，又暴露出脏子树提交、coverage 低估、TabControl 层级顺序等一组重绘链问题，需要一并收口后才能视为阶段稳定。
+- 当前痛点:
+  - 缺少一份明确的阶段验收记录，难以区分“本阶段完成项”和“明确延期项”。
+  - 当前主线 bug 虽已基于测试用例修复，但如果不做封口记录，后续继续推进下一主题时容易重复回头整理。
+- 目标:
+  - 明确第二阶段已经完成的主线改造和已验证的 bug 修复。
+  - 明确当前接受的边界与明确延期的技术债。
+  - 为后续“公开布局 API + 旧 demo 迁移”提供稳定起点。
+- 非目标：[可选]
+  - 本记录不新增运行时代码逻辑。
+  - 本记录不覆盖未来的 Tooltip 智能选位、`Table` 纵向拉伸、`Dialog` synthetic move 统一改造。
+
+## 模块边界
+
+- 职责:
+  - 汇总布局系统第二阶段的最终语义收口结果。
+  - 记录本阶段已完成的运行态 / 设计态几何规则、局部重绘提交规则与 overlay 补画规则。
+  - 明确已知延期项与后续主题边界。
+- 不负责什么:
+  - 不扩展新的布局表达能力。
+  - 不重写 `Dialog` 旧 synthetic move 机制。
+  - 不实现 `Table` 内部局部重绘体系。
+- 外部依赖:
+  - `Control / Window / Canvas / TabControl / Table / Label / Button`
+  - EasyX 绘制与消息循环环境
+- 对外能力 / API:
+  - 保持旧 API：`setLayoutMode(...)`、`setAnchor(...)`
+  - 保持显式设计基线提交入口：`commitCurrentGeometryAsDesignRect()`
+  - 保持 `Label::textStyle` 公开，但要求样式修改后手动 `setDirty(true)`
+- 关键数据 / 状态:
+  - `localx / localy / localWidth / localHeight`
+  - `x / y / width / height`
+  - `LayoutSpec / LayoutCapability / ResolvedLayoutRect`
+  - `eventVisualChanged / dirty / coverage / overlay`
+
+## 设计说明
+
+- 核心流程:
+  - 几何变化先在父局部坐标系内统一解算，再通过内部受控路径应用到运行态矩形。
+  - 内容驱动控件在自身受控路径中刷新运行态尺寸；设计基线不得在普通布局过程中自动漂移。
+  - 托管局部重绘按“脏子树提交 -> 直接分支 coverage -> 传递式 overlay 补画”收口，确保嵌套容器、Tooltip、上层兄弟遮挡链闭合。
+- 关键对象 / 类关系:
+  - [`Control.h`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)：统一布局解算、设计基线提交、托管重绘底座
+  - [`Label.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Label.cpp)：内容驱动尺寸刷新前移，`draw()` 只消费运行态矩形
+  - [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)：直接子树映射、脏子树提交、局部 overlay 补画
+  - [`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)：外层统一布局，内部页签栏/页面区自管，绘制顺序与局部提交顺序统一
+  - [`Table.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Table.cpp)：当前版本 `X Stretch / Y Fixed`、分页按钮视觉与页码重绘修复
+  - [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)：顶层托管重绘、传递式 overlay 补画、顶层 coverage 收口
+- 生命周期:
+  - 普通 resize / 重排不自动回写 `local*`
+  - 公开 setter 只写运行态，不隐式提交设计基线
+  - 显式设计基线提交只通过 `commitCurrentGeometryAsDesignRect()` 或控件内部受控结构刷新触发
+- 事件 / 渲染 / 数据流：[按模块类型填写]
+  - `WM_MOUSEMOVE`：真实命中分支处理事件，后续兄弟仅清理鼠标瞬时状态
+  - 托管局部重绘：先提交 dirty root / dirty branch，再按 coverage 传递式补画 overlay
+  - Tooltip / 扩展绘制 coverage：通过 `getManagedRepaintCoverageRect()` 纳入托管 coverage 计算
+- 关键不变量:
+  - `local*` 只表示设计态父局部矩形
+  - `x / y / width / height` 只表示运行态绘制矩形
+  - `draw()` 不再承担新的几何决策入口
+  - `Table` 当前版本 `Y Fixed` 是实现边界，不是永久产品结论
+- 降级 / 回退策略：[可选]
+  - Stretch 不满足条件时降级为固定尺寸位移策略，并输出最小必要日志
+  - 控件能力边界拦截 Stretch 请求时，通过日志说明被拦截的轴和原因
+
+## 实现与影响
+
+- 关键实现点:
+  - 收口公开 setter、统一布局应用路径、内容驱动路径、显式设计基线提交四类几何写入口
+  - 修复 `WM_MOUSEMOVE` 短路后 hover / tooltip 无法及时清理的问题
+  - 修复局部重绘只认直接 dirty child、不认 dirty descendant 的链路缺口
+  - 修复 coverage 低估导致 Tooltip / overlay 漏补画的问题
+  - 修复 Tab 页签按钮与页面绘制顺序不一致导致 Tooltip 被页面覆盖的问题
+  - 修复重复激活已激活页签时的残影 / 快照链扰动问题
+- 涉及文件 / 类 / 函数:
+  - [`Control.h`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)
+  - [`Control.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Control.cpp)
+  - [`Label.h`](D:/programming/imGUI-easyX/imGui-easyX/Label.h)
+  - [`Label.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Label.cpp)
+  - [`Button.h`](D:/programming/imGUI-easyX/imGui-easyX/Button.h)
+  - [`Button.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Button.cpp)
+  - [`Canvas.h`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.h)
+  - [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)
+  - [`TabControl.h`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.h)
+  - [`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)
+  - [`Table.h`](D:/programming/imGUI-easyX/imGui-easyX/Table.h)
+  - [`Table.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Table.cpp)
+  - [`TextBox.h`](D:/programming/imGUI-easyX/imGui-easyX/TextBox.h)
+  - [`TextBox.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TextBox.cpp)
+  - [`Dialog.h`](D:/programming/imGUI-easyX/imGui-easyX/Dialog.h)
+  - [`Dialog.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Dialog.cpp)
+  - [`Window.h`](D:/programming/imGUI-easyX/imGui-easyX/Window.h)
+  - [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)
+  - [`MessageBox.h`](D:/programming/imGUI-easyX/imGui-easyX/MessageBox.h)
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 兼容性影响:
+  - 旧锚点 API 仍可用，内部实现已完全转到新布局模型
+  - `Label::textStyle` 仍为公开字段，但要求样式修改后显式 `setDirty(true)`
+  - `TabControl::setActiveIndex()` 和 `Button::setButtonClick()` 对重复同状态调用新增短路，不再重复触发链路
+- 性能影响:
+  - 局部重绘 coverage 和 overlay 补画会更保守，补画次数可能略增
+  - 相比整窗 / 整容器强制重绘，这仍是更合理的正确性与性能折中
+  - `Table` 分页按钮视觉变化当前仍提升为整张 `Table` 重绘，颗粒度偏粗但正确性优先
+- 风险点:
+  - `Dialog` 旧 synthetic move 机制仍与新清理模型并存
+  - `Table` 尚未拥有自己的内部局部重绘体系
+  - 公开 `AxisSizePolicy / AxisAlignPolicy` API 仍未开放，旧 demo 仍受旧入口表达能力限制
+
+## 测试与验证
+
+- 测试范围:
+  - `KEY1`：页签重复激活、表格超出页范围残影回归
+  - `KEY5`：三层 `Canvas` 嵌套、跨容器 hover / tooltip、overlay 补画、`TabControl`、`Table`、页码与分页按钮
+  - 核心源码编译级验证：布局主线、重绘主线、Tab / Table / Label / TextBox / Dialog 主线
+- 验证步骤:
+
+1. 编译 `Control.cpp / Button.cpp / Label.cpp / Canvas.cpp / TabControl.cpp / Table.cpp / TextBox.cpp / Dialog.cpp / Window.cpp`
+2. 编译 `z-testDome.cpp /DKEY=1`
+3. 编译 `z-testDome.cpp /DKEY=5`
+4. 手动回归 `KEY1 / KEY5` 中的 tooltip、overlay、页签、分页、三层嵌套和跨容器按钮场景
+
+- 验证结果:
+  - 编译级验证通过
+  - 基于当前 `KEY1 / KEY5` 用例回归，已知 bug 已修复
+  - GUI 手动回归依赖本机继续确认，当前结论基于现有测试反馈成立
+- 已知限制 / 遗留问题：[可选]
+  - `Dialog` 旧 synthetic `WM_MOUSEMOVE` 机制尚未统一到新模型
+  - `Table` 内部局部重绘体系尚未实现
+  - Tooltip 智能选位明确后置
+  - 公开 `AxisSizePolicy / AxisAlignPolicy` API 尚未开放，`KEY2` 等旧场景仍受旧 anchor 语义限制
+
+## 落地信息
+
+- 关联功能变更 ID：[可选]
+  - `Feature-20260415-0008`
+- 关联 BUG / Fix：[可选]
+  - `BUG-20260415-0005`
+  - `Fix-BUG-20260415-0005`
+  - `BUG-20260415-0006`
+  - `Fix-BUG-20260415-0006`
+  - `BUG-20260415-0007`
+  - `Fix-BUG-20260415-0007`
+  - `BUG-20260415-0008`
+  - `Fix-BUG-20260415-0008`
+- Commit: 未提交（当前工作区）
+- PR：[可选]
+- 发布版本：[可选]
+- 相关文档：[可选]
+  - [Module-20260415-0003-布局系统第二阶段收口.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/模块/Module-20260415-0003-布局系统第二阶段收口.md)
+  - [Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/功能变更/Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md)
+  - [BUG-20260415-0006-托管局部重绘未正确提交脏子树导致嵌套Canvas按钮状态不刷新.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/BUG/BUG-20260415-0006-托管局部重绘未正确提交脏子树导致嵌套Canvas按钮状态不刷新.md)
+  - [Fix-BUG-20260415-0006-托管局部重绘脏子树提交链修复.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/Fix/Fix-BUG-20260415-0006-托管局部重绘脏子树提交链修复.md)
+  - [BUG-20260415-0007-实际绘制coverage低估导致Tooltip与overlay补画漏算.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/BUG/BUG-20260415-0007-实际绘制coverage低估导致Tooltip与overlay补画漏算.md)
+  - [Fix-BUG-20260415-0007-实际绘制coverage与overlay补画链修复.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/Fix/Fix-BUG-20260415-0007-实际绘制coverage与overlay补画链修复.md)
+  - [BUG-20260415-0008-TabControl页签层级与重复激活链路导致Tooltip和残影异常.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/BUG/BUG-20260415-0008-TabControl页签层级与重复激活链路导致Tooltip和残影异常.md)
+  - [Fix-BUG-20260415-0008-TabControl页签层级与重复激活链路修复.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/Fix/Fix-BUG-20260415-0008-TabControl页签层级与重复激活链路修复.md)
diff --git a/开发记录/模块/Module-20260416-0005-布局策略公开API落地.md b/开发记录/模块/Module-20260416-0005-布局策略公开API落地.md
new file mode 100644
index 0000000..2d2b41e
--- /dev/null
+++ b/开发记录/模块/Module-20260416-0005-布局策略公开API落地.md
@@ -0,0 +1,146 @@
+# 新增功能模块 / 模块重构
+
+> 适用场景：新增模块、重大模块重构、核心架构能力演进。
+> 不适用场景：小接口或轻量功能变更，请使用“功能变更”模板。
+
+## 基本信息
+
+- 模块 ID：Module-20260416-0005
+- 模块名称: 布局策略公开 API 落地
+- 状态：开发中
+- 类型：架构演进
+- 所属系统 / 子系统: GUI 框架 / Layout API
+- 版本 / 分支: 当前工作区 / 下一开发阶段
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 背景与目标
+
+- 背景:
+  - 第一阶段与第二阶段已经把内部布局模型收口到 `LayoutSpec / LayoutCapability / AxisSizePolicy / AxisAlignPolicy`。
+  - 外部调用层仍主要依赖 `setLayoutMode(...)` 与 `setAnchor(...)`，无法直接表达“固定尺寸 + 比例位移”“固定尺寸 + 居中”这类语义。
+  - `KEY2` 顶部位选择区就是典型例子：旧双锚点语义不足，导致按钮与标签 resize 后错位，且难以继续扩展。
+- 当前痛点:
+  - 外部用户无法直接设置 `AxisSizePolicy / AxisAlignPolicy`。
+  - 旧 demo 继续依赖旧锚点入口，验证成本高，迁移路径不清晰。
+  - 新旧 API 混用规则若不写清，后续容易再次回到“旧 anchor 硬凑新布局”的状态。
+- 目标:
+  - 将当前内部布局策略正式开放为公开 API。
+  - 明确新旧 API 混用规则与对外可见语义。
+  - 用 `KEY2` 作为新布局 API 的首个迁移样例。
+- 非目标：[可选]
+  - 不统一 `Dialog` 旧 synthetic `WM_MOUSEMOVE` 机制。
+  - 不实现 `Table` 内部局部重绘体系。
+  - 不实现 Tooltip 智能选位。
+  - 不扩展 `Table` 纵向拉伸和字体缩放。
+
+## 模块边界
+
+- 职责:
+  - 对外开放按轴设置布局规格的最小 API。
+  - 固化新旧 API 的混用规则与默认行为。
+  - 提供首个迁移样例，验证新 API 可表达旧场景中“旧 anchor 无法清晰表达”的布局。
+- 不负责什么:
+  - 不开放 `LayoutCapability` 的通用外部修改接口。
+  - 不改变控件内部硬能力边界。
+  - 不把所有旧 demo 一次性全部迁完。
+- 外部依赖:
+  - `Control / Canvas / TabControl / Table / Label / TextBox`
+  - `z-testDome.cpp`
+- 对外能力 / API:
+  - `setHorizontalLayoutSpec(...)`
+  - `setVerticalLayoutSpec(...)`
+  - `setHorizontalAnchors(...)`
+  - `setVerticalAnchors(...)`
+  - `setHorizontalSizePolicy(...)`
+  - `setVerticalSizePolicy(...)`
+  - `setHorizontalAlignPolicy(...)`
+  - `setVerticalAlignPolicy(...)`
+  - `getHorizontalLayoutSpec()`
+  - `getVerticalLayoutSpec()`
+- 关键数据 / 状态:
+  - `layoutSpec`
+  - `layoutMode`
+  - `layoutCapability`
+  - `localx / localy / localWidth / localHeight`
+  - `x / y / width / height`
+
+## 设计说明
+
+- 核心流程:
+  - 外部通过新 API 直接写入水平轴 / 垂直轴布局规格。
+  - 新 API 被调用后，控件自动切到 `AnchorToEdges` 布局模式。
+  - 运行时统一解算继续以 `layoutSpec` 为唯一依据。
+- 关键对象 / 类关系:
+  - [`Control.h`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)：公开布局策略 API 的对外入口。
+  - [`Control.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Control.cpp)：新 API 的实现、新旧 API 映射共存规则。
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)：`KEY2` 迁移示例与验证入口。
+- 生命周期:
+  - 新 API 只影响运行态布局策略，不自动提交设计基线。
+  - 设计基线仍由显式提交路径或控件内部受控路径维护。
+- 事件 / 渲染 / 数据流：[按模块类型填写]
+  - 新 API 不改变事件分发与局部重绘主链。
+  - 只是改变布局规格输入层与解算参数来源。
+- 关键不变量:
+  - 新旧 API 混用时，后调用者生效。
+  - 旧 API 仍保留兼容，但只覆盖新模型的有限子集。
+  - 公开布局 API 不得自动回写 `local*`。
+- 降级 / 回退策略：[可选]
+  - 非法组合继续沿用现有降级规则，并输出最小必要日志。
+  - 若后续回退，只需回退 `Control` 中新增 API 与 `KEY2` 迁移代码，不影响第二阶段主线。
+
+## 实现与影响
+
+- 关键实现点:
+  - 在 `Control` 层开放最小够用的布局策略 API。
+  - 新 API 调用后自动切换到 `AnchorToEdges`。
+  - 保留 `setAnchor(...)` 与旧 getter，不破坏兼容路径。
+  - 以 `KEY2` 位选择区、功能区、显示区和配置区作为迁移样例，验证新 API 的可用性。
+- 涉及文件 / 类 / 函数:
+  - [`Control.h`](D:/programming/imGUI-easyX/imGui-easyX/Control.h)
+  - [`Control.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Control.cpp)
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 兼容性影响:
+  - 兼容旧 `setAnchor(...)` 调用。
+  - 新 API 为新增能力，不影响现有二进制接口使用方式。
+  - 混用时以最后一次设置为准。
+- 性能影响:
+  - 布局解算主逻辑不变，性能影响可忽略。
+  - `KEY2` 迁移后控件层次变多，但仍处于测试用例范围。
+- 风险点:
+  - `KEY2` 迁移后可能暴露旧 demo 中原本被旧锚点语义掩盖的布局问题。
+  - 若后续没有补使用说明，外部调用仍可能继续滥用旧锚点入口。
+
+## 测试与验证
+
+- 测试范围:
+  - `Control` 新公开布局 API 编译级验证
+  - `KEY2` 迁移后的布局与显示联动
+  - `KEY5` 回归，确认新 API 未破坏第二阶段主线
+- 验证步骤:
+
+1. 编译 `Control.cpp`
+2. 编译 `z-testDome.cpp /DKEY=2`
+3. 编译 `z-testDome.cpp /DKEY=5`
+4. 手动回归 `KEY2` 位选择区、功能区、显示区与配置区的 resize 和联动行为
+
+- 验证结果:
+  - 编译级验证通过。
+  - GUI 手动回归待本机继续确认。
+- 已知限制 / 遗留问题：[可选]
+  - `Dialog` 旧 synthetic `WM_MOUSEMOVE` 机制暂未统一。
+  - `Table` 内部局部重绘体系暂未实现。
+  - resize 过程中若开启高频 console 日志，可能出现一帧视觉延迟；当前判断属于调试态 I/O 现象，不作为 bug 处理，后续可在官网或 API 文档中注明。
+
+## 落地信息
+
+- 关联功能变更 ID：[可选]
+  - `Feature-20260416-0009`
+- 关联 BUG / Fix：[可选]
+  - [Module-20260415-0004-布局系统第二阶段验收与封口.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/模块/Module-20260415-0004-布局系统第二阶段验收与封口.md)
+- Commit:
+- PR：[可选]
+- 发布版本：[可选]
+- 相关文档：[可选]
+  - [Module-20260410-0002-锚点与布局系统第一阶段重构.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/模块/Module-20260410-0002-锚点与布局系统第一阶段重构.md)
+  - [Module-20260415-0004-布局系统第二阶段验收与封口.md](D:/programming/imGUI-easyX/imGui-easyX/开发记录/模块/Module-20260415-0004-布局系统第二阶段验收与封口.md)