nVisual FiberMap 全面介绍零依赖的光缆网 GIS 竣工录入与出图工具摘要室外光缆工程的竣工资料录入长期面临数据量大、字段多、表格多、图数分离的难题。nVisual FiberMap 是一个在浏览器中运行的本地化工具在 GIS 地图上录入接头包、ODF、OLT、ONU、分光器、光纤跳线、井、管段、光缆段与管孔敷设关系记录接头包内的纤芯接续一键导出 Excel、PDF、PNG、DXF 四类竣工资料并可回传管理平台。本文从功能全景、四视图工作流、数据质量与交付、AI 助手与快速上手几个角度对这套工具做一次完整拆解。一、先看问题光缆竣工资料为什么难录做过室外光缆工程的人对下面这套流程不会陌生现场测量回来先在 CAD 里画路由、标井位、标接头包再在 Excel 里逐条登记接头包、光缆段、井、管段、敷设记录、纤芯接续交付时把图纸、台账、照片、PDF 打成一个包甲方核对一次就要翻一遍一旦现场变更图改了、表没改或者表改了、图没改两边对不上想查某根纤芯从哪儿来、到哪儿去只能靠人对着接续表逐行推。问题的根源不是工具不好用而是数据被拆成了图和表两份各记各的。CAD 保存的是线条Excel 保存的是字段两者之间没有引用关系也就无法自动校验、自动出图、自动统计。nVisual FiberMap 的思路很直接把地理空间数据点线位置和逻辑连接数据纤芯接续、管孔占用统一成一份结构化数据先录入数据再由数据生成图和表。工具运行在浏览器里后端只有一个本地的零依赖静态服务项目数据以 JSON 文件保存在本机。二、产品定位与整体面貌2.1 一句话定位nVisual FiberMap 是一个面向光缆网工程竣工资料的高效录入与出图工具在 GIS 地图或示意图上录入光缆网资源与连接关系自动完成接续校验、合规自检并一键导出四类交付物同时提供只读三维查看与自然语言 AI 助手。2.2 功能全景维度内容资源对象接头包、ODF光纤配线架、OLT、ONU、分光器1:41:64、光纤跳线、井、管段、光缆段、盘留点/跳线插头点虚拟对象四个视图① 光缆图GIS 地图→ ② 纤芯图接续示意图→ ③ 管井图井/管段/断面→ ④ 路由图敷设到管孔数据来源手工录入、工程量清单导入xlsx/csv/JSON、KML/KMZ 导入、依据光缆图生成管井、从管理平台获取管井多路径质量保障合规自检ERROR/WARN/INFO 三级、四套规则集、自动复测、问题定位交付物Excel单文件十一张表、PDF四视图 十一张数据表全程矢量、PNG地图全景图/当前视图范围、DXFCAD 竣工图分图层附加能力只读三维查看可选地形、AI 助手内置面板 外部 Agent 中继54 条指令、中英文界面运行方式Node.js 或 Go 单文件后端二选一前端无框架、无构建步骤项目数据存本地 JSON部署形态本机运行、局域网运行、Nginx 子路径部署如/fibermap/离线内网可用2.3 一个容易忽略的设计立场零依赖、无构建这套工具在技术选型上做了一个比较极端的决定不引入任何前端框架、不引入打包器、不引入 npm 依赖树。前端是原生 HTML Canvas ES Modules直接由浏览器加载后端有两个等价实现460 行的 Node.jsserver.js只用标准库和单文件 Gomain.go零第三方依赖go:embed把整个前端打进可执行文件构建产物是一个约 12.7 MB 的单文件可执行程序拷进内网就能跑不需要装 Node、不需要配环境、不需要联网。对一个要在内网、离线、甲方现场长期使用的工程工具来说这套路线的价值很实际没有依赖升级带来的瘫痪风险没有构建环境十年后打开源码仍然能直接改、直接跑。三、四视图工作流一条从设计到竣工的主线工具把整个光缆工程的数据录入拆成四个视图右上角用一条步骤条串联① 光缆图GIS设备 光缆 跳线 ↓ ② 纤芯图逻辑谁和谁熔接、谁成端到哪个端口 ↓ ③ 管井图管道井 管段 断面结构 ↓ ④ 路由图空间 逻辑合流光缆敷设进管孔 ↓ 合规自检 → 导出 Excel / PDF / PNG / DXF → 回传管理平台四个视图共用同一份项目数据只是关注点不同。下面逐一展开。3.1 光缆图GIS 地图上的资源录入光缆图是默认视图也是一切数据的起点。它是一张带底图的 GIS 地图支持 OSM、Google、高德、天地图、自定义瓦片源以及完全离线的经纬网格无本机配置时启动默认即离线经纬网格切换在线源后按视图各自记忆上面放置各类点对象点与点之间画线对象。1对象体系对象编号前缀视觉特征说明接头包JT…红色圆角方块 四角星光缆熔接/分支节点ODFODF…深青立式机柜 配线横条光纤配线架支持成端与跳接OLTOLT…深蓝横机框局端设备含 PON 口、上联口、管理 IP、SN 等属性ONUONU…品红方盒用户端设备含 ONU 类型、端口、SN/LOID、供电方式分光器FG…紫边空心三角光分路器符号1 路进、N 路出分光比 1:41:64光纤跳线TX…橘黄色细线设备/机架之间的短跳纤含类型/接口/芯数等专有属性井J…井盖图标人井、手井、引上井等管段GD…灰色双线井之间的管道含孔数与断面结构光缆段GL…亮蓝色线接头包之间的光缆含芯数、型号、皮长盘留点 / 插头点虚拟空心圆 / 空心小方块光缆自由端与跳线自由端的派生标记可拖动、可重新连接2高效率的录入交互光缆图在交互上下了不少功夫核心是少点击、少切换、可撤销连接点拖拽鼠标移到井、接头包、ODF、OLT、ONU 上即显示四个青色连接点无需选中从连接点拖到空白处自动新建对端对象并成段拖到已有同类对象则直接吸附成段还能链式连续拖出多段拖拽过程中实时显示距离一次拖拽创建的全部对象记一步撤销。线上吸附与自动分隔把接头包/ODF/OLT/ONU/分光器放到光缆段上、把井放到管段上时自动吸附并一分为二端点挂接、属性继承、皮长分摊、接续与敷设记录的归属全部自动处理。连续绘制按G画光缆段点起点接头包后每点下一个接头包就完成一段并自动从该节点续画管段同理。折点编辑选中光缆段后可直接拖动折点、双击线上插入折点、选中折点删除皮长随路径自动重估。多选与格式刷Ctrl点击加选/减选、Ctrl拖动框选、CtrlA全选支持批量删除与整体移动按M进入格式刷拾取一个对象的属性后单击或框选刷给同类型对象芯数、孔数缩小有安全校验。50 步撤销/重做CtrlZ/CtrlY删除时自动清理引用。3坐标一致性工程坐标是最容易埋雷的地方。这套工具的策略是内部存储统一使用WGS-84在 GCJ-02 底图高德、腾讯等上点放/拖动对象时自动反解为 WGS-84 存储显示时再加偏移对齐底图切换 WGS-84 ↔ GCJ-02 底图时视野中心自动同步换算屏幕中心始终对准同一地面位置不会出现切换底图后整体偏移约 500 米的现象地图可无限平移跨 180° 经线时经度自动归一到 ±180°。3.2 纤芯图把接续关系画清楚光缆图解决缆在哪纤芯图解决芯在哪。切到纤芯图工具会完全由光缆图数据自动派生出一张纤芯调度示意图不加载 GIS 底图也不改动任何光缆图的几何数据。1自动布局按缆段连通关系做 BFS 分层左 → 右层内用重心法排序减少连线交叉同层节点垂直堆叠、列内居中对齐多个连通分量与孤立接头包分开排布后按行打包保证节点互不重叠同一起终点的多条缆画成平行线垂直错开、端口互异光缆自由端在节点外侧生成盘留框标注盘留位置与芯数同侧多个盘留框纵向错开保证与接头包、其他盘留框都不重叠布局结果可手动拖动调整移动后缆线出线侧随实际方位自动换边入盒分线点沿边框滑动盒外缆线按避障直连重新布线不穿框、不与其他缆共线、折弯最少。2框内逐芯接线图这是纤芯图最有技术含量的部分每个接头包渲染成一个方形节点框内自动绘制完整的逐芯接线图。分线节点 光缆入盒点每根挂接光缆恰好一枚实心圆点落在缆线与边框的交点上自圆点向各条合并束斜线扇出同向连续芯合并为一条细实线每条束独占一条水平轨道斜线/竖线跨其他线时画半圆跳线表示交叉不相接轨道上的空心圆环是熔接点两端标注各缆的芯号区间标注排在分线带之外文字方向与所接缆线平行左右侧水平、上下侧竖排同一面上两根缆相接时标注写在斜线上、字号再小一倍。对分光器则改用空心三角光分路器符号顶点永远朝左进线角1 路进、底边永远朝右出线面N 路出出缆分光点沿底边按端口次序均匀错开。3批量接续编辑左侧面板按 A/B 两侧分组每侧是缆名下拉 芯号范围输入区间接续输入1-12或1-12,25-36容错全角逗号A/B 两侧按序批量配对只填一侧则另一侧同范围两侧留空等于按序直通任一芯已占用则整批拒绝并提示冲突芯号成功后自动预填下一段等长空闲区间回车即可连续录入。按序直通一键把两侧全部空闲芯按序号配对。分光接续 / 一键分光进缆芯允许重复扇出1 进 N 出是正常分光出缆芯一芯一次单根进缆芯的扇出分支不超过分光比一键分光给尚未分光的出缆各补一条接续。逐芯细编双击接头包打开纤芯接续图模态支持 Shift 连选、Ctrl 多选两侧等量自动处理已接续的两端同选即断开可录熔接损耗与备注。4ODF 成端与跳接ODF 节点采用独立的成端模型terms[ODF] [{c缆, n芯, port端口}]一芯一端口、一端口一芯端口之间的互联跳接仍走接续记录与接头包同一机制。双击 ODF 打开成端图模态左侧是缆纤芯列表右侧是按托盘 × 纤盘规格展开的圆形端口网格空闲端口虚线圆环、本缆纤芯按色谱填色、备用紫环、跳接青环、其余占用中性灰点纤芯再点空闲端口即成端点两个已成端端口即跳接/断开。成端统计口径统一为terms ∪ splices属性面板、自检、导出使用同一份数据。5一跳连通高亮选中任一光缆段整条缆高亮同时把一跳范围——框内与本缆相接的合并束、对端光缆的入盒分线点——一并高亮到对端分线点为止不再沿对端缆继续。这样既能一眼看清本缆的去向又不会把整张图标成一片亮色。3.3 管井图管道数据的三种来源管井图管理井 管段 断面结构。井是点管段是线管段的每一端挂接井管段带孔数孔位由断面结构观察方向 管材包阵列如栅格管 2×2、3×3硅芯管 n 孔等派生。管井数据有三条获取通路依据光缆图生成按光缆图中接头包与盘留点的位置建井位置文字同步为井名≤3 米内已有井自动沿用按光缆连接关系在井间创建管段路径沿用光缆路由。重复执行幂等一次生成 一步撤销。导入 KMZ/KML点要素导入为井、线要素导入为管段支持吸附阈值1/3/5/10 米可选与坐标系选择WGS-84 / GCJ-02落库时井就近沿用、管段端点自动吸附挂接、同对井去重整体为幂等合并导入。从管理平台获取把每段光缆的起终点位置作为井对提交平台的多路径查询接口POST /wapi/v1/vis_links/pipe_paths逐条光缆查询并实时显示进度返回的候选路径全部采用多路径取并集共用井合并、重叠管段去重并按接口返回的截面数据生成管段断面结构。请求统一经本机服务端代理转发浏览器不产生跨域请求。此外还有一个隐形的联动机制管井图上的井发生任何变化放置、拖动、改名、删除、导入工具会全量检查光缆图中位置文字与井名匹配的接头包与盘留点并把它们对齐到井位按屏幕右下 45° 略偏移约 1.1 米避免图标完全重叠。容差内不动作重复触发幂等。3.4 路由图把光缆敷设进管孔路由图把光缆图与管井图叠加在同一张 GIS 地图上管段与井整体置灰、绘于下层光缆与接头包保持亮色、绘于上层用于回答这根缆走了哪根管、占了哪个孔。交互设计上路由图取消了一整套录入工具改用选中即敷设点击一条光缆段即自动进入敷设状态取消选中即退出所有可见管段的中部会常驻显示一个缩小的管孔断面图蓝本缆、红他缆占用、白空闲随地图缩放同步放大缩小鼠标移上去以截面中心放大 10 倍放大后孔号可读、点孔更容易点空闲孔即敷设点其他空孔即改孔点已占用的蓝孔即取消本缆在该管段的敷设可连续点选多段管段悬停某个断面图时对应管段会白晕 青绿闪烁高亮避免面板太多不知道属于哪条管。数据一致性方面有三个关键设计走廊预检点孔前把管段两端投影到待敷设光缆路径如果管段不在光缆走廊上垂直岔出、支线、在缆端之外直接拒绝并提示覆盖比例低或端点偏差大于 25 米时放行但给出警告。敷设自动重建路径新增/取消/删除敷设记录后自动把光缆路径重建为剩余敷设管段首尾相接的链中间断链时按间隙跳跃续接两端始终锚定原接头包/盘留点敷设只改变中间路由缆端不会被搬到井位上。原路由不被修改光缆自身的 GIS 路由以及皮长、纤芯图、导出数据保持不变取消敷设即恢复原样。同一管段敷设多根光缆时工具按孔号自动分车道并行绘制间距随地图缩放同比变化并在管段旁标注共 N 缆密集管段也看得清每根缆。四、数据质量与交付自检 四类导出4.1 合规自检导出前的最后一道关顶栏的盾牌图标打开合规自检面板按当前视图运行对应规则集问题分三级级别含义示例规则ERROR数据错误必须修正编号重复、路径退化、芯数/皮长/孔号非法、接续引用已删对象、芯号越界、同一管孔被多条光缆占用WARN规范缺项应补录/核对孤立接头包、接头包位置未填、光缆两端悬空、某缆在包内整缆未接续、管段端点名称过期、光缆未敷设INFO提醒与汇总统计空闲纤芯合计、未定义断面、敷设完成度已敷设 x/y 条光缆面板打开期间数据一有变化增删对象、属性编辑、接续、敷设、撤销重做、导入就自动防抖复测点问题里的对象名即在图中定位选中并叠加大约 3 秒的闪烁雷达圈密集图面也能一眼找到。问题清单可导出为 CSVUTF-8 BOMExcel 直接打开。4.2 Excel单文件十一张表导出的.xlsx是标准的一份多 sheet 竣工台账接头包 / OLT / ONU / ODF / ODF成端 / 分光器 / 井 / 光缆段 / 光纤跳线 / 敷设 / 纤芯接续其中敷设表记录光缆段在哪个管段的哪个孔纤芯接续表记录两端缆芯的配对与熔接损耗“ODF成端表记录端口、托盘与跳接去向。所有表的数据源与界面、自检一致不会出现表和图对不上”。4.3 PDF一份全程矢量的竣工全册导出PDF输出的是单个矢量 PDF封面项目信息、对象统计、内容清单与页码 光缆图/纤芯图/管井图/路由图各一页GIS 三图按 z20 级构建密集时自动 A3 分幅邻幅带重叠区可拼接单页时最大 A3、超出则整页等比缩小 十一张数据表。技术上有几个细节值得一提文档中没有任何位图线路与文字都是矢量文字可以选中、可以搜索中文使用标准 CJK 复合字体以双字节码写入PDF 体积小且不依赖字体嵌入A3 图幅上图标统一放大到屏幕的 1.5 倍、标注文字再乘 0.5打印和 100% 阅读都清晰文字全黑并带白色衬底压在线路上也可读附带空间网格避让标注重叠自动跳过。4.4 PNG地图全景图与视图范围出图PNG 导出支持两种口径全部对象默认按全部对象的包围盒自动取景居中与屏幕当前视野无关导出一张完整地图全景图当前视图范围所见即所得按当前相机与画布尺寸渲染可选 1×/2× 输出倍率。导出级别自动取整幅能放下的最高级别上限 z22同时受单张画布预算约束长边 ≤ 8192px、总面积 ≤ 6400 万像素超限自动逐级降档始终一张图、不分幅。底图可选在线瓦片、离线经纬网格或纯白背景跨域瓦片先直连、失败自动回退到本地服务端代理避免画布被污染后导不出图。图面自动带上图名条、比例尺与底图版权。4.5 DXF给 CAD 用的竣工图DXF 导出按当前视图出图光缆图/管井图/路由图输出 GIS 竣工图纤芯图输出接续示意图。以项目数据质心为原点做等距圆柱近似投影x/y 单位均为米Y 指北同一项目分幅导出的多张图可在 CAD 里对齐分图层组织管段、光缆段、接头包、ODF、OLT、ONU、分光器、井、盘留点、光纤跳线及各自标注层按视图过滤点对象用块参照INSERT实心填充用 SOLID 三角形序列老旧 CAD 也能正确渲染文件为 UTF-8 / AC1021AutoCAD 2007实测用 ezdxf 解析 0 错误可只导出与当前屏幕视图范围相交的对象几何完整不裁剪。4.6 三维查看只读的立体校验顶栏的 3D 按钮打开一个只读三维覆盖层MapLibre GL JS 本地懒加载离线可用接头包是拱顶圆筒、ODF 是配线机柜、OLT 是局端机框、ONU 是用户端小箱、分光器是光交机柜、井是井盖圆台、盘留点是锥形标光缆与管段带描边呈伪圆管感。可以拖动平移、右键旋转、滚轮缩放点击对象弹出信息卡一键在 2D 图中定位回到编辑界面。地形是可选项支持自建 DEM 瓦片或第三方晕渲地形不可用时自动降级为平面三维。4.7 提交回平台光缆图工具栏还有一个提交入口把接头包、光缆、敷设、接续组装成竣工资料提交体经本机服务端代理调用管理平台的fiber_sync接口接头包按编号创建/复用、光缆按名称查重完成后给出新建/复用统计。这样一套数据既能本地出图也能回灌到资源管理平台避免二次录入。五、AI 助手把重复录入交给自然语言对建网 → 接续 → 管井 → 敷设 → 自检 → 导出这类高度结构化的重复操作工具内置了 AI 助手有两条通路内置 AI 面板左侧停靠抽屉用户自填 API Key只存本机浏览器服务端只做无状态转发、不落盘外部 Agent 中继外部智能体按自托管的 OpenAPI 契约驱动打开中的页面画布实时呈现与手工操作共享同一份状态和撤销栈。核心机制是计划 → 执行 → 回灌 → 自修闭环模型输出唯一 JSON 计划reply / plan / calls ↓ 页面内逐条执行 54 条指令中的 {tool, args} ↓ 结构化结果真实 id、坐标、统计、合规自检问题清单回灌 ↓ 模型读结果自我修正ERROR 未归零不宣告完成54 条指令按领域分组领域指令示例查询与状态query.status、query.objects、query.stats、query.checks、query.fiberFlow项目project.new、project.meta、project.save、project.undo/redo、project.exportJson光缆图对象closure.add/update/move/delete、cable.add/addChain/update/move/vertex/delete、well.*、duct.*接续与成端splice.range、splice.splitter、splice.remove/clear、odf.terminate/removeTerms管井与敷设route.genFromCable、well.alignFromCable、query.ductPath、lay.assign/auto/clear/check外部数据import.plan/apply、kml.import、nvisual.fetch视图与导出view.switch/focus/shot、export.xlsx/dxf/png/pdf三个设计点值得单独说明四视图可寻址指令声明目标视图执行前后自动切视图并选中聚光用户始终看得见 AI 在改什么坐标不过模型模型只说对象名 方位 距离米经纬度换算全部在本地完成从根上杜绝模型算错坐标附件本地解析拖入 Excel 工程量清单后先在页内解析成导入计划只有摘要与预检问题进入上下文整张表不进 token甲方数据也不出本机。安全性上每条指令 一步撤销破坏性操作需要一次确认可以整体撤销本轮AI 与手工操作之间还有软锁机制避免机器和鼠标同时写同一份数据。六、快速上手6.1 运行# 方式一Node.js零依赖nodeserver.js# 默认端口 4666PORTxxxx 可改# 方式二Go 单文件后端零第三方依赖功能等价go run.# 开发运行优先读取同目录 public/go build-oFiberMap.exe.# Windows 构建单文件可执行程序前端已内嵌./FiberMap.exe# 启动后自动打开默认浏览器# Linux 交叉编译CGO_ENABLED0 静态链接不依赖 glibc 版本GOOSlinuxGOARCHamd64CGO_ENABLED0go build-oFiberMap_linux_amd64.GOOSlinuxGOARCHarm64CGO_ENABLED0go build-oFiberMap_linux_arm64.启动后浏览器访问http://localhost:4666即可。服务器无桌面环境时用-openfalse关闭自动打开浏览器-port换端口。6.2 典型录入流程推荐按① 光缆图 → ② 纤芯图 → ③ 管井图 → ④ 路由图 → 导出的顺序推进顶栏向导按钮会按步骤给出入口与实时统计建项目新建并填写项目备案号、编号、名称录光缆图按J点接头包、O放 ODF、T放 OLT、N放 ONU、F放分光器、X画跳线按G画光缆段已有工程量清单可直接导入自动生成接头包/光缆段并做拓扑预布局设计接续切到纤芯图选 A/B 缆做区间接续或按序直通双击接头包逐芯细编选中 ODF 做区间/整缆成端录管井切到管井图可以依据光缆图生成也可以导入 KML/KMZ 或从管理平台获取井位/井名变化会自动对齐光缆图中的接头包与盘留点敷设切到路由图点选光缆段后点管孔完成敷设多缆自动分车道并行显示自检点顶栏盾牌图标按当前视图跑一遍规则把 ERROR 清零导出顶栏导出菜单选择 Excel / PDF / PNG / DXF需要时用提交按钮把竣工资料回传管理平台。6.3 常用快捷键按键功能V/J/O/T/N/F/X/W/G/P选择 / 接头包 / ODF / OLT / ONU / 分光器 / 跳线 / 井 / 光缆段 / 管段M格式刷CtrlZ/CtrlY撤销 / 重做50 步CtrlS保存项目Ctrl点击/Ctrl拖动/CtrlA加选减选 / 框选 / 全选Delete删除选中对象Enter/ 双击 / 右键结束当前绘制Esc结束绘制并回到选择取消当前操作3/2打开 3D / 返回 2D七、适用场景与选型思考这套工具适合以下几类使用者通信设计院 / 施工队把竣工资料的图、表、接续一次性录全导出交付运营商与专网代维把存量光缆资源结构化查纤芯去向、查管孔占用甲方与监理用自检报告和全景图核对资源对象与接续关系数据治理团队以 Excel 清单、KML 台账为输入批量入库再回传到管理平台。它不替代 CAD 制图CAD 面向画图FiberMap 面向记数据。二者的关系是——FiberMap 先把数据录对CAD 图纸DXF、竣工 PDF、Excel 台账都由数据自动生成需要精修图形时再把 DXF 拿进 CAD 处理。选型时可以关注三个判断点数据是否留在本地项目 JSON 通过系统文件对话框存取AI Key 只存浏览器 localStorage平台对接经本机代理——对内外网隔离、数据不能出内网的场景比较友好离线是否可用无网环境用经纬网格底图三维查看、导出、自检都不依赖网络交付物是否够用Excel 十一表 矢量 PDF 全册 全景 PNG 分图层 DXF基本覆盖竣工资料的常规要求。八、现状与展望目前这套工具已经形成完整闭环四个视图、四类导出、三维查看、中英文界面、54 条 AI 指令Windows / Linuxx86_64 与 ARM64均可运行。从提交记录看近期迭代的方向集中在连接点拖拽的连贯性、纤芯图与三维视图的细节打磨、AI 助手的能力覆盖、多语言覆盖。从工程角度看后续可以继续深化的方向大致有三类数据源更多测绘与离线数据格式的导入更多平台接口的双向同步协作与版本多人分工录入、项目版本对比AI 场景把自检、修复、批量调整的闭环做得更稳让一句话建网从演示走向生产。九、结语光缆竣工资料的本质是一份关系数据库设备和缆是记录接续、成端、敷设是关系。nVisual FiberMap 做的事情就是把这份数据库搬到浏览器里用 GIS 地图解决位置用纤芯图解决关系用管井与路由图解决管道占用再用自检和导出把数据变成能交付的图纸与台账。如果你的团队正在被图数分离、反复返工、交付物对不上困扰这套零依赖、无构建、数据留在本地、四类交付物自动生成的思路值得参考。