gis-view-webgl2 0.1.0 → 0.1.2

package/docs/steps/selftest-features.html

@@ -983,7 +983,7 @@
 
 					/* 快捷键：Ctrl+C / Ctrl+V 与默认框选键 */
 					cmEvents.length = 0
-					cmView.select('a')
+					cmView.selectFeatures('a')
 					cmView.el.dispatchEvent(new KeyboardEvent('keydown', { key: 'c', ctrlKey: true, bubbles: true }))
 					check('Ctrl+C 把选中的节点收进剪贴板（默认快捷键）', cmView.getPointClipboard()?.item.id === 'a', cmView.getPointClipboard()?.item.id)
 					check('Ctrl+C 命中 onPointCopy 的 clipboard 载荷（copy + keyboard + shortcuts 三件套）', cmShortcutClipboard?.phase === 'clipboard' && cmShortcutClipboard?.via === 'shortcut' && cmShortcutClipboard?.count === 1 && cmShortcutClipboard?.item?.id === 'a', JSON.stringify({ phase: cmShortcutClipboard?.phase, via: cmShortcutClipboard?.via, count: cmShortcutClipboard?.count, item: cmShortcutClipboard?.item?.id }))
@@ -998,13 +998,13 @@
 					cmView.fitView()
 					await settle(30)
 					const cmAnchor = cmView.project(0, 0)
-					cmView.select(null)
+					cmView.selectFeatures(null)
 					await cmDrag(cmView, [cmAnchor[0] - 26, cmAnchor[1] - 26], [cmAnchor[0] + 26, cmAnchor[1] + 26], { ctrlKey: true })
 					check('默认框选键是 Shift 时 Ctrl 拖动不再框选', cmView.getSelections().length === 0, `选中 ${cmView.getSelections().length}`)
 					cmView.fitView()
 					await settle(30)
 					const cmAnchor2 = cmView.project(0, 0)
-					cmView.select(null)
+					cmView.selectFeatures(null)
 					await cmDrag(cmView, [cmAnchor2[0] - 26, cmAnchor2[1] - 26], [cmAnchor2[0] + 26, cmAnchor2[1] + 26], { shiftKey: true })
 					check('按住新的框选键（Shift）拖动出选框并选中节点', cmView.getSelections().length >= 1 && cmView.getSelections().some(item => item.item.id === 'a'), `选中 ${cmView.getSelections().map(item => item.item.id).join(',')}`)
 					cmView.updateOptions({ shortcuts: { boxSelect: 'ctrl' } })
@@ -1249,6 +1249,47 @@
 					check('mergePoints 找不到节点：ok: false + 一条失败事件', cmFail.ok === false && cmMergeEvents5[cmMergeEvents5.length - 1].phase === 'merge' && cmMergeEvents5[cmMergeEvents5.length - 1].ok === false && cmView5.getPointMerge() === null, JSON.stringify(cmFail).slice(0, 160))
 					cmView5.destroy()
 					cmHost5.remove()
+
+					/* 合并触发时机：碰撞（两个半径相碰）/ 中心点进入目标节点区域 */
+					const triggerHost = document.createElement('div')
+					triggerHost.style.cssText = 'width:520px;height:300px'
+					document.body.appendChild(triggerHost)
+					const triggerEvents = []
+					const triggerView = createGisView(triggerHost, {
+						points: [{ id: 'source', x: 0, y: 0, size: 12 }, { id: 'target', x: 140, y: 0, size: 12 }],
+						fitPadding: 70,
+						showGrid: false,
+						merge: { trigger: 'center', confirm: false },
+						draggable: true,
+						onPointMerge: payload => triggerEvents.push(payload)
+					})
+					await settle(120)
+					const triggerTarget = triggerView.project(140, 0)
+					await cmDrag(triggerView, triggerView.project(0, 0), [triggerTarget[0] - 10, triggerTarget[1]])
+					check('merge.trigger=center：中心还差 10px 没进入目标区域时不触发（同样距离下碰撞档会触发）', triggerEvents.length === 0 && triggerView.getData().points.length === 2, JSON.stringify({ events: triggerEvents.map(item => item.phase), points: triggerView.getData().points.map(item => item.id) }))
+					const triggerSource = triggerView.getData().points.find(point => point.id === 'source')
+					await cmDrag(triggerView, triggerView.project(triggerSource.x, triggerSource.y), triggerTarget)
+					check('merge.trigger=center：中心进入目标区域后触发，载荷带 trigger=center', triggerView.getData().points.length === 1 && triggerView.getData().points[0].id === 'target' && triggerEvents[0]?.trigger === 'center', JSON.stringify({ points: triggerView.getData().points.map(item => item.id), trigger: triggerEvents[0]?.trigger }))
+					triggerView.destroy()
+					triggerHost.remove()
+
+					const collisionHost = document.createElement('div')
+					collisionHost.style.cssText = 'width:520px;height:300px'
+					document.body.appendChild(collisionHost)
+					const collisionView = createGisView(collisionHost, {
+						points: [{ id: 'source', x: 0, y: 0, size: 12 }, { id: 'target', x: 140, y: 0, size: 12 }],
+						fitPadding: 70,
+						showGrid: false,
+						merge: { trigger: 'collision', confirm: false },
+						draggable: true
+					})
+					await settle(120)
+					const collisionTarget = collisionView.project(140, 0)
+					await cmDrag(collisionView, collisionView.project(0, 0), [collisionTarget[0] - 10, collisionTarget[1]])
+					check('merge.trigger=collision：中心还差 10px 时两个节点半径已经相碰，照旧触发', collisionView.getData().points.length === 1 && collisionView.getData().points[0].id === 'target', JSON.stringify(collisionView.getData().points.map(item => item.id)))
+					collisionView.destroy()
+					collisionHost.remove()
+
 					/* 合并 ④：框选 / 多选之后按接口一次并完（mergeSelectedPoints） */
 					const msHost = document.createElement('div')
 					msHost.style.cssText = 'width:560px;height:360px'
@@ -1288,7 +1329,7 @@
 					})
 					await settle(140)
 					const msIds = () => msView.getData().points.map(point => point.id ?? '(无id)').join(',')
-					msView.select(['h', 'a', 'b', 'c'])
+					msView.selectFeatures(['h', 'a', 'b', 'c'])
 					await settle(30)
 					const msBulk = msView.mergeSelectedPoints()
 					check('框选 / 多选之后一步并完：自动挑「绑定线路最多」的节点当目标', msBulk.ok === true && msBulk.phase === 'mergeSelected' && msBulk.target.item.id === 'h' && msBulk.sourcesMerged === 3 && msBulk.skipped.length === 0, JSON.stringify({ target: msBulk.target?.item?.id, merged: msBulk.sourcesMerged, skipped: msBulk.skipped }))
@@ -1304,7 +1345,7 @@
 					/* 相机移动不该收掉待确认的合并（小图拖动 / moveCenter 走的是同一条路） */
 					msView.fitView()
 					await settle(60)
-					msView.select(null)
+					msView.selectFeatures(null)
 					await cmDrag(msView, msView.project(100, 0), msView.project(0, 0))
 					const msPend = msView.getPointMerge()
 					check('把节点拖到目标上：进入待确认（读得到 pending 载荷）', msPend !== null && msPend.phase === 'state' && msPend.confirmed === false, JSON.stringify(msPend?.phase))
@@ -1319,16 +1360,16 @@
 					const msWrapped = msView.batch(() => msView.mergeSelectedPoints({ target: 'h', sources: ['b', 'c'] }), { label: '批量合并' })
 					const msWrappedUndo = msView.undo()
 					check('batch 里调 mergeSelectedPoints：整批只占一步历史（撤销一次全回去）', msWrapped?.ok === true && msWrapped.sourcesMerged === 2 && msWrappedUndo?.label === '批量合并' && msIds() === 'h,a,b,c,lock,(无id)', JSON.stringify({ merged: msWrapped?.sourcesMerged, label: msWrappedUndo?.label }))
-					msView.select(null)
+					msView.selectFeatures(null)
 					const msEmpty = msView.mergeSelectedPoints()
 					check('没选中节点：ok: false 并带回原因', msEmpty.ok === false && msEmpty.phase === 'mergeSelected' && msEmpty.reason === '没有选中的节点' && msEmpty.target === null, msEmpty.reason)
-					msView.select('h')
+					msView.selectFeatures('h')
 					const msOne = msView.mergeSelectedPoints()
 					check('只选中一个节点：自动挑目标时要两个以上', msOne.ok === false && msOne.reason === '选中的节点不足两个', msOne.reason)
-					msView.select(['h', 'lock'])
+					msView.selectFeatures(['h', 'lock'])
 					const msAllLocked = msView.mergeSelectedPoints()
 					check('选中里只剩 mergeable: false 的节点：一个都并不了', msAllLocked.ok === false && msAllLocked.reason === '可以合并的节点不足两个', msAllLocked.reason)
-					msView.select(['h', 'a', 'lock'])
+					msView.selectFeatures(['h', 'a', 'lock'])
 					const msSelective = msView.mergeSelectedPoints()
 					check('多选里混着 mergeable: false：跳过它、其余照并（skipped 说明原因）', msSelective.ok === true && msSelective.sourcesMerged === 1 && msSelective.merged[0].source.item.id === 'a' && msSelective.skipped.length === 1 && msSelective.skipped[0].id === 'lock' && msSelective.skipped[0].reason === '标记了 mergeable: false', JSON.stringify({ merged: msSelective.sourcesMerged, skipped: msSelective.skipped }))
 					check('只有一个来源时走普通的一次合并（数据变更不是 batch）', msChanges[msChanges.length - 1].type === 'mergePoints', msChanges[msChanges.length - 1].type)
@@ -1401,14 +1442,14 @@
 					const cmCenter = cmLayerView.project(0, 0)
 					const cmOverPixel = await cmPixelAt(cmLayerView, cmCenter)
 					check('没选中时上层节点压在下面那个之上（按数据顺序画）', cmIsBlue(cmOverPixel), JSON.stringify(cmOverPixel))
-					cmLayerView.select('under')
+					cmLayerView.selectFeatures('under')
 					await settle(60)
 					const cmRaisedPixel = await cmPixelAt(cmLayerView, cmCenter)
 					check('选中的节点抬到最上层（与 zIndex / 数据顺序无关）', cmIsRed(cmRaisedPixel), JSON.stringify(cmRaisedPixel))
-					cmLayerView.select(null)
+					cmLayerView.selectFeatures(null)
 					cmLayerView.updateOptions({ selectionOnTop: false })
 					await settle(60)
-					cmLayerView.select('under')
+					cmLayerView.selectFeatures('under')
 					await settle(60)
 					const cmFlatPixel = await cmPixelAt(cmLayerView, cmCenter)
 					check('selectionOnTop: false 时不抬层（仍然按数据顺序画）', cmIsBlue(cmFlatPixel), JSON.stringify(cmFlatPixel))
@@ -1464,11 +1505,11 @@
 					const cmLineSpot = cmRaiseLineView.project(0, 0.6)
 					const cmLineStillPixel = await cmPixelAt(cmRaiseLineView, cmLineSpot)
 					check('两条线重叠处：后画的那条压在上面', cmIsBlue(cmLineStillPixel), JSON.stringify(cmLineStillPixel))
-					cmRaiseLineView.select('line-low')
+					cmRaiseLineView.selectFeatures('line-low')
 					await settle(90)
 					const cmLineRaisePixel = await cmPixelAt(cmRaiseLineView, cmLineSpot)
 					check('选中线路：抬到最上层（与数据顺序无关）', cmIsRed(cmLineRaisePixel), JSON.stringify(cmLineRaisePixel))
-					cmRaiseLineView.select(null)
+					cmRaiseLineView.selectFeatures(null)
 					await settle(90)
 					const cmLineBackPixel = await cmPixelAt(cmRaiseLineView, cmLineSpot)
 					check('取消选中：线路恢复原来的次序', cmIsBlue(cmLineBackPixel), JSON.stringify(cmLineBackPixel))
@@ -1504,7 +1545,7 @@
 						cmChannelStillPixels.push(await cmPixelAt(cmRaiseChannelView, spot))
 					}
 					check('通道回线与另一条线交叉处：后画的普通线压在上面', cmChannelStillPixels.every(cmIsBlue), JSON.stringify(cmChannelStillPixels))
