gis-view-webgl2 0.1.7 → 0.1.9

package/docs/index.html

@@ -604,6 +604,95 @@
 				background: var(--accent);
 				color: #fff;
 			}
+			/* 正文顶部的文档位置：父文档可点，当前页只做层级提示 */
+			article .doc-breadcrumb {
+				display: flex;
+				flex-wrap: wrap;
+				gap: 5px 7px;
+				align-items: center;
+				margin: 0 0 13px;
+				color: var(--muted);
+				font-size: 12px;
+				line-height: 1.7;
+			}
+			article .doc-breadcrumb .slash {
+				color: var(--muted-2);
+			}
+			article .doc-breadcrumb a {
+				padding: 0;
+				border: 0;
+				color: var(--accent);
+				background: none;
+				text-decoration: none;
+			}
+			article .doc-breadcrumb a:hover {
+				color: var(--accent-strong);
+				border: 0;
+				background: none;
+				text-decoration: underline;
+				text-underline-offset: 3px;
+			}
+			article .doc-breadcrumb .current {
+				color: var(--text-strong);
+				font-weight: 600;
+			}
+			/* 文档末尾的上一份 / 下一份：沿侧栏顺序走，按钮本身就是可分享的深链 */
+			.doc-pager {
+				display: grid;
+				grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+				gap: 10px;
+				margin: 36px 0 0;
+				padding: 18px 0 0;
+				border-top: 1px solid var(--line-soft);
+			}
+			article a.doc-pager__link,
+			.doc-pager__empty {
+				display: flex;
+				flex-direction: column;
+				gap: 3px;
+				min-width: 0;
+				padding: 11px 13px;
+				border: 1px solid var(--line);
+				border-radius: 10px;
+				background: var(--surface-2);
+				color: var(--text);
+				text-decoration: none;
+				transition: border-color 0.14s, background 0.14s, box-shadow 0.14s;
+			}
+			article a.doc-pager__link:hover {
+				border-color: var(--accent-line);
+				background: var(--accent-soft);
+				color: var(--text);
+				box-shadow: var(--shadow-1);
+			}
+			.doc-pager__empty {
+				visibility: hidden;
+			}
+			.doc-pager .next {
+				grid-column: 2;
+				text-align: right;
+			}
+			.doc-pager small {
+				color: var(--accent);
+				font-size: 10.5px;
+				font-weight: 600;
+				letter-spacing: 0.08em;
+			}
+			.doc-pager b {
+				overflow: hidden;
+				color: var(--text-strong);
+				font-size: 13px;
+				text-overflow: ellipsis;
+				white-space: nowrap;
+			}
+			.doc-pager span {
+				overflow: hidden;
+				color: var(--muted);
+				font-size: 11.5px;
+				line-height: 1.55;
+				text-overflow: ellipsis;
+				white-space: nowrap;
+			}
 			/* README 首屏的推荐阅读路径：按任务给四条入口，不替代正文目录 */
 			.doc-paths {
 				margin: 0 0 22px;
@@ -629,7 +718,7 @@
 			}
 			.doc-paths__grid {
 				display: grid;
-				grid-template-columns: repeat(auto-fit, minmax(185px, 1fr));
+				grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
 				gap: 9px;
 			}
 			article a.doc-path {
@@ -695,6 +784,15 @@
 				article a.doc-path {
 					min-height: 0;
 				}
+				.doc-pager {
+					grid-template-columns: minmax(0, 1fr);
+				}
+				.doc-pager .next {
+					grid-column: 1;
+				}
+				.doc-pager__empty {
+					display: none;
+				}
 			}
 			@keyframes fade-in {
 				from {
@@ -1296,7 +1394,7 @@
 			</aside>
 			<article id="content"><p id="loading">正在读取…</p></article>
 			<aside id="toc">
-				<h2>本页目录</h2>
+				<h2>本页目录<span class=count id=toc-count></span></h2>
 				<nav></nav>
 			</aside>
 		</div>
@@ -1323,7 +1421,7 @@
 				{ file: 'manual/14-视图与筛选.md', title: '手册 14 · 视图与筛选', blurb: '筛选 / 搜索 / 视图与背景', parent: 'GisView.md' },
 				{ file: 'manual/15-导出与集成.md', title: '手册 15 · 导出与集成', blurb: '导出 / 插件 / 自建界面', parent: 'GisView.md' },
 				{ file: 'manual/16-实例方法总表.md', title: '手册 16 · 实例方法总表', blurb: '实例方法主表', parent: 'GisView.md' },
-				{ file: 'manual/17-参数速查.md', title: '手册 17 · 参数速查', blurb: '257 个成员逐个列全', parent: 'GisView.md' },
+				{ file: 'manual/17-参数速查.md', title: '手册 17 · 参数速查', blurb: '273 个成员逐个列全', parent: 'GisView.md' },
 				{ file: 'manual/18-逐方法示例.md', title: '手册 18 · 逐方法示例', blurb: '每个成员一段示例', parent: 'GisView.md' },
 				{ file: 'manual/19-读数与拖拽预览.md', title: '手册 19 · 读数与拖拽预览', blurb: '读数 / 定位 / 落点预览', parent: 'GisView.md' },
 				{ file: 'manual/20-性能与大数据.md', title: '手册 20 · 性能与大数据', blurb: '大数据开关与实测', parent: 'GisView.md' },
@@ -1362,13 +1460,8 @@
 				{ file: 'internals/16-03-优化与取舍-下.md', title: '原理 16-03 · 优化与取舍（下）', blurb: '16.57 ~ 16.74：坐标、通道、筛选与文档口径的取舍。', parent: 'GisView实现原理.md' },
 				{ file: 'internals/17-调试与扩展建议.md', title: '原理 17 · 调试与扩展建议', blurb: '怎么排查 GL 错误、怎么接自己的覆盖层与插件。', parent: 'GisView实现原理.md' },
 				{ file: 'internals/18-性能实测与WebGPU评估.md', title: '原理 18 · 性能实测与 WebGPU 评估', blurb: '十五轮实测数据、瓶颈定位与 WebGPU 值不值得上。', parent: 'GisView实现原理.md' },
-				{ file: 'AI对话汇总.md', title: 'AI 对话汇总（索引）', blurb: '重要问答与 39 个会话索引（正文在 ai/）', groupLabel: '6 章' },
-				{ file: 'ai/01-起源与这份汇总的由来.md', title: '对话 01 起源与这份汇总的由来', blurb: '这份汇总的来源与筛选口径、选型与立项（2026-09-15）、以及按时间读这条线的三段。', parent: 'AI对话汇总.md' },
-				{ file: 'ai/02-按内容分类-这一路都在改什么.md', title: '对话 02 按内容分类：这一路都在改什么', blurb: '七个主题（通道分组拐点 / 交互编辑 / 样式视觉 / 性能 / 数据接口 / 文档工程 /', parent: 'AI对话汇总.md' },
-				{ file: 'ai/03-重要问答选（一）：选型通道与样式.md', title: '对话 03 重要问答选（一）：选型、通道与样式', blurb: '选型 13 问、立项、通道诞生、缩放 / 筛选 / 搜索的成形、颜色语义（描边 vs 填充）', parent: 'AI对话汇总.md' },
-				{ file: 'ai/04-重要问答选（二）：交互性能与数据.md', title: '对话 04 重要问答选（二）：交互、性能与数据', blurb: '功能开关与按总量付费的循环、节点拖拽一闪一闪、线路批次视口裁剪、百万级解析、以及 20 条的', parent: 'AI对话汇总.md' },
-				{ file: 'ai/05-重要问答选（三）：宿主旁支与收口.md', title: '对话 05 重要问答选（三）：宿主旁支与收口', blurb: '宿主 SVG / 直流标记不画的排查、选中集与拐点键跟着要素走、以及最近一轮的六条问题。', parent: 'AI对话汇总.md' },
-				{ file: 'ai/06-会话索引与复查方法.md', title: '对话 06 会话索引与复查方法', blurb: '39 个会话的索引表（时间 / 会话文件 / 轮数 / 这一轮做了什么）与「怎么自己复查」。', parent: 'AI对话汇总.md' },
+				{ file: 'AI对话汇总.md', title: 'AI 对话汇总', blurb: '39 个会话、194 轮：关键决策 / 精选问答 / 演进时间线', groupLabel: '维护索引 1 份' },
+				{ file: 'ai/06-会话索引与复查方法.md', title: '维护索引与复查', blurb: '会话文件 / 历史增量 / 当前轮次 / 自测命令', parent: 'AI对话汇总.md' },
 				{ file: '从0到完整的实现.md', title: '从 0 到完整的实现（索引）', blurb: '分步实现讲义（配 steps 里的 demo）', groupLabel: '15 份' },
 				{ file: 'from0/01-先把地图想清楚.md', title: '讲义 01 先把地图想清楚', blurb: '三层结构、四种坐标、GeoJSON 底图上的真实经纬度与文件职责。', parent: '从0到完整的实现.md' },
 				{ file: 'from0/02-WebGL2起步.md', title: '讲义 02 WebGL2 起步', blurb: '拿上下文、写着色器、那 9 个浮点数、混合与尺寸跟随。', parent: '从0到完整的实现.md' },
@@ -1385,7 +1478,7 @@
 				{ file: 'from0/13-从零搭一整套-上.md', title: '讲义 13 从零搭一整套（上）', blurb: '目标与文件、起工程，以及第 1 ~ 5 步的完整代码（常量 / 上下文 / 相机 / 解析 ', parent: '从0到完整的实现.md' },
 				{ file: 'from0/14-从零搭一整套-下.md', title: '讲义 14 从零搭一整套（下）', blurb: '第 6 ~ 7 步（拾取交互、尺寸与对外接口）、验收清单与往完整库长。', parent: '从0到完整的实现.md' },
 				{ file: 'from0/15-附录-常量速查与踩坑清单.md', title: '讲义 15 附录：常量速查与踩坑清单', blurb: '常量速查表与 27 条踩坑记录。', parent: '从0到完整的实现.md' },
-				{ file: 'steps/README.md', title: 'steps/README.md（分步 demo 用法）', blurb: '怎么跑、每步写了什么、和库文件的对照', groupLabel: '逐轮记录 10 份' },
+				{ file: 'steps/README.md', title: 'steps/README.md（分步 demo 教学路线）', blurb: '四段新手路线、每步验收、搭建思路与优化顺序', groupLabel: '逐轮记录 10 份' },
 				{ file: 'steps/rounds/README.md', title: '逐轮记录（索引）', blurb: '93 轮「修改.txt / 问题.txt」的落点表，按时间分页', parent: 'steps/README.md' },
 				{ file: 'steps/rounds/01-第1-11轮.md', title: '逐轮 第 1 ~ 11 轮', blurb: '这 11 轮各改了什么、需求落在哪（新的在后一页）。想看某一轮的完整实测与设计取舍，再翻《实', parent: 'steps/README.md' },
 				{ file: 'steps/rounds/02-第12-22轮.md', title: '逐轮 第 12 ~ 22 轮', blurb: '这 11 轮各改了什么、需求落在哪（新的在后一页）。想看某一轮的完整实测与设计取舍，再翻《实', parent: 'steps/README.md' },
@@ -1399,7 +1492,7 @@
 				{ file: '../src/gis-view/README.md', title: 'src/gis-view/README.md', blurb: '源码导读与逐轮实现记录' }
 			]
 			const PAGES = [
-				{ href: 'api/index.html', title: 'API 速查（方法 + 示例）', blurb: '257 个实例成员 / 96 个 options，逐个带示例与复制' },
+				{ href: 'api/index.html', title: 'API 速查（方法 + 示例）', blurb: '273 个实例成员 / 100 个 options，逐个带示例与复制' },
 				{ href: 'playground/index.html', title: '调试演示页（粘代码就跑）', blurb: '左侧编辑、右侧真实实例 + GeoJSON 底图：内置示例与「这一份文档」的示例同在一个下拉，粘代码直接跑' },
 				{ href: 'guide/sample-document.html', title: 'sample-document.json 图解', blurb: '点数据看端点 / 拐点 / 分组骨架' },
 				{ href: 'steps/index.html', title: '从 0 手写分步 demo', blurb: '13 步，每步一个文件' },
@@ -1665,6 +1758,7 @@
 			const pageListEl = document.querySelector('#page-list')
 			const content = document.querySelector('#content')
 			const tocNav = document.querySelector('#toc nav')
+			const tocCount = document.querySelector('#toc-count')
 			/** 左侧每组子文档的折叠状态：按父文档文件名记，刷新 / 切文档都保持（全部收起之后仍能在当前组里点开） */
 			const SIDEBAR_GROUPS_KEY = 'gisDocs.closedGroups'
 			const closedSidebarGroups = new Set()
@@ -1726,6 +1820,30 @@
 			 * 父条目自己的 blurb 仍在行内；`groupLabel` 是那行「手册 21 章」这样的分组标题。
 			 * 过滤时父 / 子各按标题匹配：命中父就整组留着，只命中子就只留命中的那几份。
 			 */
+			const shortDocTitle = title => String(title ?? '').replace(/\s*[（(]索引[）)]\s*$/, '')
+			const renderBreadcrumb = doc => {
+				const parent = doc.parent ? DOCS.find(item => item.file === doc.parent) : null
+				const parts = ['<span>文档中心</span>']
+				if (parent) {
+					parts.push(`<a href='#${encodeURIComponent(parent.file)}' data-doc='${escapeHtml(parent.file)}'>${escapeHtml(shortDocTitle(parent.title))}</a>`)
+				}
+				parts.push(`<span class='current' aria-current='page'>${escapeHtml(shortDocTitle(doc.title))}</span>`)
+				return `<nav class='doc-breadcrumb' aria-label='文档位置'>${parts.join('<span class=slash>/</span>')}</nav>`
+			}
+			const renderDocPager = file => {
+				const at = DOCS.findIndex(item => item.file === file)
+				if (at < 0) {
+					return ''
+				}
+				const pagerItem = (doc, direction) => {
+					if (!doc) {
+						return `<span class='doc-pager__empty ${direction}' aria-hidden='true'></span>`
+					}
+					const label = direction === 'prev' ? '← 上一份' : '下一份 →'
+					return `<a class='doc-pager__link ${direction}' href='#${encodeURIComponent(doc.file)}' data-doc='${escapeHtml(doc.file)}'><small>${label}</small><b>${escapeHtml(shortDocTitle(doc.title))}</b><span>${escapeHtml(doc.blurb)}</span></a>`
+				}
+				return `<nav class='doc-pager' aria-label='相邻文档'>${pagerItem(DOCS[at - 1], 'prev')}${pagerItem(DOCS[at + 1], 'next')}</nav>`
+			}
 			const renderSidebar = (filter = '') => {
 				const keyword = filter.toLowerCase()
 				const match = doc => !keyword || doc.title.toLowerCase().includes(keyword)
@@ -1956,7 +2074,7 @@
 				{ badge: 'START', title: '第一次使用', desc: '引入、最小数据与首屏配置，先把图画出来。', meta: '01 快速开始 · 约 10 分钟', file: 'manual/01-快速开始.md' },
 				{ badge: 'BACKEND', title: '接后端与导出', desc: '编辑接口、导出回灌、插件与自建界面。', meta: '15 导出与集成', file: 'manual/15-导出与集成.md' },
 				{ badge: 'PERF', title: '十万级性能', desc: 'Worker 筛选 / 异步搜索、批量更新与质量档。', meta: '20 性能与大数据', file: 'manual/20-性能与大数据.md' },
-				{ badge: 'API', title: '查方法与参数', desc: '实例方法、options 与可复制示例集中检索。', meta: 'API 速查 · 257 个成员', href: 'api/index.html', external: true }
+				{ badge: 'API', title: '查方法与参数', desc: '实例方法、options 与可复制示例集中检索。', meta: 'API 速查 · 273 个成员', href: 'api/index.html', external: true }
 			]
 			const renderReadingPaths = () => `<section class='doc-paths' aria-label='推荐阅读路径'>` +
 				`<div class='doc-paths__head'><strong>按任务选一条阅读路径</strong><span>第一次进来先看快速开始；带着明确目标时直接跳到对应章节。</span></div>` +
@@ -2007,6 +2125,11 @@
 							syncHash(node.dataset.slug ?? '')
 						})
 					})
