gis-view-webgl2 0.1.7 → 0.1.9

package/docs/steps/selftest-demos.html

@@ -268,6 +268,92 @@
 					check(`「${spec.tab}」把演示 id 写进地址栏（?demo=${spec.id}）`, location.search.includes(`demo=${spec.id}`), location.search)
 				}
 
+				// 2.0.1 基础视图：比例读写与空闲检测都能从面板操作并回读
+				if (await clickTab('基础视图')) {
+					const ready = await canvasReady()
+					await wait(300)
+					const demo = document.querySelector('.dv-demo')
+					const setup = demo?.__vueParentComponent?.setupState
+					const view = await until(() => setup?.view, 8000)
+					const canvas = demo?.querySelector('canvas.gis-view__canvas') ?? demo?.querySelector('canvas')
+					const scaleInput = document.querySelector('[data-demo=basic-scale-input]')
+					const scaleSet = document.querySelector('[data-demo=basic-scale-set]')
+					const scaleGet = document.querySelector('[data-demo=basic-scale-get]')
+					const scaleRead = document.querySelector('[data-demo=basic-scale-read]')
+					const idleToggle = document.querySelector('[data-demo=basic-idle-toggle]')
+					const idleRead = document.querySelector('[data-demo=basic-idle-read]')
+					check('基础视图：比例与空闲面板控件齐全',
+						Boolean(ready && view && canvas && scaleInput && scaleSet && scaleGet && scaleRead && idleToggle && idleRead),
+						`${ready ? 'canvas 就绪' : '没有 canvas'} / view=${Boolean(view)} / 比例 ${[scaleInput, scaleSet, scaleGet, scaleRead].filter(Boolean).length}/4 / 空闲 ${[idleToggle, idleRead].filter(Boolean).length}/2`)
+					if (ready && view && canvas && scaleInput && scaleSet && scaleGet && scaleRead && idleToggle && idleRead) {
+						const targetScale = 96
+						scaleInput.value = String(targetScale)
+						scaleInput.dispatchEvent(new Event('input', { bubbles: true }))
+						scaleSet.click()
+						await wait(120)
+						check('基础视图：setScale() 改到输入值，getScale() 与面板读数同步',
+							Math.abs(view.getScale() - targetScale) < 0.01 && scaleRead.textContent.includes(targetScale.toFixed(2)),
+							`getScale=${view.getScale()} / 面板 ${scaleRead.textContent.trim()}`)
+						scaleGet.click()
+						await wait(80)
+						check('基础视图：getScale() 按钮把读到的值写回输入与事件读数',
+							Math.abs(Number(scaleInput.value) - view.getScale()) < 0.01 && setup.readouts.event.includes('getScale()'),
+							`input=${scaleInput.value} / 事件 ${setup.readouts.event}`)
+
+						const pointerMove = () => {
+							const rect = canvas.getBoundingClientRect()
+							canvas.dispatchEvent(new PointerEvent('pointermove', {
+								bubbles: true,
+								cancelable: true,
+								composed: true,
+								pointerId: 1,
+								pointerType: 'mouse',
+								isPrimary: true,
+								clientX: rect.left + 12,
+								clientY: rect.top + 12
+							}))
+						}
+						pointerMove()
+						await wait(280)
+						const idleBeforeScale = view.getIdleTime()
+						const scaleBeforeProgrammatic = view.getScale()
+						view.setScale(scaleBeforeProgrammatic * 1.1)
+						await wait(100)
+						check('基础视图：程序化 setScale() 不重置空闲计时',
+							idleBeforeScale > 200 && view.getIdleTime() >= idleBeforeScale,
+							`${idleBeforeScale.toFixed(0)} ms → ${view.getIdleTime().toFixed(0)} ms`)
+
+						pointerMove()
+						await wait(40)
+						const idleAfterActivity = view.getIdleTime()
+						check('基础视图：真实 pointermove 后 getIdleTime() 归到阈值以内',
+							idleAfterActivity < 300,
+							`${idleAfterActivity.toFixed(0)} ms`)
+
+						const idleCallbacksBefore = setup.idleCallbackCount
+						const idleEventsBefore = setup.idleEventCount
+						await wait(1500)
+						await wait(250)
+						check('基础视图：停手超过 idleTimeout 后 onIdle 与 idle 各触发一次，读数同步刷新',
+							setup.idleCallbackCount === idleCallbacksBefore + 1 &&
+							setup.idleEventCount === idleEventsBefore + 1 &&
+							view.getIdleTime() > 1200 &&
+							idleRead.textContent.includes(`onIdle：${setup.idleCallbackCount} 次`) &&
+							idleRead.textContent.includes(`idle 事件：${setup.idleEventCount} 次`),
+							`onIdle ${idleCallbacksBefore}→${setup.idleCallbackCount} / idle ${idleEventsBefore}→${setup.idleEventCount} / idleTime ${view.getIdleTime().toFixed(0)} ms`)
+						await wait(400)
+						check('基础视图：同一空闲段不会重复触发 onIdle / idle',
+							setup.idleCallbackCount === idleCallbacksBefore + 1 && setup.idleEventCount === idleEventsBefore + 1,
+							`onIdle ${setup.idleCallbackCount} 次 / idle ${setup.idleEventCount} 次`)
+						if (!idleToggle.checked) {
+							idleToggle.click()
+						}
+					}
+				}
+				else {
+					check('基础视图：页签在', false, '没找到「基础视图」页签')
+				}
+
 				// 2.0 点聚合：控件齐全、聚合圆点击只发 clusterClick，maxZoom 展开后又回来
 				if (await clickTab('点聚合')) {
 					const ready = await canvasReady()
@@ -559,6 +645,85 @@
 						const afterObjectChannel = view.getData()
 						const objectChannel = channelList().at(-1)
 						check('可视化连线：commitAddChannel 直接传通道对象即可按 lineIds / groups 落地', Boolean(objectChannelDraft) && channelList().length === 2 && afterObjectChannel.lines.length === beforeObjectChannel.lines.length + 2 && String(objectChannel?.id).startsWith('connect-object-channel-') && objectChannel?.lineIds?.length === 2 && objectChannel.lineIds.every(id => String(id).startsWith('connect-object-line-')), `${channelList().length} 通道 / ${beforeObjectChannel.lines.length} -> ${afterObjectChannel.lines.length} 线 / ${objectChannel?.id ?? '无'} / ${JSON.stringify(objectChannel?.lineIds ?? [])}`)
+
+						// 单一通道 / 已有分组：预置一条 node-0 ↔ node-1 的通道，再分别验证阻断、新分组、指定分组与 beginAddLine 挂回线
+						document.querySelector('[data-demo=connect-seed-existing]').click()
+						const seededExisting = await until(() => view.getChannelGroups('connect-existing-channel').length === 2, 3000)
+						check('可视化连线：预置已有通道带两个分组，面板读数同步', Boolean(seededExisting) && channelList().length === 3 && text('connect-existing-readout').includes('已有通道'), `${channelList().length} 通道 / ${text('connect-existing-readout')}`)
+						const singleChannelInput = document.querySelector('[data-demo=connect-single-channel]')
+						const existingModeSelect = document.querySelector('[data-demo=connect-existing-mode]')
+						const groupTargetSelect = document.querySelector('[data-demo=connect-group-target]')
+						const setExistingMode = async value => {
+							existingModeSelect.value = value
+							existingModeSelect.dispatchEvent(new Event('change', { bubbles: true }))
+							await wait(60)
+						}
+						const beginPresetPair = async () => {
+							startPointSelect.value = 'node-0'
+							startPointSelect.dispatchEvent(new Event('change', { bubbles: true }))
+							await wait(50)
+							document.querySelector('[data-demo=connect-start]').click()
+							await wait(70)
+							await clickNode('node-1')
+							return until(() => {
+								const current = view.getAddChannelDraft()
+								return current?.phase === 'ready' ? current : null
+							}, 2500)
+						}
+						await setExistingMode('none')
+						if (!singleChannelInput.checked) singleChannelInput.click()
+						await wait(50)
+						const blockedLinesBefore = view.getData().lines.length
+						const blockedDraft = await beginPresetPair()
+						document.querySelector('[data-demo=connect-default]').click()
+						const blockedEventReady = await until(() => text('connect-event-readout').includes('phase=blocked'), 2500)
+						check('可视化连线：singleChannel + 已有通道触发 ready blocked 与提交失败事件', Boolean(blockedDraft) && blockedDraft.blocked === true && blockedDraft.existingChannel === 'block' && Boolean(blockedEventReady) && text('connect-event-readout').includes('singleChannel=true') && text('connect-action-readout').includes('blocked'), `${text('connect-event-readout')} / ${view.getData().lines.length} 线`)
+						check('可视化连线：阻断失败不改线路 / 通道数据', view.getData().lines.length === blockedLinesBefore && channelList().length === 3, `${blockedLinesBefore} → ${view.getData().lines.length} 线 / ${channelList().length} 通道`)
+
+						await setExistingMode('newGroup')
+						const groupsBeforeNew = view.getChannelGroups('connect-existing-channel').length
+						const newGroupLinesBefore = view.getData().lines.length
+						const newGroupDraft = await beginPresetPair()
+						const newGroupCommitReady = newGroupDraft?.preferred === 'newGroup' && newGroupDraft?.blocked === false
+						document.querySelector('[data-demo=connect-default]').click()
+						await wait(160)
+						check('可视化连线：existingChannel: newGroup 把 2 回新线作为新分组加入已有通道', Boolean(newGroupCommitReady) && view.getChannelGroups('connect-existing-channel').length === groupsBeforeNew + 1 && view.getData().lines.length === newGroupLinesBefore + 2 && channelList().length === 3, `${groupsBeforeNew} → ${view.getChannelGroups('connect-existing-channel').length} 组 / ${newGroupLinesBefore} → ${view.getData().lines.length} 线 / ${text('connect-action-readout')}`)
+
+						await setExistingMode('joinGroup')
+						groupTargetSelect.value = 'connect-existing-group-b'
+						groupTargetSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(50)
+						const joinGroupBefore = view.getChannelGroups('connect-existing-channel').find(group => group.id === 'connect-existing-group-b')?.lineIds.length ?? 0
+						const joinGroupChannelsBefore = channelList().length
+						const joinGroupDraft = await beginPresetPair()
+						const joinGroupCommitReady = joinGroupDraft?.targetGroupId === 'connect-existing-group-b'
+						document.querySelector('[data-demo=connect-default]').click()
+						await wait(160)
+						const joinGroupAfter = view.getChannelGroups('connect-existing-channel').find(group => group.id === 'connect-existing-group-b')?.lineIds.length ?? 0
+						check('可视化连线：existingChannel: joinGroup + groupId 把 2 回新线并入指定分组', Boolean(joinGroupCommitReady) && joinGroupAfter === joinGroupBefore + 2 && channelList().length === joinGroupChannelsBefore, `group-b ${joinGroupBefore} → ${joinGroupAfter} 回 / ${channelList().length} 通道 / ${text('connect-action-readout')}`)
+
+						kindSelect.value = 'line'
+						kindSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(60)
+						groupTargetSelect.value = 'connect-existing-group-a'
+						groupTargetSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						await wait(50)
+						const attachGroupBefore = view.getChannelGroups('connect-existing-channel').find(group => group.id === 'connect-existing-group-a')?.lineIds.length ?? 0
+						const attachChannelsBefore = channelList().length
+						const attachDraft = await beginPresetPair()
+						const attachDraftReady = attachDraft?.kind === 'line' && attachDraft?.existingChannel === 'joinGroup' && attachDraft?.targetGroupId === 'connect-existing-group-a'
+						document.querySelector('[data-demo=connect-default]').click()
+						await wait(160)
+						const attachGroupAfter = view.getChannelGroups('connect-existing-channel').find(group => group.id === 'connect-existing-group-a')?.lineIds.length ?? 0
+						check('可视化连线：beginAddLine + existingChannel: joinGroup 也能把新回线挂进指定分组，不新建通道', Boolean(attachDraftReady) && attachGroupAfter === attachGroupBefore + 1 && channelList().length === attachChannelsBefore && text('connect-log').includes('beginAddLine'), `${text('connect-log')} / group-a ${attachGroupBefore} → ${attachGroupAfter} 回`)
+
+						kindSelect.value = 'channel-2'
+						kindSelect.dispatchEvent(new Event('change', { bubbles: true }))
+						await setExistingMode('auto')
+						const autoDraft = await beginPresetPair()
+						check('可视化连线：existingChannel: auto 在分组有余量时推荐新分组', autoDraft?.blocked === false && autoDraft?.preferred === 'newGroup' && autoDraft?.existingChannel === 'auto', JSON.stringify({ preferred: autoDraft?.preferred, blocked: autoDraft?.blocked }))
+						view.cancelAddChannel()
+						await wait(60)
 						check('可视化连线：读数面板同步报出纯点 + 线 / 通道数量', text('connect-data-readout').includes('节点') && text('connect-data-readout').includes('通道'), text('connect-data-readout'))
 					}
 					else {
@@ -931,7 +1096,7 @@
 					const click = key => document.querySelector(`[data-demo="${key}"]`)?.click()
 					const text = key => document.querySelector(`[data-demo="${key}"]`)?.textContent.trim() ?? ''
 					if (ready && view) {
-						const groupsOf = () => view.getChannels().length
+						const groupsOf = () => (view.getOptions().channels ?? []).reduce((sum, channel) => sum + view.getChannelGroups(channel.id).length, 0)
 						const lineIndex = view.getData().lines.findIndex(line => String(line.id) === 'line-0')
 						const waypointCount = () => view.getWaypoints(lineIndex).length
 						const pointsBefore = view.getData().points.length
@@ -950,11 +1115,49 @@
 						click('batch-add-channel-groups')
 						const groupsAfter = await until(() => groupsOf() === groupsBefore + 2, 6000)
 						check('批量新增：addChannelGroups 一次补 2 组、4 条回线', Boolean(groupsAfter) && text('batch-add-readout').includes('2 组 / 4 条回线'), `${groupsBefore} → ${groupsOf()} / ${text('batch-add-readout')}`)
-						const waypointsBefore = waypointCount()
-						click('batch-add-waypoints')
-						const waypointsAfter = await until(() => waypointCount() > waypointsBefore, 6000)
-						check('批量新增：addWaypoints 一次插多个拐点且不虚报失败坐标', Boolean(waypointsAfter) && text('batch-add-readout').includes('addWaypoints') && !text('batch-add-readout').includes('没有落地'), `${waypointsBefore} → ${waypointCount()} / ${text('batch-add-readout')}`)
-					}
+						const waypointsBefore = waypointCount()
+						click('batch-add-waypoints')
+						const waypointsAfter = await until(() => waypointCount() > waypointsBefore, 6000)
+						check('批量新增：addWaypoints 一次插多个拐点且不虚报失败坐标', Boolean(waypointsAfter) && text('batch-add-readout').includes('addWaypoints') && !text('batch-add-readout').includes('没有落地'), `${waypointsBefore} → ${waypointCount()} / ${text('batch-add-readout')}`)
+						const updatePointBefore = view.getData().points.find(point => String(point.id).startsWith('batch-point-'))
+						const updateLineBefore = view.getData().lines.find(line => String(line.id).startsWith('batch-line-'))
+						click('batch-update-all')
+						const batchUpdated = await until(() => {
+							const point = view.getData().points.find(item => String(item.id).startsWith('batch-point-') && item.batch_updated !== undefined)
+							const line = view.getData().lines.find(item => String(item.id).startsWith('batch-line-') && item.batch_updated !== undefined)
+							const channel = (view.getOptions().channels ?? []).find(item => item.batch_updated !== undefined)
+							return point && line && channel ? { point, line, channel } : null
+						}, 6000)
+						check('批量新增：batch 包住 patchPoints / patchLines / updateChannel，一次改三类数据', Boolean(batchUpdated) && text('batch-add-readout').includes('batch(update)') && text('batch-add-readout').includes('三种 patch 合并为一步历史') && batchUpdated.point.zone_name?.startsWith('批量修改') && batchUpdated.line.color === '#2f6fd0' && Number(batchUpdated.channel.width) >= 2.4, text('batch-add-readout'))
+						view.undo()
+						const batchUpdateUndone = await until(() => {
+							const point = view.getData().points.find(item => item.id === updatePointBefore?.id)
+							const line = view.getData().lines.find(item => item.id === updateLineBefore?.id)
+							const channel = (view.getOptions().channels ?? []).find(item => item.batch_updated !== undefined)
+							return point && point.batch_updated === undefined && line && line.batch_updated === undefined && !channel
+						}, 5000)
+						check('批量新增：三类 patch 只占一步历史，撤销一次整批恢复', Boolean(batchUpdateUndone), `节点 ${updatePointBefore?.id ?? '—'} / 线路 ${updateLineBefore?.id ?? '—'}`)
+						const deletePoint = view.getData().points.find(point => String(point.id).startsWith('batch-point-'))
+						const deleteChannel = (view.getOptions().channels ?? []).find(channel => String(channel.id).startsWith('batch-channel-'))
+						const deleteBefore = { points: view.getData().points.length, lines: view.getData().lines.length, channels: view.getOptions().channels?.length ?? 0 }
+						click('batch-delete-all')
+						const batchDeleted = await until(() => {
+							const after = view.getData()
+							return after.points.length < deleteBefore.points && after.lines.length < deleteBefore.lines && (view.getOptions().channels?.length ?? 0) < deleteBefore.channels ? after : null
+						}, 6000)
+						check('批量新增：batch 内 removeChannel / removePoints / removeLines 一次删三类数据', Boolean(batchDeleted) && text('batch-add-readout').includes('batch(delete)') && text('batch-add-readout').includes('整批只记一步'), `${deleteBefore.points}/${deleteBefore.lines}/${deleteBefore.channels} → ${view.getData().points.length}/${view.getData().lines.length}/${view.getOptions().channels?.length ?? 0} · ${text('batch-add-readout')}`)
+						view.undo()
+						const batchDeleteUndone = await until(() => view.getData().points.length === deleteBefore.points && view.getData().lines.length === deleteBefore.lines && (view.getOptions().channels?.length ?? 0) === deleteBefore.channels, 5000)
+						check('批量新增：删除批同样只占一步历史，撤销后三类数据一起回来', Boolean(batchDeleteUndone) && view.getData().points.some(point => point.id === deletePoint?.id) && (view.getOptions().channels ?? []).some(channel => channel.id === deleteChannel?.id), `${view.getData().points.length}/${view.getData().lines.length}/${view.getOptions().channels?.length ?? 0}`)
+						const groupsBeforeBatchSplit = view.getChannels().length
+						click('batch-group-split')
+						const batchSplit = await until(() => view.getChannels().length > groupsBeforeBatchSplit && text('batch-add-readout').includes('batch(splitChannelGroups)'), 6000)
+						check('批量新增：batch 内逐条 splitChannelGroups，多条通道分组一次重排', Boolean(batchSplit) && text('batch-add-readout').includes('整批一步历史'), `${groupsBeforeBatchSplit} → ${view.getChannels().length} · ${text('batch-add-readout')}`)
+						const groupsBeforeBatchRemove = view.getChannels().length
+						click('batch-group-remove')
+						const batchGroupRemoved = await until(() => view.getChannels().length < groupsBeforeBatchRemove && text('batch-add-readout').includes('batch(removeChannelGroup)'), 6000)
+						check('批量新增：batch 内逐条 removeChannelGroup，回线并回相邻组且数据不丢', Boolean(batchGroupRemoved) && text('batch-add-readout').includes('回线数据未丢'), `${groupsBeforeBatchRemove} → ${view.getChannels().length} · ${text('batch-add-readout')}`)
+					}
 					else {
 						check('批量新增：画布与实例都起来了', false, ready ? '没有 setupState.view' : '没有 canvas')
 					}
