gis-view-webgl2 0.1.8 → 0.1.9

package/docs/steps/selftest-features.html

@@ -1056,8 +1056,8 @@
 					])
 					const cmView2 = createGisView(cmHost2, {
 						points: [
-							{ id: 'a', x: 0, y: 0, name: '甲', vn_kv: 500, size: 30, symbol: 'circle' },
-							{ id: 'b', x: 110, y: 0, name: '乙', size: 12, symbol: 'square' },
+							{ id: 'a', x: 0, y: 0, name: '甲', vn_kv: 500, size: 30, symbol: 'circle', source_only: '甲独有' },
+							{ id: 'b', x: 110, y: 0, name: '乙', vn_kv: 220, size: 12, symbol: 'square', target_only: '乙独有' },
 							{ id: 'c', x: 220, y: 0, name: '丙' }
 						],
 						lines: cmChannelBuild.lines,
@@ -1118,8 +1118,9 @@
 					check('确认之后发一条 confirm，载荷里是合并结果（尺寸取双方最大、sizeScale 归 1）', Boolean(cmConfirmEvent) && cmConfirmEvent.item?.size === 30 && cmConfirmEvent.item?.sizeScale === 1, JSON.stringify({ size: cmConfirmEvent?.item?.size, sizeScale: cmConfirmEvent?.item?.sizeScale }))
 					check('合并结果的图标优先目标节点', cmConfirmEvent?.item?.symbol === 'square', JSON.stringify(cmConfirmEvent?.item?.symbol))
 					check('确认合并：来源节点并进目标节点', cmMerged.points.length === 2 && cmMerged.points[0].id === 'b', JSON.stringify(cmMerged.points.map(point => point.id)))
-					check('确认合并：节点数据目标优先、来源独有的字段带过来', cmMerged.points[0].name === '乙' && cmMerged.points[0].vn_kv === 500, JSON.stringify(cmMerged.points[0]))
+					check('确认合并：其它字段取保留节点、maxKeys 缺省不取电压最高', cmMerged.points[0].name === '乙' && cmMerged.points[0].vn_kv === 220 && cmMerged.points[0].target_only === '乙独有' && cmMerged.points[0].source_only === undefined, JSON.stringify(cmMerged.points[0]))
 					check('确认合并：图标大小取双方最大、图标类型取目标', cmMerged.points[0].size === 30 && cmMerged.points[0].symbol === 'square', `${cmMerged.points[0].size}/${cmMerged.points[0].symbol}`)
+					check('确认合并：保留节点带 mergeInfo，记录来源、保留前快照与受影响线 / 通道', cmMerged.points[0].mergeInfo?.version === 1 && JSON.stringify(cmMerged.points[0].mergeInfo.sourceIds) === '["a"]' && cmMerged.points[0].mergeInfo.targetPoint?.id === 'b' && cmMerged.points[0].mergeInfo.targetPoint?.vn_kv === 220 && cmMerged.points[0].mergeInfo.points?.length === 1 && cmMerged.points[0].mergeInfo.lines?.length === 2 && cmMerged.points[0].mergeInfo.channels?.length === 3, JSON.stringify({ sources: cmMerged.points[0].mergeInfo?.sourceIds, targetVoltage: cmMerged.points[0].mergeInfo?.targetPoint?.vn_kv, lines: cmMerged.points[0].mergeInfo?.lines?.length, channels: cmMerged.points[0].mergeInfo?.channels?.length }))
 					check('确认合并：绑在来源上的线路改绑到目标', cmMerged.lines.length === 2 && cmMerged.lines[0].id === 'l1' && cmMerged.lines[0].from === 'b' && cmMerged.lines[0].to === 'c', JSON.stringify(cmMerged.lines))
 					check('确认合并：自环线路被删掉、结果里带读数', cmMerged.lines.every(line => line.id !== 'l2') && cmMergeDone.phase === 'merge' && cmMergeDone.removedLines === 1, JSON.stringify(cmMergeDone))
 					check('两端的通道撞成同一条：并成一条、默认各自保留分组', cmMergeDone.mergedChannels === 1 && cmMergeDone.channelsChanged === 2 && cmView2.getChannelGroups().length === 2, JSON.stringify({ merged: cmMergeDone.mergedChannels, changed: cmMergeDone.channelsChanged, groups: cmView2.getChannelGroups().length }))
@@ -1145,6 +1146,36 @@
 						JSON.stringify({ changes: cmMergeChangeIds, surviving: [...cmMergeSurvivingChannelIds], affected: cmMergeAffectedChannelIds }))
 					const cmApi = cmView2.mergePoints('c', 'b')
 					check('mergePoints 接口也能合并（不弹确认框）', cmApi.ok === true && cmView2.getData().points.length === 1 && cmView2.getData().lines.length === 0, JSON.stringify(cmApi).slice(0, 120))
+					const cmCumulative = cmView2.getData().points[0]
+					check('连续合并到同一保留节点：mergeInfo 累加两个来源，maxKeys 缺省仍保留目标电压', JSON.stringify(cmCumulative.mergeInfo?.sourceIds) === '["a","c"]' && cmCumulative.mergeInfo?.points?.length === 2 && cmCumulative.vn_kv === 220, JSON.stringify({ sources: cmCumulative.mergeInfo?.sourceIds, voltage: cmCumulative.vn_kv }))
+					cmView2.updateOptions({ history: true })
+					cmView2.selectFeatures('b')
+					const cmAutoSplit = cmView2.splitPoint('b')
+					await settle(80)
+					const cmRestoredData = cmView2.getData()
+					const cmRestoredChannels = cmView2.getChannels()
+					const cmRestoredA = cmRestoredData.points.find(point => point.id === 'a')
+					const cmRestoredB = cmRestoredData.points.find(point => point.id === 'b')
+					const cmRestoredC = cmRestoredData.points.find(point => point.id === 'c')
+					check('splitPoint 省略 parts：按 mergeInfo 自动恢复全部来源节点与合并前字段', cmAutoSplit.ok === true && cmAutoSplit.autoRestored === true && cmRestoredData.points.length === 3 && Boolean(cmRestoredA) && Boolean(cmRestoredB) && Boolean(cmRestoredC) && cmRestoredA?.vn_kv === 500 && cmRestoredB?.vn_kv === 220 && cmRestoredB?.mergeInfo === undefined, JSON.stringify({ auto: cmAutoSplit.autoRestored, points: cmRestoredData.points.map(point => point.id), voltages: [cmRestoredA?.vn_kv, cmRestoredB?.vn_kv, cmRestoredC?.vn_kv] }))
+					check('splitPoint 自动解除默认不选中拆分结果（只摘掉来源节点的选中态）', cmView2.getSelectionData().pointCount === 0 && cmView2.getSelections().length === 0, JSON.stringify(cmView2.getSelectionData()))
+					check('splitPoint 自动解除：线路与通道端点、成员及回线全部恢复', cmRestoredData.lines.length === 3 && cmRestoredData.lines.find(line => line.id === 'l2')?.from === 'a' && cmRestoredData.lines.find(line => line.id === 'l2')?.to === 'b' && cmRestoredData.lines.find(line => line.id === 'l1')?.from === 'a' && cmRestoredData.lines.find(line => line.id === 'l3')?.to === 'b' && cmRestoredChannels.length === 3 && cmRestoredChannels.find(channel => channel.id === 'ch-ab')?.from === 'a' && cmRestoredChannels.find(channel => channel.id === 'ch-ac')?.from === 'a' && cmRestoredChannels.find(channel => channel.id === 'ch-bc')?.to === 'b', JSON.stringify({ lines: cmRestoredData.lines.map(line => `${line.id}:${line.from}->${line.to}`), channels: cmRestoredChannels.map(channel => `${channel.id}:${channel.from}->${channel.to}`) }))
+					check('splitPoint 自动解除：返回 mergeSourceIds / 可提交 changes', JSON.stringify(cmAutoSplit.mergeSourceIds) === '["a","c"]' && cmAutoSplit.changes?.points?.length === 3 && cmAutoSplit.changes?.lines?.length === 3 && cmAutoSplit.changes?.channels?.length === 3, JSON.stringify({ sources: cmAutoSplit.mergeSourceIds, changes: { points: cmAutoSplit.changes?.points?.length, lines: cmAutoSplit.changes?.lines?.length, channels: cmAutoSplit.changes?.channels?.length } }))
+					cmView2.undo()
+					await settle(80)
+					const cmUnmergeUndo = cmView2.getData()
+					const cmUnmergeUndoChannels = cmView2.getChannels()
+					cmView2.redo()
+					await settle(80)
+					const cmUnmergeRedo = cmView2.getData()
+					const cmUnmergeRedoChannels = cmView2.getChannels()
+					check('splitPoint 自动解除是一步历史：撤销回到合并态、重做恢复自动解除结果', cmUnmergeUndo.points.length === 1 && cmUnmergeUndo.points[0]?.id === 'b' && cmUnmergeUndo.lines.length === 0 && cmUnmergeUndoChannels.length === 0 && cmUnmergeRedo.points.length === 3 && cmUnmergeRedo.lines.length === 3 && cmUnmergeRedoChannels.length === 3, JSON.stringify({ undo: [cmUnmergeUndo.points.length, cmUnmergeUndo.lines.length, cmUnmergeUndoChannels.length], redo: [cmUnmergeRedo.points.length, cmUnmergeRedo.lines.length, cmUnmergeRedoChannels.length] }))
+					cmView2.undo()
+					await settle(80)
+					const cmAutoSplitSelected = cmView2.splitPoint('b', null, { select: true })
+					await settle(80)
+					const cmAutoSelectedData = cmView2.getSelectionData()
+					check('splitPoint 自动解除 select:true 时选中全部恢复节点', cmAutoSplitSelected.ok === true && cmAutoSplitSelected.autoRestored === true && cmAutoSelectedData.pointCount === 3 && cmAutoSplitSelected.pointIds.every(id => cmAutoSelectedData.points.some(point => String(point.id) === String(id))), JSON.stringify({ pointCount: cmAutoSelectedData.pointCount, ids: cmAutoSplitSelected.pointIds }))
 
 					/* 移除节点：绑在它上面的线路与声明了它当端点的通道一起收拾 */
 					const cmHost7 = document.createElement('div')
@@ -1168,6 +1199,107 @@
 					cmView7.destroy()
 					cmHost7.remove()
 
+					/* merge.maxKeys：缺省不取最高；数组 / 逗号字符串都按列出的数值字段取双方最高 */
+					const mkHost = document.createElement('div')
+					mkHost.style.cssText = 'width:460px;height:300px'
+					document.body.appendChild(mkHost)
+					const mkView = createGisView(mkHost, {
+						points: [
+							{ id: 'mk-a', x: 0, y: 0, name: '来源甲', vn_kv: 500, value: 9, loading: 0.2 },
+							{ id: 'mk-b', x: 80, y: 0, name: '目标乙', vn_kv: 220, value: 3, loading: 0.8 },
+							{ id: 'mk-c', x: 0, y: 80, name: '来源丙', vn_kv: 525, value: 12, loading: 0.1 },
+							{ id: 'mk-d', x: 80, y: 80, name: '目标丁', vn_kv: 1050, value: 4, loading: 0.9 }
+						],
+						merge: { distance: 8, maxKeys: ['vn_kv', 'value'] },
+						fitPadding: 60,
+						showGrid: false
+					})
+					await settle(80)
+					const mkFirst = mkView.mergePoints('mk-a', 'mk-b')
+					const mkFirstItem = mkView.getData().points.find(point => point.id === 'mk-b')
+					check('merge.maxKeys 数组：列出的 vn_kv / value 取双方最高，其余字段取目标', mkFirst.ok === true && mkFirstItem?.vn_kv === 500 && mkFirstItem?.value === 9 && mkFirstItem?.loading === 0.8 && mkFirstItem?.name === '目标乙', JSON.stringify(mkFirstItem))
+					mkView.updateOptions({ merge: { enabled: true, maxKeys: 'vn_kv, value' } })
+					const mkSecond = mkView.mergePoints('mk-c', 'mk-d')
+					const mkSecondItem = mkView.getData().points.find(point => point.id === 'mk-d')
+					check('merge.maxKeys 逗号字符串：同样只对列出的数值字段取最高', mkSecond.ok === true && mkSecondItem?.vn_kv === 1050 && mkSecondItem?.value === 12 && mkSecondItem?.loading === 0.9 && mkSecondItem?.name === '目标丁', JSON.stringify(mkSecondItem))
+					mkView.destroy()
+					mkHost.remove()
+
+					/* splitPoint.select：缺省不选中结果，也不清掉无关的线路选中；显式 true 才选中全部拆分结果 */
+					const ssHost = document.createElement('div')
+					ssHost.style.cssText = 'width:420px;height:260px'
+					document.body.appendChild(ssHost)
+					const ssView = createGisView(ssHost, {
+						points: [{ id: 'ss-a', x: 0, y: 0, name: '拆分源' }, { id: 'ss-b', x: 80, y: 0 }],
+						lines: [{ id: 'ss-line', from: 'ss-a', to: 'ss-b' }],
+						fitPadding: 50,
+						showGrid: false
+					})
+					await settle(80)
+					ssView.selectFeatures(['ss-a', 'ss-line'])
+					const ssDefault = ssView.splitPoint('ss-a', [
+						{ x: -1, y: 0, name: 'A' },
+						{ x: 1, y: 0, name: 'B' }
+					])
+					const ssDefaultSelection = ssView.getSelectionData()
+					check('splitPoint 缺省不选中拆分结果，其它无关选中保持', ssDefault.ok === true && ssDefaultSelection.pointCount === 0 && ssDefaultSelection.lineCount === 1, JSON.stringify(ssDefaultSelection))
+					ssView.undo()
+					await settle(60)
+					ssView.selectFeatures('ss-a')
+					const ssSelected = ssView.splitPoint('ss-a', [
+						{ x: -1, y: 0, name: 'A2' },
+						{ x: 1, y: 0, name: 'B2' }
+					], { select: true })
+					const ssSelectedData = ssView.getSelectionData()
+					const ssSelectedIndexes = [...ssSelectedData.pointIndexes].sort((left, right) => left - right)
+					const ssResultIndexes = [...ssSelected.indexes].sort((left, right) => left - right)
+					check('splitPoint({ select: true }) 选中全部拆分结果', ssSelected.ok === true && ssSelectedData.pointCount === 2 && JSON.stringify(ssSelectedIndexes) === JSON.stringify(ssResultIndexes) && ssSelectedData.lineCount === 0, JSON.stringify({ selected: ssSelectedIndexes, result: ssResultIndexes }))
+					ssView.destroy()
+					ssHost.remove()
+
+					/* 通道简略：只折叠严格超过阈值的分组；没有 groups 的通道按一整组算 */
+					const csHost = document.createElement('div')
+					csHost.style.cssText = 'width:520px;height:300px'
+					document.body.appendChild(csHost)
+					const csLineIds = Array.from({ length: 8 }, (_item, index) => `cs-l${index + 1}`)
+					const csView = createGisView(csHost, {
+						points: [{ id: 'cs-a', x: 0, y: 0 }, { id: 'cs-b', x: 180, y: 0 }],
+						lines: csLineIds.map(id => ({ id, from: 'cs-a', to: 'cs-b' })),
+						channels: [
+							{ id: 'cs-plain', from: 'cs-a', to: 'cs-b', lineIds: csLineIds.slice(0, 3) },
+							{
+								id: 'cs-grouped',
+								from: 'cs-a',
+								to: 'cs-b',
+								groups: [
+									{ id: 'cs-g1', lineIds: csLineIds.slice(3, 6) },
+									{ id: 'cs-g2', lineIds: csLineIds.slice(6) }
+								]
+							}
+						],
+						channelSimplify: { enabled: true, threshold: 2, style: { color: '#ff3300', width: 5 } },
+						fitPadding: 60,
+						showGrid: false
+					})
+					await settle(120)
+					const csStyles = csLineIds.map((_id, index) => csView.getLineStyle(index))
+					const csGroups = csView.getChannelGroups()
+					const csSnapshot = csView.getChannels()
+					const csSnapshotLaneCounts = csSnapshot.map(group => new Set(group.paths.map(path => JSON.stringify(path))).size)
+					const csRepresentative = csStyles[0]
+					const csDataCount = csView.getData().lines.length
+					check('通道简略：超过 threshold 的分组只画一条代表线，无 groups 的通道也按一组折叠', csStyles.filter(Boolean).length === 4 && csStyles[1] === null && csStyles[2] === null && csStyles[3] !== null && csStyles[4] === null && csStyles[5] === null && csStyles[6] !== null && csStyles[7] !== null, JSON.stringify(csStyles.map(style => style ? style.index : null)))
+					check('通道简略：代表线套自定义颜色 / 线宽，原始数据与分组成员不变', csRepresentative?.width === 5 && Math.abs(csRepresentative.color[0] - 1) < 1e-6 && Math.abs(csRepresentative.color[1] - 0.2) < 1e-6 && csDataCount === 8 && csGroups.length === 3 && csGroups.map(group => group.lineIds.length).join(',') === '3,3,2', JSON.stringify({ style: csRepresentative, data: csDataCount, groups: csGroups.map(group => group.lineIds.length) }))
+					check('通道简略：getChannels 快照为每条成员回线保留完整路径与各自车道',
+						csSnapshot.length === 3 && csSnapshot.every((group, index) => group.paths.length === group.lineIndexes.length && group.paths.every(path => Array.isArray(path) && path.length >= 2) && csSnapshotLaneCounts[index] === group.paths.length),
+						JSON.stringify(csSnapshot.map((group, index) => [group.lineIndexes.length, group.paths.length, csSnapshotLaneCounts[index], group.paths.map(path => path.length)])))
+					csView.updateOptions({ channelSimplify: false })
+					await settle(100)
+					const csRestoredStyles = csLineIds.map((_id, index) => csView.getLineStyle(index))
+					check('通道简略关闭后全部回线恢复，数据与分组读数仍不变', csRestoredStyles.every(Boolean) && csView.getData().lines.length === 8 && csView.getChannelGroups().length === 3, JSON.stringify(csRestoredStyles.map(style => style ? style.index : null)))
+					csView.destroy()
+					csHost.remove()
+
 					diag('复制 / 合并', `复制事件 ${cmEvents.length} 条，合并读数 linesChanged=${cmMergeDone.linesChanged} removedLines=${cmMergeDone.removedLines} removedChannels=${cmMergeDone.removedChannels} mergedChannels=${cmMergeDone.mergedChannels}`)
 					cmView2.destroy()
 					cmHost2.remove()
@@ -2412,6 +2544,24 @@
 					goView.destroy()
 					goHost.remove()
 
+					const rocHost = document.createElement('div')
+					rocHost.style.cssText = 'width:420px;height:280px'
+					document.body.appendChild(rocHost)
+					const rocView = createGisView(rocHost, {
+						points: [{ id: 'ra', x: -80, y: 0 }, { id: 'rb', x: 80, y: 0 }],
+						lines: [{ id: 'r1', from: 'ra', to: 'rb' }, { id: 'r2', from: 'ra', to: 'rb' }, { id: 'r3', from: 'ra', to: 'rb' }],
+						channels: [{ id: 'roc', groups: [{ id: 'roc-g1', lineIds: ['r1', 'r2'] }, { id: 'roc-g2', lineIds: ['r3'] }] }],
+						showGrid: false,
+						fitPadding: 60
+					})
+					await settle(100)
+					const rocRemoved = rocView.removeChannel('roc')
+					check('removeChannel 删除只写 groups 的通道时连同组内成员回线一起删净',
+						rocRemoved.ok === true && rocRemoved.lineIds.length === 3 && rocView.getData().lines.length === 0 && rocView.getChannelGroups('roc').length === 0,
+						JSON.stringify({ lineIds: rocRemoved.lineIds, lines: rocView.getData().lines.length, groups: rocView.getChannelGroups('roc').length }))
+					rocView.destroy()
+					rocHost.remove()
+
 					/* 这一轮新增：updateChannel 第三段（通道声明 + 逐条成员回线一次下发） */
 					const ucHost = document.createElement('div')
 					ucHost.style.cssText = 'width:420px;height:280px'
@@ -3886,6 +4036,46 @@ check('beginAddChannel({ lineData })：草稿按第二段对齐条数（circuits
 					check('exportData：format 写错直接抛异常（不静默兜底）', /view/.test(rdThrew) && /new/.test(rdThrew) && /test/.test(rdThrew), rdThrew)
 					rdView.destroy()
 					rdHost.remove()
+
+					/* 本轮：视口导出的线路 / 通道端点模式。半区只盖住左端点，和整区对照。 */
+					const veHost = document.createElement('div')
+					veHost.style.cssText = 'width:480px;height:300px'
+					document.body.appendChild(veHost)
+					const veView = createGisView(veHost, {
+						points: [
+							{ id: 've-a', x: -130, y: 0, size: 16 },
+							{ id: 've-b', x: 130, y: 0, size: 16 }
+						],
+						lines: [
+							{ id: 've-bound', from: 've-a', to: 've-b', width: 8 },
+							{ id: 've-path', path: [[-80, 60], [80, 60]], width: 8 },
+							{ id: 've-ch-line', from: 've-a', to: 've-b', width: 8 }
+						],
+						channels: [{ id: 've-ch', lineIds: ['ve-ch-line'] }],
+						showGrid: false,
+						fitOnInit: false,
+						initialView: { center: [0, 0], scale: 1 },
+						width: 480,
+						height: 300
+					})
+					await settle(120)
+					const veHalf = { minX: -200, minY: -100, maxX: 0, maxY: 100 }
+					const veAll = { minX: -200, minY: -100, maxX: 200, maxY: 100 }
+					const veLineIds = result => (result.lines ?? []).map(row => row.line_id).sort()
+					const veLegacy = veView.exportData({ scope: 'viewport', rect: veHalf, selectionKinds: ['line'] })
+					check('exportData 视口 line 旧模式：几何沾到视口的独立线路都导出', veLegacy.counts.points === 0 && veLegacy.counts.lines === 2 && veLineIds(veLegacy).join(',') === 've-bound,ve-path' && veLegacy.counts.channels === 0, JSON.stringify({ counts: veLegacy.counts, lines: veLineIds(veLegacy) }))
+					const veLineHalf = veView.exportData({ scope: 'viewport', rect: veHalf, selectionKinds: ['lineEndpoints'] })
+					check('exportData 视口 lineEndpoints：只盖住一端时不导出独立线路', veLineHalf.counts.lines === 0 && veLineHalf.lines.length === 0 && veLineHalf.counts.channels === 0, JSON.stringify(veLineHalf.counts))
+					const veLineAll = veView.exportData({ scope: 'viewport', rect: veAll, selectionKinds: ['line-endpoints'] })
+					check('exportData 视口 lineEndpoints：两端都在视口内才导出，纯 path 线路仍跳过', veLineAll.counts.points === 0 && veLineAll.counts.lines === 1 && veLineIds(veLineAll).join(',') === 've-bound', JSON.stringify({ counts: veLineAll.counts, lines: veLineIds(veLineAll) }))
+					const veChannelLegacy = veView.exportData({ scope: 'viewport', rect: veHalf, selectionKinds: ['channel'] })
+					check('exportData 视口 channel 旧模式：成员回线沾到视口就导出整条通道', veChannelLegacy.counts.channels === 1 && veChannelLegacy.channels[0].channel_name === 've-ch' && veChannelLegacy.counts.lines === 1, JSON.stringify({ counts: veChannelLegacy.counts, channels: veChannelLegacy.channels.map(row => row.channel_name) }))
+					const veChannelHalf = veView.exportData({ scope: 'viewport', rect: veHalf, selectionKinds: ['channelEndpoints'] })
+					check('exportData 视口 channelEndpoints：只盖住一端时不导出通道', veChannelHalf.counts.channels === 0 && veChannelHalf.counts.lines === 0, JSON.stringify(veChannelHalf.counts))
+					const veChannelAll = veView.exportData({ scope: 'viewport', rect: veAll, selectionKinds: ['channel-endpoints'] })
+					check('exportData 视口 channelEndpoints：两端都在视口内才导出整条通道与成员回线', veChannelAll.counts.points === 0 && veChannelAll.counts.channels === 1 && veChannelAll.counts.lines === 1 && veChannelAll.channels[0].channel_name === 've-ch' && veChannelAll.channels[0].line_data[0].line_id === 've-ch-line', JSON.stringify({ counts: veChannelAll.counts, lines: veLineIds({ lines: veChannelAll.channels[0].line_data }) }))
+					veView.destroy()
+					veHost.remove()
 				}
 				{
 					// 接口选中（selectFeatures）、读回选中（getSelectionData）与聚焦（focusOn：单个 / 一批 / 只居中）
@@ -4925,6 +5115,53 @@ check('beginAddChannel({ lineData })：草稿按第二段对齐条数（circuits
 					JSON.stringify({ removedChannels: cbManyRemoved.removedChannels?.map(item => item.id) }))
 				nwView.destroy()
 
+				/* 这一轮新增：getDirectConnections 只取传入节点集合内部的直接通道 / 线路 */
+				const dcHost = document.createElement('div')
+				dcHost.style.cssText = 'width:420px;height:280px'
+				document.body.appendChild(dcHost)
+				const dcView = createGisView(dcHost, {
+					points: [
+						{ id: 'da', x: -120, y: -60 },
+						{ id: 'db', x: 120, y: -60 },
+						{ id: 'dc', x: 120, y: 60 },
+						{ id: 'dd', x: -120, y: 60 }
+					],
+					lines: [
+						{ id: 'dc-ab-1', from: 'da', to: 'db' },
+						{ id: 'dc-ab-2', from: 'db', to: 'da' },
+						{ id: 'dc-bc', from: 'db', to: 'dc' },
+						{ id: 'dc-cd', from: 'dc', to: 'dd' },
+						{ id: 'dc-loop', from: 'da', to: 'da' },
+						{ id: 'dc-free', path: [[0, 0], [40, 40]] }
+					],
+					channels: [
+						{ id: 'dc-ch-ab', groups: [{ id: 'dc-ch-ab-g1', lineIds: ['dc-ab-1'] }] },
+						{ id: 'dc-ch-bc', from: 'db', to: 'dc', lineIds: ['dc-bc'] },
+						{ id: 'dc-ch-ad', from: 'da', to: 'dd', lineIds: ['dc-cd'] },
+						{ id: 'dc-ch-miss', from: 'da', to: 'missing', lineIds: [] },
+						{ id: 'dc-ch-free', groups: [{ id: 'dc-ch-free-g1', lineIds: ['dc-free'] }] }
+					],
+					showGrid: false,
+					fitPadding: 50
+				})
+				await settle(80)
+				const dcAB = dcView.getDirectConnections(['da', 'db'])
+				const dcAll = dcView.getDirectConnections(['da', 'db', 'dc'])
+				check('getDirectConnections：只返回集合内部的直接通道 / 线路，通道与成员回线可同时命中',
+					dcAB.map(item => item.type).join(',') === 'channel,line,line' && dcAB.map(item => item.channelId ?? item.lineId).join(',') === 'dc-ch-ab,dc-ab-1,dc-ab-2',
+					JSON.stringify(dcAB.map(item => ({ type: item.type, id: item.channelId ?? item.lineId, from: item.from.id, to: item.to.id }))))
+				check('getDirectConnections：通道端点可继承成员回线，线路保留声明方向与节点下标',
+					dcAB[0].from.id === 'da' && dcAB[0].to.id === 'db' && JSON.stringify(dcAB[0].lineIds) === JSON.stringify(['dc-ab-1']) && dcAB[2].from.id === 'db' && dcAB[2].to.id === 'da' && dcAB[2].from.index === 1 && dcAB[2].to.index === 0,
+					JSON.stringify({ channel: dcAB[0], reverse: dcAB[2] }))
+				check('getDirectConnections：三个节点时连上集合内的第二条边，不把集合外的边一起带回来',
+					dcAll.length === 5 && dcAll.some(item => item.type === 'channel' && item.channelId === 'dc-ch-bc') && dcAll.filter(item => item.type === 'line').map(item => item.lineId).join(',') === 'dc-ab-1,dc-ab-2,dc-bc',
+					JSON.stringify(dcAll.map(item => ({ type: item.type, id: item.channelId ?? item.lineId }))))
+				check('getDirectConnections：节点不足两个 / 有节点不存在 / 端点认不出 / 自环与未绑定线路都返回空表',
+					dcView.getDirectConnections([]).length === 0 && dcView.getDirectConnections('da').length === 0 && dcView.getDirectConnections(['da', 'missing']).length === 0 && dcView.getDirectConnections(['da', 'db', 'da']).length === 3,
+					JSON.stringify({ empty: dcView.getDirectConnections([]), missing: dcView.getDirectConnections(['da', 'missing']), duplicate: dcView.getDirectConnections(['da', 'db', 'da']).length }))
+				dcView.destroy()
+				dcHost.remove()
+
 				/* 这一轮新增：addLine / addChannel 第二段的裸 id 归一（见 15.98）+ 视口量不出来时挂起的落位请求封存的是「请求那一刻」的目标（见 16.68） */
 				const bvHost = document.createElement('div')
 				bvHost.style.cssText = 'width:520px;height:340px'
@@ -5823,6 +6060,77 @@ check('beginAddChannel({ lineData })：草稿按第二段对齐条数（circuits
 				check('splitPoint({ autoLines: alternate })：通道端点跟随整组成员，lineAssignments 报出每一份的线路条数', autoSplit.lineAssignments.length === 2 && autoSplit.lineAssignments.reduce((sum, item) => sum + item.lineCount, 0) === 5 && String(autoSplitChannel?.from) === String(autoSplit.pointIds[autoChannelSlotA]) && String(autoSplitChannel?.to) === 'as-a' && autoSplitNewPoint !== 'as-hub', JSON.stringify({ channelFrom: autoSplitChannel?.from, newPoint: autoSplitNewPoint, counts: autoSplit.lineAssignments.map(item => item.lineCount) }))
 				autoSplitView.destroy()
 				autoSplitHost.remove()
+
+				/* 首屏 center / scale 简写、比例 API 与空闲检测 */
+				const cameraApiHost = document.createElement('div')
+				cameraApiHost.style.cssText = 'width:480px;height:280px'
+				document.body.append(cameraApiHost)
+				const cameraApiView = createGisView(cameraApiHost, {
+					points: [{ id: 'camera-api-a', x: 0, y: 0 }],
+					center: [12, -8],
+					scale: 3,
+					showGrid: false
+				})
+				await settle()
+				const shorthandCamera = cameraApiView.getCamera()
+				check('创建时顶层 center / scale 直接决定首屏相机', Math.abs(shorthandCamera.center[0] - 12) < 0.01 && Math.abs(shorthandCamera.center[1] + 8) < 0.01 && Math.abs(shorthandCamera.scale - 3) < 0.001, JSON.stringify(shorthandCamera))
+				check('getScale / setScale：读写同一份相机比例', Math.abs(cameraApiView.getScale() - 3) < 0.001 && cameraApiView.setScale(5, [100, 80]) === cameraApiView && Math.abs(cameraApiView.getScale() - 5) < 0.001 && Math.abs(cameraApiView.getCamera().scale - 5) < 0.001, JSON.stringify({ before: 3, after: cameraApiView.getScale() }))
+				cameraApiView.updateOptions({ scale: 4 })
+				cameraApiView.applyInitialView()
+				const mergedScaleCamera = cameraApiView.getCamera()
+				cameraApiView.updateOptions({ center: [20, -10] })
+				cameraApiView.applyInitialView()
+				const mergedInitialView = cameraApiView.getCamera()
+				check('updateOptions 的 center / scale 简写合进同一份 initialView，不会互相冲掉', Math.abs(mergedScaleCamera.center[0] - 12) < 0.01 && Math.abs(mergedScaleCamera.center[1] + 8) < 0.01 && Math.abs(mergedScaleCamera.scale - 4) < 0.001 && Math.abs(mergedInitialView.center[0] - 20) < 0.01 && Math.abs(mergedInitialView.center[1] + 10) < 0.01 && Math.abs(mergedInitialView.scale - 4) < 0.001, JSON.stringify({ afterScale: mergedScaleCamera, afterCenter: mergedInitialView }))
+				cameraApiView.destroy()
+				cameraApiHost.remove()
+
+				const precedenceHost = document.createElement('div')
+				precedenceHost.style.cssText = 'width:480px;height:280px'
+				document.body.append(precedenceHost)
+				const precedenceView = createGisView(precedenceHost, {
+					points: [{ id: 'precedence-a', x: 0, y: 0 }],
+					center: [1, 2],
+					scale: 9,
+					initialView: { center: [30, 40], scale: 2 },
+					showGrid: false
+				})
+				await settle()
+				const precedenceCamera = precedenceView.getCamera()
+				check('显式 initialView 整份优先于顶层 center / scale 简写', Math.abs(precedenceCamera.center[0] - 30) < 0.01 && Math.abs(precedenceCamera.center[1] - 40) < 0.01 && Math.abs(precedenceCamera.scale - 2) < 0.001, JSON.stringify(precedenceCamera))
+				precedenceView.destroy()
+				precedenceHost.remove()
+
+				const idleHost = document.createElement('div')
+				idleHost.style.cssText = 'width:480px;height:280px'
+				document.body.append(idleHost)
+				const idleCalls = []
+				const idleBusCalls = []
+				const idleView = createGisView(idleHost, {
+					points: [{ id: 'idle-a', x: 0, y: 0 }],
+					idleTimeout: 45,
+					onIdle: payload => idleCalls.push(payload),
+					showGrid: false
+				})
+				idleView.on('idle', payload => idleBusCalls.push(payload))
+				const idleStartedAt = idleView.getIdleTime()
+				await settleMs(110)
+				const firstIdle = idleCalls[0]
+				const afterFirstIdle = idleView.getIdleTime()
+				await settleMs(80)
+				check('idleTimeout：到点只回调一次，getIdleTime 持续增长', idleStartedAt >= 0 && idleCalls.length === 1 && idleBusCalls.length === 1 && firstIdle?.timeout === 45 && firstIdle?.idleTime >= 40 && afterFirstIdle >= firstIdle?.idleTime, JSON.stringify({ start: idleStartedAt, after: afterFirstIdle, calls: idleCalls.length, bus: idleBusCalls.length, payload: firstIdle }))
+				check('idleTimeout：同一空闲段不重复触发', idleCalls.length === 1 && idleBusCalls.length === 1, JSON.stringify({ calls: idleCalls.length, bus: idleBusCalls.length }))
+				const idleBox = idleView.canvas.getBoundingClientRect()
+				idleView.canvas.dispatchEvent(new PointerEvent('pointerdown', { bubbles: true, cancelable: true, pointerId: 31, pointerType: 'mouse', clientX: idleBox.left + 20, clientY: idleBox.top + 20 }))
+				const afterActivity = idleView.getIdleTime()
+				await settleMs(110)
+				check('idleTimeout：用户操作重置 getIdleTime，并开启下一段空闲触发', afterActivity < 40 && idleCalls.length === 2 && idleBusCalls.length === 2, JSON.stringify({ afterActivity, calls: idleCalls.length, bus: idleBusCalls.length }))
+				idleView.destroy()
+				const idleBeforeDestroyWait = idleCalls.length
+				await settleMs(80)
+				check('destroy 后清除 idle 定时器，不再触发回调', idleCalls.length === idleBeforeDestroyWait, JSON.stringify({ before: idleBeforeDestroyWait, after: idleCalls.length }))
+				idleHost.remove()
+
 				lineOnlyView.destroy()
 				lineOnlyHost.remove()
 				splitView.destroy()

package/docs/steps/selftest-labels.html

@@ -1363,6 +1363,87 @@
 				check('线路标签同样支持 labelRender: canvas（优化档、6 条全部进画布）', Number(lineCanvas?.dataset.labelCount || 0) === 6 && (lineCanvasLayer?.querySelectorAll('.gis-view__label').length ?? 0) === 0, `画布 ${lineCanvas?.dataset.labelCount ?? 0} 条 / DOM ${lineCanvasLayer?.querySelectorAll('.gis-view__label').length ?? 0} 条`)
 				canvasLineView.destroy()
 				canvasLineHost.remove()
+				// 32. 中心点 API / selectionOnTop / 标签层级 / 跟随节点 / 字号缩放
+				const layerHost = document.createElement('div')
+				layerHost.style.cssText = 'width:640px;height:380px'
+				document.body.append(layerHost)
+				const layerView = createGisView(layerHost, {
+					points: [
+						{ id: 'layer-low', x: 0, y: 0, name: '低层', zIndex: 0 },
+						{ id: 'layer-occluder', x: 30, y: 0, name: '遮挡', zIndex: 20, labelVisible: false },
+						{ id: 'layer-high', x: 200, y: 0, name: '高层', zIndex: 20 },
+						{ id: 'layer-far', x: -100, y: -100, name: '端点', zIndex: 0, labelVisible: false }
+					],
+					lines: [{ id: 'layer-line', from: 'layer-low', to: 'layer-far', name: '选中线' }],
+					channels: [{ id: 'layer-channel', from: 'layer-low', to: 'layer-far', lineIds: ['layer-line'] }],
+					initialView: { scale: 1, center: [0, 0] },
+					zoomBaseScale: 1,
+					label: { enabled: true, content: '{name}', followNodeZIndex: true, maxCount: 20 },
+					showGrid: false
+				})
+				await settle(320)
+				const layerLabel = index => layerHost.querySelector(`.gis-view__label[data-label-kind='point'][data-label-index='${index}']`)
+				check('followNodeZIndex：低层标签先被更高层节点的图标盖住', !layerLabel(0) && Boolean(layerLabel(2)), `低层 ${layerLabel(0) ? '在' : '不在'} / 高层 ${layerLabel(2) ? '在' : '不在'}`)
+				const lowLabelInfo = layerView.getLabels('point', 0)?.[0]
+				const highLabelInfo = layerView.getLabels('point', 2)?.[0]
+				check('getLabels 报出生效层级与跟随开关', lowLabelInfo?.zIndex === 0 && lowLabelInfo?.followNodeZIndex === true && highLabelInfo?.zIndex === 20, JSON.stringify({ low: lowLabelInfo && { zIndex: lowLabelInfo.zIndex, follow: lowLabelInfo.followNodeZIndex }, high: highLabelInfo && { zIndex: highLabelInfo.zIndex, follow: highLabelInfo.followNodeZIndex } }))
+				layerView.updateLabel('point', 'layer-low', { zIndex: 40 })
+				await settle(300)
+				const explicitLow = layerLabel(0)
+				const highNode = layerLabel(2)
+				check('显式 zIndex 压过跟随层级：低层标签重新出现且 CSS 层级更高', Boolean(explicitLow) && Number(getComputedStyle(explicitLow).zIndex) > Number(getComputedStyle(highNode).zIndex), `低层 ${explicitLow ? getComputedStyle(explicitLow).zIndex : '不在'} / 高层 ${highNode ? getComputedStyle(highNode).zIndex : '不在'}`)
+				layerView.updateLabel('point', 'layer-low', { zIndex: null })
+				await settle(300)
+				check('显式层级写回 null 后恢复跟随节点层级', !layerLabel(0) && layerView.getLabels('point', 0)?.[0]?.zIndex === 0, JSON.stringify(layerView.getLabels('point', 0)?.[0] ?? null))
+				layerView.updatePoint('layer-occluder', { zIndex: 0 })
+				await settle(320)
+				check('节点样式链的 zIndex 变了会触发标签重排：遮挡消失后低层标签回来', Boolean(layerLabel(0)) && Number(getComputedStyle(layerLabel(0)).zIndex) === 1000000, layerLabel(0) ? getComputedStyle(layerLabel(0)).zIndex : '没有标签')
+				layerView.selectFeatures(['layer-line'])
+				await settle(120)
+				const lineScene = layerView.snapshotScene()
+				check('selectionOnTop：选中线路在普通节点之后、两端节点之前', lineScene.raisedLines.length === 1 && lineScene.lines.length === 0 && lineScene.points.length === 2 && lineScene.raised.length === 2, JSON.stringify({ raisedLines: lineScene.raisedLines.length, lines: lineScene.lines.length, points: lineScene.points.length, raised: lineScene.raised.length }))
+				layerView.deselect()
+				layerView.selectFeatures({ type: 'channel', channelId: 'layer-channel' })
+				await settle(120)
+				const channelScene = layerView.snapshotScene()
+				check('selectionOnTop：选中通道整条抬层，两端节点仍压在线路上', channelScene.raisedLines.length === 1 && channelScene.lines.length === 0 && channelScene.raised.length === 2, JSON.stringify({ raisedLines: channelScene.raisedLines.length, lines: channelScene.lines.length, raised: channelScene.raised.length }))
+				const labelScaleHost = document.createElement('div')
+				labelScaleHost.style.cssText = 'width:640px;height:380px'
+				document.body.append(labelScaleHost)
+				const labelScaleView = createGisView(labelScaleHost, {
+					points: [{ id: 'zoom-point', x: 0, y: 0, name: '缩放' }],
+					initialView: { scale: 1, center: [0, 0] },
+					zoomBaseScale: 1,
+					label: { enabled: true, content: '{name}', maxCount: 1, style: { fontSize: '10px' }, zoomScale: 0 },
+					showGrid: false
+				})
+				await settle(260)
+				const labelScaleNode = () => labelScaleHost.querySelector(`.gis-view__label[data-label-kind='point'][data-label-index='0']`)
+				const labelScaleFontSize = () => labelScaleNode() ? parseFloat(getComputedStyle(labelScaleNode()).fontSize) : 0
+				const centerCopy = labelScaleView.getCenter()
+				centerCopy[0] += 999
+				const centerKept = labelScaleView.getCenter()
+				const setCenterReturn = labelScaleView.setCenter([120, -80])
+				const centerAfterSet = labelScaleView.getCenter()
+				const centerScale = labelScaleView.getCamera().scale
+				check('getCenter / setCenter：返回副本、只改中心且可链式调用', Math.abs(centerKept[0]) < 1e-6 && Math.abs(centerKept[1]) < 1e-6 && setCenterReturn === labelScaleView && Math.abs(centerAfterSet[0] - 120) < 1e-6 && Math.abs(centerAfterSet[1] + 80) < 1e-6 && Math.abs(centerScale - 1) < 1e-6, JSON.stringify({ kept: centerKept, set: centerAfterSet, scale: centerScale }))
+				check('zoomScale: 0 时标签字号固定为屏幕字号（比例 2 仍是 10px）', labelScaleFontSize() === 10, `${labelScaleFontSize()}px`)
+				labelScaleView.setCamera({ scale: 2, center: [0, 0] })
+				await settle(320)
+				check('zoomScale: 0 放大到 2 倍后字号不动', labelScaleFontSize() === 10, `${labelScaleFontSize()}px`)
+				labelScaleView.updateLabel('point', 'zoom-point', { zoomScale: 1 })
+				await settle(320)
+				check('zoomScale: 1 时字号按相机比例放大到 20px', labelScaleFontSize() === 20 && labelScaleView.getLabels('point', 0)?.[0]?.zoomScale === 1, `${labelScaleFontSize()}px / ${labelScaleView.getLabels('point', 0)?.[0]?.zoomScale}`)
+				labelScaleView.setCamera({ scale: 4, center: [0, 0] })
+				await settle(360)
+				check('zoomScale: 1 时字号继续跟随到 40px', labelScaleFontSize() === 40, `${labelScaleFontSize()}px`)
+				labelScaleView.updateLabel('point', 'zoom-point', { zoomScale: 0 })
+				await settle(320)
+				check('zoomScale 改回 0 后恢复固定字号', labelScaleFontSize() === 10, `${labelScaleFontSize()}px`)
+				labelScaleView.destroy()
+				labelScaleHost.remove()
+				layerView.destroy()
+				layerHost.remove()
 				richView.destroy()
 				reRichView.destroy()
 				richHost.remove()

package/docs/steps/selftest-perf.html

@@ -270,9 +270,37 @@
 				check('数据包围盒缓存：追加到范围外的节点会立即扩大读数',
 					boundsAfterAppend.minX === -600 && boundsAfterAppend.minY === -700,
 					JSON.stringify(boundsAfterAppend))
-				boundsView.destroy()
-				boundsHost.remove()
-				// 两万个点会走发散渲染：等它铺完再拾取（没铺到的节点按设计不参与拾取）
+				boundsView.destroy()
+				boundsHost.remove()
+				// 节点 id 索引：整份 refresh 后仍能解析 from / to；定向改 id 时旧键必须立即失效、新键马上可绑定
+				const idIndexHost = document.createElement('div')
+				document.querySelector('#map').append(idIndexHost)
+				const idIndexView = createGisView(idIndexHost, {
+					points: [{ id: 'ida', x: 0, y: 0 }, { id: 'idb', x: 100, y: 0 }],
+					lines: [{ id: 'idl', from: 'ida', to: 'idb' }],
+					width: 320,
+					height: 200
+				})
+				idIndexView.refresh()
+				// 隐藏节点插到最前面：可见 id 顺序不变、解析下标整体后移，缓存必须按新下标重建
+				idIndexView.updateData({
+					points: [{ id: 'hidden', x: -50, y: 0, visible: false }, { id: 'ida', x: 0, y: 0 }, { id: 'idb', x: 100, y: 0 }]
+				})
+				const idLineAfterShift = idIndexView.getLine('idl')
+				check('节点 id 索引：隐藏节点增删导致可见下标平移时仍按新下标解析',
+					idLineAfterShift?.path?.length === 2 && idLineAfterShift.path[0][0] === 0 && idLineAfterShift.path[1][0] === 100,
+					JSON.stringify({ path: idLineAfterShift?.path ?? null }))
+				const idLineAfterRefresh = idIndexView.getLine('idl')
+				idIndexView.updatePoint('ida', { id: 'ida-renamed' })
+				const idLineOldKey = idIndexView.getLine('idl')
+				const idLineAdded = idIndexView.addLine({ id: 'idl-new', from: 'ida-renamed', to: 'idb' })
+				const idLineNewKey = idIndexView.getLine('idl-new')
+				check('节点 id 索引：整份 refresh 后绑定线路仍可解析；updatePoint 改 id 后旧键立即失效、新键马上可绑定',
+					idLineAfterRefresh?.path?.length === 2 && (idLineOldKey?.path?.length ?? 0) < 2 && idLineAdded.ok && idLineNewKey?.path?.length === 2 && idLineNewKey.path[0][0] === 0 && idLineNewKey.path[1][0] === 100,
+					JSON.stringify({ refresh: idLineAfterRefresh?.path ?? null, oldAfterRename: idLineOldKey?.path ?? null, added: idLineAdded.ok, renamed: idLineNewKey?.path ?? null }))
+				idIndexView.destroy()
+				idIndexHost.remove()
+				// 两万个点会走发散渲染：等它铺完再拾取（没铺到的节点按设计不参与拾取）
 				const readyDeadline = now() + 8000
 				while (!big.isLayoutReady() && now() < readyDeadline) {
 					await sleep(50)

package/docs/steps/selftest-select.html

@@ -317,10 +317,60 @@
 				ckView.updateOptions({ selectionKinds: 'all' })
 				ckView.selectInBox({ x: 0, y: 0, width: ckBox.width, height: ckBox.height })
 				const ckBoxedInfo = ckView.getSelectionData()
-				check('selectInBox：线路框选与通道摊开沿用同一份判定（整框一次收下节点 / 独立线路 / 通道回线）', ckBoxedInfo.count === 4 && ckBoxedInfo.pointCount === 2 && ckBoxedInfo.lineCount === 2 && ckBoxedInfo.channelCount === 1, JSON.stringify({ items: ckBoxedInfo.count, points: ckBoxedInfo.pointCount, lines: ckBoxedInfo.lineCount, channels: ckBoxedInfo.channelCount }))
+				check('selectInBox：线路框选与通道摊开沿用同一份判定（整框一次收下节点 / 独立线路 / 通道回线）', ckBoxedInfo.count === 4 && ckBoxedInfo.pointCount === 2 && ckBoxedInfo.lineCount === 2 && ckBoxedInfo.channelCount === 1, JSON.stringify({ items: ckBoxedInfo.count, points: ckBoxedInfo.pointCount, lines: ckBoxedInfo.lineCount, channels: ckBoxedInfo.channelCount }))
 				ckView.destroy()
 				ckHost.remove()
 
+				/* ---------- 本轮：线路 / 通道的端点框选模式 ---------- */
+				// 半框只盖住左端点：普通 line / channel 仍按“几何沾框”命中，端点模式必须两个端点都在框里。
+				const epHost = document.createElement('div')
+				epHost.style.cssText = 'width:480px;height:320px'
+				document.body.append(epHost)
+				const epView = createGisView(epHost, {
+					points: [
+						{ id: 'ep-a', x: -130, y: 0, size: 16 },
+						{ id: 'ep-b', x: 130, y: 0, size: 16 }
+					],
+					lines: [
+						{ id: 'ep-bound', from: 'ep-a', to: 'ep-b', width: 8 },
+						{ id: 'ep-path', path: [[-80, 60], [80, 60]], width: 8 },
+						{ id: 'ep-ch-line', from: 'ep-a', to: 'ep-b', width: 8 }
+					],
+					channels: [{ id: 'ep-ch', lineIds: ['ep-ch-line'] }],
+					features: 'view',
+					selectionKinds: 'all',
+					showGrid: false,
+					fitOnInit: false,
+					initialView: { center: [0, 0], scale: 1 },
+					width: 480,
+					height: 320
+				})
+				await settle(120)
+				const epBox = epView.canvas.getBoundingClientRect()
+				const epHalf = { x: 0, y: 0, width: epBox.width / 2, height: epBox.height }
+				const epAll = { x: 0, y: 0, width: epBox.width, height: epBox.height }
+				const epInfo = () => epView.getSelectionData()
+				epView.selectInBox(epHalf, { selectionKinds: ['line'] })
+				const epLegacy = epInfo()
+				check('line 旧模式：线路几何沾到半框就选中', epLegacy.lineCount === 2 && epView.isSelected('ep-bound') && epView.isSelected('ep-path'), JSON.stringify({ lines: epLegacy.lineCount, ids: epLegacy.ids }))
+				epView.selectInBox(epHalf, { selectionKinds: ['lineEndpoints'] })
+				const epLineHalf = epInfo()
+				check('lineEndpoints：只框住一端时独立线路不选中', epLineHalf.lineCount === 0 && epLineHalf.channelCount === 0 && !epView.isSelected('ep-bound') && !epView.isSelected('ep-path'), JSON.stringify({ lines: epLineHalf.lineCount, channels: epLineHalf.channelCount, ids: epLineHalf.ids }))
+				epView.selectInBox(epAll, { selectionKinds: ['line-endpoints'] })
+				const epLineAll = epInfo()
+				check('lineEndpoints：两端都在框内才选中，纯 path 线路仍跳过（不依赖 point 档）', epLineAll.pointCount === 0 && epLineAll.lineCount === 1 && epView.isSelected('ep-bound') && !epView.isSelected('ep-path'), JSON.stringify({ points: epLineAll.pointCount, lines: epLineAll.lineCount, ids: epLineAll.ids }))
+				epView.selectInBox(epHalf, { selectionKinds: ['channel'] })
+				const epChannelHalfLegacy = epInfo()
+				check('channel 旧模式：成员回线沾到半框就选中整条通道', epChannelHalfLegacy.channelCount === 1 && epChannelHalfLegacy.lineCount === 1 && epView.isSelected('ep-ch-line'), JSON.stringify({ lines: epChannelHalfLegacy.lineCount, channels: epChannelHalfLegacy.channelCount, ids: epChannelHalfLegacy.ids }))
+				epView.selectInBox(epHalf, { selectionKinds: ['channelEndpoints'] })
+				const epChannelHalf = epInfo()
+				check('channelEndpoints：只框住一端时通道不选中', epChannelHalf.channelCount === 0 && epChannelHalf.lineCount === 0 && !epView.isSelected('ep-ch-line'), JSON.stringify({ lines: epChannelHalf.lineCount, channels: epChannelHalf.channelCount, ids: epChannelHalf.ids }))
+				epView.selectInBox(epAll, { selectionKinds: ['channel-endpoints'] })
+				const epChannelAll = epInfo()
+				check('channelEndpoints：两端节点都在框内才选中整条通道', epChannelAll.pointCount === 0 && epChannelAll.channelCount === 1 && epChannelAll.lineCount === 1 && epView.isSelected('ep-ch-line'), JSON.stringify({ points: epChannelAll.pointCount, lines: epChannelAll.lineCount, channels: epChannelAll.channelCount, ids: epChannelAll.ids }))
+				epView.destroy()
+				epHost.remove()
+
 				/* ---------- 问题 1（本轮）：接口取消选中 —— deselect（单个 / 一批 / 整条通道）与「取消全部」的老写法 ---------- */
 				const dzHost = document.createElement('div')
 				dzHost.style.cssText = 'width:320px;height:200px'

package/docs//344/273/2160/345/210/260/345/256/214/346/225/264/347/232/204/345/256/236/347/216/260.md

@@ -1,6 +1,7 @@
 # 从 0 到完整的实现（索引）
 
 这一份是「照着源码从零写一遍」的讲义：先讲清地图的模型，再一块一块把渲染、相机、解析层、通道、覆盖层、筛选与性能写出来，最后给一份可以照抄的整套代码。
+第一次从 0 上手，建议先走 [四段学习路线、每步验收与优化顺序](steps/README.md)：第 1 ~ 9 步手写主干，第 10 步接入真组件，第 11 ~ 13 步补上线配置；卡住时再回到下面章节补原理，或直接照抄 `from0/13` / `14` 的整套代码。
 只想用组件看 [GisView.md](GisView.md)；每一帧怎么实现、为什么这么写看 [实现原理](GisView实现原理.md)；分步 demo（每步一个文件、页面上直接跑）在 [docs/steps](steps/README.md)。
 性能数据与 WebGPU 的取舍见 [实现原理 18 性能实测与 WebGPU 评估](internals/18-性能实测与WebGPU评估.md#18-性能实测与-webgpu-评估)。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gis-view-webgl2",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "WebGL2 矢量视图：点、线与 GeoJSON / 图片背景层，无内置界面，点击 / 双击 / 拖拽可配置",
   "type": "module",
   "scripts": {