gis-view-webgl2 0.1.1 → 0.1.2

package/docs/manual/18-/351/200/220/346/226/271/346/263/225/347/244/272/344/276/213.md

@@ -89,6 +89,12 @@ view.updateChannel('c1', { name: '东干线' }, [
 ], ['l1', 'l2'])                                       // 表里没有了的旧成员直接从数据里删掉（要只移出用 removeChannelLines）
 view.updateChannel('c1', {}, [{ id: 'l1', width: 4 }]) // 只传线路数组：只改成员回线的字段，数量不动
 
+// setFeatureVisible(kind, refs, visible) / hideFeatures(kind, refs) / showFeatures(kind, refs)：只改 visible，不删数据
+const hiddenChannel = view.hideFeatures('channel', 'c1')  // 'point' / 'line' / 'channel'，refs 单个 / 数组 / 'selection'
+view.showFeatures('channel', 'c1')                        // 成员回线、分组、拐点原样回来
+view.setFeatureVisible('point', ['a', 'b'], false)        // 一批节点一次收起（一条历史、一条 batch）
+console.log(hiddenChannel.ok, hiddenChannel.indexes, hiddenChannel.skipped)
+
 // 整份换通道声明（与 updateChannel 的分工：这条全换、点不出某一条）
 view.updateData({ channels: [{ id: 'c1', lineIds: ['l1', 'l2'] }, { id: 'c2', from: 'a', to: 'b' }] })
 
