gis-view-webgl2 0.1.7 → 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()
@@ -2264,7 +2396,7 @@
 					check('拆分发 channelGroupChange（action: splitGroups 带新组表）', cgBus.length === 1 && cgSplit?.action?.type === 'splitGroups' && cgSplit.action.groupIds.length === 2 && cgSplit.channelId === 'ch-1' && cgSplit.groups.length === 2, JSON.stringify({ type: cgSplit?.action?.type, groupIds: cgSplit?.action?.groupIds }))
 					check('onChannelGroupChange 回调和事件总线收到同一份载荷', cgOption.length === 1 && cgOption[0] === cgBus[0])
 
-					// 选中一条回线再合并：选中镜像里的 groupId / groupIndex 要跟着真值走（本轮修复的回归守卫）
+					// 选中一条回线再合并：选中项不再挂通道字段，实时归属要跟着真值走（回归守卫）
 					cgView.selectFeatures('c2')
 					await settle(60)
 					const cgTruth = () => {
@@ -2277,7 +2409,10 @@
 					cgView.mergeChannelGroups('ch-1', [cgAfterSplit[1].id], cgAfterSplit[0].id)
 					await settle(60)
 					const cgMerged = cgTruth()
-					check('合并回线之后选中镜像的 groupId / groupIndex 一起刷新（本轮修复）', String(cgMirror()?.groupId) === cgMerged?.id && cgMirror()?.groupIndex === cgMerged?.index, `镜像 ${cgMirror()?.groupId}/${cgMirror()?.groupIndex} / 真值 ${cgMerged?.id}/${cgMerged?.index}`)
+					const cgOwner = cgView.getLineChannel('c2')
+					const cgOwnerGroups = cgView.getChannelGroups('ch-1')
+					const cgOwnerGroupIndex = cgOwnerGroups.findIndex(group => String(group.id) === String(cgOwner?.groupId))
+					check('合并回线之后 getLineChannel 的 groupId / groupIndex 一起刷新，选中项仍不挂通道字段', String(cgOwner?.groupId) === cgMerged?.id && cgOwnerGroupIndex === cgMerged?.index && cgMirror()?.groupId === undefined && cgMirror()?.groupIndex === undefined, `归属 ${cgOwner?.groupId}/${cgOwnerGroupIndex} / 真值 ${cgMerged?.id}/${cgMerged?.index} / 镜像 ${cgMirror()?.groupId}/${cgMirror()?.groupIndex}`)
 					const cgMerge = cgBus[cgBus.length - 1]
 					check('合并发 channelGroupChange（action: mergeGroups 带目标组与来源组）', cgMerge?.action?.type === 'mergeGroups' && String(cgMerge.action.groupId) === String(cgMerged?.id) && cgMerge.action.groupIds.length === 2, JSON.stringify({ type: cgMerge?.action?.type, groupId: cgMerge?.action?.groupId, groupIds: cgMerge?.action?.groupIds }))
 
@@ -2409,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'
@@ -2657,7 +2810,7 @@
 					chView.destroy()
 					chHost.remove()
 
-					/* 这一轮新增：屏幕 ↔ 真实坐标互转 / addChannel 第二段 lineItems / beginAddChannel 交接模式 */
+/* 这一轮新增：屏幕 ↔ 真实坐标互转 / addChannel 第二段 lineData / beginAddChannel 交接模式 */
 					const hwHost = document.createElement('div')
 					hwHost.style.cssText = 'width:420px;height:280px'
 					document.body.appendChild(hwHost)
@@ -2701,18 +2854,18 @@
 					const hwClientViaScreen = hwView.screenToClient(hwScreen[0], hwScreen[1])
 					check('screenToClient(project(世界)) 与 worldToClient(同一世界) 同一结果：反向也等价', Math.abs(hwClientViaScreen[0] - hwClient[0]) < 1e-6 && Math.abs(hwClientViaScreen[1] - hwClient[1]) < 1e-6, JSON.stringify({ viaScreen: hwClientViaScreen, viaWorld: hwClient }))
 					// ② addChannel / addLine 第二段：连同线路一起新建
-					const hwAdd = hwView.addChannel({ from: 'ha', to: 'hb', name: '第二段通道', circuits: 5 }, [
+					const hwAdd = hwView.addChannel({ from: 'ha', to: 'hb', name: '第二段通道' }, [
 						{ id: 'hw-l1', color: '#112233', width: 4 },
 						{ id: 'hw-l2', color: '#445566' }
 					])
 					const hwLine = id => hwView.getOptions().lines.find(line => String(line.id) === id)
 					const hwChannelOf = channelId => hwView.getOptions().channels.find(channel => String(channel.id) === String(channelId))
-					check('addChannel(input, lineItems)：给了几条建几条（circuits: 5 忽略），逐条字段各自落地', hwAdd.ok === true && hwAdd.lineIds.length === 2 && hwAdd.circuits === 2 && (hwChannelOf(hwAdd.channelId)?.lineIds ?? []).length === 2 && hwLine('hw-l1')?.color === '#112233' && hwLine('hw-l1')?.width === 4 && hwLine('hw-l2')?.color === '#445566', JSON.stringify({ ids: hwAdd.lineIds, circuits: hwAdd.circuits, l1: hwLine('hw-l1') }))
-					const hwAddOne = hwView.addLine({ from: 'hc', to: 'hd', circuits: 3 }, { id: 'hw-solo', color: '#abcdef' })
+					check('addChannel(spec, lineData)：给几条建几条，逐条字段各自落地', hwAdd.ok === true && hwAdd.lineIds.length === 2 && hwAdd.circuits === 2 && (hwChannelOf(hwAdd.channelId)?.lineIds ?? []).length === 2 && hwLine('hw-l1')?.color === '#112233' && hwLine('hw-l1')?.width === 4 && hwLine('hw-l2')?.color === '#445566', JSON.stringify({ ids: hwAdd.lineIds, circuits: hwAdd.circuits, l1: hwLine('hw-l1') }))
+					const hwAddOne = hwView.addLine({ from: 'hc', to: 'hd' }, { id: 'hw-solo', color: '#abcdef' })
 					check('第二段收单条（非数组）也认：addLine 按它建一条独立线路', hwAddOne.ok === true && hwAddOne.lineIds.length === 1 && hwAddOne.lineIds[0] === 'hw-solo' && hwAddOne.kind === 'line' && hwLine('hw-solo')?.color === '#abcdef', JSON.stringify({ ids: hwAddOne.lineIds, circuits: hwAddOne.circuits }))
-					const hwBatch = hwView.addChannels([{ from: 'ha', to: 'hc', lineItems: [{ id: 'hw-b1' }, { id: 'hw-b2' }, { id: 'hw-b3' }] }])
-					check('addChannels 的每一项也能写 lineItems：三条一起建', hwBatch.ok === true && hwBatch.lineIds.length === 3 && ['hw-b1', 'hw-b2', 'hw-b3'].every(id => hwLine(id) !== undefined), JSON.stringify({ ids: hwBatch.lineIds }))
-					// ③ beginAddChannel：lineItems 对齐条数、handoff 交接
+					const hwBatch = hwView.addChannels([{ from: 'ha', to: 'hc', lineData: [{ id: 'hw-b1' }, { id: 'hw-b2' }, { id: 'hw-b3' }] }])
+					check('addChannels 的每一项写 lineData：三条一起建', hwBatch.ok === true && hwBatch.lineIds.length === 3 && ['hw-b1', 'hw-b2', 'hw-b3'].every(id => hwLine(id) !== undefined), JSON.stringify({ ids: hwBatch.lineIds }))
+// ③ beginAddChannel：lineData 对齐条数、handoff 交接
 					const hwClickPoint = id => {
 						const item = hwView.getData().points.find(point => point.id === id)
 						return hwView.project(item.x, item.y)
@@ -2748,9 +2901,13 @@
 					const hwHandAdd = hwReady ? hwView.addChannel({ from: hwReady.from.id, to: hwReady.to.id, name: '交接通道' }) : { ok: false }
 					check('交接之后自己走 addChannel：真实的通道与回线落地', hwHandAdd.ok === true && hwHandAdd.channelId !== null && hwView.getOptions().lines.length === hwLineBefore + 1, JSON.stringify({ ok: hwHandAdd.ok, channelId: hwHandAdd.channelId }))
 					hwDraftEvents.length = 0
-					hwView.beginAddChannel({ autoCommit: true, lineItems: [{ id: 'hw-d1', color: '#0a0b0c' }, { id: 'hw-d2', color: '#0d0e0f' }] })
-					await settle(40)
-					check('beginAddChannel({ lineItems })：草稿按第二段对齐条数（circuits = 2）', hwView.getAddChannelDraft()?.circuits === 2 && (hwView.getAddChannelDraft()?.lineItems?.length ?? 0) === 2, JSON.stringify({ circuits: hwView.getAddChannelDraft()?.circuits }))
+hwView.beginAddChannel({ lineItems: [{ id: 'hw-old-d1' }, { id: 'hw-old-d2' }] })
+await settle(40)
+check('beginAddChannel 旧 lineItems 已移除：不进入草稿的 lineData、回数按缺省 1', hwView.getAddChannelDraft()?.lineData === null && hwView.getAddChannelDraft()?.circuits === 1, JSON.stringify({ circuits: hwView.getAddChannelDraft()?.circuits, lineData: hwView.getAddChannelDraft()?.lineData }))
+hwView.cancelAddChannel()
+hwView.beginAddChannel({ autoCommit: true, lineData: [{ id: 'hw-d1', color: '#0a0b0c' }, { id: 'hw-d2', color: '#0d0e0f' }] })
+await settle(40)
+check('beginAddChannel({ lineData })：草稿按第二段对齐条数（circuits = 2）', hwView.getAddChannelDraft()?.circuits === 2 && (hwView.getAddChannelDraft()?.lineData?.length ?? 0) === 2, JSON.stringify({ circuits: hwView.getAddChannelDraft()?.circuits }))
 					hwClick(hwClickPoint('hb'))
 					await settle(30)
 					hwClick(hwClickPoint('hd'))
@@ -2812,17 +2969,17 @@
 					check('位置对账：新加进来的节点以加入时坐标入账（刚加不算，之后再挪才算）', mvAfterAdd === 0 && mvMovedNew.length === 1 && mvMovedNew[0].id === 'me' && mvMovedNew[0].x === 620, JSON.stringify({ afterAdd: mvAfterAdd, afterMove: mvMovedNew.map(item => item.id) }))
 					check('位置对账：clearMovedPoints 返回实例本身（可以链式调）', mvView.clearMovedPoints('me') === mvView && mvView.clearMovedPoints().getMovedPoints().length === 0, '')
 
-					const mvAdd1 = mvView.addChannel({ from: 'ma', to: 'mb' })
+					const mvAdd1 = mvView.addChannelGroupLines('mch')
 					const mvCh1 = mvChannel('mch')
-					check('addChannel 已有通道：自动方案 newGroup，通道 lineIds 与 groups 一起追加', mvAdd1.ok === true && mvAdd1.resolution?.type === 'newGroup' && mvCh1.lineIds.length === 3 && mvCh1.groups.length === 2 && mvCh1.groups[1].lineIds.length === 1, JSON.stringify({ type: mvAdd1.resolution?.type, lineIds: mvCh1.lineIds, groups: mvCh1.groups.map(group => group.lineIds) }))
-					check('addChannel 已有通道：结果回带更新后的通道 lineIds（channelLineIds 与声明一致）', Array.isArray(mvAdd1.channelLineIds) && mvAdd1.channelLineIds.length === 3 && JSON.stringify(mvAdd1.channelLineIds) === JSON.stringify(mvCh1.lineIds), JSON.stringify(mvAdd1.channelLineIds))
-					const mvAdd2 = mvView.addChannel({ from: 'ma', to: 'mb', channelId: 'mch', groupIndex: 0 })
+					check('addChannelGroupLines 已有通道：新分组，通道 lineIds 与 groups 一起追加', mvAdd1.ok === true && mvAdd1.resolution?.type === 'newGroup' && mvCh1.lineIds.length === 3 && mvCh1.groups.length === 2 && mvCh1.groups[1].lineIds.length === 1, JSON.stringify({ type: mvAdd1.resolution?.type, lineIds: mvCh1.lineIds, groups: mvCh1.groups.map(group => group.lineIds) }))
+					check('addChannelGroupLines 已有通道：结果回带更新后的通道 lineIds（channelLineIds 与声明一致）', Array.isArray(mvAdd1.channelLineIds) && mvAdd1.channelLineIds.length === 3 && JSON.stringify(mvAdd1.channelLineIds) === JSON.stringify(mvCh1.lineIds), JSON.stringify(mvAdd1.channelLineIds))
+					const mvAdd2 = mvView.joinChannelGroupLines('mch', 0)
 					const mvCh2 = mvChannel('mch')
-					check('addChannel 顶层简写：channelId + groupIndex 并进指定分组（通道 lineIds 继续追加）', mvAdd2.ok === true && mvAdd2.resolution?.type === 'joinGroup' && mvAdd2.groupId === mvCh2.groups[0].id && mvCh2.lineIds.length === 4 && mvCh2.groups[0].lineIds.length === 3, JSON.stringify({ type: mvAdd2.resolution?.type, groupId: mvAdd2.groupId, lineIds: mvCh2.lineIds, groups: mvCh2.groups.map(group => group.lineIds) }))
-					const mvAdd3 = mvView.addChannel({ from: 'ma', to: 'mb', channelId: 'nope' })
-					check('addChannel 指定了不在方案里的通道：失败并给出可读原因', mvAdd3.ok === false && typeof mvAdd3.reason === 'string' && mvAdd3.reason.includes('没有可用方案'), JSON.stringify({ ok: mvAdd3.ok, reason: mvAdd3.reason }))
-					const mvAdd4 = mvView.addChannel({ from: 'mb', to: 'mc', channelId: 'mch-x' })
-					check('addChannel 两个节点之间还没有通道：顶层 channelId 仍是新建通道的 id', mvAdd4.ok === true && mvAdd4.channelId === 'mch-x' && Array.isArray(mvAdd4.channelLineIds) && mvAdd4.channelLineIds.length === 1 && mvChannel('mch-x').lineIds.length === 1, JSON.stringify({ ok: mvAdd4.ok, channelId: mvAdd4.channelId, channelLineIds: mvAdd4.channelLineIds }))
+					check('joinChannelGroupLines 按分组序号并进指定分组（通道 lineIds 继续追加）', mvAdd2.ok === true && mvAdd2.resolution?.type === 'joinGroup' && mvAdd2.groupId === mvCh2.groups[0].id && mvCh2.lineIds.length === 4 && mvCh2.groups[0].lineIds.length === 3, JSON.stringify({ type: mvAdd2.resolution?.type, groupId: mvAdd2.groupId, lineIds: mvCh2.lineIds, groups: mvCh2.groups.map(group => group.lineIds) }))
+					const mvAdd3 = mvView.addChannelGroupLines('nope')
+					check('分组方法指定了不存在的通道：失败并给出可读原因', mvAdd3.ok === false && typeof mvAdd3.reason === 'string' && mvAdd3.reason.includes('找不到通道'), JSON.stringify({ ok: mvAdd3.ok, reason: mvAdd3.reason }))
+					const mvAdd4 = mvView.addChannel({ from: 'mb', to: 'mc', id: 'mch-x' })
+					check('addChannel 两个节点之间还没有通道：id 是新建通道的 id', mvAdd4.ok === true && mvAdd4.channelId === 'mch-x' && Array.isArray(mvAdd4.channelLineIds) && mvAdd4.channelLineIds.length === 1 && mvChannel('mch-x').lineIds.length === 1, JSON.stringify({ ok: mvAdd4.ok, channelId: mvAdd4.channelId, channelLineIds: mvAdd4.channelLineIds }))
 					mvView.destroy()
 					mvHost.remove()
 
@@ -3096,8 +3253,8 @@
 					diag('右键回线中段', `世界 ${rcMidWorld.map(value => Number(value).toFixed(2)).join(',')} · 回线折点 ${Array.isArray(rcLine?.path) ? rcLine.path.length : 0}`)
 					await rcRightClick(rcView.project(rcMidWorld[0], rcMidWorld[1]))
 					const rcContext = rcHits[1]?.channelContext
-					check('右键落在回线中段：同一份 onContextMenu 载荷里带 channelContext（组数 / 当前分组 / 可用交互）', rcHits.length === 2 && rcContext?.channelId === 'ch-rc' && rcHits[1]?.lineId === 'rc-1' && rcContext?.groupCount === 1 && (rcContext?.actions ?? []).length > 0, JSON.stringify({ count: rcHits.length, channel: rcContext?.channelId, line: rcHits[1]?.lineId, groups: rcContext?.groupCount }))
-					check('右键通道只发这一条（不再额外发 onChannelContextMenu），线路下标 / id 也在载荷上', rcHits[1]?.type === 'line' && rcHits[1]?.channelId === 'ch-rc' && rcHits[1]?.lineId === 'rc-1' && Number.isInteger(rcHits[1]?.lineIndex) && rcHits[1]?.action?.target === 'channel', JSON.stringify({ count: rcHits.length, type: rcHits[1]?.type, lineIndex: rcHits[1]?.lineIndex, target: rcHits[1]?.action?.target }))
+					check('右键落在回线中段：同一份 onContextMenu 载荷里带 channelContext（组数 / 当前分组 / 可用交互）', rcHits.length === 2 && rcContext?.channelId === 'ch-rc' && rcHits[1]?.item?.id === 'rc-1' && rcContext?.groupCount === 1 && (rcContext?.actions ?? []).length > 0, JSON.stringify({ count: rcHits.length, channel: rcContext?.channelId, line: rcHits[1]?.item?.id, groups: rcContext?.groupCount }))
+					check('右键通道只发这一条（不再额外发 onChannelContextMenu），线路下标读 index、id 读 item.id', rcHits[1]?.type === 'line' && rcHits[1]?.channelId === 'ch-rc' && rcHits[1]?.item?.id === 'rc-1' && Number.isInteger(rcHits[1]?.index) && rcHits[1]?.lineId === undefined && rcHits[1]?.lineIndex === undefined && rcHits[1]?.action?.target === 'channel', JSON.stringify({ count: rcHits.length, type: rcHits[1]?.type, index: rcHits[1]?.index, item: rcHits[1]?.item?.id, target: rcHits[1]?.action?.target }))
 					rcView.destroy()
 					rcHost.remove()
 
@@ -3519,18 +3676,19 @@
 						await settle(60)
 					}
 					await rdClick(rdView.project(0, 0))
-					check('单击载荷：selected true / wasSelected false（点之前没选中）+ selection 读数', rdClicks[0]?.selected === true && rdClicks[0]?.wasSelected === false && rdClicks[0]?.selection?.count === 1 && rdClicks[0]?.selection?.points === 1, JSON.stringify({ selected: rdClicks[0]?.selected, was: rdClicks[0]?.wasSelected, count: rdClicks[0]?.selection?.count }))
+					const rdClickInfo = rdView.getSelectionInfo()
+					check('单击载荷：selected true / wasSelected false（点之前没选中），总读数走 getSelectionInfo()', rdClicks[0]?.selected === true && rdClicks[0]?.wasSelected === false && rdClicks[0]?.selection === undefined && rdClickInfo.count === 1 && rdClickInfo.points === 1, JSON.stringify({ selected: rdClicks[0]?.selected, was: rdClicks[0]?.wasSelected, count: rdClickInfo.count }))
 					await rdClick(rdView.project(0, 0))
-					check('再点已经选中的节点：wasSelected 也是 true（点之前就在选中集里）', rdClicks[1]?.selected === true && rdClicks[1]?.wasSelected === true && rdClicks[1]?.selection?.count === 1, JSON.stringify({ selected: rdClicks[1]?.selected, was: rdClicks[1]?.wasSelected }))
+					check('再点已经选中的节点：wasSelected 也是 true（点之前就在选中集里）', rdClicks[1]?.selected === true && rdClicks[1]?.wasSelected === true && rdClicks[1]?.selection === undefined && rdView.getSelectionInfo().count === 1, JSON.stringify({ selected: rdClicks[1]?.selected, was: rdClicks[1]?.wasSelected }))
 					const rdSelects = []
 					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.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 }))