-					cmRaiseChannelView.select('ch-c1')
+					cmRaiseChannelView.selectFeatures('ch-c1')
 					await settle(120)
 					const cmChannelRaisePixels = []
 					for (const spot of cmChannelSpots) {
@@ -1747,7 +1788,7 @@
 					// ② 整份换成新对象（等价于撤销 / 重新拉一份数据）：收掉并补一条 cancel，载荷带 invalidated
 					const pendSourceBefore = pendView.getData().points.find(point => point.id === 'a')
 					const pendSourceX = pendSourceBefore.x
-					pendView.updatePoints(pendView.getData().points.map(point => ({ ...point })))
+					pendView.updateData({ points: pendView.getData().points.map(point => ({ ...point })) })
 					await settle(80)
 					const pendCancel = pendMergeEvents[pendMergeEvents.length - 1]
 					const pendSourceAfter = pendView.getData().points.find(point => point.id === 'a')
@@ -1859,11 +1900,11 @@
 					check('updateOptions 发 onDataChange（changed 标出改的是哪一类）', evLog.data.length === 1 && evLog.data[0].type === 'updateOptions' && evLog.data[0].changed.points === false && evLog.data[0].changed.channels === true, evTypes())
 
 					evLog.select.length = 0
-					evView.select('a')
+					evView.selectFeatures('a')
 					check('接口选中发 onSelectChange（cause 为 api）', evLog.select.length === 1 && evLog.select[0].cause === 'api' && evLog.select[0].count === 1 && evLog.select[0].ids[0] === 'a' && evLog.select[0].points === 1, JSON.stringify(evLog.select.map(entry => `${entry.cause}:${entry.count}`)))
-					evView.select('a')
+					evView.selectFeatures('a')
 					check('选中集没变就不再发 onSelectChange', evLog.select.length === 1, `次数 ${evLog.select.length}`)
-					evView.select(null)
+					evView.selectFeatures(null)
 					check('清空选中也发一条（count: 0 / cause: api）', evLog.select.length === 2 && evLog.select[1].count === 0 && evLog.select[1].cause === 'api', JSON.stringify(evLog.select.map(entry => entry.count)))
 
 					evLog.shortcut.length = 0
@@ -1937,7 +1978,7 @@
 					check('onChannelGroupChange 回调和事件总线收到同一份载荷', cgOption.length === 1 && cgOption[0] === cgBus[0])
 
 					// 选中一条回线再合并：选中镜像里的 groupId / groupIndex 要跟着真值走（本轮修复的回归守卫）
-					cgView.select('c2')
+					cgView.selectFeatures('c2')
 					await settle(60)
 					const cgTruth = () => {
 						const groups = cgView.getChannelGroups('ch-1')
@@ -2005,8 +2046,8 @@
 					ulHost.remove()
 					/* 这一轮新增：通道改名 / 通道下增减回线 / 删除分组（问题.txt 第 2 条那几个「方法有吗」） */
 					const cgNameBefore = cgData.length
-					cgView.setChannelName('ch-1', '甲通道')
-					check('setChannelName 改通道名称：数据副本落地 + 一条 updateChannel 变更', cgView.getOptions().channels[0].name === '甲通道' && cgData.length === cgNameBefore + 1 && cgData[cgData.length - 1].type === 'updateChannel', JSON.stringify({ name: cgView.getOptions().channels[0].name, type: cgData[cgData.length - 1]?.type }))
+					cgView.updateChannel('ch-1', { name: '甲通道' })
+					check('updateChannel({ name }) 改通道名称：数据副本落地 + 一条 updateChannel 变更', cgView.getOptions().channels[0].name === '甲通道' && cgData.length === cgNameBefore + 1 && cgData[cgData.length - 1].type === 'updateChannel', JSON.stringify({ name: cgView.getOptions().channels[0].name, type: cgData[cgData.length - 1]?.type }))
 
 					cgView.addLine({ id: 'c3', from: 'ca', to: 'cb', color: '#8a5cf6' })
 					const cgMemberCount = () => cgView.getChannels().reduce((total, state) => total + state.lineIndexes.length, 0)
@@ -2143,7 +2184,7 @@
 					ucView.destroy()
 					ucHost.remove()
 
-					/* 这一轮新增：改 lineIds 增删线路（有 groups 也生效）+ updateChannels 写回分组 id + 声明校验 warning */
+					/* 这一轮新增：改 lineIds 增删线路（有 groups 也生效）+ updateData({ channels }) 写回分组 id + 声明校验 warning */
 					const chHost = document.createElement('div')
 					chHost.style.cssText = 'width:420px;height:280px'
 					document.body.appendChild(chHost)
@@ -2164,6 +2205,10 @@
 					await settle(150)
 					const chGroups = () => chView.getChannelGroups('chA').map(group => ({ id: group.id, lineIds: group.lineIds }))
 					const chMemberCount = () => chView.getChannels().reduce((total, state) => total + state.lineIndexes.length, 0)
+					const chInView = chView.getChannelsInView()
+					check('getChannelsInView 按视口单遍归并通道，回线与分组 id 都去重',
+						chInView.length === 1 && chInView[0].channelId === 'chA' && chInView[0].lineIndexes.length === 2 && chInView[0].groupIds.length === 1,
+						JSON.stringify(chInView))
 
 					chView.updateChannel('chA', { groups: [{ id: 'ga', lineIds: ['k1'] }, { id: 'gb', lineIds: ['k2'] }] })
 					await settle(60)
@@ -2191,16 +2236,16 @@
 					check('updateChannel 找不到通道 / 没给补丁各报一句 warning，不静默空操作', chWarn.length === 2, JSON.stringify(chWarn))
 
 					chWarn.length = 0
-					chView.updateChannels([{ id: 'chA', name: 'A 通道', groups: [{ lineIds: ['k3'] }, { lineIds: ['nope2'] }] }])
+					chView.updateData({ channels: [{ id: 'chA', name: 'A 通道', groups: [{ lineIds: ['k3'] }, { lineIds: ['nope2'] }] }] })
 					await settle(60)
 					const chDeclared = chView.getOptions().channels[0].groups ?? []
-					check('updateChannels 把引擎补好的分组 id / 拐点路径写回声明（缺省 id 不再留在数据里）', chDeclared.length === 1 && typeof chDeclared[0].id === 'string' && chDeclared[0].id.length > 0 && Array.isArray(chDeclared[0].path) && JSON.stringify(chDeclared[0].lineIds) === JSON.stringify(['k3']), JSON.stringify(chDeclared))
-					check('updateChannels 里认不出的成员也报一句 warning', chWarn.length === 1 && String(chWarn[0]).includes('nope2'), JSON.stringify(chWarn))
+					check('updateData({ channels }) 把引擎补好的分组 id / 拐点路径写回声明（缺省 id 不再留在数据里）', chDeclared.length === 1 && typeof chDeclared[0].id === 'string' && chDeclared[0].id.length > 0 && Array.isArray(chDeclared[0].path) && JSON.stringify(chDeclared[0].lineIds) === JSON.stringify(['k3']), JSON.stringify(chDeclared))
+					check('updateData({ channels }) 里认不出的成员也报一句 warning', chWarn.length === 1 && String(chWarn[0]).includes('nope2'), JSON.stringify(chWarn))
 					/* 这一轮新增：整份提交的几个入口也走同一份调和（lineIds 是成员整表），写回时成员表对齐到分组 */
-					chView.updateChannels([{ id: 'chA', lineIds: ['k1', 'k2'], groups: [{ id: 'ga', lineIds: ['k1'] }, { id: 'gb', lineIds: ['k2'] }, { id: 'gc', lineIds: ['k9'] }] }])
+					chView.updateData({ channels: [{ id: 'chA', lineIds: ['k1', 'k2'], groups: [{ id: 'ga', lineIds: ['k1'] }, { id: 'gb', lineIds: ['k2'] }, { id: 'gc', lineIds: ['k9'] }] }] })
 					await settle()
 					const chWhole = chGroups()
-					check('updateChannels 整份提交也调和：声明里 lineIds 与 groups 冲突时按 lineIds 收窄（多出的组丢掉）', JSON.stringify(chWhole.map(group => group.lineIds)) === JSON.stringify([['k1'], ['k2']]) && chMemberCount() === 2, JSON.stringify({ groups: chWhole, members: chMemberCount() }))
+					check('updateData({ channels }) 整份提交也调和：声明里 lineIds 与 groups 冲突时按 lineIds 收窄（多出的组丢掉）', JSON.stringify(chWhole.map(group => group.lineIds)) === JSON.stringify([['k1'], ['k2']]) && chMemberCount() === 2, JSON.stringify({ groups: chWhole, members: chMemberCount() }))
 
 					chView.updateOptions({ channels: [{ id: 'chA', lineIds: ['k9'] }] })
 					await settle()
@@ -2214,18 +2259,18 @@
 					await settle()
 					check('importData({ channels }) 导入的声明同样过调和（applied.channels 为真）', chImported.ok === true && chImported.applied.channels === true && chMemberCount() === 2, JSON.stringify({ ok: chImported.ok, applied: chImported.applied, members: chMemberCount() }))
 
-					chView.updateChannels([{ id: 'chA', groups: [{ id: 'ga', lineIds: ['k1'] }, { id: 'gb', lineIds: ['k9'] }] }])
+					chView.updateData({ channels: [{ id: 'chA', groups: [{ id: 'ga', lineIds: ['k1'] }, { id: 'gb', lineIds: ['k9'] }] }] })
 					await settle()
 					const chOnlyGroups = chView.getOptions().channels[0]
 					check('只写 groups 的声明原样保留（不补 lineIds，成员由 groups 决定）', chOnlyGroups.lineIds === undefined && chMemberCount() === 2 && chGroups().length === 2, JSON.stringify({ lineIds: chOnlyGroups.lineIds, members: chMemberCount(), groups: chGroups() }))
 
-					chView.updateChannels([{ id: 'chA', lineIds: ['k1'], groups: [{ id: 'ga', lineIds: ['k1'] }] }])
+					chView.updateData({ channels: [{ id: 'chA', lineIds: ['k1'], groups: [{ id: 'ga', lineIds: ['k1'] }] }] })
 					await settle()
 					chView.updateChannel('chA', { groups: [{ id: 'ga', lineIds: ['k1'] }, { id: 'gb', lineIds: ['k9'] }] })
 					await settle()
 					check('写回时成员表跟着分组对齐：挪进分组的回线补进 lineIds（下一轮整份提交不会被收窄剔掉）', chMemberCount() === 2 && JSON.stringify(chView.getOptions().channels[0].lineIds) === JSON.stringify(['k1', 'k9']), JSON.stringify(chView.getOptions().channels[0]))
 
-					chView.updateChannels([JSON.parse(JSON.stringify(chView.getOptions().channels[0]))])
+					chView.updateData({ channels: [JSON.parse(JSON.stringify(chView.getOptions().channels[0]))] })
 					await settle()
 					check('拆分 / 挪组之后把声明原样整份重提交：成员与分组一个都不丢', chMemberCount() === 2 && chGroups().length === 2, JSON.stringify({ groups: chGroups(), members: chMemberCount() }))
 
@@ -2471,8 +2516,8 @@
 					mvView.undo()
 					check('位置对账：撤销回到基线之后不再算「位置变过」', mvView.getMovedPoints().length === 0, JSON.stringify(mvView.getMovedPoints().map(item => item.id)))
 					mvView.updatePoint('mc', { x: 900, y: 0 })
-					mvView.updatePoints(mvView.getData().points)
-					check('位置对账：整份换节点数据（updatePoints）按新数据对齐', mvView.getMovedPoints().length === 0, JSON.stringify(mvView.getMovedPoints().map(item => item.id)))
+					mvView.updateData({ points: mvView.getData().points })
+					check('位置对账：整份换节点数据（updateData({ points })）按新数据对齐', mvView.getMovedPoints().length === 0, JSON.stringify(mvView.getMovedPoints().map(item => item.id)))
 					mvView.addPoints({ id: 'me', x: 600, y: 0 })
 					const mvAfterAdd = mvView.getMovedPoints().length
 					mvView.updatePoint('me', { x: 620, y: 20 })
@@ -2580,6 +2625,42 @@
 					ftView.destroy()
 					ftHost.remove()
 
+					// 拐点只有一道总闸：waypoint / waypointEditable 关闭时新增、移动与删除一起停
+					const waHost = document.createElement('div')
+					waHost.style.cssText = 'width:320px;height:200px'
+					document.body.appendChild(waHost)
+					const waLog = []
+					const waView = createGisView(waHost, {
+						points: [{ id: 'a', x: 0, y: 0 }, { id: 'b', x: 100, y: 0 }],
+						lines: [{ id: 'wa-line', from: 'a', to: 'b' }],
+						showGrid: false,
+						features: { waypoint: false },
+						onWaypointChange: payload => waLog.push(payload)
+					})
+					await settle(120)
+					const waState = waView.getFeatures()
+					waView.addWaypoint('wa-line', [50, 10])
+					await settle(60)
+					check('waypoint:false 总闸关闭新增、且不再有 waypointAdd 细分开关',
+						waState.waypoint === false && !Object.prototype.hasOwnProperty.call(waState, 'waypointAdd') && (waView.getData().lines[0].path ?? null) === null && waLog.length === 0,
+						JSON.stringify({ waypoint: waState.waypoint, keys: Object.keys(waState), path: waView.getData().lines[0].path, events: waLog.length }))
+					waView.setFeatures({ waypoint: true })
+					await settle(60)
+					waView.addWaypoint('wa-line', [50, 10])
+					await settle(60)
+					const waPath = waView.getData().lines[0].path
+					check('打开 waypoint 之后 addWaypoint 正常插入并发 add',
+						waView.getFeatures().waypoint === true && waPath?.length === 3 && waLog.length === 1 && waLog[0].phase === 'add',
+						JSON.stringify({ waypoint: waView.getFeatures().waypoint, path: waPath, events: waLog.map(item => item.phase) }))
+					waView.setFeatures({ waypoint: false })
+					const waRemoved = waView.removeWaypoint('wa-line', 1)
+					await settle(60)
+					check('waypoint:false 同时关闭已有拐点的删除（接口空操作、数据不动）',
+						waRemoved === waView && waView.getData().lines[0].path?.length === 3 && waLog.length === 1,
+						JSON.stringify({ removed: waRemoved, path: waView.getData().lines[0].path, events: waLog.length }))
+					waView.destroy()
+					waHost.remove()
+
 					// 缺省不记历史：一个开关都不开时与从前完全一样
 					const nhHost = document.createElement('div')
 					nhHost.style.cssText = 'width:320px;height:200px'
@@ -2600,7 +2681,7 @@
 					const stHost = document.createElement('div')
 					stHost.style.cssText = 'width:320px;height:200px'
 					document.body.appendChild(stHost)
-					const stView = createGisView(stHost, { points: [{ id: 'a', x: 0, y: 0 }, { id: 'b', x: 100, y: 40 }], features: 'static', showGrid: false })
+					const stView = createGisView(stHost, { points: [{ id: 'a', x: 0, y: 0, name: '甲' }, { id: 'b', x: 100, y: 40 }], features: 'static', showGrid: false, label: { content: '{name}' } })
 					await settle(150)
 					const stScale = stView.getCamera().scale
 					const stBox = stView.canvas.getBoundingClientRect()
@@ -2608,6 +2689,9 @@
 					await settle(80)
 					check('features 预设 static：滚轮不缩放', stView.getCamera().scale === stScale, `${stScale} -> ${stView.getCamera().scale}`)
 					check('features 预设 static：指针事件照旧（getFeatures 里 pan / zoom / hover / select 全是 false）', stView.getFeatures().pan === false && stView.getFeatures().zoom === false && stView.getFeatures().hover === false && stView.getFeatures().select === false, JSON.stringify(stView.getFeatures()))
+					check('features 预设 static：全部开关为 false，配了标签也不产生 DOM',
+						Object.values(stView.getFeatures()).every(value => value === false) && stView.el.querySelectorAll('.gis-view__label-layer--point .gis-view__label').length === 0,
+						JSON.stringify({ state: stView.getFeatures(), labels: stView.el.querySelectorAll('.gis-view__label-layer--point .gis-view__label').length }))
 					stView.destroy()
 					stHost.remove()
 
@@ -2753,7 +2837,7 @@
 					const exEmpty = await exView.exportSelection({ format: 'data' })
 					check('没选中节点就导出：ok: false + 原因，不抛异常', exEmpty.ok === false && /没有要导出的节点/.test(String(exEmpty.reason)) && exEmpty.points.length === 0 && exEmpty.image === null, exEmpty.reason)
 					check('导出失败时点 / 线 / 下标都回空数组', exEmpty.pointIndexes.length === 0 && exEmpty.lineIndexes.length === 0 && exEmpty.box === null, JSON.stringify({ points: exEmpty.pointIndexes, lines: exEmpty.lineIndexes, box: exEmpty.box }))
-					exView.select(['ex-a', 'ex-b'])
+					exView.selectFeatures(['ex-a', 'ex-b'])
 					const exCamera = exView.getCamera()
 					const exVisible = exView.listPoints({ visibleOnly: true }).length
 					const exData = await exView.exportSelection({ format: 'data', withLines: true })
@@ -2922,14 +3006,14 @@
 					rdView.on('selectChange', payload => rdSelects.push(payload))
 					await rdClick(rdView.project(0, 0), { ctrlKey: true })
 					check('Ctrl + 点已选中的节点：多选取反走 onSelectChange（count 0），不经过 onClick', rdSelects.length === 1 && rdSelects[0].count === 0 && rdSelects[0].items.length === 0 && rdClicks.length === 2 && rdView.getSelectionData().count === 0, JSON.stringify({ selects: rdSelects.length, clicks: rdClicks.length, count: rdSelects[0]?.count }))
-					rdView.select(['rd-a', 'rd-b'])
+					rdView.selectFeatures(['rd-a', 'rd-b'])
 					await rdRightClick(rdView.project(320, 0))
 					check('右键落在没选中的节点上：selected / wasSelected 都是 false，selection 照旧给整份选中集', rdMenus[0]?.type === 'point' && rdMenus[0]?.item?.id === 'rd-c' && rdMenus[0]?.selected === false && rdMenus[0]?.wasSelected === false && rdMenus[0]?.selection?.count === 2, JSON.stringify({ id: rdMenus[0]?.item?.id, selected: rdMenus[0]?.selected, count: rdMenus[0]?.selection?.count }))
 					await rdRightClick(rdView.project(0, 0))
 					check('右键落在已选中的节点上：wasSelected true（据此决定要不要保住整份多选）', rdMenus[1]?.selected === true && rdMenus[1]?.wasSelected === true && rdMenus[1]?.selection?.count === 2, JSON.stringify({ selected: rdMenus[1]?.selected, was: rdMenus[1]?.wasSelected }))
 					const rdPointInfo = rdView.getSelectionData()
 					check('getSelectionData 给读数（ids / count / 各类型条数）', rdPointInfo.count === 2 && rdPointInfo.pointCount === 2 && rdPointInfo.lineCount === 0 && rdPointInfo.channelCount === 0 && rdPointInfo.ids.join(',') === 'rd-a,rd-b', JSON.stringify(rdPointInfo))
-					rdView.select(['rd-1', 'rd-2'])
+					rdView.selectFeatures(['rd-1', 'rd-2'])
 					const rdInfo = rdView.getSelectionData()
 					check('getSelectionData：选中一条通道的两回线时 lines 两条、channels 去重成一个', rdInfo.count === 2 && rdInfo.lineCount === 2 && rdInfo.channelCount === 1 && rdInfo.lines.length === 2 && rdInfo.channels.length === 1 && rdInfo.channels[0].id === 'rd-ch' && rdInfo.lineIndexes.length === 2 && rdInfo.items.length === 2 && rdInfo.items[0].item === rdInfo.lines[0], JSON.stringify({ channels: rdInfo.channels.map(item => item.id), lineIndexes: rdInfo.lineIndexes }))
 
@@ -2960,7 +3044,8 @@
 						channels: csmBuilt.channels,
 						fitPadding: 60,
 						showGrid: false,
-						// 点回线摊开选中集：点击选中显式打开
+						// 点回线摊开选中集：先关拐点编辑，Ctrl 点击才能测「整批取反」；加点那一段再打开
+						waypointEditable: false,
 						features: { select: true }
 					})
 					await settle(140)