@@ -372,6 +378,13 @@ const mergedCustom = view.mergePoints('a', 'b', { item: { name: '合并结果',
 const mergedAll = view.mergeSelectedPoints()
 view.mergeSelectedPoints({ target: 'b', sources: ['a', 'c'], force: true })
 
+// splitPoint(source, parts, options?)：把一个节点拆成多份（mergePoints 的逆操作）
+const splitResult = view.splitPoint('a', [
+  { x: 0, y: 0, name: '甲站（主）' },                    // 第一份沿用原下标 / id
+  { x: 80, y: 40, name: '甲站（东）', lines: ['l1'] }    // 显式分给第二份；未分配的线路跟第一份
+], { label: '拆分甲站' })
+console.log(splitResult.pointIds, splitResult.linesChanged, splitResult.changes)
+
 // getPointMerge() / resolvePointMerge(confirmed?, options?) / commitPointMerge() / revertPointMerge()
 const pendingMerge = view.getPointMerge()              // 待确认的那一份载荷（没有就是 null）
 console.log(pendingMerge?.impact?.lineCount)           // 这次合并会影响几条线路（改写 + 删除，按线路去重）
@@ -430,6 +443,21 @@ const groups = view.getChannelGroups('c1')
 const allGroups = view.getChannelGroups()
 const groupWaypoints = view.getChannelGroupWaypoints('c1', 'c1::2')
 
+// getChangedChannels(options?) / clearChangedChannels(refs?)：通道变化对账
+view.updateChannel('c1', { name: '东干线' })
+view.addChannelGroupWaypoint('c1', 'c1', [200, 120])       // 拐点变化入账（单组通道的组 id 就是通道 id）
+const changedChannels = view.getChangedChannels()          // [{ index, id, item, groups, reasons, … }]
+console.log(changedChannels[0]?.reasons)                    // ['waypoints'] / ['members'] / ['visibility']…
+const waypointOnly = view.getChangedChannels({ reasons: ['waypoints'], ignoreGroups: true })
+view.clearChangedChannels('c1')                            // 发完接口对账这一条；不传 = 全部对账
+
+// getChangedLines(options?) / clearChangedLines(refs?)：只有节点和线路时也能独立对账
+view.updateLine('l1', { name: '东联络线' })
+const changedLines = view.getChangedLines()                 // [{ index, id, item, path, from, to, reasons, … }]
+console.log(changedLines[0]?.reasons)                       // ['fields'] / ['path'] / ['endpoints'] / ['visibility']
+const pathOnly = view.getChangedLines({ reasons: ['path'] })
+view.clearChangedLines('l1')                               // 发完接口对账这一条；不传 = 全部对账
+
 // getChannelContext(channelId?, groupId?)：右键交互框那一份读数（含 actions 与各自能不能点）
 const channelContext = view.getChannelContext('c1')
 const groupContext = view.getChannelContext('c1', 'c1::2')

package/docs/manual/20-/346/200/247/350/203/275/344/270/216/345/244/247/346/225/260/346/215/256.md

@@ -34,6 +34,7 @@ view.updateOptions({ denseMode: 'off' })   // 手动退出
 
 10 万点 + 10 万线（含通道）在 `docs/demos/GisViewDemo.vue` 里可以直接切到，交互路径上没有按总量线性增长的循环：
 
+- **高密度纯文本标签自动画布化**：强制显示档（`labelOptimize` 未开、`denseMode` 未激活）下，节点层或线路层里能画布的纯文本标签达到 **1024** 条时，默认 `labelRender: 'auto'` 会让该层改用一张 `.gis-view__label-canvas`，不再为每条标签建 `div`。HTML、函数返回元素、可拖拽 / 可编辑及超出 Canvas 样式能力的标签仍留在同层 DOM，因此画布与少量 DOM 可以混排；`labelRender: 'dom'` 可强制回退逐条 DOM。优化档 / 密集档仍走 DOM（避让、截断与命中判定要真实量尺寸），这一步不是它们的替代品。`selftest-labels.html` 用 1100 条纯文本验证了点标签层只剩一张画布、混入一条 `html: true` 时只保留那一条 DOM，并覆盖切回 `dom`、再切回 `auto` 的节点回收与 SVG 导出。
 - 拾取与框选共用网格索引：点走按数据范围重建的均匀网格，线走随线段重建的 `createSegmentGrid`，每次交互只遍历光标附近的候选，耗时与总量基本脱钩，`getStats().pickMs` 是随手可读的实测值（10 万规模下热态约 0.2 ~ 0.3 ms / 次）。线段按格线步进登记进它真正穿过的格子（早期按包围盒填格，一条斜跨全图的线会占掉上万格、只好整条丢进「超长线」单，而十万条线里绝大多数都是这种，于是每次拾取都要重算十万条的距离）；剩下的长线只记一条包围盒，查询时按盒子先筛一遍。10 万点 / 10 万线的合成数据里（随机配对、长线极密），500 次 `pick` 从 3530 ms 降到 164 ms（0.3 ms / 次）。
 - 拖动时「哪些线跟着这个点走」按需建索引：`collectDragLinks` 从前每次都把全部线路的端点与组内成员逐个比一遍，10 万点 / 12 万线下这一步占总 CPU 的 27%，是拖动路径上唯一还按总量线性付费的循环。现在线路超过 `LINE_BIND_TOLERANCE_SCAN_LIMIT`（2048）条时改用一张线路归属表（按 `from` / `to` 的 id 与端点坐标建，整份换数据 / 增删线 / 改绑定才重建，只改坐标就地把那一条换掉），只对命中的候选逐字段判定 —— 十万级拖动降到 CPU 的 1% 以下，单条 `updatePoint`（改名这类不动几何的改动）55 → 3.3 ms（稳态 0.02 ms）。线路不多时保留原来的浮点容差扫描（行为与从前逐字不差）；索引那条路只认 id 绑定与坐标精确相等 —— 这个量级坐标都是同一份来源算出来的，容差是给手写数据留的余量。
 - 视口里的线路改走线段网格：线路标签排版这类「只看屏幕里这一片」的路径（`forEachLineInView`）原先要把每条线的包围盒过一遍，10 万级 + 标签的 CPU profile 里它占 47 ~ 58%。现在线路超过 `LINE_VIEW_GRID_MIN_LINES`（2048）条、且估计出来的候选线段只占总数的 1/32 以内（`LINE_VIEW_GRID_COST_SHARE`）时改查拾取用的那张线段网格，再逐条按包围盒确认；候选排回要素下标顺序，脏线与没有线段的退化线单独补一遍，访问顺序与判定口径与整份扫描逐行相同。网格脏着（正在拖线 / 改线）或线路不多时照旧整份扫描。
@@ -118,6 +119,8 @@ view.updateOptions({ denseMode: 'off' })   // 手动退出
 
 再往后一轮继续收紧**优化档的节点标签候选**：数据前部经常是一大簇同屏节点，旧顺序会先收满 `scanLimit` 个候选，后面散开的节点一个标签都轮不到。现在优化档先按 32px 屏幕小格去重（同格只留一条主候选），再按 160px 粗格限流（每格最多 3 条主候选），其余节点进补位队列；主队列按屏幕行列排，密集簇被压成少量代表之后，扫描名额能落到整个视口。补位候选只在主候选被避让丢掉时接上，所以不会改变「先铺开、再补位」的优先级。缺省强制显示档完全不走这两层筛选与补位：`maxCount` / `scanLimit` / `avoidOverlap` 仍不生效，同格的每条标签都画。专项自测用「前 900 个同格点 + 后 12 个散点、maxCount 8 / scanLimit 24」验证散点仍有标签、总数不超上限且互不重叠，另有 24 个同格点在强制显示档全部画出的回归。
 
+**标签内容的写入也按“哪一项真的变了”拆开**：`paintLabel` 原来把 class、dataset、内容、内联样式合成一份签名，改字号或只换锚点都会把同一段 HTML 重新 `innerHTML` 一遍。现在分四类比较：class、内联样式、内容（`html` 标志 + 最终字符串）、尺寸签名；只有内容变化才写 DOM，样式变化只改 `style`，位置变化只改 `transform`。尺寸缓存键去掉下标与标签 id，只留 `kind` / `className` / `inline style` / `content`，同一屏上 120 条同文案 HTML 标签首次排版共用一次量测，批量循环里也会当场命中刚写入的缓存。自测页直接统计标签节点的 `getBoundingClientRect`：120 条同内容标签首轮真实布局读取 ≤ 4 次（旧写法逐条读约 120 次）；只改字号时 HTML 子节点身份保持不变，`innerHTML` 写入为 0。内容本身确实变了（例如每条文案都不同）时仍要逐条解析 HTML，这部分是浏览器必须付的成本，能靠 `style` / `className` 做外观时不要改内容。
+
 覆盖层的**区域文字**（GeoJSON 的 `label`）也按同样的思路收紧：`overlay.js` 现在按数组下标复用 DOM 节点，文字 / 字号 / 字体 / 颜色等样式签名没变时，只调整 `transform`；同一相机重复刷新连 `display` 与 `transform` 都不再写。签名用 `JSON.stringify([...])` 而不是分隔符拼串，避免文字本身含 `|` / `~` 时两份不同内容被判成同一份；单条样式变化只改那一条并作废它的尺寸缓存，不再整层删除重建。相机事件在同一帧连发时统一并到下一帧，12 次 `cameraChange` 只触发 1 次重投影；同一份底图重新下发时另有一份锚点签名兜底 —— 样式没变但 `x` / `y` / 偏移变了照样重投影，完全没变才跳过这一帧。离屏节点上一次的 `display` / `transform` 状态会保留，样式更新后回到视野仍能正常恢复显示。鹰眼图的视口框同样缓存上一次写出的 `transform` / 宽 / 高，位置与尺寸都没变时直接返回，不碰 `style`。这两处的读取口径也统一了：引擎尚未创建时，覆盖层、鹰眼图、`getViewport()` 与 `getViewState().viewport` 共用同一个 `fallbackViewport()`，`pixelRatio` 不再一处是 1、另一处是 `devicePixelRatio`。
 
 鹰眼图这一轮补了两个开销边界：`maxPixelRatio` 把备份倍率封在 1 ~ 4（默认 4），实际倍率取 `devicePixelRatio × 宿主显示比例` 与该上限的较小值，高分屏 / 宿主放大时不再无限增加填充像素；小图容器加 `contain: layout paint` 与 `isolation: isolate`，布局与重绘留在自身。扩展内容改由 `layers` 按 `order` 分层执行，每层独立 `save` / `restore`，旧的单层 `draw` 仍兼容并最后执行 —— 多个业务标记可以各自维护，不会互相串改画布状态。

package/docs/manual/21-/350/257/264/346/230/216/344/270/216/345/270/270/350/247/201/351/227/256/351/242/230.md

@@ -176,7 +176,7 @@
 | 覆盖层 | `GisViewLabelOptions`、`GisViewLineLabelOptions`、`GisViewItemLabel`、`GisViewLabelState`、`GisViewLabelPatch`、`GisViewSetLabelContentOptions`、`GisViewLabelListItem`、`GisViewItemLabelsInfo`、`GisViewRemoveLabelResult`、`GisViewSetLabelStatesResult`、`GisViewLabelChangePayload`、`GisViewLabelDragPayload`、`GisViewLabelClickPayload`、`GisViewLabelPointerPayload`、`GisViewLabelRef`、`GisViewLabelTarget`、`GisViewLabelBatchEntry`、`GisViewLabelRemoveEntry`、`GisViewLabelBatchSkip`、`GisViewAddLabelsResult`、`GisViewUpdateLabelsResult`、`GisViewRemoveLabelsResult`、`GisViewLineDecoration`、`GisViewTooltipOptions`、`GisViewLabelPayload`、`GisViewLineLabelPayload` |
 | 筛选 | `GisViewFilter`、`GisViewFilterResult`、`GisViewFilterCascade`、`GisViewFilterWorkerOptions` |
 | 大数据展示模式 | `GisViewDenseMode`、`GisViewDenseModeOptions`、`GisViewDenseModeInput`、`GisViewDenseState` |
-| 通道 | `GisViewChannelInput`、`GisViewChannelBuildOptions`、`GisViewChannelBuild`、`GisViewChannelInfo`、`GisViewChannelGroupInfo`、`GisViewChannelGroupWaypoints`、`GisViewChannelGroupLineWaypoints`、`GisViewChannelMember`、`GisViewChannelContext`、`GisViewChannelContextPayload`、`GisViewChannelAddPlan`、`GisViewChannelBetween`、`GisViewChannelAddOption`、`GisViewChannelAddInput`、`GisViewChannelAddResult`、`GisViewChannelDraftOptions`、`GisViewChannelDraftPayload`、`GisViewChannelLineMoveTarget`、`GisViewChannelLineMoveResult`、`GisViewRemoveLineResult`、`GisViewRemoveChannelResult`、`GisViewRemoveLinesResult`、`GisViewChannelInView`、`GisViewChannelAction`、`GisViewChannelActionId`、`GisViewChannelDraftStyle`、`createChannels`、`CHANNEL_DEFAULT_COLORS` |
+| 通道 | `GisViewChannelInput`、`GisViewChannelBuildOptions`、`GisViewChannelBuild`、`GisViewChannelInfo`、`GisViewChannelGroupInfo`、`GisViewChannelGroupWaypoints`、`GisViewChannelGroupLineWaypoints`、`GisViewChannelMember`、`GisViewChannelContext`、`GisViewChannelContextPayload`、`GisViewChannelAddPlan`、`GisViewChannelBetween`、`GisViewChannelAddOption`、`GisViewChannelAddInput`、`GisViewChannelAddResult`、`GisViewChannelDraftOptions`、`GisViewChannelDraftPayload`、`GisViewChannelLineMoveTarget`、`GisViewChannelLineMoveResult`、`GisViewRemoveLineResult`、`GisViewRemoveChannelResult`、`GisViewRemoveLinesResult`、`GisViewChannelInView`、`GisViewChannelAction`、`GisViewChannelActionId`、`GisViewChannelDraftStyle`、`GisViewChannelWaypointDragMode`、`createChannels`、`CHANNEL_DEFAULT_COLORS` |
 | 事件载荷 | `GisViewPickResult`、`GisViewPickAtResult`、`GisViewRectQueryResult`、`GisViewSelectionInfo`、`GisViewSelectedItems`、`GisViewSelectPayload`、`GisViewClickPayload`、`GisViewPointerPayload`、`GisViewPointerAction`、`GisViewPointerActionType`、`GisViewPointerTarget`、`GisViewPointerModifiers`、`GisViewWaypointActionData`、`GisViewLabelActionData`、`GisViewHoverPayload`、`GisViewCursorPayload`、`GisViewPointDragPayload`、`GisViewDragPointChange`、`GisViewDragLineChange`、`GisViewPointCopyPayload`、`GisViewPointCopyState`、`GisViewPointMergePayload`、`GisViewMergeImpact`、`GisViewMergeResult`、`GisViewMergeFailure`、`GisViewWaypointPayload`、`GisViewWaypointInfo`、`GisViewWaypointKey`、`GisViewParallelGroup`、`GisViewReadyPayload`、`GisViewEngineStats`、`GisViewEngineHeatDensity`、`GisViewDataChangeType`、`GisViewDataChangePayload`、`GisViewSelectChangePayload`、`GisViewShortcutPayload`、`GisViewRenderPayload`、`GisViewAddItemsResult`、`GisViewAddPointResult` |
 | 快捷键与复制 / 合并 / 删除 | `GisViewShortcuts`、`GisViewShortcut`、`GisViewShortcutAction`、`GisViewCopyOptions`、`GisViewCopyContext`、`GisViewCopyStartOptions`、`GisViewPasteOptions`、`GisViewCopyItem`、`GisViewClipboardItem`、`GisViewMergeOptions`、`GisViewMergeContext`、`GisViewPointStyleSnapshot`、`GisViewPointRef`、`GisViewMergeResult`、`GisViewMergeFailure`、`GisViewMergeOutcome`、`GisViewRemovePointsOutcome`、`GisViewRemoveSelectedOutcome`、`GisViewRemoveOptions`、`GisViewRemoveScope`、`GisViewRemovePayload`、`GisViewRemoveResult`、`GisViewRemoveOutcome`、`GisViewRemoveFailure`、`GisViewRemoveAction`、`GisViewRemovePoint`、`GisViewRemoveLine`、`GisViewRemoveWaypoint`、`GisViewRemoveGroup`、`GisViewRemoveChannel`、`GisViewRemoveCounts`、`GisViewChannelSelectMode`、`GisViewUpdateItemsOutcome`、`GisViewUpdateItemEntry` |
 | 相机与视图 | `GisViewCamera`、`GisViewViewport`、`GisViewFocusOptions`、`GisViewFocusTarget`、`GisViewExportImageOptions`、`GisViewExportSelectionOptions`、`GisViewExportSelectionResult` |

package/docs/steps/README.md

@@ -16,11 +16,11 @@ npm run dev            # 或 npx vite
 控制台里 `__gisSteps.view` 就是当前这一步的视图，`__gisSteps.DATA` 是那份园区数据，可以随手调 API。
 地址栏里带步骤号（`index.html#7`）可以直接打开某一步，也能收藏 / 分享。
 
-自测页就在同一个目录下（`selftest.html` / `selftest-demo.html` / `selftest-demos.html` / `selftest-labels.html` / `selftest-select.html` / `selftest-actions.html` / `selftest-scale.html` / `selftest-perf.html` / `selftest-features.html` / `selftest-full.html` / `selftest-effects.html` / `selftest-data.html` / `selftest-decoration.html` / `selftest-docs.html`）：打开就跑，标题报 `PASS` / `FAIL`，页面上的清单是逐条断言。**无头环境下 `requestAnimationFrame` 基本不推进**，动画类断言要用真时间（CDP 或直接开浏览器）跑 —— `selftest-effects.html` 因此自己装了一个「帧泵」（把 `requestAnimationFrame` 收进 Map、手动按帧推进），涟漪与动点的断言才测得动。另有 docs/index.html（文档中心：把仓库里的 markdown 读成 HTML）、docs/api/index.html（API 速查：241 个实例成员逐个一张卡，参数 / 返回 / 说明 / 示例与复制，搜索 + `#成员名` 深链、左侧分组跟随与深浅主题）、docs/guide/sample-document.html（sample-document.json 的交互图解）与 docs/steps/selftest-docs.html（上面这三个页面的自测：清单 / 渲染 / 点选标注一页跑完）。
+自测页就在同一个目录下（`selftest.html` / `selftest-demo.html` / `selftest-demos.html` / `selftest-labels.html` / `selftest-select.html` / `selftest-actions.html` / `selftest-scale.html` / `selftest-perf.html` / `selftest-features.html` / `selftest-full.html` / `selftest-effects.html` / `selftest-data.html` / `selftest-decoration.html` / `selftest-docs.html`）：打开就跑，标题报 `PASS` / `FAIL`，页面上的清单是逐条断言。**无头环境下 `requestAnimationFrame` 基本不推进**，动画类断言要用真时间（CDP 或直接开浏览器）跑 —— `selftest-effects.html` 因此自己装了一个「帧泵」（把 `requestAnimationFrame` 收进 Map、手动按帧推进），涟漪与动点的断言才测得动。另有 docs/index.html（文档中心：把仓库里的 markdown 读成 HTML）、docs/api/index.html（API 速查：249 个实例成员逐个一张卡，参数 / 返回 / 说明 / 示例与复制，搜索 + `#成员名` 深链、左侧分组跟随与深浅主题）、docs/guide/sample-document.html（sample-document.json 的交互图解）与 docs/steps/selftest-docs.html（上面这三个页面的自测：清单 / 渲染 / 点选标注一页跑完）。
 
 ## 怎么查全部属性与方法
 
-组件的完整 API 是同一份清单的五个去处（当前：实例成员 **241** 个 = 238 个方法 + `el` / `canvas` / `gl` 三个属性，`options` **90** 个键，数据字段 **238** 个）：
+组件的完整 API 是同一份清单的五个去处（当前：实例成员 **249** 个 = 246 个方法 + `el` / `canvas` / `gl` 三个属性，`options` **92** 个键，数据字段 **245** 个）：
 
 - **手册里查**：`docs/manual/` 把整本手册拆成 21 章（索引页 `docs/GisView.md` 有目录与按任务的快速跳转）—— 找方法先看 [`16 实例方法总表`](../manual/16-实例方法总表.md)、要把每个成员逐个列全（参数写「名字: 类型 = 默认值」、返回值只写类型）看 [`17 参数速查`](../manual/17-参数速查.md)、要能直接复制的调用看 [`18 逐方法示例`](../manual/18-逐方法示例.md)；`options` 表与数据字段表分别在 [`03 配置项（options）`](../manual/03-配置项.md) 与 [`02 坐标与数据`](../manual/02-坐标与数据.md)。同名的接口在 `src/gis-view/types.d.ts`。
 - **页面上查**：`docs/api/index.html`（API 速查）—— 左栏按 16 个分组列出全部成员，带搜索（Ctrl+K）与方法 / 属性 / options 三档开关，当前读到的分组会跟着高亮；右栏每个成员一张卡，参数 / 返回 / 说明之外，示例块直接来自 [`18 逐方法示例`](../manual/18-逐方法示例.md)，带高亮与「复制名字 / 复制代码」，旁边还有「在调试页跑 →」；地址栏带 `#updateLine` 这样的 hash 直接跳到那一条。右上角主题按钮与文档中心共用 `gisDocs.reading`，跟随系统 / 浅色 / 深色三档换页不会各记一套；深链落点还留了 `scroll-margin-top`，不会被吸顶栏盖住。页面数据来自 `docs/demos/api-index.js`（生成物，禁止手改），自测页 `docs/steps/selftest-docs.html` 盯着它别掉队。
@@ -106,21 +106,23 @@ API 名字与前面几步是一一对应的；第 11 步再补两件「数据之
 - `selftest.html`：手写版第 1 ~ 9 步的断言（拾取、草稿的 step 1 / 2、落地、移除、连续新增、平移……）；
 - `selftest-full.html`：真组件上的同一套断言，外加把 `index.html` 的十三个步骤逐个挂载一遍（第 13 步再点一遍画质 / 批量 / 撤销 / 重做 / 功能预设五个按钮）；
   这一轮又补了四条：小图上的 GeoJSON 底图在主视图放大 3 倍前后红色描边像素数不变（容差 20%）、小图放大 6 倍时 `pointZoomScale` 指数 0 / 1 的像素对比（指数 1 至少 4 倍面积、指数 0 不长大，且倍数回到 1 时指数 1 也不再放大）、以及 stub host 上「拖节点没有结束事件、空闲计时器也会把 `hideOnInteract` 收起的标签层放出来」。
-- `selftest-features.html`（582 条）：真组件上的线型 / 线路装饰 / 光标 / 表现型配置断言 —— 把画面用 `exportImage` 读回 2D 画布数像素（实线 > 虚线 > 点线的墨量、`dc_line` 中点装饰的像素差、`showGrid` 只重画一帧），光标则用合成的指针事件与 Ctrl 键读出 `canvas.style.cursor`；装饰那几条还会量「几何变了装饰跟不跟着走」—— 写回新路径、拖绑定的节点、加 / 删拐点之后，装饰的紫色像素质心都要落在新中点上（容差 3px）；另外两条量的是**固定档**：`anchor: 'fixed'` + `at` 先把装饰钉在写死的世界坐标上，再把线从水平拖成斜的，装饰必须留在原坐标、不能跑到新中点。线路标签在单独一张画布上验：默认挂在中点、内容取 `name`，`position: 0` 落到起点，`hideOnInteract` 在缩放期间给整层加 `--hidden`、停手恢复，关掉 `lineLabel` 之后标签消失。装饰缺省 `auto` 的那一串也在这里量：没有拐点时拖端点装饰保持同一个比例（一直挂在中点）、加上拐点之后钉在那一刻的坐标上（改折线也不动）、把拐点删回直线又回到比例跟随、`anchor: 'follow'` 则一直跟到折线的新中点；`parallel` 用一条横条符号验（默认包围盒 26×6，平行之后转成 4×26），方形符号走的是 gl.POINTS 那条路（旋转后外接盒从 24×24 撑成 32×32）。通道里「每条回线各显示自己的标签」也在这里验：没有逐条配置时会被 32px 屏幕小格去重（只显示 1 ~ 2 条），给每条回线写上自己的 `lineLabelPosition` 之后 8 条全都在、位置各不相同，斜线上的标签按线路方向转、朝左的自动翻半圈（rotate = 0）。线路的层序（`zIndex`）也在这里验：画布正中一横一竖两条粗线交叉，默认后写的竖线在上（中心像素蓝），规则里给横线写 `zIndex: 5` 就换成红，`updateLine` 给竖线写 `zIndex: 9` 又换回蓝，写回 0 再回到红。这一轮另外验了插件上下文：`options.plugins` 与 `view.use()` 拿到的第二个参数是同一个冻结对象（`apiVersion === 1`、`view` 指回实例），旧的一参插件写法照常可用。这一轮另补 3 条合并触发时机断言（center 差 10px 不触发、继续拖入目标区域触发并带 trigger、collision 同距离照旧触发）。这一轮再补 1 条：13 个旧快捷方法已从实例删除，`updatePoint` / `updateLine` / `updateChannel` / `updateOptions` / `setFilter` / `setDropPreview` 仍在。
+- `selftest-features.html`（611 条）：真组件上的线型 / 线路装饰 / 光标 / 表现型配置断言 —— 把画面用 `exportImage` 读回 2D 画布数像素（实线 > 虚线 > 点线的墨量、`dc_line` 中点装饰的像素差、`showGrid` 只重画一帧），光标则用合成的指针事件与 Ctrl 键读出 `canvas.style.cursor`；装饰那几条还会量「几何变了装饰跟不跟着走」—— 写回新路径、拖绑定的节点、加 / 删拐点之后，装饰的紫色像素质心都要落在新中点上（容差 3px）；另外两条量的是**固定档**：`anchor: 'fixed'` + `at` 先把装饰钉在写死的世界坐标上，再把线从水平拖成斜的，装饰必须留在原坐标、不能跑到新中点。线路标签在单独一张画布上验：默认挂在中点、内容取 `name`，`position: 0` 落到起点，`hideOnInteract` 在缩放期间给整层加 `--hidden`、停手恢复，关掉 `lineLabel` 之后标签消失。装饰缺省 `auto` 的那一串也在这里量：没有拐点时拖端点装饰保持同一个比例（一直挂在中点）、加上拐点之后钉在那一刻的坐标上（改折线也不动）、把拐点删回直线又回到比例跟随、`anchor: 'follow'` 则一直跟到折线的新中点；`parallel` 用一条横条符号验（默认包围盒 26×6，平行之后转成 4×26），方形符号走的是 gl.POINTS 那条路（旋转后外接盒从 24×24 撑成 32×32）。通道里「每条回线各显示自己的标签」也在这里验：没有逐条配置时会被 32px 屏幕小格去重（只显示 1 ~ 2 条），给每条回线写上自己的 `lineLabelPosition` 之后 8 条全都在、位置各不相同，斜线上的标签按线路方向转、朝左的自动翻半圈（rotate = 0）。线路的层序（`zIndex`）也在这里验：画布正中一横一竖两条粗线交叉，默认后写的竖线在上（中心像素蓝），规则里给横线写 `zIndex: 5` 就换成红，`updateLine` 给竖线写 `zIndex: 9` 又换回蓝，写回 0 再回到红。这一轮另外验了插件上下文：`options.plugins` 与 `view.use()` 拿到的第二个参数是同一个冻结对象（`apiVersion === 1`、`view` 指回实例），旧的一参插件写法照常可用。这一轮另补 3 条合并触发时机断言（center 差 10px 不触发、继续拖入目标区域触发并带 trigger、collision 同距离照旧触发）。这一轮再补 1 条：13 个旧快捷方法已从实例删除，`updatePoint` / `updateLine` / `updateChannel` / `updateOptions` / `setFilter` / `setDropPreview` 仍在。对账组另补 8 条：`getChangedChannels({ ignoreGroups })` 忽略分组增删、已有分组拐点仍报、`reasons` 收窄与线路字段 / 路径 / 显隐变化，以及删除通道 / 删除线路 / 无通道场景同步清账。
 - `selftest-decoration.html`（75 条）：动态装饰器草稿专项自测 —— 开启后的 `start` 载荷、默认 14px 触发半径与每条线路不限量、指针在线路上 `hover`（命中线 / 自身 `decoration` / 平行角）、同一位置重复移动不重复发事件、移出目标 `leave`、在线路与空白处 `pointerup` 的 `ready` 差异、按下 / 抬起 `action.type` 都是 `decorationDraft`、单线 / 分组 / 整条通道三档作用域与非通道回退、`maxPerLine` 满额时悬浮与松手都不触发且提交前复核不写数据、`allowedLines` / `allowedChannels` / `allowedGroups` 三种白名单在悬浮与提交两处都拦截、`update` 改图标 / 尺寸 / 方向、`commit` 一次 `batch` 写四条且只发一条 `dataChange`、`cancel` 不改数据、重复 `begin` 替换旧草稿、整份换数据后过期草稿静默清掉。节点侧另有 32 条：`target: 'point'` 命中与只展开一个节点目标、方向 / 距离换算成屏幕偏移、相对偏移 / 固定世界坐标 / 鼠标位置三种位置来源、连接线样式随提交保存、`allowedPoints` 与 `maxPerPoint` 在悬浮 / 提交两处拦截、`both` 等距时节点优先且最近节点被白名单拦住时回退线路、节点与线路的重复 `reject` / `offset` 两种策略、节点装饰 get / update / remove 与整批提交、度转角与连接线进入矢量快照。这一轮另补 8 条节点断言：既有的 2 条「装饰随移动」仍保留；新增 6 条覆盖 `pointer + follow`、`fixed + follow`、`offset + fixed` 三种跨组合的预览与提交结果，确认位置来源和落地关系解耦后分别写成 `offset` 或 `at`。
 - `selftest-demo.html`：demo 级自测 —— 面板上的「定位直流线路」按当前数据集的 `dc_line` 条数走（默认数据集 `new.json` 里现在自带 5 条，点一下直接选中并定位到第一条；一条都没有的数据集才切到样例数据、定位到「直流送电」，中点挂着 `PATH_DC_LINE` 装饰），断言按数据算出来的条数写、不写死数字，读数与选中面板都跟着更新；打开时说明段落默认收起、面板按组折叠，节点标签只给最高电压那一档、线路标签默认整个不显示（面板上勾「显示」再按「显示范围」展开），面板上有 PATH_DC_LINE 的「标记定位」下拉（自动 / 一直跟随 / 写死坐标三档）。「通道回线各自显示」这一档从数据层核对（勾上之后 3669 条回线都带上了自己的 `lineLabelPosition`），再放大三步后勾「与线路平行」，画出来的标签 transform 里要出现 `rotate(...)`。这一轮又补了「数据映射」下拉（raw / lngLat / fit / scale）与「节点 / geojson 比例」滑块：切到 fit 后 320 个站点都要落进 GeoJSON 画出来的范围、读数里给出换算比例；「经纬度 → 屏幕」「屏幕 → 经纬度」两个按钮来回换算一致（屏幕读数保留 1 位小数，允许 0.01° 的回差）；在画布上挪一下鼠标，面板上就要出现屏幕像素与经纬度两行读数。
 - `selftest-perf.html`（136 条）：大数据量与画质档位的性能自测 —— 20000 点 / 8000 线的建场景与整份重排耗时、500 次拾取、逐个改 500 个节点对 `view.batch()`、四档画质与 `'auto'` 的自动升降；前面几轮补过 8 条交互期细线的断言（`getStats()` 给出 `antialias` / `software` / `thinLines` 三个读数；交互期 1px 实线整批走 `gl.LINES` 快路径、停手回到四边形展开；`interactionThinLines: false`、线宽 8px、整批带虚线这三种情况下都不走快路径，改回细实线又走）；上一轮补过 7 条线路标签候选复用的断言（复用态与整层重排逐字一致，改线路内容 / 挪节点 / 相机变化之后缓存都作废）与 1 条连续更新的耗时 DIAG（2 万点 / 1 万线，中位 0.30 ms / 次）；**这一轮再补 3 条标签避让盒的断言**（4 万点 + 4 万条长线放大后连续整层重排：第 2 轮起一次布局都不读、同一轮里没有哪条标签被量第二次）与 1 条量测读数 DIAG（逐轮 1427 / 0 / 0 / 0 / 0 次，旧写法 2662 / 0 … 次、第 1 轮重复量 1235 条；**上一轮把「没有哪条标签被量第二次」从按 DOM 节点去重改成按标签身份（`labelKind` # `labelIndex` # `labelLabel`）去重** —— 标签节点是池化复用的，按节点去重会把「同一格换了条标签」误报成重复量，旧代码实测第 1 轮 1235 条、新代码 0 条；**这一轮再补 3 条线路批次视口裁剪的断言**（20000 点 / 8000 线放大到 `scale: 10`：`lineInstances` 8000 → 27、相机挪回来回到 8000、来回一趟整幅像素差 0 / 241164）与 1 条读数 DIAG。这一轮再补 2 条点视口网格的断言（网格可用时枚举顺序与整份筛出来的下标序列一致、回调返回 `false` 最多只访问一个）；页面每段之间让出一帧，边跑边出结果。
 - `selftest-scale.html`（107 条）：大数据交互这一轮的自测 —— 2000 点 / 2000 线、筛选开着：`batch()` 里改 200 个节点只发 1 条 `onFilter` 与 1 条 `onDataChange`（对照组逐个调用是 200 条）；改字段 / 改坐标 / 改线路之后「增量补写的隐藏集」与「从零建一个同样条件的视图」逐位一致；点挪到被筛掉的坐标上，按 `coordinate` 联动的线路当场隐藏、挪回去又出来；线段网格的步进登记与多层粗格（沿线查得到、线不经过的角落不进候选、跨层只返回一次、2 万条长线密集时小范围查询的候选远少于总条数、整图估计值与总条数同量级）；点 / 线 / 空白的拾取；搜索文本缓存的命中与「改过字段之后按新值搜得到、旧值搜不到」。最底下几条 DIAG 是耗时读数（`Date.now()`），无头浏览器里虚拟时钟不往前走、显示 0.0 ms，带界面的浏览器里才是真实数字。；这一轮又补了 8 条：三万点的发散渲染（超过 2 万点走分批铺开）铺完之后装饰 400 个一条不少、挪一条带装饰的线的端点只动那一条线的装饰且落在新路径中点上、贴图符号进的是贴图批次、选中的节点抬到最上层、整份重排之后装饰与动点不翻倍，以及「节点自己配的涟漪数得清」（这一条顺带抓出了发散渲染期间涟漪补不齐的 bug）。这一轮再补一条 `createPointGrid.estimate` 与 `query` 同口径、带 `stopAfter` 提前封顶的断言（不建候选数组也能判断值不值得走网格）。
 - `bench-filter.html`：基准页（不是自测，只会打印读数）—— 20000 点 / 20000 线、`cascade: 'binding'` 的筛选开着（`filterWorker: false`），量「连换 10 次筛选条件」「`batch()` 里改 500 个节点（筛选开着 / 关掉）」「单个 `updatePoint`」「默认全字段 `search` 跑两次」这几档，每档先热身一遍再计时（`Date.now()`）。标题从 `bench running` 变成 `bench done` 表示跑完；别用 `--virtual-time-budget` 打开它 —— 虚拟时钟下同步脚本里的 `Date.now()` 不往前走，量出来全是 0。
 - `bench-scale.html`：百万级基准页（同样只打印读数）—— 点 / 线规模与视口走 URL 参数，`window.__bench.run(options)` 量生成数据、建场景与发散渲染、平移 / 缩放 / 放大 / 拾取、`refresh` / `updatePoint` / `updateOptions`、内存账与销毁回收；另有 `prepare`（只建场景）、`__bench.op(name)`（单步）与 `__bench.micro(count)`（原语微基准）。配 `scripts/bench-scale.mjs` 用（CDP 驱动，`--points=1000000 --gpu --port=93xx`，另有 `--profile` 抓 CPU profile、`--heap` 抓堆快照）；跑全部自测页用 `scripts/run-selftests.mjs`（`node scripts/run-selftests.mjs [页面名…]`，无头 Chrome + 真时间），两个脚本都要先起 dev server。
-- `selftest-labels.html`（135 条）：标签拖动与编辑、导出分项多选的专项自测 —— 按住标签拖 90 px 之后标签真的挪了那么多、同时画布不平移，`labelDrag` 的 `start` / `move` / `end` 三态与 `offset` / `delta` 对得上，偏移进得了 `getLabelStates()`、再拖动节点时偏移照旧叠在节点位移上，`resetLabel` 之后回到默认锚点；`updateLabel` 改内容 / 字号 / 颜色（`style` 是增量合并，只改字号不动颜色）、`resetLabels` 一次清干净；点一下标签发 `labelClick` 并把这一条交给面板；线路标签的拖动与恢复默认同一条路；导出侧验「选什么导什么」（选场站只出场站、选通道自动带上拐点、不认识的分项记一条提示），`exportData({ scope: 'selection' })` 验场站 + 通道 / 只出线路 / 没选中时的 `ok: false` 三个分支。另验 GeoJSON 区域文字同一相机重复刷新 0 次 `style` 写入、只改字号复用同一 DOM 节点、离屏时改样式再回到视野仍能恢复显示、只改锚点位置也会重新投影，以及同一帧 12 次相机变化只做 1 次重投影。设备像素专项把 `devicePixelRatio` 临时设为 1.25，验标签落点与拖动期整层位移都落在物理像素网格上，并确认逐条标签不再各自声明 `will-change`。
+- `selftest-labels.html`（161 条）：标签拖动与编辑、HTML 语义、高密度画布、导出分项多选的专项自测 —— 按住标签拖 90 px 之后标签真的挪了那么多、同时画布不平移，`labelDrag` 的 `start` / `move` / `end` 三态与 `offset` / `delta` 对得上，偏移进得了 `getLabelStates()`、再拖动节点时偏移照旧叠在节点位移上，`resetLabel` 之后回到默认锚点；`updateLabel` 改内容 / 字号 / 颜色（`style` 是增量合并，只改字号不动颜色）、`resetLabels` 一次清干净；点一下标签发 `labelClick` 并把这一条交给面板；线路标签的拖动与恢复默认同一条路；导出侧验「选什么导什么」（选场站只出场站、选通道自动带上拐点、不认识的分项记一条提示），`exportData({ scope: 'selection' })` 验场站 + 通道 / 只出线路 / 没选中时的 `ok: false` 三个分支。HTML 专项验全局 / 逐条 `true` / `false`、模板与 `field` / 默认名称转义、`updateLabel` 双向切换、线路标签富文本、点击载荷保留 `html` 与原标记、`getLabels()` 报运行时偏移、只改样式不替换 HTML 子节点、导出 → 回灌保持逐条语义，以及 120 条同内容标签首轮布局读取 ≤ 4 次的缓存断言。高密度专项用 1100 条纯文本验缺省 `auto` 只留一张画布、混入一条 `html: true` 仍保留那一条 DOM、`labelRender: 'dom'` 回退逐条 DOM 并清空画布、切回 `auto` 回收上一轮 div、SVG 导出包含画布标签与缩放只推一次。另验 GeoJSON 区域文字同一相机重复刷新 0 次 `style` 写入、只改字号复用同一 DOM 节点、离屏时改样式再回到视野仍能恢复显示、只改锚点位置也会重新投影，以及同一帧 12 次相机变化只做 1 次重投影。设备像素专项把 `devicePixelRatio` 临时设为 1.25，验标签落点与拖动期整层位移都落在物理像素网格上，并确认逐条标签不再各自声明 `will-change`。
 - `selftest-actions.html`：事件判读与只读接口的专项自测 —— 左右键、拖动、框选、拐点与标签的 `action` 三件套（type / target / data）、`button` / `modifiers` / `moved` / `double`、Shift 框选（含没框到东西的空框）与 Ctrl 取反在 `selectChange.action.type` 上的分辨、`pickAt` 的客户端坐标与只读性、`getFeaturesInRect`（含宽高为负的矩形）与 `getChannelsInView`、`addPoints` / `addPoint` / `addLines` / `removeLines` 的返回与 `dataChange` 类型；最后一段把第 12 步 `step-12-events.js` 挂起来跑一遍（判读读数、`probeAt` / `probeRect`、两条走廊）。页面底部流式打印 PASS / FAIL。
 - `selftest-select.html`：选择与框选的专项自测（59 条）—— 点选 / 悬停 / Ctrl 取反 / 多选开关的像素级状态样式与恢复，`select` / `deselect` / 通道写法 / 变更来源的接口断言，以及 SVG 状态贴图的预热与不同尺寸配方；这一轮补了 `selectionKinds: 'all'` 下 `selectInBox` 一次收下节点、独立线路与按 `channelSelectMode` 摊开的通道回线。
-- `selftest-demos.html`：演示外壳与 20 个页签（19 个功能 + 综合，按基础 / 交互 / 样式 / 数据 / 性能 / 综合六组排列）的自测（286 条）—— 逐个用 `?demo=<id>` 打开基础视图、标签交互、标签显示、鹰眼图配置、样式与规则、悬停与提示、通道与数据、编辑与保存、事件与方法、批量复制与合并、拖拽落点、可视化连线、动态装饰器、批量新增、搜索与筛选、扩展能力、性能与质量、动画效果、扩展图形与综合示例，画布与右栏读数都在、切页签会把 `?demo=` 写回地址栏、切走之后上一个实例被销毁（不留画布）、缺省页签是综合示例、页签总数与注册表一致、顶部六个分组按钮一次只展开一组且组名可见；鹰眼图配置页另验 `layers` 的自定义 `draw` 真被调用、`placement` 切到数据前 / 后时 `drawInfo.stage` 跟着变、框拖动触发 `onInteraction` 并带相机、尺寸切换走 `updateOptions` 重铺画布、DPR 2 下 `maxPixelRatio` 的 1× / 2× 备份尺寸、关掉扩展层与 `zoomMinimapBy` / `setMinimapZoom`；批量复制 / 合并、通道拐点 / 分组两页另有假接口断言（Shift 框选、整份请求体、标准响应包与资源级结果、版本号 / opId、200 / 网络失败 / 500 / 409、原 opId 重试与幂等重放不推进版本、409 rebase、本地回滚）；假后端严格契约另有一组直接断言（请求头与 body 不一致返回 400、baseVersion 非有限数字返回 400、同 opId 换 body 返回 409 `IDEMPOTENCY_CONFLICT` 且版本不前进），通道页还验了自定义格式按钮注册 → 导出 → 注销；扩展能力页另验自定义运算符 / 图元 / `view.use` 插件 / `defineExportFormat` 的注册、切换、卸载与业务 DTO 结构，并验同名重新注册图元当场换画笔；可视化连线页另验初始 `channels` 为空、正交折线拐点、预览箭头、取消不写数据，以及默认提交 / `addLines` / `addChannels` 三种落地；动态装饰器页另验吸附方式只有「跟随 / 固定」、两档下位置都有「相对节点 / 固定位置 / 鼠标位置」三档，固定 + 相对节点只改 `anchor`，固定 / 跟随 + 鼠标位置分别映射为 `placement: pointer` + 对应 `anchor` 且不带 `at`，跟随 + 固定位置仍传 `at`；页面底部流式打印 PASS / FAIL。
+- `selftest-demos.html`：演示外壳与 20 个页签（19 个功能 + 综合，按基础 / 交互 / 样式 / 数据 / 性能 / 综合六组排列）的自测（297 条）—— 逐个用 `?demo=<id>` 打开基础视图、标签交互、标签显示、鹰眼图配置、样式与规则、悬停与提示、通道与数据、编辑与保存、事件与方法、批量复制与合并、拖拽落点、可视化连线、动态装饰器、批量新增、搜索与筛选、扩展能力、性能与质量、动画效果、扩展图形与综合示例，画布与右栏读数都在、切页签会把 `?demo=` 写回地址栏、切走之后上一个实例被销毁（不留画布）、缺省页签是综合示例、页签总数与注册表一致、顶部六个分组按钮一次只展开一组且组名可见；鹰眼图配置页另验 `layers` 的自定义 `draw` 真被调用、`placement` 切到数据前 / 后时 `drawInfo.stage` 跟着变、框拖动触发 `onInteraction` 并带相机、尺寸切换走 `updateOptions` 重铺画布、DPR 2 下 `maxPixelRatio` 的 1× / 2× 备份尺寸、关掉扩展层与 `zoomMinimapBy` / `setMinimapZoom`；批量复制 / 合并、通道拐点 / 分组两页另有假接口断言（Shift 框选、整份请求体、标准响应包与资源级结果、版本号 / opId、200 / 网络失败 / 500 / 409、原 opId 重试与幂等重放不推进版本、409 rebase、本地回滚）；假后端严格契约另有一组直接断言（请求头与 body 不一致返回 400、baseVersion 非有限数字返回 400、同 opId 换 body 返回 409 `IDEMPOTENCY_CONFLICT` 且版本不前进），通道页还验了自定义格式按钮注册 → 导出 → 注销；扩展能力页另验自定义运算符 / 图元 / `view.use` 插件 / `defineExportFormat` 的注册、切换、卸载与业务 DTO 结构，并验同名重新注册图元当场换画笔；可视化连线页另验初始 `channels` 为空、正交折线拐点、预览箭头、取消不写数据，以及默认提交 / `addLines` / `addChannels` 三种落地；动态装饰器页另验吸附方式只有「跟随 / 固定」、两档下位置都有「相对节点 / 固定位置 / 鼠标位置」三档，固定 + 相对节点只改 `anchor`，固定 / 跟随 + 鼠标位置分别映射为 `placement: pointer` + 对应 `anchor` 且不带 `at`，跟随 + 固定位置仍传 `at`；通道与数据页另验「线路分组」弹框：分组卡片与「场站对标标识」都在，行内「确认移入」只改本地草稿、组件数据不动，取消 / Esc / 遮罩关闭不写数据，「确定分组」只调用一次 `splitChannelGroups` 把整份 groups 一次落地。页面底部流式打印 PASS / FAIL。
 - `selftest-effects.html`：线路 / 节点动画与贴图预热的专项自测（83 条，页面自带「帧泵」—— 无头环境里 `requestAnimationFrame` 几乎不推进，它把 rAF 收进 Map、手动推帧，动画类断言才测得动）：纯函数组（归一化、三层「关」的语义、按弧长采样、拐点连续、相位打散）、引擎组（铺批次 / 关掉一层 / 恢复 / 逐要素覆盖 / `getLineEffects` 全程贴线）、像素组（画布上真的有一个红点在两帧之间挪了位置）、**涟漪跟手组**（开着动画拖节点：拖动前圆心在节点坐标上、拖动中跟着走且是就地改实例缓冲、松手后整份重建也对齐、再拖回原位跟着回来，另有一条像素级断言量绿圈质心落在新坐标上）、**预热组**（全排列条数、第二次命中缓存、`getSymbolCombos()` 的去重与线路侧那一条、照着它配的一份**零张新画布**、反向一条「没画过的组合会当场烤、画布 +1」）、提醒组（`effects.line` 里写 `show` 被点名）。
 - `selftest-data.html`：标准数据文档与渲染后端开关的自测（103 条）—— `normalizeDocument` 的标准写法与 JSON 安全（无效日期写 `null` 并告警、类实例不静默变成空对象）、整份文档直接当 `createGisView` 入参、`exportData({ format: 'full' })` 导出 → 重建 → 再导出逐字节相同、`importData` 的整份与分列、`renderer` 三档与能力探测、网格顶点缓存窗口，以及自定义导出格式的注册 / 上下文 DTO 映射 / 深拷贝 / 视口导出 / 注销后失效；断言全在接口层，不读像素。
 - `check-sample-fields.mjs`：不是页面、是对账脚本（`node docs/steps/check-sample-fields.mjs`）—— 核对 `sample-document.json` 自己就是标准写法（`normalizeDocument` 后逐字节相同、0 条提醒）、`docs/sample-document字段详解.md` 里的读数与 `documentCounts()` 一致、以及它的「字段索引」与从文件里摘出来的字段路径集合一个不多一个不少（当前 154 个）；改完样本数据跑 `--write` 重写那两段机器块（幂等）。
-- `selftest-docs.html`：三个文档页 + 调试页的自测（130 条）—— 文档中心（`docs/index.html`）的清单 92 份 md（10 个根 + 82 份子文档，含新的 `接口协议.md`；树形侧栏按 `parent` / `groupLabel` 分成 6 组 `details`）、首屏 README 渲染、markdown 渲染器（表格 / 带语言代码块 / 两级列表 / 引用 / 行内代码 / md 链接 / 目录 / 首条摘要卡片 / 首段导语）、元信息里的阅读时长、索引页的子文档链接、换一份子文档、代码块复制按钮、跨文档搜索与深链、跨文档锚点链接（`文件.md#小节` 原地切文档并闪一下）、能直接跑的围栏才有的「在调试页跑」与元信息行的「这一份的调试页（N 段示例）」、390px 窄屏首屏 / 深链 / 横向溢出回归、阅读百分比与「回到顶部」的联动；调试演示页（`docs/playground/index.html`）的一个示例下拉（内置示例 + 「这一份文档」两组 optgroup）、`?doc=` 读文档抽示例、片段标注与来源子栏、顶层 await 运行、`channels` 快照、光标行列、草稿自动保存与恢复、`Ctrl+S` 运行、复制 / 清空输出、状态胶囊；API 速查页（`docs/api/index.html`）的 `__gisApi` 钩子、六张统计卡、241 张成员卡都带签名网格与示例、90 个 options 四列网格、搜索过滤与命中读数、`select(名字)` 高亮、类型开关能单独收起属性、左侧当前分组高亮、深浅主题切换与阅读设置共用；图解页（`docs/guide/sample-document.html`）的 47 条数据列表、点线路 / 分组 / 标签状态的图上标注、`点击时居中` 与 `显示编号` 开关、清空标注；三个页面都跑在 iframe 里，要用 dev server 打开。
+- `selftest-docs.html`：三个文档页 + 调试页的自测（130 条）—— 文档中心（`docs/index.html`）的清单 92 份 md（10 个根 + 82 份子文档，含新的 `接口协议.md`；树形侧栏按 `parent` / `groupLabel` 分成 6 组 `details`）、首屏 README 渲染、markdown 渲染器（表格 / 带语言代码块 / 两级列表 / 引用 / 行内代码 / md 链接 / 目录 / 首条摘要卡片 / 首段导语）、元信息里的阅读时长、索引页的子文档链接、换一份子文档、代码块复制按钮、跨文档搜索与深链、跨文档锚点链接（`文件.md#小节` 原地切文档并闪一下）、能直接跑的围栏才有的「在调试页跑」与元信息行的「这一份的调试页（N 段示例）」、390px 窄屏首屏 / 深链 / 横向溢出回归、阅读百分比与「回到顶部」的联动；调试演示页（`docs/playground/index.html`）的一个示例下拉（内置示例 + 「这一份文档」两组 optgroup）、`?doc=` 读文档抽示例、片段标注与来源子栏、顶层 await 运行、`channels` 快照、光标行列、草稿自动保存与恢复、`Ctrl+S` 运行、复制 / 清空输出、状态胶囊；API 速查页（`docs/api/index.html`）的 `__gisApi` 钩子、六张统计卡、249 张成员卡都带签名网格与示例、92 个 options 四列网格、搜索过滤与命中读数、`select(名字)` 高亮、类型开关能单独收起属性、左侧当前分组高亮、深浅主题切换与阅读设置共用；图解页（`docs/guide/sample-document.html`）的 47 条数据列表、点线路 / 分组 / 标签状态的图上标注、`点击时居中` 与 `显示编号` 开关、清空标注；三个页面都跑在 iframe 里，要用 dev server 打开。
+
+本轮补上的两组断言：`selftest-features.html` 新增 8 条 —— 3 条验 `channelSelectMode` 在 Ctrl + 点击加点后的高亮范围（`line` / `group` / `channel`），5 条验分组 `channelWaypointDragMode: 'vertex'`（`{ x, y }` 偏移归一化并参与实际路由、同组同序号拐点按世界增量平移、相邻拐点与其它分组不动、只写 `waypointOffsets` 不改公共 `path`、`parallel_groups.group_route` 带刚性偏移）。`selftest-demos.html` 新增 1 条，验通道演示页可切到 `vertex`，且「准备两分组拐点」会拆成两组、每组两个拐点。
 
 这些页面都要用 dev server 打开（第 10 ~ 13 步与 demo 自测要加载 `src/gis-view` 的 CSS；`selftest-demo.html` 会把 7 MB 的 `new.json` 与样例数据都加载一遍），页面底部会打印 PASS / FAIL。
 

package/docs/steps/selftest-demos.html

@@ -806,10 +806,24 @@
 							`${conflictPreview.slice(-320).replace(/\s+/g, ' ')} / ${text('copy-backend-readout')}`)
 						copyRetryButton.click()
 						const copyRebased = await until(() => text('copy-backend-readout').includes('200 OK') && !text('copy-backend-readout').includes('失败'), 5000)
-						check('批量复制与合并：409 后 rebase 生成新 opId 并成功落库',
-							Boolean(copyRebased) && setup.backendSnapshot?.version === conflictVersion + 2 && setup.backendSnapshot?.applied === conflictApplied + 1,
-							`v${conflictVersion} → v${setup.backendSnapshot?.version} / applied ${conflictApplied} → ${setup.backendSnapshot?.applied} / ${text('copy-backend-readout')}`)
-					}
+						check('批量复制与合并：409 后 rebase 生成新 opId 并成功落库',
+							Boolean(copyRebased) && setup.backendSnapshot?.version === conflictVersion + 2 && setup.backendSnapshot?.applied === conflictApplied + 1,
+							`v${conflictVersion} → v${setup.backendSnapshot?.version} / applied ${conflictApplied} → ${setup.backendSnapshot?.applied} / ${text('copy-backend-readout')}`)
+						// 拆分：先选一组，再点演示按钮；节点 +1、读数落到面板，撤销一步回到拆分前
+						click('copy-select-sources')
+						const splitSelectionReady = await until(() => view.getSelectionData().pointCount === 4, 5000)
+						const splitSource = view.getSelectionData().points?.[0] ?? view.getData().points[0]
+						const pointsBeforeSplit = view.getData().points.length
+						click('split-selected')
+						const splitLanded = await until(() => view.getData().points.length === pointsBeforeSplit + 1 && text('split-readout').includes('splitPoint'), 6000)
+						const splitReadout = text('split-readout')
+						check('批量复制与合并：拆分选中节点走 splitPoint，第二份与改线 / 改通道读数落面板',
+							Boolean(splitSelectionReady) && Boolean(splitLanded) && text('copy-action').includes('splitPoint') && splitReadout.includes('改线') && splitReadout.includes('改通道'),
+							`${pointsBeforeSplit} → ${view.getData().points.length} · ${splitReadout}`)
+						view.undo()
+						const splitUndone = await until(() => view.getData().points.length === pointsBeforeSplit && view.getData().points.some(point => String(point.id) === String(splitSource?.id)), 5000)
+						check('批量复制与合并：拆分是一步历史，撤销后节点与连线恢复', Boolean(splitUndone), `${view.getData().points.length} 点 / ${splitSource?.id ?? '—'}`)
+					}
 					else {
 						check('批量复制与合并：画布与实例都起来了', false, ready ? '没有 setupState.view' : '没有 canvas')
 					}