+					content.insertAdjacentHTML('afterbegin', renderBreadcrumb(target))
+					content.insertAdjacentHTML('beforeend', renderDocPager(target.file))
+					if (tocCount) {
+						tocCount.textContent = String(toc.length)
+					}
 					markCurrent(target.file)
 					// README 首屏在正文前插一排阅读路径；切到别的文档时随正文一起换掉
 					if (target.file === DOCS[0].file) {

package/docs/internals/15-04-/351/200/220/350/275/256/350/256/260/345/275/225-/347/203/255/345/212/233/345/233/276/344/270/216/346/200/247/350/203/275.md

@@ -449,6 +449,16 @@ demo 侧（第 ② 条）：`docs/demos/gisStyle.js` 的 `buildGisLineRules(laye
 
 **验证**：`npx tsc --noEmit` 0 错、`npm run build` 通过、`node docs/steps/check-doc-coverage.mjs` 全部命中；十二页自测逐页跑完（`selftest-perf` 85 → **88** 条全绿，新增的 3 条量的是「8000 条线放大之后批次只剩 27 条 / 相机挪回来又回到 8000 / 来回一趟整幅像素一模一样（差异 0 / 241164）」，另加 1 条 DIAG；`selftest-features` 295 → **299** 条，新增的 4 条按画布正中两条粗线交叉处的像素判红蓝：默认蓝（后写的在上）→ 规则写 `zIndex: 5` 变红 → `updateLine` 给另一条写 `zIndex: 9` 又变蓝 → 写回 0 回到红；其余各页条数与改前一致，`selftest-features` 2 条 noMsaa、`selftest-demos` 1 条 LabelDemo 是既有失败，与本轮无关）。
 
+### 15.48 通道解析 / 快照路径拆分与直接连接查询（本轮）
+
+**需求**（修改.txt）：①「刚刚修改为什么没有更新文档」——补齐上一轮通道性能优化与 `removeChannel` 修复的实现记录；②新增一个按节点集合获取直接通道或线路的方法，传一组节点 id，没有结果返回空，两端必须节点之间存在。
+
+**上一轮实现补记**：`resolveChannels()` 逐组只解析一次成员，后续车道与骨架共用；简略组只给代表槽生成居中几何，渲染、补丁、命中与边界测量都跳过空槽，状态里的 `offsets` / `spacing` 仍是整组车道。`channelPathsFor()` 与 `channelSnapshotPathAt()` 把「实际要画的路径」和「对外快照的完整路径」拆开：前者不碰隐藏成员，后者按成员原车道惰性补全，所以 `getChannels()` / `getChannelGroupWaypoints()` 不会因简略而出现空路径或错车道。`channelGroupsOf(channel, false)` 让只读路径直接复用声明，`lineChannelIndexIn()` 把复制载荷的反复分组扫描收成一次索引，`removeLines()` 用预建索引与 Set 去重；`removeChannel()` 改按 `channelLineIdsOf()` 取成员，只写 `groups` 的通道也会把组内回线全部删净。20 000 回线 / 4 分组实测：完整构建 **1198.7 → 134.0 ms**、简略构建 **922.0 → 26.6 ms**、复制 **3899 → 682.8 ms**、删除 **2895 → 685.8 ms**。
+
+**直接连接查询**：`create.js` 新增 `getDirectConnections(pointIds)`。输入先按真实 `points` id 解析、字符串归一后去重，少于两个有效节点直接返回 `[]`；随后扫一遍通道、一遍线路，只保留两端都在集合里且端点不同的边。通道走 `channelEndsOf()`，即声明优先；只写 `groups` 的通道从第一条成员回线继承端点。线路只认自己的 `from` / `to`，所以纯 `path` 线路、自环、端点不在 `points` 或不在输入集合里的边都跳过，不存在多跳推导。结果先按 `channels` 数据顺序、再按 `lines` 数据顺序，通道和它的成员回线可以同时出现；每项带 `type`、`from` / `to`（id / 下标 / 数据对象）与 `item`，通道另有 `channelId` / `channelIndex` / `lineIds`，线路另有 `lineId` / `lineIndex`。空结果严格为 `[]`，查询不依赖当前选中、筛选或显隐，也不改数据。
+
+**类型、文档与验证**：`types.d.ts` 补 `GisViewDirectConnectionNode` / `GisViewDirectChannelConnection` / `GisViewDirectLineConnection` / `GisViewDirectConnection` 与实例签名；manual 09 新增查询口径，16 / 17 / 18 补主表、参数和示例；`selftest-features` 新增四条，覆盖集合内外的边、反向端点、groups-only 通道继承端点、自环 / 未绑定线路与空表。公开成员由 **272** 增至 **273**（**267 → 268** 个方法，属性仍 5 个）。详细验证见本轮 aimd 记录。
+
 ---
 
 [← 15-03 逐轮记录：性能与修复（下）](15-03-%E9%80%90%E8%BD%AE%E8%AE%B0%E5%BD%95-%E6%80%A7%E8%83%BD%E4%B8%8E%E4%BF%AE%E5%A4%8D-%E4%B8%8B.md) · [实现原理目录](../GisView实现原理.md) · [16-01 优化与取舍（上） →](16-01-%E4%BC%98%E5%8C%96%E4%B8%8E%E5%8F%96%E8%88%8D-%E4%B8%8A.md)

package/docs/manual/02-/345/235/220/346/240/207/344/270/216/346/225/260/346/215/256.md

@@ -5,7 +5,7 @@
 ## 坐标、相机与像素
 
 - **世界坐标**：`x` / `y` 就是数据里的数值（经纬度、平面坐标都行），组件不做投影、不做坐标轴翻转。数据范围由节点与线路顶点共同决定（`getBounds()`）。
-- **相机**：`{ center: [x, y], scale }`，`scale` 的单位是**屏幕 CSS 像素 / 世界单位**（`getCamera()` / `setCamera()`）。`fitView(padding)` 适应整份数据，`zoomToBounds(bounds, padding)` 适应一段范围，`zoomTo(scale, origin)` 直接设比例，`zoomBy(factor, origin)` 按锚点缩放，`focusOn(target, { center: true })` 只挪中心。
+- **相机**：`{ center: [x, y], scale }`，`scale` 的单位是**屏幕 CSS 像素 / 世界单位**（`getCamera()` / `setCamera()`）。`fitView(padding)` 适应整份数据，`zoomToBounds(bounds, padding)` 适应一段范围，`zoomTo(scale, origin)` 直接设比例，`zoomBy(factor, origin)` 按锚点缩放，`focusOn(target)` 缺省只挪中心。
 - **滚轮缩放**：以光标为锚点，`deltaY` 100 对应 1.12 倍 —— 缩放量按 `deltaY` 的大小算（`deltaMode` 是行 / 页时先折算成像素），触摸板的连续小位移因此是平滑的小步长，鼠标滚轮的一格仍是原来那一步，一次甩得再大也有上限（`deltaY` 夹在 ±240，免得某个设备一次甩出十倍）。**缩放缺省是关的**（`interactive` / `zoom` 都没写时滚轮完全不接），写 `interactive: true` 或 `features: { zoom: true }` / `features: 'view'` 才接；接着的时候一律 `preventDefault()`（含 Ctrl + 滚轮的浏览器缩放）。
 - **三档坐标口径**（`world` 不多余：数据 `x` / `y` 就是世界坐标，事件载荷里叫 `world` 只是标口径；三档之间是「客户端坐标 ↔ 画布 CSS 像素 ↔ 世界坐标」的换算链）：
   - **世界坐标（`x` / `y`）**：数据、相机、几何读数、`focusOn` 与拖拽落点用的都是这一套，没有第二套；

package/docs/manual/03-/351/205/215/347/275/256/351/241/271.md

@@ -26,6 +26,7 @@
 | `channelTangentInset` | `number \| null` | `null` | 两端切点往节点里收多少 CSS 像素：缺省（`null`）按成员回线里最粗那条的线宽收，线因此不会从节点边缘探出去；`0` 表示切点正好落在节点边上，**负数外收**（切点往节点外让、回线整段比节点宽）；单个通道可用 `tangentInset` 覆盖；内收两侧合计最多收掉节点宽度的 40%，外收单侧最多让出 50% |
 | `channelMaxGroups` | `number` | `0` | 一条通道最多几个分组（`0` 表示不限）：新增通道时用来判断还能不能变成新分组，见「新增通道」 |
 | `channelGroupMaxLines` | `number` | `0` | 一个分组最多几条回线（`0` 表示不限）：新增通道时用来判断还能不能并进某一组，见「新增通道」 |
+| `channelSimplify` | `boolean \| GisViewChannelSimplifyOptions` | `false` | 通道简略：`true` 用缺省阈值 `4`；对象可调 `enabled` / `threshold` / `style`。分组回线数严格大于阈值时只画一条代表线，见「通道简略（channelSimplify）」 |
 | `channelDraftStyle` | `GisViewChannelDraftStyle` | 蓝色 2px + 两端圆点，箭头关闭 | 新增通道草稿预览的全局样式：`color` / `width` / `dot` / `dotColor` / `dots`（`false` 关示例点，或 `{ show, size, color, shape, from, to }` 分端配置；示例点固定在点中的节点中心）/ `layer`（`'above'` 默认，`'below-points'` 让示例线 / 箭头 / `customDraw` 位于真实节点之下）/ `arrow` / `arrowSize` / `arrowPositions` / `arrowReverse` / `arrowColor` / `circuitSpacing` / `opacity` / `customDraw`；`beginAddChannel({ channelDraftStyle })` 可按这一次草稿覆盖，`updateAddChannelStyle(patch)` 可在草稿期间增量修改 |
 | `webglLayers` | `GisViewWebGLLayer[]` | `[]` | WebGL 自定义绘制层：每层提供 `draw({ gl, canvas, viewport, camera, frame, project, unproject, requestRender })`，在内置内容之后按 `order` 绘制；运行时也可用 `addWebGLLayer` / `updateWebGLLayer` / `removeWebGLLayer` 维护 |
 | `background` | `GisViewBackground` | 浅色底 | 背景层，支持底色、图片与 GeoJSON |
@@ -36,10 +37,10 @@
 | `effects` | `GisViewEffectsInput` | 关 | 动画效果（全局缺省）：线路上的跑动图标（`line`，ECharts `lines.effect` 那一类）与节点上的扩散涟漪（`point`，`effectScatter` 那一类），逐要素用 `points[].effect` / `lines[].effect` 覆盖；没配就是关的，但「只在数据里逐条配了 `effect`」的场景照样会动。`false` 或 `{ enabled: false }` 是**一处关掉**（谁都别动）；运行时有 `updateOptions({ effects })` / `getEffects()` / `getLineEffects()`，见「动画效果（effects）」 |
 | `lineDirection` | `GisViewLineDirectionInput` | 关（`null`） | 线路方向箭头（全局缺省）：沿线摆一串静态箭头，朝向跟着线路切向走（起点 / `from` 那一端 → 终点，`reverse` 指回上游），按弧长等分、缺省每条线只在中点一个；逐条线路用 `lines[].direction` 覆盖，写法与 `effects` 同构（`true` 用全局、对象逐字段覆盖、`false` / `null` 关掉），见「线路方向箭头（lineDirection）」 |
 | `prebake` | `GisViewPrebakeOptions \| true` | 关 | 贴图符号预热：把「这次画面会出现什么」提前告诉组件 —— 两种写法：`combos` 逐组合（精确，`getSymbolCombos()` 收出来的那份）/ `symbols × pointColors × sizes` 与 `lineColors × 线路动画图标` 全排列（省事，颜色与尺寸由同一个字段决定时会多烤很多）—— 第一帧之前就烤好，画到它们时命中的是现成的贴图（省掉解码 + 光栅化那一下）；组合数与数据量无关，不配就是从前那条按需路径。读数 `getPrebake()` / `getSymbolCombos()`、手动再烤一遍 `runPrebake()`，见「贴图符号预热（prebake）」 |
-| `label` | `GisViewLabelOptions \| GisViewLabelOptions[]` | 无 | 节点标签：内容 / 位置 / 显隐 / 避让 / 拖动与编辑都可配，**写数组就是同一个节点上多条标签**，与 `lineLabel` 共用一套避让网格，见「节点标签」 |
+| `label` | `GisViewLabelOptions \| GisViewLabelOptions[]` | 无 | 节点标签：内容 / 位置 / 显隐 / 避让 / 层级 / 缩放字号 / 拖动与编辑都可配，**写数组就是同一个节点上多条标签**，与 `lineLabel` 共用一套避让网格；`zIndex` 显式定层，`followNodeZIndex` 跟随节点样式链，`zoomScale` 控制字号是否随地图缩放，见「节点标签」 |
 | `labelOptimize` | `boolean` | `false` | 标签显示优化开关：**缺省关 = 强制显示**（不避让、不按 `maxCount` 截断、不设 `scanLimit` / 扫描预算，节点 / 线路的每个可见要素该出现的标签一条不少）；写 `true` 与从前一致 —— 避让 / 换落点 / 数量上限 / 候选上限全部生效。标签订得密、数据量大（十万级）时建议打开，见「标签显示优化开关」 |
 | `labelRender` | `'auto' \| 'canvas' \| 'dom'` | `'auto'` | 纯文本标签的容器渲染方式：`auto` 在强制显示档（`labelOptimize` 未开且未进密集档）下，同一层纯文本标签达到 1024 条时改画到一张 Canvas；`canvas` 不受数量阈值限制，优化档 / 密集档也强制画布并直接用画布尺寸参与避让；`dom` 始终逐条建 `.gis-view__label`。HTML / 元素内容 / 可拖拽 / 可编辑 / 超出 Canvas 样式能力的标签仍走 DOM。只影响容器，不改内容、锚点、显隐以及 `maxCount` / `when` / `scanLimit` 等优化策略，见「标签容器渲染（labelRender）」 |
-| `lineLabel` | `GisViewLineLabelOptions \| GisViewLineLabelOptions[]` | 无 | 线路标签：位置沿线走（比例 / 百分比 / 绝对距离），内容、避让、显隐都可配，与节点标签共用一套避让网格；**写数组就是同一条线上多条标签**，见「线路标签」 |
+| `lineLabel` | `GisViewLineLabelOptions \| GisViewLineLabelOptions[]` | 无 | 线路标签：位置沿线走（比例 / 百分比 / 绝对距离），内容、避让、显隐、层级与缩放字号都可配，与节点标签共用一套避让网格；**写数组就是同一条线上多条标签**，见「线路标签」 |
 | `labelStates` | `GisViewLabelState[]` | 无 | 标签的运行时状态（`getLabelStates()` 的那一份：拖出来的偏移、改过的内容与样式、运行时加的标签、隐藏覆盖）：创建时喂回来就回显，等价于创建之后调 `setLabelStates(states)`；`updateOptions({ labelStates })` 同样认。`exportData({ format: 'input' })` 的结果里就叫 `labelStates`，存档 → 回灌直接接上 |
 | `graphics` | `GisViewGraphic[]` | 无 | 与节点无关的扩展图形：按世界坐标放 SVG 路径 / 图片 / Canvas，支持锚点、偏移、旋转、透明度、`zIndex` 与 `scaleWithView`；位于画布之上、标签之下，运行时用 `addGraphic` / `addGraphics` / `updateGraphic` / `removeGraphic` / `clearGraphics` 增删改，见「扩展图形（graphic）」 |
 | `tooltip` | `GisViewTooltipOptions` | 无 | 悬停提示：点 / 线 / 通道分别配置内容，见「悬浮提示」 |
@@ -58,7 +59,7 @@
 | `boxSelect` | `boolean` | `false` | 是否允许按住框选快捷键（`shortcuts.boxSelect`，默认 Shift）拖动鼠标框选要素；**缺省关**，写 `boxSelect: true` 或 `features: { boxSelect: true }` 才开。框选默认只收节点，`selectionKinds` 可把线路 / 通道也纳入 |
 | `multiSelect` | `boolean` | `false` | 多选开关：打开后不用按修饰键，直接单击节点 / 线路就取反累加选中（与按住 `shortcuts.multiSelect` 点击同一套行为、同一个 `multiSelectStyle`；取反那一下不经过 `onClick`，`onSelectChange.action.type` 是 `toggleSelect`）；**缺省关**，关着时多选走框选（`boxSelect`）与按住多选快捷键（默认 Ctrl / ⌘）。运行时 `updateOptions({ multiSelect })` 切换只重画一帧、不重排场景 |
 | `selectTrigger` | `'click' \| 'dblClick'` | `'click'` | 选中触发方式：`click` 第一次单击就改选中集；`dblClick` 第一下只派发 `onClick`，等双击判定命中的第二下才改选中集，并同时派发 `onClick` 与 `onDblClick`。Ctrl / ⌘ 多选与 `multiSelect` 在双击模式下同样等第二下才取反。运行时走 `updateOptions({ selectTrigger })`，只重画一帧、不重排场景 |
-| `selectionKinds` | `GisViewSelectionKindsInput` | 无（框选只收节点；Ctrl 多选收节点 / 线路 / 通道） | 框选与 Ctrl / 多选点击的类型过滤：`'point'` 节点、`'line'` 通道外的独立线路、`'channel'` 通道回线；可写数组任意组合，`'all'` / `true` 全开，`false` / `null` 全关。通道回线只归 `channel` 管，通道外的线路只归 `line` 管；通道回线仍按 `channelSelectMode` 摊开。不写时保留旧口径；普通单选与 `select` / `selectFeatures` 不受它限制。运行时走 `updateOptions({ selectionKinds })`，见「框选」与「选择类型过滤」 |
+| `selectionKinds` | `GisViewSelectionKindsInput` | 无（框选只收节点；Ctrl 多选收节点 / 线路 / 通道） | 框选与 Ctrl / 多选点击的类型过滤：`'point'` 节点、`'line'` 通道外的独立线路、`'channel'` 通道回线；另有 `'lineEndpoints'` / `'channelEndpoints'`，只在框选时要求线路 / 通道两端节点都在框内。可写数组任意组合，`'all'` / `true` 全开，`false` / `null` 全关。通道回线只归 `channel` 管，通道外的线路只归 `line` 管；通道回线仍按 `channelSelectMode` 摊开。不写时保留旧口径；普通单选与 `select` / `selectFeatures` 不受它限制。运行时走 `updateOptions({ selectionKinds })`，见「框选」与「选择类型过滤」 |
 | `selectionBoxStyle` | `GisViewSelectionBoxStyle` | 蓝底 0.16 透明 + 1px 蓝框 | 框选矩形的填充与边框：`fill`、`fillOpacity`、`stroke`、`strokeWidth` |
 | `selectionOnTop` | `boolean` | `true` | 选中的节点 / 拖动中的整组 / 待确认合并的目标节点，以及选中线路所在的整条通道，是否画在所有要素之上（与 `zIndex` 无关），见「选中 / 拖动的层级」 |
 | `channelSelectMode` | `'line' \| 'group' \| 'channel'` | `'line'` | 通道选中模式：点中通道里的一条回线时选中什么 —— `'line'` 只选这一条、`'group'` 连它所在的分组一起、`'channel'` 整条通道（所有分组的回线）；通道以外的线路永远只选自己。普通点选与 Ctrl / ⌘ + 点击加点共用这一档高亮范围；Ctrl / ⌘ + 点击在 `group` / `channel` 下按整批取反；切换走 `updateOptions({ channelSelectMode })`，只重画一帧、不重排场景，见「通道选中模式」 |
@@ -79,13 +80,16 @@
 | `shortcuts` | `GisViewShortcuts` | 见「快捷键」 | 所有快捷键都可自定义：框选 / 多选 / 加点 / 复制 / 粘贴 / 取消 / 删除 / 适应视图，没写的动作沿用默认值，写 `false` 等于关掉这个动作的快捷键 |
 | `copy` | `GisViewCopyOptions` | 缺省关 | 复制节点（**写了这份配置才算开**，`enabled: false` 显式关掉）：`enabled` 开关、`offset` 落点偏移（默认 `[28, 24]` 像素）、`autoCommit`（交互入口落地前是否自动确认：不写就是落地，`false` 停在预览态等 `commitPointCopy()` / 载荷里的 `payload.commit()`）、`idPrefix`（默认 `copy-`）、`createId` / `createItem` 定制复制品，见「节点复制」 |
 | `remove` | `GisViewRemoveOptions` | 缺省关 | 删除选中的拐点 / 线路 / 节点（**写了这份配置才算开**，`enabled: false` 显式关掉）：`enabled` 开关、`scope`（`confirm()` 不带参数时的缺省范围：`'lines'` 只删选中的回线 / `'groups'` 连所在分组 / `'channels'` 连整条通道，缺省 `'lines'`）、`confirm`（不写停在 `pending` 等使用方裁决 / `false` 直接删 / 函数自行裁决，支持 Promise）。Delete 键与 `requestRemove()` 都先出一份「要删什么、连带什么」的载荷，确认之后才动数据；删节点会连挂在它身上的线路与被它锚定的通道一起删，见「删除（remove）」 |
-| `merge` | `GisViewMergeOptions` | 缺省关 | 合并节点（**写了这份配置才算开**，`enabled: false` 显式关掉）：`enabled` 开关、`trigger` 触发时机（`'collision'` 两个节点半径相碰 / `'center'` 拖动节点中心进入目标节点区域）、`distance` 额外像素容差、`confirm`（不写停在 `pending` 等使用方裁决 / `false` 直接合并 / 函数自行裁决）、`channelGroups`（`'keep'` 各自保留分组 / `'merge'` 合成一个分组）、`createItem` 定制合并结果，见「节点合并」 |
+| `merge` | `GisViewMergeOptions` | 缺省关 | 合并节点（**写了这份配置才算开**，`enabled: false` 显式关掉）：`enabled` 开关、`trigger` 触发时机（`'collision'` 两个节点半径相碰 / `'center'` 拖动节点中心进入目标节点区域）、`distance` 额外像素容差、`confirm`（不写停在 `pending` 等使用方裁决 / `false` 直接合并 / 函数自行裁决）、`channelGroups`（`'keep'` 各自保留分组 / `'merge'` 合成一个分组）、`maxKeys` 选哪些字段取双方最高、`createItem` 定制合并结果，见「节点合并」 |
 | `minScale` / `maxScale` | `number` | `0.002` / `20000` | 缩放范围（像素 / 世界单位） |
 | `fitPadding` | `number` | `48` | 适应视图时四周留白（CSS 像素）；留白比画布还大时按「内容至少留 48px」反过来压留白，不会把内容挤成一个点 |
 | `fitOnInit` | `boolean` | `true` | 首次拿到数据时自动适应视图；配了 `initialView` 时以它为准（`false` 只关掉「适应」，`initialView` 仍然生效，见「初始视图」） |
+| `center` | `GisViewCoordinate` | 无 | 首屏中心 `[x, y]` / `{ x, y }`，是 `initialView.center` 的顶层简写；显式给出非空 `initialView` 时以那一份为准 |
+| `scale` | `number` | 无 | 首屏绝对比例（像素 / 世界单位），是 `initialView.scale` 的顶层简写；显式给出非空 `initialView` 时以那一份为准 |
 | `initialView` | `GisViewInitialView` | 无 | 首次加载的相机落位：中心点、绝对比例、相对放大倍数或要适应的范围，见「初始视图」 |
 | `progressiveInit` | `boolean` | `true` | 大数据（2 万点以上）初始化是否从视图中心向外发散渲染：首帧只排中心附近的一批，剩下的分帧往外补，见「大数据量」 |
 | `statsInterval` | `number` | `250` | `onStats` 的最小间隔（毫秒），`0` 表示每帧都发 |
+| `idleTimeout` | `number` | `0`（关闭） | 用户操作空闲阈值（毫秒）：根节点上这么久没有指针 / 滚轮 / 键盘活动就发一次 `onIdle` / `idle`；每个空闲段只触发一次，恢复操作后重新计时 |
 | `renderEmitInterval` | `number` | `400` | `onRender` 的节流间隔（毫秒），`0` 与 `onStats` 同拍（再配上 `statsInterval: 0` 就是每帧一条） |
 | `plugins` | `GisViewPlugin[]` | `[]` | 插件：`(view, context) => hook`，返回的 `destroy` 在实例销毁时倒序回调，见「插件」 |
 | `zoomStep` | `number` | `1.4` | `zoomIn()` / `zoomOut()` 的步进倍率 |
@@ -108,13 +112,13 @@
 | --- | --- |
 | 总开关与历史 | `features` · `history` |
 | 数据与背景 | `points` · `lines` · `channels` · `pointCluster` · `background` |
-| 通道几何 | `channelWidth` · `channelInset` · `channelNodeWidth` · `channelTangentInset` · `channelMaxGroups` · `channelGroupMaxLines` · `channelDraftStyle` · `channelSelectMode` · `channelWaypointDragMode` |
+| 通道几何 | `channelWidth` · `channelInset` · `channelNodeWidth` · `channelTangentInset` · `channelMaxGroups` · `channelGroupMaxLines` · `channelSimplify` · `channelDraftStyle` · `channelSelectMode` · `channelWaypointDragMode` |
 | 样式与规则 | `pointStyle` · `lineStyle` · `pointRules` / `lineRules` · `heatmap` · `effects` · `lineDirection` · `prebake` · `label` · `labelOptimize` · `labelRender` · `lineLabel` · `labelStates` · `tooltip` · `pointSizeScale` / `lineWidthScale`、`pointZoomScale` / `lineZoomScale`、`zoomBaseScale` · `cursorStyle` · `gridColor` · `gridSize` · `showGrid` |
 | 状态样式与选中 | `pointHoverStyle` / `pointSelectStyle` · `lineHoverStyle` / `lineSelectStyle` · `pointMultiSelectStyle` / `pointBoxSelectStyle` · `lineMultiSelectStyle` · `defaultHighlight` · `selectionBoxStyle` · `selectionOnTop` · `waypointStyle` / `waypointSelectStyle` |
 | 交互开关 | `boxSelect` · `multiSelect` · `selectTrigger` · `waypointEditable` · `waypointVisibility` · `interactive` · `preventContextMenu` · `clickable` · `draggable` · `liveDrag` · `lineFollowsNode` · `shortcuts` · `copy` · `remove` · `merge` |
-| 视图与相机 | `minScale` / `maxScale` · `fitPadding` · `fitOnInit` · `initialView` · `zoomStep` |
+| 视图与相机 | `minScale` / `maxScale` · `fitPadding` · `fitOnInit` · `center` / `scale` · `initialView` · `zoomStep` |
 | 画质与渲染 | `quality` · `width` / `height` · `pixelRatio` · `maxCanvasPixels` · `antialias` · `interactionThinLines` · `interactionNoMsaa` · `renderer` · `webglLayers` |
-| 大数据（筛选 / 搜索 / 读数） | `denseMode` · `filter` · `filterWorker` · `searchWorker` · `progressiveInit` · `statsInterval` · `renderEmitInterval` |
+| 大数据（筛选 / 搜索 / 读数） | `denseMode` · `filter` · `filterWorker` · `searchWorker` · `progressiveInit` · `statsInterval` · `idleTimeout` · `renderEmitInterval` |
 | 外部界面与集成 | `minimap` · `plugins` · `ariaLabel` |
 
 ### 总开关与历史
@@ -276,6 +280,25 @@ view.updateOptions({ channelWidth: 0.08 })   // 没绑节点的那几条跟着
 - **默认值**：`0`
 - **说明**：一个分组最多几条回线（`0` 表示不限）：新增通道时用来判断还能不能并进某一组，见「新增通道」
 
+#### `channelSimplify`
+
+- **类型**：`boolean | GisViewChannelSimplifyOptions`
+- **默认值**：`false`
+- **说明**：通道简略。`true` 使用缺省阈值 `4`；对象写法 `{ enabled, threshold, style }` 本身即开启，只有 `enabled: false` 才关闭。分组回线数**严格大于** `threshold`（向下取整，最小 `1`）时只画该组第一条 `visible !== false` 的回线，其余回线暂不绘制 / 不参与拾取，`getLineStyle()` 对折叠成员返回 `null`。代表线压在分组骨架中线，`style` 按 `GisViewLineStyle` 覆盖颜色、线宽、线型等展示字段。没有 `groups` 的通道按一整组处理；`getData()`、`getChannelGroups()` 与导出始终保留全部回线，关闭后原样恢复。运行时 `updateOptions({ channelSimplify })` 会重解析通道，见「通道简略（channelSimplify）」
+- **参考**：见「通道简略（channelSimplify）」一节，子字段在主表里展开
+- **示例**：
+
+```js
+createGisView(container, {
+  channelSimplify: {
+    enabled: true,
+    threshold: 4,
+    style: { color: '#ff6b35', width: 3, dash: [8, 4] }
+  }
+})
+view.updateOptions({ channelSimplify: false })   // 关闭后全部回线恢复
+```
+
 #### `channelDraftStyle`
 
 - **类型**：`GisViewChannelDraftStyle`
@@ -398,7 +421,7 @@ view.updateOptions({ prebake: { combos: view.getSymbolCombos().combos } })
 
 - **类型**：`GisViewLabelOptions | GisViewLabelOptions[]`
 - **默认值**：无
-- **说明**：节点标签：内容 / 位置 / 显隐 / 避让 / 拖动与编辑都可配，**写数组就是同一个节点上多条标签**，与 `lineLabel` 共用一套避让网格，见「节点标签」
+- **说明**：节点标签：内容 / 位置 / 显隐 / 避让 / 层级 / 缩放字号 / 拖动与编辑都可配，**写数组就是同一个节点上多条标签**，与 `lineLabel` 共用一套避让网格。`zIndex` 显式指定标签层级；`followNodeZIndex: true` 时取节点样式链（节点自身 > 规则 > `pointStyle`）的 `zIndex`，并让更高层节点图标压住这条标签；`zoomScale` 是字号随地图缩放的指数（`0` 固定屏幕字号、`1` 与地图同倍率），见「节点标签」
 - **参考**：见「节点标签」一节，子字段在那里的表里逐个展开
 
 #### `labelOptimize`
@@ -419,7 +442,7 @@ view.updateOptions({ prebake: { combos: view.getSymbolCombos().combos } })
 
 - **类型**：`GisViewLineLabelOptions | GisViewLineLabelOptions[]`
 - **默认值**：无
-- **说明**：线路标签：位置沿线走（比例 / 百分比 / 绝对距离），内容、避让、显隐都可配，与节点标签共用一套避让网格；**写数组就是同一条线上多条标签**，见「线路标签」
+- **说明**：线路标签：位置沿线走（比例 / 百分比 / 绝对距离），内容、避让、显隐、层级与缩放字号都可配，与节点标签共用一套避让网格；**写数组就是同一条线上多条标签**。`zIndex` 决定线路标签之间的先后，`zoomScale` 控制字号是否随地图缩放，见「线路标签」
 - **参考**：见「线路标签」一节，子字段在那里的表里逐个展开
 
 #### `labelStates`
@@ -592,7 +615,7 @@ createGisView(container, {
 
 - **类型**：`boolean`
 - **默认值**：`true`
-- **说明**：选中的节点 / 拖动中的整组 / 待确认合并的目标节点，以及选中线路所在的整条通道，是否画在所有要素之上（与 `zIndex` 无关），见「选中 / 拖动的层级」
+- **说明**：选中的节点 / 拖动中的整组 / 待确认合并的目标节点，以及选中线路所在的整条通道，是否抬层绘制（与 `zIndex` 无关）。选中的线路 / 通道压在普通节点之上，但两端节点会再抬一层压回线路之上，保证端点与线路接头可见；见「选中 / 拖动的层级」
 - **参考**：见「选中 / 拖动的层级（selectionOnTop）」一节，子字段在那里的表里逐个展开
 
 #### 拐点样式（`waypointStyle` / `waypointSelectStyle`）
@@ -652,7 +675,7 @@ view.updateOptions({ selectTrigger: 'click' })
 
 - **类型**：`GisViewSelectionKindsInput`
 - **默认值**：无（框选只收节点；Ctrl 多选仍收节点 / 线路 / 通道）
-- **说明**：限定框选与 Ctrl（⌘）/ `multiSelect` 点击能选中哪几类要素。`'point'` 是节点、`'line'` 是通道外的独立线路、`'channel'` 是通道回线；数组可任意组合，`'all'` / `true` 三类全开，`false` / `null` 三类全关。通道回线只受 `channel` 管、通道外的线路只受 `line` 管；选中通道回线时仍按 `channelSelectMode` 决定只选这一条 / 一组 / 整条通道。**不写时保持旧口径**：框选只收节点，Ctrl / 多选点击收节点与线路；显式写 `selectionKinds` 后两边统一按这份过滤。普通单击与 `select` / `selectFeatures` 接口不受限制；`selectInBox(box, { selectionKinds })` 可一次性覆盖。
+- **说明**：限定框选与 Ctrl（⌘）/ `multiSelect` 点击能选中哪几类要素。`'point'` 是节点、`'line'` 是通道外的独立线路、`'channel'` 是通道回线；`'lineEndpoints'` / `'channelEndpoints'` 是框选专用的另一种口径，要求线路 / 通道自己的两端节点都落在框内，纯 `path`、缺失端点与自环跳过。数组可任意组合，`'all'` / `true` 五档全开，`false` / `null` 全关；新旧线路 / 通道口径并存时取并集。通道回线只受 `channel` 管、通道外的线路只受 `line` 管；选中通道回线时仍按 `channelSelectMode` 决定只选这一条 / 一组 / 整条通道。端点口径不会顺带选中两端节点，也不依赖 `point` 是否开启。**不写时保持旧口径**：框选只收节点，Ctrl / 多选点击收节点与线路；显式写 `selectionKinds` 后框选按完整过滤、Ctrl / 多选点击只认互斥的 `point` / `line` / `channel`。普通单击与 `select` / `selectFeatures` 接口不受限制；`selectInBox(box, { selectionKinds })` 可一次性覆盖。
 - **参考**：见「08 选中与拐点」的「框选」与「选择类型过滤（selectionKinds）」
 - **示例**：
 
@@ -663,9 +686,10 @@ createGisView(container, {
   channelSelectMode: 'channel'          // 真要选通道回线时整条通道一起选
 })
 
-view.updateOptions({ selectionKinds: 'all' })       // 三类全开
+view.updateOptions({ selectionKinds: 'all' })       // 五档全开（节点 / 两类旧口径 / 两类端点口径）
 view.updateOptions({ selectionKinds: false })       // 框选 / Ctrl 多选都不改选中集
 view.selectInBox(rect, { selectionKinds: 'channel' }) // 仅这一次只框通道
+view.selectInBox(rect, { selectionKinds: ['lineEndpoints', 'channelEndpoints'] }) // 只框两端都在框里的线路 / 通道
 ```
 
 #### `waypointEditable`
@@ -790,14 +814,15 @@ view.resolveRemove('all')         // 或 'points' / false
 | `distance` | `number` | `0` | 额外触发容差（CSS 像素）：`collision` 加在两个节点半径之和上，`center` 加在目标节点半径上，负数按 0 处理 |
 | `confirm` | `false \| (payload) => boolean \| void \| Promise<boolean \| void>` | 不写（停在 `pending`） | 确认方式：不写时组件不弹任何界面，等使用方调 `payload.confirm()` / `resolvePointMerge()`；`false` 松手直接合并；函数自行裁决，返回 / resolve `false` 取消，返回 `undefined` 表示继续等使用方接管 |
 | `channelGroups` | `'keep' \| 'merge'` | `'keep'` | 两个节点合并后、两端撞成同一条通道时回线怎么分组：`keep` 各自保留原分组，`merge` 合成一个分组（回线取并集） |
-| `createItem` | `(source, target, context) => GisViewPoint` | 内置合并规则 | 整份接管合并后的节点数据。`context` 含双方数据 / 坐标 / 样式快照 / `lines` / `channels` / `view`；不写时按「目标优先、来源独有字段带过来、尺寸取双方最大、图标优先目标」合并，坐标与 id 始终取保留端 |
+| `maxKeys` | `string[] \| string` | `[]` | 合并后取双方最高值的字段：数组或逗号分隔字符串（去空白、去重），例如 `['vn_kv', 'value']` / `'vn_kv,value'`。只对双方能解析成有限数字的值取 `Math.max`，只有一方有效就用那一方，两边都无效时保持保留节点的原值；其它业务字段全部取保留节点。配了 `createItem` 时不参与 |
+| `createItem` | `(source, target, context) => GisViewPoint` | 内置合并规则 | 整份接管合并后的业务字段。`context` 含双方数据 / 坐标 / 样式快照 / `lines` / `channels` / `view`；不写时以保留节点为底（名称、图标类型等字段取保留端），只有 `maxKeys` 列出的字段取双方最高值（缺省不取），尺寸取双方最大、图标类型用保留端。坐标、id 与 `mergeInfo` 始终由组件维护 |
 
 `merge` **没有 `offset` 字段**：拖拽合并的落点由拖动位置决定，合并后保留端的坐标不会被额外平移；复制品的屏幕偏移属于另一份配置 `copy.offset`（默认 `[28, 24]` 像素），两者不要混写。
 - **参考**：见「节点合并」一节，子字段在那里的表里逐个展开
 - **示例**：
 
 ```js
-createGisView(container, { merge: { enabled: true, trigger: 'center', distance: 6, confirm: false } })
+createGisView(container, { merge: { enabled: true, trigger: 'center', distance: 6, confirm: false, maxKeys: ['vn_kv', 'value'] } })
 view.mergePoints('a', 'b')        // 接口合并
 view.getPointMerge()              // 待确认时读预览
 view.getLine('l1')                 // impact.lineIds 里的 id 按它查线路详情
@@ -824,6 +849,32 @@ view.getChannel('ch-1')            // impact.channelIds 里的 id 按它查通
 - **默认值**：`true`
 - **说明**：首次拿到数据时自动适应视图；配了 `initialView` 时以它为准（`false` 只关掉「适应」，`initialView` 仍然生效，见「初始视图」）
 
+#### `center`
+
+- **类型**：`GisViewCoordinate`
+- **默认值**：无
+- **说明**：首屏中心 `[x, y]` / `{ x, y }`，等价于 `initialView.center`。适合只想在创建时传一个中心点、不想再包一层 `initialView` 的写法；显式给出非空 `initialView` 时整份以 `initialView` 为准，这里的值不参与合并。运行中 `updateOptions({ center })` 会合并到 `initialView`，但和 `initialView` 一样只影响下一次 `applyInitialView()` / 首次落位，不会立刻搬相机；只想马上移动中心用 `setCenter()` / `setCamera({ center })`
+- **参考**：见「初始视图」一节
+- **示例**：
+
+```js
+createGisView(container, { points, center: [500, 300], scale: 2 })
+```
+
+#### `scale`
+
+- **类型**：`number`
+- **默认值**：无
+- **说明**：首屏绝对比例（像素 / 世界单位），等价于 `initialView.scale`，仍然夹在 `minScale` ~ `maxScale` 之间。显式给出非空 `initialView` 时以它为准；运行中 `updateOptions({ scale })` 只改下一次落位，想立刻改当前比例用 `setScale()` / `zoomTo()`。当前读数用 `getScale()` 或 `getCamera().scale`
+- **参考**：见「初始视图」与「缩放范围」两节
+- **示例**：
+
+```js
+const view = createGisView(container, { points, center: [500, 300], scale: 2 })
+view.setScale(3)                       // 运行中立即改比例（锚点缺省视口中心）
+console.log(view.getScale())           // 3
+```
+
 #### `initialView`
 
 - **类型**：`GisViewInitialView`
@@ -992,6 +1043,23 @@ view.setFilter(null)     // 清掉筛选
 - **默认值**：`250`
 - **说明**：`onStats` 的最小间隔（毫秒），`0` 表示每帧都发
 
+#### `idleTimeout`
+
+- **类型**：`number`
+- **默认值**：`0`（关闭）
+- **说明**：用户操作空闲阈值（毫秒）。根节点上超过这么久没有 `pointerdown` / `pointermove` / `pointerup` / `pointercancel` / `wheel` / `keydown`，就回调一次 `onIdle` 并派发 `idle`，载荷是 `{ idleTime, timeout }`。每个空闲段只触发一次，下一次用户操作后重新计时；`getIdleTime()` 随时可读当前空闲时长，不配 `idleTimeout` 也能用。程序化 API 调用不算用户操作、不会重置计时；`updateOptions({ idleTimeout })` 会以这次更新为新的计时起点（写 `0` 关闭）。组件只保留一个定时器，`destroy()` 会清掉它并移除根节点监听
+- **参考**：见「04 事件与回调」的 `onIdle` / `idle` 与「14 视图与筛选」的「比例读写、画布事件与空闲检测」
+- **示例**：
+
+```js
+const view = createGisView(container, {
+  points,
+  idleTimeout: 60000,
+  onIdle: ({ idleTime }) => console.log(`无操作 ${idleTime}ms`)
+})
+console.log(view.getIdleTime())
+```
+
 #### `renderEmitInterval`
 
 - **类型**：`number`