@@ -3001,9 +3086,99 @@
 					// 通道外的线路没有分组可摊，照旧只选它自己
 					await csmClick(csmView.project(100, 160))
 					check('通道外的线路不受选中模式影响（还是只选自己）', csmIds() === 'csm-solo', csmIds())
+					// Ctrl + 点击给通道回线加点：加完后的选中 / 高亮范围与普通单击共用 channelSelectMode
+					csmView.updateOptions({ waypointEditable: true })
+					await settle(60)
+					const csmGroupSkeleton = () => csmView.getChannelGroups('csm-ch').find(group => String(group.id) === 'csm-g2')?.skeleton.length ?? 0
+					const csmAddBefore = csmGroupSkeleton()
+					csmView.updateOptions({ channelSelectMode: 'line' })
+					await csmClick(csmView.project(50, 60), { ctrlKey: true })
+					const csmLineAdd = csmView.getSelectionData()
+					check('Ctrl + 点击加点（line）：只高亮被加点的那一条回线', csmLineAdd.lineCount === 1 && csmGroupSkeleton() === csmAddBefore + 1 && csmIds() !== 'csm-2,csm-3' && csmIds() !== 'csm-1,csm-2,csm-3', JSON.stringify({ ids: csmIds(), waypoints: csmGroupSkeleton() }))
+					csmView.updateOptions({ channelSelectMode: 'group' })
+					await csmClick(csmView.project(100, 60), { ctrlKey: true })
+					check('Ctrl + 点击加点（group）：加完连所在分组一起高亮', csmIds() === 'csm-2,csm-3' && csmGroupSkeleton() === csmAddBefore + 2, JSON.stringify({ ids: csmIds(), waypoints: csmGroupSkeleton() }))
+					csmView.updateOptions({ channelSelectMode: 'channel' })
+					await csmClick(csmView.project(150, 60), { ctrlKey: true })
+					check('Ctrl + 点击加点（channel）：加完整条通道一起高亮', csmIds() === 'csm-1,csm-2,csm-3' && csmView.getSelectionData().channelCount === 1 && csmGroupSkeleton() === csmAddBefore + 3, JSON.stringify({ ids: csmIds(), waypoints: csmGroupSkeleton() }))
 					csmView.destroy()
 					csmHost.remove()
 
+					/* 分组拐点 vertex 拖动：只平移当前分组同一 pathIndex 的顶点，其它拐点与分组不动 */
+					const vwdHost = document.createElement('div')
+					vwdHost.style.cssText = 'width:560px;height:360px'
+					document.body.appendChild(vwdHost)
+					const vwdView = createGisView(vwdHost, {
+						points: [{ id: 'vwd-a', x: 0, y: 0 }, { id: 'vwd-b', x: 360, y: 0 }],
+						lines: [
+							{ id: 'vwd-1', from: 'vwd-a', to: 'vwd-b' },
+							{ id: 'vwd-2', from: 'vwd-a', to: 'vwd-b' },
+							{ id: 'vwd-3', from: 'vwd-a', to: 'vwd-b' },
+							{ id: 'vwd-4', from: 'vwd-a', to: 'vwd-b' }
+						],
+						channels: [{
+							id: 'vwd-ch',
+							from: 'vwd-a',
+							to: 'vwd-b',
+							groups: [
+								{ id: 'vwd-g1', lineIds: ['vwd-1', 'vwd-2'], path: [[100, 80], [260, 80]] },
+								{ id: 'vwd-g2', lineIds: ['vwd-3', 'vwd-4'], path: [[100, -80], [260, -80]], waypointOffsets: { '1': { x: 0, y: 6 } } }
+							]
+						}],
+						waypointEditable: true,
+						waypointVisibility: 'always',
+						channelWaypointDragMode: 'vertex',
+						fitPadding: 70,
+						showGrid: false
+					})
+					await settle(160)
+					const vwdSend = (type, screen, extra = {}) => {
+						const box = vwdView.canvas.getBoundingClientRect()
+						vwdView.canvas.dispatchEvent(new PointerEvent(type, {
+							bubbles: true,
+							cancelable: true,
+							pointerId: 79,
+							pointerType: 'mouse',
+							button: extra.button ?? 0,
+							buttons: extra.buttons ?? (type === 'pointerup' ? 0 : 1),
+							clientX: box.left + screen[0],
+							clientY: box.top + screen[1],
+							...extra
+						}))
+					}
+					const vwdBefore = vwdView.getChannelGroupWaypoints('vwd-ch', 'vwd-g1')
+					const vwdOtherBefore = vwdView.getChannelGroupWaypoints('vwd-ch', 'vwd-g2')
+					const vwdWorldStart = vwdBefore.lines[0].waypoints[0]
+					const vwdWorldTarget = [vwdWorldStart[0] + 42, vwdWorldStart[1] + 30]
+					const vwdStart = vwdView.project(vwdWorldStart[0], vwdWorldStart[1])
+					const vwdTarget = vwdView.project(vwdWorldTarget[0], vwdWorldTarget[1])
+					const vwdObjectOffset = vwdView.getChannelGroups('vwd-ch').find(group => String(group.id) === 'vwd-g2')?.waypointOffsets?.['1']
+					const vwdObjectLane = vwdView.getChannels().find(group => String(group.id) === 'vwd-g2')?.offsets?.[0] ?? NaN
+					check('分组拐点偏移：{ x, y } 声明归一成 [dx, dy] 并参与实际路由', Array.isArray(vwdObjectOffset) && Math.abs(vwdObjectOffset[0]) <= 1e-3 && Math.abs(vwdObjectOffset[1] - 6) <= 1e-3 && Math.abs(vwdOtherBefore.lines[0].waypoints[0][1] - (vwdOtherBefore.skeleton[1][1] + vwdObjectLane + 6)) <= 1e-3, JSON.stringify({ offset: vwdObjectOffset, lane: vwdObjectLane, skeleton: vwdOtherBefore.skeleton, line: vwdOtherBefore.lines[0].waypoints[0] }))
+					vwdSend('pointermove', vwdStart, { buttons: 0 })
+					vwdSend('pointerdown', vwdStart, { buttons: 1 })
+					vwdSend('pointermove', [(vwdStart[0] + vwdTarget[0]) / 2, (vwdStart[1] + vwdTarget[1]) / 2], { buttons: 1 })
+					vwdSend('pointermove', vwdTarget, { buttons: 1 })
+					vwdSend('pointerup', vwdTarget, { buttons: 0 })
+					await settle(180)
+					const vwdAfter = vwdView.getChannelGroupWaypoints('vwd-ch', 'vwd-g1')
+					const vwdOtherAfter = vwdView.getChannelGroupWaypoints('vwd-ch', 'vwd-g2')
+					const vwdClose = (left, right, tolerance = 1e-3) => Math.abs(left - right) <= tolerance
+					const vwdMoved = vwdAfter.lines[0].waypoints[0]
+					const vwdPartnerBefore = vwdBefore.lines[1].waypoints[0]
+					const vwdPartnerAfter = vwdAfter.lines[1].waypoints[0]
+					const vwdAdjacent = vwdBefore.lines[0].waypoints[1]
+					const vwdAdjacentAfter = vwdAfter.lines[0].waypoints[1]
+					const vwdRoute = vwdView.getParallelGroups().find(group => String(group.group_id) === 'vwd-g1')
+					const vwdOffset = vwdAfter.waypointOffsets['1']
+					const vwdDeclared = vwdView.getOptions().channels[0].groups.find(group => String(group.id) === 'vwd-g1')?.waypointOffsets
+					check('分组拐点 vertex：目标分组的同序号拐点按世界增量平移', vwdClose(vwdMoved[0] - vwdWorldStart[0], 42) && vwdClose(vwdMoved[1] - vwdWorldStart[1], 30) && vwdClose(vwdPartnerAfter[0] - vwdPartnerBefore[0], 42) && vwdClose(vwdPartnerAfter[1] - vwdPartnerBefore[1], 30), JSON.stringify({ moved: vwdMoved, partnerDelta: [vwdPartnerAfter[0] - vwdPartnerBefore[0], vwdPartnerAfter[1] - vwdPartnerBefore[1]] }))
+					check('分组拐点 vertex：相邻拐点与其它分组一个都不动', vwdClose(vwdAdjacentAfter[0], vwdAdjacent[0]) && vwdClose(vwdAdjacentAfter[1], vwdAdjacent[1]) && JSON.stringify(vwdOtherAfter.lines.map(line => line.path)) === JSON.stringify(vwdOtherBefore.lines.map(line => line.path)), JSON.stringify({ adjacent: vwdAdjacentAfter, other: vwdOtherAfter.lines[0].waypoints }))
+					check('分组拐点 vertex：只写 waypointOffsets，不改分组公共 path', vwdOffset && Object.keys(vwdAfter.waypointOffsets).join(',') === '1' && JSON.stringify(vwdAfter.path) === JSON.stringify(vwdBefore.path) && vwdDeclared && vwdClose(vwdDeclared['1']?.[0] ?? NaN, vwdOffset[0]) && vwdClose(vwdDeclared['1']?.[1] ?? NaN, vwdOffset[1]), JSON.stringify({ offsets: vwdAfter.waypointOffsets, declared: vwdDeclared, path: vwdAfter.path }))
+					check('分组拐点 vertex：parallel_groups.group_route 带刚性偏移（导出不回到旧骨架）', Array.isArray(vwdOffset) && vwdClose(vwdRoute?.group_route?.[1]?.[0] ?? NaN, vwdBefore.skeleton[1][0] + vwdOffset[0]) && vwdClose(vwdRoute?.group_route?.[1]?.[1] ?? NaN, vwdBefore.skeleton[1][1] + vwdOffset[1]), JSON.stringify(vwdRoute?.group_route ?? null))
+					vwdView.destroy()
+					vwdHost.remove()
+
 					/* 删除（Delete 键）：先出载荷说清「删什么 / 连带什么 / 能按哪些范围删」，确认之后才动数据 */
 					const rmHost = document.createElement('div')
 					rmHost.style.cssText = 'width:520px;height:320px'
@@ -3039,7 +3214,7 @@
 					const rmKey = (key, extra = {}) => {
 						rmView.el.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true, cancelable: true, ...extra }))
 					}
-					rmView.select(['rm-2'])
+					rmView.selectFeatures(['rm-2'])
 					rmKey('Delete')
 					await settle(40)
 					const rmPlan = rmView.getRemoveRequest()
@@ -3050,13 +3225,13 @@
 					rmView.cancelRemove()
 					await settle(40)
 					check('取消删除：数据不动、事件给 phase: cancel、待确认的载荷收掉', rmView.getData().lines.length === 4 && rmEvents.length === 2 && rmEvents[1].phase === 'cancel' && rmEvents[1].cancelled === true && rmView.getRemoveRequest() === null, JSON.stringify(rmEvents.map(item => item.phase)))
-					rmView.select(['rm-2'])
+					rmView.selectFeatures(['rm-2'])
 					rmKey('Delete')
 					await settle(40)
 					rmView.resolveRemove('channels')
 					await settle(80)
 					check('按「整条通道」确认：三条回线一起删、通道声明也摘掉，通道外的线路留着', rmView.getData().lines.length === 1 && rmView.getData().lines[0].id === 'rm-solo' && rmView.getOptions().channels.length === 0 && rmEvents.at(-1).phase === 'remove' && rmEvents.at(-1).scope === 'channels' && rmEvents.at(-1).result.lineIds.length === 3, JSON.stringify({ lines: rmView.getData().lines.map(item => item.id), channels: rmView.getOptions().channels.length }))
