copper3d 3.6.2 → 3.6.5

package/dist/Utils/surfaceAnnotation/MeshGraph.d.ts

@@ -1,13 +1,15 @@
 import * as THREE from "three";
 /**
- * 从 BufferGeometry 的索引构建顶点邻接图,用于模式 B(测地线)的最短路径。
- * 顶点坐标按 local 存;传入的查询点需先转为 local(mesh.worldToLocal)。
+ * Build a vertex adjacency graph from a BufferGeometry's index, used for the shortest path in
+ * mode B (geodesic). Vertex coordinates are stored in local space; query points must be converted
+ * to local first (mesh.worldToLocal).
  *
- * 说明:几何须为已索引(indexed)。modelLoader 用 mergeVertices 焊接重复顶点,
- * 保证同一表面位置共享顶点,邻接图才连通。
+ * Note: the geometry must be indexed. modelLoader welds duplicate vertices with mergeVertices so
+ * that vertices at the same surface position are shared, otherwise the adjacency graph won't be connected.
  *
- * 性能:O(V²) Dijkstra + O(V) 最近顶点查找。对几万顶点单次点击可接受;
- * 若过大可后续换二叉堆 + 空间网格加速(留作升级)。
+ * Performance: O(V²) Dijkstra + O(V) nearest-vertex lookup. Acceptable for a single click on tens
+ * of thousands of vertices; if too large it can later be sped up with a binary heap + spatial grid
+ * (left as a future upgrade).
  */
 export declare class MeshGraph {
     private positions;
@@ -18,16 +20,16 @@ export declare class MeshGraph {
     private px;
     private py;
     private pz;
-    /** 最近顶点(传入 local 坐标)。 */
+    /** Nearest vertex (pass in local coordinates). */
     nearestVertex(localPoint: THREE.Vector3): number;
     /**
-     * 两顶点间最短路径(含端点的顶点索引序列)。二叉堆 Dijkstra,O(E log V)。
-     * 不连通时返回 [start,end] 兜底。
+     * Shortest path between two vertices (sequence of vertex indices including endpoints).
+     * Binary-heap Dijkstra, O(E log V). Falls back to [start,end] when disconnected.
      */
     shortestPath(startV: number, endV: number): number[];
     vertexWorld(i: number, matrixWorld: THREE.Matrix4): THREE.Vector3;
     vertexNormalWorld(i: number, mesh: THREE.Mesh): THREE.Vector3;
-    /** 顶点的 local 坐标 + local 法线(图几何即 local 空间)。 */
+    /** Vertex local coordinates + local normal (the graph geometry is already local space). */
     vertexLocal(i: number): {
         x: number;
         y: number;

package/dist/Utils/surfaceAnnotation/MeshGraph.js

@@ -1,13 +1,15 @@
 import * as THREE from "three";
 /**
- * 从 BufferGeometry 的索引构建顶点邻接图,用于模式 B(测地线)的最短路径。
- * 顶点坐标按 local 存;传入的查询点需先转为 local(mesh.worldToLocal)。
+ * Build a vertex adjacency graph from a BufferGeometry's index, used for the shortest path in
+ * mode B (geodesic). Vertex coordinates are stored in local space; query points must be converted
+ * to local first (mesh.worldToLocal).
  *
- * 说明:几何须为已索引(indexed)。modelLoader 用 mergeVertices 焊接重复顶点,
- * 保证同一表面位置共享顶点,邻接图才连通。
+ * Note: the geometry must be indexed. modelLoader welds duplicate vertices with mergeVertices so
+ * that vertices at the same surface position are shared, otherwise the adjacency graph won't be connected.
  *
- * 性能:O(V²) Dijkstra + O(V) 最近顶点查找。对几万顶点单次点击可接受;
- * 若过大可后续换二叉堆 + 空间网格加速(留作升级)。
+ * Performance: O(V²) Dijkstra + O(V) nearest-vertex lookup. Acceptable for a single click on tens
+ * of thousands of vertices; if too large it can later be sped up with a binary heap + spatial grid
+ * (left as a future upgrade).
  */
 export class MeshGraph {
     constructor(geometry) {
@@ -35,7 +37,7 @@ export class MeshGraph {
             }
         }
         else {
-            // 非索引兜底(连通性差,仅避免崩溃)。
+            // Non-indexed fallback (poor connectivity, only to avoid crashing).
             for (let i = 0; i + 2 < this.vertexCount; i += 3) {
                 addEdge(i, i + 1);
                 addEdge(i + 1, i + 2);
@@ -52,7 +54,7 @@ export class MeshGraph {
     pz(i) {
         return this.positions[i * 3 + 2];
     }
-    /** 最近顶点(传入 local 坐标)。 */
+    /** Nearest vertex (pass in local coordinates). */
     nearestVertex(localPoint) {
         let best = -1;
         let bestD = Infinity;
@@ -69,8 +71,8 @@ export class MeshGraph {
         return best;
     }
     /**
-     * 两顶点间最短路径(含端点的顶点索引序列)。二叉堆 Dijkstra,O(E log V)。
-     * 不连通时返回 [start,end] 兜底。
+     * Shortest path between two vertices (sequence of vertex indices including endpoints).
+     * Binary-heap Dijkstra, O(E log V). Falls back to [start,end] when disconnected.
      */
     shortestPath(startV, endV) {
         if (startV === endV)
@@ -127,7 +129,7 @@ export class MeshGraph {
         const nm = new THREE.Matrix3().getNormalMatrix(mesh.matrixWorld);
         return n.applyMatrix3(nm).normalize();
     }
-    /** 顶点的 local 坐标 + local 法线(图几何即 local 空间)。 */
+    /** Vertex local coordinates + local normal (the graph geometry is already local space). */
     vertexLocal(i) {
         return {
             x: this.px(i),
@@ -140,7 +142,7 @@ export class MeshGraph {
         };
     }
 }
-/** 极简二叉最小堆(按 priority 排序,存顶点索引)。用于 Dijkstra。 */
+/** Minimal binary min-heap (ordered by priority, stores vertex indices). Used for Dijkstra. */
 class MinHeap {
     constructor() {
         this.ids = [];

package/dist/Utils/surfaceAnnotation/MeshGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"MeshGraph.js","sourceRoot":"","sources":["../../../src/Utils/surfaceAnnotation/MeshGraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MeshGraph.js","sourceRoot":"","sources":["../../../src/Utils/surfaceAnnotation/MeshGraph.ts"],"names":[],"mappings":"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"}

package/dist/Utils/surfaceAnnotation/SurfaceAnnotator.d.ts

@@ -9,26 +9,34 @@ export interface SurfaceAnnotatorOptions {
         enabled: boolean;
     };
     mesh: THREE.Mesh;
-    /** 缺省时从 mesh 几何包围盒对角线自算。 */
+    /** Computed from the mesh geometry's bounding-box diagonal when omitted. */
     bboxDiagonal?: number;
-    /** 自由手绘 contour 颜色,默认 #e5006e。 */
+    /**
+     * Outward offset of the annotation line from the surface (world units), defaults to bboxDiagonal*0.002.
+     * Providing it separately decouples it from the sampling spacing (minGap/maxJump, still derived from
+     * bboxDiagonal) — useful on bumpy/voxel surfaces where a larger offset is needed to float the line
+     * above the relief without also coarsening the sampling.
+     */
+    epsilon?: number;
+    /** Freehand contour color, defaults to #e5006e. */
     freehandColor?: string;
-    /** 测地线 contour 颜色,默认 #ffa24e。 */
+    /** Geodesic contour color, defaults to #ffa24e. */
     geodesicColor?: string;
-    /** 放点标记颜色,默认 #ffd166。 */
+    /** Point-marker color, defaults to #ffd166. */
     pointColor?: string;
-    /** 线宽(像素),默认 3。 */
+    /** Line width (pixels), defaults to 3. */
     lineWidth?: number;
-    /** 标记小球半径,默认 bboxDiagonal*0.006。 */
+    /** Marker sphere radius, defaults to bboxDiagonal*0.006. */
     markerRadius?: number;
     onModeChange?: (m: AnnotationMode) => void;
-    /** 标注列表变化回调(增删/撤销/清空)。 */
+    /** Callback when the annotation list changes (add/remove/undo/clear). */
     onChange?: (annotations: Annotation[]) => void;
 }
 /**
- * 表面标注主控制器(Phase 4):navigate / freehand / geodesic / point 四模式,
- * Enter 闭合,数据交给 AnnotationStore 管理(多条带颜色标签、撤销/删除/清空、导出)。
- * 渲染层据 store.list() 做场景对账(reconcile),撤销/删除自动加/移 three 对象。
+ * Main surface-annotation controller (Phase 4): four modes navigate / freehand / geodesic / point,
+ * Enter closes the loop, and data is managed by AnnotationStore (multiple color-labeled strips,
+ * undo/delete/clear, export).
+ * The render layer reconciles the scene against store.list(); undo/delete automatically add/remove three objects.
  */
 export declare class SurfaceAnnotator {
     private o;
@@ -56,7 +64,7 @@ export declare class SurfaceAnnotator {
     private hoveredGeoMarker;
     private _projV;
     constructor(opts: SurfaceAnnotatorOptions);
-    /** 窗口尺寸变化时更新所有 fat line 的像素分辨率,否则线宽会失真。 */
+    /** Update the pixel resolution of all fat lines on window resize, otherwise line width distorts. */
     private onResize;
     private get freehandColor();
     private get geodesicColor();
@@ -64,13 +72,13 @@ export declare class SurfaceAnnotator {
     getMode(): AnnotationMode;
     setMode(m: AnnotationMode): void;
     getStore(): AnnotationStore;
-    /** 当前标注列表快照。 */
+    /** Snapshot of the current annotation list. */
     getAnnotations(): Annotation[];
     undo(): void;
     clearAll(): void;
     deleteAnnotation(id: string): void;
     selectAnnotation(id: string | null): void;
-    /** 颜色变更后重画对应 three 对象。 */
+    /** Redraw the corresponding three object after a color change. */
     refreshAnnotation(id: string): void;
     exportJSON(modelName: string, opts?: ExportOptions): {
         model: string;
@@ -87,42 +95,54 @@ export declare class SurfaceAnnotator {
         }[];
     };
     private applyCameraGating;
-    /** 据 store.list() 对账场景:补齐缺失对象、移除已删对象(不 dispose,留给撤销恢复)。 */
+    /** Reconcile the scene against store.list(): add missing objects, remove deleted ones (no dispose, kept for undo restore). */
     private reconcile;
     private applySelection;
     private disposeObject;
     private nextId;
     private hit;
     /**
-     * 事件目标是否是容器内的 WebGL canvas。
-     * 仅认 canvas:面板(GUIDE / 控制面板 / 标注列表的 ✕ 按钮)都是 container 的子元素,
-     * 若只判断 contains 会把面板上的点击也当成在模型上作画 —— 这会"穿透"删除按钮、
-     * 让 ✕ 难以点中。只响应 canvas 上的指针事件即可彻底隔离 UI 与画布。
+     * Whether the event target is the WebGL canvas inside the container.
+     * Only accept the canvas: panels (GUIDE / control panel / the ✕ buttons in the annotation list)
+     * are all children of the container, so checking contains alone would treat clicks on the panels
+     * as drawing on the model — which "leaks through" the delete buttons and makes ✕ hard to click.
+     * Responding only to pointer events on the canvas fully isolates the UI from the drawing surface.
      */
     private insideContainer;
     private onPointerDown;
-    /** 射线拾取进行中的锚点小球,返回锚点下标;未命中返回 -1。 */
+    /**
+     * Pick an in-progress anchor: return the index of the nearest anchor (screen pixel distance <
+     * tolerance), or -1 on a miss.
+     *
+     * Uses "screen-space pixel distance" instead of ray/sphere intersection: the anchor spheres are
+     * tiny, so strict ray/sphere hits require pixel-perfect aiming and most clicks miss — and a miss
+     * falls through to the "add anchor" branch, so trying to delete a point ends up adding one. That
+     * was the root cause of the old "deleting a point takes several clicks, must hit the sphere dead
+     * center" problem. Projecting each anchor to the screen and taking the nearest within tolerance
+     * makes deletion stable and reliable. The tolerance is enlarged relative to the sphere's screen
+     * radius to make it easy to hit.
+     */
     private pickGeoMarker;
-    /** 设置当前悬停的锚点(-1 = 无):更新高亮缩放、光标与"✕(可取消)"悬浮标。 */
+    /** Set the currently hovered anchor (-1 = none): update highlight scale, cursor, and the "✕ (cancel)" floating badge. */
     private setGeoHover;
-    /** 懒创建悬浮 ✕ 标(挂在 container 内,pointer-events:none 不挡点击)。 */
+    /** Lazily create the floating ✕ badge (appended inside the container, pointer-events:none so it doesn't block clicks). */
     private ensureGeoBadge;
-    /** 把 ✕ 标定位到锚点投影到屏幕的位置(正中心,即光标悬停处,避免歧义)。 */
+    /** Position the ✕ badge at the anchor's screen projection (dead center, i.e. where the cursor hovers, to avoid ambiguity). */
     private positionGeoBadge;
-    /** 据当前锚点重建可见的锚点小球(锚点比放点稍大,便于看见与点中取消)。 */
+    /** Rebuild the visible anchor spheres from the current anchors (slightly larger than placed points, so they're easy to see and click to cancel). */
     private rebuildGeoMarkers;
-    /** 据当前锚点重画进行中的测地线(不闭合);不足两点时移除线。 */
+    /** Redraw the in-progress geodesic from the current anchors (not closed); remove the line when fewer than two points. */
     private redrawGeoLine;
-    /** 丢弃进行中的测地线:移除并 dispose 线与全部锚点。 */
+    /** Discard the in-progress geodesic: remove and dispose the line and all anchors. */
     private clearActiveGeo;
-    /** 移除进行中测地线的全部锚点小球(落定后调用:只留下线)。 */
+    /** Remove all anchor spheres of the in-progress geodesic (called after committing: only the line remains). */
     private removeGeoMarkers;
     private onPointerMove;
     private onPointerUp;
     private closeLastContour;
-    /** 沿网格表面求 a→b 的测地路径(local 顶点),去掉与 a 重合的首点。a/b 已是 local。 */
+    /** Compute the geodesic path a→b along the mesh surface (local vertices), dropping the first point that coincides with a. a/b are already local. */
     private surfacePathBetween;
-    /** 结束当前测地线:闭合成环并落定为一条 contour。 */
+    /** Finish the current geodesic: close it into a ring and commit it as one contour. */
     private finishGeodesic;
     private isTypingTarget;
     private onKeyDown;

package/dist/Utils/surfaceAnnotation/SurfaceAnnotator.js

@@ -11,13 +11,14 @@ import { mergeVertices } from "three/examples/jsm/utils/BufferGeometryUtils";
 const LINE_W = 3;
 const LINE_W_SEL = 6;
 /**
- * 表面标注主控制器(Phase 4):navigate / freehand / geodesic / point 四模式,
- * Enter 闭合,数据交给 AnnotationStore 管理(多条带颜色标签、撤销/删除/清空、导出)。
- * 渲染层据 store.list() 做场景对账(reconcile),撤销/删除自动加/移 three 对象。
+ * Main surface-annotation controller (Phase 4): four modes navigate / freehand / geodesic / point,
+ * Enter closes the loop, and data is managed by AnnotationStore (multiple color-labeled strips,
+ * undo/delete/clear, export).
+ * The render layer reconciles the scene against store.list(); undo/delete automatically add/remove three objects.
  */
 export class SurfaceAnnotator {
     constructor(opts) {
-        var _a, _b;
+        var _a, _b, _c;
         this.mode = "navigate";
         this.spaceHeld = false;
         this.pointerDown = false;
@@ -25,12 +26,12 @@ export class SurfaceAnnotator {
         this.managed = new Set();
         this.seq = 0;
         this.selectedId = null;
-        this.activeGeoMarkers = []; // 进行中测地线的可见锚点
+        this.activeGeoMarkers = []; // visible anchors of the in-progress geodesic
         this.geoRay = new THREE.Raycaster();
         this.geoNdc = new THREE.Vector2();
         this.hoveredGeoMarker = -1;
         this._projV = new THREE.Vector3();
-        /** 窗口尺寸变化时更新所有 fat line 的像素分辨率,否则线宽会失真。 */
+        /** Update the pixel resolution of all fat lines on window resize, otherwise line width distorts. */
         this.onResize = () => {
             const w = this.o.container.clientWidth;
             const h = this.o.container.clientHeight;
@@ -49,7 +50,7 @@ export class SurfaceAnnotator {
             if (this.spaceHeld)
                 return;
             if (e.button !== 0)
-                return; // 仅左键
+                return; // left button only
             if (!this.insideContainer(e))
                 return;
             this.pointerDown = true;
@@ -84,7 +85,7 @@ export class SurfaceAnnotator {
                 return;
             }
             if (this.mode === "geodesic") {
-                // 先判断是否点中了一个已有锚点 → 取消该点(支持取消其中任意一点)。
+                // First check whether an existing anchor was clicked → cancel that point (any point can be canceled).
                 const pick = this.pickGeoMarker(e);
                 if (pick >= 0 && this.activeGeo) {
                     this.activeGeo.removeAnchorAt(pick);
@@ -96,7 +97,7 @@ export class SurfaceAnnotator {
                     }
                     return;
                 }
-                // 否则在表面落一个新锚点。
+                // Otherwise drop a new anchor on the surface.
                 const h = this.hit(e);
                 if (!h)
                     return;
@@ -114,7 +115,7 @@ export class SurfaceAnnotator {
                 this.setGeoHover(-1);
                 return;
             }
-            // 测地线模式下,悬停到锚点小球时显示"✕"提示(该点可被点击取消)。
+            // In geodesic mode, show the "✕" hint when hovering an anchor sphere (that point can be clicked to cancel).
             if (this.mode === "geodesic" && !this.pointerDown) {
                 this.setGeoHover(this.insideContainer(e) ? this.pickGeoMarker(e) : -1);
             }
@@ -179,7 +180,7 @@ export class SurfaceAnnotator {
                 return;
             }
             if (e.key === "Enter") {
-                // 测地线进行中 → 结束并闭合;否则闭合最近一条自由手绘线。
+                // Geodesic in progress → finish and close it; otherwise close the most recent freehand line.
                 if (this.activeGeo)
                     this.finishGeodesic();
                 else
@@ -204,24 +205,25 @@ export class SurfaceAnnotator {
         this.o = opts;
         const meshGeo = opts.mesh.geometry;
         if (!meshGeo.getAttribute("normal"))
-            meshGeo.computeVertexNormals(); // 渲染需要法线
+            meshGeo.computeVertexNormals(); // rendering needs normals
         meshGeo.computeBoundingBox();
         const diag = (_a = opts.bboxDiagonal) !== null && _a !== void 0 ? _a : meshGeo.boundingBox.getSize(new THREE.Vector3()).length();
         this.markerRadius = (_b = opts.markerRadius) !== null && _b !== void 0 ? _b : diag * 0.0032;
-        this.epsilon = diag * 0.002;
+        this.epsilon = (_c = opts.epsilon) !== null && _c !== void 0 ? _c : diag * 0.002;
         this.minGap = diag * 0.004;
         this.maxJump = diag * 0.05;
-        // 测地线连通性:单独焊接一份"仅位置"的几何给 MeshGraph 用——
-        // 不动被渲染的 mesh(保留其法线/UV/纹理)。仅位置可保证同表面位置的顶点
-        // 被 mergeVertices 合并(否则逐面法线/UV 会阻止合并,图断裂 → 闭合穿模)。
+        // Geodesic connectivity: weld a separate "position-only" geometry for MeshGraph to use —
+        // leaving the rendered mesh untouched (keeping its normals/UV/texture). Position-only ensures
+        // vertices at the same surface position get merged by mergeVertices (otherwise per-face
+        // normals/UV would block the merge, breaking the graph → the closed loop cuts through the model).
         const posOnly = new THREE.BufferGeometry();
         posOnly.setAttribute("position", meshGeo.getAttribute("position").clone());
         const graphGeo = mergeVertices(posOnly);
         graphGeo.computeVertexNormals();
         this.graph = new MeshGraph(graphGeo);
         this.store.subscribe(() => this.reconcile());
-        // 监听挂到 window 的捕获阶段(capture=true):在 copper 的 TrackballControls
-        // 之前拿到每一个指针事件,避免它的 setPointerCapture / 事件路由导致拖拽中途丢 move。
+        // Listen on window in the capture phase (capture=true): receive every pointer event before
+        // copper's TrackballControls, so its setPointerCapture / event routing doesn't drop moves mid-drag.
         window.addEventListener("pointerdown", this.onPointerDown, true);
         window.addEventListener("pointermove", this.onPointerMove, true);
         window.addEventListener("pointerup", this.onPointerUp, true);
@@ -242,13 +244,13 @@ export class SurfaceAnnotator {
         var _a;
         return (_a = this.o.pointColor) !== null && _a !== void 0 ? _a : "#ffd166";
     }
-    // ---- 对外 API(供 Vue 调用) ----
+    // ---- Public API (called from Vue) ----
     getMode() {
         return this.mode;
     }
     setMode(m) {
         var _a, _b;
-        // 离开测地线模式时丢弃尚未 Enter 落定的进行中测地线(清掉残留的锚点与线)。
+        // When leaving geodesic mode, discard the in-progress geodesic not yet committed with Enter (clear leftover anchors and line).
         if (m !== "geodesic" && this.activeGeo)
             this.clearActiveGeo();
         this.mode = m;
@@ -258,13 +260,13 @@ export class SurfaceAnnotator {
     getStore() {
         return this.store;
     }
-    /** 当前标注列表快照。 */
+    /** Snapshot of the current annotation list. */
     getAnnotations() {
         return this.store.list();
     }
     undo() {
-        // 测地线进行中 → 撤销最近一次锚点编辑(加点 / 取消点都能回退);
-        // 否则撤销最近一条已落定的标注。
+        // Geodesic in progress → undo the most recent anchor edit (both adding and canceling a point can be rolled back);
+        // otherwise undo the most recently committed annotation.
         if (this.activeGeo && this.activeGeo.canUndo()) {
             this.activeGeo.undoEdit();
             if (this.activeGeo.anchorCount === 0)
@@ -298,7 +300,7 @@ export class SurfaceAnnotator {
         this.selectedId = id;
         this.applySelection();
     }
-    /** 颜色变更后重画对应 three 对象。 */
+    /** Redraw the corresponding three object after a color change. */
     refreshAnnotation(id) {
         const a = this.store.get(id);
         if (!a || !a.object3D)
@@ -314,12 +316,12 @@ export class SurfaceAnnotator {
     exportJSON(modelName, opts) {
         return this.store.toJSON(modelName, this.o.mesh, opts);
     }
-    // ---- 内部 ----
+    // ---- Internal ----
     applyCameraGating() {
-        // 按住 Space 临时旋转优先;否则仅 navigate 模式开相机。
+        // Holding Space for temporary rotation takes priority; otherwise enable the camera only in navigate mode.
         this.o.controls.enabled = this.spaceHeld || this.mode === "navigate";
     }
-    /** 据 store.list() 对账场景:补齐缺失对象、移除已删对象(不 dispose,留给撤销恢复)。 */
+    /** Reconcile the scene against store.list(): add missing objects, remove deleted ones (no dispose, kept for undo restore). */
     reconcile() {
         var _a, _b;
         const present = new Set();
@@ -369,29 +371,53 @@ export class SurfaceAnnotator {
         return raycastSurface(this.o.camera, this.o.container, this.o.mesh, e.clientX, e.clientY);
     }
     /**
-     * 事件目标是否是容器内的 WebGL canvas。
-     * 仅认 canvas:面板(GUIDE / 控制面板 / 标注列表的 ✕ 按钮)都是 container 的子元素,
-     * 若只判断 contains 会把面板上的点击也当成在模型上作画 —— 这会"穿透"删除按钮、
-     * 让 ✕ 难以点中。只响应 canvas 上的指针事件即可彻底隔离 UI 与画布。
+     * Whether the event target is the WebGL canvas inside the container.
+     * Only accept the canvas: panels (GUIDE / control panel / the ✕ buttons in the annotation list)
+     * are all children of the container, so checking contains alone would treat clicks on the panels
+     * as drawing on the model — which "leaks through" the delete buttons and makes ✕ hard to click.
+     * Responding only to pointer events on the canvas fully isolates the UI from the drawing surface.
      */
     insideContainer(e) {
         const t = e.target;
         return !!t && t.tagName === "CANVAS" && this.o.container.contains(t);
     }
-    /** 射线拾取进行中的锚点小球,返回锚点下标;未命中返回 -1。 */
+    /**
+     * Pick an in-progress anchor: return the index of the nearest anchor (screen pixel distance <
+     * tolerance), or -1 on a miss.
+     *
+     * Uses "screen-space pixel distance" instead of ray/sphere intersection: the anchor spheres are
+     * tiny, so strict ray/sphere hits require pixel-perfect aiming and most clicks miss — and a miss
+     * falls through to the "add anchor" branch, so trying to delete a point ends up adding one. That
+     * was the root cause of the old "deleting a point takes several clicks, must hit the sphere dead
+     * center" problem. Projecting each anchor to the screen and taking the nearest within tolerance
+     * makes deletion stable and reliable. The tolerance is enlarged relative to the sphere's screen
+     * radius to make it easy to hit.
+     */
     pickGeoMarker(e) {
         if (!this.activeGeoMarkers.length)
             return -1;
         const rect = this.o.container.getBoundingClientRect();
-        this.geoNdc.x = ((e.clientX - rect.left) / rect.width) * 2 - 1;
-        this.geoNdc.y = -((e.clientY - rect.top) / rect.height) * 2 + 1;
-        this.geoRay.setFromCamera(this.geoNdc, this.o.camera);
-        const hits = this.geoRay.intersectObjects(this.activeGeoMarkers, false);
-        if (!hits.length)
-            return -1;
-        return this.activeGeoMarkers.indexOf(hits[0].object);
+        const px = e.clientX - rect.left;
+        const py = e.clientY - rect.top;
+        const TOL = 16; // hit tolerance (pixels), larger than the sphere itself for forgiving clicks
+        let best = -1;
+        let bestDist = TOL;
+        const v = this._projV;
+        for (let i = 0; i < this.activeGeoMarkers.length; i++) {
+            v.copy(this.activeGeoMarkers[i].position).project(this.o.camera);
+            if (v.z > 1)
+                continue; // projects behind the camera, skip
+            const sx = (v.x * 0.5 + 0.5) * rect.width;
+            const sy = (-v.y * 0.5 + 0.5) * rect.height;
+            const d = Math.hypot(sx - px, sy - py);
+            if (d < bestDist) {
+                bestDist = d;
+                best = i;
+            }
+        }
+        return best;
     }
-    /** 设置当前悬停的锚点(-1 = 无):更新高亮缩放、光标与"✕(可取消)"悬浮标。 */
+    /** Set the currently hovered anchor (-1 = none): update highlight scale, cursor, and the "✕ (cancel)" floating badge. */
     setGeoHover(idx) {
         if (idx === this.hoveredGeoMarker) {
             if (idx >= 0)
@@ -415,7 +441,7 @@ export class SurfaceAnnotator {
             this.o.container.style.cursor = "";
         }
     }
-    /** 懒创建悬浮 ✕ 标(挂在 container 内,pointer-events:none 不挡点击)。 */
+    /** Lazily create the floating ✕ badge (appended inside the container, pointer-events:none so it doesn't block clicks). */
     ensureGeoBadge() {
         if (this.geoHoverBadge)
             return this.geoHoverBadge;
@@ -443,7 +469,7 @@ export class SurfaceAnnotator {
         this.geoHoverBadge = b;
         return b;
     }
-    /** 把 ✕ 标定位到锚点投影到屏幕的位置(正中心,即光标悬停处,避免歧义)。 */
+    /** Position the ✕ badge at the anchor's screen projection (dead center, i.e. where the cursor hovers, to avoid ambiguity). */
     positionGeoBadge(marker) {
         if (!marker)
             return;
@@ -455,7 +481,7 @@ export class SurfaceAnnotator {
         b.style.left = `${x}px`;
         b.style.top = `${y}px`;
     }
-    /** 据当前锚点重建可见的锚点小球(锚点比放点稍大,便于看见与点中取消)。 */
+    /** Rebuild the visible anchor spheres from the current anchors (slightly larger than placed points, so they're easy to see and click to cancel). */
     rebuildGeoMarkers() {
         this.setGeoHover(-1);
         for (const m of this.activeGeoMarkers) {
@@ -471,7 +497,7 @@ export class SurfaceAnnotator {
             this.activeGeoMarkers.push(marker);
         }
     }
-    /** 据当前锚点重画进行中的测地线(不闭合);不足两点时移除线。 */
+    /** Redraw the in-progress geodesic from the current anchors (not closed); remove the line when fewer than two points. */
     redrawGeoLine() {
         if (!this.activeGeo)
             return;
@@ -492,7 +518,7 @@ export class SurfaceAnnotator {
             updateContourLine(this.activeGeoLine, verts, false, this.epsilon, this.o.mesh);
         }
     }
-    /** 丢弃进行中的测地线:移除并 dispose 线与全部锚点。 */
+    /** Discard the in-progress geodesic: remove and dispose the line and all anchors. */
     clearActiveGeo() {
         this.setGeoHover(-1);
         if (this.activeGeoLine) {
@@ -507,7 +533,7 @@ export class SurfaceAnnotator {
         this.activeGeoMarkers = [];
         this.activeGeo = undefined;
     }
-    /** 移除进行中测地线的全部锚点小球(落定后调用:只留下线)。 */
+    /** Remove all anchor spheres of the in-progress geodesic (called after committing: only the line remains). */
     removeGeoMarkers() {
         this.setGeoHover(-1);
         for (const m of this.activeGeoMarkers) {
@@ -520,7 +546,7 @@ export class SurfaceAnnotator {
         const last = this.lastFreehand;
         if (!last || last.closed || last.vertices.length < 3 || !last.object3D)
             return;
-        // 用测地线沿表面把末点连回首点,避免直线弦从模型内部"抄近路"被遮挡。
+        // Use a geodesic along the surface to connect the last point back to the first, so a straight chord doesn't "shortcut" through the model interior and get occluded.
         const tail = last.vertices[last.vertices.length - 1];
         const head = last.vertices[0];
         const closing = this.surfacePathBetween(tail, head);
@@ -528,14 +554,14 @@ export class SurfaceAnnotator {
         last.closed = true;
         updateContourLine(last.object3D, last.vertices, true, this.epsilon, this.o.mesh);
     }
-    /** 沿网格表面求 a→b 的测地路径(local 顶点),去掉与 a 重合的首点。a/b 已是 local。 */
+    /** Compute the geodesic path a→b along the mesh surface (local vertices), dropping the first point that coincides with a. a/b are already local. */
     surfacePathBetween(a, b) {
         const va = this.graph.nearestVertex(new THREE.Vector3(a.x, a.y, a.z));
         const vb = this.graph.nearestVertex(new THREE.Vector3(b.x, b.y, b.z));
         const path = this.graph.shortestPath(va, vb);
         return path.slice(1).map((i) => this.graph.vertexLocal(i));
     }
-    /** 结束当前测地线:闭合成环并落定为一条 contour。 */
+    /** Finish the current geodesic: close it into a ring and commit it as one contour. */
     finishGeodesic() {
         if (!this.activeGeo || !this.activeGeoLine)
             return;
@@ -559,7 +585,7 @@ export class SurfaceAnnotator {
             this.o.scene.remove(this.activeGeoLine);
             this.disposeObject(this.activeGeoLine);
         }
-        // 落定后清掉可见锚点,只留下贴合表面的线。
+        // After committing, clear the visible anchors and leave only the surface-hugging line.
         this.removeGeoMarkers();
         this.activeGeo = undefined;
         this.activeGeoLine = undefined;