+					check('右键落在没选中的节点上：selected / wasSelected 都是 false，总读数走 getSelectionInfo()', rdMenus[0]?.type === 'point' && rdMenus[0]?.item?.id === 'rd-c' && rdMenus[0]?.selected === false && rdMenus[0]?.wasSelected === false && rdMenus[0]?.selection === undefined && rdView.getSelectionInfo().count === 2, JSON.stringify({ id: rdMenus[0]?.item?.id, selected: rdMenus[0]?.selected, count: rdView.getSelectionInfo().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 }))
+					check('右键落在已选中的节点上：wasSelected true（据此决定要不要保住整份多选）', rdMenus[1]?.selected === true && rdMenus[1]?.wasSelected === true && rdMenus[1]?.selection === undefined && rdView.getSelectionInfo().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.selectFeatures(['rd-1', 'rd-2'])
@@ -3878,6 +4036,46 @@
 					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：单个 / 一批 / 只居中）
@@ -3982,27 +4180,27 @@
 					const apiCorners = [[0, 0], [400, 40]].map(spot => apiView.project(spot[0], spot[1]))
 					const apiInside = apiCorners.every(spot => spot[0] >= 0 && spot[0] <= apiStats.cssWidth && spot[1] >= 0 && spot[1] <= apiStats.cssHeight)
 					check('focusOn(一批目标, { zoom: true })：整体包围盒居中，三个点都在视口里', Math.abs(apiBatch.center[0] - 200) < 1e-6 && Math.abs(apiBatch.center[1] - 20) < 1e-6 && apiBatch.scale > 0 && apiInside, JSON.stringify({ center: apiBatch.center, corners: apiCorners }))
-					// center: true 是原来 centerOn 的语义：只挪中心，比例一点不动
-					apiView.focusOn(['api-a', 'api-b'], { center: true })
+					// 只挪中心、比例一点不动是 focusOn 的缺省语义
+					apiView.focusOn(['api-a', 'api-b'])
 					const apiCenter1 = apiView.getCamera()
-					check('focusOn(一批, { center: true })：中心挪到这一段的中点，比例一点不动', Math.abs(apiCenter1.center[0] - 100) < 1e-6 && Math.abs(apiCenter1.center[1] - 20) < 1e-6 && apiCenter1.scale === apiBatch.scale, JSON.stringify(apiCenter1.center))
-					apiView.focusOn([400, 0], { center: true })
+					check('focusOn(一批)：中心挪到这一段的中点，比例一点不动', Math.abs(apiCenter1.center[0] - 100) < 1e-6 && Math.abs(apiCenter1.center[1] - 20) < 1e-6 && apiCenter1.scale === apiBatch.scale, JSON.stringify(apiCenter1.center))
+					apiView.focusOn([400, 0])
 					const apiCenter2 = apiView.getCamera().center
-					check('focusOn([x, y], { center: true }) 与 { x, y } 写法都认', Math.abs(apiCenter2[0] - 400) < 1e-6 && Math.abs(apiCenter2[1]) < 1e-6, JSON.stringify(apiCenter2))
-					apiView.focusOn('api-b', { center: true })
+					check('focusOn([x, y]) 与 { x, y } 写法都认', Math.abs(apiCenter2[0] - 400) < 1e-6 && Math.abs(apiCenter2[1]) < 1e-6, JSON.stringify(apiCenter2))
+					apiView.focusOn('api-b')
 					const apiCenter3 = apiView.getCamera().center
-					check('focusOn(id, { center: true })：中心挪到这个要素上', Math.abs(apiCenter3[0] - 200) < 1e-6 && Math.abs(apiCenter3[1] - 40) < 1e-6, JSON.stringify(apiCenter3))
+					check('focusOn(id)：中心挪到这个要素上', Math.abs(apiCenter3[0] - 200) < 1e-6 && Math.abs(apiCenter3[1] - 40) < 1e-6, JSON.stringify(apiCenter3))
 					const apiChannelScale = apiView.getCamera().scale
 					apiView.focusOn({ type: 'channel', channelId: 'api-ch' })
 					const apiChannelCamera = apiView.getCamera()
 					const apiCenter4 = apiChannelCamera.center
 					check('focusOn(通道写法) 缺省只居中，线路 / 通道不再自动放大', Math.abs(apiCenter4[0] - 100) < 5 && Math.abs(apiCenter4[1] - 20) < 5 && apiChannelCamera.scale === apiChannelScale, JSON.stringify({ center: apiCenter4, scale: [apiChannelScale, apiChannelCamera.scale] }))
-					apiView.focusOn('没有这个 id', { center: true })
+					apiView.focusOn('没有这个 id')
 					const apiCenter5 = apiView.getCamera().center
 					check('focusOn：认不出来的目标什么都不做（视角停在原处）', apiCenter5[0] === apiCenter4[0] && apiCenter5[1] === apiCenter4[1], JSON.stringify(apiCenter5))
-					apiView.focusOn({ minX: 0, minY: 0, maxX: 400, maxY: 40 }, { center: true })
+					apiView.focusOn({ minX: 0, minY: 0, maxX: 400, maxY: 40 })
 					const apiCenter6 = apiView.getCamera().center
-					check('focusOn(一段范围, { center: true })：取中心', Math.abs(apiCenter6[0] - 200) < 1e-6 && Math.abs(apiCenter6[1] - 20) < 1e-6, JSON.stringify(apiCenter6))
+					check('focusOn(一段范围)：取中心', Math.abs(apiCenter6[0] - 200) < 1e-6 && Math.abs(apiCenter6[1] - 20) < 1e-6, JSON.stringify(apiCenter6))
 					// select: true：被聚焦的要素同时变成选中状态（与接口选中同一份 state）；mode 决定怎么并进当前选中集
 					const apiBeforeFocusSelect = apiView.getSelectionData().ids.join(',')
 					apiView.focusOn(['api-a', 'api-b', 'api-c'], { select: true, zoom: true, padding: 20 })
@@ -4733,13 +4931,13 @@
 				check('addChannel 新签名：lineIds 自动按线路数组每项的 id 构建', JSON.stringify(nwCh1?.lineIds) === JSON.stringify(['nl1', 'nl2']) && JSON.stringify(nwAdd.lineIds) === JSON.stringify(['nl1', 'nl2']), JSON.stringify(nwCh1?.lineIds))
 				check('addChannel 新签名：线路数组逐条落地（自己的字段保留、from / to 固定两端）', nwLine('nl1')?.color === '#112233' && nwLine('nl1')?.from === 'na' && nwLine('nl1')?.to === 'nb' && nwAdd.circuits === 2, JSON.stringify({ l1: nwLine('nl1'), count: nwAdd.circuits }))
 				check('addChannel 新签名：第三段分组信息写进声明（id / lineIds / path）', nwCh1?.groups?.length === 1 && nwCh1.groups[0].id === 'ng1' && JSON.stringify(nwCh1.groups[0].lineIds) === JSON.stringify(['nl1', 'nl2']) && JSON.stringify(nwCh1.groups[0].path) === JSON.stringify([[0, 30]]), JSON.stringify(nwCh1?.groups))
-				check('addChannel 新签名：落地后新回线整批选中', JSON.stringify(nwView.getSelectionData().ids) === JSON.stringify(['nl1', 'nl2']), JSON.stringify(nwView.getSelectionData().ids))
+				check('addChannel 缺省不改变选中集（select 是显式选项）', nwView.getSelectionData().ids.length === 0, JSON.stringify(nwView.getSelectionData().ids))
 
-				// ② 旧写法继续可用（circuits / resolution 那一套）
+				// ② 旧写法已移除；只写 { from, to } 是新签名，会新建一条回线
 				const nwLegacy = nwView.addChannel({ from: 'nc', to: 'nd', circuits: 2, name: '丙丁' })
-				check('addChannel 旧写法（circuits 那套）继续可用：一次两回', nwLegacy.ok === true && nwLegacy.circuits === 2 && nwView.getOptions().lines.filter(item => item.from === 'nc' && item.to === 'nd').length === 2, JSON.stringify({ ok: nwLegacy.ok, ids: nwLegacy.lineIds }))
+				check('addChannel 旧 circuits 写法已移除：明确失败且不写数据', nwLegacy.ok === false && String(nwLegacy.reason).includes('circuits') && nwView.getOptions().lines.filter(item => item.from === 'nc' && item.to === 'nd').length === 0, JSON.stringify({ ok: nwLegacy.ok, reason: nwLegacy.reason }))
 				const nwBare = nwView.addChannel({ from: 'nc', to: 'nd' })
-				check('只写 { from, to } 的老调用照旧按方案表分流（已有通道 → newGroup，不被新签名当成「只新建」）', nwBare.ok === true && nwBare.resolution?.type === 'newGroup', JSON.stringify({ ok: nwBare.ok, type: nwBare.resolution?.type, reason: nwBare.reason }))
+				check('只写 { from, to }：新建通道并自动建一条回线', nwBare.ok === true && nwBare.resolution?.type === 'newChannel' && nwBare.lineIds.length === 1, JSON.stringify({ ok: nwBare.ok, type: nwBare.resolution?.type, reason: nwBare.reason }))
 
 				// ③ 两个节点之间已有通道：新签名整条失败，plan 里带分组信息（拿来给用户看「已经有几组」）
 				const nwLinesBefore = nwView.getOptions().lines.length
@@ -4748,9 +4946,11 @@
 				check('失败结果里的 plan 带 hasChannel / hasGroup / groups / channel / group', nwBlocked.plan?.hasChannel === true && nwBlocked.plan?.hasGroup === true && nwBlocked.plan.groups.length === 1 && nwBlocked.plan.channel?.id === 'nc1' && nwBlocked.plan.group?.id === 'ng1', JSON.stringify({ hasChannel: nwBlocked.plan?.hasChannel, groups: nwBlocked.plan?.groups?.map(item => item.id) }))
 
 				// ④ 拆出来的两个方法：新加一组 / 并进某一组
-				const nwNewGroup = nwView.addChannelGroupLines('nc1', [{ id: 'nl3', color: '#334455' }], { id: 'ng2' })
+				const nwSelectBefore = nwSelectChanges.length
+				const nwNewGroup = nwView.addChannelGroupLines('nc1', [{ id: 'nl3', color: '#334455' }], { id: 'ng2' }, { select: true })
 				const nwCh1b = nwChannel('nc1')
 				check('addChannelGroupLines：新回线进新分组（成员表一起长）', nwNewGroup.ok === true && nwNewGroup.groupId === 'ng2' && nwNewGroup.resolution?.type === 'newGroup' && JSON.stringify(nwCh1b.lineIds) === JSON.stringify(['nl1', 'nl2', 'nl3']) && nwCh1b.groups.length === 2, JSON.stringify({ ok: nwNewGroup.ok, groupId: nwNewGroup.groupId }))
+				check('addChannelGroupLines({ select: true })：落地后只选中这次的新回线，并只发一次选中变化', nwSelectChanges.length === nwSelectBefore + 1 && JSON.stringify(nwView.getSelectionData().ids) === JSON.stringify(['nl3']), JSON.stringify({ changes: nwSelectChanges.length - nwSelectBefore, ids: nwView.getSelectionData().ids }))
 				const nwJoin = nwView.joinChannelGroupLines('nc1', 'ng1', [{ id: 'nl4' }])
 				check('joinChannelGroupLines：按分组 id 并进某一组', nwJoin.ok === true && nwJoin.groupId === 'ng1' && JSON.stringify(nwChannel('nc1').groups.find(item => item.id === 'ng1').lineIds) === JSON.stringify(['nl1', 'nl2', 'nl4']), JSON.stringify({ groups: nwChannel('nc1')?.groups?.map(item => [item.id, item.lineIds]) }))
 				const nwJoinIndex = nwView.joinChannelGroupLines('nc1', 1, 'nl5')
@@ -4759,8 +4959,10 @@
 				check('通道找不到时拆出来的方法给出 reason、不抛错', nwJoinMiss.ok === false && String(nwJoinMiss.reason).includes('找不到通道'), JSON.stringify({ ok: nwJoinMiss.ok, reason: nwJoinMiss.reason }))
 
 				// ⑤ addChannels 的每一项也认新签名（lineData + group 写在对象上）
-				const nwMany = nwView.addChannels([{ from: 'na', to: 'nc', name: '甲丙', id: 'nc2', lineData: [{ id: 'nl6' }, { id: 'nl7' }], group: { id: 'ng3' } }])
+				const nwBatchSelectBefore = nwSelectChanges.length
+				const nwMany = nwView.addChannels([{ from: 'na', to: 'nc', name: '甲丙', id: 'nc2', lineData: [{ id: 'nl6' }, { id: 'nl7' }], group: { id: 'ng3' } }], { select: true })
 				check('addChannels 的每一项认新签名（lineData + group）', nwMany.ok === true && nwMany.channelIds[0] === 'nc2' && JSON.stringify(nwChannel('nc2')?.lineIds) === JSON.stringify(['nl6', 'nl7']) && nwChannel('nc2')?.groups?.[0]?.id === 'ng3', JSON.stringify({ ok: nwMany.ok, ids: nwMany.channelIds }))
+				check('addChannels({ select: true })：两条回线一次选中，不逐条发选中变化', nwSelectChanges.length === nwBatchSelectBefore + 1 && JSON.stringify(nwView.getSelectionData().ids) === JSON.stringify(['nl6', 'nl7']), JSON.stringify({ changes: nwSelectChanges.length - nwBatchSelectBefore, ids: nwView.getSelectionData().ids }))
 
 				// ⑥ updateChannel 的 group（单数：改一组的信息）/ groups（复数：整份换）
 				nwView.updateChannel('nc1', { group: { id: 'ng1', path: [[7, 8]] } })
@@ -4784,7 +4986,7 @@
 					send('pointerdown', { buttons: 1 })
 					send('pointerup', { buttons: 0 })
 				}