-					rmView.select(['rm-a'])
+					rmView.selectFeatures(['rm-a'])
 					rmKey('Delete')
 					await settle(40)
 					const rmPointPlan = rmView.getRemoveRequest()
@@ -3068,7 +3243,7 @@
 					await settle(80)
 					check('撤销一步：节点与连带删掉的线路一起回来', rmView.getData().points.length === 3 && rmView.getData().lines.length === 1 && rmView.getData().lines[0].id === 'rm-solo', JSON.stringify({ points: rmView.getData().points.length, lines: rmView.getData().lines.map(item => item.id) }))
 					rmView.updateOptions({ shortcuts: { remove: 'shift+delete' } })
-					rmView.select(['rm-solo'])
+					rmView.selectFeatures(['rm-solo'])
 					rmKey('Delete')
 					await settle(40)
 					check('快捷键单独配：单独的 Delete 不再触发删除', rmView.getRemoveRequest() === null && rmView.getData().lines.length === 1, JSON.stringify(rmView.getRemoveRequest()))
@@ -3077,7 +3252,7 @@
 					check('配成 Shift+Delete：按住 Shift 再按才出载荷', Boolean(rmView.getRemoveRequest()) && rmView.getRemoveRequest().counts.lines === 1, JSON.stringify(rmView.getRemoveRequest()?.counts))
 					rmView.cancelRemove()
 					/* 待确认期间数据换过：确认时整条请求作废（不按旧下标删），事件给 phase: cancel + invalidated */
-					rmView.select(['rm-solo'])
+					rmView.selectFeatures(['rm-solo'])
 					rmKey('Delete', { shiftKey: true })
 					await settle(40)
 					rmView.updateData([{ id: 'rm-a', x: 0, y: 0 }, { id: 'rm-b', x: 200, y: 0 }, { id: 'rm-c', x: 100, y: -80 }, { id: 'rm-d', x: 40, y: 40 }], [{ id: 'rm-solo', from: 'rm-a', to: 'rm-c' }])
@@ -3099,44 +3274,44 @@
 						showGrid: false
 					})
 					await settle(120)
-					rmOffView.select(['rm-off-line'])
+					rmOffView.selectFeatures(['rm-off-line'])
 					rmOffView.el.dispatchEvent(new KeyboardEvent('keydown', { key: 'Delete', bubbles: true, cancelable: true }))
 					await settle(40)
 					check('开关关着（features.remove 缺省）：Delete 不出删除载荷，数据不动', rmOffView.getRemoveRequest() === null && rmOffView.getData().lines.length === 1, JSON.stringify({ lines: rmOffView.getData().lines.length }))
 					rmOffView.destroy()
 					rmOffHost.remove()
 
-					const rdStations = rdView.exportStationData()
-					check('exportStationData：new.json 的 station_data 口径（列名 / 母线清单 / 业务列原样透传）', rdStations.ok === true && rdStations.station_data.length === 3 && rdStations.station_data[0].station_id === 'rd-a' && rdStations.station_data[0].station_name === '甲站' && rdStations.station_data[0].vn_kv === 220 && rdStations.station_data[0].bus_id_list.join(',') === 'b-1,b-2' && Array.isArray(rdStations.station_data[0].trafo_id_list) && rdStations.station_data[0].max_loading_rate === 0.8, JSON.stringify(rdStations.station_data[0]).slice(0, 200))
-					check('exportStationData：四至范围与 show_station_list / show_station_data 一起给', Number.isFinite(rdStations.max_lat) && Number.isFinite(rdStations.min_lon) && rdStations.show_station_list.join(',') === 'b-1,b-2,b-3' && rdStations.show_station_data[0].join(',') === 'b-1,b-2', JSON.stringify({ box: [rdStations.min_lon, rdStations.min_lat, rdStations.max_lon, rdStations.max_lat], list: rdStations.show_station_list }))
-					const rdLean = rdView.exportStationData({ points: ['rd-a'], box: false, showStation: false })
-					check('exportStationData：box / showStation 关掉就不带那几列，只留选中的这一个站', rdLean.station_data.length === 1 && !('max_lat' in rdLean) && !('show_station_list' in rdLean), JSON.stringify(Object.keys(rdLean)))
+					const rdStations = rdView.exportData({ format: 'new', parts: ['station'] })
+					check('exportData(format: new, parts: station)：new.json 的 station_data 口径（列名 / 母线清单 / 业务列原样透传）', rdStations.ok === true && rdStations.station_data.length === 3 && rdStations.station_data[0].station_id === 'rd-a' && rdStations.station_data[0].station_name === '甲站' && rdStations.station_data[0].vn_kv === 220 && rdStations.station_data[0].bus_id_list.join(',') === 'b-1,b-2' && Array.isArray(rdStations.station_data[0].trafo_id_list) && rdStations.station_data[0].max_loading_rate === 0.8, JSON.stringify(rdStations.station_data[0]).slice(0, 200))
+					check('exportData(format: new, parts: station)：四至范围与 show_station_list / show_station_data 一起给', Number.isFinite(rdStations.max_lat) && Number.isFinite(rdStations.min_lon) && rdStations.show_station_list.join(',') === 'b-1,b-2,b-3' && rdStations.show_station_data[0].join(',') === 'b-1,b-2', JSON.stringify({ box: [rdStations.min_lon, rdStations.min_lat, rdStations.max_lon, rdStations.max_lat], list: rdStations.show_station_list }))
+					const rdLean = rdView.exportData({ format: 'new', parts: ['station'], points: ['rd-a'], box: false, showStation: false })
+					check('exportData(format: new, parts: station)：box / showStation 关掉就不带那几列，只留选中的这一个站', rdLean.station_data.length === 1 && !('max_lat' in rdLean) && !('show_station_list' in rdLean), JSON.stringify(Object.keys(rdLean)))
 					const rdCopyRow = rdStations.station_data[0]
 					rdCopyRow.bus_id_list.push('改一改')
 					check('导出的是拷贝：改导出结果不动组件里的那一份', rdView.getData().points[0].bus_id_list.length === 2, `组件里 ${rdView.getData().points[0].bus_id_list.length} 个`)
-					const rdPoints = rdView.exportPointData()
-					check('exportPointData：test.json 的 point_data 口径（同一份数据换列名，带分区列）', rdPoints.ok === true && rdPoints.point_data.length === 3 && rdPoints.point_data[0].station_id === 'rd-a' && rdPoints.point_data[0].station_name === '甲站' && rdPoints.point_data[0].lon === 0 && rdPoints.point_data[0].lat === 0 && rdPoints.counts.points === 3, JSON.stringify({ keys: Object.keys(rdPoints.point_data[0] ?? {}).length, count: rdPoints.counts.points, lon: rdPoints.point_data[0].lon, lat: rdPoints.point_data[0].lat }))
-					check('exportPointData：zone_id / zone_name 两列在（没给值就是 null）', 'zone_id' in rdPoints.point_data[0] && 'zone_name' in rdPoints.point_data[0] && rdPoints.point_data[0].bus_name_list.length === 2, JSON.stringify({ zone_id: rdPoints.point_data[0].zone_id }))
-					const rdLines = rdView.exportLineData()
+					const rdPoints = rdView.exportData({ format: 'test', parts: ['station'] })
+					check('exportData(format: test, parts: station)：test.json 的 point_data 口径（同一份数据换列名，带分区列）', rdPoints.ok === true && rdPoints.point_data.length === 3 && rdPoints.point_data[0].station_id === 'rd-a' && rdPoints.point_data[0].station_name === '甲站' && rdPoints.point_data[0].lon === 0 && rdPoints.point_data[0].lat === 0 && rdPoints.counts.points === 3, JSON.stringify({ keys: Object.keys(rdPoints.point_data[0] ?? {}).length, count: rdPoints.counts.points, lon: rdPoints.point_data[0].lon, lat: rdPoints.point_data[0].lat }))
+					check('exportData(format: test, parts: station)：zone_id / zone_name 两列在（没给值就是 null）', 'zone_id' in rdPoints.point_data[0] && 'zone_name' in rdPoints.point_data[0] && rdPoints.point_data[0].bus_name_list.length === 2, JSON.stringify({ zone_id: rdPoints.point_data[0].zone_id }))
+					const rdLines = rdView.exportData({ format: 'test', parts: ['line'] })
 					const rdChannelLine = rdLines.line_data.filter(row => row.channel_id === 'rd-ch')
-					check('exportLineData：通道回线带上 channel_id / channel_name / parallel_group_id 与第几回', rdLines.ok === true && rdLines.line_data.length === 3 && rdChannelLine.length === 2 && rdChannelLine[0].parallel_group_id !== undefined && rdChannelLine[0].index === 0 && rdChannelLine[1].index === 1 && rdChannelLine.every(row => Array.isArray(row.coords_list) && row.coords_list.length >= 2), JSON.stringify(rdChannelLine.map(row => ({ id: row.line_id, group: row.parallel_group_id, index: row.index }))))
-					check('exportLineData：不在通道里的线路 channel_id 给 null，折线就是画出来的那一份', rdLines.line_data.some(row => row.line_id === 'rd-solo' && row.channel_id === null && row.coords_list.length === 3), JSON.stringify(rdLines.line_data.map(row => ({ id: row.line_id, channel: row.channel_id, points: row.coords_list.length }))))
-					const rdChannels = rdView.exportChannelData()
-					check('exportChannelData：一条通道一行，回线在 line_data 里、路由在 coords 里', rdChannels.ok === true && rdChannels.channel_data.length === 1 && rdChannels.counts.channels === 1 && rdChannels.counts.lines === 2 && rdChannels.channel_data[0].line_data.length === 2 && Array.isArray(rdChannels.channel_data[0].coords) && rdChannels.channel_data[0].coords.length >= 2, JSON.stringify({ channels: rdChannels.counts.channels, lines: rdChannels.counts.lines, coords: rdChannels.channel_data[0].coords.length }))
-					const rdChannelLean = rdView.exportChannelData({ channels: [0], lines: ['rd-1'] })
-					check('exportChannelData：options.lines 能把通道里的 line_data 收到这几条回线', rdChannelLean.channel_data[0].line_data.length === 1 && rdChannelLean.channel_data[0].line_data[0].line_id === 'rd-1', JSON.stringify(rdChannelLean.channel_data[0].line_data.map(row => row.line_id)))
-					const rdGroupsOff = rdView.exportParallelGroups()
-					check('exportParallelGroups：没加过拐点时是空的一份（与通道数据各走各的）', rdGroupsOff.ok === true && rdGroupsOff.parallel_groups.length === 0 && rdGroupsOff.counts.parallelGroups === 0, JSON.stringify(rdGroupsOff.counts))
+					check('exportData(format: test, parts: line)：通道回线带上 channel_id / channel_name / parallel_group_id 与第几回', rdLines.ok === true && rdLines.line_data.length === 3 && rdChannelLine.length === 2 && rdChannelLine[0].parallel_group_id !== undefined && rdChannelLine[0].index === 0 && rdChannelLine[1].index === 1 && rdChannelLine.every(row => Array.isArray(row.coords_list) && row.coords_list.length >= 2), JSON.stringify(rdChannelLine.map(row => ({ id: row.line_id, group: row.parallel_group_id, index: row.index }))))
+					check('exportData(format: test, parts: line)：不在通道里的线路 channel_id 给 null，折线就是画出来的那一份', rdLines.line_data.some(row => row.line_id === 'rd-solo' && row.channel_id === null && row.coords_list.length === 3), JSON.stringify(rdLines.line_data.map(row => ({ id: row.line_id, channel: row.channel_id, points: row.coords_list.length }))))
+					const rdChannels = rdView.exportData({ format: 'new', parts: ['channel'] })
+					check('exportData(format: new, parts: channel)：一条通道一行，回线在 line_data 里、路由在 coords 里', rdChannels.ok === true && rdChannels.channel_data.length === 1 && rdChannels.counts.channels === 1 && rdChannels.counts.lines === 2 && rdChannels.channel_data[0].line_data.length === 2 && Array.isArray(rdChannels.channel_data[0].coords) && rdChannels.channel_data[0].coords.length >= 2, JSON.stringify({ channels: rdChannels.counts.channels, lines: rdChannels.counts.lines, coords: rdChannels.channel_data[0].coords.length }))
+					const rdChannelLean = rdView.exportData({ format: 'new', parts: ['channel'], channels: [0], lines: ['rd-1'] })
+					check('exportData(format: new, parts: channel)：options.lines 能把通道里的 line_data 收到这几条回线', rdChannelLean.channel_data[0].line_data.length === 1 && rdChannelLean.channel_data[0].line_data[0].line_id === 'rd-1', JSON.stringify(rdChannelLean.channel_data[0].line_data.map(row => row.line_id)))
+					const rdGroupsOff = rdView.exportData({ format: 'test', parts: ['waypoint'] })
+					check('exportData(format: test, parts: waypoint)：没加过拐点时是空的一份（与通道数据各走各的）', rdGroupsOff.ok === true && rdGroupsOff.parallel_groups.length === 0 && rdGroupsOff.counts.parallelGroups === 0, JSON.stringify(rdGroupsOff.counts))
 					rdView.addWaypoint('rd-1', [80, 40])
 					await settle(80)
