gis-view-webgl2 0.1.4 → 0.1.5

package/docs/AI/345/257/271/350/257/235/346/261/207/346/200/273.md

@@ -364,3 +364,48 @@
 - **交互与方法性能**：定向补丁只在改动可能影响筛选结果时重跑筛选；只改展示字段时沿用原结果，`id` / 坐标 / `from` / `to` / `visible` 与函数 / 自定义运算符条件保持保守重跑。引擎新增定向的通道 / 分组范围测量，`focusOn` 不再为一段范围复制整页通道几何；事件总线在只有一条订阅时直接调用，省掉每次事件分发的快照数组。本轮没有做可信的性能基准，不提供加速倍数。
 - **核心文件**：`src/gis-view/create.js`、`engine.js`、`events.js`、`types.d.ts`、`docs/api/index.html`、`docs/demos/ExtensionDemo.vue`、`docs/demos/SearchFilterDemo.vue`、`docs/demos/ApiCoverageDemo.vue`、`docs/demos/gis-view-demo/useGisViewDemo.js`、`docs/demos/gis-view-demo/panels/OpsPanels.vue`、`docs/demos/gis-view-demo/GisViewDemoCardHeader.vue`、`docs/demos/demos.js`、`docs/demos/api-index.js`（生成物）、`README.md`、`src/gis-view/README.md`、`docs/GisView.md`、`docs/index.html`、`docs/manual/08` / `14` / `15` / `16` / `17` / `18` / `19`、`docs/steps/README.md`、`docs/steps/selftest-features.html` / `selftest-demos.html` / `selftest-docs.html` 与本轮 aimd。
 - **验证**：`selftest-features.html` **672** 条、`selftest-demos.html` **337** 条、`selftest-docs.html` **134** 条，三页共 **1143** 条通过 / 0 失败；`node --check src/gis-view/create.js`、`npx tsc --noEmit`、`npm run build`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`（**256** 个实例成员 = **253** 个方法 + 3 个属性 / **96** 个 options / **16** 个分组 / **250** 个数据字段）与 `git diff --check` 全部通过。复查入口见 [06 的增量记录](ai/06-会话索引与复查方法.md#2026-10-23-增量修改txt四项focuson-缺省居中--文档互跳--扩展命令--性能优化)。
+
+## 2026-10-23 增量（「问题.txt」五项：鹰眼图回线居中 / 动态位置 / backgroundStyle / 主图样式 / 外部挂载）
+
+本轮仍是现有会话的继续增量，没有新建会话归档，因此不改上表的 39 条会话统计。需求原话来自仓库根目录的 `问题.txt`：① 取消通道回线后双回线只显示上面一根，应在两根中间显示；② 支持动态移动整个鹰眼图；③ 检查 `backgroundStyle` 是否生效；④ 沿用主图规则后节点尺寸与图标要和主图一致；⑤ 支持把鹰眼图单独挂到外部 `div`。
+
+- **回线居中代表线**：`channelCircuits: false` 不再按偏移挑最靠中间的成员线；`collectMinimapData()` 取该通道分组当前可见的回线，顶点数一致时逐顶点取平均再画一根。双回线落在两线正中，三回线落在中间线，只剩一根时仍画它自己；路径结构不一致时保守回退第一条可见成员。
+- **动态位置**：新增 `minimap.offset: [x, y]`，相对 `position` 指定的角移动整张鹰眼图，`x` 正数向右、`y` 正数向下，四个角语义统一；`updateOptions({ minimap: { ...old, offset } })` 即时生效，配合新增的 `getMinimapElement()` 可绑定自定义整图拖动。
+- **backgroundStyle**：显式设置 `backgroundStyle` 时由容器接管底色，画布不再铺主图的不透明底色，只画继承 / 独立的图片与 GeoJSON；不写时保持原行为，想要完全透出宿主可写 `transparent`。
+- **沿用主图样式**：`inheritRules` 开启时，节点半径取自引擎最终 `getPointStyle()` 尺寸（圆形按 `CIRCLE_AREA_FACTOR` 还原实际直径），并沿用主图的符号、层级与图标填充 / 描边色。圆、方、图片、SVG 与自定义图元都能显示；异步解码完成的符号会在后续帧补画。
+- **外部挂载**：新增 `minimap.container`，接受元素或 CSS 选择器，把同一根鹰眼图节点移至外部宿主，`position` / `margin` / `offset` 相对该宿主计算；选择器找不到时回落主视图根节点。运行时切换容器只移动节点、不重建画布，`destroy()` 会清理挂载。
+- **核心文件**：`src/gis-view/minimap.js`、`src/gis-view/create.js`、`src/gis-view/engine.js`、`src/gis-view/types.d.ts`、`docs/steps/selftest-full.html`、`docs/internals/13-鹰眼图.md`、`docs/manual/03` / `09` / `14` / `16` / `17` / `18` / `21`、`README.md`、`src/gis-view/README.md`、`docs/GisView.md`、`docs/index.html`、`docs/steps/README.md`、`docs/steps/selftest-docs.html` / `selftest-demos.html`、`docs/demos/api-index.js`（生成物）与本轮 aimd。
+- **验证**：`selftest-full.html` **85** 条、`selftest-docs.html` **134** 条、`selftest-demos.html` **337** 条，三页共 **556** 条通过 / 0 失败。新增 5 条鹰眼图断言覆盖居中代表线、显式底色让画布透明、主图尺寸与 SVG 图标、外部容器挂载、`offset` 动态位移及换容器复用节点。`npx tsc --noEmit`、`node --check`（minimap / create / engine）、`node docs/steps/gen-api-index.mjs --check`、`npm run check:docs`（**257** 个实例成员 = **254** 个方法 + 3 个属性 / **96** 个 options / **250** 个数据字段 / **16** 个分组）、`npm run build` 与 `git diff --check` 全部通过。复查入口见 [06 的增量记录](ai/06-会话索引与复查方法.md#2026-10-23-增量问题txt五项鹰眼图回线居中--动态位置--backgroundstyle--主图样式--外部挂载)。
+
+## 2026-10-23 增量：鹰眼图缩放联动与新增通道示例节点
+
+本轮仍是现有会话的继续增量，没有新建会话归档，因此不改上表的 39 条会话统计。需求原话来自仓库根目录的 `修改.txt` 五项与 `问题.txt` 三项：`修改.txt` ①沿用主图规则后节点要按鹰眼图与主图的比例缩小；②`dragAction: 'box'` 不依赖缩放开关；③新增跟随主图缩放的模式且与手动缩放互斥；④demo 展示指定起点新增，并让 `commitAddChannel` 可直接接收本次新增的通道 / 线路对象；⑤草稿示例点严格落在节点中心、可显隐 / 配样式，示例线路可压到真实节点下面。`问题.txt` ①`auto` 范围随相机收窄改为默认关闭的开关；②补鹰眼图拖拽 demo；③继承节点按主图与小图的视口尺寸比例缩放，不按主图放大倍数缩放。
+
+- **鹰眼节点尺寸与范围**：`collectMinimapData()` 给继承主图尺寸的节点打 `inheritSize`；`inheritedSizeFactor()` 取小图与主图 `getViewport()` 的 CSS 宽、高较小比例，只随两边视口尺寸变化，不随主图 `/` 小图相机倍数漂移。`extentFollowCamera` 默认 `false`，`extent: 'auto'` 固定用「可见数据 ∪ 底图」；只有显式打开后才允许相机落入其中一份时按正在看的那一份收窄。
+- **缩放三态与拖拽**：`zoomable` 统一为 `false` / `true` / `'follow'` 三态互斥：手动缩放、跟随主图、关闭；`followZoomScale` 是主图相对基准倍数的指数（`0` 不跟随、`1` 同倍率），`zoom` 在跟随模式作为基准倍数，`setMinimapZoom` / `zoomMinimapBy` 不抢主图控制权。`dragAction: 'box'` 在缩放关闭时也能直接框选，只有手动缩放才用 Ctrl / ⌘ 切换平移与框选；Demo 提供框选 / 平移两种整图拖拽演示。
+- **新增通道对象入参**：`commitAddChannel` 兼容旧 `resolution`，也可直接传 `GisViewChannel` / `GisViewLine`，或 `{ channel, line, lines, resolution, ... }` 包装对象。对象中的端点、id、名称、路径、分组、样式与业务字段优先，缺省字段继续沿用草稿；直接线路对象除 `COMMIT_LINE_KEYS` 外的颜色 / 线宽 / 线型 / 业务字段都汇入 `lineProps`，直接通道对象支持 `lineIds` / `groups` / `lineProps` / `channelProps`，不会被容器写法误判。
+- **草稿示例点与层级**：`channelDraftStyle.dots` 支持 `false` / `true` / 样式对象，统一设置 `show` / `size` / `color` / `shape`，`from` / `to` 可分别覆盖颜色、尺寸、圆点或方点；示例点固定画在真正点中的节点中心，不受多回线偏移影响。`layer: 'below-points'` 把示例线、箭头与 `customDraw` 画在真实节点之前（端点示例点仍最后画），默认 `above` 保持原层级；草稿 buffer / VAO 一并补上销毁。
+- **Demo 与文档**：`ConnectDemo` 增加指定起点、示例点显隐 / 尺寸 / 形状 / 分端颜色、示例线层级和线路 / 通道对象直传；`MinimapDemo` 增加关闭 / 手动 / 跟随三态、跟随指数、范围开关、框选 / 平移拖拽演示，旧的 `minimapZoomable` 写法统一换成三态配置。同步根 `README.md`、`docs/manual/03` / `10` / `14` / `16` / `17` / `18` / `21`、`docs/internals/13-鹰眼图.md`、`docs/steps/README.md` 与 `docs/demos/api-index.js`（生成物）。
+- **核心文件**：`src/gis-view/minimap.js`、`src/gis-view/create.js`、`src/gis-view/engine.js`、`src/gis-view/types.d.ts`、`docs/demos/ConnectDemo.vue`、`MinimapDemo.vue`、`docs/demos/gis-view-demo/useGisViewDemo.js`、`GisViewDemoStage.vue`、`docs/steps/selftest-full.html`、`selftest-demos.html`、上述手册 / 内部文档与本轮 aimd。
+- **验证**：`selftest-full.html` **86** 条、`selftest-features.html` **672** 条、`selftest-demos.html` **349** 条、`selftest-docs.html` **134** 条，四页共 **1241** 条通过 / 0 失败；新增断言覆盖继承节点不随主图放大、视口尺寸变化重铺、范围开关默认关闭与显式开启、三态跟随、关闭缩放时框选、对象直传与草稿示例点。`npx tsc --noEmit`、`node --check`（minimap / create / engine）、`node docs/steps/gen-api-index.mjs --check`、`npm run check:docs`（**257** 个实例成员 = **254** 个方法 + 3 个属性 / **96** 个 options / **250** 个数据字段 / **43** 个事件 / **17** 个功能开关）、`npm run build` 与 `git diff --check` 全部通过。复查入口见 [06 的增量记录](ai/06-会话索引与复查方法.md#2026-10-23-增量鹰眼图缩放联动与新增通道示例节点)。
+
+## 2026-10-23 增量：鹰眼图继承要素尺寸与地图缩放解耦
+
+本轮仍是现有会话的继续增量，没有新建会话归档，因此不改上表的 39 条会话统计。需求原话来自仓库根目录的 `问题.txt` 三项：① 鹰眼图的范围跟随相机改为默认关闭；② 补鹰眼图拖拽 demo；③ 澄清「节点随主视图缩放」只指沿用主图规则时的节点 / 线路尺寸。复核确认 ① / ② 已在当前工作树实现，本轮补齐 ③：继承节点 / 线路按「小图视口 ÷ 主图视口」的较小比例缩放，独立于主图相机倍数和鹰眼图自身倍数；主图放大不改变它们，鹰眼图自身放大时才由 `pointZoomScale` / `lineZoomScale` 联动。
+
+- **继承线宽**：`line.js` 的 `resolveLineStyleInto()` 记录样式链原始宽度 `baseWidth`（不含热力倍数 / 整体倍数 / 缩放联动），`engine.js` 新增内部 `getLineStyle(index)` 快照；`create.js` 在沿用主图线路时写入 `entry.width` 并标记 `inheritWidth`，与节点的 `inheritSize` 走同一份视口比例。
+- **缩放拆层**：`minimap.js` 对继承节点使用 `pointSizeScale × pointZoomScale × inheritedSizeFactor()`，对继承线路使用 `lineWidthScale × lineZoomScale × inheritedSizeFactor()`；`pointMapZoomScale` / `lineMapZoomScale` 只作用于小图自有规则 / 样式。点 / 线路缓存键同步包含各自系数，没有继承线路时继承系数固定为 1。
+- **Demo 与文档**：`MinimapDemo` 默认切到沿用主图，拆分节点 / 线路整体倍数与小图缩放指数控件，并保留框选 / 平移拖拽演示；主 demo 在沿用模式下禁用「节点跟主图 / 线路跟主图」并更新提示。同步 `types.d.ts` 注释、根 `README.md`、`src/gis-view/README.md`、`docs/manual/03` / `14`、`docs/internals/13-鹰眼图.md`，重新生成 `docs/demos/api-index.js`。
+- **核心文件**：`src/gis-view/line.js`、`src/gis-view/engine.js`、`src/gis-view/create.js`、`src/gis-view/minimap.js`、`src/gis-view/types.d.ts`、`docs/demos/MinimapDemo.vue`、`docs/demos/gis-view-demo/GisViewDemoStage.vue`、`docs/demos/gis-view-demo/useGisViewDemo.js`、`docs/steps/selftest-full.html`、`docs/steps/selftest-demos.html` 与本轮文档。
+- **验证**：`selftest-full.html` **92** 条、`selftest-features.html` **672** 条、`selftest-demos.html` **351** 条、`selftest-docs.html` **134** 条，四页共 **1249** 条通过 / 0 失败；新增 8 条断言覆盖继承线路 / 节点在主图放大时尺寸不变、`pointSizeScale` / `lineWidthScale` 对继承要素生效、小图自身放大按 `pointZoomScale` / `lineZoomScale` 联动，以及 demo 两个独立整体倍数控件。`npx tsc --noEmit`、`node --check`（minimap / create / engine / line）、`node docs/steps/gen-api-index.mjs --check`、`npm run check:docs`（**257** 个实例成员 = **254** 个方法 + 3 个属性 / **96** 个 options / **250** 个数据字段 / **43** 个事件 / **17** 个功能开关）、`npm run build` 与 `git diff --check` 全部通过。复查入口见 [06 的增量记录](ai/06-会话索引与复查方法.md#2026-10-23-增量鹰眼图继承要素尺寸与地图缩放解耦)。
+
+## 2026-10-23 增量（「修改.txt」三项：commitAddChannel 文档 / 传参示例 / 线路半跳过）
+
+本轮仍是现有会话的继续增量，没有新建会话归档，因此不改上表的 39 条会话统计。需求原话来自仓库根目录的 `修改.txt` 三项：① 说明 `commitAddChannel` 有哪些传参、支持哪些写法；② 把方法用法、传参和示例写详细；③ 继续优化组件性能。
+
+- **`commitAddChannel` 入参口径**：手册 `10` 的「对象直传」扩写为五种写法：无参、旧 resolution、直接线路对象、直接通道对象（必须有 `lineIds`）、容器（`channel` / `line` / `lines` / `lineData` / `lineItems` / `channelGroups` / `group` / `channelProps` / `lineProps` / `resolution`）。明确草稿只支持 `from`、没有 `to`；`line` 缺省是独立线路，`lines` 才是成员回线表；空数组沿用草稿；直接通道的 `id` 只是通道 id，回线 id 来自 `lineIds`；直接通道自己的 `lineProps` 生效，容器里的 `channel.lineProps` 不合并；分组优先级 `channelGroups > group > channel.groups`；并进已有通道 / 分组要用容器并显式写 `resolution`。
+- **示例与错误说明**：`ready` 里的方案读数不能整条回传，统一只取 `{ type, groupId, groupIndex, channelId }` 子集；删除“整条 option 可直接提交”的旧示例。`groups[].lineIds` 写了本次未生成的 id 改为 warning + 按成员表调和，不再列为失败原因；返回结果的 `channelIndex` 改为“成功时为通道下标、独立线路为 -1，失败通常不返回，事件载荷按 -1 兜底”。同步扩写 `18` 的逐方法示例（五种写法、只给 `channel.lineIds`、容器逐条字段、空数组、端点 / 路由覆盖、并组、连续提交、结果读取），并细化 `16` / `17` 与 `types.d.ts` 的 JSDoc。
+- **线路半跳过**：`engine.js` 在节点半跳过成立后，再核对线路数组与通道声明逐元素同引用、隐藏集合 / 通道车道输入 / 线路与状态样式快照未变，且没有追加补点补线；命中时跳过 `resolveLines`、线路索引、虚线槽位、层序与线路包围盒重算，直接复用上一轮线路半包围盒。追加补线与拖点 / 拐点 / 通道骨架等增量改线会把新路径并进缓存；没有可信读数时记 `lineHalfOutOfSync`，下一轮放弃跳过。`selftest-perf.html` 新增 3 条断言：同一批点线连交 5 次条数与线路实例数不变、通道声明未变时回线派生折线原样保留、换通道骨架时线路几何必须重推。
+- **实测**：20000 点 / 8000 线同一批对象回灌 5 次取中位，**14.3 ms → 6.3 ms**（优化后 5.6 / 6.3 / 6.3 / 6.4 / 10.7 ms）。
+- **核心文件**：`src/gis-view/engine.js`、`src/gis-view/types.d.ts`、`docs/manual/10` / `16` / `17` / `18`、`docs/steps/selftest-perf.html`、`docs/internals/16-01-优化与取舍-上.md`、`docs/internals/18-性能实测与WebGPU评估.md`、`docs/demos/api-index.js`（生成物）、本轮 aimd。
+- **验证**：`node --check`（engine / create）、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`（**257** 个实例成员 = **254** 个方法 + 3 个属性 / **96** 个 options / **250** 个数据字段 / **43** 个事件 / **17** 个功能开关）、五页自测 `full 92` + `features 672` + `demos 351` + `docs 134` + `perf 167` = **1416** 条通过 / 0 失败、`npx tsc --noEmit`、`npm run build` 与 `git diff --check` 全部通过。复查入口见 [06 的增量记录](ai/06-会话索引与复查方法.md#2026-10-23-增量修改txt三项commitaddchannel-文档--传参示例--线路半跳过)。

package/docs/GisView.md

@@ -1,53 +1,53 @@
-# GisView
-
-`GisView` 是一套不依赖任何第三方图形库的 WebGL2 矢量视图：渲染层是原生 WebGL2（GLSL ES 3.00 + 实例化绘制），交互层只有指针与滚轮，界面只内置可选的小地图（配 `minimap` 才有，见「鹰眼图」），其余全靠使用方。它没有 Vue 组件形态，用 `createGisView(dom, options)` 把画布直接挂到传入的 DOM 上，宽高默认跟随容器。
-
-控制面板、读数面板、图例这类视图工具都不内置：组件只提供画布与实例方法，样式和布局完全由使用方决定，后续改样式不需要等待组件升级。数据侧该有的都给了：按属性筛选（默认只隐藏，也可显式从数据删除；点被过滤时绑定线路与通道一起消失，大数据量走 Web Worker）、按属性批量配色换符号、节点标签与点 / 线 / 通道的悬浮提示，都可以通过 options 或实例方法配置。
-
-**这份手册按主题拆成了 21 章，正文在 [`docs/manual/`](manual/) 下**：找方法先看 [16 实例方法总表](manual/16-实例方法总表.md)，查参数跳 [17 参数速查](manual/17-参数速查.md)，要能直接复制的调用看 [18 逐方法示例](manual/18-逐方法示例.md)；只想先跑起来看 [01 快速开始](manual/01-快速开始.md)。
-
-- 想在页面上按方法名搜、直接看示例：打开 [API 速查（方法 + 示例）](api/index.html)（清单就是从 17 / 18 两章生成的；支持深浅主题、左侧分组跟随与 `#成员名` 深链）；要边改边跑用 [调试演示页](playground/index.html)。
-- 「某个特性怎么实现、为什么这么做」看 [GisView 实现原理](GisView实现原理.md)；数据的标准写法与五套口径看 [数据格式](数据格式.md)。
-- 复制 / 合并 / 通道分组 / 拐点要接真实后端：请求头、body、成功响应、409 / 500、幂等与前端重试流程看 [编辑接口协议](接口协议.md)；成功响应怎么落到本地数据（`idMap` 改写、合并对账、分组 / 拐点覆盖、409 局部恢复）见其中的「前端落地映射」。
-- 后端 DTO 与内置列名不一致时，不必改组件：用 `defineExportFormat`（或底层的 `registerExportFormat`）注册一个同步导出格式，把标准文档映射成自己的表结构，见 [自定义导出格式](manual/15-导出与集成.md#自定义导出格式后端-dto)。
-- 想照着源码从零写一遍看 [从 0 到完整的实现](从0到完整的实现.md)；逐文件的教程与自测页在 [docs/steps](steps/README.md)（页面：[docs/steps/index.html](steps/index.html)）。
-
-## 手册目录
-
-| 章 | 讲什么 |
-| --- | --- |
-| [01 快速开始](manual/01-快速开始.md) | 引入与最小示例：装什么、怎么把画布挂到 DOM 上 |
-| [02 坐标与数据](manual/02-坐标与数据.md) | 世界坐标 / 经纬度映射、相机与像素、数据字段全表 |
-| [03 配置项（options）](manual/03-配置项.md) | 全部 options 的总表与逐个详解（默认值、落点、相关开关） |
-| [04 事件与回调](manual/04-事件与回调.md) | 回调清单、事件订阅、两层功能开关、配置提醒 |
-| [05 画质与批量更新](manual/05-画质与批量更新.md) | quality 四档与自动升降；batch 把一批改动作一次提交 |
-| [06 数据与场景更新](manual/06-数据与场景更新.md) | 整份换数据 / 增量追加 / 加载完成回调 / 按方法新增要素 / 历史 |
-| [07 指针与要素编辑](manual/07-指针与要素编辑.md) | 点击与样式、指针事件全字段、光标、拖拽点、复制 / 合并 / 删除 |
-| [08 选中与拐点](manual/08-选中与拐点.md) | 选中与拖动的层级、框选、接口选中、线路拐点的增删改 |
-| [09 通道与多回线](manual/09-通道与多回线.md) | 通道的数据结构、createChannels 批量生成、分组与选中模式 |
-| [10 通道编辑与新增](manual/10-通道编辑与新增.md) | 分组拐点的增删、右键交互框、新增通道的草稿流程、改名与增删回线 |
-| [11 样式与规则](manual/11-样式与规则.md) | 点配置、线配置、条件语言（筛选 / 规则 / 标签共用）与批量样式规则 |
-| [12 标签与装饰](manual/12-标签与装饰.md) | 节点 / 线路标签、标签拖动与编辑、节点与线路装饰、动态装饰器草稿、悬浮提示 |
-| [13 动效与图元](manual/13-动效与图元.md) | 热力图、动画效果、线路方向箭头、贴图预热与自定义图元 |
-| [14 视图与筛选](manual/14-视图与筛选.md) | 筛选、搜索定位、初始视图与缩放范围、背景层、鹰眼图、近义入口 |
-| [15 导出与集成](manual/15-导出与集成.md) | 导出图片 / 选中节点 / 数据、自定义导出格式，插件、自建界面与键盘交互 |
-| [16 实例方法总表](manual/16-实例方法总表.md) | 按功能分组的实例方法主表（找方法从这一章开始） |
-| [17 参数速查（逐个方法）](manual/17-参数速查.md) | 256 个成员逐个列全：参数、默认值与返回 |
-| [18 逐方法示例（复制就能跑）](manual/18-逐方法示例.md) | 每个成员一段可复制的调用示例（API 速查页读的就是这一章） |
-| [19 读数与拖拽预览](manual/19-读数与拖拽预览.md) | 自建界面常用的读数 / 定位方法；拖拽落点预览 |
-| [20 性能与大数据](manual/20-性能与大数据.md) | 十万级数据的开关与实测、WebGPU 取舍、渲染后端开关 |
-| [21 说明与常见问题](manual/21-说明与常见问题.md) | 边界与口径、FAQ、类型定义索引 |
-
-## 快速跳转（按任务）
-
-- **上手**：[引入](manual/01-快速开始.md#引入) · [基础用法](manual/01-快速开始.md#基础用法) · [坐标与数据](manual/02-坐标与数据.md)
-- **配置与回调**：[options 总表](manual/03-配置项.md#options) · [回调](manual/04-事件与回调.md#回调) · [功能开关](manual/04-事件与回调.md#功能开关)
-- **通道**：[通道与多回线](manual/09-通道与多回线.md) · [通道编辑与新增](manual/10-通道编辑与新增.md) · [分组拐点](manual/10-通道编辑与新增.md#分组拐点把某一组拉走)
-- **样式**：[点配置](manual/11-样式与规则.md#点配置) · [线配置](manual/11-样式与规则.md#线配置) · [条件语言](manual/11-样式与规则.md#条件语言) · [批量样式规则](manual/11-样式与规则.md#批量样式规则)
-- **标签与动效**：[节点标签](manual/12-标签与装饰.md#节点标签) · [线路标签](manual/12-标签与装饰.md#线路标签) · [标签优化](manual/12-标签与装饰.md#标签显示优化开关labeloptimize) · [扩展图形](manual/12-标签与装饰.md#扩展图形graphic) · [节点装饰](manual/12-标签与装饰.md#节点上的装饰图片--svg) · [线路装饰](manual/12-标签与装饰.md#线路上的装饰图片--svg) · [手动删除装饰](manual/12-标签与装饰.md#手动删除装饰) · [动态装饰器](manual/12-标签与装饰.md#动态装饰器草稿) · [动画效果](manual/13-动效与图元.md#动画效果effects) · [自定义图元](manual/13-动效与图元.md#自定义图元)
-- **视图**：[筛选](manual/14-视图与筛选.md#筛选) · [搜索与定位](manual/14-视图与筛选.md#搜索与定位) · [适应视图的节点间距](manual/14-视图与筛选.md#适应视图的节点间距fitspacing) · [背景层](manual/14-视图与筛选.md#背景层) · [鹰眼图](manual/14-视图与筛选.md#鹰眼图)
-- **导出与集成**：[导出数据](manual/15-导出与集成.md#导出数据) · [自定义导出格式](manual/15-导出与集成.md#自定义导出格式后端-dto) · [插件](manual/15-导出与集成.md#插件) · [实例命令](manual/15-导出与集成.md#实例命令) · [六类扩展点怎么选](manual/15-导出与集成.md#六类扩展点怎么选) · [自建界面](manual/15-导出与集成.md#自建界面)
-- **查方法**：[实例方法总表](manual/16-实例方法总表.md) · [参数速查](manual/17-参数速查.md) · [逐方法示例](manual/18-逐方法示例.md) · [读数与拖拽预览](manual/19-读数与拖拽预览.md)
-- **概念与排查**：[大数据展示模式（denseMode）](manual/20-性能与大数据.md#大数据展示模式densemode) · [大数据量](manual/20-性能与大数据.md#大数据量) · [常见问题](manual/21-说明与常见问题.md#常见问题) · [类型定义索引](manual/21-说明与常见问题.md#类型定义索引)
-
-> 本页也可以从文档中心（`docs/index.html`）打开：左侧清单里 `GisView.md` 是这一页，下面紧跟着 21 章手册。
+# GisView
+
+`GisView` 是一套不依赖任何第三方图形库的 WebGL2 矢量视图：渲染层是原生 WebGL2（GLSL ES 3.00 + 实例化绘制），交互层只有指针与滚轮，界面只内置可选的小地图（配 `minimap` 才有，见「鹰眼图」），其余全靠使用方。它没有 Vue 组件形态，用 `createGisView(dom, options)` 把画布直接挂到传入的 DOM 上，宽高默认跟随容器。
+
+控制面板、读数面板、图例这类视图工具都不内置：组件只提供画布与实例方法，样式和布局完全由使用方决定，后续改样式不需要等待组件升级。数据侧该有的都给了：按属性筛选（默认只隐藏，也可显式从数据删除；点被过滤时绑定线路与通道一起消失，大数据量走 Web Worker）、按属性批量配色换符号、节点标签与点 / 线 / 通道的悬浮提示，都可以通过 options 或实例方法配置。
+
+**这份手册按主题拆成了 21 章，正文在 [`docs/manual/`](manual/) 下**：找方法先看 [16 实例方法总表](manual/16-实例方法总表.md)，查参数跳 [17 参数速查](manual/17-参数速查.md)，要能直接复制的调用看 [18 逐方法示例](manual/18-逐方法示例.md)；只想先跑起来看 [01 快速开始](manual/01-快速开始.md)。
+
+- 想在页面上按方法名搜、直接看示例：打开 [API 速查（方法 + 示例）](api/index.html)（清单就是从 17 / 18 两章生成的；支持深浅主题、左侧分组跟随与 `#成员名` 深链）；要边改边跑用 [调试演示页](playground/index.html)。
+- 「某个特性怎么实现、为什么这么做」看 [GisView 实现原理](GisView实现原理.md)；数据的标准写法与五套口径看 [数据格式](数据格式.md)。
+- 复制 / 合并 / 通道分组 / 拐点要接真实后端：请求头、body、成功响应、409 / 500、幂等与前端重试流程看 [编辑接口协议](接口协议.md)；成功响应怎么落到本地数据（`idMap` 改写、合并对账、分组 / 拐点覆盖、409 局部恢复）见其中的「前端落地映射」。
+- 后端 DTO 与内置列名不一致时，不必改组件：用 `defineExportFormat`（或底层的 `registerExportFormat`）注册一个同步导出格式，把标准文档映射成自己的表结构，见 [自定义导出格式](manual/15-导出与集成.md#自定义导出格式后端-dto)。
+- 想照着源码从零写一遍看 [从 0 到完整的实现](从0到完整的实现.md)；逐文件的教程与自测页在 [docs/steps](steps/README.md)（页面：[docs/steps/index.html](steps/index.html)）。
+
+## 手册目录
+
+| 章 | 讲什么 |
+| --- | --- |
+| [01 快速开始](manual/01-快速开始.md) | 引入与最小示例：装什么、怎么把画布挂到 DOM 上 |
+| [02 坐标与数据](manual/02-坐标与数据.md) | 世界坐标 / 经纬度映射、相机与像素、数据字段全表 |
+| [03 配置项（options）](manual/03-配置项.md) | 全部 options 的总表与逐个详解（默认值、落点、相关开关） |
+| [04 事件与回调](manual/04-事件与回调.md) | 回调清单、事件订阅、两层功能开关、配置提醒 |
+| [05 画质与批量更新](manual/05-画质与批量更新.md) | quality 四档与自动升降；batch 把一批改动作一次提交 |
+| [06 数据与场景更新](manual/06-数据与场景更新.md) | 整份换数据 / 增量追加 / 加载完成回调 / 按方法新增要素 / 历史 |
+| [07 指针与要素编辑](manual/07-指针与要素编辑.md) | 点击与样式、指针事件全字段、光标、拖拽点、复制 / 合并 / 删除 |
+| [08 选中与拐点](manual/08-选中与拐点.md) | 选中与拖动的层级、框选、接口选中、线路拐点的增删改 |
+| [09 通道与多回线](manual/09-通道与多回线.md) | 通道的数据结构、createChannels 批量生成、分组与选中模式 |
+| [10 通道编辑与新增](manual/10-通道编辑与新增.md) | 分组拐点的增删、右键交互框、新增通道的草稿流程、改名与增删回线 |
+| [11 样式与规则](manual/11-样式与规则.md) | 点配置、线配置、条件语言（筛选 / 规则 / 标签共用）与批量样式规则 |
+| [12 标签与装饰](manual/12-标签与装饰.md) | 节点 / 线路标签、标签拖动与编辑、节点与线路装饰、动态装饰器草稿、悬浮提示 |
+| [13 动效与图元](manual/13-动效与图元.md) | 热力图、动画效果、线路方向箭头、贴图预热与自定义图元 |
+| [14 视图与筛选](manual/14-视图与筛选.md) | 筛选、搜索定位、初始视图与缩放范围、背景层、鹰眼图、近义入口 |
+| [15 导出与集成](manual/15-导出与集成.md) | 导出图片 / 选中节点 / 数据、自定义导出格式，插件、自建界面与键盘交互 |
+| [16 实例方法总表](manual/16-实例方法总表.md) | 按功能分组的实例方法主表（找方法从这一章开始） |
+| [17 参数速查（逐个方法）](manual/17-参数速查.md) | 257 个成员逐个列全：参数、默认值与返回 |
+| [18 逐方法示例（复制就能跑）](manual/18-逐方法示例.md) | 每个成员一段可复制的调用示例（API 速查页读的就是这一章） |
+| [19 读数与拖拽预览](manual/19-读数与拖拽预览.md) | 自建界面常用的读数 / 定位方法；拖拽落点预览 |
+| [20 性能与大数据](manual/20-性能与大数据.md) | 十万级数据的开关与实测、WebGPU 取舍、渲染后端开关 |
+| [21 说明与常见问题](manual/21-说明与常见问题.md) | 边界与口径、FAQ、类型定义索引 |
+
+## 快速跳转（按任务）
+
+- **上手**：[引入](manual/01-快速开始.md#引入) · [基础用法](manual/01-快速开始.md#基础用法) · [坐标与数据](manual/02-坐标与数据.md)
+- **配置与回调**：[options 总表](manual/03-配置项.md#options) · [回调](manual/04-事件与回调.md#回调) · [功能开关](manual/04-事件与回调.md#功能开关)
+- **通道**：[通道与多回线](manual/09-通道与多回线.md) · [通道编辑与新增](manual/10-通道编辑与新增.md) · [分组拐点](manual/10-通道编辑与新增.md#分组拐点把某一组拉走)
+- **样式**：[点配置](manual/11-样式与规则.md#点配置) · [线配置](manual/11-样式与规则.md#线配置) · [条件语言](manual/11-样式与规则.md#条件语言) · [批量样式规则](manual/11-样式与规则.md#批量样式规则)
+- **标签与动效**：[节点标签](manual/12-标签与装饰.md#节点标签) · [线路标签](manual/12-标签与装饰.md#线路标签) · [标签优化](manual/12-标签与装饰.md#标签显示优化开关labeloptimize) · [扩展图形](manual/12-标签与装饰.md#扩展图形graphic) · [节点装饰](manual/12-标签与装饰.md#节点上的装饰图片--svg) · [线路装饰](manual/12-标签与装饰.md#线路上的装饰图片--svg) · [手动删除装饰](manual/12-标签与装饰.md#手动删除装饰) · [动态装饰器](manual/12-标签与装饰.md#动态装饰器草稿) · [动画效果](manual/13-动效与图元.md#动画效果effects) · [自定义图元](manual/13-动效与图元.md#自定义图元)
+- **视图**：[筛选](manual/14-视图与筛选.md#筛选) · [搜索与定位](manual/14-视图与筛选.md#搜索与定位) · [适应视图的节点间距](manual/14-视图与筛选.md#适应视图的节点间距fitspacing) · [背景层](manual/14-视图与筛选.md#背景层) · [鹰眼图](manual/14-视图与筛选.md#鹰眼图)
+- **导出与集成**：[导出数据](manual/15-导出与集成.md#导出数据) · [自定义导出格式](manual/15-导出与集成.md#自定义导出格式后端-dto) · [插件](manual/15-导出与集成.md#插件) · [实例命令](manual/15-导出与集成.md#实例命令) · [六类扩展点怎么选](manual/15-导出与集成.md#六类扩展点怎么选) · [自建界面](manual/15-导出与集成.md#自建界面)
+- **查方法**：[实例方法总表](manual/16-实例方法总表.md) · [参数速查](manual/17-参数速查.md) · [逐方法示例](manual/18-逐方法示例.md) · [读数与拖拽预览](manual/19-读数与拖拽预览.md)
+- **概念与排查**：[大数据展示模式（denseMode）](manual/20-性能与大数据.md#大数据展示模式densemode) · [大数据量](manual/20-性能与大数据.md#大数据量) · [常见问题](manual/21-说明与常见问题.md#常见问题) · [类型定义索引](manual/21-说明与常见问题.md#类型定义索引)
+
+> 本页也可以从文档中心（`docs/index.html`）打开：左侧清单里 `GisView.md` 是这一页，下面紧跟着 21 章手册。

package/docs/ai/06-/344/274/232/350/257/235/347/264/242/345/274/225/344/270/216/345/244/215/346/237/245/346/226/271/346/263/225.md

@@ -357,6 +357,42 @@
 - **核心文件**：`src/gis-view/create.js`、`engine.js`、`events.js`、`types.d.ts`、`docs/api/index.html`、`docs/demos/ExtensionDemo.vue`、`SearchFilterDemo.vue`、`ApiCoverageDemo.vue`、`gis-view-demo/useGisViewDemo.js`、`gis-view-demo/panels/OpsPanels.vue`、`gis-view-demo/GisViewDemoCardHeader.vue`、`demos.js`、`api-index.js`（生成物）、`README.md`、`src/gis-view/README.md`、`docs/GisView.md`、`docs/index.html`、`docs/manual/08` / `14` / `15` / `16` / `17` / `18` / `19`、`docs/steps/README.md`、`docs/steps/selftest-features.html` / `selftest-demos.html` / `selftest-docs.html` 与本轮 aimd。
 - **验证**：`selftest-features.html` **672** 条、`selftest-demos.html` **337** 条、`selftest-docs.html` **134** 条，三页共 **1143** 条通过 / 0 失败；`node --check src/gis-view/create.js`、`npx tsc --noEmit`、`npm run build`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`（256 个实例成员 = 253 个方法 + 3 个属性 / 96 个 options / 16 个分组 / 250 个数据字段）与 `git diff --check` 全部通过。详细口径见 [AI 对话汇总的本轮增量](../AI对话汇总.md#2026-10-23-增量修改txt四项focuson-缺省居中--文档互跳--扩展命令--性能优化)。
 
+### 2026-10-23 增量（「问题.txt」五项：鹰眼图回线居中 / 动态位置 / backgroundStyle / 主图样式 / 外部挂载）
+
+本轮仍是现有会话的继续增量，没有独立会话归档，因此不改上表的 39 条统计。需求原话来自仓库根目录的 `问题.txt`：取消通道回线后双回线应居中、支持动态移动鹰眼图、确认 `backgroundStyle` 生效、沿用主图后节点尺寸与图标一致、支持挂到外部 `div`。
+
+- **回线居中**：`create.js` 的 `averageMinimapPaths()` 在当前可见成员间逐顶点平均，`channelCircuits: false` 只画一根居中代表线；双回线位于两线中间，三回线落在中间线，成员只剩一条时原样保留，路径结构不一致时保守回退第一条可见路径。
+- **动态位置与外部挂载**：`minimap.offset` 使用统一的正向右 / 正向下位移，`updateOptions` 可即时移动；`minimap.container` 支持元素或选择器，`syncAttachment()` 只移动同一根节点；新增 `getMinimapElement()` 供宿主绑定整图拖动。宿主需要定位上下文，选择器失效时回落主视图根节点。
+- **backgroundStyle 与主图样式**：显式 `backgroundStyle` 时画布不再铺不透明主图底色，保留图片 / GeoJSON；`inheritRules` 的节点尺寸与符号改为取主图最终 `getPointStyle()` 结果，圆形用 `CIRCLE_AREA_FACTOR` 还原，图片 / SVG / 自定义图元支持异步加载后补画。
+- **文档与验证**：同步手册 `03` / `09` / `14` / `16` / `17` / `18` / `21`、`docs/internals/13-鹰眼图.md`、根 `README.md`、`src/gis-view/README.md`、`docs/GisView.md` 与文档索引；`selftest-full.html` 增加 5 条断言。`selftest-full.html` **85** 条、`selftest-docs.html` **134** 条、`selftest-demos.html` **337** 条，三页共 **556** 条通过 / 0 失败；`npx tsc --noEmit`、`node --check`（minimap / create / engine）、`node docs/steps/gen-api-index.mjs --check`、`npm run check:docs`（**257** 个实例成员 = **254** 个方法 + 3 个属性 / **96** 个 options / **250** 个数据字段 / **16** 个分组）、`npm run build` 与 `git diff --check` 全部通过。详细口径见 [AI 对话汇总的本轮增量](../AI对话汇总.md#2026-10-23-增量问题txt五项鹰眼图回线居中--动态位置--backgroundstyle--主图样式--外部挂载)。
+
+### 2026-10-23 增量：鹰眼图缩放联动与新增通道示例节点
+
+本轮仍是现有会话的继续增量，没有独立会话归档，因此不改上表的 39 条统计。需求原话来自仓库根目录的 `修改.txt` 五项与 `问题.txt` 三项：沿用主图规则后节点按鹰眼图 / 主图比例缩放、`box` 拖拽不再依赖缩放、增加与手动缩放互斥的跟随主图模式、`commitAddChannel` 直接接收新增对象、草稿示例点居中且可配、`auto` 范围跟相机改为默认关闭、补鹰眼图拖拽 demo，以及继承节点按两边视口尺寸而不是主图放大倍数缩放。
+
+- **鹰眼图**：`minimap.js` 的 `inheritedSizeFactor()` 改用两边 CSS 视口宽高的较小比例，`inheritSize` 节点不再跟主图相机倍数变化；`extentFollowCamera` 默认 `false`，`extent: 'auto'` 默认保持「数据 ∪ 底图」；`zoomable` 三态为 `false` / `true` / `'follow'`，`followZoomScale` 控制跟随指数，手动缩放与跟随互斥，跟随档不接受 `setMinimapZoom` / `zoomMinimapBy` 抢控制；`dragAction: 'box'` 在关闭缩放时也可用。
+- **新增通道**：`commitAddChannel` 增加对象入参，直接给通道 / 线路或 `{ channel, line, lines, ... }` 均可；对象字段优先、缺省续用草稿，直接线路的业务字段与样式透传到 `lineProps`，直接通道支持 `lineIds` / `groups` / `lineProps` / `channelProps`。草稿示例点固定在真实节点中心，`dots` 支持显隐 / 分端样式 / 尺寸 / 圆方形状，`channelDraftStyle.layer` 可设 `'below-points'` 让示例线压在真实节点下面。
+- **Demo 与文档**：`ConnectDemo` 展示指定起点、示例点样式与对象直传；`MinimapDemo` 展示三态缩放、跟随指数、范围开关与框选 / 平移拖拽。同步 `README.md`、`docs/manual/03` / `10` / `14` / `16` / `17` / `18` / `21`、`docs/internals/13-鹰眼图.md`、`docs/steps/README.md` 和 `docs/demos/api-index.js`。
+- **验证**：`selftest-full.html` **86** 条、`selftest-features.html` **672** 条、`selftest-demos.html` **349** 条、`selftest-docs.html` **134** 条，四页共 **1241** 条通过 / 0 失败；`npx tsc --noEmit`、`node --check`（minimap / create / engine）、`node docs/steps/gen-api-index.mjs --check`、`npm run check:docs`（257 个实例成员 / 96 个 options / 250 个数据字段 / 43 个事件 / 17 个功能开关）、`npm run build` 与 `git diff --check` 全部通过。详细口径见 [AI 对话汇总的本轮增量](../AI对话汇总.md#2026-10-23-增量鹰眼图缩放联动与新增通道示例节点)。
+
+### 2026-10-23 增量：鹰眼图继承要素尺寸与地图缩放解耦
+
+本轮仍是现有会话的继续增量，没有独立会话归档，因此不改上表的 39 条统计。需求原话来自仓库根目录的 `问题.txt` 三项：范围跟随相机默认关闭、补鹰眼图拖拽 demo、澄清继承节点 / 线路的尺寸语义。前两项已在当前工作树实现；本轮完成第三项，把继承尺寸与主图相机倍数彻底解耦。
+
+- **继承线宽**：`resolveLineStyleInto()` 新增 `baseWidth`，`engine.getLineStyle(index)` 返回样式链原始线宽；`collectMinimapData()` 在未配自有 `lineRules` 时写入继承线宽并标记 `inheritWidth`，与节点的 `inheritSize` 一样乘两边 CSS 视口的较小比例。
+- **缩放口径**：继承节点 = `pointSizeScale × 小图自身缩放指数 × 视口比例`，继承线路 = `lineWidthScale × 小图自身缩放指数 × 视口比例`；主图缩放不进入这两条公式，`pointMapZoomScale` / `lineMapZoomScale` 只作用于小图自有规则 / 样式。点 / 线路缓存键同步拆分这些系数，避免继承尺寸与主图倍数错误互相失效。
+- **Demo 与文档**：`MinimapDemo` 默认沿用主图，提供节点 / 线路各自的整体倍数与小图缩放指数控件，保留框选 / 平移拖拽演示；主 demo 在沿用模式下禁用地图倍数联动。同步类型注释、根 `README.md`、`src/gis-view/README.md`、手册 `03` / `14`、内部文档 `13` 与生成的 `docs/demos/api-index.js`。
+- **验证**：`selftest-full.html` **92** 条、`selftest-features.html` **672** 条、`selftest-demos.html` **351** 条、`selftest-docs.html` **134** 条，四页共 **1249** 条通过 / 0 失败；`npx tsc --noEmit`、`node --check`（minimap / create / engine / line）、`node docs/steps/gen-api-index.mjs --check`、`npm run check:docs`（257 个实例成员 / 96 个 options / 250 个数据字段 / 43 个事件 / 17 个功能开关）、`npm run build` 与 `git diff --check` 全部通过。详细口径见 [AI 对话汇总的本轮增量](../AI对话汇总.md#2026-10-23-增量鹰眼图继承要素尺寸与地图缩放解耦)。
+
+### 2026-10-23 增量（「修改.txt」三项：commitAddChannel 文档 / 传参示例 / 线路半跳过）
+
+本轮仍是现有会话的继续增量，没有独立会话归档，因此不改上表的 39 条统计。需求原话来自仓库根目录的 `修改.txt` 三项：说明 `commitAddChannel` 的传参与写法、把方法用法和示例写详细、继续优化组件性能。
+
+- **文档**：手册 `10` 补齐五种入参（无参 / 旧 resolution / 直接线路 / 直接通道 / 容器）、精确字段优先级与并组限制；明确草稿只认 `from`（没有 `to`）、直接通道 `id` 不是回线种子、`line` 与 `lines` 语义不同、空数组沿用草稿、容器不合并 `channel.lineProps`、方案读数只能取 `{ type, groupId, groupIndex, channelId }` 子集。`18` 增加逐项示例，`16` / `17` 与 `types.d.ts` 同步参数说明。
+- **性能**：`engine.js` 新增线路半跳过；命中时复用上一轮线路解析结果与包围盒，跳过 `resolveLines` 及索引 / 虚线 / 层序 / 包围盒几趟。追加补线与增量改线维护线路半包围盒，`lineHalfOutOfSync` 负责失效兜底。20000 点 / 8000 线原样回灌中位 **14.3 → 6.3 ms**。
+- **自测与文档**：`selftest-perf.html` 新增 3 条断言，锁住原样回灌、通道声明未变沿用派生折线、换骨架必须重推几何；性能页 **167** 条通过。性能记录同步到内部文档 `16-01` 的 16.37 与 `18` 的第十六轮。
+- **验证**：五页自测 full **92** / features **672** / demos **351** / docs **134** / perf **167**，合计 **1416** 条通过 / 0 失败；`node --check`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`（257 个实例成员 / 96 个 options / 250 个数据字段 / 43 个事件 / 17 个功能开关）、`npx tsc --noEmit`、`npm run build` 与 `git diff --check` 全部通过。详细口径见 [AI 对话汇总的本轮增量](../AI对话汇总.md#2026-10-23-增量修改txt三项commitaddchannel-文档--传参示例--线路半跳过)。
+
 ## 六、怎么自己复查
 
 会话文件是逐行 JSON，不用整份读 —— 只挑两种行解析就够：`session_meta` 行里的 `payload.cwd` 认项目，`payload.type === 'user_message'` 行里的 `payload.message` 是用户原话：

package/docs/demos/ConnectDemo.vue

@@ -28,6 +28,13 @@ const arrow = ref(true)
 const arrowSize = ref(12)
 const arrowPositionsText = ref('0.5')
 const circuitSpacing = ref(12)
+const startPointId = ref('')
+const dotsVisible = ref(true)
+const dotSize = ref(5)
+const startDotColor = ref('#2f6fd0')
+const endDotColor = ref('#d9544d')
+const dotShape = ref('circle')
+const draftLayer = ref('above')
 const draft = ref(null)
 const actionText = ref('配置好线条之后点「开始连线」，依次点两个节点')
 const dataText = ref('正在创建视图…')
@@ -72,6 +79,10 @@ const createInitialLines = () => {
 const isChannel = computed(() => linkKind.value !== 'line')
 const circuits = computed(() => linkKind.value === 'channel-3' ? 3 : linkKind.value === 'channel-2' ? 2 : 1)
 const arrowPositions = computed(() => arrowPositionsText.value.split(',').map(value => Number(value.trim())).filter(value => Number.isFinite(value)))
+const startPointLabel = computed(() => {
+	const point = points.find(item => String(item.id) === String(startPointId.value))
+	return point ? point.name ?? String(point.id) : ''
+})
 const isDraftLive = computed(() => Boolean(draft.value) && ['start', 'from', 'ready', 'restart', 'pick'].includes(draft.value.phase))
 const canFinish = computed(() => draft.value?.phase === 'ready')
 const draftText = computed(() => {
@@ -110,10 +121,19 @@ const currentDraftStyle = () => ({
 	color: lineColor.value,
 	width: lineWidth.value,
 	dot: 4,
+	dots: dotsVisible.value
+		? {
+			size: dotSize.value,
+			shape: dotShape.value,
+			from: { color: startDotColor.value },
+			to: { color: endDotColor.value }
+		}
+		: false,
 	arrow: arrow.value,
 	arrowSize: arrowSize.value,
 	arrowPositions: arrowPositions.value,
-	circuitSpacing: circuitSpacing.value
+	circuitSpacing: circuitSpacing.value,
+	layer: draftLayer.value
 })
 
 /** 预览与真实落地共用同一份线条字段：颜色 / 线宽 / 方向箭头都从这里出发 */
@@ -129,6 +149,7 @@ const startDraft = () => {
 	}
 	view.endAddChannel()
 	view.beginAddChannel({
+		...(startPointId.value ? { from: startPointId.value } : {}),
 		kind: isChannel.value ? 'channel' : 'line',
 		circuits: circuits.value,
 		routing: routing.value,
@@ -136,7 +157,9 @@ const startDraft = () => {
 		channelDraftStyle: currentDraftStyle(),
 		lineProps: currentLineProps()
 	})
-	actionText.value = `开始连线：先点起点，再点终点（${isChannel.value ? `通道 ${circuits.value} 回` : '独立线路'} / ${routing.value === 'orthogonal' ? '正交折线' : '直线'}）`
+	actionText.value = startPointId.value
+		? `开始连线：起点已指定为 ${startPointLabel.value}，下一次点节点只选终点（${isChannel.value ? `通道 ${circuits.value} 回` : '独立线路'} / ${routing.value === 'orthogonal' ? '正交折线' : '直线'}）`
+		: `开始连线：先点起点，再点终点（${isChannel.value ? `通道 ${circuits.value} 回` : '独立线路'} / ${routing.value === 'orthogonal' ? '正交折线' : '直线'}）`
 	pushLog('beginAddChannel', actionText.value)
 }
 
@@ -177,6 +200,60 @@ const commitDraft = () => {
 	emit('notice', actionText.value)
 }
 
+/** 直接把本次新增的线路 / 通道对象交给 commitAddChannel：不再先 addLine / addChannel */
+const commitWithObject = () => {
+	if (!view || !canFinish.value) {
+		return
+	}
+	const current = view.getAddChannelDraft()
+	if (!current?.from || !current?.to) {
+		return
+	}
+	sequence += 1
+	const from = current.from.id
+	const to = current.to.id
+	const middle = middlePathOf(current)
+	const fullPath = fullPathOf(current)
+	let payload
+	if (current.kind === 'line') {
+		payload = {
+			id: `connect-object-line-${sequence}`,
+			name: `对象线路 ${sequence}`,
+			from,
+			to,
+			...(fullPath ? { path: fullPath } : {}),
+			...currentLineProps()
+		}
+	}
+	else {
+		const lineIds = Array.from({ length: current.circuits }, (_item, index) => `connect-object-line-${sequence}-${index + 1}`)
+		const channelId = `connect-object-channel-${sequence}`
+		payload = {
+			id: channelId,
+			name: `对象通道 ${sequence}`,
+			from,
+			to,
+			lineIds,
+			...(middle ? { path: middle } : {}),
+			groups: [{ id: channelId, lineIds, ...(middle ? { path: middle } : {}) }]
+		}
+	}
+	const result = view.commitAddChannel(payload)
+	refreshState()
+	if (!result.ok) {
+		actionText.value = `commitAddChannel(对象) 没有落地：${result.reason ?? '未知原因'}`
+	}
+	else {
+		const lines = result.lines?.length ?? (result.line ? 1 : 0)
+		actionText.value = `commitAddChannel(对象) → ${result.kind === 'line' ? '线路对象' : '通道对象'} ${String(result.channelId ?? result.lineId ?? '')} · ${lines} 回线`
+		if (result.lineIds?.length) {
+			view.selectFeatures(result.lineIds)
+		}
+	}
+	pushLog('commitAddChannel(对象)', actionText.value)
+	emit('notice', actionText.value)
+}
+
 const middlePathOf = current => (current.path?.length ? current.path.map(point => [point[0], point[1]]) : null)
 const fullPathOf = current => {
 	const middle = middlePathOf(current)
@@ -267,7 +344,7 @@ const resetScene = () => {
 	pushLog('reset', actionText.value)
 }
 
-watch([lineColor, lineWidth, arrow, arrowSize, arrowPositionsText, circuitSpacing], () => {
+watch([lineColor, lineWidth, arrow, arrowSize, arrowPositionsText, circuitSpacing, dotsVisible, dotSize, startDotColor, endDotColor, dotShape, draftLayer], () => {
 	if (view && isDraftLive.value) {
 		view.updateAddChannelStyle(currentDraftStyle())
 		draft.value = view.getAddChannelDraft()
@@ -333,6 +410,14 @@ onBeforeUnmount(() => {
 						</select>
 					</label>
 				</div>
+				<div class="dv-row">
+					<label>指定起点
+						<select v-model="startPointId" data-demo="connect-start-point" :disabled="isDraftLive">
+							<option value="">点击时再选</option>
+							<option v-for="point in points" :key="String(point.id)" :value="String(point.id)">{{ point.name ?? point.id }}</option>
+						</select>
+					</label>
+				</div>
 				<div class="dv-row">
 					<label>线色 <input v-model="lineColor" type="color" data-demo="connect-color" /></label>
 					<label>线宽 <input v-model.number="lineWidth" type="range" min="1" max="6" step="0.2" data-demo="connect-width" /> {{ lineWidth.toFixed(1) }}</label>
@@ -356,6 +441,31 @@ onBeforeUnmount(() => {
 				<p class="dv-hint">草稿样式直接传给 <code>beginAddChannel({ channelDraftStyle })</code>；连线期间改颜色 / 线宽 / 箭头位置 / 回线间距会走 <code>updateAddChannelStyle()</code>，预览立即更新。正交折线会自动补一个 90 度拐点；落地线路用完整 path，通道只写中间拐点。</p>
 			</div>
 
+			<div class="dv-group">
+				<h3>示例点与层级</h3>
+				<div class="dv-row">
+					<label><input v-model="dotsVisible" type="checkbox" data-demo="connect-dots-visible" /> 显示两端示例点</label>
+					<label>形状
+						<select v-model="dotShape" data-demo="connect-dot-shape">
+							<option value="circle">圆形</option>
+							<option value="square">方形</option>
+						</select>
+					</label>
+					<label>尺寸 <input v-model.number="dotSize" type="range" min="2" max="12" step="1" data-demo="connect-dot-size" /> {{ dotSize }}px</label>
+				</div>
+				<div class="dv-row">
+					<label>起点色 <input v-model="startDotColor" type="color" data-demo="connect-dot-from-color" :disabled="!dotsVisible" /></label>
+					<label>终点色 <input v-model="endDotColor" type="color" data-demo="connect-dot-to-color" :disabled="!dotsVisible" /></label>
+					<label>示例线路层级
+						<select v-model="draftLayer" data-demo="connect-draft-layer">
+							<option value="above">真实节点之上</option>
+							<option value="below-points">真实节点之下</option>
+						</select>
+					</label>
+				</div>
+				<p class="dv-hint">示例点始终落在被点击节点的正中心（多回线偏移不会带走它），可通过 <code>dots: false</code> 关闭，或用 <code>dots.from / dots.to</code> 分别配颜色、尺寸与形状。层级只作用于示例线 / 箭头 / <code>customDraw</code>；示例点仍画在真实节点之后，保证看得见。</p>
+			</div>
+
 			<div class="dv-group">
 				<h3>草稿与落地</h3>
 				<div class="dv-row">
@@ -364,6 +474,7 @@ onBeforeUnmount(() => {
 				</div>
 				<div class="dv-row">
 					<button type="button" class="dv-button" data-demo="connect-default" :disabled="!canFinish" @click="commitDraft">默认添加（commitAddChannel）</button>
+					<button type="button" class="dv-button" data-demo="connect-commit-object" :disabled="!canFinish" @click="commitWithObject">对象提交（通道 / 线路对象）</button>
 					<button type="button" class="dv-button" data-demo="connect-add-lines" :disabled="!canFinish" @click="addWithLines">用 addLines 添加</button>
 					<button type="button" class="dv-button" data-demo="connect-add-channels" :disabled="!canFinish" @click="addWithChannels">用 addChannels 添加</button>
 				</div>

package/docs/demos/MinimapDemo.vue

@@ -17,12 +17,17 @@ const enabled = ref(true)
 const size = ref('medium')
 const position = ref('bottom-right')
 const extent = ref('auto')
-const ruleMode = ref('voltage')
+const ruleMode = ref('inherit')
 const levelMode = ref('all')
-const linkedSizes = ref(true)
+const pointSizeScale = ref(1)
+const lineWidthScale = ref(1)
+const pointZoomScale = ref(0)
+const lineZoomScale = ref(0)
 const channelCircuits = ref(true)
-const zoomable = ref(true)
+const zoomMode = ref('manual')
+const followZoomScale = ref(1)
 const dragAction = ref('pan')
+const extentFollowCamera = ref(false)
 const maxPixelRatio = ref('2')
 const gridPlacement = ref('below-data')
 const customLayers = ref(true)
@@ -125,6 +130,7 @@ const minimapOptions = () => {
 		margin: 12,
 		padding: 0.05,
 		extent: extent.value,
+		extentFollowCamera: extentFollowCamera.value,
 		background: 'inherit',
 		backgroundStyle: 'rgba(255, 255, 255, 0.94)',
 		borderColor: '#c7d8eb',
@@ -140,16 +146,19 @@ const minimapOptions = () => {
 		levels: levelMode.value === 'top' ? [2] : undefined,
 		cascade: 'both',
 		layered: true,
-		pointSizeScale: 1,
-		lineWidthScale: 1,
-		pointMapZoomScale: linkedSizes.value ? 0.5 : 0,
-		lineMapZoomScale: linkedSizes.value ? 0.5 : 0,
+		// 自己规则 / 沿用主图都乘这一份；与主图相机倍数、小图自身倍数都无关
+		pointSizeScale: Number(pointSizeScale.value),
+		lineWidthScale: Number(lineWidthScale.value),
+		// 只有小图自身放大时才按这两个指数联动；沿用主图的节点 / 线路也一样
+		pointZoomScale: Number(pointZoomScale.value),
+		lineZoomScale: Number(lineZoomScale.value),
 		boxStyle: { fill: '#3678bf', fillOpacity: 0.16, stroke: '#3678bf', strokeWidth: 1, strokeStyle: 'dashed', radius: 3 },
 		selectStyle: { fill: '#f0a43c', stroke: '#f0a43c' },
 		interactive: true,
 		onInteraction: handleMinimapInteraction,
 		longPressDelay: 180,
-		zoomable: zoomable.value,
+		zoomable: zoomMode.value === 'manual' ? true : zoomMode.value === 'follow' ? 'follow' : false,
+		followZoomScale: Number(followZoomScale.value),
 		minZoom: 0.7,
 		maxZoom: 6,
 		zoomStep: 1.35,
@@ -168,10 +177,14 @@ const refreshReadout = () => {
 	const sizeText = root ? `${Math.round(root.getBoundingClientRect().width)}×${Math.round(root.getBoundingClientRect().height)}` : '未挂载'
 	readout.value = `${sizeText} · 备份 ${canvas?.width ?? 0}×${canvas?.height ?? 0} · 像素比 ${ratio ? ratio.toFixed(2) : '—'} · 范围 ${extent.value} · 自定义层 ${options.layers.length}`
 	if (view) {
-		zoomReadout.value = `小图倍数 ${view.getMinimapZoom().toFixed(2)} · ${zoomable.value ? '滚轮缩放小图' : '滚轮缩放主图'}`
+		zoomReadout.value = `小图倍数 ${view.getMinimapZoom().toFixed(2)} · ${zoomModeLabel.value}`
 	}
 }
 
+const zoomModeLabel = computed(() => zoomMode.value === 'manual'
+	? '手动缩放小图'
+	: zoomMode.value === 'follow' ? `跟随主图（指数 ${Number(followZoomScale.value).toFixed(1)}）` : '不缩放小图，滚轮缩放主图')
+
 const applyMinimap = () => {
 	if (!view) {
 		return
@@ -193,10 +206,20 @@ const zoomMinimap = (factor) => {
 
 const refreshZoom = () => {
 	if (view) {
-		zoomReadout.value = `小图倍数 ${view.getMinimapZoom().toFixed(2)} · ${zoomable.value ? '滚轮缩放小图' : '滚轮缩放主图'}`
+		zoomReadout.value = `小图倍数 ${view.getMinimapZoom().toFixed(2)} · ${zoomModeLabel.value}`
 	}
 }
 
+/** 拖拽演示：框选不依赖 zoomable；平移才需要手动缩放后内容有可移动余量 */
+const showDragDemo = (action) => {
+	dragAction.value = action
+	zoomMode.value = action === 'box' ? 'off' : 'manual'
+	applyMinimap()
+	eventText.value = action === 'box'
+		? '拖拽演示：缩放模式已关闭，在小图空白处直接拖动仍能拉出框选矩形'
+		: '拖拽演示：已切到手动缩放，在小图空白处拖动平移小图内容'
+}
+
 const refreshLayerReadout = () => {
 	layerReadout.value = `网格层 ${layerPaints.grid} 次（${layerPaints.gridStage}） · 指北针层 ${layerPaints.compass} 次`
 	refreshReadout()
@@ -289,6 +312,9 @@ const sizeSummary = computed(() => `${SIZES[size.value]?.[0] ?? 0}×${SIZES[size
 						</select>
 					</label>
 				</div>
+				<div class="dv-row">
+					<label><input v-model="extentFollowCamera" type="checkbox" data-demo="minimap-extent-follow" @change="applyMinimap" /> 自动范围随相机收窄（默认关）</label>
+				</div>
 				<p class="dv-hint"><code>maxPixelRatio</code> 越大越清晰，也越吃填充率；高分屏按机器档位调到 2 通常就够。</p>
 			</div>
 			<div class="dv-group">
@@ -309,11 +335,24 @@ const sizeSummary = computed(() => `${SIZES[size.value]?.[0] ?? 0}×${SIZES[size
 					</label>
 				</div>
 				<div class="dv-row">
-					<label><input v-model="linkedSizes" type="checkbox" data-demo="minimap-linked" @change="applyMinimap" /> 尺寸跟随主图缩放</label>
+					<label>节点整体倍数 <input v-model.number="pointSizeScale" type="range" min="0" max="3" step="0.1" data-demo="minimap-point-size-scale" @change="applyMinimap" /> {{ Number(pointSizeScale).toFixed(1) }}</label>
+					<label>线路整体倍数 <input v-model.number="lineWidthScale" type="range" min="0" max="3" step="0.1" data-demo="minimap-line-width-scale" @change="applyMinimap" /> {{ Number(lineWidthScale).toFixed(1) }}</label>
+				</div>
+				<div class="dv-row">
+					<label>小图放大节点 <input v-model.number="pointZoomScale" type="range" min="0" max="1" step="0.1" data-demo="minimap-point-zoom-scale" @change="applyMinimap" /> {{ Number(pointZoomScale).toFixed(1) }}</label>
+					<label>小图放大线路 <input v-model.number="lineZoomScale" type="range" min="0" max="1" step="0.1" data-demo="minimap-line-zoom-scale" @change="applyMinimap" /> {{ Number(lineZoomScale).toFixed(1) }}</label>
+				</div>
+				<div class="dv-row">
 					<label><input v-model="channelCircuits" type="checkbox" data-demo="minimap-circuits" @change="applyMinimap" /> 画全部回线</label>
 				</div>
 				<div class="dv-row">
-					<label><input v-model="zoomable" type="checkbox" data-demo="minimap-zoomable" @change="applyMinimap" /> 小图自身可缩放</label>
+					<label>缩放模式
+						<select v-model="zoomMode" data-demo="minimap-zoomable" @change="applyMinimap">
+							<option value="off">关闭</option>
+							<option value="manual">手动缩放小图</option>
+							<option value="follow">跟随主图</option>
+						</select>
+					</label>
 					<label>空白拖动
 						<select v-model="dragAction" data-demo="minimap-drag-action" @change="applyMinimap">
 							<option value="pan">平移小图</option>
@@ -321,7 +360,14 @@ const sizeSummary = computed(() => `${SIZES[size.value]?.[0] ?? 0}×${SIZES[size
 						</select>
 					</label>
 				</div>
-				<p class="dv-hint">打开「小图自身可缩放」后，滚轮缩放小图；按住 Ctrl / ⌘ + 滚轮仍然缩放主图。视口框可以拖，空白处长按跟随。</p>
+				<div class="dv-row">
+					<label>跟随指数 <input v-model.number="followZoomScale" type="range" min="0" max="2" step="0.1" data-demo="minimap-follow-scale" @change="applyMinimap" /> {{ Number(followZoomScale).toFixed(1) }}</label>
+				</div>
+				<div class="dv-row">
+					<button type="button" class="dv-button" data-demo="minimap-drag-box" @click="showDragDemo('box')">拖拽演示：框选</button>
+					<button type="button" class="dv-button" data-demo="minimap-drag-pan" @click="showDragDemo('pan')">拖拽演示：平移</button>
+				</div>
+				<p class="dv-hint">沿用主图规则时，节点 / 线路先按「小图视口 ÷ 主图视口」缩放，主图放大缩小不会改变它们的大小；滚轮或 ＋ / － 放大鹰眼图时，再按 <code>pointZoomScale</code> / <code>lineZoomScale</code> 的指数变化。两个整体倍数对自有规则与沿用主图的要素都生效。<code>zoomable: true</code> 是小图手动缩放，<code>'follow'</code> 是整体范围跟随主图，两者互斥；<code>followZoomScale</code> 是主图倍数的指数。框选不依赖缩放开关：选「关闭」+ <code>dragAction: 'box'</code>，空白处拖动仍会直接框选。视口框可以拖，空白处长按跟随。</p>
 			</div>
 			<div class="dv-group">
 				<h3>扩展层</h3>
@@ -341,9 +387,9 @@ const sizeSummary = computed(() => `${SIZES[size.value]?.[0] ?? 0}×${SIZES[size
 			<div class="dv-group">
 				<h3>小图倍数</h3>
 				<div class="dv-row">
-					<button type="button" class="dv-button" data-demo="minimap-zoom-out" @click="zoomMinimap(1 / 1.35)">－</button>
-					<button type="button" class="dv-button dv-button--primary" data-demo="minimap-zoom-reset" @click="resetZoom">1×</button>
-					<button type="button" class="dv-button" data-demo="minimap-zoom-in" @click="zoomMinimap(1.35)">＋</button>
+					<button type="button" class="dv-button" data-demo="minimap-zoom-out" :disabled="zoomMode === 'follow'" @click="zoomMinimap(1 / 1.35)">－</button>
+					<button type="button" class="dv-button dv-button--primary" data-demo="minimap-zoom-reset" :disabled="zoomMode === 'follow'" @click="resetZoom">1×</button>
+					<button type="button" class="dv-button" data-demo="minimap-zoom-in" :disabled="zoomMode === 'follow'" @click="zoomMinimap(1.35)">＋</button>
 				</div>
 				<p class="dv-readout" data-demo="minimap-zoom-readout">{{ zoomReadout }}</p>
 			</div>