-				const nwSelectBefore = nwView.getSelectionData().ids
+				const nwSelectedBeforeDraft = nwView.getSelectionData().ids
 				nwEvents.length = 0
 				nwSelectChanges.length = 0
 				nwView.beginAddChannel({ select: false })
@@ -4794,7 +4996,7 @@
 				await settle(40)
 				nwClick(nwScreenOf('nb'))
 				await settle(60)
-				check('select 关着：点两个节点不改变选中集（只画两个草稿点）', JSON.stringify(nwView.getSelectionData().ids) === JSON.stringify(nwSelectBefore) && nwSelectChanges.length === 0, JSON.stringify(nwView.getSelectionData().ids))
+				check('select 关着：点两个节点不改变选中集（只画两个草稿点）', JSON.stringify(nwView.getSelectionData().ids) === JSON.stringify(nwSelectedBeforeDraft) && nwSelectChanges.length === 0, JSON.stringify(nwView.getSelectionData().ids))
 				const nwReadyPlain = nwEvents.find(payload => payload.phase === 'ready')
 				check('结束事件（ready）带两个节点与「没有分组」的读数', nwReadyPlain !== undefined && nwReadyPlain.from.id === 'nd' && nwReadyPlain.to.id === 'nb' && nwReadyPlain.finished === true && nwReadyPlain.hasChannel === false && nwReadyPlain.hasGroup === false && nwReadyPlain.groups.length === 0 && nwReadyPlain.group === null && nwReadyPlain.channel === null, JSON.stringify({ from: nwReadyPlain?.from?.id, to: nwReadyPlain?.to?.id, hasGroup: nwReadyPlain?.hasGroup }))
 				check('beginAddChannel 只负责示例路径：ready 之后草稿还在、一条数据都没落', nwView.getAddChannelDraft()?.phase === 'ready' && nwEvents.every(payload => payload.phase !== 'commit'), JSON.stringify({ draft: nwView.getAddChannelDraft()?.phase, phases: nwEvents.map(payload => payload.phase) }))
