# GIS-Mate **Repository Path**: konvil/gis-mate ## Basic Information - **Project Name**: GIS-Mate - **Description**: 一款浏览器插件,用于把 Excel 清单里的全景 / VR 场景按经纬度标注到 GIS 地图站点上:鼠标悬停查看拍摄信息,点击即在当前页面内打开实景。支持本地离线包与清单里的线上网址两种来源。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-18 - **Last Updated**: 2026-10-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 小海GIS助手(GIS Mate) 把 Excel 清单里的全景 / VR 场景按经纬度标注到 GIS 地图站点上:鼠标悬停查看拍摄信息, 点击即在当前页面内打开实景。支持本地离线包与清单里的线上网址两种来源。 适用于水上巡检、航道踏勘、园区安防、施工记录等任何「地图 + 实景」的对照场景。 --- ## 功能 | 能力 | 说明 | |---|---| | 热点标注 | 按经纬度把场景画到地图上,悬停显示名称 / 设备 / 高度 / 时间 | | 实景浏览 | 点击热点在页面内打开,支持浮窗与右侧分屏两种模式 | | 密码自动填入 | 配好场景密码后,打开带密码的作品自动填写并点「确认」 | | 自动进入 | 密码通过后自动点击封面,无需手工操作 | | 图标样式 | 水滴 / VR 相机 / 五角星 / 图钉 四种外形,三档尺寸(小 / 中 / 大) | | 打开方式 | 自动判断(探测本地可达性)/ 仅本地 / 仅线上 三种,横排按钮切换 | | 坐标纠偏 | WGS84 / GCJ-02 自动换算,支持整体平移微调 | | 深浅主题 | 跟随系统 / 强制浅色 / 强制深色 | ## 安装 ### 从源码构建 ```bash node build.js chrome # 生成 dist/gis-mate-chrome/ node build.js firefox # 生成 dist/gis-mate-firefox/ node build.js all # 两个都生成(默认) node build.js zip # 额外打成 zip,发布到 AMO 用 ``` 构建无任何第三方依赖,Node 14+ 即可。 ### 加载到浏览器 - **Chrome / Edge**:`chrome://extensions` → 开发者模式 → 加载已解压的扩展程序 → 选 `dist/gis-mate-chrome` - **Firefox**:`about:debugging#/runtime/this-firefox` → 载入临时附加组件 → 选 `dist/gis-mate-firefox/manifest.json` > Firefox 的 MV3 不自动授予网站访问权限,首次使用需在插件面板里点「授予权限」, > 然后**刷新一次地图页面**(授权不会让脚本注入到已打开的标签页)。 ## 使用 1. 在「数据」页点**下载模板**,用 Excel 打开按列填写(表头已含示例行)。 2. 点**导入 Excel 清单**选择文件。清单的「原网址」列需填完整的 720云场景地址, 「仅本地」以外的两种模式都直接使用它。 3. 打开受支持的地图站点,热点自动出现。 ### 支持的地图站点 | 站点 | 地址 | 地图引擎 | |---|---|---| | 船顺网 | `www.ships66.com` | OpenLayers | | 船讯网 | `www.shipxy.com` | Leaflet | | 导助航综合服务系统 | `ais.msa.gov.cn` | OpenLayers | **新增站点只需改 `src/shared/site-config.js` 一个文件** —— manifest 的 `host_permissions` 与 `content_scripts.matches` 由构建脚本自动注入, 手工维护两处必然漏改。 ### 关于本地离线包 720 云导出的离线包通常跑在 `http://127.0.0.1:10000`(插件已默认填好): - **打开方式**选「自动判断」时,插件会真正探测它能否访问,能则用本地、不能自动回退清单里的线上网址。 - Chrome 142+ 首次访问会弹「是否允许访问本地网络设备」,请点**允许**。 这是浏览器新增的本地网络访问(Local Network Access)限制,与插件无关。 ## 目录结构 ``` src/ popup/ 扩展面板(HTML / CSS / JS) content/ 内容脚本:注入页面脚本、VR 窗口、场景密码自动填入 page/ 注入到页面世界(MAIN world):地图探测、热点渲染 shared/ popup 与 content 共用的逻辑(场景数据、地址解析、坐标纠偏、站点清单) lib/ XLSX 解析、地图探测、投影换算 build.js 构建脚本:一份代码产出 Chrome / Firefox 两个包 manifest.*.json 两个平台的清单(差异仅在权限声明) ``` 代码分层遵循一条原则:**能在 `shared/` 里写的就写**。 列识别规则、地址拼接规则、坐标换算规则过去在多处各写一遍, 改了一处忘了另一处就会出现「面板显示的设置和实际行为不一致」。 ## 实现要点(给二次开发者) 这几处是踩过坑之后定下的,改动前请先读这段: **地图实例的存放方式,三个站点各不相同** - 船顺网:直接挂在 window 上 - 导助航综合服务系统:藏在 Vue 组件树里,最终在 Pinia store 的 `state.map`(一个原生 JS `Map`) - 船讯网:Leaflet,关在业务闭包中,需要从容器反查 `src/lib/probe.js` 因此是多路径探测。能拿到对方的构建产物时, **直接 grep 产物比猜属性名可靠得多**。 **覆盖层挂载点有两个正交约束** 1. 不能被渲染器每帧清空 —— OpenLayers 的 `renderFrame()` 会执行 `this.children_.length = 0` 清空 `.ol-layers` 2. 不能被不透明画布遮挡 —— 必须排在 `.ol-layers` **之后** 唯一解是插到 `.ol-layers` 之后、`.ol-overlaycontainer` 之前。 只解决一个约束会造成两种典型故障:插入 `.ol-layers` 里 → 图标疯狂闪烁; 插到它之前 → 图标完全看不见。Leaflet 则是挂在 `.leaflet-container` 本身 (挂进 `map-pane` 会叠加它的 `translate3d` 位移)。 **适配层最容易漏的是「写」方法** `src/page/page.js` 把 Leaflet 包装成 OL 风格接口时,只实现读方法 (`getView` / `getPixelFromCoordinate`)是不够的:`fitAll()` 用的 `view.setCenter` / `view.fit` 和 `flyTo()` 用的 `view.animate` 也必须实现, 否则点击热点后地图不会移动到场景位置。写接口只在特定交互路径上触发, 本地不容易测到。 **`pixelFromCoord` 不要改用 `map.getPixelFromCoordinate()`** 该方法读的是「上一帧」的状态,视图刚变化时返回值是过期的, 表现为「拖了地图,标记停在原处」。 **跨上下文通信的三个坑** - 页面世界(MAIN world)拿不到隔离世界的 `SceneCore`,所以 `page.js` 里的 部分格式化函数必须写一份本地兜底副本 —— 改一处记得改另一处 - 往 `postMessage` 里塞数据前要做净化:OL 等第三方对象带原型链, 结构化克隆会抛 `DataCloneError` - 密码绝不能进 `postMessage`,页面世界的任何脚本都能监听 message **本地可达探测必须在扩展页面里发起** 内容脚本跑在第三方站点页面中,那里的 `fetch` 受 CORS 与混合内容限制, 请求 `127.0.0.1` 会被直接拦掉,探测结果不可信。探测放在 `popup` 里做。 ## 许可 [MIT](LICENSE) ## LOGO ⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂ ⠂⠂⠂⠂⠂⠂⠂⣀⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣄⡀⠂⠂⠂⠂⠂⠂ ⠂⠂⠂⠂⢀⣴⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣦⡀⠂⠂⠂⠂ ⠂⠂⠂⢀⣾⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⡄⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⡿⠿⠿⠛⠛⠿⠿⢿⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣧⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⡿⠟⠉⢕⢕⢕⢕⢕⢕⢕⢕⢕⢕⠉⠻⢿⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⡿⠋⢕⢕⢕⢕⢀⣀⣤⣤⣤⣤⣀⡀⢕⢕⢕⢕⠙⢿⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⡟⠁⢕⢕⢕⣠⡾⠛⠉⠂⢀⣀⠂⠉⠙⠷⣦⡀⢕⢕⢕⢻⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⡟⠈⢕⢕⢠⡾⠃⢀⠄⠊⡡⠁⠈⠫⠑⠢⡀⠈⢻⡄⢕⢕⢕⢿⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⠃⢕⢕⢀⣫⠁⢀⠊⠂⢠⠁⠂⠂⠂⢃⠂⠈⠆⠂⢿⡆⢕⢕⠸⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⢕⢕⢕⢸⡏⠂⢨⠌⠌⣀⠂⠂⠌⠌⢸⠌⠌⢸⠂⢸⡇⢕⢕⢕⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⡇⢕⡇⠸⣷⠂⠰⠂⠂⢀⠂⠂⠂⠂⠘⠂⠂⡘⠂⣸⣷⢕⢕⢸⣟⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⡀⡀⠁⠻⣆⠂⠱⡀⠈⢄⠂⠂⢠⠁⢀⠔⠂⣠⣟⠅⢕⢕⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣷⡼⢦⢕⠙⢷⣄⠂⠑⠚⠦⠴⠕⠂⠁⣀⣴⡮⡿⢕⢀⣾⣟⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣞⢔⢕⠙⠝⠿⢶⣤⣤⣤⣤⣶⣾⣯⣟⠉⢕⣠⣾⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣟⣷⡀⢕⣀⣬⣼⣶⣢⣴⣶⡮⡮⡿⢕⢀⣴⣟⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣦⢕⡮⡮⡮⡮⡮⡮⡮⡮⡗⣠⣾⣟⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣟⣷⣝⢿⡮⡮⡮⡮⡮⢫⣾⣟⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣟⣶⡸⡮⡮⢟⣵⣫⣟⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠂⠂⠂ ⠂⠂⠂⢸⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣟⣫⣮⣱⣫⣟⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⡿⠂⠂⠂ ⠂⠂⠂⠘⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣟⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⠃⠂⠂⠂ ⠂⠂⠂⠂⠈⠻⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⣫⡟⠁⠂⠂⠂⠂ ⠂⠂⠂⠂⠂⠂⠈⠙⠛⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠟⠋⠁⠂⠂⠂⠂⠂⠂ ⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