diff --git a/VERSION b/VERSION
index af2dabf3..166c9e29 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.25.1
+0.25.2
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 0fab8218..c9dbee4a 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -7,6 +7,24 @@ This project follows the repository versioning rule:
- `feature` -> `+0.1.0`
- `bugfix` -> `+0.0.1`
+## 0.25.2
+
+Released: 2026-04-10
+
+### Highlights
+
+- Refined the Earth HUD operator polish so settings now behave like a true bounded menu, HUD panels render at the correct scale from the first frame, and dragged panels animate cleanly into and out of maximized layout targets without drifting to screen edges.
+
+### Improved
+
+- Improved [frontend/public/earth/index.html](/home/ray/dev/linkong/planet/frontend/public/earth/index.html) by precomputing the initial `--hud-scale` before Earth CSS loads, so HUD panels no longer flash at full size before shrinking to the target scale.
+- Improved [frontend/public/earth/css/hud.css](/home/ray/dev/linkong/planet/frontend/public/earth/css/hud.css) by cleaning up duplicated settings-modal close-button styles, aligning the settings title with the shared HUD title system, and constraining the settings sheet to a stable centered width instead of viewport-relative modal sizing.
+
+### Fixed
+
+- Fixed [frontend/public/earth/js/controls.js](/home/ray/dev/linkong/planet/frontend/public/earth/js/controls.js) so dragged HUD panels now fly from their dragged positions into maximized layout targets, closed panels stay out of the transition, and restoring layout clears drag overrides back to the initial positions.
+- Fixed [frontend/public/earth/js/controls.js](/home/ray/dev/linkong/planet/frontend/public/earth/js/controls.js) and [frontend/public/earth/css/hud.css](/home/ray/dev/linkong/planet/frontend/public/earth/css/hud.css) so layout transitions no longer visibly stick to screen edges before landing; the FLIP motion now composes with the existing corner transforms instead of fighting them.
+
## 0.25.1
Released: 2026-04-10
diff --git a/docs/version-history.md b/docs/version-history.md
index 52ec0498..7672e915 100644
--- a/docs/version-history.md
+++ b/docs/version-history.md
@@ -16,7 +16,7 @@
## Current Version
- `main` 当前主线历史推导到：`0.16.5`
-- `dev` 当前开发分支历史推导到：`0.25.1`
+- `dev` 当前开发分支历史推导到：`0.25.2`
## Timeline
@@ -83,6 +83,7 @@
| `0.24.8` | bugfix | `dev` | `pending` | move BGP brief markdown into a dedicated modal, keep tab content metadata-focused, and constrain modal scrolling to the viewport |
| `0.25.0` | feature | `dev` | `89a71e6f` | add persistent backend-backed AI Playground chat state, split alert workspaces into dedicated pages, and establish the situational-awareness foundation for later multi-signal analysis |
| `0.25.1` | bugfix | `dev` | `pending` | clean duplicated Playground flow code, add reusable code-hygiene rules, and fix first-level sidebar menu expansion behavior across route navigation and refresh |
+| `0.25.2` | bugfix | `dev` | `pending` | refine Earth settings modal sizing, eliminate first-frame HUD scale flicker, and make dragged HUD panels animate cleanly through maximized layout transitions |
## Maintenance Commits Not Counted as Version Bumps
diff --git a/frontend/package.json b/frontend/package.json
index 4f80d231..603c9b68 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,6 +1,6 @@
{
"name": "planet-frontend",
- "version": "0.25.1",
+ "version": "0.25.2",
"private": true,
"packageManager": "bun@1",
"dependencies": {
diff --git a/frontend/public/earth/css/hud.css b/frontend/public/earth/css/hud.css
index 42664966..725925aa 100644
--- a/frontend/public/earth/css/hud.css
+++ b/frontend/public/earth/css/hud.css
@@ -58,13 +58,14 @@
.hud-panel-title {
color: #4db8ff;
- margin-bottom: var(--hud-gap-sm);
+ margin: 0 0 var(--hud-gap-sm);
font-size: var(--hud-title-size);
+ line-height: 1.2;
}
.hud-panel-header {
display: flex;
- align-items: center;
+ align-items: flex-start;
justify-content: space-between;
gap: var(--hud-gap-sm);
margin-bottom: var(--hud-gap-sm);
@@ -84,9 +85,11 @@
}
.hud-panel-close {
- width: 28px;
- height: 28px;
- min-width: 28px;
+ align-self: flex-start;
+ width: calc(var(--hud-title-size) * 1.24);
+ height: calc(var(--hud-title-size) * 1.24);
+ min-width: calc(var(--hud-title-size) * 1.24);
+ padding: 0;
border: 0;
border-radius: 999px;
background: rgba(255, 255, 255, 0.08);
@@ -99,7 +102,8 @@
}
.hud-panel-close .material-symbols-rounded {
- font-size: 18px;
+ font-size: calc(var(--hud-title-size) * 0.8);
+ line-height: 1;
}
.hud-panel-close:hover {
@@ -116,6 +120,10 @@
0 0 36px rgba(120, 200, 255, 0.16);
}
+.hud-panel.is-layout-animating {
+ transition: none !important;
+}
+
.hud-panel-hidden {
display: none !important;
}
@@ -224,12 +232,13 @@
.earth-settings-sheet {
position: fixed;
- top: 15vh;
- right: 20vw;
- bottom: 15vh;
- left: 20vw;
- width: auto;
- max-width: none;
+ top: max(32px, 9vh);
+ right: 16px;
+ left: 16px;
+ width: min(560px, calc(100vw - 32px));
+ max-width: 560px;
+ max-height: calc(100vh - max(64px, 18vh));
+ margin-inline: auto;
transform: none;
border-radius: calc(28px * var(--hud-scale));
padding: calc(20px * var(--hud-scale));
@@ -272,24 +281,12 @@
}
.earth-settings-title {
- margin-top: 4px;
+ margin: 4px 0 0;
color: #eef7ff;
- font-size: calc(1.45rem * var(--hud-scale));
- font-weight: 600;
}
.earth-settings-close {
- width: 34px;
- height: 34px;
- min-width: 34px;
- border: 0;
- border-radius: 999px;
- background: rgba(255, 255, 255, 0.08);
- color: #d9efff;
- display: inline-flex;
- align-items: center;
- justify-content: center;
- cursor: pointer;
+ margin-top: 4px;
}
.earth-settings-content {
@@ -406,10 +403,12 @@
@media (max-width: 960px) {
.earth-settings-sheet {
- top: 12vh;
- right: 10vw;
- bottom: 12vh;
- left: 10vw;
+ top: 24px;
+ right: 12px;
+ left: 12px;
+ width: auto;
+ max-width: none;
+ max-height: calc(100vh - 48px);
}
}
diff --git a/frontend/public/earth/index.html b/frontend/public/earth/index.html
index bd9af3a3..69198a25 100644
--- a/frontend/public/earth/index.html
+++ b/frontend/public/earth/index.html
@@ -13,6 +13,20 @@
}
}
+
@@ -261,9 +275,9 @@
diff --git a/frontend/public/earth/js/controls.js b/frontend/public/earth/js/controls.js
index c0f012f1..8a9114fc 100644
--- a/frontend/public/earth/js/controls.js
+++ b/frontend/public/earth/js/controls.js
@@ -31,6 +31,8 @@ const HUD_PANEL_IDS = [
"coordinates-display",
"earth-stats",
];
+const DRAGGABLE_PANEL_SELECTOR = ".hud-panel-draggable";
+const PANEL_LAYOUT_ANIMATION_MS = 420;
function getFloatingGroups() {
return [
@@ -159,7 +161,7 @@ function setupHudPanelControls() {
function setupDraggableHudPanels() {
const app = document.getElementById("container");
- const draggablePanels = document.querySelectorAll(".hud-panel-draggable");
+ const draggablePanels = document.querySelectorAll(DRAGGABLE_PANEL_SELECTOR);
if (!app || draggablePanels.length === 0) return;
draggablePanels.forEach((panel) => {
@@ -196,6 +198,7 @@ function setupDraggableHudPanels() {
panel.style.right = "auto";
panel.style.bottom = "auto";
panel.style.transform = "none";
+ panel.dataset.dragged = "true";
};
bindListener(handle, "pointerdown", (event) => {
@@ -212,6 +215,7 @@ function setupDraggableHudPanels() {
panel.style.right = "auto";
panel.style.bottom = "auto";
panel.style.transform = "none";
+ panel.dataset.dragged = "true";
panel.classList.add("is-dragging");
document.body.style.userSelect = "none";
handle.setPointerCapture?.(event.pointerId);
@@ -783,8 +787,74 @@ function updateLayoutUI(container) {
}
}
-function toggleLayoutExpanded(container) {
- layoutExpanded = !layoutExpanded;
- updateLayoutUI(container);
- return layoutExpanded;
+function resetPanelInlineLayout(panel) {
+ panel.style.left = "";
+ panel.style.top = "";
+ panel.style.right = "";
+ panel.style.bottom = "";
+ panel.style.transform = "";
+ delete panel.dataset.dragged;
+}
+
+function isPanelVisible(panel) {
+ return !panel.classList.contains("hud-panel-hidden");
+}
+
+function animatePanelLayoutTransition(container, expand) {
+ const panels = Array.from(
+ container.querySelectorAll(DRAGGABLE_PANEL_SELECTOR),
+ );
+ if (panels.length === 0) {
+ layoutExpanded = expand;
+ updateLayoutUI(container);
+ return expand;
+ }
+
+ const visiblePanels = panels.filter(isPanelVisible);
+ const firstRects = new Map(
+ visiblePanels.map((panel) => [panel, panel.getBoundingClientRect()]),
+ );
+
+ panels.forEach((panel) => panel.classList.add("is-layout-animating"));
+ layoutExpanded = expand;
+ panels.forEach(resetPanelInlineLayout);
+ updateLayoutUI(container);
+
+ visiblePanels.forEach((panel) => {
+ const firstRect = firstRects.get(panel);
+ if (!firstRect) return;
+
+ const lastRect = panel.getBoundingClientRect();
+ const deltaX = firstRect.left - lastRect.left;
+ const deltaY = firstRect.top - lastRect.top;
+
+ if (Math.abs(deltaX) < 0.5 && Math.abs(deltaY) < 0.5) {
+ return;
+ }
+
+ panel.animate(
+ [
+ {
+ translate: `${deltaX}px ${deltaY}px`,
+ },
+ {
+ translate: "0 0",
+ },
+ ],
+ {
+ duration: PANEL_LAYOUT_ANIMATION_MS,
+ easing: "cubic-bezier(0.22, 1, 0.36, 1)",
+ },
+ );
+ });
+
+ window.setTimeout(() => {
+ panels.forEach((panel) => panel.classList.remove("is-layout-animating"));
+ }, PANEL_LAYOUT_ANIMATION_MS);
+
+ return expand;
+}
+
+function toggleLayoutExpanded(container) {
+ return animatePanelLayoutTransition(container, !layoutExpanded);
}
diff --git a/pyproject.toml b/pyproject.toml
index 453f4625..21f524bf 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "planet"
-version = "0.25.1"
+version = "0.25.2"
description = "智能星球计划 - 态势感知系统"
requires-python = ">=3.14"
dependencies = [
diff --git a/uv.lock b/uv.lock
index 08656abb..5f5993d5 100644
--- a/uv.lock
+++ b/uv.lock
@@ -475,7 +475,7 @@ wheels = [
[[package]]
name = "planet"
-version = "0.25.1"
+version = "0.25.2"
source = { virtual = "." }
dependencies = [
{ name = "aiofiles" },