@@ -4817,6 +5019,7 @@
 				nwDraftMode = 'commit'
 				nwEvents.length = 0
 				const nwLinesBefore2 = nwView.getOptions().lines.length
+				const nwSelectedBeforeInside = nwView.getSelectionData().ids
 				nwView.beginAddChannel()
 				await settle(40)
 				nwClick(nwScreenOf('nd'))
@@ -4824,7 +5027,7 @@
 				nwClick(nwScreenOf('nb'))
 				await settle(80)
 				check('事件里 endAddChannel + addChannel：真实通道与回线落地、假通道不留', nwInside?.ok === true && nwChannel('nc9') !== undefined && nwLine('nl9') !== undefined && nwLine('nl10') !== undefined && nwView.getOptions().lines.length === nwLinesBefore2 + 2, JSON.stringify({ ok: nwInside?.ok, lines: nwView.getOptions().lines.map(item => item.id) }))
-				check('事件里落地之后草稿收掉、新回线选中', nwView.getAddChannelDraft() === null && JSON.stringify(nwView.getSelectionData().ids) === JSON.stringify(['nl9', 'nl10']), JSON.stringify(nwView.getSelectionData().ids))
+				check('事件里落地之后草稿收掉、缺省不改选中集', nwView.getAddChannelDraft() === null && JSON.stringify(nwView.getSelectionData().ids) === JSON.stringify(nwSelectedBeforeInside), JSON.stringify({ before: nwSelectedBeforeInside, after: nwView.getSelectionData().ids }))
 
 				// ⑩ select: true 与结束事件里的分组读数；提前结束用 cancelAddChannel
 				nwDraftMode = null
