release: bump version to 0.76.1

VERSION

@@ -1 +1 @@
-0.76.0
+0.76.1

docs/CHANGELOG.md

@@ -8,6 +8,20 @@ This project follows the repository versioning rule:
 - `improvement` -> `+0.0.1`（bugfix + 小功能混合）
 - `bugfix` -> `+0.0.1`
 
+## [0.76.1] — 2026-10-01
+
+Released: 2026-10-01
+
+### Highlights
+- 修复选中 BGP 事件静态光晕在地表边缘被切断或陷入地表的问题。
+
+### Added / Fixed / Improved
+- 抽取通用整体锚点遮挡能力，BGP 事件保持原有图标样式并复用圆角图标的前后显隐规则。
+- 选中事件光晕与事件图标共享地表锚点、前景层级和前后显隐路径，清理中间态代码与资源。
+- 补充中英文渲染层说明、回归测试和浏览器验证记录。
+
+---
+
 ## [0.76.0] — 2026-09-30
 
 Released: 2026-09-30

docs/technical/en/earth-render-layer-order.md

@@ -98,7 +98,7 @@ Base, tint, land fill and HD surface now use `createEarthSurfaceGeometry()` and
 
 ### Surface marker alignment and limb visibility
 
-Cables and landing points share R+0.48, the `earthSurfacePoint` triangle projection and renderOrder=1. Related landing halos use an emphasis attribute in the existing batch, adding no Sprite or draw call. Rounded badges use GPU anchor ray/sphere occlusion: draw the entire billboard when its anchor is visible, otherwise clip it entirely. CPU picking uses the same test to reject rear anchors. Only `icon.badge` layers (including compute and collectors; vessels independently use heading arrows) use this path; flat BGP change-event depth testing stays unchanged.
+Cables and landing points share R+0.48, the `earthSurfacePoint` triangle projection and renderOrder=1. Related landing halos use an emphasis attribute in the existing batch, adding no Sprite or draw call. Rounded badges use GPU anchor ray/sphere occlusion: draw the entire billboard when its anchor is visible, otherwise clip it entirely. CPU picking uses the same test to reject rear anchors. Only `icon.badge` layers (including compute and collectors; vessels independently use heading arrows) use this path. The selected BGP event's static overlay halo uses the event icon's R+0.48 anchor, foreground order and whole-anchor front/rear visibility; the existing animated BGP event ring remains a separate effect with its original behavior.
 
 
 The `.map-clusters` projection layer uses z-index 8 below HUD and whole-marker occlusion from real surface anchors. Ordinary points retain their Three.js layers; transitioning members render only once in the projection layer. Spider legs use widened transparent hit areas; hover highlights the matching line and child, and both clicks resolve the same business object. Wheel input over projected markers and legs continues to zoom the globe.

docs/technical/zh/earth-render-layer-order.md

@@ -100,7 +100,7 @@ Earth 的地表不是单一 mesh，而是多层近似同心球：基座球、海
 
 ### 地表标记对齐与侧面显隐
 
-海缆和登陆点现在统一使用 R+0.48 及 `earthSurfacePoint` 三角表面投影，并保持 renderOrder=1。登陆点关联光晕进入原实例批次的 emphasis 属性，不增加独立 Sprite 或 draw call。侧面的完整圆角徽标采用 GPU 锚点射线/球体遮挡：锚点可见则整个 billboard 绘制，锚点被地球挡住则整块裁除。CPU 拾取使用同样的射线判断，避免点到背面图标。该路径只作用于 `icon.badge` 层（含算力、观测站；船舶独立使用航向箭头），不改变 BGP 变化事件的原深度测试。
+海缆和登陆点现在统一使用 R+0.48 及 `earthSurfacePoint` 三角表面投影，并保持 renderOrder=1。登陆点关联光晕进入原实例批次的 emphasis 属性，不增加独立 Sprite 或 draw call。侧面的完整圆角徽标采用 GPU 锚点射线/球体遮挡：锚点可见则整个 billboard 绘制，锚点被地球挡住则整块裁除。CPU 拾取使用同样的射线判断，避免点到背面图标。该路径只作用于 `icon.badge` 层（含算力、观测站；船舶独立使用航向箭头）。选中 BGP 事件的静态覆盖光晕使用事件图标相同的 R+0.48 锚点、前景顺序和整块前后显隐；BGP 发散圆环仍保留原有独立动画语义。
 
 
 聚合投影层 `.map-clusters` 的 z-index 为 8，低于 HUD；以真实地表锚点做整标遮挡。普通点仍使用原 Three.js 图层，过渡中的成员只在投影层显示一次，避免双图标。Spiderfy 引线有透明加宽命中区域，悬停联动高亮引线与子点，点击返回同一业务对象；滚轮在图标与引线上继续缩放地球。