-					const rdGroupsOn = rdView.exportParallelGroups()
-					check('加了拐点之后：parallel_groups 单独给出这一组（group_id / member_line_ids / group_route 对得上）', rdGroupsOn.parallel_groups.length === 1 && rdGroupsOn.counts.parallelGroups === 1 && rdGroupsOn.counts.waypoints >= 1 && Array.isArray(rdGroupsOn.parallel_groups[0].group_route) && rdGroupsOn.parallel_groups[0].group_route.length >= 3 && rdGroupsOn.parallel_groups[0].member_line_ids.length >= 1, JSON.stringify(rdGroupsOn.parallel_groups[0]).slice(0, 200))
-					const rdGroupsAll = rdView.exportParallelGroups({ all: true })
-					check('exportParallelGroups：all 为 true 时把没编辑过的分组 / 带折线的线路也列出来', rdGroupsAll.parallel_groups.some(group => String(group.group_id) === 'rd-solo'), JSON.stringify(rdGroupsAll.parallel_groups.map(group => group.group_id)))
-					const rdOneGroup = rdView.exportParallelGroups({ channels: ['rd-ch'] })
-					check('exportParallelGroups：channels 只留这条通道那一份', rdOneGroup.parallel_groups.length === 1 && rdOneGroup.parallel_groups[0].group_route.length >= 3, JSON.stringify(rdOneGroup.parallel_groups.map(group => group.group_id)))
-					const rdNoGroup = rdView.exportParallelGroups({ channels: ['没有这条通道'] })
-					check('exportParallelGroups：通道 id 解不出来时给空表 + 一条 warnings', rdNoGroup.parallel_groups.length === 0 && rdNoGroup.warnings.length === 1, JSON.stringify(rdNoGroup.warnings))
+					const rdGroupsOn = rdView.exportData({ format: 'test', parts: ['waypoint'] })
+					check('加了拐点之后：parallel_groups 单独给出这一组（group_id / member_line_ids / group_route 对得上）', rdGroupsOn.parallel_groups.length === 1 && rdGroupsOn.counts.parallelGroups === 1 && Array.isArray(rdGroupsOn.parallel_groups[0].group_route) && rdGroupsOn.parallel_groups[0].group_route.length >= 3 && rdGroupsOn.parallel_groups[0].member_line_ids.length >= 1, JSON.stringify(rdGroupsOn.parallel_groups[0]).slice(0, 200))
+					const rdGroupsAll = rdView.exportData({ format: 'test', parts: ['waypoint'], all: true })
+					check('exportData(format: test, parts: waypoint)：all 为 true 时把没编辑过的分组 / 带折线的线路也列出来', rdGroupsAll.parallel_groups.some(group => String(group.group_id) === 'rd-solo'), JSON.stringify(rdGroupsAll.parallel_groups.map(group => group.group_id)))
+					const rdOneGroup = rdView.exportData({ format: 'test', parts: ['waypoint'], channels: ['rd-ch'] })
+					check('exportData(format: test, parts: waypoint)：channels 只留这条通道那一份', rdOneGroup.parallel_groups.length === 1 && rdOneGroup.parallel_groups[0].group_route.length >= 3, JSON.stringify(rdOneGroup.parallel_groups.map(group => group.group_id)))
+					const rdNoGroup = rdView.exportData({ format: 'test', parts: ['waypoint'], channels: ['没有这条通道'] })
+					check('exportData(format: test, parts: waypoint)：通道 id 解不出来时给空表 + 一条 warnings', rdNoGroup.parallel_groups.length === 0 && rdNoGroup.warnings.length === 1, JSON.stringify(rdNoGroup.warnings))
 					const rdFour = rdView.exportData({ format: 'view' })
 					check("exportData format: view（缺省）：points / lines / channels / parallelGroups 四份分开", rdFour.ok === true && rdFour.points.length === 3 && rdFour.lines.length === 3 && rdFour.channels.length === 1 && Array.isArray(rdFour.parallelGroups) && rdFour.counts.points === 3 && rdFour.counts.lines === 3 && rdFour.counts.channels === 1, JSON.stringify(rdFour.counts))
 					const rdNew = rdView.exportData({ format: 'new' })
@@ -3145,6 +3320,32 @@
 					check("exportData format: test：test.json 口径的整份（point_data + line_data + parallel_groups）", rdTest.point_data.length === 3 && rdTest.line_data.length === 3 && Array.isArray(rdTest.switch_data) && rdTest.parallel_groups.length >= 1 && rdTest.counts.points === 3, JSON.stringify(rdTest.counts))
 					const rdFiltered = rdView.exportData({ format: 'view', points: ['rd-a'], lines: ['rd-solo'], channels: ['rd-ch'] })
 					check('exportData：三个筛选取一部分时只导这几个（id / 下标 / { id } 都认）', rdFiltered.points.length === 1 && rdFiltered.lines.length === 1 && rdFiltered.channels.length === 1 && rdFiltered.lines[0].line_id === 'rd-solo', JSON.stringify(rdFiltered.counts))
+					const rdStationOnly = rdView.exportData({ format: 'view', parts: ['station'] })
+					check('exportData：parts 只留场站时不生成线路 / 通道 / 拐点', rdStationOnly.points.length === 3 && rdStationOnly.lines === undefined && rdStationOnly.channels === undefined && rdStationOnly.parallelGroups === undefined && rdStationOnly.counts.lines === 0 && rdStationOnly.counts.channels === 0, JSON.stringify(rdStationOnly.counts))
+					const rdViewportUnified = rdView.exportData({ scope: 'viewport', margin: 0 })
+					const rdViewportRepeat = rdView.exportData({ scope: 'viewport' })
+					check('exportData(scope: viewport) 可重复且带 scope / viewRect / margin', JSON.stringify(rdViewportUnified) === JSON.stringify(rdViewportRepeat) && rdViewportUnified.scope === 'viewport' && rdViewportUnified.viewRect && rdViewportUnified.margin === 0, JSON.stringify({ scope: rdViewportUnified.scope, rect: rdViewportUnified.viewRect, margin: rdViewportUnified.margin }))
+					const rdSelectionUnified = rdView.exportData({ scope: 'selection', points: ['rd-a', 'rd-b'], parts: ['station', 'channel'] })
+					const rdSelectionRepeat = rdView.exportData({ scope: 'selection', points: ['rd-a', 'rd-b'], parts: ['station', 'channel'] })
+					check('exportData(scope: selection) 可重复且把下标 / parts 一并回显', JSON.stringify(rdSelectionUnified) === JSON.stringify(rdSelectionRepeat) && rdSelectionUnified.scope === 'selection' && rdSelectionUnified.pointIndexes.length === 2 && Array.isArray(rdSelectionUnified.channelIndexes), JSON.stringify({ scope: rdSelectionUnified.scope, points: rdSelectionUnified.pointIndexes, channels: rdSelectionUnified.channelIndexes }))
+					const rdRemovedAliases = ['exportStationData', 'exportPointData', 'exportLineData', 'exportChannelData', 'exportParallelGroups', 'exportViewportData', 'exportSelectionData']
+					check('七个旧分项导出别名已经从实例上删除，只保留统一 exportData', rdRemovedAliases.every(name => rdView[name] === undefined) && typeof rdView.exportData === 'function', rdRemovedAliases.map(name => `${name}:${typeof rdView[name]}`).join(' / '))
+					const rdRemovedThinWrappers = ['setEffects', 'setPointSize', 'setPointSymbol', 'setPointColor', 'setLineWidth', 'setLineColor', 'setChannelWidth', 'setChannelNodeWidth', 'setChannelInset', 'setChannelTangentInset', 'setChannelName', 'clearFilter', 'clearDropPreview']
+					check('十三个重复的单项 / 清空快捷方法已经从实例上删除，统一走 update* / setFilter(null) / setDropPreview(null)', rdRemovedThinWrappers.every(name => rdView[name] === undefined) && typeof rdView.updatePoint === 'function' && typeof rdView.updateLine === 'function' && typeof rdView.updateChannel === 'function' && typeof rdView.updateOptions === 'function' && typeof rdView.setFilter === 'function' && typeof rdView.setDropPreview === 'function', rdRemovedThinWrappers.map(name => `${name}:${typeof rdView[name]}`).join(' / '))
+					const rdInputViewport = rdView.exportData({ scope: 'viewport', format: 'input' })
+					check('format: input 的视口结果保持回灌形状，不额外夹带 scope / viewRect / margin', Array.isArray(rdInputViewport.points) && !('scope' in rdInputViewport) && !('viewRect' in rdInputViewport) && !('margin' in rdInputViewport), Object.keys(rdInputViewport).join(','))
+					const rdChannelLeanUnified = rdView.exportData({ format: 'new', parts: ['channel'], channels: ['rd-ch'], lines: ['rd-1'] })
+					check('exportData：统一入口下通道的 line_data 仍按 lines 收窄（只留选中的回线）', rdChannelLeanUnified.channel_data.length === 1 && rdChannelLeanUnified.channel_data[0].line_data.length === 1 && rdChannelLeanUnified.channel_data[0].line_data[0].line_id === 'rd-1', JSON.stringify(rdChannelLeanUnified.channel_data[0]?.line_data?.map(row => row.line_id)))
+					const rdFull = rdView.exportData({ format: 'full', scope: 'viewport' })
+					check('exportData：format full 始终返回标准文档本身，不夹带 scope / viewRect 读数', rdFull.format === 'gis-view' && !('scope' in rdFull) && !('viewRect' in rdFull) && !('counts' in rdFull), Object.keys(rdFull).join(','))
+					let rdScopeThrew = ''
+					try {
+						rdView.exportData({ scope: 'window' })
+					}
+					catch (error) {
+						rdScopeThrew = String(error && error.message ? error.message : error)
+					}
+					check('exportData：scope 写错直接抛异常（不静默按全量导）', /viewport/.test(rdScopeThrew) && /selection/.test(rdScopeThrew) && /window/.test(rdScopeThrew), rdScopeThrew)
 					const rdBad = rdView.exportData({ format: 'test', lines: ['没有这条线'] })
 					check('解不出的引用记进 warnings，其余照常导出（ok 仍是 true）', rdBad.ok === true && rdBad.line_data.length === 0 && rdBad.warnings.length === 1 && /没找到/.test(String(rdBad.warnings[0])), JSON.stringify(rdBad.warnings))
 					let rdThrew = ''
@@ -3229,9 +3430,9 @@
 					check('selectFeatures：拾取载荷（pickAt 的结果）可以直接喂进来', apiIds() === 'api-a', apiIds())
 					apiView.selectFeatures(apiView.search({ keyword: 'api-l1' }).hits[0])
 					check('selectFeatures：搜索命中（kind: line）可以直接喂进来', apiIds() === 'api-l1', apiIds())
-					apiView.select(null)
+					apiView.selectFeatures(null)
 					const apiEmpty = apiView.getSelectionData()
-					check('select(null) 清空选中，getSelectionData 给空的一份（bounds 是 null）', apiEmpty.count === 0 && apiEmpty.ids.length === 0 && apiEmpty.bounds === null, JSON.stringify(apiEmpty.count))
+					check('selectFeatures(null) 清空选中，getSelectionData 给空的一份（bounds 是 null）', apiEmpty.count === 0 && apiEmpty.ids.length === 0 && apiEmpty.bounds === null, JSON.stringify(apiEmpty.count))
 					apiSend('pointermove', apiPointScreen)
 					apiSend('pointerdown', apiPointScreen, { button: 0, buttons: 1 })
 					apiSend('pointerup', apiPointScreen, { button: 0, buttons: 0 })
@@ -3282,7 +3483,7 @@
 					check('focusOn(一批, { select: true })：被聚焦的这一批同时选中（整份选中集换成这三个）', apiView.getSelectionData().ids.join(',') === 'api-a,api-b,api-c' && apiBeforeFocusSelect === 'api-a,api-b,api-c' && apiView.getSelectionData().count === 3, `${apiBeforeFocusSelect} -> ${apiView.getSelectionData().ids.join(',')}`)
 					apiView.focusOn('api-a', { select: true, mode: 'remove' })
 					check("focusOn(..., { select: true, mode: 'remove' })：只把聚焦的这个从选中集里去掉", apiView.getSelectionData().ids.join(',') === 'api-b,api-c', apiView.getSelectionData().ids.join(','))
-					apiView.select(null)
+					apiView.selectFeatures(null)
 					const apiAreaScale = apiView.getCamera().scale
 					apiView.focusOn('api-b', { maxZoom: 12 })
 					const apiZoomCamera = apiView.getCamera()
@@ -3433,7 +3634,8 @@
 					const pluginLog = []
 					const pluginWarnings = []
 					const pluginErrors = []
-					let optionPluginInstance = null
+					let optionPluginInstance = null
+					let optionPluginContext = null
 					const pluginView = createGisView(pluginHost, {
 						points: [{ id: 'pg-1', x: 0, y: 0 }],
 						lines: [],
@@ -3441,19 +3643,22 @@
 						height: 160,
 						onWarning: text => pluginWarnings.push(text),
 						onError: text => pluginErrors.push(text),
-						plugins: [v => {
+						plugins: [(v, context) => {
 							optionPluginInstance = v
+							optionPluginContext = context
 							return { destroy: () => pluginLog.push('options') }
 						}]
 					})
-					check('options.plugins 拿到的就是实例本身', optionPluginInstance === pluginView)
-					let usePluginInstance = null
+					check('options.plugins 拿到实例本身与带 apiVersion 的只读上下文', optionPluginInstance === pluginView && optionPluginContext?.apiVersion === 1 && optionPluginContext.view === pluginView && Object.isFrozen(optionPluginContext), JSON.stringify(optionPluginContext ? { apiVersion: optionPluginContext.apiVersion, sameView: optionPluginContext.view === pluginView } : null))
+					let usePluginInstance = null
+					let usePluginContext = null
 					let useDestroyCount = 0
-					const disposeUse = pluginView.use(v => {
+					const disposeUse = pluginView.use((v, context) => {
 						usePluginInstance = v
+						usePluginContext = context
 						return { destroy: () => { useDestroyCount += 1 } }
 					})
-					check('use() 立即执行、拿到的也是同一个实例', usePluginInstance === pluginView)
+					check('use() 立即执行，实例与带版本的上下文都和 options.plugins 一致', usePluginInstance === pluginView && usePluginContext?.apiVersion === 1 && usePluginContext.view === pluginView && Object.isFrozen(usePluginContext))
 					disposeUse()
 					disposeUse()
 					check('use() 返回的卸载函数跑插件的 destroy（重复调用只跑一次）', useDestroyCount === 1, String(useDestroyCount))
@@ -3664,7 +3869,7 @@
 				await edgeSleep(120)
 				const shiftDropFrame = await frameOf(shiftView)
 				check('删掉选中里的那一条：读数只剩 c，b 的位置不留选中色', shiftView.getSelectionData().ids.join(',') === 'sp-c' && !pixelIs(shiftDropFrame, shiftSpotB, 'green') && pixelIs(shiftDropFrame, shiftSpotC, 'green'), JSON.stringify({ ids: shiftView.getSelectionData().ids, b: pixelIs(shiftDropFrame, shiftSpotB, 'green'), c: pixelIs(shiftDropFrame, shiftSpotC, 'green') }))
-				shiftView.select(null)
+				shiftView.selectFeatures(null)
 				await edgeSleep(120)
 				const shiftClearFrame = await frameOf(shiftView)
 				check('删点之后取消选中：c 的选中色收掉、回到自己的底色（不会停在别人身上）', !pixelIs(shiftClearFrame, shiftSpotC, 'green') && pixelIsWhite(shiftClearFrame, shiftSpotC), JSON.stringify({ green: pixelIs(shiftClearFrame, shiftSpotC, 'green'), white: pixelIsWhite(shiftClearFrame, shiftSpotC) }))
@@ -3691,7 +3896,7 @@
 				})
 				await edgeSleep(120)
 				const lineSpot = lineShiftView.project(200, 120)
-				lineShiftView.select('ssl2')
+				lineShiftView.selectFeatures('ssl2')
 				lineShiftView.removeLines('ssl1')
 				await edgeSleep(120)
 				const lineShiftFrame = await frameOf(lineShiftView)
@@ -3712,7 +3917,7 @@
 				})
 				await edgeSleep(120)
 				const mergeSpotC = mergeShiftView.project(280, 0)
