gis-view-webgl2 0.1.14 → 0.1.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +302 -76
- package/dist/index.js +1 -1
- package/docs/AI/345/257/271/350/257/235/346/261/207/346/200/273.md +127 -5
- package/docs/GisView.md +2 -2
- 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 +123 -17
- package/docs/demos/ApiCoverageDemo.vue +1 -5
- package/docs/demos/BackendSyncDemo.vue +1 -2
- package/docs/demos/BackgroundDemo.vue +68 -1
- package/docs/demos/BatchAddDemo.vue +2 -1
- package/docs/demos/ChannelDemo.vue +212 -3
- package/docs/demos/ClusterDemo.vue +48 -1
- package/docs/demos/CopyMergeDemo.vue +225 -55
- package/docs/demos/api-index.js +43 -46
- package/docs/demos/gis-view-demo/useGisViewDemo.js +19 -14
- package/docs/format/02-/350/212/202/347/202/271/344/270/216/347/272/277/350/267/257.md +3 -3
- package/docs/format/03-/346/213/220/347/202/271/350/243/205/351/245/260/344/270/216/346/240/267/345/274/217.md +3 -0
- package/docs/from0/01-/345/205/210/346/212/212/345/234/260/345/233/276/346/203/263/346/270/205/346/245/232.md +8 -7
- package/docs/index.html +3 -3
- package/docs/internals/04-/347/233/270/346/234/272/345/235/220/346/240/207/344/270/216/345/203/217/347/264/240.md +6 -4
- package/docs/internals/14-/350/203/214/346/231/257/345/261/202.md +2 -2
- package/docs/internals/15-03-/351/200/220/350/275/256/350/256/260/345/275/225-/346/200/247/350/203/275/344/270/216/344/277/256/345/244/215-/344/270/213.md +14 -0
- 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 +14 -0
- package/docs/internals/16-03-/344/274/230/345/214/226/344/270/216/345/217/226/350/210/215-/344/270/213.md +8 -0
- package/docs/manual/02-/345/235/220/346/240/207/344/270/216/346/225/260/346/215/256.md +36 -16
- package/docs/manual/03-/351/205/215/347/275/256/351/241/271.md +53 -87
- package/docs/manual/04-/344/272/213/344/273/266/344/270/216/345/233/236/350/260/203.md +38 -21
- package/docs/manual/06-/346/225/260/346/215/256/344/270/216/345/234/272/346/231/257/346/233/264/346/226/260.md +2 -2
- package/docs/manual/07-/346/214/207/351/222/210/344/270/216/350/246/201/347/264/240/347/274/226/350/276/221.md +58 -13
- package/docs/manual/08-/351/200/211/344/270/255/344/270/216/346/213/220/347/202/271.md +14 -14
- package/docs/manual/09-/351/200/232/351/201/223/344/270/216/345/244/232/345/233/236/347/272/277.md +12 -0
- package/docs/manual/10-/351/200/232/351/201/223/347/274/226/350/276/221/344/270/216/346/226/260/345/242/236.md +113 -8
- package/docs/manual/12-/346/240/207/347/255/276/344/270/216/350/243/205/351/245/260.md +6 -0
- package/docs/manual/14-/350/247/206/345/233/276/344/270/216/347/255/233/351/200/211.md +3 -2
- package/docs/manual/15-/345/257/274/345/207/272/344/270/216/351/233/206/346/210/220.md +2 -0
- package/docs/manual/16-/345/256/236/344/276/213/346/226/271/346/263/225/346/200/273/350/241/250.md +37 -19
- package/docs/manual/17-/345/217/202/346/225/260/351/200/237/346/237/245.md +19 -13
- package/docs/manual/18-/351/200/220/346/226/271/346/263/225/347/244/272/344/276/213.md +98 -12
- package/docs/manual/20-/346/200/247/350/203/275/344/270/216/345/244/247/346/225/260/346/215/256.md +28 -4
- package/docs/manual/21-/350/257/264/346/230/216/344/270/216/345/270/270/350/247/201/351/227/256/351/242/230.md +3 -3
- package/docs/playground/index.html +1 -1
- package/docs/sample-document/345/255/227/346/256/265/350/257/246/350/247/243.md +2 -2
- package/docs/steps/selftest-actions.html +4 -4
- package/docs/steps/selftest-data.html +5 -5
- package/docs/steps/selftest-demos.html +180 -14
- package/docs/steps/selftest-docs.html +4 -4
- package/docs/steps/selftest-effects.html +1 -1
- package/docs/steps/selftest-features.html +1053 -46
- package/docs/steps/selftest-perf.html +150 -53
- package/docs/steps/selftest-scale.html +6 -2
- package/docs/steps/selftest-select.html +20 -13
- package/docs/steps/step-10-full.js +1 -4
- package/docs/steps/step-12-events.js +1 -4
- package/docs//346/216/245/345/217/243/345/215/217/350/256/256.md +2 -0
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AI 对话汇总
|
|
2
2
|
|
|
3
|
-
> 一页读完 gis-view 的 AI 协作史:39 个会话、
|
|
3
|
+
> 一页读完 gis-view 的 AI 协作史:39 个会话、222 轮需求,按「关键决策 → 演进主线 → 精选问答」整理。
|
|
4
4
|
> 原先拆开的 01 ~ 05 已合并到这里;逐会话文件、历史增量索引与复查命令统一放在 [维护索引](ai/06-会话索引与复查方法.md)。
|
|
5
5
|
|
|
6
6
|
这份汇总不是使用手册。组件行为以 [GisView 手册](GisView.md) 和 [数据格式](数据格式.md) 为准,实现细节与逐轮证据在 [GisView 实现原理](GisView实现原理.md) 的 `internals/15-*`、`16-*`。这里只回答三件事:当时为什么这么定、后来怎么演进、现在该从哪里继续查。
|
|
@@ -20,11 +20,11 @@
|
|
|
20
20
|
|
|
21
21
|
| 项目 | 结论 |
|
|
22
22
|
| --- | --- |
|
|
23
|
-
| 对话范围 | 2026-09-15 ~ 2026-11-
|
|
23
|
+
| 对话范围 | 2026-09-15 ~ 2026-11-04,39 个会话、222 轮;10-14 之后主要为现有会话的增量轮次 |
|
|
24
24
|
| 产品形态 | 一个默认无控制面板的 `createGisView(dom, options)` WebGL2 矢量视图;鹰眼图、图例与背景编辑器按需开启,交互与视觉效果通过配置、事件和实例方法组合 |
|
|
25
25
|
| 核心对象 | 节点、线路、通道(多回线 / 分组)、拐点、装饰、标签、覆盖层、鹰眼图、扩展图形 |
|
|
26
26
|
| 技术路线 | WebGL2 批量渲染 + HTML / Canvas 覆盖层 + 网格索引 + 增量更新 + Worker 筛选与搜索 |
|
|
27
|
-
| 当前公开面 |
|
|
27
|
+
| 当前公开面 | 287 个实例成员(282 个方法 + 5 个属性)、100 个 options、265 个数据字段、44 个事件、19 个功能开关、16 个分组 |
|
|
28
28
|
| 维护方式 | 文档双向对账、API 索引生成、14 个自测页与无头浏览器回归;每轮记录同步到本页与维护索引 |
|
|
29
29
|
|
|
30
30
|
## 关键技术决策
|
|
@@ -84,7 +84,129 @@
|
|
|
84
84
|
|
|
85
85
|
先分清组件与宿主:本组件只负责接收已经整理好的点线数据,`initData` 只应在挂载时调用一次;若宿主定时重建数据,先查宿主路由、监听与 `gisTools.js` / `buildNewData`。SVG 被画成圆通常是宿主传入了错误的 `symbol` 或 `pointRules`,直流标记则要确认装饰类型与数据映射。历史排查见维护索引的 10-12 旁支记录。
|
|
86
86
|
|
|
87
|
-
##
|
|
87
|
+
## 当前轮次:筛选开启时的线路标签候选复用(2026-11-04)
|
|
88
|
+
|
|
89
|
+
- **需求来源**:根目录 `修改.txt` 两条 —— ① 修改 gis-view 组件;② 继续优化组件性能、排查组件 bug。
|
|
90
|
+
- **根因与修复**:`create.js` 的 `labelRefreshKinds()` 原来写的是「只要有筛选就整层重排」,把「筛选开着」误当成「筛选结果这一轮会变」。现在改用 `filterNeedsPatchRerun(kind, patches)` 做补丁级判断:补丁碰到筛选字段、`id` / 坐标 / `visible` / 线路两端,或筛选条件含函数、字段元数据不可安全判读时,仍保守返回 `undefined` 并整层重排;只改 `name` / `color` 等展示字段时隐藏集合不动,节点定向更新继续复用线路标签候选,跳过十万条线的视口扫描。
|
|
91
|
+
- **性能实测**:无头 Chrome + 2 万点 / 1 万线 + 两层标签、筛选开启,只改一个节点 `name` 时线路条件检查由 **2060 次 → 0 次**、`onFilter` 为 **0 次**;连续 24 次定向更新中位 **0.60 → 0.50 ms / 次**、最大 **2.70 → 2.00 ms**。同一轮 2 万点 `updatePoint` 约 **0.11 ms / 次**。这是「省掉整层线路扫描」的收益,不是 GPU 帧率提升。
|
|
92
|
+
- **测试口径修复**:`selftest-scale` 原来两条断言只改 `name` 却期待 `onFilter` 重算,与「展示字段不参与筛选时跳过重算」的既有设计相反;现改为 batch / 逐条都同时写真正的筛选字段 `vn_kv`,并新增「只改不参与筛选的字段时跳过整轮筛选」断言(期望 `onFilter` 为 0)。`selftest-perf` 的线路候选复用用例补上真实筛选与 `lineLabel.when` 计数,等待布局、预热候选缓存与当前视口标签后再取样,新增「筛选开着时只改节点展示字段也不重扫线路」断言。
|
|
93
|
+
- **核心文件**:`src/gis-view/create.js`、`docs/steps/selftest-scale.html`、`docs/steps/selftest-perf.html`、`src/gis-view/README.md`、`docs/internals/15-03-逐轮记录-性能与修复-下.md`、`docs/internals/16-03-优化与取舍-下.md`、本页与维护索引。
|
|
94
|
+
- **验证**:`node scripts/run-selftests.mjs selftest-scale.html selftest-perf.html` 为 **129/0**、**202/0**;`selftest-features` **935/0**、`selftest-demos` **457/0**、`selftest-docs` **139/0**;`node --check src/gis-view/create.js`、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs` 与 `--check`、`npm run check:docs`、`npm run build`、`git diff --check` 通过。公开面不变(287 个实例成员 / 282 个方法 / 100 options / 265 个数据字段)。
|
|
95
|
+
|
|
96
|
+
## 同日上一轮:节点合并的通道分组策略与两个合并入口(2026-11-04)
|
|
97
|
+
|
|
98
|
+
- **需求来源**:根目录 `修改.txt` 四条 —— ① `mergeSelectedPoints` 与 `onPointMerge` 的 `payload.confirm()` 有什么区别、事件底层做了什么;② 节点合并时能否指定被并通道回线作为新分组插入、并入指定组或默认第一组;③ `updateChannel` 能否修改分组信息;④ 在 Demo 中体现。
|
|
99
|
+
- **两个合并入口**:`mergeSelectedPoints(options?)` 是立即执行的批量接口,解析目标与来源后逐对调用 `mergePoints()`;多个来源用内部 `batch()` 收成一步历史与一条 `batch` 数据变更,每对发 `phase: 'merge'`、收尾发 `phase: 'mergeSelected'`,全程没有 pending,也不经过 `merge.confirm`。`onPointMerge` 的 `payload.confirm(options?)` 把拖拽合并从 `pending` 推进到 `confirm`(引擎 `resolvePointMerge(true)`);进入确认回调时数据仍未落地,`payload.item` 仍可改、也可 `payload.cancel()`,回调结束后组件才按 `keep` / `channelGroups` 调 `mergePoints()` 落地并发 `phase: 'merge'` / `dataChange('mergePoints')`。链路同步,`payload.confirm()` / `resolvePointMerge(true)` 正常返回时通常已经落地;`resolvePointMerge(true, options)` 是 `payload.confirm` 的程序化等价入口。
|
|
100
|
+
- **合并分组策略**:`merge.channelGroups` 与单次 `mergePoints` / `mergeSelectedPoints` 的 `options.channelGroups` 支持 `'keep'`(各自保留,缺省)、`'merge'`(合成一组)、`'newGroup'`(被并回线收成新组,沿用其第一组骨架)、`'first'`(并进保留通道第一组)、`{ groupId }`(并进指定组,找不到 / 空 id 回落第一组);分组合并 id 撞车自动加序号。拖拽合并的 pending 创建时继承全局策略,确认时可用 `payload.confirm({ channelGroups })` / `resolvePointMerge(true, { channelGroups })` 覆盖;pending / confirm / merge / mergeSelected 载荷都回带本次 `channelGroups`。`analyzeMergeImpact()` 同步接收策略,确认框看到的影响预演与落地一致。
|
|
101
|
+
- **事件配置与最终节点改写(同日补问,需求原话:事件触发的合并如何设置上一轮新增的分组策略、是否需要增加 merge 配置;`payload.confirm()` 时如何额外修改合并后节点的自身数据与颜色等样式,`mergeSelectedPoints` 同理)**:现有公开面已经够用,**无需新增配置或实例成员**。事件拖拽合并的全局策略就是 `merge.channelGroups`,`pending` 创建时继承;单次 `payload.confirm({ channelGroups })` / `resolvePointMerge(true, { channelGroups })` 覆盖。最终节点用 `item` 补丁改,可直接写 `color` / `size` / `symbol` / `strokeColor` 等样式与业务字段:`payload.confirm({ item })`、confirm 回调里改 `payload.item`、`mergePoints(..., { item })`、`mergeSelectedPoints({ item })`(也收函数)都会写进落地节点;`id` / 坐标 / `mergeInfo` 仍由组件维护。`merge` 没有 `item` 字段,全局缺省结果改写用 `merge.createItem`。文档 03 / 07 / 16 / 17 / 18 和 Demo 文案已补齐这些口径,并明确「应用全局策略」同时影响之后拖拽进来的 pending。
|
|
102
|
+
- **`updateChannel` 改分组**:无需新增入口。`{ groups }` 整份覆盖分组声明,`{ group }` 按 `id` / `groupId` 单组补丁(找不到就新增、不写 id 为第一组,可改 `lineIds` / `path` / `visible` / `waypointOffsets`);分组先发 `channelGroups` 与 `channelGroupChange`,再发 `updateChannel`。边界是声明与成员引用:不会创建 / 删除顶层真实线路,真实回线增删仍走 `addChannelGroupLines` / `joinChannelGroupLines` / `addLine(s)` / `addChannelLines` / `removeChannelLines` / `removeLine(s)`。
|
|
103
|
+
- **只写 groups 的通道**:合并、分组摘线、删线路后的成员判断统一按顶层 `lineIds` 与各组 `lineIds` 的并集计算;`newGroup` / `first` / `{ groupId }` 能移动只写在组里的回线,也不会因顶层 `lineIds` 为空误删整条通道,收尾保留原声明形态。
|
|
104
|
+
- **Demo 与测试**:`CopyMergeDemo.vue` 重建为两条可相撞且各带两组回线的通道,新增分组策略下拉、指定组 id、`mergeSelectedPoints`、pending `confirm`、全局策略与 `updateChannel('channel-a', { group: { id, visible } })` 演示及读数,并明确「声明字段不创建真实线路」。`selftest-features` 新增合并 ③b fixture,覆盖五种策略、指定组不存在回落、空 groupId、只写 groups、pending 继承与 confirm 覆盖;`selftest-demos` 覆盖策略下拉、`first`、指定组与改组。
|
|
105
|
+
- **核心文件**:`src/gis-view/engine.js`、`src/gis-view/create.js`、`src/gis-view/types.d.ts`、`docs/demos/CopyMergeDemo.vue`、`docs/demos/api-index.js`、`docs/steps/selftest-features.html`、`docs/steps/selftest-demos.html`、`docs/manual/03-配置项.md`、`docs/manual/07-指针与要素编辑.md`、`docs/manual/09-通道与多回线.md`、`docs/manual/10-通道编辑与新增.md`、`docs/manual/16-实例方法总表.md`、`docs/manual/17-参数速查.md`、`docs/manual/18-逐方法示例.md`、`docs/接口协议.md`、组件 README、本页与维护索引。
|
|
106
|
+
- **验证**:`node --check src/gis-view/engine.js`、`node --check src/gis-view/create.js`、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs` 与 `--check`、`npm run check:docs`、`npm run build`、`git diff --check` 通过;`selftest-features` **935/0**(新增 ③c 三条样式落地断言)、`selftest-demos` **457/0**(加强 `mergeSelectedPoints` 的 item 样式读数)。公开面不变(287 个实例成员 / 282 个方法 / 100 options / 265 数据字段)。
|
|
107
|
+
|
|
108
|
+
## 同日前两轮:通道数据读取与分组线路增删(2026-11-04)
|
|
109
|
+
|
|
110
|
+
- **需求来源**:根目录 `修改.txt` 五条 —— ① 如何拿整个 options / 所有 points、lines、channels;② 如何在某条通道的分组里新建、删除线路;③ 如何新建分组并分配已有线路,以及新建分组时同时新增线路;④ 删分组时如何连组内线路一起删、如何只删通道不删线路;⑤ 在 Demo 中体现。
|
|
111
|
+
- **读取口径**:`getOptions()` 返回当前配置,并带当前 `points` / `lines` / `channels` 三列;`getData()` 仍只返回点线两列;运行时分组几何继续用 `getChannels()` / `getChannelGroups()`。Demo 新增同步读数,直接展示三种入口的份量。
|
|
112
|
+
- **分组与线路**:已有组内新建回线用 `joinChannelGroupLines`,删除用 `removeLine` / `removeLines`;新建组并分配已有回线用 `addChannelGroup`,新建组同时建回线用 `addChannelGroupLines`。Demo 覆盖建线、删线、组分配与同批建组。
|
|
113
|
+
- **删除策略**:`removeChannelGroup(channelId, groupId, { removeLines: true })` 删除分组与组内真实回线,通道仍有其它组时保留,删空时整条通道一起走;`removeChannel(channelId, { keepLines: true })` / `removeChannels(ids, { keepLines: true })` 只删通道声明,成员回线留在 `lines` 并成为独立线路,返回 `keptLineIds`。
|
|
114
|
+
- **Demo 回归修复**:Demo 新建组后误读了返回结果里不存在的 `result.groups`,会抛异常并导致后续删组按钮不可用;改为从 `getChannelGroups()` 读当前组数。`pruneDemoGroupState()` 同时参考 `getOptions().channels` 的声明分组,避免运行时读数尚未刷新时清掉刚创建的引用。
|
|
115
|
+
- **类型与文档**:`types.d.ts` 扩展 `removeChannelGroup` 的 `removeLines`、`removeChannel(s)` 的 `keepLines` 与 `keptLineIds`;手册 10 新增读取口径与完整增删示例,手册 16 更新方法表。公开面不变(287 个实例成员 / 282 个方法 / 100 options / 265 数据字段)。
|
|
116
|
+
- **核心文件**:`src/gis-view/create.js`、`src/gis-view/types.d.ts`、`docs/demos/ChannelDemo.vue`、`docs/steps/selftest-features.html`、`docs/steps/selftest-demos.html`、`docs/manual/10-通道编辑与新增.md`、`docs/manual/16-实例方法总表.md`、本页与维护索引。
|
|
117
|
+
- **验证**:`node --check src/gis-view/create.js`、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs` 与 `--check`、`npm run check:docs`、`npm run build`、`git diff --check` 通过;`selftest-features` **914/0**、`selftest-demos` **451/0**、`selftest-actions` **96/0**、`selftest-select` **118/0**、`selftest-docs` **139/0**。
|
|
118
|
+
|
|
119
|
+
## 同日前三轮:removeLine / removeLines 空 groups 误删通道修复(2026-11-04)
|
|
120
|
+
|
|
121
|
+
- **需求来源**:根目录 `修改.txt` —— 通道两条回线用 `removeLine` 删除一条后,视图虽然更新,但整条通道也被删除,再次点击已不再按通道命中;同时确认 `removeLines` 是否同样受影响。
|
|
122
|
+
- **根因**:`removeLines` 在删完成员后只看 `groups !== undefined` 时的分组剩余数;后端数据常见的 `groups: []` 会让顶层 `lineIds` 仍有成员也被算成 0,从而把整条通道收走。
|
|
123
|
+
- **修复口径**:剩余成员改为取顶层 `lineIds` 与各组 `lineIds` 的并集,与 `channelLineIdsOf()` 和引擎的成员口径一致。空 `groups` 不再遮蔽顶层成员;通道仍有回线时保留声明和引擎几何、继续按通道拾取,最后一条成员删除时仍照常整条删除。
|
|
124
|
+
- **自测**:`selftest-features` 新增三条断言:`removeLine` 后通道数据与引擎状态保留且仍可拾取命中原通道;`removeLines` 同样识别空 `groups` 下的顶层成员。
|
|
125
|
+
- **核心文件**:`src/gis-view/create.js`、`src/gis-view/types.d.ts`、`docs/manual/10-通道编辑与新增.md`、`docs/steps/selftest-features.html`、本页与维护索引。
|
|
126
|
+
- **验证**:`node --check src/gis-view/create.js`、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs` 与 `--check`、`npm run check:docs`、`npm run build`、`git diff --check` 通过;`selftest-features` **908/0**、`selftest-actions` **96/0**、`selftest-select` **118/0**、`selftest-docs` **139/0**。公开面不变(287 个实例成员 / 282 个方法 / 100 options / 265 数据字段)。
|
|
127
|
+
|
|
128
|
+
## 同日前四轮:patchChannels / patchLines 补齐 updateChannel / updateLine 批量版(2026-11-04)
|
|
129
|
+
|
|
130
|
+
- **需求来源**:根目录 `修改.txt` —— `patchChannels` 能不能改成 `updateChannel` 的批量版,`patchLines` 同理,也就是 `updateChannel` / `updateLine` 的批量操作怎么收口。
|
|
131
|
+
- **批量线路**:`patchLines(entries, patch?)` 现在逐条支持 `updateLine` 的线路字段与 `groupId` / `groupIndex` / `channelId` 分组指令。分组指令先走 `applyLineGroupPatch`,随后从补丁里摘掉,不写进 `lines`;只给分组指令的条目不产生 `updateLines`,混合批次仍只发一条 `updateLines`,整次调用只占一步历史。
|
|
132
|
+
- **批量通道**:`patchChannels(entries, patch?, linePatches?, lineIds?)` 现在是 `updateChannel` 的批量版,兼容旧扁平 `{ id, name, groups }`、`updateChannel` 形状 `{ id, patch, linePatches, lineIds }` 和扁平 + 成员补丁;公共第二 / 三 / 四段与逐条形式同义。缺失成员可补建,`lineIds` 与成员补丁配对时执行整表少了删;声明整批只 `engine.setChannels()` 一次,成员补丁、补建与删除都收在同一个 batch / 历史步,主数据变更仍是一条 `updateChannels`。
|
|
133
|
+
- **兼容规则**:只有逐条或公共 `linePatches` 存在时,条目里的 `lineIds` 才按第四段整表解释;共享通道补丁配逐条 `lineIds` 仍按成员声明写入,`nestedPatch` 本身不触发整表语义。这样旧写法 `patchChannels([{ id, lineIds }], { width })` 不会被误当成少了删。
|
|
134
|
+
- **声明与成员边界**:`patchChannels` 单独的 `lineIds` / `groups` 仍只改通道声明,不会新建、删除或改写顶层 `lines` 里的真实线路;补齐批量版后,成员字段可以直接走它的第三 / 四段,单条通道也可用 `updateChannel` 第三段或 `patchLines`。真实回线新增仍可用 `addChannelGroupLines` / `joinChannelGroupLines` / `addLine(s)`,挂入用 `addChannelLines`,只摘出用 `removeChannelLines`,删除线路用 `removeLine(s)`。
|
|
135
|
+
- **lineData 口径**:不改存储模型。`lines` 是唯一真实线路数据,`GisViewChannel` 只保存 `lineIds` / `groups[].lineIds`;`lineData` 只是 `addChannel` / `addLine` / `commitAddChannel` 等新增入口的第二段入参,不会落成 `channel.lineData`。不建议和线路做双向对象引用 / Proxy 同步:会破坏 JSON 序列化、历史撤销、数据复制与导出的一致性;后端已有 inline `lineData` 时在导入边界扁平化为 `lines` + `channel.lineIds`。
|
|
136
|
+
- **核心文件**:`src/gis-view/create.js`、`types.d.ts`、`src/gis-view/README.md`、`docs/manual/10` / `14` / `16` / `17` / `18`、`docs/steps/selftest-features.html`、`docs/demos/api-index.js`、本页与维护索引。
|
|
137
|
+
- **验证**:`node --check src/gis-view/create.js`、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs` 与 `--check`、`npm run check:docs`(287 / 282 / 100 / 265)、`npm run build`、`git diff --check` 通过;`selftest-features` **905/0**、`selftest-select` **118/0**、`selftest-docs` **139/0**。公开面不变(287 个实例成员 / 282 个方法 / 100 options / 265 数据字段)。
|
|
138
|
+
|
|
139
|
+
## 同日前五轮:批量补丁命名口径、通道联动与性能收口(2026-11-04)
|
|
140
|
+
|
|
141
|
+
- **需求来源**:根目录 `修改.txt` 三条 —— ① `updateLine`、`removeLine` / `removeLines` 会不会同步通道里的线路;② 如何批量更新通道、批量更新线路;③ 继续优化组件性能。同日上一轮已先补齐「通道内只改部分回线」与 `removeChannels` 批量删除。
|
|
142
|
+
- **命名口径(同日补充,后续已补齐批量版)**:`patchChannels` / `patchLines` 分别是 `updateChannel` / `updateLine` 的批量版:单条 `update*` 返回 `this`,批量 `patch*` 返回 `{ ok, indexes, items, count, skipped }`;`patchChannels` 同样接受逐条或公共第二 / 三 / 四段,改成员 / 分组时另发 `channelGroups`。整份替换统一走 `updateData({ points | lines | channels })`。旧的 `updatePoints` / `updateLines` / `updateChannels` 已按去重要求删除,不再作为别名恢复;`updatePoints` 等仍可作为数据变更事件类型名出现。源码 / 类型注释、手册 10 / 14 / 16 / 17 / 18、手册 17 成员计数与 `selftest-select` 断言同步,公开面不变。
|
|
143
|
+
- **联动口径**:`updateLine()` 只更新线路数据与绘制,普通字段补丁不会重写通道的 `lineIds` / `groups`;通道成员的颜色、宽度、名称、装饰会立即生效,几何仍由通道骨架推导,`path` 不能覆盖实际折线(改中间拐点用 `setLineWaypoints`,改骨架用 `setChannelPath`)。显式 `groupId` / `groupIndex` 是分组指令,仍会走 `moveChannelLine` 那一套。`removeLine()` / `removeLines()` 会同步从顶层与各组 `lineIds` 摘掉成员、删除空组;最后一条成员删除时整条通道一起删除,返回值分别给 `removedChannel` / `removedChannels`。
|
|
144
|
+
- **批量更新**:新增 `patchChannels(entries, patch?)`,支持逐条 `{ id | index, ...补丁 }` 与「一批定位 + 公共补丁」,可改 `groups` / `lineIds` / 单组 `group`;整批只推一次 `engine.setChannels()`、只记一步历史、只发一条 `updateChannels`,改过成员或分组的通道另发 `channelGroups`。`patchLines(entries, patch?)` 的批次交给引擎一次收尾;整份替换统一用 `updateData({ lines })`,旧的 `updateLines(lines)` 实例方法已移除。混合通道声明与成员回线时用 `batch()` 收成一个数据变更。
|
|
145
|
+
- **性能收口**:`patchChannels` 在批量定位前先建通道 id 表,避免逐条线性扫描退化成平方级;`engine.updateLines(entries)` 逐条仍走 `updateLine()` 的定向解析,但把 `refreshWaypointBatch()` / `refreshStateVisuals()` / `requestRender()` 从每条一次收为整批一次。无头 Chrome + ANGLE / D3D11、400 通道 × 4 回线(1600 条线)、5 轮中位数:逐条 `batch(updateChannel)` **532.8 → 1.7 ms**,逐条 `batch(updateLine)` **4.6 → 3.2 ms**;线路侧只收批次收尾,不夸大成数量级提升。
|
|
146
|
+
- **类型与文档**:`types.d.ts` 新增 `GisViewChannelPatch` / `GisViewChannelUpdateItemEntry`、`patchChannels` 与 `updateChannels` / `removeChannels` 数据变更类型;手册 04 / 06 / 10 / 16 / 17 / 18 / 20、实现原理、组件 README、API 索引与自测同步。公开实例成员 286 → **287**(方法 281 → **282**),options 仍 100,`check:docs` 实测数据字段 265。
|
|
147
|
+
- **核心文件**:`src/gis-view/create.js`、`engine.js`、`types.d.ts`、`docs/manual/04` / `06` / `10` / `14` / `16` / `17` / `18` / `20`、`docs/internals/15-04`、`docs/GisView.md`、`src/gis-view/README.md`、`docs/demos/api-index.js`、`docs/steps/selftest-features.html` / `selftest-demos.html` / `selftest-docs.html` / `selftest-select.html`、本页与维护索引。
|
|
148
|
+
- **验证**:`node --check src/gis-view/create.js` / `engine.js`、`npx tsc --noEmit`、API 索引重建与 `--check`、`npm run check:docs`(287 个实例成员 / 282 个方法 / 100 个 options / 265 个数据字段)、`npm run build`、`git diff --check` 通过;命名补充轮次复跑 `selftest-select` **118/0**、`selftest-docs` **139/0**、`selftest-features` **892/0**。完整 14 页回归 13 页全绿;`selftest-scale` 126/2,两条旧断言仍期待“只改 name 也重算筛选”,与现有 `filterNeedsPatchRerun` 的设计(name 不参与筛选时跳过重算)冲突,非本轮引入。
|
|
149
|
+
|
|
150
|
+
## 前一轮次:交互权限唯一入口与经纬度存档回灌(2026-11-03)
|
|
151
|
+
|
|
152
|
+
- **需求来源**:根目录 `修改.txt` 两条 —— ① `mapDataToLngLat()` 保存后的数据要能原样映射回地图,并在 demo 中体现;② `clickable`、`boxSelect` 这类交互权限统一只通过 `features` 配置。
|
|
153
|
+
- **权限收口**:七个旧顶层交互开关 `draggable` / `interactive` / `clickable` / `boxSelect` / `multiSelect` / `toggleSelect` / `waypointEditable` 全部从公开 options 删除。`pickEngineOptions()` 的平移、缩放、悬停、选中、右键、拖拽、框选、多选、取反与拐点权限只从 `features` 计算,引擎内部 `interactive` / `clickable` 总闸固定为 `true`;`featureState()` 也不再回读旧顶层字段。创建与 `updateOptions()` 收到旧字段时逐项发出迁移提示并忽略,`getOptions()` 不再残留。节点级 `clickable` / `draggable`、线路级 `waypointEditable`、标签级 `draggable` 与 `features` 内的同名别名仍保留,分别负责逐要素覆盖与表内输入。
|
|
154
|
+
- **逆映射与 Demo**:新增 `mapLngLatToData(data, options?)`,按当前最终底图投影把存着经纬度的 `points` / `lines` / `channels` 写回世界坐标,覆盖线路端点 / 路径、固定坐标装饰、通道分组路径与 `waypointOffsets` 向量;返回副本、不改入参,没有 GeoJSON 背景时为 `null`。`BackgroundDemo.vue` 增加保存、清空、回灌三步和首节点误差读数,证明底图未改动时世界坐标与屏幕落点原样恢复。
|
|
155
|
+
- **测试与公开面**:`selftest-features` **881/0** 覆盖几何往返、入参不变、保存 → 清空 → 回灌,以及七个旧字段在创建与更新时告警、被忽略、不留进 `getOptions()`;`selftest-demos` **446/0** 覆盖背景 Demo 的三步流程。公开面为 **285** 个实例成员(280 方法 + 5 属性)/ **100** options / **275** 数据字段 / 44 事件 / 19 功能开关。
|
|
156
|
+
- **核心文件**:`src/gis-view/features.js`、`create.js`、`projection.js`、`types.d.ts`、`docs/demos/BackgroundDemo.vue`、`docs/steps/selftest-features.html`、`docs/steps/selftest-demos.html`;手册 02 / 03 / 04 / 07 / 08 / 10 / 16 / 17 / 18 / 21、`docs/format/02`、`docs/GisView.md`、`docs/index.html`、API 索引、组件 README、本页与维护索引。
|
|
157
|
+
- **验证**:`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`(285 成员 / 280 方法 / 100 options / 275 数据字段)、`npm run build`、`git diff --check` 通过;串行自测 `selftest-features` **881/0**、`selftest-demos` **446/0**、`selftest-docs` **139/0**、`selftest-actions` **96/0**、`selftest-select` **118/0**、`selftest-data` **103/0**、`selftest-perf` **201/0**、`selftest-effects` **96/0**。
|
|
158
|
+
|
|
159
|
+
## 上一轮次:拖动权限收口与网架坐标反投影(2026-11-03)
|
|
160
|
+
|
|
161
|
+
- **需求来源**:根目录 `修改.txt` 两条 —— ① `draggable` 不应继续保留在顶层 options,而应归入 `features`;② GeoJSON 背景编辑(缩放 / 平移 / 旋转)后,提供一个方法把网架世界坐标 `x/y` 批量转换为基于该 GeoJSON 的经纬度。
|
|
162
|
+
- **拖动开关收口**:`pickEngineOptions()` 下发给引擎的 `draggable` 改为只由 `featureOn(features, 'drag', false)` 计算,`featureState().drag` 缺省为 `false`;顶层 `draggable` 从公开 `GisViewOptions` 删除,创建或 `updateOptions` 传入时经 `onWarning` 提示改用 `features: { drag: true }` 并忽略(创建与 `updateOptions` 都不会把它留进 `getOptions()`)。`features` 内的 `draggable` 别名、节点 `draggable` 与标签 `draggable` 保留,分别负责表内映射和逐要素行为。
|
|
163
|
+
- **坐标反投影**:`projection.js` 的 `createGeoMapper()` 新增 `mode: 'world'`,以调用当时的最终底图投影 `unproject` 反算经纬度,包含 `aspectScale`、背景编辑后的 `bounds` / `rotation`;`waypointOffsets` 继续按向量换算。`create.js` 新增 `mapDataToLngLat(data?, options?)`:不传 data 时转换当前 `points` / `lines` / `channels`,返回副本,不改原数据和视图,也不自动 `updateData()`;没有 GeoJSON 背景时返回 `null`。
|
|
164
|
+
- **回归与公开面**:`selftest-features` 876 → **879/0**,新增 world 反投影 / 旋转往返 / 向量换算、背景编辑后整份网架转换且原数据不变、顶层旧写法告警与节点拖不动三条;公开面为 **284** 个实例成员(**279** 方法 + **5** 属性)/ **106** options / **275** 数据字段 / 44 事件 / 19 功能开关 / 16 分组。
|
|
165
|
+
- **核心文件**:`src/gis-view/create.js`、`projection.js`、`features.js`、`engine.js`、`types.d.ts`、`src/gis-view/README.md`;手册 02 / 03 / 04 / 07 / 08 / 16 / 17 / 18 / 21、`docs/format/02`、`docs/GisView.md`、`docs/index.html`、Demo 与 `docs/steps/selftest-*`、`docs/demos/api-index.js`、本页与维护索引。
|
|
166
|
+
- **验证**:`node --check`(`create.js` / `projection.js` / `features.js` / `engine.js`)、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`(284 个实例成员 / 106 个 options / 275 个数据字段)、`npm run build`、`git diff --check` 通过;串行自测 `selftest-features` **879/0**、`selftest-actions` / `selftest-effects` / `selftest-perf` / `selftest-demos` / `selftest-docs` 0 FAIL。
|
|
167
|
+
|
|
168
|
+
## 上两轮次:features 权限收口与点聚合自定义样式(2026-11-03)
|
|
169
|
+
|
|
170
|
+
- **需求来源**:根目录 `修改.txt` 两条 —— ① 将分散的权限统一收进 `features` 控制,例如 `draggable`,并明确 `features` 是对象还是数组;② 点聚合支持自定义颜色、图标等外观。
|
|
171
|
+
- **features 收口**:`features` 的规范写法是对象 `{ 开关名: boolean }`,也接受预设名与布尔值,不是数组。`FEATURE_NAMES` 新增 `multiSelect` / `toggleSelect` 后共 **19** 个规范开关;新增 `FEATURE_ALIASES`,把 `draggable` 映射到 `drag`、`waypointEditable` 映射到 `waypoint`、`interactive` 映射到 `pan` / `zoom` / `contextMenu`、`clickable` 映射到 `hover` / `select`。同一对象同时写别名与规范名时规范名优先;数组写法经 `onWarning` 提示后忽略,未写开关仍回退到各自的详细配置。`getFeatures()` 只返回 19 个规范键。
|
|
172
|
+
- **聚合样式**:`cluster` 新增 `color` / `strokeColor` / `strokeWidth` / `opacity` / `textColor` / `fontSize` / `symbol` / `showCount` / `sizeScale`。`symbol` 支持内置 `circle` / `square`、SVG / 图片与自定义图元;内置形状继续走形状批次,SVG / 图片 / 自定义图标走独立贴图批次,绘制顺序保持普通点 → 聚合标识 → 拐点,贴图异步就绪后自动重排。默认外观保持蓝色圆、白色 2px 描边与自动 12 / 13px 数量文字,`sizeScale` 同时作用于展示与拾取半径。
|
|
173
|
+
- **读数与导出**:`getClusters()` / `getPointCluster()` / 聚合拾取载荷 / `snapshotScene()` / SVG 导出共用解析后的样式;`showCount: false` 同时关闭数量 DOM 与导出文字,关闭聚合或销毁时释放聚合图标 VAO。SVG 导出按解析后的图标类型判断,不再只比较原始 `symbol === 'circle'`。
|
|
174
|
+
- **回归与公开面**:`selftest-features` 871 → **876/0**,覆盖别名映射、规范名优先、数组告警、自定义聚合样式、数量显隐与导出;`selftest-perf` **201/0**、`selftest-demos` **442/0**。公开面保持 283 个实例成员 / 107 个 options / 276 个数据字段 / 44 个事件 / 16 个分组,功能开关 17 → **19**。
|
|
175
|
+
- **核心文件**:`src/gis-view/features.js`、`create.js`、`engine.js`、`cluster.js`、`overlay.js`、`svg.js`、`index.js`、`types.d.ts`、`src/gis-view/README.md`;手册 03 / 04 / 08 / 16 / 17 / 18 / 20 / 21、`ClusterDemo.vue`、Demo 组合式函数、`selftest-features.html` / `selftest-perf.html` / `selftest-demos.html`、`docs/demos/api-index.js`、本页与维护索引。
|
|
176
|
+
- **验证**:`node --check`(`cluster.js` / `engine.js` / `create.js` / `features.js` / `overlay.js` / `svg.js`)、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`(283 个实例成员 / 107 个 options / 276 个数据字段 / 19 个功能开关)、`npm run build`、`git diff --check` 通过;串行自测 `selftest-features` **876/0**、`selftest-perf` **201/0**、`selftest-demos` **442/0**。
|
|
177
|
+
|
|
178
|
+
## 上三轮次:GeoJSON 投影闭环、背景解析性能与嵌套数据映射(2026-11-03)
|
|
179
|
+
|
|
180
|
+
- **需求来源**:根目录 `修改.txt` 两条 —— 修改 gis-view 组件;深度优化组件性能并排查 bug;考虑添加地图 GeoJSON 时坐标与经纬度如何映射。
|
|
181
|
+
- **GeoJSON 解析**:进入剖分前统一清理非法点、相邻重复点与闭合尾点,描边不再复制闭环节点;凸环直接 O(n) 扇形剖分,凹环与带洞面改用 `Int32Array` prev / next 双链表耳切,并在内点检查前先做三角形包围盒预筛。先剔除没有可见几何的 Feature,再计算 `rawBounds` 与 `aspectScale` 中心,避免无效要素把相机落位和投影带偏。
|
|
182
|
+
- **最终投影**:`placeGeoJsonBounds()` 返回实际使用的缩放、平移、旋转中心与角度,`resolveGeoJson()` 输出 `drawTransform`;`createGeoProjection()` 先套 `aspectScale`,再合成 `geoJsonStyle.bounds / rotation`,因此 `getGeoProjection()`、事件 `lngLat`、`focusOn({ lngLat })` 与最终底图严格重合。旋转 cos / sin 在整份底图解析时只算一次。
|
|
183
|
+
- **数据映射**:`createGeoMapper()` 的 `lngLat` / `scale` 与最终底图同源,默认 `scale: 1` 才真正与底图重合;`fit` 范围补齐线路 `start` / `end` 与通道 / 分组路径。映射同时认 `[x, y]` 与 `{ x, y }`,覆盖线路 `path` / `start` / `end`、节点 / 线路固定坐标装饰、通道 `groups[].path`;`waypointOffsets` 按 `map(offset) - map([0, 0])` 做向量换算,避免叠加平移。屏幕像素偏移与尺寸 / 线宽保持原值。
|
|
184
|
+
- **性能实测**:Node 同进程微基准,6000 点凸环 `buildGeoJsonShapes()` 中位 **50.98 → 2.97 ms**,6000 点凹环 **49.16 → 23.13 ms**,两种输入改前 / 改后三角形数均为 **5998**。测量为 2 次预热 + 5 次计时取中位。
|
|
185
|
+
- **回归**:`selftest-features` 866 → **871/0**,新增旋转 / 平移后的投影重合、默认 `scale` 与 `aspectScale` 对齐、`start/end` 与通道分组 / 固定装饰 / 对象坐标映射、`waypointOffsets` 旋转向量、GeoJSON 退化环归一化断言;`selftest-docs` **139/0**、`selftest-demos` **441/0**、`selftest-full` **94/0**、`selftest-perf` **197/0**。
|
|
186
|
+
- **核心文件**:`src/gis-view/geojson.js`、`background.js`、`projection.js`、`types.d.ts`、`src/gis-view/README.md`、`docs/steps/selftest-features.html`;手册 02 / 14 / 16 / 17 / 18 / 20、internals 04 / 14、from0 01、`docs/demos/api-index.js`、本页与维护索引。
|
|
187
|
+
- **验证**:`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`(283 个实例成员 / 107 个 options / 276 个数据字段)、`npm run build`、`git diff --check` 通过;构建仅有既有的大 chunk 提示。公开面未新增或删除成员、options、数据字段。
|
|
188
|
+
|
|
189
|
+
## 上四轮次:特征解析半账合并、线路路径复用与定向更新收口(2026-11-03)
|
|
190
|
+
|
|
191
|
+
- **需求来源**:根目录 `修改.txt` —— 修改 gis-view 组件,继续优化组件性能并排查 bug。
|
|
192
|
+
- **解析与分层**:逐要素状态样式与 `effect` 拆成点 / 线两半记账,在 `resolveFeatures()` 各自的解析循环里顺路记完;`finishFeatureResolve()` 只补扫没有真正解析过的那一半,只换背景或只动一半数据时不再回头整份扫原始数组。`resolvePointLayers()` 首趟顺手清零 `layerRank`,不分层时省掉第二趟;`resolveLineLayers(knownLayered)` 可以复用解析循环已知的“有没有 zIndex”,整半复用与增量删除则传 `undefined` 让层序自行重扫,避免误清带层级线路的顺序。
|
|
193
|
+
- **线路路径**:新增 `resolveLinePathFromBounds()`,线路端点由 `resolveRenderedLinePath()` 一次性取齐通道骨架 / 隐藏成员 / `from` / `to` / 静态路径,整份解析与定向几何更新共用;实线共用 `SOLID_DASH_STYLE`,`resolveLine()` 不再为每条线预造两份马上被替换的 `segments` / `caps` 数组。
|
|
194
|
+
- **Bug 修复**:① `updatePoint()` / `updateLine()` 首次补上状态样式或 `effect` 时同步维护总账,修复立即选中不生效、动画时钟 / 实例不启动;② 整半复用线路解析时不再把 `lineLayered` 当 `false`,修复只换背景会清空线路 `zIndex` 层序;③ 绑定节点改名后定向更新拿到空路径时不再触发 `new Array(-1)` 的 `RangeError`,改为按局部路径安全收口;④ 删除最后一个带 `effect` 的节点后清零 `featurePointEffects`,不会一直把动画判成开启。
|
|
195
|
+
- **回归与性能**:`selftest-features` 859 → **866/0**,新增首次状态样式 / effect、线路层序复用、空路径与效果总账回归;`selftest-perf` **197/0**。10 万线级基准连续 5 次:`syncMs` 中位 **377.7 ms**(改前参照 423.1)、`readyMs` **179.2**(244.3)、`refresh()` **137.6**(121.2 ~ 165.8,改前 212.0)、`updatePoint` 首调 **3.4 ~ 6.4 ms** / 第二次 **1.9 ~ 3.0 ms**(改前 5.1 / 3.2),引擎保留内存中位 **206.2 MB**(改前 218.5),平移 p50 保持 **16.6 ~ 16.7 ms**。
|
|
196
|
+
- **核心文件**:`src/gis-view/engine.js`、`src/gis-view/line.js`、`src/gis-view/README.md`、`docs/steps/selftest-features.html`、本页与维护索引。
|
|
197
|
+
- **验证**:`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`(283 个实例成员 / 107 options / 276 个数据字段)、`npm run build`、`git diff --check` 通过;串行自测除 `selftest-scale` 的既有 2 条 `onFilter` 回调时序用例外均 0 FAIL。公开面未新增或删除成员、options、数据字段。
|
|
198
|
+
|
|
199
|
+
## 2026-11-02 轮次:装饰随选中要素抬层与可选跟随选中色(2026-11-02)
|
|
200
|
+
|
|
201
|
+
- **需求来源**:根目录 `修改.txt` 两条 —— ① 通道、线路或节点存在 `decorations` 时,被选中后装饰的层级也要跟所属要素一起提升;② 装饰颜色可以配置为跟随所属线路 / 节点一起变色。
|
|
202
|
+
- **抬层**:`engine.js` 在 `raisedLineIndexes` / `raisedPointIndexes` / `raisedLineEndpointIndexes` 的基础上,把线路装饰与节点装饰分别归入抬层段。选中线路或通道回线时,整条通道的成员回线装饰一起抬层;选中节点时节点装饰抬层;选中线路的两端节点已有端点抬层逻辑,其装饰沿用同一判断。`snapshotScene()` 新增 `raisedDecorations`,绘制次序固定为普通装饰 → 抬层线路 → 抬层装饰 → 抬层节点,`svg.js` 的矢量导出按同一顺序输出。
|
|
203
|
+
- **跟随选中色**:线路 / 节点装饰新增 `followSelectColor`(缺省 `false`)。打开后仅在所属线路 / 节点被选中时取该要素的最终选中色(包含 `selectStyle`、多选 / 框选状态链的结果);颜色写到哪个通道由 `symbol` 决定:`{ type: 'svg', path }` 写 `strokeColor`、填充保留自身 `color`,其他符号写 `color`、描边保留自身 `strokeColor`。节点连接线与位图本身不跟随,取消选中后恢复装饰自身颜色。动态装饰草稿的配置、归一化、提交载荷与事件载荷都贯通该字段,`updateDecorationDraft({ followSelectColor: false })` 可关闭。
|
|
204
|
+
- **快路径**:`selectionOnTop: false` 时不做抬层重排,但线路装饰的 restyle 快路径会先检查 `followSelectColor`,节点装饰的槽位补丁也会重算颜色;选中 / 取消选中都不会留下旧色。
|
|
205
|
+
- **回归与文档**:`selftest-features` 新增选中线路 / 节点装饰的抬层、颜色往返、SVG path 选中描边 / 普通符号选中填充、像素叠放、SVG 顺序、`selectionOnTop: false` 与整条通道成员装饰断言;通道测试夹具补 `circuits: 2`,确保第二条回线确实属于通道。842 → **859/0**。手册 02 / 03 / 08 / 12 / 15 / 16 / 17、格式 02 / 03、`types.d.ts` 与组件 README 同步。公开面保持 283 个实例成员 / 107 options,数据字段 275 → **276**。
|
|
206
|
+
- **核心文件**:`src/gis-view/engine.js`、`src/gis-view/svg.js`、`src/gis-view/types.d.ts`、`src/gis-view/README.md`;`docs/manual/02` / `03` / `08` / `12` / `15` / `16` / `17`、`docs/format/02` / `03`、`docs/steps/selftest-features.html`、`docs/demos/api-index.js`、本页与维护索引。
|
|
207
|
+
- **验证**:`node --check src/gis-view/engine.js` / `svg.js`、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`(283 个实例成员 / 107 options / 276 个数据字段)、`npm run build`、`git diff --check` 通过;串行自测 `selftest-features` **859/0**、`selftest-decoration` **75/0**、`selftest-select` **118/0**、`selftest-actions` **96/0**、`selftest-demos` **441/0**、`selftest-docs` **139/0**、`selftest-perf` **197/0**。
|
|
208
|
+
|
|
209
|
+
## 2026-11-02 更早轮次:框选线路 / 通道按实际折线路径命中(2026-11-02)
|
|
88
210
|
|
|
89
211
|
- **需求来源**:根目录 `修改.txt` —— 修改 gis-view 组件,检查框选为什么有时候会框选到不在框选区域的通道。
|
|
90
212
|
- **根因**:`engine.js` 的 `collectLinesInBox()` 通过 `forEachLineInView()` 取候选,而后者只按线路包围盒与选框相交筛选。U 形 / 折返 / 绕行线路的包围盒可以覆盖选框,实际折线却可能离框很远;通道回线一旦被粗筛命中,后续还会按 `channelSelectMode` 摊开整组 / 整条通道,表现为选中了框外通道。
|
|
@@ -93,7 +215,7 @@
|
|
|
93
215
|
- **核心文件**:`src/gis-view/engine.js`、`src/gis-view/types.d.ts`、`docs/manual/03-配置项.md`、`docs/manual/08-选中与拐点.md`、`docs/steps/selftest-select.html`、`src/gis-view/README.md`、`docs/AI对话汇总.md`、`docs/ai/06-会话索引与复查方法.md`。
|
|
94
216
|
- **验证**:`node --check src/gis-view/engine.js`、`npx tsc --noEmit`、`node docs/steps/gen-api-index.mjs`、`npm run check:docs`、`npm run build`、`git diff --check` 通过;串行自测 `selftest-select` **118/0**、`selftest-features` **842/0**、`selftest-actions` **96/0**、`selftest-demos` **441/0**、`selftest-docs` **139/0**、`selftest-perf` **197/0**。
|
|
95
217
|
|
|
96
|
-
##
|
|
218
|
+
## 2026-11-02 再早轮次:toggleSelect 节点 / 线路 / 通道 / 分组核验与 visualMap 多目标门控(2026-11-02)
|
|
97
219
|
|
|
98
220
|
- **需求来源**:根目录 `修改.txt` —— ① 检查 `toggleSelect` 是否真的生效;② 续查对线路、通道和通道分组的取消是否生效;③ 反馈再次点击通道 / 线路 / 分组不会取消、只有节点能取消;④ 前一轮的 `visualMap` 交互没有效果、不会隐藏网架。
|
|
99
221
|
- **toggleSelect 根因与修复**:入口原先只看命中的那一条线路 `result.selected`。通道分组 / 整条通道只选中一部分,或点到组内、通道内的另一条回线时,这个值可能为 false,点击于是落到普通单选并重新选上,看起来只有节点能取消。现在 `engine.js` 抽出 `selectionScopeKeysOf()` 按 `channelSelectMode` 取得完整范围,`toggleSelect` 用范围 `anySelected` 判断,并以 `removeOnly` 整批取消;Ctrl / 多选仍保持原来的“整批取反 / 补缺”语义。独立线路、通道单条、完整分组、部分分组、完整通道、部分通道都有真实指针回归;`onClick` / `onSelectChange` 的动作名都是 `toggleSelect`。`selftest-select` 新增 6 条,107 → **113/0**。
|
package/docs/GisView.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
`GisView` 是一套不依赖任何第三方图形库的 WebGL2 矢量视图:渲染层是原生 WebGL2(GLSL ES 3.00 + 实例化绘制),交互层只有指针与滚轮,界面只内置可选的小地图、热力图图例与背景编辑器(分别配 `minimap` / `visualMap` / 调 `beginBackgroundEdit()` 才有,见「鹰眼图」「图例(visualMap)」「背景层」),其余全靠使用方。它没有 Vue 组件形态,用 `createGisView(dom, options)` 把画布直接挂到传入的 DOM 上,宽高默认跟随容器。
|
|
4
4
|
|
|
5
|
-
控制面板与读数面板不内置;需要热力图图例时也不必自建:`options.visualMap` 会画一条带刻度的连续色带(`ruler` / `continuous`)或一组分段色块(`piecewise`),默认跟随 `heatmap` 的字段、值域与颜色。显式写 `target` 时选区只门控这一类;不写时展示值域取第一类有数值的启用目标,选区却覆盖全部启用目标上同 `field` 的热力上色、光晕与密度。图例本身就能点选分段、拖动筛选区间;默认继承主图热力的鹰眼图同步门控,显式 `minimap.heatmap` 仍独立。落选值由 `outOfRange` 选择只回普通样式(`'heatmap'`,缺省)、把对应节点 / 独立线路 / 通道一起隐藏(`'network'`),或完全不做内置门控而只发 `onChange`(`'none'`);三种方式都不删除数据、不改筛选。额外业务联动仍可听 `onChange`。需要「再次点击已选中要素即取消」时打开 `toggleSelect`(缺省关),普通单击、双击与 Ctrl 选中后的普通单击都适用。需要完全换一套外观时用 `render(context)` 接管内容,不必再写插件。其余样式和布局由使用方决定,后续改样式不需要等待组件升级。数据侧该有的都给了:按属性筛选(默认只隐藏,也可显式从数据删除;点被过滤时绑定线路与通道一起消失,大数据量走 Web Worker)、按属性批量配色换符号、节点标签与点 / 线 / 通道的悬浮提示,都可以通过 options 或实例方法配置。
|
|
5
|
+
控制面板与读数面板不内置;需要热力图图例时也不必自建:`options.visualMap` 会画一条带刻度的连续色带(`ruler` / `continuous`)或一组分段色块(`piecewise`),默认跟随 `heatmap` 的字段、值域与颜色。显式写 `target` 时选区只门控这一类;不写时展示值域取第一类有数值的启用目标,选区却覆盖全部启用目标上同 `field` 的热力上色、光晕与密度。图例本身就能点选分段、拖动筛选区间;默认继承主图热力的鹰眼图同步门控,显式 `minimap.heatmap` 仍独立。落选值由 `outOfRange` 选择只回普通样式(`'heatmap'`,缺省)、把对应节点 / 独立线路 / 通道一起隐藏(`'network'`),或完全不做内置门控而只发 `onChange`(`'none'`);三种方式都不删除数据、不改筛选。额外业务联动仍可听 `onChange`。需要「再次点击已选中要素即取消」时打开 `features: { toggleSelect: true }`(缺省关),普通单击、双击与 Ctrl 选中后的普通单击都适用。需要完全换一套外观时用 `render(context)` 接管内容,不必再写插件。其余样式和布局由使用方决定,后续改样式不需要等待组件升级。数据侧该有的都给了:按属性筛选(默认只隐藏,也可显式从数据删除;点被过滤时绑定线路与通道一起消失,大数据量走 Web Worker)、按属性批量配色换符号、节点标签与点 / 线 / 通道的悬浮提示,都可以通过 options 或实例方法配置。
|
|
6
6
|
|
|
7
7
|
**这份手册按主题拆成了 21 章,正文在 [`docs/manual/`](manual/) 下**:找方法先看 [16 实例方法总表](manual/16-实例方法总表.md),查参数跳 [17 参数速查](manual/17-参数速查.md),要能直接复制的调用看 [18 逐方法示例](manual/18-逐方法示例.md);只想先跑起来看 [01 快速开始](manual/01-快速开始.md)。
|
|
8
8
|
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
| [14 视图与筛选](manual/14-视图与筛选.md) | 筛选、搜索定位、初始视图与缩放范围、背景层、鹰眼图、近义入口 |
|
|
33
33
|
| [15 导出与集成](manual/15-导出与集成.md) | 导出图片 / 选中节点 / 数据、自定义导出格式,插件、自建界面与键盘交互 |
|
|
34
34
|
| [16 实例方法总表](manual/16-实例方法总表.md) | 按功能分组的实例方法主表(找方法从这一章开始) |
|
|
35
|
-
| [17 参数速查(逐个方法)](manual/17-参数速查.md) |
|
|
35
|
+
| [17 参数速查(逐个方法)](manual/17-参数速查.md) | 287 个成员逐个列全:参数、默认值与返回 |
|
|
36
36
|
| [18 逐方法示例(复制就能跑)](manual/18-逐方法示例.md) | 每个成员一段可复制的调用示例(API 速查页读的就是这一章) |
|
|
37
37
|
| [19 读数与拖拽预览](manual/19-读数与拖拽预览.md) | 自建界面常用的读数 / 定位方法;拖拽落点预览 |
|
|
38
38
|
| [20 性能与大数据](manual/20-性能与大数据.md) | 十万级数据的开关与实测、WebGPU 取舍、渲染后端开关 |
|