docs/version-history.md

@@ -16,12 +16,13 @@
 ## Current Version
 
 - `main` 当前主线历史推导到：`0.16.5`
-- `dev` 当前开发分支历史推导到：`0.76.0`
+- `dev` 当前开发分支历史推导到：`0.76.1`
 
 ## Timeline
 
 | Version | Type | Branch | Commit | Summary |
 | --- | --- | --- | --- | --- |
+| `0.76.1` | bugfix | `dev` | `v0.76.1` | 修复选中 BGP 事件静态光晕地表遮挡，统一事件锚点显隐与前景偏移，清理中间态逻辑并补齐验证 |
 | `0.76.0` | feature | `dev` | `v0.76.0` | 详情卡默认配图与后台配置、五类算力中心、统一地表拾取与选中置顶、卡片交互修复及 Earth 性能优化 |
 | `0.75.4` | improvement | `dev` | `v0.75.4` | 图例统一筛选、卫星 Points 点径与性能优化、FPS、菜单 DPI/hover、星空 sRGB、地表对齐及新闻编码修复，清理废弃代码文档 |
 | `0.75.3` | improvement | `dev` | `v0.75.3` | 地球海陆材质与可读夜侧、连续拖拽、现代徽标、卫星平滑开放轨道及流光，修复 CelesTrak 缓存与任务历史并清理废弃实现 |