@@ -4912,6 +5115,53 @@
 					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'
@@ -4938,10 +5188,10 @@
 				check('addLine 不传 id：按 from-to-序号 自动编号（撞车由 uniqueLineId 往后排）',
 					bvAuto.ok === true && String(bvAuto.lineId) === 'bb-bc-0',
 					JSON.stringify({ ok: bvAuto.ok, lineId: bvAuto.lineId }))
-				const bvLegacy = bvView.addChannel({ from: 'ba', to: 'bb', circuits: 2 }, ['bare-4', 'bare-5'])
-				check('旧写法 addChannel 的 lineItems 同样认裸 id：给了两条就按两条建（circuits 忽略）',
-					bvLegacy.ok === true && JSON.stringify(bvLegacy.lineIds.map(String)) === JSON.stringify(['bare-4', 'bare-5']),
-					JSON.stringify({ ok: bvLegacy.ok, lineIds: bvLegacy.lineIds }))
+				const bvChannel = bvView.addChannel({ from: 'ba', to: 'bb' }, ['bare-4', 'bare-5'])
+				check('addChannel 第二段同样认裸 id：给了两条就建两条回线',
+					bvChannel.ok === true && JSON.stringify(bvChannel.lineIds.map(String)) === JSON.stringify(['bare-4', 'bare-5']),
+					JSON.stringify({ ok: bvChannel.ok, lineIds: bvChannel.lineIds }))
 				bvView.destroy()
 				bvHost.remove()
 				// 容器先 display:none（量不出视口）再显示：挂起的那次落位兑现的是「请求那一刻」的范围，中途新加的远处节点不算进来
