..標題：WiFi 調查工具
.. slug: wifi-調查-工具
.. 日期: 2025-12-29 16:00:00 世界標準時間
..標籤：網路、計算機、工具、wifi、射頻、無線、調查
..類別：
..連結：
.. 描述：主動 WiFi 現場勘察工具，用於記錄和視覺化無線訊號測量結果
..類型：文字
<link href="/assets/css/rf-modeling-tool.css" rel="stylesheet"/>
<style>
/* Survey Tool Specific Styles */
.survey-modal-overlay {
    display: none;
    position: fixed;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    background: rgba(0, 0, 0, 0.6);
    z-index: 1000;
    justify-content: center;
    align-items: center;
}

.survey-modal-overlay.active {
    display: flex;
}

.survey-modal {
    background: #fff;
    border-radius: 8px;
    box-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
    width: 600px;
    max-width: 95vw;
    max-height: 90vh;
    overflow: hidden;
    display: flex;
    flex-direction: column;
}

.survey-modal-header {
    background: #343a40;
    color: #fff;
    padding: 15px 20px;
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.survey-modal-header h3 {
    margin: 0;
    font-size: 16px;
}

.survey-modal-close {
    background: none;
    border: none;
    color: #fff;
    font-size: 24px;
    cursor: pointer;
    padding: 0;
    line-height: 1;
}

.survey-modal-close:hover {
    color: #dc3545;
}

.survey-modal-body {
    padding: 20px;
    overflow-y: auto;
    flex: 1;
}

.survey-modal-footer {
    padding: 15px 20px;
    background: #f8f9fa;
    border-top: 1px solid #dee2e6;
    display: flex;
    justify-content: flex-end;
    gap: 10px;
}

.os-tabs {
    display: flex;
    border-bottom: 2px solid #dee2e6;
    margin-bottom: 15px;
}

.os-tab {
    padding: 10px 20px;
    background: #f8f9fa;
    border: none;
    border-bottom: 2px solid transparent;
    cursor: pointer;
    font-size: 14px;
    margin-bottom: -2px;
    transition: all 0.2s;
}

.os-tab:hover {
    background: #e9ecef;
}

.os-tab.active {
    background: #fff;
    border-bottom-color: #007bff;
    color: #007bff;
    font-weight: 600;
}

.os-command-box {
    background: #1e1e1e;
    color: #d4d4d4;
    padding: 12px 15px;
    border-radius: 4px;
    font-family: 'Consolas', 'Monaco', monospace;
    font-size: 13px;
    margin-bottom: 15px;
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.os-command-box code {
    color: #9cdcfe;
}

.copy-btn {
    background: #4a4a4a;
    border: none;
    color: #fff;
    padding: 5px 10px;
    border-radius: 3px;
    cursor: pointer;
    font-size: 11px;
}

.copy-btn:hover {
    background: #5a5a5a;
}

.rf-data-input {
    width: 100%;
    height: 200px;
    font-family: 'Consolas', 'Monaco', monospace;
    font-size: 12px;
    padding: 10px;
    border: 1px solid #ced4da;
    border-radius: 4px;
    resize: vertical;
}

.rf-data-input:focus {
    border-color: #007bff;
    outline: none;
    box-shadow: 0 0 0 2px rgba(0, 123, 255, 0.25);
}

.parsed-data-preview {
    background: #f8f9fa;
    border: 1px solid #dee2e6;
    border-radius: 4px;
    padding: 15px;
    margin-top: 15px;
    display: none;
}

.parsed-data-preview.has-data {
    display: block;
}

.parsed-data-preview h4 {
    margin: 0 0 10px 0;
    font-size: 14px;
    color: #495057;
}

.parsed-field {
    display: flex;
    margin-bottom: 5px;
    font-size: 13px;
}

.parsed-field-label {
    font-weight: 600;
    min-width: 120px;
    color: #6c757d;
}

.parsed-field-value {
    color: #212529;
}

.parsed-field-value.good {
    color: #28a745;
}

.parsed-field-value.medium {
    color: #ffc107;
}

.parsed-field-value.poor {
    color: #dc3545;
}

.ssid-selector {
    margin-bottom: 15px;
}

.ssid-selector label {
    display: block;
    margin-bottom: 5px;
    font-weight: 600;
    font-size: 13px;
}

.ssid-selector select {
    width: 100%;
    padding: 8px;
    border: 1px solid #ced4da;
    border-radius: 4px;
    font-size: 13px;
}

.survey-point-marker {
    cursor: pointer;
}

.survey-points-list {
    max-height: 300px;
    overflow-y: auto;
}

.survey-point-item {
    display: flex;
    justify-content: space-between;
    align-items: center;
    padding: 8px 10px;
    border-bottom: 1px solid #dee2e6;
    font-size: 12px;
}

.survey-point-item:hover {
    background: #f8f9fa;
}

.survey-point-item .signal-indicator {
    display: inline-block;
    width: 12px;
    height: 12px;
    border-radius: 50%;
    margin-right: 8px;
}

.survey-point-item .delete-btn {
    background: none;
    border: none;
    color: #dc3545;
    cursor: pointer;
    padding: 2px 6px;
}

.survey-point-item .delete-btn:hover {
    background: #f8d7da;
    border-radius: 3px;
}

.min-points-warning {
    background: #fff3cd;
    border: 1px solid #ffc107;
    border-radius: 4px;
    padding: 10px;
    margin-bottom: 10px;
    font-size: 12px;
    color: #856404;
}

.metadata-toggle {
    color: #007bff;
    cursor: pointer;
    font-size: 12px;
    margin-top: 10px;
}

.metadata-toggle:hover {
    text-decoration: underline;
}

.metadata-section {
    display: none;
    margin-top: 10px;
    padding: 10px;
    background: #e9ecef;
    border-radius: 4px;
    font-size: 11px;
}

.metadata-section.visible {
    display: block;
}

.point-label-input {
    width: 100%;
    padding: 8px;
    border: 1px solid #ced4da;
    border-radius: 4px;
    font-size: 13px;
    margin-bottom: 10px;
}
</style>
外部表：側邊欄|畫布區
<table class="rf-outer-table">
<tr>
左側邊欄（250px 固定寬度）
<td class="rf-sidebar-cell">
<div class="rf-sidebar-title">WiFi 調查工具</div>
<div class="rf-sidebar-subtitle">現場勘察</div>
上傳部分
<div class="rf-section" id="uploadSection">
<div class="rf-section-title">平面圖上傳</div>
<div class="rf-upload-area" id="uploadArea">
<div class="rf-upload-icon">📁</div>
<div class="rf-upload-text">點擊上傳平面圖</div>
<div class="rf-upload-hint">（PNG、JPG 或 PDF）</div>
</div>
<input accept="image/*,.pdf" id="floorPlanInput" style="display: none;" type="file"/>
</div>
校準部分
<div class="rf-section" id="calibrationSection">
<div class="rf-section-title">秤校準</div>
<div class="rf-form-group">
<label class="rf-label" for="calibrationDistance">已知距離</label>
<input class="rf-input" id="calibrationDistance" min="0" placeholder="Enter distance" step="0.1" type="number"/>
</div>
<div class="rf-form-group">
<label class="rf-label" for="calibrationUnit">單元</label>
<select class="rf-select" id="calibrationUnit">
<option value="feet">腳</option>
<option value="meters">米</option>
</select>
</div>
<button class="rf-btn rf-btn-primary" disabled="" id="startCalibrationBtn">開始校準</button>
<span class="rf-hint">點擊平面圖上的兩點以設定比例</span>
</div>
調查資料視覺化部分
<div class="rf-section" id="surveyVisualizationSection">
<div class="rf-section-title">調查視覺化</div>
<div style="margin-bottom: 10px;">
<label style="display: block; margin-bottom: 5px;">
<input id="showHeatmap" style="margin-right: 5px;" type="checkbox"/>顯示覆蓋熱圖</label>
</div>
<div class="min-points-warning" id="minPointsWarning" style="display: none;">增加至少 3 個測量點以產生熱圖</div>
<button class="rf-btn rf-btn-primary" id="regenerateHeatmapBtn" style="margin-bottom: 10px; width: 100%;">🔄 重新生成熱圖</button>
<div class="rf-slider-group">
<label class="rf-slider-label">網格分辨率<span class="rf-slider-value" id="gridResValue">20</span>像素</label>
<input class="rf-slider" id="gridResolution" max="50" min="5" step="5" type="range" value="20"/>
</div>
<div class="rf-slider-group">
<label class="rf-slider-label">IDW電源<span class="rf-slider-value" id="idwPowerValue">2</span>
</label>
<input class="rf-slider" id="idwPower" max="4" min="1" step="0.5" type="range" value="2"/>
</div>
<div style="margin-top: 10px; font-size: 11px; color: #6c757d;">
<div><strong>傳奇：</strong></div>
<div style="display: flex; align-items: center; margin-top: 3px;">
<span style="display: inline-block; width: 40px; height: 12px; background: linear-gradient(to right, #ff0000, #ffff00, #00ff00); border: 1px solid #ccc;"></span>
<span style="margin-left: 5px;">弱→強</span>
</div>
<div style="margin-top: 5px;">
<span style="color: #28a745;">●</span>&gt;-50 dBm（優）<br/>
<span style="color: #ffc107;">●</span>-50 至 -70 dBm（良好）<br/>
<span style="color: #dc3545;">●</span>&lt;-70 dBm（差）</div>
</div>
</div>
查看控制部分
<div class="rf-section" id="viewControlsSection">
<div class="rf-section-title">查看控制項</div>
<div style="display: flex; gap: 5px; margin-bottom: 10px;">
<button class="rf-btn rf-btn-secondary" id="zoomInBtn" style="flex: 1;">+ 放大</button>
<button class="rf-btn rf-btn-secondary" id="zoomOutBtn" style="flex: 1;">- 縮小</button>
</div>
<button class="rf-btn rf-btn-secondary" id="resetViewBtn" style="width: 100%; margin-bottom: 10px;">重置視圖</button>
<div style="font-size: 11px; color: #6c757d;">
<div><strong>飛漲：</strong> <span id="zoomLevel">100%</span></div>
<div style="margin-top: 5px;">
<strong>控制：</strong><br/>* 滑鼠滾輪縮放<br/>* Shift + 拖曳進行平移<br/>* 滑鼠中鍵平移</div>
</div>
</div>
</td>
右側畫布區域
<td class="rf-canvas-cell">
嵌套表格：用於標尺和畫布的 3x3 網格
<table class="rf-ruler-table">
<tr>
左上角
<td class="rf-ruler-corner"></td>
頂尺
<td class="rf-ruler-top" id="rulerTop"></td>
右上角
<td class="rf-ruler-corner"></td>
</tr>
<tr>
左標尺
<td class="rf-ruler-left" id="rulerLeft"></td>
畫布位於中心
<td class="rf-canvas-container">
<canvas height="600" id="rfCanvas" width="800"></canvas>
</td>
右尺
<td class="rf-ruler-right" id="rulerRight"></td>
</tr>
<tr>
左下角
<td class="rf-ruler-corner"></td>
底尺
<td class="rf-ruler-bottom" id="rulerBottom"></td>
右下角
<td class="rf-ruler-corner"></td>
</tr>
</table>
嵌套表格下方的狀態列
<div class="rf-status-bar">
<span class="rf-status-left">
<span id="statusText">準備好 - 上傳平面圖即可開始</span>
</span>
<span class="rf-status-right" id="cursorPosition">X：0，Y：0</span>
</div>
</td>
右側邊欄（250px 固定寬度）
<td class="rf-right-sidebar-cell">
<div class="rf-sidebar-title">調查點</div>
測量點部分
<div class="rf-section" id="surveyPointsSection">
<div class="rf-section-title">記錄點（<span id="pointCount">0</span>)</div>
<div class="survey-points-list" id="surveyPointsList">
<div style="color: #6c757d; font-size: 12px; padding: 10px; text-align: center;">點擊地圖加入測量點</div>
</div>
<div style="margin-top: 10px;">
<button class="rf-btn rf-btn-secondary" disabled="" id="clearAllPointsBtn" style="width: 100%;">清除所有點</button>
</div>
<div style="margin-top: 10px; padding-top: 10px; border-top: 1px solid #dee2e6;">
<button class="rf-btn rf-btn-secondary" disabled="" id="exportDataBtn" style="width: 100%; margin-bottom: 5px;">匯出調查資料 (JSON)</button>
<button class="rf-btn rf-btn-secondary" id="importDataBtn" style="width: 100%;">導入調查數據</button>
<input accept=".json" id="importFileInput" style="display: none;" type="file"/>
</div>
</div>
說明部分
<div class="rf-section" id="instructionsSection">
<div class="rf-section-title">如何使用</div>
<div style="font-size: 11px; color: #6c757d;">
<ol style="margin: 0; padding-left: 20px;">
<li>上傳您的平面圖圖像</li>
<li>使用已知距離校準比例</li>
<li>走到地板上的某個位置</li>
<li>點擊地圖上的該地點</li>
<li>執行 WiFi 命令並貼上輸出</li>
<li>重複至少 3 點</li>
<li>啟用熱圖以可視化覆蓋範圍</li>
</ol>
</div>
</div>
</td>
</tr>
</table>
調查資料輸入模式
<div class="survey-modal-overlay" id="surveyModal">
<div class="survey-modal">
<div class="survey-modal-header">
<h3>添加測量點</h3>
<button class="survey-modal-close" id="closeModalBtn">×</button>
</div>
<div class="survey-modal-body">
點標籤
<div style="margin-bottom: 15px;">
<label style="display: block; margin-bottom: 5px; font-weight: 600; font-size: 13px;">點標籤（可選）</label>
<input class="point-label-input" id="pointLabelInput" placeholder="e.g., Conference Room A, Hallway, etc." type="text"/>
</div>
作業系統選項卡
<div class="os-tabs">
<button class="os-tab active" data-os="osx">macOS</button>
<button class="os-tab" data-os="windows">視窗</button>
<button class="os-tab" data-os="linux">Linux</button>
</div>
特定於作業系統的命令框
<div class="os-command-box" id="osxCommand">
<code>sudo wdutil info</code>
<button class="copy-btn" data-command="sudo wdutil info">複製</button>
</div>
<div class="os-command-box" id="windowsCommand" style="display: none;">
<code>netsh wlan show networks mode=bssid</code>
<button class="copy-btn" data-command="netsh wlan show networks mode=bssid">複製</button>
</div>
<div class="os-command-box" id="linuxCommand" style="display: none;">
<code>nmcli device wifi list</code>
<button class="copy-btn" data-command="nmcli device wifi list">複製</button>
</div>
SSID 選擇器（適用於具有多個網路的 Windows）
<div class="ssid-selector" id="ssidSelector" style="display: none;">
<label>選擇網路：</label>
<select id="ssidSelect"></select>
</div>
資料輸入
<textarea class="rf-data-input" id="rfDataInput" placeholder="Paste the command output here..."></textarea>
解析資料預覽
<div class="parsed-data-preview" id="parsedDataPreview">
<h4>解析數據</h4>
<div id="parsedDataFields"></div>
<div class="metadata-toggle" id="metadataToggle">顯示附加元數據</div>
<div class="metadata-section" id="metadataSection"></div>
</div>
</div>
<div class="survey-modal-footer">
<button class="rf-btn rf-btn-secondary" id="cancelSurveyBtn">取消</button>
<button class="rf-btn rf-btn-primary" disabled="" id="saveSurveyBtn">保存點</button>
</div>
</div>
</div>
<script src="/assets/js/wifi-survey-tool.js"></script>