-				mergeShiftView.select('mp-c')
+				mergeShiftView.selectFeatures('mp-c')
 				mergeShiftView.mergePoints('mp-a', 'mp-b')
 				await edgeSleep(120)
 				const mergeShiftFrame = await frameOf(mergeShiftView)
@@ -3734,7 +3939,7 @@
 				await edgeSleep(120)
 				const fallbackSpotB = fallbackShiftView.project(140, 0)
 				const fallbackSpotC = fallbackShiftView.project(280, 0)
-				fallbackShiftView.select('fp-c')
+				fallbackShiftView.selectFeatures('fp-c')
 				fallbackShiftView.removePoints('fp-a')
 				await edgeSleep(120)
 				const fallbackFrame = await frameOf(fallbackShiftView)
@@ -3887,11 +4092,37 @@
 					/<image[^>]+href="data:image\/png;base64/.test(symSvg),
 					(symSvg.match(/<image[^>]*/) ?? ['没有 <image>'])[0].slice(0, 90))
 				check('自定义图元：listSymbols 报得出注册过的名字', symView.listSymbols().includes('三角'), JSON.stringify(symView.listSymbols()))
+				// 同名覆盖要换一张贴图：画笔从三角形换成整块实心方块，斜角立刻从透明变成实色。
+				// 贴图缓存的来源键没带注册代次时，这里会继续拿旧三角形，画面看起来像「注册没生效」。
+				const symBlockPainter = (context, info) => {
+					context.fillStyle = '#c837d6'
+					context.fillRect(0, 0, info.width, info.height)
+				}
+				symView.registerSymbol('三角', symBlockPainter)
+				await edgeSleep(240)
+				const symReregistered = await symShot(symView)
+				const symReregisteredCorner = symRead(symReregistered, symCorner)
+				check('自定义图元：同名重新注册会重新烘焙贴图（三角形换成整块色块，原来的斜角变实了）',
+					symReregisteredCorner[3] > 200 && symReregisteredCorner[0] > 150 && symReregisteredCorner[1] < 120 && symReregisteredCorner[2] > 150,
+					symReregisteredCorner.join(','))
 				symView.registerSymbol('   ', trianglePainter)
 				symView.registerSymbol('空画笔', null)
 				check('自定义图元：名字空的 / 画笔不是函数只报一条 onWarning，注册表不动',
 					warnedNames.length === 2 && symView.listSymbols().length === 1 && warnedNames.every(message => message.includes('registerSymbol')),
 					warnedNames.join(' | '))
+				const scopedSymbolPainter = (context, info) => {
+					context.fillStyle = info.color
+					context.fillRect(0, 0, info.width, info.height)
+				}
+				const scopedSymbolOffA = symView.registerSymbol('作用域图元', scopedSymbolPainter)
+				const scopedSymbolOffB = symView.registerSymbol('作用域图元', scopedSymbolPainter)
+				scopedSymbolOffA()
+				const scopedSymbolSurvived = symView.listSymbols().includes('作用域图元')
+				scopedSymbolOffB()
+				scopedSymbolOffB()
+				check('自定义图元：同名覆盖后旧注销函数不误删新注册（画笔相同也算新注册），新注销函数重复调用安全',
+					scopedSymbolSurvived && !symView.listSymbols().includes('作用域图元'),
+					`旧注销后仍在 ${scopedSymbolSurvived} / 最终 ${JSON.stringify(symView.listSymbols())}`)
 				symView.unregisterSymbol('三角')
 				symOff()
 				await edgeSleep(240)
@@ -4214,9 +4445,9 @@
 				const auGeometry = id => auView.listLines({}).find(item => item.item?.id === id)?.path ?? null
 				const auWaypoints = id => auView.getWaypoints(auLineIndex(id)).map(item => item.coordinate)
 
-				// ① getPointStyle 读的是「样式链定下来的那一份」：setPointSize / updatePoint 之后必须跟着变
-				auView.setPointSize('a', 34)
-				check('getPointStyle：setPointSize 之后读回来就是新尺寸', auView.getPointStyle(auPointIndex('a'))?.size === 34, JSON.stringify(auView.getPointStyle(auPointIndex('a'))))
+				// ① getPointStyle 读的是「样式链定下来的那一份」：updatePoint({ size }) 之后必须跟着变
+				auView.updatePoint('a', { size: 34 })
+				check('getPointStyle：updatePoint({ size }) 之后读回来就是新尺寸', auView.getPointStyle(auPointIndex('a'))?.size === 34, JSON.stringify(auView.getPointStyle(auPointIndex('a'))))
 				auView.updatePoint('a', { size: 26 })
 				check('getPointStyle：updatePoint({ size }) 之后也跟上（不再停在初次解析的那一份）', auView.getPointStyle(auPointIndex('a'))?.size === 26, JSON.stringify(auView.getPointStyle(auPointIndex('a'))))
 
@@ -4229,7 +4460,7 @@
 				auView.cancelPointCopy()
 
 				// ③ setCurrentChannelGroup(id, null) = 不选中（不是「选中第一组」）
-				auView.select('m1')
+				auView.selectFeatures('m1')
 				const auSelectedBefore = auView.getSelections().filter(entry => entry.type === 'line').length
 				auView.setCurrentChannelGroup('au-ch', null)
 				const auSelectedAfter = auView.getSelections().filter(entry => entry.type === 'line').length
@@ -4344,6 +4575,446 @@
 					JSON.stringify(gwView.getOptions().channels[0]?.groups ?? null))
 				gwView.destroy()
 				gwHost.remove()
