Chronos - VS Code 追蹤器

Chronos 是一個 VS Code 擴充功能，專為追蹤您的程式碼編寫活動而設計。它會自動收集您的編寫工作階段數據並同步到 Chronos 伺服器，讓您能夠量化與分析開發效率。

功能

• 活動數據收集：透過心跳系統 (Heartbeat) 記錄您的活動（每 2 分鐘或存檔時發送），供伺服器計算開發時間。
• 專案與檔案追蹤：自動識別當前編輯的專案、檔案及程式語言。
• 智慧活動分類：區分一般程式編寫、除錯 (Debugging) 和執行測試 (Running Tests)。
• Git 整合：自動偵測並記錄當前的 Git 分支。
• 離線支援：當離線或伺服器無法連線時，會將心跳數據排程，讓您稍後同步。
• 多編輯器支援：偵測您正在使用的編輯器（VS Code, Cursor, Windsurf 等）。
• 狀態列整合：在 VS Code 狀態列中顯示即時統計數據（今日編輯檔案數）。

開始使用

先決條件

• 您的 Chronos API 金鑰 (API Key)。可在 https://chronos.zeabur.app/ 註冊取得。

設定

1. 開啟命令選擇區 (Command Palette) (Cmd+Shift+P / Ctrl+Shift+P)。
2. 執行指令 Chronos: Setup。
3. 輸入您的 Chronos API 金鑰。

設定完成後，Chronos 將立即開始追蹤您的活動。

注意：預設伺服器為 https://chronos.zeabur.app。設定資訊會安全地儲存在 VS Code 的秘密儲存區 (Secret Storage) 中。

使用說明

指令

• Chronos: Setup：開啟設定精靈。
• Chronos: Show Status：開啟儀表板顯示：
  • 今日編輯的檔案數量
  • 心跳狀態 (已傳送/失敗)
  • 目前的專案與檔案
  • 手動操作 (同步、設定)
• Chronos: Sync Offline Data：手動觸發同步待處理的離線心跳數據。

狀態列

擴充功能會在 VS Code 狀態列（右下角）新增一個項目。

• 點擊它可開啟 Chronos Status 選單。
• 它會顯示您每日活動的快速摘要（例如："Chronos: 5 files"）。

開發

建置

# 安裝依賴套件
npm install

# 編譯原始碼
npm run compile

# 監聽變更
npm run watch

執行 (除錯器)

1. 在 VS Code 中開啟此專案。
2. 按下 F5 啟動一個載入此擴充功能的新 Extension Development Host 視窗。

隱私

Chronos 僅追蹤元數據 (Metadata)，如檔名、專案名稱、時間戳記、行數等。它不會上傳您的實際程式碼內容。