@@ -1059,14 +1073,29 @@
 
 				// 3. 回到标签演示，逐条验这一轮新增的交互
 				await clickTab('标签交互')
-				await canvasReady()
-				await until(() => document.querySelectorAll('.dv-demo .gis-view__label').length > 0, 15000)
-				const labelNodes = () => [...document.querySelectorAll('.dv-demo .gis-view__label')]
-				check('标签演示：节点标签都画出来了', labelNodes().length > 0, `${labelNodes().length} 个标签节点`)
-					check('标签节点上是可点可拖的那一类（draggable / editable）', labelNodes().every(node => node.classList.contains('gis-view__label--draggable')), labelNodes()[0]?.className ?? '')
-					// 3.0 一键换标签内容：setLabelContent 只换全局 label / lineLabel 的 content（节点 + 线路一起）
-					const labelView = () => document.querySelector('.dv-demo')?.__vueParentComponent?.setupState?.view ?? null
-					const overlapHideButton = document.querySelector('[data-demo="label-overlap-hide"]')
+				await canvasReady()
+				await until(() => document.querySelectorAll('.dv-demo .gis-view__label').length > 0, 15000)
+				const labelNodes = () => [...document.querySelectorAll('.dv-demo .gis-view__label')]
+				const perItemLabelNode = id => document.querySelector(`.dv-demo .gis-view__label[data-label-kind="point"][data-label-label="${id}"]`)
+				const labelView = () => document.querySelector('.dv-demo')?.__vueParentComponent?.setupState?.view ?? null
+				check('标签演示：节点标签都画出来了', labelNodes().length > 0, `${labelNodes().length} 个标签节点`)
+					document.querySelector('[data-demo="label-per-item-focus"]')?.click()
+					const perItemReady = await until(() => {
+						const readout = document.querySelector('[data-demo="label-per-item-readout"]')?.textContent.trim() ?? ''
+						return readout.includes('per-item-draggable') && readout.includes('per-item-locked') && perItemLabelNode('per-item-draggable') && perItemLabelNode('per-item-locked')
+					}, 6000)
+					const editablePerItem = perItemLabelNode('per-item-draggable')
+					const lockedPerItem = perItemLabelNode('per-item-locked')
+					check('标签演示：逐条配置 A 可拖可点、B 只读（false 覆盖全局开关）',
+						Boolean(perItemReady) &&
+							editablePerItem?.classList.contains('gis-view__label--draggable') === true &&
+							editablePerItem?.classList.contains('gis-view__label--editable') === true &&
+							lockedPerItem?.classList.contains('gis-view__label--draggable') === false &&
+							lockedPerItem?.classList.contains('gis-view__label--editable') === false &&
+							getComputedStyle(lockedPerItem).pointerEvents === 'none',
+						`A=${editablePerItem?.className ?? '没有'} / B=${lockedPerItem?.className ?? '没有'} / 当前 ${labelNodes().map(node => `${node.dataset.labelKind}:${node.dataset.labelIndex}:${node.dataset.labelLabel}:${node.textContent}`).join(' | ')} / ${document.querySelector('[data-demo="label-per-item-readout"]')?.textContent.trim() ?? ''}`)
+					// 3.0 一键换标签内容：setLabelContent 只换全局 label / lineLabel 的 content（节点 + 线路一起）
+					const overlapHideButton = document.querySelector('[data-demo="label-overlap-hide"]')
 					overlapHideButton?.click()
 					await wait(220)
 					const hideOverlapOptions = labelView()?.getOptions()