@@ -4993,7 +5243,96 @@
 					JSON.stringify(dfView.getCamera()))
 				dfView.destroy()
 				dfHost.remove()
-				
+
+				/* 新增接口：选中由 options.select 显式打开；addLine 一步撤销；有通道声明时仍走追加式补线 */
+				const awHost = document.createElement('div')
+				awHost.style.cssText = 'width:520px;height:340px'
+				document.body.appendChild(awHost)
+				const awSelectChanges = []
+				const awView = createGisView(awHost, {
+					points: [
+						{ id: 'aa', x: -180, y: -100 },
+						{ id: 'ab', x: -90, y: -100 },
+						{ id: 'ac', x: 0, y: -100 },
+						{ id: 'ad', x: 90, y: -100 },
+						{ id: 'ae', x: 0, y: 100 },
+						{ id: 'af', x: 180, y: 100 }
+					],
+					lines: [],
+					channels: [],
+					features: { channelDraft: true },
+					history: true,
+					showGrid: false,
+					onSelectChange: event => awSelectChanges.push(event)
+				})
+				await settle(60)
+				const awIds = () => awView.getSelectionData().ids
+				const awLine = id => awView.getOptions().lines.find(item => String(item.id) === String(id))
+				const awInitialChanges = awSelectChanges.length
+				const awPointPlain = awView.addPoint({ id: 'aw-p1', x: 40, y: 30 })
+				check('addPoint 缺省不改变选中集', awPointPlain.ok === true && awIds().length === 0 && awSelectChanges.length === awInitialChanges, JSON.stringify({ ids: awIds(), changes: awSelectChanges.length - awInitialChanges }))
+				const awPointsSelected = awView.addPoints([{ id: 'aw-p2', x: 50, y: 35 }, { id: 'aw-p3', x: 60, y: 40 }], { select: true })
+				check('addPoints({ select: true })：一次选中这批新节点', awPointsSelected.ok === true && JSON.stringify(awIds()) === JSON.stringify(['aw-p2', 'aw-p3']), JSON.stringify(awIds()))
+				awView.selectFeatures(null)
+				const awLinesPlain = awView.addLines([{ id: 'aw-l1', from: 'aa', to: 'ab' }])
+				check('addLines 缺省不改变选中集', awLinesPlain.ok === true && awIds().length === 0, JSON.stringify(awIds()))
+				const awLinesSelected = awView.addLines([{ id: 'aw-l2', from: 'ac', to: 'ad' }, { id: 'aw-l3', from: 'ae', to: 'af' }], { select: true })
+				check('addLines({ select: true })：一次选中这批新线路', awLinesSelected.ok === true && JSON.stringify(awIds()) === JSON.stringify(['aw-l2', 'aw-l3']), JSON.stringify(awIds()))
+				awView.selectFeatures(null)
+				const awLinePlain = awView.addLine({ from: 'aa', to: 'ac', id: 'aw-l4' })
+				check('addLine 缺省不改变选中集', awLinePlain.ok === true && awIds().length === 0, JSON.stringify(awIds()))
+				const awLineSelected = awView.addLine({ from: 'ae', to: 'af', id: 'aw-l5' }, undefined, { select: true })
+				check('addLine({ select: true })：只选中新增回线', awLineSelected.ok === true && JSON.stringify(awIds()) === JSON.stringify(['aw-l5']), JSON.stringify(awIds()))
+				awView.selectFeatures(null)
+				const awChannelPlain = awView.addChannel({ from: 'aa', to: 'ab', id: 'aw-c1' }, ['aw-c1-1'])
+				check('addChannel 缺省不改变选中集', awChannelPlain.ok === true && awIds().length === 0, JSON.stringify(awIds()))
+				const awChannelSelected = awView.addChannel({ from: 'ab', to: 'ad', id: 'aw-c2' }, ['aw-c2-1', 'aw-c2-2'], undefined, { select: true })
+				check('addChannel({ select: true })：只选中这次新建的全部回线', awChannelSelected.ok === true && JSON.stringify(awIds()) === JSON.stringify(['aw-c2-1', 'aw-c2-2']), JSON.stringify(awIds()))
+				const awLineLegacy = awView.addLine({ from: 'ac', to: 'af', circuits: 2 })
+				check('addLine 旧 circuits 入参已移除：明确失败且不写数据', awLineLegacy.ok === false && String(awLineLegacy.reason).includes('circuits') && awLine('ac-af-0') === undefined, JSON.stringify({ ok: awLineLegacy.ok, reason: awLineLegacy.reason }))
+				const awCommitLegacy = awView.commitAddChannel({ lineItems: [{ id: 'aw-old-commit' }] })
+				check('commitAddChannel 旧 lineItems 入参已移除：明确失败且不写数据', awCommitLegacy.ok === false && String(awCommitLegacy.reason).includes('lineItems') && awLine('aw-old-commit') === undefined, JSON.stringify({ ok: awCommitLegacy.ok, reason: awCommitLegacy.reason }))
+				const awChannelGroupsBefore = JSON.stringify(awView.getOptions().channels)
+				const awLineCountBeforeGroups = awView.getOptions().lines.length
+				const awGroupLegacy = awView.addChannelGroups('aw-c2', [{ lineData: [{ id: 'aw-group-new' }], lineItems: [{ id: 'aw-group-old' }] }])
+				check('addChannelGroups 旧 lineItems 入参已移除：整组拒绝、不改数据', awGroupLegacy.ok === false && String(awGroupLegacy.reason).includes('lineItems') && JSON.stringify(awView.getOptions().channels) === awChannelGroupsBefore && awView.getOptions().lines.length === awLineCountBeforeGroups, JSON.stringify({ ok: awGroupLegacy.ok, reason: awGroupLegacy.reason }))
+
+				awView.beginAddChannel({ kind: 'line' })
+				await settle(20)
+				const awDraftKind = awView.getAddChannelDraft()?.kind
+				awView.continueAddChannel({ kind: 'line' })
+				await settle(20)
+				const awContinuedKind = awView.getAddChannelDraft()?.kind
+				awView.cancelAddChannel()
+				awView.beginAddLine({ kind: 'channel' })
+				await settle(20)
+				const awLineDraftKind = awView.getAddChannelDraft()?.kind
+				awView.cancelAddChannel()
+				check('beginAddChannel 固定通道语义：运行时 kind: line 不再切换入口', awDraftKind === 'channel', JSON.stringify({ kind: awDraftKind }))
+				check('continueAddChannel 不切换入口语义：通道草稿传 kind: line 仍是通道', awContinuedKind === 'channel', JSON.stringify({ kind: awContinuedKind }))
+				check('beginAddLine 固定线路语义：运行时 kind: channel 不再切换入口', awLineDraftKind === 'line', JSON.stringify({ kind: awLineDraftKind }))
+
+				const awChannelsBeforeLine = JSON.stringify(awView.getOptions().channels)
+				awView.clearHistory()
+				const awHistoryLine = awView.addLine({ from: 'aa', to: 'af', id: 'aw-history' })
+				await settle(20)
+				const awCenter = awView.project(0, 0)
+				const awHistoryHit = awView.pick(awCenter[0], awCenter[1])
+				const awHistoryState = awView.getHistoryState()
+				const awUndo = awView.undo()
+				await settle(20)
+				const awUndoHit = awView.pick(awCenter[0], awCenter[1])
+				const awChannelsAfterUndo = JSON.stringify(awView.getOptions().channels)
+				check('addLine 有通道声明时仍可落地与拾取，通道成员 / 分组不变', awHistoryLine.ok === true && awHistoryHit?.item?.id === 'aw-history' && awChannelsBeforeLine === JSON.stringify(awView.getOptions().channels), JSON.stringify({ hit: awHistoryHit?.item?.id }))
+				check('addLine 的撤销只记一步：一次 undo 就摘掉这条回线', awHistoryState.undoCount === 1 && awUndo?.type === 'addLine' && awLine('aw-history') === undefined && awUndoHit?.item?.id !== 'aw-history' && awChannelsAfterUndo === awChannelsBeforeLine, JSON.stringify({ before: awHistoryState.undoCount, undo: awUndo, hit: awUndoHit?.item?.id }))
+				const awRedo = awView.redo()
+				await settle(20)
+				const awRemovedLine = awView.removeLine('aw-history')
+				check('addLine 重做后再删除：只摘回线，通道声明保持不变', awRedo?.type === 'addLine' && awRemovedLine.ok === true && awLine('aw-history') === undefined && JSON.stringify(awView.getOptions().channels) === awChannelsBeforeLine, JSON.stringify({ redo: awRedo, removed: awRemovedLine.ok }))
+				check('有通道时 addLine 仍返回独立线路读数（channelId / channelLineIds 为 null）', awHistoryLine.channelId === null && awHistoryLine.channelLineIds === null && awHistoryLine.kind === 'line', JSON.stringify({ channelId: awHistoryLine.channelId, channelLineIds: awHistoryLine.channelLineIds }))
+				awView.destroy()
+				awHost.remove()
+
 				nwHost.remove()
 				/* 这一轮新增：组件方法审计（getPointStyle / updateCopyPoint / setCurrentChannelGroup(null) / options 透传 / getElementBounds / 拐点中间点口径 / minimap.setZoom / off / runChannelAction 认不出的动作） */
 				const auHost = document.createElement('div')
