Repository navigation
Releases
技嘉出勤時間追蹤器 v1.3.2
技嘉出勤時間追蹤器 v1.3.1
技嘉出勤時間追蹤器 v1.3.0
技嘉出勤時間追蹤器 v1.2.1
技嘉出勤時間追蹤器 v1.2.0
技嘉出勤時間追蹤器 v1.1.3
技嘉出勤時間追蹤器 v1.1.2
v1.1.1 - 修正當日出勤異常判斷邏輯
🐛 Bug 修正
修正當日出勤異常判斷邏輯
問題描述
目前系統判斷出勤異常時,因為出勤資料不是即時更新的,導致當日(今天)的出勤記錄總是會被標記為異常,即使員工已經在 09:30 之前正常打卡。
解決方案
調整當日出勤異常的判斷邏輯,新增以下規則:
- 判斷記錄是否為當日:比對記錄日期與今天的日期
- 當日記錄的特殊處理:
- 如果沒有上班打卡時間 → 視為異常
- 如果上班打卡時間 ≤ 09:30 → 不視為異常(即使下班資料尚未完整)
- 如果上班打卡時間 > 09:30 → 視為異常(遲到)
- 非當日記錄:維持原有的異常判斷邏輯不變
影響範圍
- ✅ 當日上班時間在 09:30 之前打卡,不會被誤判為異常
- ✅ 當日上班時間晚於 09:30,仍然會被正確標記為異常
- ✅ 歷史記錄的異常判斷邏輯維持不變
- ✅ 不影響其他功能模組
📦 安裝方法
- 下載
gigabyte-attendance-tracker-v1.1.1.zip - 解壓縮到本機資料夾
- 開啟 Microsoft Edge,前往
edge://extensions/ - 開啟右上角的「開發人員模式」
- 點擊「載入解壓縮」按鈕
- 選擇解壓縮的資料夾
- 擴充套件安裝完成!
📝 完整更新日誌
Changed
- 修正當日出勤異常判斷邏輯,避免正常打卡被誤判為異常
Technical Details
- 修改檔案:
scripts/api.js - 修改函數:
parseAbnormalAttendance(attendanceData) - 新增當日記錄的特殊判斷邏輯
完整變更記錄: v1.1.0...v1.1.1
技嘉出勤時間追蹤器 v1.1.0
技嘉出勤時間追蹤器 v1.1.0
🎉 版本資訊
版本號:v1.1.0
發布日期:2025-10-03
類型:功能更新
重要性:⭐⭐⭐⭐ 重要更新
✨ 主要新功能
🔄 自動重新登入功能
取消原本的 8 小時自動登出機制,改為 Token 過期時自動重新登入。
核心特點
✅ 無縫體驗 - 使用者不會因為 token 過期而被強制登出
✅ 自動恢復 - API 錯誤時自動嘗試重新登入並重試操作
✅ 安全儲存 - 使用 AES-GCM 256-bit 加密儲存密碼
✅ 預防性更新 - 在 token 過期前自動更新(7.5 小時)
✅ 三重保護 - 三種自動重新登入觸發機制
工作原理
使用者登入(勾選記住)
↓
密碼加密並儲存
↓
Token 即將過期(7.5 小時)
↓
自動重新登入
↓
更新 Token
↓
繼續正常使用
🔒 安全性增強
加密規格
- 加密演算法:AES-GCM
- 金鑰長度:256-bit
- 金鑰派生:PBKDF2 (100,000 次迭代)
- 隨機化:每次加密使用不同的 salt 和 IV
安全特性
✅ 密碼使用業界標準加密演算法
✅ 儲存在 Chrome Storage Local,外部無法存取
✅ 加密金鑰基於瀏覽器環境,無法跨裝置使用
✅ 密碼不以明文記錄在任何地方
📝 詳細變更內容
新增功能
- ✅ 自動重新登入機制(三種觸發方式)
- ✅ 密碼加密儲存功能
- ✅ API 錯誤自動重試
- ✅ 背景定期檢查(每小時)
新增檔案
scripts/crypto.js- 加密工具模組test-crypto.html- 加密功能測試頁面docs/README_AUTO_RELOGIN.md- 總覽文件docs/QUICK_START_AUTO_RELOGIN.md- 快速開始指南docs/QUICK_REFERENCE.md- 快速參考卡docs/AUTO_RELOGIN_FEATURE.md- 完整功能說明docs/IMPLEMENTATION_SUMMARY.md- 實作總結docs/CHANGELOG_AUTO_RELOGIN.md- 變更日誌docs/INDEX.md- 文檔索引
修改檔案
manifest.json- 版本號更新為 1.1.0README.md- 加入新功能說明和文檔連結background.js- 移除自動登出,新增自動重新登入scripts/auth.js- 新增自動重新登入方法scripts/popup.js- 改善錯誤處理popup.html- 引用加密模組
改進項目
- ✅ 改善使用者體驗(不會被強制登出)
- ✅ 改善錯誤處理(自動重試)
- ✅ 提升安全性(加密儲存)
- ✅ 完善文檔(8 個詳細文檔)
📦 安裝與升級
新安裝
- 下載 ZIP 檔案
- 解壓縮到本機資料夾
- 開啟 Edge,前往
edge://extensions/ - 開啟「開發人員模式」
- 點擊「載入解壓縮」
- 選擇解壓縮的資料夾
- 完成安裝!
從舊版本升級
- 下載新版本 ZIP 檔案
- 解壓縮並覆蓋原有檔案
- 前往
edge://extensions/ - 點擊擴充套件的「重新載入」按鈕
- 重新登入並勾選「記住登入資訊」
🚀 使用方式
啟用自動重新登入
- 開啟擴充套件
- 輸入帳號密碼
- 勾選「記住登入資訊」 ← 重要!
- 點擊登入
✅ 完成!之後 Token 過期時會自動重新登入。
停用自動重新登入
方法 1:登入時不勾選「記住登入資訊」
方法 2:清除憑證
// 在 DevTools Console 中執行
chrome.storage.local.remove(['savedAccount', 'savedPassword', 'hasCredentials']);🧪 測試建議
快速測試
- 登入並勾選「記住登入資訊」
- 開啟 DevTools (F12)
- 在 Console 中執行:
chrome.storage.local.get(['lastLoginTime'], (data) => { const eightHoursAgo = Date.now() - (8 * 60 * 60 * 1000); chrome.storage.local.set({ lastLoginTime: eightHoursAgo }, () => { console.log('已將登入時間設為 8 小時前'); }); });
- 重新開啟 Popup
- 應該自動重新登入並顯示出勤資料
加密功能測試
開啟 test-crypto.html 執行所有測試項目。
📚 文檔
完整文檔請參考:
⚠️ 重要注意事項
使用者須知
安全性說明
✅ 密碼使用 AES-GCM 256-bit 加密
✅ 儲存在 Chrome Storage Local,外部無法存取
✅ 加密金鑰基於瀏覽器環境
🐛 已知問題
目前沒有已知的重大問題。
如發現問題,請回報至 GitHub Issues。
🔄 相容性
- Edge 版本:支援 Manifest V3 的所有版本
- 作業系統:Windows, macOS, Linux
- 向下相容:完全相容舊版本的所有功能
📊 效能影響
| 項目 | 影響 |
|---|---|
| 初始化時間 | +50-100 ms(極小) |
| 記憶體使用 | +1 MB(可忽略) |
| 儲存空間 | +250 bytes(可忽略) |
| CPU 使用 | 可忽略不計 |
🎯 未來計劃
v1.2.0(短期)
- 加入使用者設定選項
- 提供手動清除憑證按鈕
- 改善錯誤訊息
v1.3.0(中期)
- 縮短背景檢查間隔
- 加入憑證過期時間設定
- 顯示上次自動重新登入時間
💬 回饋與支援
回報問題
功能建議
歡迎在 GitHub Issues 提出建議
免責聲明:此擴充套件為非官方工具,僅供個人使用。使用前請確保符合公司相關政策。
開發團隊
發布日期:2025-10-03
版本:v1.1.0