frontend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planet-frontend",
-  "version": "0.76.0",
+  "version": "0.76.1",
   "private": true,
   "packageManager": "bun@1",
   "dependencies": {

frontend/public/earth/js/bgp.js

@@ -8,6 +8,7 @@ import {
   SURFACE_AVOIDANCE_PROFILES,
 } from "./interactable.js";
 import { getSurfaceMarkerCameraScale, latLonToVector3 } from "./utils.js";
+import { isSurfaceAnchorVisible } from "./surface-marker-occlusion.js";
 
 const bgpGroup = new THREE.Group();
 const bgpOverlayGroup = new THREE.Group();
@@ -22,7 +23,6 @@ let totalAnomalyCount = 0;
 let totalIncidentCount = 0;
 let textureCache = null;
 let eventRingTextureCache = null;
-let activeEventOverlay = null;
 let activeCollectorOverlayContext = null;
 const relativeTimeFormatter = new Intl.RelativeTimeFormat("zh-CN", {
   numeric: "auto",
@@ -42,6 +42,7 @@ const BGP_COLLECTOR_ICON_SOURCE = new URL("../assets/icons/bgp-broadcast-pin.svg
 const BGP_COLLECTOR_HOVER_SCALE = 1.08;
 const BGP_COLLECTOR_LOCKED_SCALE = 1.12;
 const BGP_COLLECTOR_PULSE_AMPLITUDE = 0.14;
+const bgpCameraLocalScratch = new THREE.Vector3();
 
 bgpOverlayGroup.name = "bgp-overlay-root";
 bgpEventOverlayGroup.name = "bgp-event-overlay-layer";
@@ -279,6 +280,7 @@ const bgpEventIconLayer = createInteractableLayer({
     coordinates: "canvas",
     draw: drawBGPEventIcon,
   },
+  surfaceAnchorOcclusion: true,
   getPosition: (item) => ({
     latitude: item.latitude,
     longitude: item.longitude,
@@ -905,6 +907,16 @@ function createOverlaySprite({ color, opacity, scale }) {
   return sprite;
 }
 
+function updateEventHaloVisibility(camera) {
+  const earth = bgpEventOverlayGroup.parent?.parent;
+  if (!earth || !camera || bgpEventOverlayGroup.children.length === 0) return;
+  bgpCameraLocalScratch.copy(camera.position);
+  earth.worldToLocal(bgpCameraLocalScratch);
+  bgpEventOverlayGroup.children.forEach((halo) => {
+    halo.visible = isSurfaceAnchorVisible(halo.position, bgpCameraLocalScratch, CONFIG.earthRadius);
+  });
+}
+
 function projectLatLon(lat, lon, bearingDeg, distanceDeg) {
   const latRad = (lat * Math.PI) / 180;
   const lonRad = (lon * Math.PI) / 180;
@@ -1361,6 +1373,7 @@ export async function loadBGPAnomalies(scene, earth) {
 
 export function updateBGPVisualState(lockedObjectType, lockedObject, camera, cruiseMarker = null) {
   const now = performance.now();
+  updateEventHaloVisibility(camera);
   updateCollectorOverlayScan(lockedObjectType, lockedObject);
   syncBGPLegendEffects();
   const hasLockedLayer = Boolean(
@@ -1686,8 +1699,6 @@ export function showBGPEventOverlay(marker, earth) {
       typeof region?.longitude === "number",
   );
   if (validRegions.length === 0) return;
-  const overlayItems = [];
-
   validRegions.forEach((region) => {
     const eventBaseColor = marker.userData.baseColor || getSeverityColor(marker.userData.severity);
     const halo = createOverlaySprite({
@@ -1695,19 +1706,19 @@ export function showBGPEventOverlay(marker, earth) {
       opacity: 0.24,
       scale: BGP_CONFIG.regionScale,
     });
-    halo.position.copy(
-      latLonToVector3(
-        region.latitude,
-        region.longitude,
-        CONFIG.earthRadius + BGP_COLLECTOR_ALTITUDE_OFFSET - 0.1,
-      ),
+    const anchor = latLonToVector3(
+      region.latitude,
+      region.longitude,
+      CONFIG.earthRadius + BGP_CONFIG.altitudeOffset,
     );
-    halo.renderOrder = 2;
+    halo.position.copy(anchor);
+    // Like marker badges, a visible anchor owns the entire billboard. Per-pixel
+    // Earth depth would cut this camera-facing gradient through the surface.
+    halo.material.depthTest = false;
+    halo.renderOrder = BGP_EVENT_RENDER_ORDER;
     bgpEventOverlayGroup.add(halo);
-    overlayItems.push(halo);
   });
 
-  activeEventOverlay = overlayItems;
   activeCollectorOverlayContext = null;
   bgpOverlayGroup.visible = showBGP;
 }
@@ -1767,7 +1778,6 @@ export function showBGPCollectorCoverageOverlay(marker, earth, options = {}) {
   innerRing.renderOrder = 3;
   bgpCollectorRadarGroup.add(innerRing);
 
-  const overlayItems = [halo, pulseHalo, innerRing];
   const anchorLatitude = marker.userData.displayLatitude ?? marker.userData.latitude;
   const anchorLongitude = marker.userData.displayLongitude ?? marker.userData.longitude;
   const activityMagnitude = Math.log2(prefixCount + observationCount + 1);
@@ -1823,7 +1833,6 @@ export function showBGPCollectorCoverageOverlay(marker, earth, options = {}) {
   );
   sectorFill.renderOrder = 2;
   bgpCollectorRadarGroup.add(sectorFill);
-  overlayItems.push(sectorFill);
 
   const outerArc = createCoverageBoundaryLine(
     outerArcPoints,
@@ -1832,7 +1841,6 @@ export function showBGPCollectorCoverageOverlay(marker, earth, options = {}) {
   );
   outerArc.renderOrder = 3;
   bgpCollectorRadarGroup.add(outerArc);
-  overlayItems.push(outerArc);
 
   const leftBoundary = createCoverageBoundaryLine(
     leftBoundaryPoints,
@@ -1841,7 +1849,6 @@ export function showBGPCollectorCoverageOverlay(marker, earth, options = {}) {
   );
   leftBoundary.renderOrder = 3;
   bgpCollectorRadarGroup.add(leftBoundary);
-  overlayItems.push(leftBoundary);
 
   const rightBoundary = createCoverageBoundaryLine(
     rightBoundaryPoints,
@@ -1850,9 +1857,7 @@ export function showBGPCollectorCoverageOverlay(marker, earth, options = {}) {
   );
   rightBoundary.renderOrder = 3;
   bgpCollectorRadarGroup.add(rightBoundary);
-  overlayItems.push(rightBoundary);
 
-  activeEventOverlay = overlayItems;
   activeCollectorOverlayContext = {
     marker,
     earth,
@@ -1863,7 +1868,6 @@ export function showBGPCollectorCoverageOverlay(marker, earth, options = {}) {
 }
 
 export function clearBGPEventOverlay() {
-  activeEventOverlay = null;
   activeCollectorOverlayContext = null;
   clearGroup(bgpEventOverlayGroup);
   clearGroup(bgpCollectorRadarGroup);

frontend/public/earth/js/interactable.js

@@ -490,6 +490,7 @@ export function createInteractableLayer(options = {}) {
     avoidance = false,
     cluster = undefined,
     icon,
+    surfaceAnchorOcclusion = false,
     getPosition,
     getKind = (item) => item?.type || "default",
     getRotationBin = () => 0,
@@ -548,7 +549,9 @@ export function createInteractableLayer(options = {}) {
   const hoverScale = stateScale.hover ?? 1;
   const lockedScale = stateScale.locked ?? 1;
   const dimmedScale = stateScale.dimmed ?? 1;
-  const usesSurfaceAnchorOcclusion = Boolean(icon.badge);
+  // Rounded badges enable this implicitly, while other icon styles can opt
+  // into the same whole-billboard surface behavior without changing artwork.
+  const usesSurfaceAnchorOcclusion = Boolean(surfaceAnchorOcclusion || icon.badge);
   const depthTest = usesSurfaceAnchorOcclusion ? false : material.depthTest ?? true;
   const depthWrite = material.depthWrite ?? false;
   const alphaTest = material.alphaTest ?? 0.01;

frontend/public/earth/js/marker-badges.test.js

@@ -82,6 +82,25 @@ test('projected BGP symbols bake the same category color as GPU vertex colors',
   } finally {layer?.clearData();globalThis.document=oldDocument;globalThis.window=oldWindow;}
 });
 
+test('surface anchor occlusion can preserve a custom icon drawing style', () => {
+  const oldDocument = globalThis.document, oldWindow = globalThis.window;
+  globalThis.window = { innerWidth: 1280, innerHeight: 720, devicePixelRatio: 1 };
+  globalThis.document = { createElement: () => ({ width: 128, height: 128, getContext: () => new Proxy({}, { get: () => () => {} }) }) };
+  let layer;
+  try {
+    layer = createInteractableLayer({ id: 'surface-anchor-style-test', cluster: false,
+      surfaceAnchorOcclusion: true, getPosition: item => item,
+      icon: { draw() {} } });
+    const earth = new THREE.Object3D(), camera = new THREE.PerspectiveCamera(75, 1, .1, 5000);
+    camera.position.z = 350; camera.updateMatrixWorld();
+    layer.attach(earth); layer.setVisible(true); layer.setData([{ id: 'custom', latitude: 0, longitude: -90 }]);
+    layer.updateVisualState(null, null, camera);
+    const points = layer.group.children.find(group => group.children.some(child => child.isPoints)).children.find(child => child.isPoints);
+    expect(points.material.depthTest).toBe(false);
+    expect(points.material.defines.USE_SURFACE_ANCHOR_OCCLUSION).toBe('');
+  } finally { layer?.clearData(); globalThis.document = oldDocument; globalThis.window = oldWindow; }
+});
+
 
 test('selected pulses do not refresh unchanged batches; state changes still do', () => {
   const oldDocument=globalThis.document,oldWindow=globalThis.window;

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "planet"
-version = "0.76.0"
+version = "0.76.1"
 description = "智能星球计划 - 态势感知系统"
 requires-python = ">=3.14"
 dependencies = [

uv.lock

@@ -757,7 +757,7 @@ wheels = [
 
 [[package]]
 name = "planet"
-version = "0.76.0"
+version = "0.76.1"
 source = { virtual = "." }
 dependencies = [
     { name = "aiofiles" },