@@ -5475,6 +5814,104 @@
 					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 }))
 
+				/* beginAddLine / beginAddChannel：单一通道阻断、已有通道新分组 / 指定分组、beginAddLine 挂回线 */
+				const bdHost = document.createElement('div')
+				bdHost.style.cssText = 'width:520px;height:320px'
+				document.body.append(bdHost)
+				const bdEvents = []
+				const bdView = createGisView(bdHost, {
+					points: [
+						{ id: 'bda', x: 0, y: 0, name: 'A' },
+						{ id: 'bdb', x: 80, y: 0, name: 'B' },
+						{ id: 'bdc', x: 0, y: 70, name: 'C' }
+					],
+					lines: [],
+					fitPadding: 60,
+					showGrid: false,
+					features: { channelDraft: true },
+					onChannelDraft: payload => bdEvents.push(payload)
+				})
+				await settle(120)
+				const bdSeed = bdView.addChannel({ id: 'bd-ch', name: '已有通道', from: 'bda', to: 'bdb' }, [
+					{ id: 'bd-l1' },
+					{ id: 'bd-l2' }
+				], [
+					{ id: 'bd-g1', lineIds: ['bd-l1'] },
+					{ id: 'bd-g2', lineIds: ['bd-l2'] }
+				])
+				check('beginAddChannel 前置：已有通道带两个命名分组，供 singleChannel / newGroup / joinGroup 测试', bdSeed.ok === true && bdView.getChannelGroups('bd-ch').length === 2, JSON.stringify({ ok: bdSeed.ok, groups: bdView.getChannelGroups('bd-ch').map(group => group.id) }))
+				const bdCanvas = bdView.canvas
+				const bdClick = async (id) => {
+					const point = bdView.getData().points.find(item => item.id === id)
+					const screen = bdView.project(point.x, point.y)
+					const rect = bdCanvas.getBoundingClientRect()
+					for (const type of ['pointerdown', 'pointerup']) {
+						bdCanvas.dispatchEvent(new PointerEvent(type, {
+							bubbles: true,
+							cancelable: true,
+							composed: true,
+							pointerId: 31,
+							pointerType: 'mouse',
+							isPrimary: true,
+							button: 0,
+							clientX: rect.left + screen[0],
+							clientY: rect.top + screen[1]
+						}))
+					}
+					await settle(50)
+				}
+
+				bdView.beginAddLine({ from: 'bda', singleChannel: true })
+				const bdLineStart = bdView.getAddChannelDraft()
+				await bdClick('bdb')
+				const bdLineReady = bdView.getAddChannelDraft()
+				const bdLineBefore = bdView.getData().lines.length
+				const bdLineResult = bdView.commitAddChannel()
+				check('beginAddLine 不把 singleChannel 当成挂通道开关：两端已有通道仍出独立线路草稿', bdLineStart?.kind === 'line' && bdLineStart.singleChannel === false && bdLineStart.existingChannel === null && bdLineReady?.blocked === false, JSON.stringify({ kind: bdLineStart?.kind, single: bdLineStart?.singleChannel, existing: bdLineStart?.existingChannel, readyBlocked: bdLineReady?.blocked }))
+				check('beginAddLine 提交后只加独立线路，不碰已有通道', bdLineResult.ok === true && bdLineResult.kind === 'line' && bdView.getData().lines.length === bdLineBefore + 1 && bdView.getChannelGroups('bd-ch').length === 2, JSON.stringify({ kind: bdLineResult.kind, channelId: bdLineResult.channelId, groups: bdView.getChannelGroups('bd-ch').length }))
+
+				bdEvents.length = 0
+				const bdBlockLines = bdView.getData().lines.length
+				bdView.beginAddChannel({ from: 'bda', singleChannel: true })
+				await bdClick('bdb')
+				const bdBlockDraft = bdView.getAddChannelDraft()
+				const bdBlockResult = bdView.commitAddChannel()
+				const bdBlockEvent = bdEvents.find(payload => payload.phase === 'blocked')
+				check('singleChannel：两端已有通道时 ready 直接 blocked，并给出 singleChannel 原因', bdBlockDraft?.blocked === true && bdBlockDraft.existingChannel === 'block' && /singleChannel/.test(bdBlockDraft.reason ?? ''), JSON.stringify({ blocked: bdBlockDraft?.blocked, existing: bdBlockDraft?.existingChannel, reason: bdBlockDraft?.reason }))
+				check('singleChannel：隐式提交发 blocked 事件且不改数据，事件仍报 channel / 当前电路数', bdBlockResult.ok === false && bdBlockEvent?.kind === 'channel' && bdBlockEvent?.singleChannel === true && bdView.getData().lines.length === bdBlockLines, JSON.stringify({ result: bdBlockResult.ok, event: bdBlockEvent?.phase, kind: bdBlockEvent?.kind, lines: bdView.getData().lines.length }))
+
+				bdEvents.length = 0
+				bdView.beginAddChannel({ from: 'bda', singleChannel: true, existingChannel: 'newGroup' })
+				await bdClick('bdb')
+				const bdNewGroupDraft = bdView.getAddChannelDraft()
+				const bdNewGroupResult = bdView.commitAddChannel()
+				check('existingChannel: newGroup 覆盖 singleChannel：已有通道新加一组回线', bdNewGroupDraft?.blocked === false && bdNewGroupDraft.preferred === 'newGroup' && bdNewGroupResult.ok === true && bdNewGroupResult.channelId === 'bd-ch' && bdView.getChannelGroups('bd-ch').length === 3, JSON.stringify({ preferred: bdNewGroupDraft?.preferred, ok: bdNewGroupResult.ok, groupId: bdNewGroupResult.groupId, groups: bdView.getChannelGroups('bd-ch').length }))
+
+				bdEvents.length = 0
+				bdView.beginAddChannel({ from: 'bda', existingChannel: 'joinGroup', groupId: 'bd-g1' })
+				await bdClick('bdb')
+				const bdJoinDraft = bdView.getAddChannelDraft()
+				const bdJoinBefore = bdView.getChannelGroups('bd-ch').find(group => group.id === 'bd-g1')?.lineIndexes.length ?? 0
+				const bdJoinResult = bdView.commitAddChannel()
+				const bdJoinAfter = bdView.getChannelGroups('bd-ch').find(group => group.id === 'bd-g1')?.lineIndexes.length ?? 0
+				check('existingChannel: joinGroup + groupId：新回线落进指定分组，读数带回 targetGroupId', bdJoinDraft?.targetGroupId === 'bd-g1' && bdJoinResult.ok === true && bdJoinResult.groupId === 'bd-g1' && bdJoinAfter === bdJoinBefore + 1, JSON.stringify({ draftTarget: bdJoinDraft?.targetGroupId, groupId: bdJoinResult.groupId, before: bdJoinBefore, after: bdJoinAfter }))
+
+				bdEvents.length = 0
+				bdView.beginAddLine({ from: 'bda', existingChannel: 'joinGroup', groupId: 'bd-g2' })
+				await bdClick('bdb')
+				const bdAttachDraft = bdView.getAddChannelDraft()
+				const bdAttachChannels = bdView.getOptions().channels.length
+				const bdAttachResult = bdView.commitAddChannel()
+				check('beginAddLine + existingChannel: joinGroup：线路入口也能把新回线挂进已有分组（不新建通道）', bdAttachDraft?.kind === 'line' && bdAttachDraft.existingChannel === 'joinGroup' && bdAttachDraft.targetGroupId === 'bd-g2' && bdAttachResult.ok === true && bdAttachResult.kind === 'channel' && bdAttachResult.groupId === 'bd-g2' && bdView.getOptions().channels.length === bdAttachChannels, JSON.stringify({ draftKind: bdAttachDraft?.kind, target: bdAttachDraft?.targetGroupId, resultKind: bdAttachResult.kind, groupId: bdAttachResult.groupId, channels: bdView.getOptions().channels.length }))
+
+				bdView.beginAddChannel({ from: 'bda', existingChannel: 'auto' })
+				await bdClick('bdb')
+				const bdAutoDraft = bdView.getAddChannelDraft()
+				check('existingChannel: auto：有组余量时优先推荐新分组', bdAutoDraft?.blocked === false && bdAutoDraft.preferred === 'newGroup' && bdAutoDraft.existingChannel === 'auto', JSON.stringify({ preferred: bdAutoDraft?.preferred, existing: bdAutoDraft?.existingChannel }))
+				bdView.cancelAddChannel()
+				bdView.destroy()
+				bdHost.remove()
+
 				/* 隐藏 / 显示、节点拆分、通道变化对账：接口级自测 */
 				const splitHost = document.createElement('div')
 				splitHost.style.cssText = 'width:640px;height:380px'
