WhatPulse 是跨平台（Linux/Windows/macOS）的輸入統計與頻寬監控工具，記錄按鍵數、滑鼠點擊、網路流量、系統運行時間，支援團隊排行榜、熱力圖視覺化、自動脈衝上傳。本文涵蓋安裝配置、權限設定、功能深度解析與隱私考量。

核心功能一覽

模組	統計項目	視覺化
鍵盤	總按鍵數、單鍵頻率、每日/週/月/年趨勢	熱力圖 (冷暖色顯示鍵位使用強度)
滑鼠	左/中/右鍵點擊、滾輪、移動距離	點擊熱力圖、時間分佈
網路	上傳/下載流量、每介面統計、國家/地區分佈	流量趨勢圖、地理分佈
系統	運行時間、啟動次數、應用程式使用時長	時間軸、應用排名

安裝部署 (Linux)

官方下載頁面

https://whatpulse.org/downloads 提供：

• .tar.gz 通用二進制包 (x86_64, aarch64)
• .deb Debian/Ubuntu/Mint/Pop!_OS
• .rpm Fedora/RHEL/openSUSE
• AUR: whatpulse (Arch/Manjaro)
• Flatpak: flatpak install flathub com.whatpulse.WhatPulse

依賴庫需求 (通用包)

# Qt6 基礎 (WhatPulse 5.x 基於 Qt6)
sudo apt install libqt6core6 libqt6widgets6 libqt6network6 libqt6webengine6 \
  libssl3 libpcap0.8  # Ubuntu 22.04+

# 或 Qt5 (舊版)
sudo apt install libqt5core5a libqt5webkit5 libqt5sql5-sqlite libssl-dev

安裝範例

# Debian/Ubuntu .deb
wget https://whatpulse.org/downloads/latest/debian -O whatpulse.deb
sudo apt install ./whatpulse.deb

# Arch AUR
yay -S whatpulse

# 通用包
tar xzf whatpulse-linux.tar.gz
cd whatpulse
./WhatPulse  # 直接執行

首次啟動與權限配置

1. 帳號註冊/登入

• 啟動客戶端 → 歡迎嚮導 → 註冊/登入 WhatPulse 帳號
• 支援 Email、Google、GitHub、Facebook 登入
• 設定電腦名稱（多裝置同步同一帳號的關鍵）

2. 輸入裝置權限 (關鍵步驟)

# 執行包含的腳本設定 uinput 權限
./setup-input-permissions.sh
# 或手動
sudo usermod -a -G input $USER
# 需重新登入生效

無權限時：鍵盤/滑鼠統計為 0，系統托盤圖示可能顯示警告。

3. 網路統計權限

# 需 libpcap 權限捕獲封包
sudo setcap cap_net_raw,cap_net_admin=eip /usr/bin/whatpulse
# 或以 root 執行 (不建議)
# 缺少時：網路標籤顯示 "Network measurement disabled"

客戶端介面深度解析

總覽

• 系統資訊：OS、核心、CPU、RAM、GPU
• 即時計數器：按鍵、點擊、下載/上傳、運行時間
• Pulse 按鈕：手動上傳統計到伺服器

輸入標籤

• 時間範圍：今日/本週/本月/本年/全部
• 鍵盤熱力圖：直觀顯示高頻鍵位 (WASD、空格鍵、Enter 通常最熱)
• 按鍵頻率表：排序顯示每個鍵的按下次數
• 滑鼠分析：左/中/右鍵比例、點擊時間分佈

網路標籤

• 介面級流量統計 (eth0, wlan0, docker0, veth...)
• 國家/地區流量分佈 (GeoIP)
• 應用程式流量細分 (需 root/權限)

應用程式追蹤

• 記錄前景應用程式使用時長
• 生產力分析：編輯器 vs 瀏覽器 vs 終端機時長對比

自動脈衝配置

# 設定 → 自動脈衝
# 條件觸發上傳：
- 每 50,000 按鍵
- 每 10,000 點擊
- 每 1 GB 下載
- 每 500 MB 上傳
- 每 24 小時
- 系統啟動/關機時

團隊與社群功能

• 建立/加入團隊：共同目標、內部排行榜
• 公開排行榜：全球、國家、團隊排名
• 成就系統：里程碑徽章 (百萬按鍵、TB 流量等)

隱私與資料安全

• 所有統計本地優先，上傳前可審查
• 不記錄按鍵內容、密碼、具體網址、檔案名稱
• 僅統計元數據：次數、時間、應用程式、流量大小
• 可隨時刪除本地資料、註銷帳號、請求資料刪除
• 開源客戶端：GitHub (部分模組開源)

命令列介面 (CLI) 自動化

# 查看狀態
whatpulse --status

# 手動脈衝
whatpulse --pulse

# 匯出資料 (JSON/CSV)
whatpulse --export json > stats.json

# 無頭模式 (伺服器/容器)
whatpulse --headless --config /path/to/config.json

替代方案對比

工具	平台	特色	開源
WhatPulse	跨平台	雲端同步、團隊、熱力圖、Web 儀表板	客戶端部分
KeyCounter	Windows	簡單計數器	否
Mousotron	Windows	滑鼠專用統計	否
SelfSpy	Linux	全活動記錄、本地 SQLite、隱私優先	是
ActivityWatch	跨平台	時間追蹤、應用/視窗/瀏覽器分類、本地優先	是
Kairos	Linux	鍵盤熱力圖、Wayland 支援	是

疑難排解

問題	解決
統計為 0	執行 setup-input-permissions.sh、加入 input 群組、重新登入
網路無數據	setcap cap_net_raw,cap_net_admin=eip 或安裝 libpcap
Wayland 下無法捕獲	需 XWayland 相容模式、或使用 Kairos/ActivityWatch
Qt 外觀問題	QT_QPA_PLATFORMTHEME=gtk2 或安裝 qt6ct
開機不自啟	桌面環境自啟動設定加入 whatpulse --tray

小結

WhatPulse 將枯燥的輸入統計轉化為可視化的個人/團隊儀表板。Linux 部署關鍵在 input 群組權限與 libpcap 能力授予。對於關注生產力模式、鍵盤熱力圖、跨裝置統計同步的用戶，是極佳選擇。隱私意識強者可考慮 ActivityWatch (完全本地、開源、功能更豐富) 或 SelfSpy (極簡記錄)。