gis-view-webgl2 0.1.7 → 0.1.8

package/docs/steps/selftest-features.html

@@ -2264,7 +2264,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 +2277,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 }))
 
@@ -2657,7 +2660,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 +2704,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 +2751,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 +2819,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 +3103,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 +3526,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'])
@@ -3982,27 +3990,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 +4741,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 +4756,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 +4769,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 +4796,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 +4806,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 +4829,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 +4837,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
@@ -4938,10 +4951,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 +5006,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 +5577,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 +5791,38 @@
 				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()
 				lineOnlyView.destroy()
 				lineOnlyHost.remove()
 				splitView.destroy()

package/docs/steps/selftest-full.html

@@ -42,9 +42,9 @@
 					onClick: payload => push('click', payload),
 					onDblClick: payload => push('dblclick', payload),
 					onSelect: payload => push('select', payload),
-					onPointerDown: (payload, event) => push('down', payload),
-					onPointerUp: (payload, event) => push('up', payload),
-					onContextMenu: (payload, event) => push('contextmenu', payload),
+					onPointerDown: payload => push('down', payload),
+					onPointerUp: payload => push('up', payload),
+					onContextMenu: payload => push('contextmenu', payload),
 					onChannelDraft: payload => push('draft', payload),
 					onChannelDraftClick: payload => push('draftclick', payload)
 				})

package/docs/steps/selftest-labels.html

@@ -536,7 +536,7 @@
 					const labelMenuEvent = new MouseEvent('contextmenu', { bubbles: true, cancelable: true, button: 2, clientX: menuRect.left + 4, clientY: menuRect.top + 4 })
 					firstMenu.dispatchEvent(labelMenuEvent)
 					const menuPayload = menuPayloads[menuPayloads.length - 1]
-					check('右键标签发 labelContextMenu：哪一条 / 内容 / 挂在谁 / 指针位置都在，系统菜单被拦下', menuPayload?.labelId === 'default' && menuPayload?.label?.content === '右键站' && menuPayload?.parent?.id === 'm1' && Math.abs(menuPayload.clientX - (menuRect.left + 4)) < 0.01 && labelMenuEvent.defaultPrevented === true, JSON.stringify({ labelId: menuPayload?.labelId, content: menuPayload?.label?.content, parent: menuPayload?.parent?.id, x: menuPayload?.clientX, prevented: labelMenuEvent.defaultPrevented }))
+					check('右键标签发 labelContextMenu：哪一条 / 内容 / 挂在谁 / 指针位置都在，系统菜单被拦下', menuPayload?.labelId === 'default' && menuPayload?.label?.content === '右键站' && menuPayload?.parent?.id === 'm1' && Math.abs(menuPayload.originalEvent.clientX - (menuRect.left + 4)) < 0.01 && menuPayload.clientX === undefined && labelMenuEvent.defaultPrevented === true, JSON.stringify({ labelId: menuPayload?.labelId, content: menuPayload?.label?.content, parent: menuPayload?.parent?.id, x: menuPayload?.originalEvent?.clientX, prevented: labelMenuEvent.defaultPrevented }))
 					check('右键载荷里的 state 与偏移读数和点选同一套', menuPayload?.state === null && Array.isArray(menuPayload?.offset) && menuPayload.offset[0] === 0 && menuPayload.offset[1] === 0, JSON.stringify({ state: menuPayload?.state, offset: menuPayload?.offset }))
 				}
 				menuView.updateOptions({ preventContextMenu: false })