@@ -5591,6 +6028,109 @@
 				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 }))
+				const autoSplitHost = document.createElement('div')
+				autoSplitHost.style.cssText = 'width:480px;height:280px'
+				document.body.append(autoSplitHost)
+				const autoSplitView = createGisView(autoSplitHost, {
+					points: [
+						{ id: 'as-hub', x: 0, y: 0 },
+						{ id: 'as-a', x: 8, y: 0 },
+						{ id: 'as-b', x: 0, y: 8 }
+					],
+					lines: [
+						{ id: 'as-c1', from: 'as-hub', to: 'as-a' },
+						{ id: 'as-c2', from: 'as-hub', to: 'as-a' },
+						{ id: 'as-i1', from: 'as-hub', to: 'as-b' },
+						{ id: 'as-i2', from: 'as-hub', to: 'as-b' },
+						{ id: 'as-i3', from: 'as-hub', to: 'as-a' }
+					],
+					channels: [{ id: 'as-ch', from: 'as-hub', to: 'as-a', lineIds: ['as-c1', 'as-c2'] }],
+					showGrid: false
+				})
+				const autoSplit = autoSplitView.splitPoint('as-hub', [
+					{ x: -1, y: 0, name: '解除 A' },
+					{ x: 1, y: 0, name: '解除 B' }
+				], { autoLines: 'alternate' })
+				const autoAssignSlot = id => autoSplit.lineAssignments.find(assignment => assignment.lineIds.includes(id))?.index
+				const autoChannelSlotA = autoAssignSlot('as-c1')
+				const autoChannelSlotB = autoAssignSlot('as-c2')
+				const autoSplitChannel = autoSplitView.getOptions().channels.find(channel => channel.id === 'as-ch')
+				const autoSplitNewPoint = autoSplit.pointIds[1]
+				check('splitPoint({ autoLines: alternate })：按通道成组轮流分配，两条同通道回线不会拆到不同节点', autoSplit.ok === true && autoSplit.autoLines === 'alternate' && autoSplit.autoAssignedLines === 5 && autoChannelSlotA !== undefined && autoChannelSlotA === autoChannelSlotB, JSON.stringify({ autoLines: autoSplit.autoLines, assigned: autoSplit.autoAssignedLines, slots: [autoChannelSlotA, autoChannelSlotB], assignments: autoSplit.lineAssignments.map(item => `${item.index}:${item.lineIds.join('+')}`) }))
+				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()