@@ -1066,9 +1269,50 @@
 						const confirmButton = document.querySelector('[data-demo="merge-confirm"]')
 						const cancelButton = document.querySelector('[data-demo="merge-cancel"]')
 						check('批量复制与合并：待确认面板给出 resolvePointMerge(true / false) 两个入口', Boolean(confirmButton) && Boolean(cancelButton) && confirmButton.disabled && cancelButton.disabled && confirmButton.textContent.includes('resolvePointMerge(true') && cancelButton.textContent.includes('resolvePointMerge(false'), `${confirmButton?.textContent.trim()} / ${cancelButton?.textContent.trim()}`)
-						setup.resetScene()
-						await wait(300)
-						const dragCanvas = document.querySelector('.gis-view__canvas')
+						setup.resetScene()
+						await wait(300)
+						click('merge-select-sources')
+						await until(() => view.getSelectionData().pointCount === 4, 5000)
+						setup.mergeTargetId = 'node-7'
+						const maxKeysInput = document.querySelector('[data-demo="merge-max-keys"]')
+						maxKeysInput.value = 'vn_kv'
+						maxKeysInput.dispatchEvent(new Event('input', { bubbles: true }))
+						click('merge-apply-max-keys')
+						const maxKeysApplied = await until(() => setup.mergeMaxKeys === 'vn_kv' && view.getOptions().merge?.maxKeys?.join(',') === 'vn_kv', 2000)
+						const maxKeysMergeBefore = view.getData().points.length
+						click('merge-default')
+						const maxKeysMerged = await until(() => view.getData().points.length === maxKeysMergeBefore - 3, 6000)
+						const maxKeysTarget = view.getData().points.find(point => String(point.id) === 'node-7')
+						check('批量复制与合并：maxKeys 输入应用后只把列出的 vn_kv 取参与场站最高', Boolean(maxKeysApplied) && Boolean(maxKeysMerged) && maxKeysTarget?.vn_kv === 1050 && maxKeysTarget?.name === '变电站 8' && text('merge-readout').includes('maxKeys'), JSON.stringify(maxKeysTarget && { name: maxKeysTarget.name, voltage: maxKeysTarget.vn_kv, readout: text('merge-readout') }))
+						setup.resetScene()
+						await wait(300)
+						click('merge-select-sources')
+						await until(() => view.getSelectionData().pointCount === 4, 5000)
+						setup.mergeTargetId = 'node-7'
+						const defaultMergeBefore = view.getData().points.length
+						click('merge-default')
+						const defaultMerged = await until(() => view.getData().points.length === defaultMergeBefore - 3, 6000)
+						const defaultTarget = view.getData().points.find(point => String(point.id) === 'node-7')
+						check('批量复制与合并：maxKeys 缺省时电压等业务字段取保留节点', Boolean(defaultMerged) && defaultTarget?.vn_kv === 15.7 && defaultTarget?.name === '变电站 8' && defaultTarget?.zone_name === '分区 4' && defaultTarget?.demo_merged === undefined, JSON.stringify(defaultTarget && { name: defaultTarget.name, zone: defaultTarget.zone_name, voltage: defaultTarget.vn_kv, demoMerged: defaultTarget.demo_merged }))
+						check('批量复制与合并：缺省合并后的节点带 mergeInfo 来源与快照', defaultTarget?.mergeInfo?.version === 1 && JSON.stringify(defaultTarget.mergeInfo.sourceIds) === '["node-0","node-5","node-12"]' && defaultTarget.mergeInfo.points?.length === 3 && defaultTarget.mergeInfo.lines?.length > 0 && text('merge-readout').includes('mergeInfo'), JSON.stringify({ sources: defaultTarget?.mergeInfo?.sourceIds, points: defaultTarget?.mergeInfo?.points?.length, lines: defaultTarget?.mergeInfo?.lines?.length }))
+						click('split-selected')
+						const defaultSplitLanded = await until(() => view.getData().points.length === defaultMergeBefore && text('split-readout').includes('自动解除合并'), 6000)
+						const defaultSplitResult = unwrap(setup.lastSplitResult)
+						check('批量复制与合并：Demo 自动解除按 mergeInfo 恢复全部来源并回到合并前节点数', Boolean(defaultSplitLanded) && defaultSplitResult?.autoRestored === true && JSON.stringify(defaultSplitResult.mergeSourceIds) === '["node-0","node-5","node-12"]' && view.getData().points.find(point => point.id === 'node-7')?.vn_kv === 15.7, JSON.stringify({ auto: defaultSplitResult?.autoRestored, sources: defaultSplitResult?.mergeSourceIds, points: view.getData().points.length }))
+						check('批量复制与合并：解除合并默认不选中恢复节点，读数明确「未选中拆分结果」', view.getSelectionData().pointCount === 0 && text('split-readout').includes('未选中拆分结果'), JSON.stringify({ selection: view.getSelectionData(), readout: text('split-readout') }))
+						view.undo()
+						const splitUndoForSelect = await until(() => view.getData().points.length === defaultMergeBefore - 3, 5000)
+						const splitSelectInput = document.querySelector('[data-demo="split-select"]')
+						splitSelectInput.checked = true
+						splitSelectInput.dispatchEvent(new Event('change', { bubbles: true }))
+						const splitSelectEnabled = await until(() => setup.splitSelect === true, 2000)
+						click('split-selected')
+						const selectedSplitLanded = await until(() => view.getData().points.length === defaultMergeBefore && text('split-readout').includes('已选中拆分结果'), 6000)
+						const selectedSplitResult = unwrap(setup.lastSplitResult)
+						check('批量复制与合并：勾选后可配置解除合并选中全部恢复节点', Boolean(splitUndoForSelect) && Boolean(splitSelectEnabled) && Boolean(selectedSplitLanded) && view.getSelectionData().pointCount === selectedSplitResult?.items?.length && view.getSelectionData().pointCount === 4, JSON.stringify({ selected: view.getSelectionData().pointCount, items: selectedSplitResult?.items?.length }))
+						setup.resetScene()
+						await wait(300)
+						const dragCanvas = document.querySelector('.gis-view__canvas')
 						const dragBox = dragCanvas.getBoundingClientRect()
 						const dragSend = (type, screen, extra = {}) => {
 							dragCanvas.dispatchEvent(new PointerEvent(type, {
@@ -1211,17 +1455,21 @@
 						check('批量复制与合并：409 后 rebase 生成新 opId 并成功落库',
 							Boolean(copyRebased) && setup.backendSnapshot?.version === conflictVersion + 2 && setup.backendSnapshot?.applied === conflictApplied + 1,
 							`v${conflictVersion} → v${setup.backendSnapshot?.version} / applied ${conflictApplied} → ${setup.backendSnapshot?.applied} / ${text('copy-backend-readout')}`)
-						// 拆分：先选一组，再点演示按钮；节点 +1、读数落到面板，撤销一步回到拆分前
+						// 解除合并：先选一组，再点演示按钮；有 mergeInfo 时自动恢复全部来源，撤销一步回到合并态
 						click('copy-select-sources')
 						const splitSelectionReady = await until(() => view.getSelectionData().pointCount === 4, 5000)
 						const splitSource = view.getSelectionData().points?.[0] ?? view.getData().points[0]
 						const pointsBeforeSplit = view.getData().points.length
 						click('split-selected')
-						const splitLanded = await until(() => view.getData().points.length === pointsBeforeSplit + 1 && text('split-readout').includes('splitPoint'), 6000)
+						const splitLanded = await until(() => view.getData().points.length > pointsBeforeSplit && text('split-readout').includes('自动解除合并'), 6000)
 						const splitReadout = text('split-readout')
-						check('批量复制与合并：拆分选中节点走 splitPoint，第二份与改线 / 改通道读数落面板',
-							Boolean(splitSelectionReady) && Boolean(splitLanded) && text('copy-action').includes('splitPoint') && splitReadout.includes('改线') && splitReadout.includes('改通道'),
+						const splitResult = unwrap(setup.lastSplitResult)
+						check('批量复制与合并：解除合并优先走 splitPoint 自动恢复，mergeSourceIds / 改线 / 改通道读数落面板',
+							Boolean(splitSelectionReady) && Boolean(splitLanded) && text('copy-action').includes('splitPoint') && splitResult?.autoRestored === true && splitReadout.includes('恢复来源') && splitReadout.includes('改线') && splitReadout.includes('改通道'),
 							`${pointsBeforeSplit} → ${view.getData().points.length} · ${splitReadout}`)
+						check('批量复制与合并：自动解除恢复该次合并的来源节点，来源 id 与 mergeInfo 对得上',
+							splitResult?.autoRestored === true && JSON.stringify(splitResult.mergeSourceIds) === '["node-7"]' && splitResult.items.length === 2 && splitResult.mergeSourceIds.every(id => view.getData().points.some(point => String(point.id) === String(id))),
+							JSON.stringify({ sources: splitResult?.mergeSourceIds, items: splitResult?.items?.map(item => item.id) }))
 						view.undo()
 						const splitUndone = await until(() => view.getData().points.length === pointsBeforeSplit && view.getData().points.some(point => String(point.id) === String(splitSource?.id)), 5000)
 						check('批量复制与合并：拆分是一步历史，撤销后节点与连线恢复', Boolean(splitUndone), `${view.getData().points.length} 点 / ${splitSource?.id ?? '—'}`)
@@ -1871,6 +2119,32 @@
 				const channelField = key => channelDemo.querySelector(`[data-demo="${key}"]`)?.textContent.trim() ?? ''
 				const channelCanvas = channelDemo.querySelector('canvas.gis-view__canvas')
 				if (channelView && channelCanvas) {
+					const simplifyToggle = channelDemo.querySelector('[data-demo="channel-simplify-enabled"]')
+					const simplifyThresholdInput = channelDemo.querySelector('[data-demo="channel-simplify-threshold"]')
+					const simplifyGroupsBefore = channelView.getChannelGroups()
+					const simplifyGroupSize = group => group.lineIds?.length ?? group.lineIndexes?.length ?? 0
+					const simplifyLineCountBefore = channelView.getData().lines.length
+					const simplifyGroupLineCountBefore = simplifyGroupsBefore.reduce((sum, group) => sum + simplifyGroupSize(group), 0)
+					simplifyThresholdInput.value = '1'
+					simplifyThresholdInput.dispatchEvent(new Event('input', { bubbles: true }))
+					simplifyThresholdInput.dispatchEvent(new Event('change', { bubbles: true }))
+					await until(() => channelSetup.simplifyThreshold === 1, 2000)
+					simplifyToggle.checked = true
+					simplifyToggle.dispatchEvent(new Event('change', { bubbles: true }))
+					const simplifyApplied = await until(() => channelView.getOptions().channelSimplify?.enabled === true && channelView.getOptions().channelSimplify?.threshold === 1 && channelField('channel-simplify-readout').includes('开 · threshold=1'), 5000)
+					const simplifyGroups = channelView.getChannelGroups()
+					const simplifyFolded = simplifyGroups.filter(group => simplifyGroupSize(group) > 1)
+					const simplifyHiddenIndexes = new Set(simplifyFolded.flatMap(group => group.lineIndexes.slice(1)))
+					const simplifyExpectedIndexes = channelView.getData().lines.map((_line, index) => index).filter(index => !simplifyHiddenIndexes.has(index))
+					const simplifyVisibleIndexes = channelView.getData().lines.map((_line, index) => index).filter(index => channelView.getLineStyle(index) !== null)
+					const simplifyRepresentativeStyle = simplifyFolded.length ? channelView.getLineStyle(simplifyFolded[0].lineIndexes[0]) : null
+					check('通道与数据：开启简略后每个超阈值分组只画代表线，无 groups 的通道按一组处理', Boolean(simplifyApplied) && simplifyFolded.length > 0 && JSON.stringify(simplifyVisibleIndexes) === JSON.stringify(simplifyExpectedIndexes) && simplifyGroups.reduce((sum, group) => sum + simplifyGroupSize(group), 0) === simplifyGroupLineCountBefore && channelView.getData().lines.length === simplifyLineCountBefore && channelField('channel-simplify-readout').includes(`原始 ${simplifyGroupLineCountBefore} 条`), channelField('channel-simplify-readout'))
+					check('通道与数据：简略代表线应用自定义颜色 / 线宽，关闭后全部回线恢复', simplifyRepresentativeStyle?.width === 4 && Math.round(simplifyRepresentativeStyle.color[0] * 255) === 255 && Math.round(simplifyRepresentativeStyle.color[1] * 255) === 107 && Math.round(simplifyRepresentativeStyle.color[2] * 255) === 53, JSON.stringify(simplifyRepresentativeStyle))
+					simplifyToggle.checked = false
+					simplifyToggle.dispatchEvent(new Event('change', { bubbles: true }))
+					const simplifyDisabled = await until(() => channelView.getOptions().channelSimplify === false && channelField('channel-simplify-readout').includes('关'), 5000)
+					const simplifyRestored = channelView.getData().lines.every((_line, index) => channelView.getLineStyle(index) !== null)
+					check('通道与数据：关闭简略后全部回线恢复，原始数据 / 分组条数保持不变', Boolean(simplifyDisabled) && simplifyRestored && channelView.getData().lines.length === simplifyLineCountBefore && channelView.getChannelGroups().length === simplifyGroupsBefore.length, `可见 ${channelView.getData().lines.filter((_line, index) => channelView.getLineStyle(index) !== null).length} / ${simplifyLineCountBefore}`)
 					const visibilityChannelId = channelView.getOptions().channels?.[0]?.id
 					const groupsBeforeHide = channelView.getChannelGroups(visibilityChannelId).length
 					const membersBeforeHide = channelView.getChannel(visibilityChannelId)?.lineIndexes?.length ?? 0
@@ -2493,8 +2767,8 @@
 					await wait(150)
 					const apiItems = () => [...document.querySelectorAll('.demo-api-list:not(.demo-api-list--options) .demo-api-item')]
 					const optionItems = () => [...document.querySelectorAll('.demo-api-list--options .demo-api-item')]
-					check('实例方法速查：整份成员清单按分组列全（16 组 / 265 个成员）',
-						Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 265,
+					check('实例方法速查：整份成员清单按分组列全（16 组 / 273 个成员）',
+						Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 273,
 						`${document.querySelectorAll('.demo-api-group').length} 组 / ${apiItems().length} 个成员`)
 					const apiNames = apiItems().map(node => node.querySelector('b')?.textContent)
 					const roundNames = ['registerSymbol', 'unregisterSymbol', 'listSymbols']
@@ -2513,7 +2787,7 @@
 					check('实例方法速查：这一轮拆出来的方法也在清单里（addChannelGroupLines / joinChannelGroupLines / endAddChannel）',
 						roundNames1597.every(name => apiNames.includes(name)),
 						roundNames1597.filter(name => !apiNames.includes(name)).join(' / ') || '三个都在')
-					check('实例方法速查：options 折叠清单列全 96 个键', optionItems().length === 96, `${optionItems().length} 个键`)
+					check('实例方法速查：options 折叠清单列全 100 个键', optionItems().length === 100, `${optionItems().length} 个键`)
 					const apiSearch = document.querySelector('.demo-api-search input[type="search"]')
 					apiSearch.value = 'focusOn'
 					apiSearch.dispatchEvent(new Event('input', { bubbles: true }))

package/docs/steps/selftest-docs.html

@@ -110,9 +110,11 @@
 				if (check('文档中心：挂上了 __gisDocs 钩子（没钩子多半是 file:// 打开的）', Boolean(api))) {
 					const doc = docsFrame.contentDocument
 					const files = api.docs.map(item => item.file)
-					check('文档中心：清单 92 份 md（10 个根 + 82 份子文档），含接口协议 / manual/18 / internals/18 / steps/rounds/09', api.docs.length === 92 && files.includes('接口协议.md') && files.includes('manual/18-逐方法示例.md') && files.includes('internals/18-性能实测与WebGPU评估.md') && files.includes('steps/rounds/09-第89-93轮.md'), `${api.docs.length} 份 / ${api.docs.filter(item => item.parent).length} 份挂在父文档下`)
+					check('文档中心：清单 87 份 md（10 个根 + 77 份子文档），含接口协议 / manual/18 / internals/18 / steps/rounds/09', api.docs.length === 87 && files.includes('接口协议.md') && files.includes('manual/18-逐方法示例.md') && files.includes('internals/18-性能实测与WebGPU评估.md') && files.includes('steps/rounds/09-第89-93轮.md'), `${api.docs.length} 份 / ${api.docs.filter(item => item.parent).length} 份挂在父文档下`)
+					const aiDocs = api.docs.filter(item => item.file === 'AI对话汇总.md' || item.file.startsWith('ai/'))
+					check('文档中心：AI 文档精简为「主汇总 + 维护索引」两个入口，旧 01 ~ 05 已合并', aiDocs.length === 2 && aiDocs.some(item => item.file === 'AI对话汇总.md') && aiDocs.some(item => item.file === 'ai/06-会话索引与复查方法.md' && item.parent === 'AI对话汇总.md') && !files.some(file => /^ai\/(0[1-5])-/.test(file)), aiDocs.map(item => item.file).join(' / '))
 					const parents = api.docs.filter(item => item.parent)
-					check('文档中心：子文档的 parent 都能对上清单里的父文档，分组标题挂在父条目上（6 组）', parents.length === 82 && parents.every(item => files.includes(item.parent) && api.docs.some(candidate => candidate.file === item.parent && candidate.groupLabel)) && new Set(parents.map(item => item.parent)).size === 6, [...new Set(parents.map(item => item.parent))].join(' / '))
+					check('文档中心：子文档的 parent 都能对上清单里的父文档，分组标题挂在父条目上（6 组）', parents.length === 77 && parents.every(item => files.includes(item.parent) && api.docs.some(candidate => candidate.file === item.parent && candidate.groupLabel)) && new Set(parents.map(item => item.parent)).size === 6, [...new Set(parents.map(item => item.parent))].join(' / '))
 					check('文档中心：清单 6 个交互页，含 api/index.html / playground/index.html / guide/sample-document.html', api.pages.length === 6 && api.pages.some(item => item.href === 'api/index.html') && api.pages.some(item => item.href === 'playground/index.html') && api.pages.some(item => item.href === 'guide/sample-document.html'), api.pages.map(item => item.href).join(' / '))
 					check('文档中心：侧栏按清单渲染（md 与交互页两条都数得对）', doc.querySelectorAll('#doc-list a').length === api.docs.length && doc.querySelectorAll('#page-list a').length === api.pages.length)
 					const treeGroups = [...doc.querySelectorAll('#doc-list details.doc-children')]
@@ -125,6 +127,15 @@
 					const pathDocs = pathCards.map(card => card.dataset.doc).filter(Boolean)
 					const apiPathCard = pathCards.find(card => card.textContent.includes('查方法与参数'))
 					check('文档中心：README 顶部有 4 条推荐阅读路径，3 篇文档加 API 页都指向真实目标', pathCards.length === 4 && pathDocs.length === 3 && pathDocs.every(file => files.includes(file)) && (apiPathCard?.getAttribute('href') ?? '').includes('api/index.html') && pathCards.every(card => card.querySelector('.doc-path__badge') && card.textContent.trim().length > 12), pathCards.map(card => card.querySelector('b')?.textContent?.trim()).join(' / '))
+					await api.load('manual/08-选中与拐点.md')
+					const breadcrumb = doc.querySelector('#content .doc-breadcrumb')
+					const crumbParent = breadcrumb?.querySelector('a[data-doc]')
+					check('文档中心：正文顶部有当前位置面包屑，父文档可点回索引', Boolean(breadcrumb) && breadcrumb.textContent.includes('文档中心') && breadcrumb.textContent.includes('GisView.md') && breadcrumb.textContent.includes('手册 08') && crumbParent?.dataset.doc === 'GisView.md' && files.includes(crumbParent.dataset.doc), breadcrumb?.textContent.trim() ?? '没有面包屑')
+					const pager = doc.querySelector('#content .doc-pager')
+					const pagerLinks = [...pager.querySelectorAll('a[data-doc]')]
+					check('文档中心：文末有上一份 / 下一份，顺序与侧栏清单一致', pagerLinks.length === 2 && pagerLinks[0].dataset.doc === 'manual/07-指针与要素编辑.md' && pagerLinks[1].dataset.doc === 'manual/09-通道与多回线.md' && pagerLinks.every(link => files.includes(link.dataset.doc)), pagerLinks.map(link => link.dataset.doc).join(' → '))
+					const tocCountText = doc.querySelector('#toc-count')?.textContent ?? ''
+					check('文档中心：右栏目录标题显示本页小节数，和目录链接数一致', Number(tocCountText) > 0 && Number(tocCountText) === doc.querySelectorAll('#toc nav a[data-id]').length, `${tocCountText} 个小节 / ${doc.querySelectorAll('#toc nav a[data-id]').length} 条目录`)
 					check('文档中心：正文链接的解析（相对「当前那份文档」算，解析不到给 null）', api.resolve('docs/GisView.md', '../README.md') === 'GisView.md' && api.resolve('../从0到完整的实现.md', 'steps/README.md') === '从0到完整的实现.md' && api.resolve('../index.html', 'README.md') === null)
 					const fixture = api.render('# 文档标题\n\n> 一句话摘要\n\n## 标题\n\n| A | B |\n| --- | --- |\n| 1 | 2 |\n\n```js\nconst a = 1\n```\n\n- 一级\n  - 二级\n\n> 正文引用\n\n行内 `code` 与 [链接](GisView.md)\n')
 					const tableFixture = api.render('| 字段 | 类型 |\n| --- | --- |\n| `type` | `\'image/png\' \\| \'image/jpeg\' \\| \'svg\'` |\n')
@@ -520,8 +531,8 @@
 				if (check('API 速查：挂上了 __gisApi 钩子（数据来自 api-index.js，没钩子多半是 file:// 打开的）', Boolean(apiHook))) {
 					const apiDoc = apiFrame.contentDocument
 					const summary = apiHook.summary
-					check('API 速查：清单来自 api-index（265 个成员 / 260 个方法 / 5 个属性 / 96 个 options / 16 个分组）',
-						summary.members === 265 && summary.methods === 260 && summary.properties === 5 && summary.options === 96 && summary.sections === 16,
+					check('API 速查：清单来自 api-index（273 个成员 / 268 个方法 / 5 个属性 / 100 个 options / 16 个分组）',
+						summary.members === 273 && summary.methods === 268 && summary.properties === 5 && summary.options === 100 && summary.sections === 16,
 						JSON.stringify(summary))
 					const topJumps = [...apiDoc.querySelectorAll('.doc-jump')]
 					const jumpTargets = topJumps.map(node => `${node.dataset.docJump}:${node.getAttribute('href')}`)
@@ -559,8 +570,8 @@
 						`${apiDoc.querySelectorAll('.api-member').length} 张卡片 / 属性 ${apiDoc.querySelectorAll('.api-member[data-kind="property"]').length} 张`)
 					const noExample = [...apiDoc.querySelectorAll('.api-member')].filter(node => Number(node.dataset.examples) < 1)
 					check('API 速查：每个成员都带至少一段示例（不出现空卡片）', noExample.length === 0,
-						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '265 张卡片都有示例')
-					check('API 速查：96 个 options 都列全（名字 / 类型 / 默认值 / 说明四件套）',
+						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '273 张卡片都有示例')
+					check('API 速查：100 个 options 都列全（名字 / 类型 / 默认值 / 说明四件套）',
 						apiDoc.querySelectorAll('.api-option').length === summary.options && [...apiDoc.querySelectorAll('.api-option')].every(node => node.querySelector('.name code') && node.querySelector('.type') && node.querySelector('.def') && node.querySelector('.doc')),
 						`${apiDoc.querySelectorAll('.api-option').length} 个`)
 					const statCards = [...apiDoc.querySelectorAll('#stats .api-stat')]