透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

WakaTime 介紹

WakaTime 是一款紀錄自己生產力的工具，透過客戶端插件、集成工具紀錄「行徑」並發送到官方｜非官方伺服器，可以分析花了多久時間在哪個專案、哪個程式語言、會議、code review。透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

記憶力不佳，過去常常無法想起某段時間做了哪些專案，甚至 daily standup 前忘記昨天做了什麼，發現了 wakatime 可以透過 vscode 插件、terminal 插件來查看自己在哪些時間變更了哪些專案、檔案，甚至可以紀錄下過得指令（僅 binary 的部份，不含參數不會洩漏資料）。

在使用 WakaTime 前，先到 WakaTime 官網上註冊並登入，取得最重要的 API Key(API Token)：

透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

安裝相應的客戶端插件。wakatime 支援的插件、編輯器包括但不限於：

Visual Studio Code
Vim
Excel
Terminal
- zsh
- bash
- fish
- iTerm2

舉例來說我們可以安裝 vscode 插件，並跟著 Installation 輸入完 API Key 就可以開始寫點東西了。

查看報告

使用了一段時間後，可以回到官網查看 dashboard

查看自己上週、前兩週、前一個月每天花了（浪費）了多少時間，以前三十天的圖為例：透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

或是 YoY 的活動圖透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

以此 blog 的 repo 來作為舉例，可以查看某個 project 的細節

在該專案花了多少時間、什麼語言：透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

檔案、分支的時間分配：透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

費用

免費版本的功能已經十分完整了，完整費用方案在此。透過學生帳號可以申請教育折扣，年度付費 Premium 方案的話一年只要 59 美元，就可以享有完整的 WakaTime 服務。雖然付費方案的功能幾乎都可以透過免費版本就有的 API 來完成，但仍可以花點小錢支持團隊，或是開啟公司計畫。

更新你的 GitHub Profile

GitHub Profile 定義如下：

If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page.

舉例來說，我的 github 使用者名稱為 omegaatt36，放在 github.com/omegaatt36/omegaatt36 這個 repo 中的 README.md 就會顯示在我的 Overview 上。

有許多工具可幫我們產生精美的 Profile，諸如 anuraghazra/github-readme-stats 等等。而我們可以透過 anmol098/waka-readme-stats 來幫我們自動把 WakaTime 的統計資料自動更新至 README.md 上。

設定 waka-readme-stats

我們可以透過 waka-readme-stats 的設定教學一步一步來操作。

建立與自己使用者名稱同名的 repo，舉例來說我的使用者名稱是 omegaatt36，就建立一個名為 omegaatt36 的 repo。
新增 README.md 並在檔案內增加兩條註解，將統計資料的顯示區域提供給 waka-readme-stats 辨識：
```


```

新增 GitHub Action Workflow file，在專案目錄中的 .github/workflows 內新增 waka-readme.yml:

name: Waka Readme

on:
schedule:
    - cron: '0 0 * * *'
workflow_dispatch:
jobs:
update-readme:
    name: Update Readme with Metrics
    runs-on: ubuntu-latest
    steps:
    - uses: anmol098/waka-readme-stats@master
        with:
        WAKATIME_API_KEY: ${{ secrets.WAKATIME_API_KEY }}
        GH_TOKEN: ${{ secrets.GH_TOKEN }}
        SHOW_PROFILE_VIEWS: False
        SHOW_SHORT_INFO: False
        SHOW_LOC_CHART: False

其中參數可以設定可以參考官方文件，某些參數需要額外的授權。
commit 並 push 到 GitHub 上。
在 GitHub repo 內設定 secrets:
1. 點擊 repo 中的 Settings 頁籤
2. 點擊左側 Secrets and variables 中的 Actions
3. 點擊 New repository secret
4. 到 WakaTime 的設定頁面複製 Secret API Key
5. 建立一個 secret，名稱為 WAKATIME_API_KEY，secret 為剛剛複製的 Secret API Key
6. 到 GitHub token 頁面設定一個擁有 repo, user 權限的 Token
7. 複製 Token（這個 token 不會再顯示，忘記的話請註銷再重新建立）
8. 回到 repo 中再建立一個 secret，名稱為 GH_TOKEN，secret 為剛剛複製的 GitHub Token
手動執行工作流，點擊 Actions 頁籤，手動執行 Waka Readme 工作流。
待工作流執行完後，回到 Code 頁籤，就能看到我們在 WakaTime 上的統計數據了，同樣的數據也會呈現在個人首頁上。