@@ -1094,8 +1123,8 @@
 					contentSelect.dispatchEvent(new Event('change', { bubbles: true }))
 					await wait(300)
 
-				// 3.1 点一下标签 → labelClick
-				const target = labelNodes()[0]
+				// 3.1 点一下标签 → labelClick
+				const target = labelNodes().find(node => node.classList.contains('gis-view__label--editable')) ?? labelNodes()[0]
 				tap(target)
 				const clickLogged = await until(() => logText().includes('labelClick'), 8000)
 				check('点一下标签发 labelClick，日志记下「哪一条、内容是什么」', Boolean(clickLogged), logText().slice(0, 160))
@@ -1426,10 +1455,61 @@
 				const channelSetup = channelDemo.__vueParentComponent.setupState
 				const channelView = await until(() => channelSetup.view, 8000)
 				await until(() => (channelView?.getChannels() ?? []).length > 0, 8000)
-				const channelField = key => channelDemo.querySelector(`[data-demo="${key}"]`)?.textContent.trim() ?? ''
-				const channelCanvas = channelDemo.querySelector('canvas.gis-view__canvas')
-				if (channelView && channelCanvas) {
-					const channelBox = channelCanvas.getBoundingClientRect()
+				const channelField = key => channelDemo.querySelector(`[data-demo="${key}"]`)?.textContent.trim() ?? ''
+				const channelCanvas = channelDemo.querySelector('canvas.gis-view__canvas')
+				if (channelView && channelCanvas) {
+					const visibilityChannelId = channelView.getOptions().channels?.[0]?.id
+					const groupsBeforeHide = channelView.getChannelGroups(visibilityChannelId).length
+					const membersBeforeHide = channelView.getChannel(visibilityChannelId)?.lineIndexes?.length ?? 0
+					channelView.clearChangedChannels()
+					channelDemo.querySelector('[data-demo="channel-hide"]')?.click()
+					const channelHidden = await until(() => {
+						const declared = channelView.getOptions().channels?.find(channel => String(channel.id) === String(visibilityChannelId))
+						return declared?.visible === false && channelView.getChannel(visibilityChannelId)?.lineIndexes?.length === 0 && channelField('channel-visibility').includes('隐藏')
+					}, 5000)
+					const hiddenChange = channelView.getChangedChannels().find(channel => String(channel.id) === String(visibilityChannelId))
+					check('通道与数据：隐藏第一条通道只改 visible，成员回线一起退场且最近变化记可见性',
+						Boolean(channelHidden) && hiddenChange?.visibilityChanged === true && hiddenChange?.reasons.includes('visibility') === true && channelField('channel-changed').includes('可见性'),
+						`${channelField('channel-visibility')} / ${channelField('channel-changed')}`)
+					channelDemo.querySelector('[data-demo="channel-show"]')?.click()
+					const channelShown = await until(() => {
+						const declared = channelView.getOptions().channels?.find(channel => String(channel.id) === String(visibilityChannelId))
+						return declared?.visible === true && channelView.getChannel(visibilityChannelId)?.lineIndexes?.length === membersBeforeHide && channelField('channel-visibility').includes('显示')
+					}, 5000)
+					channelDemo.querySelector('[data-demo="channel-clear-changed"]')?.click()
+					const changesCleared = await until(() => channelView.getChangedChannels().length === 0 && channelField('channel-changed').includes('没有'), 5000)
+					check('通道与数据：显示后成员与分组原样恢复，通道对账后最近变化清空',
+						Boolean(channelShown) && membersBeforeHide > 0 && channelView.getChannelGroups(visibilityChannelId).length === groupsBeforeHide && Boolean(changesCleared) && channelField('channel-visibility').includes('新基准'),
+						`${membersBeforeHide} 回 / ${groupsBeforeHide} 组 · ${channelField('channel-visibility')} / ${channelField('channel-changed')}`)
+					const demoPointId = channelView.getOptions().points?.[0]?.id
+					channelDemo.querySelector('[data-demo="point-hide"]')?.click()
+					const demoPointHidden = await until(() => {
+						const point = channelView.getOptions().points?.find(item => String(item.id) === String(demoPointId))
+						return point?.visible === false && channelField('channel-visibility').includes('隐藏节点')
+					}, 5000)
+					channelDemo.querySelector('[data-demo="point-show"]')?.click()
+					const demoPointShown = await until(() => {
+						const point = channelView.getOptions().points?.find(item => String(item.id) === String(demoPointId))
+						return point?.visible === true && channelField('channel-visibility').includes('显示节点')
+					}, 5000)
+					check('通道与数据：demo 的节点隐藏 / 显示按钮只改 visible 并恢复原数据',
+						Boolean(demoPointHidden) && Boolean(demoPointShown) && demoPointId !== undefined,
+						`${String(demoPointId)} · ${channelField('channel-visibility')}`)
+					const demoLineId = channelView.getOptions().lines?.[0]?.id
+					channelDemo.querySelector('[data-demo="line-hide"]')?.click()
+					const demoLineHidden = await until(() => {
+						const line = channelView.getOptions().lines?.find(item => String(item.id) === String(demoLineId))
+						return line?.visible === false && channelField('channel-visibility').includes('隐藏线路')
+					}, 5000)
+					channelDemo.querySelector('[data-demo="line-show"]')?.click()
+					const demoLineShown = await until(() => {
+						const line = channelView.getOptions().lines?.find(item => String(item.id) === String(demoLineId))
+						return line?.visible === true && channelField('channel-visibility').includes('显示线路')
+					}, 5000)
+					check('通道与数据：demo 的线路隐藏 / 显示按钮只改 visible 并恢复原数据',
+						Boolean(demoLineHidden) && Boolean(demoLineShown) && demoLineId !== undefined,
+						`${String(demoLineId)} · ${channelField('channel-visibility')}`)
+					const channelBox = channelCanvas.getBoundingClientRect()
 					const channelRightClick = (screen) => {
 						channelCanvas.dispatchEvent(new MouseEvent('contextmenu', {
 							bubbles: true,
@@ -1583,9 +1663,77 @@
 					await wait(80)
 					splitButton.click()
 					await wait(320)
-					const straightGroup = groupsOfFirst().find(group => group.lineIds.length === 2)
-					check('切「直连」再拆：options.path 写 [] 就真的一个拐点都不带', Boolean(straightGroup) && straightGroup.path.length === 0, JSON.stringify(groupsOfFirst().map(group => [group.id, group.lineIds, group.path])))
-					const waypointGroupId = straightGroup?.id ?? groupsOfFirst()[0]?.id
+					const straightGroup = groupsOfFirst().find(group => group.lineIds.length === 2)
+					check('切「直连」再拆：options.path 写 [] 就真的一个拐点都不带', Boolean(straightGroup) && straightGroup.path.length === 0, JSON.stringify(groupsOfFirst().map(group => [group.id, group.lineIds, group.path])))
+					// 线路分组弹框：行内确认移入只改草稿，底部确定时一次 splitChannelGroups 提交整份 groups
+					const dialogOpen = channelDemo.querySelector('[data-demo="channel-group-dialog-open"]')
+					const groupsBeforeDialog = JSON.stringify(groupsOfFirst().map(group => ({ id: String(group.id), lineIds: group.lineIds.map(String).sort() })))
+					dialogOpen?.click()
+					const groupDialogNode = await until(() => channelDemo.querySelector('[data-demo="channel-group-dialog"]'), 3000)
+					const dialogCards = [...(groupDialogNode?.querySelectorAll('[data-demo="channel-group-dialog-card"]') ?? [])]
+					const dialogRows = [...(groupDialogNode?.querySelectorAll('[data-demo="channel-group-dialog-line"]') ?? [])]
+					const dialogTitle = groupDialogNode?.querySelector('h3')?.textContent.trim() ?? ''
+					const dialogSubtitle = groupDialogNode?.querySelector('.dv-group-dialog__head p')?.textContent ?? ''
+					check('通道与数据：线路分组弹框按通道列全分组与回线，标题 / 场站对标标识都在',
+						Boolean(groupDialogNode) && dialogTitle === '线路分组' && dialogSubtitle.includes('场站对标标识') && dialogCards.length === groupsOfFirst().length && dialogRows.length === membersOfFirst(),
+						`${dialogCards.length} 组 / ${dialogRows.length} 回 / ${dialogTitle} · ${dialogSubtitle.replace(/\s+/g, ' ').slice(0, 100)}`)
+					const sourceCard = dialogCards.find(card => card.querySelectorAll('[data-demo="channel-group-dialog-line"]').length > 1) ?? dialogCards[0]
+					const sourceRow = sourceCard?.querySelector('[data-demo="channel-group-dialog-line"]')
+					const targetCard = dialogCards.find(card => card !== sourceCard)
+					const draftLineId = sourceRow?.dataset.lineId
+					const draftTargetId = targetCard?.dataset.groupId
+					const draftTargetSelect = sourceRow?.querySelector('[data-demo="channel-group-dialog-target"]')
+					if (draftTargetSelect && draftTargetId) {
+						draftTargetSelect.value = draftTargetId
+						draftTargetSelect.dispatchEvent(new Event('change', { bubbles: true }))
+					}
+					await wait(80)
+					sourceRow?.querySelector('[data-demo="channel-group-dialog-move"]')?.click()
+					await wait(120)
+					const draftGroups = JSON.stringify(groupsOfFirst().map(group => ({ id: String(group.id), lineIds: group.lineIds.map(String).sort() })))
+					const draftText = groupDialogNode?.querySelector('[data-demo="channel-group-dialog-text"]')?.textContent ?? ''
+					check('通道与数据：弹框里的「确认移入」只记草稿，组件数据不动',
+						Boolean(draftLineId) && Boolean(draftTargetId) && draftGroups === groupsBeforeDialog && draftText.includes('数据还没动'),
+						`${draftLineId} → ${draftTargetId} · ${draftText.replace(/\s+/g, ' ').slice(0, 110)}`)
+					groupDialogNode?.querySelector('[data-demo="channel-group-dialog-cancel"]')?.click()
+					await wait(100)
+					const cancelledGroups = JSON.stringify(groupsOfFirst().map(group => ({ id: String(group.id), lineIds: group.lineIds.map(String).sort() })))
+					check('通道与数据：取消分组弹框不写数据、弹框收起',
+						!channelDemo.querySelector('[data-demo="channel-group-dialog"]') && cancelledGroups === groupsBeforeDialog,
+						cancelledGroups === groupsBeforeDialog ? '数据未变' : '取消后分组被改了')
+					// 重开再做一次同样的移动，这次点「确定分组」：确认只调用一次整组变更方法
+					dialogOpen?.click()
+					const reopenedDialog = await until(() => channelDemo.querySelector('[data-demo="channel-group-dialog"]'), 3000)
+					const reopenedCards = [...(reopenedDialog?.querySelectorAll('[data-demo="channel-group-dialog-card"]') ?? [])]
+					const reopenedSourceCard = reopenedCards.find(card => card.querySelectorAll('[data-demo="channel-group-dialog-line"]').length > 1) ?? reopenedCards[0]
+					const reopenedRow = reopenedSourceCard?.querySelector('[data-demo="channel-group-dialog-line"]')
+					const reopenedTargetCard = reopenedCards.find(card => card !== reopenedSourceCard)
+					const movedLineId = reopenedRow?.dataset.lineId
+					const movedTargetId = reopenedTargetCard?.dataset.groupId
+					const reopenedSelect = reopenedRow?.querySelector('[data-demo="channel-group-dialog-target"]')
+					if (reopenedSelect && movedTargetId) {
+						reopenedSelect.value = movedTargetId
+						reopenedSelect.dispatchEvent(new Event('change', { bubbles: true }))
+					}
+					await wait(80)
+					reopenedRow?.querySelector('[data-demo="channel-group-dialog-move"]')?.click()
+					await wait(100)
+					const confirmButton = reopenedDialog?.querySelector('[data-demo="channel-group-dialog-confirm"]')
+					let splitGroupCalls = 0
+					const originalSplitChannelGroups = channelView.splitChannelGroups
+					channelView.splitChannelGroups = function (...args) {
+						splitGroupCalls += 1
+						return originalSplitChannelGroups.apply(this, args)
+					}
+					confirmButton?.click()
+					await wait(600)
+					channelView.splitChannelGroups = originalSplitChannelGroups
+					const confirmedGroups = groupsOfFirst()
+					const movedGroup = confirmedGroups.find(group => String(group.id) === String(movedTargetId))
+					check('通道与数据：确定分组只调用一次 splitChannelGroups，整份声明一次落地',
+						Boolean(confirmButton) && splitGroupCalls === 1 && membersOfFirst() === mergedGroups[0].lineIds.length && movedGroup?.lineIds.some(id => String(id) === String(movedLineId)) && logText().includes('splitChannelGroups'),
+						`调用 ${splitGroupCalls} 次 / ${confirmedGroups.length} 组 / ${membersOfFirst()} 回线 / ${movedLineId} → ${movedTargetId}`)
+					const waypointGroupId = straightGroup?.id ?? groupsOfFirst()[0]?.id
 					const backendModeSelect = channelDemo.querySelector('[data-demo="channel-backend-mode"]')
 					const backendRetryButton = channelDemo.querySelector('[data-demo="channel-backend-retry"]')
 					backendModeSelect.value = 'network'
@@ -1640,11 +1788,28 @@
 						channelCanvas.dispatchEvent(new PointerEvent('pointerdown', { ...base, button: 0, buttons: 1 }))
 						channelCanvas.dispatchEvent(new PointerEvent('pointerup', { ...base, button: 0, buttons: 0 }))
 					}
-					channelClick(menuScreen)
-					await wait(240)
-					const modeInfo = channelView.getSelectionData()
-					check('通道与数据：channelSelectMode = channel 时单击一条回线选中整条通道', Boolean(modeSelect) && channelLineTotal > 0 && modeInfo.lineCount === channelLineTotal && modeInfo.channelCount === 1, '选中 ' + modeInfo.lineCount + ' / 通道共 ' + channelLineTotal + ' 回（模式 ' + channelView.getOptions().channelSelectMode + '）')
-					// 删除：requestRemove 先出载荷（待确认期间数据不动），确认框由 demo 自己按载荷画
+					channelClick(menuScreen)
+					await wait(240)
+					const modeInfo = channelView.getSelectionData()
+					check('通道与数据：channelSelectMode = channel 时单击一条回线选中整条通道', Boolean(modeSelect) && channelLineTotal > 0 && modeInfo.lineCount === channelLineTotal && modeInfo.channelCount === 1, '选中 ' + modeInfo.lineCount + ' / 通道共 ' + channelLineTotal + ' 回（模式 ' + channelView.getOptions().channelSelectMode + '）')
+					// 分组拐点拖动模式：下拉更新 option，准备按钮拆两组并各加两个拐点
+					const waypointDragModeSelect = channelDemo.querySelector('[data-demo="channel-waypoint-drag-mode"]')
+					if (waypointDragModeSelect) {
+						waypointDragModeSelect.value = 'vertex'
+						waypointDragModeSelect.dispatchEvent(new Event('change', { bubbles: true }))
+					}
+					await wait(160)
+					const waypointDragModeApplied = channelView.getOptions().channelWaypointDragMode === 'vertex'
+					channelDemo.querySelector('[data-demo="channel-waypoint-drag-prepare"]')?.click()
+					const preparedWaypointGroups = await until(() => {
+						const channelId = channelView.getChannels()[0]?.channelId
+						const groups = channelView.getChannelGroups(channelId)
+						return groups.length === 2 && groups.every(group => group.path.length === 2) ? groups : null
+					}, 5000)
+					check('通道与数据：分组拐点拖动可切 vertex，准备按钮拆两组且每组两个拐点',
+						Boolean(waypointDragModeSelect) && Boolean(preparedWaypointGroups) && waypointDragModeApplied && channelField('channel-waypoint-drag-text').includes('已准备 2 组'),
+						`${channelView.getOptions().channelWaypointDragMode} / ${(preparedWaypointGroups ?? []).map(group => group.path.length).join(' / ')} / ${channelField('channel-waypoint-drag-text')}`)
+					// 删除：requestRemove 先出载荷（待确认期间数据不动），确认框由 demo 自己按载荷画
 					const linesBeforeRemove = channelView.getData().lines.length
 					const channelsBeforeRemove = channelView.getOptions().channels.length
 					;[...channelDemo.querySelectorAll('.dv-panel button')].find(node => node.textContent.includes('删除选中'))?.click()
@@ -1854,8 +2019,8 @@
 					await wait(150)
 					const apiItems = () => [...document.querySelectorAll('.demo-api-list:not(.demo-api-list--options) .demo-api-item')]
 					const optionItems = () => [...document.querySelectorAll('.demo-api-list--options .demo-api-item')]
-check('实例方法速查：整份成员清单按分组列全（16 组 / 241 个成员）',
-  Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 241,
+					check('实例方法速查：整份成员清单按分组列全（16 组 / 249 个成员）',
+						Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 249,
 						`${document.querySelectorAll('.demo-api-group').length} 组 / ${apiItems().length} 个成员`)
 					const apiNames = apiItems().map(node => node.querySelector('b')?.textContent)
 					const roundNames = ['registerSymbol', 'unregisterSymbol', 'listSymbols']
@@ -1870,7 +2035,7 @@ check('实例方法速查：整份成员清单按分组列全（16 组 / 241 个
 					check('实例方法速查：这一轮拆出来的方法也在清单里（addChannelGroupLines / joinChannelGroupLines / endAddChannel）',
 						roundNames1597.every(name => apiNames.includes(name)),
 						roundNames1597.filter(name => !apiNames.includes(name)).join(' / ') || '三个都在')
-check('实例方法速查：options 折叠清单列全 90 个键', optionItems().length === 90, `${optionItems().length} 个键`)
+					check('实例方法速查：options 折叠清单列全 92 个键', optionItems().length === 92, `${optionItems().length} 个键`)
 					const apiSearch = document.querySelector('.demo-api-search input[type="search"]')
 					apiSearch.value = 'focusOn'
 					apiSearch.dispatchEvent(new Event('input', { bubbles: true }))

package/docs/steps/selftest-docs.html

@@ -518,8 +518,8 @@
 				if (check('API 速查：挂上了 __gisApi 钩子（数据来自 api-index.js，没钩子多半是 file:// 打开的）', Boolean(apiHook))) {
 					const apiDoc = apiFrame.contentDocument
 					const summary = apiHook.summary
-					check('API 速查：清单来自 api-index（241 个成员 / 90 个 options / 16 个分组）',
-						summary.members === 241 && summary.options === 90 && summary.sections === 16,
+					check('API 速查：清单来自 api-index（249 个成员 / 92 个 options / 16 个分组）',
+						summary.members === 249 && summary.options === 92 && summary.sections === 16,
 						JSON.stringify(summary))
 					check('API 速查：左侧分组有当前项，滚动 / 点选时会跟着亮', apiHook.activeGroup() !== null, String(apiHook.activeGroup()))
 					check('API 速查：分组都渲染出来（16 组 + options 一组）',
@@ -530,8 +530,8 @@
 						`${apiDoc.querySelectorAll('.api-member').length} 张卡片 / 属性 ${apiDoc.querySelectorAll('.api-member[data-kind="property"]').length} 张`)
 					const noExample = [...apiDoc.querySelectorAll('.api-member')].filter(node => Number(node.dataset.examples) < 1)
 					check('API 速查：每个成员都带至少一段示例（不出现空卡片）', noExample.length === 0,
-						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '241 张卡片都有示例')
-					check('API 速查：90 个 options 都列全（名字 / 类型 / 默认值 / 说明四件套）',
+						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '249 张卡片都有示例')
+					check('API 速查：92 个 options 都列全（名字 / 类型 / 默认值 / 说明四件套）',
 						apiDoc.querySelectorAll('.api-option').length === summary.options && [...apiDoc.querySelectorAll('.api-option')].every(node => node.querySelector('.name code') && node.querySelector('.type') && node.querySelector('.def') && node.querySelector('.doc')),
 						`${apiDoc.querySelectorAll('.api-option').length} 个`)
 					const statCards = [...apiDoc.querySelectorAll('#stats .api-stat')]
@@ -622,11 +622,12 @@
 					await settle(playFrame.contentWindow, 1)
 					const playErr = playDoc.querySelector('#out').textContent
 					check('调试演示页：代码报错打在输出区（红字 + 不炸整页）', playErr.includes('noSuchMethod') && playDoc.querySelector('#out .err') !== null, playErr.split('\n')[0])
+					const playCanvasCount = playDoc.querySelectorAll('#map canvas').length
 					await playHook.run('createGisView(\'#map\', {})\nview.getData().points.length')
 					await settle(playFrame.contentWindow, 1)
 					check('调试演示页：示例里的 createGisView(\'#map\') 沿用右边这份视图（不会新开一块画布）',
-						playDoc.querySelectorAll('#map canvas').length === 1 && (playDoc.querySelector('#out').textContent ?? '').includes('3'),
-						`画布 ${playDoc.querySelectorAll('#map canvas').length} 块`)
+						playDoc.querySelectorAll('#map canvas').length === playCanvasCount && (playDoc.querySelector('#out').textContent ?? '').includes('3'),
+						`画布 ${playCanvasCount} → ${playDoc.querySelectorAll('#map canvas').length} 块`)
 					playHook.setCode('view.updatePoint(\'b\', { color: \'#00aa88\' })')
 					check('调试演示页：setCode 换编辑器内容（深链 #code= 与 API 页带过来的代码都走它）', playHook.getCode().includes('00aa88'))
 					playHook.reset()