# 你的 GitHub 個人檔案 README 一次搞定：常用產生器與小工具（含範例可直接貼）

> [!NOTE]
> 📡 **本文包含多個動態統計圖片**，需要網路連線才能正常顯示預覽效果。

> 給開發者的超精簡實用指南：可以用幾個「一鍵產生器」先把版型生出來，再用常見小工具（統計卡、連擊、獎盃、程式時數、徽章、瀏覽計數）把內容補齊。

> 本文中所有示範一律使用本人帳號 **`thc1006`**，各位可以置換後直接複製貼上就能用。

## 一、先選一個「一鍵產生器」（輸入資料 → 自動組版）

* **GitHub Profile README Generator（Rahul Jain）**：超熱門的圖形化產生器，點一點就能輸出完整 Markdown，支援常見附加元件。使用：開啟網站 → 填基本資料與想要的卡片 → 匯出。 ([rahuldkjain.github.io][1])
* **GPRM（GitHub Profile ReadMe Maker）**：精簡導引式流程，主打「一分鐘內產出」。支援社群連結與統計卡快速插入。 ([gprm.itsvg.in][2])
* **Profilinator**：模組化拖拉組件，產生的 Markdown 可直接貼到 README。 ([Github Profilinator][3])
* **Profile Readme Generator（Mauro de Souza）**：另一路線的產生器，提供多種模板與左側選項面板。 ([Profile Readme Generator][4])

> 小提醒：以上工具的「自動選擇最合適版型」本質上就是你在精靈/表單勾選偏好（職能、技能、是否顯示統計卡…）後，系統幫你拼出適合的區塊與 Markdown。

---

## 二、把 README 變「會動」：經典小工具（即貼即用）

> 下面每個範例都已把 `username` 換成 **`thc1006`**，直接貼到你的 `README.md` 即可。

### 1) GitHub Readme Stats（總覽卡＋語言分佈）

<!-- 總覽卡 -->
![GitHub Stats](https://github-readme-stats.vercel.app/api?username=thc1006)


<!-- Top Languages（compact） -->
![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=thc1006&layout=compact)


> <!-- 其他版型可試：layout=donut、donut-vertical、pie -->

參考專案與參數說明。 ([GitHub][5])

### 2) 連擊卡（Streak Stats）

[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com?user=thc1006)](https://github.com/DenverCoder1/github-readme-streak-stats)

[](https://github.com/DenverCoder1/github-readme-streak-stats)

> **小技巧**：如果想把「私有倉庫的貢獻」也算進去，請到個人頁「貢獻圖」的選單開啟 *Private contributions*。工具的計算方式與注意事項見專案說明。 ([GitHub][6])

### 3) 獎盃牆（Profile Trophy）

[![trophy](https://github-profile-trophy.vercel.app/?username=thc1006)](https://github.com/ryo-ma/github-profile-trophy)

[](https://github.com/ryo-ma/github-profile-trophy)

一行就能顯示動態獎盃，更多主題與排序可在專案頁找到。 ([GitHub][7])

### 4) 程式時數（WakaTime → 每週自動更新）

1. 申請並安裝 WakaTime（IDE 外掛）拿到 API Key。
2. 在你的「個人 README 倉庫」加上 GitHub Actions（依市集頁教學設定）。
3. 在 README 放入以下註記，Action 會定期把統計寫進來：

<!--START_SECTION:waka-->
<!--END_SECTION:waka-->

設定方式與 Action 市集頁： ([GitHub][8])

---

## 三、常用徽章 & 訪客計數

### 1) Shields.io 徽章（技能、社群、版本…）

<!-- 例：LinkedIn、Gmail、Python 技能徽章 -->
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Profile-blue)](#)
[![Gmail](https://img.shields.io/badge/Email-contact-red)](#)
![Python](https://img.shields.io/badge/Python-3.x-informational)

徽章產生器與完整文件（可換主題/Logo/顏色）： ([Shields][9])
更多現成樣式清單： ([ileriayo.github.io][10])

### 2) 個人頁瀏覽次數（ghpvc）

![](https://komarev.com/ghpvc/?username=thc1006&label=Profile+Views)


官方使用說明與範例： ([GitHub][11])

---

## 四、快速上線（3 步驟）

1. 在 GitHub 建立一個**和你帳號同名**的公開倉庫（例如：`thc1006/thc1006`）。
2. 新增/編輯根目錄的 `README.md`，把上面範例貼上即可。
3. 儲存後回到你的個人頁，README 就會顯示在最上方。 ([GitHub Docs][12])

---

## 五、延伸閱讀（範例大全）

* **Awesome GitHub Profile README**：大量範例與工具彙整，靈感一次看。 ([GitHub][13])

---

### 最小可用片段（直接貼到你的 `README.md`）

# Hi, I'm Hsiu-Chi (thc1006)

[![LinkedIn](https://img.shields.io/badge/LinkedIn-Profile-blue)](#)
[![Gmail](https://img.shields.io/badge/Email-contact-red)](#)
![Python](https://img.shields.io/badge/Python-3.x-informational)

## GitHub Stats
![GitHub Stats](https://github-readme-stats.vercel.app/api?username=thc1006)
![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=thc1006&layout=compact)

## Streak
[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com?user=thc1006)](https://github.com/DenverCoder1/github-readme-streak-stats)

## Trophies
[![trophy](https://github-profile-trophy.vercel.app/?username=thc1006)](https://github.com/ryo-ma/github-profile-trophy)

## Coding Time (WakaTime)
<!--START_SECTION:waka-->
<!--END_SECTION:waka-->

![](https://komarev.com/ghpvc/?username=thc1006&label=Profile+Views)

[1]: https://rahuldkjain.github.io/gh-profile-readme-generator/ "GitHub Profile Readme Generator - Rahul Jain"
[2]: https://gprm.itsvg.in/ "GPRM : GitHub Profile ReadMe Maker"
[3]: https://profilinator.rishav.dev/ "Github Profilinator - GitHub Profile README Generator"
[4]: https://profile-readme-generator.com/ "Profile Readme Generator"
[5]: https://github.com/anuraghazra/github-readme-stats "anuraghazra/github-readme-stats"
[6]: https://github.com/DenverCoder1/github-readme-streak-stats "DenverCoder1/github-readme-streak-stats"
[7]: https://github.com/ryo-ma/github-profile-trophy "ryo-ma/github-profile-trophy"
[8]: https://github.com/marketplace/actions/waka-readme "Waka Readme · Actions · GitHub Marketplace"
[9]: https://shields.io/ "Shields.io"
[10]: https://ileriayo.github.io/markdown-badges/ "markdown-badges - GitHub Pages"
[11]: https://github.com/antonkomarev/github-profile-views-counter "antonkomarev/github-profile-views-counter"
[12]: https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme "Managing your profile README"
[13]: https://github.com/abhisheknaiidu/awesome-github-profile-readme "abhisheknaiidu/awesome-github-profile-readme"