smc.peering.tw（Taiwan Submarine Cable Map）是一个实时展示台湾海缆状态的交互式海缆地图。通过颜色、线条与标记点，你可以在 1 分钟内看懂：哪条海缆断线、哪段只是部分受损、哪些登缆点（Landing Point）正在工作。本文将带你从零读懂地图上的每一种符号，不再被红黄蓝黑线条搞糊涂。

一、地图上的 5 种线条颜色，一次看懂

打开页面后，整个页面就是一张深色底图的世界海缆地图。不同颜色代表不同状态（色值定义在 src/components/MapLegend.tsx）：

几个实用细节：

• 红色线条会比蓝色更粗，并带有发光效果，即使线路密集也能一眼锁定故障位置（src/components/Map.tsx）。
• 故障颜色会沿同一路径传播：某段断线后，同一路径上无替代路由的区段也会标红；若存在备用路径，则只标黄色（src/lib/cable-status.ts）。
• 黄色优先级低于红色，重叠时以红色为准。

二、蓝点与白点：登缆点和中继器

地图上除了线条，还有两种圆点标记：

• 蓝色圆点 = Landing Point（登缆点）：海缆从海底登陆陆地的机房位置，例如淡水的 Tamsui CLS。数据来自 src/data/landing-points.json，点击蓝点可查看地点名称和精确经纬度。
• 白色圆点 = Equipment（设备）：通常是海缆上的**中继器（Repeater）**或 BMH、AC 等供电/放大设备，点击可看名称与坐标。

💡 小知识：在故障描述里看到CLS指海缆登陆站，ETR指预计修复时间（Estimated Time of Repair），Shunt Fault是供电故障（不一定是光纤断了）。项目内置了专业名词悬浮提示，鼠标停在描述上就能看解释，词库维护在 src/lib/incident-glossary.ts。

三、左上角三个数字：连通性计数器的正确读法

地图左下角（桌面版）有一个International Connectivity计数器（src/components/OutageCounter.tsx）：

• 🟢Online：当前在线的国际连接数
• 🔴Affected：受故障影响的连接数
• ⚪Total：国际连接总数

⚠️ 注意：它统计的是连接条数，不是带宽容量，数字不代表实际可用传输能力（官方提示文案见 src/i18n/locales/en.json）。

四、点击任意海缆：查看名称、走向与线段编号

鼠标悬停会高亮整条海缆，点击后弹出信息卡，包含：

1. 中文全称与 MODA 英文缩写
2. 连接的国家/地区列表
3. 服役时间（In service since）
4. Segment ID（线段编号）——故障公告里出现的那个编号
5. 点击位置的经纬度

这个弹窗是读懂官方海缆故障公告的钥匙：公告写 "55km from TNS CLS" 时，你就能在地图上对照线段编号和登缆点定位断点。弹窗实现见 src/components/Map.tsx。

五、右侧事件面板：Active Incidents 怎么看

右侧面板默认显示活跃事件（Active Incidents），每条记录包含：

• 天数：故障已持续（或距计划开始还有）多少天
• 状态标签：Outage（断线）/ Partial Outage（部分受损）/ Resolved（已恢复）/ Scheduled（计划内维护）
• 原因标签：地震、渔船拖网、台风、维护、老化等，图标与配色一目了然（src/components/IncidentList.tsx）
• Estimated Reparing at：预计修复时间，仅供参考，可能随抢修进度变化

面板顶部可切换Active ↔ Historical，回看历史断缆记录。

六、进阶功能：筛选、Timeline 与 Topology

• 海缆筛选器（左上角三个圆点）：一键只看"全部 / 正常 / 故障"海缆，排查断线时最好用（src/components/CableFilter.tsx）。
• Timeline：展示过去一年的海缆在线率（Uptime），快速判断哪条系统最稳定。
• Topology：拓扑视图，用图的形式展示ISP 依赖哪些海缆段，某段断线时能直接看出受影响的运营商（src/components/TopologyPage.tsx）。
• 引导游览：点击侧边栏的?按钮即可开始 Guided Tour，按步骤介绍计数器、图例、事件列表等每个区域。

七、快速上手清单 ✅

1. 打开页面，先看计数器：Affected 为 0 即无活动断线
2. 用筛选器切到"故障"，只看红黄线路
3. 点击红线查看Segment ID，对照事件面板定位断点
4. 点击蓝点确认断点离哪个登缆点多远
5. 需要看影响面时，切到Topology视图

📌 数据说明：地图数据来自公开情报与第三方监测系统（路由信息、延迟、丢包率等），仅供参考，最准确的状态请以各海缆系统官方公告为准（免责声明见 src/i18n/locales/en.json）。

掌握以上符号，你就可以像运维工程师一样阅读这张台湾海缆状态地图了。项目采用 React + TypeScript 构建，完整功能介绍见 README.md。