+
+				/* ⑪ 扩展图形：path / image / canvas 三类，世界坐标跟随相机，DOM 层级在画布与标签之间，导出 PNG / SVG 都包含 */
+				const grHost = document.createElement('div')
+				grHost.style.cssText = 'width:480px;height:300px'
+				document.body.appendChild(grHost)
+				const grImageCanvas = document.createElement('canvas')
+				grImageCanvas.width = 8
+				grImageCanvas.height = 8
+				const grImageContext = grImageCanvas.getContext('2d')
+				grImageContext.fillStyle = '#ffcc00'
+				grImageContext.fillRect(0, 0, 8, 8)
+				const grLiveCanvas = document.createElement('canvas')
+				grLiveCanvas.width = 16
+				grLiveCanvas.height = 16
+				const grLiveContext = grLiveCanvas.getContext('2d')
+				grLiveContext.fillStyle = '#00aa66'
+				grLiveContext.fillRect(0, 0, 16, 16)
+				const grBase = [
+					{ id: 'g-path', type: 'path', x: 0, y: 0, width: 36, height: 36, viewBox: [0, 0, 10, 10], d: 'M0 0H10V10H0Z', fill: '#ff0000', stroke: 'none', anchor: 'center' },
+					{ id: 'g-image', type: 'image', src: grImageCanvas.toDataURL('image/png'), x: 80, y: 0, width: 32, height: 32, anchor: 'center' },
+					{ id: 'g-canvas', type: 'canvas', canvas: grLiveCanvas, x: -80, y: 0, width: 32, height: 32, anchor: 'center', scaleWithView: true }
+				]
+				const grWarns = []
+				const grView = createGisView(grHost, {
+					points: [],
+					lines: [],
+					graphics: grBase,
+					initialView: { scale: 2, center: [0, 0] },
+					showGrid: false,
+					onWarning: message => grWarns.push(message)
+				})
+				await settle(220)
+				const grNode = id => grHost.querySelector(`[data-graphic-id=${id}]`)
+				const grChildren = [...grView.el.children]
+				const grCanvasIndex = grChildren.indexOf(grView.canvas)
+				const grLayerIndex = grChildren.indexOf(grHost.querySelector('.gis-view__graphics'))
+				const grLabelIndex = grChildren.indexOf(grHost.querySelector('.gis-view__labels'))
+				check('扩展图形：初始化同时接受 path / image / canvas 三类，并生成对应 DOM',
+					grNode('g-path')?.dataset.graphicType === 'path' && grNode('g-image')?.querySelector('img') instanceof HTMLImageElement && grNode('g-canvas')?.contains(grLiveCanvas) === true,
+					['g-path', 'g-image', 'g-canvas'].map(id => grNode(id)?.dataset.graphicType ?? 'missing').join(' / '))
+				check('扩展图形：DOM 顺序为 canvas → graphics → labels（图形压在要素上、标签下）',
+					grCanvasIndex >= 0 && grCanvasIndex < grLayerIndex && grLayerIndex < grLabelIndex,
+					JSON.stringify({ canvas: grCanvasIndex, graphics: grLayerIndex, labels: grLabelIndex }))
+				const grPathNode = grNode('g-path')
+				const grCanvasNode = grNode('g-canvas')
+				const grBefore = {
+					left: Number.parseFloat(grPathNode.style.left),
+					width: Number.parseFloat(grPathNode.style.width),
+					canvasWidth: Number.parseFloat(grCanvasNode.style.width)
+				}
+				const grCamera = grView.getCamera()
+				grView.setCamera({ ...grCamera, center: [grCamera.center[0] + 20, grCamera.center[1]], scale: grCamera.scale * 2 })
+				await settle(80)
+				const grAfter = {
+					left: Number.parseFloat(grPathNode.style.left),
+					width: Number.parseFloat(grPathNode.style.width),
+					canvasWidth: Number.parseFloat(grCanvasNode.style.width)
+				}
+				check('扩展图形：相机移动后重投影（屏幕位置跟着变）', grAfter.left !== grBefore.left, `${grBefore.left} → ${grAfter.left}`)
+				check('扩展图形：默认尺寸保持屏幕像素，scaleWithView: true 时宽高随相机缩放',
+					Math.abs(grAfter.width - grBefore.width) < 0.5 && Math.abs(grAfter.canvasWidth - grBefore.canvasWidth * 2) < 0.5,
+					JSON.stringify({ path: [grBefore.width, grAfter.width], canvas: [grBefore.canvasWidth, grAfter.canvasWidth] }))
+				const grScene = grView.snapshotScene({ background: false })
+				check('扩展图形：snapshotScene 带 scene.graphics（屏幕坐标、尺寸、类型齐全）',
+					grScene?.graphics?.length === 3 && grScene.graphics.every(item => typeof item.x === 'number' && typeof item.width === 'number') && grScene.graphics.some(item => item.type === 'path') && grScene.graphics.some(item => item.type === 'image') && grScene.graphics.some(item => item.type === 'canvas'),
+					JSON.stringify(grScene?.graphics?.map(item => ({ id: item.id, type: item.type, width: item.width })) ?? null))
+				const grDecodeSvg = url => {
+					const base64 = String(url).slice('data:image/svg+xml;base64,'.length)
+					return new TextDecoder().decode(Uint8Array.from(atob(base64), char => char.charCodeAt(0)))
+				}
+				const grSvg = grDecodeSvg(await grView.exportImage({ type: 'svg', includeLabels: false, background: 'none' }))
+				check('扩展图形：SVG 导出包含路径与图片 / Canvas 的 <image>',
+					grSvg.includes('M0 0H10V10H0Z') && (grSvg.match(/<image/g) ?? []).length >= 2,
+					`path=${grSvg.includes('M0 0H10V10H0Z')} / image=${(grSvg.match(/<image/g) ?? []).length}`)
+				const grPixelAt = async (url, x, y) => {
+					const image = new Image()
+					await new Promise((resolve, reject) => {
+						image.onload = resolve
+						image.onerror = () => reject(new Error('扩展图形导出图片加载失败'))
+						image.src = url
+					})
+					const buffer = document.createElement('canvas')
+					buffer.width = image.width
+					buffer.height = image.height
+					const context = buffer.getContext('2d')
+					context.drawImage(image, 0, 0)
+					return [...context.getImageData(Math.round(x), Math.round(y), 1, 1).data]
+				}
+				const grPoint = grView.project(0, 0)
+				const grPixel = await grPixelAt(await grView.exportImage({ background: 'none', includeLabels: false, scale: 1 }), grPoint[0], grPoint[1])
+				check('扩展图形：PNG 导出按「画布 → 图形 → 标签」次序合成（路径像素真的进了图）',
+					grPixel[0] > 200 && grPixel[1] < 80 && grPixel[2] < 80 && grPixel[3] > 200,
+					`rgba(${grPixel.join(',')})`)
+				const grAdded = grView.addGraphic({ id: 'g-dyn', type: 'path', x: 0, y: 100, width: 20, height: 20, viewBox: [0, 0, 10, 10], d: 'M0 0H10V10H0Z', fill: '#3355ff', zIndex: 9 })
+				const grBulk = grView.addGraphics([{ id: 'g-low', type: 'path', x: 0, y: -100, width: 20, height: 20, viewBox: [0, 0, 10, 10], d: 'M0 0H10V10H0Z', fill: '#999999', zIndex: -5 }])
+				const grUpdated = grView.updateGraphic('g-dyn', { style: { width: 50, height: 30, fill: '#00aa00' } })
+				const grBadType = grView.addGraphic({ id: 'g-bad', type: 'triangle', x: 0, y: 0, width: 10, height: 10, d: 'M0 0H10V10Z' })
+				const grDuplicate = grView.addGraphics([{ id: 'g-low', type: 'path', x: 0, y: -100, width: 24, height: 20, viewBox: [0, 0, 10, 10], d: 'M0 0H10V10H0Z', fill: '#777777', zIndex: -4 }])
+				const grOrdered = grView.getGraphics()
+				check('扩展图形：addGraphic / addGraphics / updateGraphic / getGraphic 都能用（style.width / height 也能改）',
+					grAdded?.id === 'g-dyn' && grBulk.length === 1 && grUpdated?.width === 50 && grUpdated?.height === 30 && grUpdated?.fill === '#00aa00' && grView.getGraphic('g-image')?.type === 'image' && grView.getGraphic('missing') === null,
+					JSON.stringify({ added: grAdded?.id, bulk: grBulk.length, updated: grUpdated && { width: grUpdated.width, height: grUpdated.height, fill: grUpdated.fill } }))
+				check('扩展图形：显式写错的 type 不静默按 path 处理，跳过并给出 warning', grBadType === null && grView.getGraphic('g-bad') === null && grWarns.some(message => message.includes('triangle') && message.includes('不支持')), grWarns.join(' | '))
+				check('扩展图形：addGraphics 里重复 id 按更新覆盖并点名 warning', grDuplicate.length === 1 && grView.getGraphic('g-low')?.fill === '#777777' && grWarns.some(message => message.includes('addGraphics') && message.includes('g-low')), JSON.stringify({ count: grDuplicate.length, fill: grView.getGraphic('g-low')?.fill }))
+				check('扩展图形：getGraphics 按 zIndex、再按加入顺序排', grOrdered[0]?.id === 'g-low' && grOrdered[grOrdered.length - 1]?.id === 'g-dyn', grOrdered.map(item => `${item.id}:${item.zIndex}`).join(' / '))
+				const grRemoved = grView.removeGraphic('g-dyn')
+				const grRemovedBulk = grView.removeGraphic('g-low')
+				const grMissing = grView.removeGraphic('missing')
+				const grCleared = grView.clearGraphics()
+				check('扩展图形：removeGraphic / clearGraphics 返回值与清空结果一致',
+					grRemoved?.id === 'g-dyn' && grRemovedBulk?.id === 'g-low' && grMissing === null && grCleared === 3 && grView.getGraphics().length === 0,
+					JSON.stringify({ removed: grRemoved?.id, removedBulk: grRemovedBulk?.id, missing: grMissing, cleared: grCleared }))
+				grView.updateOptions({ graphics: grBase })
+				await settle(120)
+				check('扩展图形：运行时清空后再传回同一份初始数组仍能恢复（配置来源不会因同一引用短路）',
+					grView.getGraphics().length === 3 && Boolean(grNode('g-path')) && Boolean(grNode('g-image')) && Boolean(grNode('g-canvas')),
+					`${grView.getGraphics().length} 条 / DOM ${grHost.querySelectorAll('.gis-view__graphic').length} 个`)
+				grView.destroy()
+				grHost.remove()
+
+				/* 这一轮新增：通道草稿样式 / 多回线预览 / 选起点后点空白取消 / WebGL 自定义层 */
+				const { channelDraftArrowPlacement } = await import('../../src/gis-view/engine.js')
+				const arrowQuarter = channelDraftArrowPlacement([[0, 0], [100, 0]], 0.25)
+				const arrowDefault = channelDraftArrowPlacement([[0, 0], [100, 0]])
+				const arrowClamped = channelDraftArrowPlacement([[0, 0], [100, 0]], 2)
+				check('草稿箭头位置按弧长比例取点（25% / 缺省 50% / 越界夹到端点）',
+					Math.abs(arrowQuarter?.center[0] - 25) < 1e-9 && Math.abs(arrowDefault?.center[0] - 50) < 1e-9 && Math.abs(arrowClamped?.center[0] - 100) < 1e-9 && arrowQuarter.unitX === 1,
+					JSON.stringify({ quarter: arrowQuarter?.center, center: arrowDefault?.center, end: arrowClamped?.center }))
+
+				const draftHost = document.createElement('div')
+				draftHost.style.cssText = 'width:520px;height:340px'
+				document.body.appendChild(draftHost)
+				const draftEvents = []
+				const draftClicks = []
+				const draftDraws = []
+				const draftErrors = []
+				const draftCustomDraw = (context) => {
+					draftDraws.push(context)
+					// 故意把 GL 状态改坏：组件应在 customDraw 返回后收回内置绘制依赖的状态
+					context.gl.enable(context.gl.SCISSOR_TEST)
+					context.gl.scissor(0, 0, 1, 1)
+					context.gl.viewport(1, 1, 1, 1)
+					context.gl.disable(context.gl.BLEND)
+				}
+				const draftView = createGisView(draftHost, {
+					points: [{ id: 'd-a', x: 0, y: 0 }, { id: 'd-b', x: 180, y: 0 }, { id: 'd-c', x: 0, y: 140 }],
+					lines: [],
+					fitPadding: 70,
+					showGrid: false,
+					features: { channelDraft: true },
+					onChannelDraft: payload => draftEvents.push(payload),
+					onChannelDraftClick: payload => draftClicks.push(payload),
+					onError: message => draftErrors.push(String(message))
+				})
+				await settle(150)
+				const draftCanvas = draftView.canvas
+				const dispatchDraftPointer = (type, x, y) => {
+					const screen = draftView.project(x, y)
+					const rect = draftCanvas.getBoundingClientRect()
+					draftCanvas.dispatchEvent(new PointerEvent(type, {
+						bubbles: true,
+						cancelable: true,
+						composed: true,
+						pointerId: 19,
+						pointerType: 'mouse',
+						isPrimary: true,
+						button: 0,
+						clientX: rect.left + screen[0],
+						clientY: rect.top + screen[1]
+					}))
+				}
+				const clickDraftWorld = async (x, y) => {
+					dispatchDraftPointer('pointerdown', x, y)
+					dispatchDraftPointer('pointerup', x, y)
+					await settle(40)
+				}
+				draftView.beginAddChannel({
+					circuits: 3,
+					routing: 'orthogonal',
+					channelDraftStyle: {
+						color: '#1456d8',
+						width: 3,
+						dot: 3,
+						dotColor: '#e58a2b',
+						arrow: true,
+						arrowSize: 15,
+						arrowPositions: [0.25, 0.75],
+						arrowReverse: true,
+						arrowColor: '#128457',
+						circuitSpacing: 18,
+						opacity: 0.65,
+						customDraw: draftCustomDraw
+					}
+				})
+				const draftStart = draftView.getAddChannelDraft()
+				check('beginAddChannel 接收本次草稿完整样式，3 回通道与箭头位置都进载荷',
+					draftStart?.phase === 'start' && draftStart.circuits === 3 && draftStart.style?.color === '#1456d8' && draftStart.style?.dotColor === '#e58a2b' && draftStart.style?.arrow === true && draftStart.style?.arrowReverse === true && draftStart.style?.arrowColor === '#128457' && draftStart.style?.circuitSpacing === 18 && draftStart.style?.opacity === 0.65 && draftStart.style?.arrowPositions.join(',') === '0.25,0.75' && draftStart.style?.customDraw === draftCustomDraw,
+					JSON.stringify(draftStart?.style))
+
+				await clickDraftWorld(0, 0)
+				const styleReturn = draftView.updateAddChannelStyle({ arrowPositions: [0.15, 0.5, 0.85], circuitSpacing: 24, opacity: 0.5 })
+				dispatchDraftPointer('pointermove', 110, 100)
+				await settle(30)
+				const draftStyled = draftView.getAddChannelDraft()
+				check('updateAddChannelStyle 字段级合并箭头位置 / 回线间距 / 透明度，并保持链式返回',
+					styleReturn === draftView && draftStyled?.phase === 'from' && draftStyled.style.arrowPositions.join(',') === '0.15,0.5,0.85' && draftStyled.style.circuitSpacing === 24 && draftStyled.style.opacity === 0.5 && draftStyled.style.color === '#1456d8',
+					JSON.stringify(draftStyled?.style))
+
+				draftDraws.length = 0
+				await draftView.exportImage({ background: 'none', includeLabels: false, scale: 1 })
+				const draftDraw = draftDraws.at(-1)
+				const draftStarts = new Set((draftDraw?.circuitPaths ?? []).map(path => `${path[0]?.[0]?.toFixed(3)},${path[0]?.[1]?.toFixed(3)}`))
+				check('customDraw 拿到最终 GL / 相机 / 完整路径与 3 条平行回线，可完全接管预览绘制',
+					draftDraws.length > 0 && draftDraw?.gl === draftView.gl && draftDraw?.canvas === draftCanvas && draftDraw?.circuits === 3 && draftDraw?.circuitPaths.length === 3 && draftStarts.size === 3 && draftDraw?.path.length >= 2 && draftDraw?.kind === 'channel' && draftDraw?.phase === 'from' && draftDraw?.style.arrowPositions.join(',') === '0.15,0.5,0.85' && draftErrors.length === 0,
+					JSON.stringify({ draws: draftDraws.length, circuits: draftDraw?.circuits, starts: [...draftStarts], path: draftDraw?.path?.length, errors: draftErrors }))
+
+				const draftResetReturn = draftView.updateAddChannelStyle(null)
+				const draftReset = draftView.getAddChannelDraft()
+				check('updateAddChannelStyle(null) 回到全局缺省样式（箭头关、单中点位置、间距 10）',
+					draftResetReturn === draftView && draftReset?.style.arrow === false && draftReset.style.arrowPositions.join(',') === '0.5' && draftReset.style.circuitSpacing === 10 && draftReset.style.opacity === 1 && typeof draftReset.style.customDraw === 'undefined',
+					JSON.stringify(draftReset?.style))
+
+				const draftDataBeforeCancel = draftView.getData()
+				draftEvents.length = 0
+				draftClicks.length = 0
+				await clickDraftWorld(110, 100)
+				const draftCancel = draftEvents.find(payload => payload.phase === 'cancel')
+				const draftCancelClick = draftClicks.at(-1)
+				check('已选起点后点节点以外的位置直接取消：草稿清空、cancel 同时给 onChannelDraft 与 onChannelDraftClick',
+					draftView.getAddChannelDraft() === null && draftCancel?.reason === 'click-outside-node' && draftCancel?.hit === false && draftCancelClick?.phase === 'cancel' && draftCancelClick?.reason === 'click-outside-node' && draftView.getData().lines.length === draftDataBeforeCancel.lines.length,
+					JSON.stringify({ draft: draftView.getAddChannelDraft(), event: draftCancel?.reason, click: draftCancelClick?.reason }))
+
+				draftView.beginAddChannel({ circuits: 2 })
+				draftEvents.length = 0
+				draftClicks.length = 0
+				await clickDraftWorld(110, 100)
+				check('还没选起点时点空白仍保持草稿并发送 pick（不会误取消）',
+					draftView.getAddChannelDraft()?.phase === 'start' && draftClicks.at(-1)?.phase === 'pick' && draftClicks.at(-1)?.hit === false && !draftEvents.some(payload => payload.phase === 'cancel'),
+					JSON.stringify({ draft: draftView.getAddChannelDraft()?.phase, click: draftClicks.at(-1)?.phase, events: draftEvents.map(payload => payload.phase) }))
+				draftView.cancelAddChannel()
+
+				/* WebGL 自定义层：最终画布、排序 / 开关 / 卸载，以及每层开画前的状态重置 */
+				let lowLayerCalls = 0
+				let highLayerCalls = 0
+				let highLayerState = null
+				draftView.addWebGLLayer({
+					id: 'test-high',
+					order: 20,
+					draw: ({ gl }) => {
+						highLayerCalls += 1
+						highLayerState = {
+							scissor: gl.isEnabled(gl.SCISSOR_TEST),
+							blend: gl.isEnabled(gl.BLEND),
+							viewport: Array.from(gl.getParameter(gl.VIEWPORT)),
+							framebuffer: gl.getParameter(gl.FRAMEBUFFER_BINDING)
+						}
+					}
+				})
+				draftView.addWebGLLayer({
+					id: 'test-low',
+					order: 10,
+					draw: ({ gl }) => {
+						lowLayerCalls += 1
+						gl.enable(gl.SCISSOR_TEST)
+						gl.scissor(0, 0, 2, 2)
+						gl.viewport(3, 3, 4, 4)
+						gl.disable(gl.BLEND)
+					}
+				})
+				const layerOrder = draftView.getWebGLLayers()
+				check('view.gl / addWebGLLayer / getWebGLLayers 可用，层按 order 排序（同 id 可覆盖）',
+					typeof WebGL2RenderingContext !== 'undefined' && draftView.gl instanceof WebGL2RenderingContext && layerOrder.map(layer => layer.id).join(',') === 'test-low,test-high' && layerOrder.every(layer => typeof layer.draw === 'function') && draftView.getOptions().webglLayers.map(layer => layer.id).join(',') === 'test-low,test-high',
+					JSON.stringify({ gl: Boolean(draftView.gl), order: layerOrder.map(layer => `${layer.id}:${layer.order}`), options: draftView.getOptions().webglLayers?.map(layer => layer.id) }))
+
+				await draftView.exportImage({ background: 'none', includeLabels: false, scale: 1 })
+				check('自定义层在内置内容之后执行；前一层改坏的 scissor / viewport / blend 不会漏给下一层',
+					lowLayerCalls > 0 && highLayerCalls > 0 && highLayerState?.scissor === false && highLayerState?.blend === true && highLayerState?.framebuffer === null && highLayerState?.viewport.join(',') === [0, 0, draftCanvas.width, draftCanvas.height].join(','),
+					JSON.stringify({ low: lowLayerCalls, high: highLayerCalls, state: highLayerState }))
+
+				const lowBeforeDisabled = lowLayerCalls
+				const highBeforeDisabled = highLayerCalls
+				const disabledLayer = draftView.updateWebGLLayer('test-low', { enabled: false })
+				await draftView.exportImage({ background: 'none', includeLabels: false, scale: 1 })
+				check('enabled: false 只跳过这一层，其它层照常绘制',
+					disabledLayer?.enabled === false && lowLayerCalls === lowBeforeDisabled && highLayerCalls > highBeforeDisabled,
+					JSON.stringify({ low: [lowBeforeDisabled, lowLayerCalls], high: [highBeforeDisabled, highLayerCalls] }))
+
+				const reenabled = draftView.updateWebGLLayer('test-low', { enabled: true, order: 40 })
+				await draftView.exportImage({ background: 'none', includeLabels: false, scale: 1 })
+				draftView.updateWebGLLayer('test-high', { order: 50 })
+				check('updateWebGLLayer 可原地改 enabled / order，排序马上反映在 getWebGLLayers',
+					reenabled?.enabled === true && reenabled.order === 40 && draftView.getWebGLLayers().map(layer => `${layer.id}:${layer.order}`).join(',') === 'test-low:40,test-high:50',
+					JSON.stringify(draftView.getWebGLLayers().map(layer => `${layer.id}:${layer.order}`)))
+
+				const removedLow = draftView.removeWebGLLayer('test-low')
+				const missingLayer = draftView.updateWebGLLayer('missing', { order: 1 })
+				const unsubscribe = draftView.addWebGLLayer({ id: 'test-off', order: 5, draw: () => {} })
+				const offAdded = draftView.getWebGLLayers().some(layer => layer.id === 'test-off')
+				unsubscribe()
+				check('removeWebGLLayer / addWebGLLayer 的卸载函数 / 不存在的 id 都按接口约定返回',
+					removedLow?.id === 'test-low' && missingLayer === null && draftView.removeWebGLLayer('missing') === null && offAdded && !draftView.getWebGLLayers().some(layer => layer.id === 'test-off'),
+					JSON.stringify({ removed: removedLow?.id, missing: missingLayer, offAdded, layers: draftView.getWebGLLayers().map(layer => layer.id) }))
+
+				const staleUnload = draftView.addWebGLLayer({ id: 'test-replaced', order: 6, draw: () => {} })
+				const replacementDraw = () => {}
+				draftView.addWebGLLayer({ id: 'test-replaced', order: 6, draw: replacementDraw })
+				staleUnload()
+				const replacedLayer = draftView.getWebGLLayers().find(layer => layer.id === 'test-replaced')
+				check('同 id 的 WebGL 层被覆盖后，旧卸载函数不会误删新层',
+					replacedLayer?.draw === replacementDraw && (draftView.getOptions().webglLayers ?? []).some(layer => layer.id === 'test-replaced'),
+					JSON.stringify({ layers: draftView.getWebGLLayers().map(layer => layer.id), options: draftView.getOptions().webglLayers?.map(layer => layer.id) }))
+				draftView.removeWebGLLayer('test-replaced')
+
+				const clearedLayers = draftView.clearWebGLLayers()
+				check('clearWebGLLayers 清空并同步 getOptions().webglLayers；requestRender 可链式调用',
+					clearedLayers === 1 && draftView.getWebGLLayers().length === 0 && (draftView.getOptions().webglLayers ?? []).length === 0 && draftView.requestRender() === draftView,
+					JSON.stringify({ cleared: clearedLayers, layers: draftView.getWebGLLayers().length, options: draftView.getOptions().webglLayers?.length }))
+
+				/* 隐藏 / 显示、节点拆分、通道变化对账：接口级自测 */
+				const splitHost = document.createElement('div')
+				splitHost.style.cssText = 'width:640px;height:380px'
+				document.body.append(splitHost)
+				const splitView = createGisView(splitHost, {
+					points: [
+						{ id: 'sv-a', x: 0, y: 0, name: 'A' },
+						{ id: 'sv-b', x: 8, y: 0, name: 'B' },
+						{ id: 'sv-c', x: 0, y: 8, name: 'C' }
+					],
+					lines: [
+						{ id: 'sv-ab', from: 'sv-a', to: 'sv-b', name: 'AB' },
+						{ id: 'sv-ab2', from: 'sv-a', to: 'sv-b', name: 'AB-2' },
+						{ id: 'sv-ac', from: 'sv-a', to: 'sv-c', name: 'AC' }
+					],
+					channels: [{ id: 'sv-ch', from: 'sv-a', to: 'sv-b', lineIds: ['sv-ab', 'sv-ab2'] }],
+					initialView: { scale: 1, center: [2, 2] },
+					labelOptimize: false,
+					showGrid: false,
+					waypointEditable: true,
+					history: { limit: 20 }
+				})
+				const splitOutcome = splitView.splitPoint('sv-a', [
+					{ x: -1, y: -1, name: 'A-左' },
+					{ x: 1, y: 1, name: 'A-右', lines: ['sv-ab'] }
+				])
+				const splitData = splitView.getData()
+				const splitB = splitData.points.find(point => point.name === 'A-右')
+				const splitAb = splitData.lines.find(line => line.id === 'sv-ab')
+				const splitAb2 = splitData.lines.find(line => line.id === 'sv-ab2')
+				const splitAc = splitData.lines.find(line => line.id === 'sv-ac')
+				const splitChannel = splitView.getOptions().channels.find(channel => channel.id === 'sv-ch')
+				check('splitPoint：第一份复用原下标 / id，第二份追加并拿到新 id', splitOutcome.ok === true && splitOutcome.items.length === 2 && splitOutcome.indexes[0] === 0 && splitData.points.length === 4 && splitOutcome.pointIds[0] === 'sv-a' && splitOutcome.pointIds[1] !== 'sv-a', JSON.stringify({ ids: splitOutcome.pointIds, indexes: splitOutcome.indexes, points: splitData.points.length }))
+				check('splitPoint：显式分给第二份的线路改绑，未分配的线路跟第一份', splitAb?.from === splitB?.id && splitAb2?.from === 'sv-a' && splitAc?.from === 'sv-a', JSON.stringify({ ab: splitAb?.from, ab2: splitAb2?.from, ac: splitAc?.from, b: splitB?.id }))
+				check('splitPoint：通道没写 channels 时跟随第一条被分配过的成员回线', String(splitChannel?.from) === String(splitB?.id) && String(splitChannel?.to) === 'sv-b', JSON.stringify({ from: splitChannel?.from, to: splitChannel?.to, b: splitB?.id }))
+				check('splitPoint：返回可直接提交的 changeSet 与 splitPoint 计数', splitOutcome.changes?.removedPoint?.id === 'sv-a' && splitOutcome.changes?.points?.length === 2 && splitOutcome.changes?.lines?.some(line => line.id === 'sv-ab') && splitOutcome.changes?.channels?.some(channel => channel.id === 'sv-ch') && splitOutcome.linesChanged === 3 && splitOutcome.channelsChanged === 1, JSON.stringify({ lines: splitOutcome.changes?.lines?.map(line => line.id), channels: splitOutcome.changes?.channels?.map(channel => channel.id) }))
+				const changedAfterSplit = splitView.getChangedChannels().find(channel => channel.id === 'sv-ch')
+				check('getChangedChannels：拆分后的端点变化入账，reason 带 endpoints', Boolean(changedAfterSplit) && changedAfterSplit.endpointsChanged && changedAfterSplit.reasons.includes('endpoints'), JSON.stringify(changedAfterSplit?.reasons))
+				splitView.undo()
+				const undoData = splitView.getData()
+				check('splitPoint：撤销一步回到拆分前（节点、线路、通道端点全恢复）', undoData.points.length === 3 && undoData.lines.find(line => line.id === 'sv-ab')?.from === 'sv-a' && splitView.getOptions().channels.find(channel => channel.id === 'sv-ch')?.from === 'sv-a', JSON.stringify({ points: undoData.points.length, from: undoData.lines.find(line => line.id === 'sv-ab')?.from }))
+				splitView.redo()
+				check('splitPoint：重做恢复拆分结果', splitView.getData().points.length === 4 && splitView.getData().lines.find(line => line.id === 'sv-ab')?.from !== 'sv-a', JSON.stringify({ points: splitView.getData().points.length }))
+				splitView.clearChangedChannels()
+				check('clearChangedChannels：全部对账后最近变化为空', splitView.getChangedChannels().length === 0, JSON.stringify(splitView.getChangedChannels().map(item => item.id)))
+				const addedSplitGroup = splitView.addChannelGroup('sv-ch', ['sv-ab2'])
+				const fullGroupChange = splitView.getChangedChannels().find(channel => channel.id === 'sv-ch')
+				const ignoredGroupChange = splitView.getChangedChannels({ ignoreGroups: true }).find(channel => channel.id === 'sv-ch')
+				check('getChangedChannels({ ignoreGroups })：分组新增 / 删除不入账', addedSplitGroup.ok === true && fullGroupChange?.groupsChanged === true && !ignoredGroupChange, JSON.stringify({ added: addedSplitGroup.ok, full: fullGroupChange?.reasons, ignored: ignoredGroupChange?.reasons }))
+				splitView.clearChangedChannels()
+				if (addedSplitGroup.ok) {
+					splitView.removeChannelGroup('sv-ch', addedSplitGroup.groupId)
+					splitView.clearChangedChannels()
+				}
+				const splitGroup = splitView.getChannelGroups('sv-ch')[0]
+				splitView.addChannelGroupWaypoint('sv-ch', splitGroup?.id)
+				const waypointChange = splitView.getChangedChannels({ reasons: ['waypoints'] }).find(channel => channel.id === 'sv-ch')
+				const ignoredWaypointChange = splitView.getChangedChannels({ ignoreGroups: true, reasons: ['waypoints'] }).find(channel => channel.id === 'sv-ch')
+				check('getChangedChannels({ reasons: [waypoints] })：只返回拐点变化并收窄 reasons', Boolean(waypointChange) && waypointChange.waypointsChanged && waypointChange.reasons.length === 1 && waypointChange.reasons[0] === 'waypoints', JSON.stringify(waypointChange?.reasons))
+				check('getChangedChannels({ ignoreGroups })：已有分组的拐点变化照常报', Boolean(ignoredWaypointChange) && ignoredWaypointChange.waypointsChanged && ignoredWaypointChange.reasons.length === 1 && ignoredWaypointChange.reasons[0] === 'waypoints', JSON.stringify(ignoredWaypointChange?.reasons))
+				splitView.clearChangedChannels('sv-ch')
+				splitView.clearChangedLines()
+				splitView.updateLine('sv-ac', { name: 'AC-变更' })
+				const fieldLineChange = splitView.getChangedLines({ reasons: ['fields'] }).find(line => line.id === 'sv-ac')
+				check('getChangedLines({ reasons: [fields] })：线路字段变化入账', Boolean(fieldLineChange) && fieldLineChange.fields.includes('name') && fieldLineChange.reasons.length === 1 && fieldLineChange.reasons[0] === 'fields', JSON.stringify(fieldLineChange?.reasons))
+				splitView.clearChangedLines('sv-ac')
+				splitView.setLineWaypoints('sv-ac', [[4, 4]])
+				const pathLineChange = splitView.getChangedLines({ reasons: ['path'] }).find(line => line.id === 'sv-ac')
+				check('getChangedLines：path 变化独立记 path，读取不改基准', Boolean(pathLineChange) && pathLineChange.pathChanged && pathLineChange.reasons.includes('path') && splitView.getChangedLines({ reasons: ['path'] }).length === 1, JSON.stringify(pathLineChange?.reasons))
+				splitView.clearChangedLines()
+				const hideChannel = splitView.hideFeatures('channel', 'sv-ch')
+				const hiddenChannelRead = splitView.getChannel('sv-ch')
+				const hideChanged = splitView.getChangedChannels().find(channel => channel.id === 'sv-ch')
+				check('hideFeatures(channel)：visible 落数据、通道退场，变化账本记 visibility', hideChannel.ok === true && splitView.getOptions().channels.find(channel => channel.id === 'sv-ch')?.visible === false && hiddenChannelRead?.lineIndexes?.length === 0 && hideChanged?.visibilityChanged === true, JSON.stringify({ ok: hideChannel.ok, paths: hiddenChannelRead?.lineIndexes?.length, reasons: hideChanged?.reasons }))
+				const showChannel = splitView.showFeatures('channel', 'sv-ch')
+				check('showFeatures(channel)：隐藏后原样恢复（回线、分组、拐点都还在）', showChannel.ok === true && splitView.getChannel('sv-ch')?.lineIndexes?.length === 2 && splitView.getOptions().channels.find(channel => channel.id === 'sv-ch')?.visible === true && splitView.getChannelGroups('sv-ch').length === 1, JSON.stringify({ lines: splitView.getChannel('sv-ch')?.lineIndexes?.length, groups: splitView.getChannelGroups('sv-ch').length }))
+				const generatedId = splitView.getData().points.find(point => point.name === 'A-右')?.id
+				const hidePoint = splitView.hideFeatures('point', generatedId)
+				const hideLine = splitView.hideFeatures('line', 'sv-ac')
+				check('hideFeatures(point / line)：只改 visible，数据不删', hidePoint.ok === true && hideLine.ok === true && splitView.getData().points.find(point => point.id === generatedId)?.visible === false && splitView.getData().lines.find(line => line.id === 'sv-ac')?.visible === false, JSON.stringify({ point: hidePoint.ok, line: hideLine.ok }))
+				const hiddenLineChange = splitView.getChangedLines().find(line => line.id === 'sv-ac')
+				check('getChangedLines：线路显隐变化入账', Boolean(hiddenLineChange) && hiddenLineChange.visibilityChanged && hiddenLineChange.reasons.includes('visibility'), JSON.stringify(hiddenLineChange?.reasons))
+				splitView.showFeatures('point', generatedId)
+				splitView.showFeatures('line', 'sv-ac')
+				check('showFeatures(point / line)：恢复后 visible 回到 true', splitView.getData().points.find(point => point.id === generatedId)?.visible === true && splitView.getData().lines.find(line => line.id === 'sv-ac')?.visible === true, '')
+				splitView.clearChangedLines('sv-ac')
+				splitView.updateLine('sv-ac', { name: 'AC-删除前' })
+				const lineChangedBeforeDelete = splitView.getChangedLines().some(line => line.id === 'sv-ac')
+				splitView.removeLine('sv-ac')
+				const lineAfterDelete = splitView.getChangedLines().find(line => line.id === 'sv-ac')
+				check('getChangedLines：线路删除同步清账，不再返回已删线路', lineChangedBeforeDelete && !lineAfterDelete, JSON.stringify({ before: lineChangedBeforeDelete, after: lineAfterDelete ?? null }))
+				splitView.clearChangedChannels()
+				splitView.updateChannel('sv-ch', { name: '待删通道' })
+				const channelChangedBeforeDelete = splitView.getChangedChannels().some(channel => channel.id === 'sv-ch')
+				splitView.removeChannel('sv-ch')
+				const channelAfterDelete = splitView.getChangedChannels().find(channel => channel.id === 'sv-ch')
+				check('getChangedChannels：通道删除同步清账，不再返回已删通道', channelChangedBeforeDelete && !channelAfterDelete, JSON.stringify({ before: channelChangedBeforeDelete, after: channelAfterDelete ?? null }))
+				const lineOnlyHost = document.createElement('div')
+				lineOnlyHost.style.cssText = 'width:480px;height:280px'
+				document.body.append(lineOnlyHost)
+				const lineOnlyView = createGisView(lineOnlyHost, {
+					points: [
+						{ id: 'lo-a', x: 0, y: 0 },
+						{ id: 'lo-b', x: 8, y: 0 }
+					],
+					lines: [{ id: 'lo-ab', from: 'lo-a', to: 'lo-b', name: 'AB' }],
+					initialView: { scale: 1, center: [4, 0] },
+					labelOptimize: false,
+					showGrid: false
+				})
+				const lineOnlyInitial = lineOnlyView.getChangedLines().length === 0
+				lineOnlyView.updateLine('lo-ab', { name: 'AB-变更' })
+				const lineOnlyChange = lineOnlyView.getChangedLines({ reasons: ['fields'] }).find(line => line.id === 'lo-ab')
+				lineOnlyView.removeLine('lo-ab')
+				const lineOnlyAfterDelete = lineOnlyView.getChangedLines().find(line => line.id === 'lo-ab')
+				check('getChangedLines：只有节点和线路时独立对账，删线路后同步清账', lineOnlyInitial && Boolean(lineOnlyChange) && lineOnlyChange.fields.includes('name') && !lineOnlyAfterDelete, JSON.stringify({ initial: lineOnlyInitial, change: lineOnlyChange?.reasons, after: lineOnlyAfterDelete ?? null }))
+				lineOnlyView.destroy()
+				lineOnlyHost.remove()
+				splitView.destroy()
+				splitHost.remove()
+				draftView.destroy()
+				draftHost.remove()
 				auView.destroy()
 				auHost.remove()
 				symView.destroy()