Agent 學習地圖 · 站點 0

基礎準備

「電腦與基本工具準備好了嗎？」

完成後你能：用 Python 呼叫公開 API、讀 JSON，並用 Git 保存成果。

5–15 小時（1–2 週）12 堂對應課程官方完整版

📌 學習目標

讓 Python 從 API 拿資料，再讀出 JSON 裡需要的部分。
從終端機執行程式，並找到程式建立的檔案。
用 Git 保存一個版本，需要時可以回到這個版本。
認出 YAML、JSON 與 API token（讓程式登入的秘密文字），知道哪些內容不能公開。

🏃 何時可以跳過

四項自評都做得到就直接跳過：用 Python 從 API 拿公開資料並讀 JSON、用 Git clone／branch／commit／push、用命令列切換資料夾與執行 Python script、看得懂 YAML 與 JSON。

🧭 本站課程

按建議順序讀；勾選結果與 /learn 課程頁共用同一份瀏覽器進度。

本站進度

0/12

進度只存在你的瀏覽器

01
Terminal 是什麼：你打開的那個視窗裡，每一樣東西的名字
安裝教學第一行永遠是「打開 Terminal」，你打開了，看到一個黑底視窗和一行字，然後不知道接下來該看哪裡。這篇不教指令清單 —— 它把你眼前的畫面逐行拆開：那個視窗是什麼、為什麼打字可以做事、提示字元在告訴你哪三件事、以及那個看不見卻一直在生效的「目前所在目錄」。
13 分鐘
02
Terminal、Shell、CLI：三個詞的差別，與十行保命指令
多數 AI 工具安裝教學的第一行就是「打開 Terminal」，但沒人解釋 Terminal、Shell、CLI 到底差在哪。這篇把三個詞分清楚，給出十行真的夠用的指令、怎麼讀錯誤訊息，以及新手最容易付出代價的那個習慣。
11 分鐘
03
檔案路徑：為什麼你的檔案「找不到」
絕對路徑與相對路徑的差別、macOS/Linux 與 Windows 的目錄分隔符為什麼不一樣、家目錄簡寫是什麼、含空格的名稱為什麼需要引號，以及怎麼在自己的系統上找出一個檔案到底在哪裡。五個最常見的路徑錯誤與各自的確認方法。
8 分鐘
04
把指令從網頁貼進終端機：為什麼常常失敗
從網頁復制一行指令貼進終端機，卻得到 syntax error 或 command not found —— 這篇解釋四個最常見的原因：智慧引號、多行指令被截斷、看不見的空白字元、以及貼進了錯誤的 shell。每個都給一個可以立刻確認的檢查方法。
8 分鐘
05
API、SDK 與那些縮寫：它們各自是什麼、你什麼時候會需要
API 是一份公開的約定，SDK 是别人替你把呼叫 API 的細節包好的工具包。這篇說清楚兩者的差别、為什麼有些工具要求你有 API key 而有些不用、REST 與串流的區别，以及作為使用者你到底需不需要自己寫 API 呼叫。
8 分鐘
06
網路是怎麼說話的：HTTP、狀態碼、標頭與那些看不見的協定
為什麼 API 說明裡全是 status code 與 header。這篇用一次真實的請求把 HTTP 的四個部件講清楚 —— 請求、回應、狀態碼、標頭 —— 再解釋 WebSocket 與輪詢的差别、CORS 為什麼擋住你、proxy 在中間做了什麼，以及 SSH 與私鑰為什麼是同一類東西。
11 分鐘
07
API Key 是什麼：它同時是你的身分和你的錢包
API key 是一串讓遠端服務認得「這個請求是你發的、帳單算你的」的字串。這篇講清楚它為什麼是秘密、它該放在哪裡（環境變數或 .env，絕對不是聊天視窗）、洩漏了該怎麼處理、為什麼它通常直接連著錢，以及一個多數新手不知道的差別：登入網頁版不等於有 API key。
10 分鐘
08
怎麼讀一則錯誤訊息：解剖、堆疊追蹤與結束代碼
錯誤訊息不是給你逐字讀的，它有固定的形狀：一行結論、一段堆疊追蹤、一個檔名與行號、一個結束代碼。這篇教你由下往上讀堆疊追蹤的原因、怎麼找到真正失敗的那一行、六個真實形狀的範例，以及什麼時候該整段貼去搜尋、什麼時候該貼給 AI Agent、什麼時候兩者都不該。
19 分鐘
09
Git 與 GitHub：AI 工具一直叫你去 clone，那到底是什麼
為什麼每個 AI 編程工具的安裝說明都假設你懂 Git。這篇解釋儲存庫、commit、branch、clone 與 fork、pull request 五個詞各自是什麼、彼此怎麼串起來，以及不會寫程式的人為什麼也需要懂前三個。
9 分鐘
10
設定檔、點檔案與套件管理器：那些以點開頭的檔案是什麼
為什麼每個工具都要你改一個以點開頭的檔案，YAML 與 JSON 差在哪、縮排錯了為什麼整份失效、brew 與 apt 這類套件管理器解決什麼問題，以及正則表達式在你只想知道「這一行是什麼意思」時需要懂到什麼程度。
11 分鐘
11
五分鐘設置你的 LLM 開發環境
從零搭好能呼叫 LLM API 的開發環境：Python 安裝、虛擬環境、API Key 取得與環境變數管理，最後用一條 curl 指令驗證整條鏈路。macOS 與 Windows 雙平台完整指令，重點講解金鑰安全管理與不洩漏進 git 的做法。
15 分鐘
12
裝完沒反應：五個檢查，照順序做完再重裝
安裝完一個工具卻「沒反應」，幾乎總是五種原因之一：不在 PATH 裡、權限不夠、網絡被擋、版本不符、磁盤空間不足。這篇給每一種一個可以在一分鐘內確認的檢查方法，以及為什麼「重裝」幾乎從來不是解法。
9 分鐘

🎯 精選資源

資源	適合誰	推薦度	為什麼推薦
Python Python Crash Course	想跟著一本書從頭練習	⭐⭐⭐⭐	程式碼免費；完整教材需購買書本。
Python Real Python	學過一點，想查一個問題	⭐⭐⭐⭐	文章按主題分開，遇到問題時容易查找。
Python Python 官方繁體中文教學	做完第一次練習，想查正確語法	⭐⭐⭐⭐	官方參考資料；它預期你已懂一點程式設計。
Git Pro Git book	想完整理解 Git	⭐⭐⭐⭐	免費的官方完整參考書。
Git Atlassian Git Tutorials	想用圖看懂 branch、merge 與做事順序	⭐⭐⭐⭐	用圖解說明常見工作流程。
Git Pro Git — Undoing Things	Git 操作出錯，想安全復原	⭐⭐⭐⭐	先說明哪些操作會丟失資料，再教你如何復原。
Git git-flight-rules	基本方法不夠，想查更多問題	⭐⭐⭐	收錄較多 Git 問題與處理方式。
CLI／Shell The Art of Command Line	想有順序地學命令列	⭐⭐⭐⭐	從新手指令一路介紹到較進階的操作。
CLI／Shell Microsoft Learn — PowerShell	使用 Windows，想從第一步開始	⭐⭐⭐⭐	Microsoft 官方的 PowerShell 入門教材。
CLI／Shell tldr pages	只想先看一個指令怎麼用	⭐⭐⭐⭐	用短小、可複製的例子解釋常用指令。
REST API MDN — HTTP	想知道 API 背後怎麼傳資料	⭐⭐⭐⭐	Mozilla 維護的 HTTP 參考資料。
REST API Postman Learning Center	想用圖形介面試 API	⭐⭐⭐⭐	不必先寫程式，也能看到送出與收到的資料。
YAML／JSON YAML 官網	需要查 YAML 的正確寫法	⭐⭐⭐	語法與正式規格的官方入口。
YAML／JSON JSON 介紹	第一次接觸 JSON	⭐⭐⭐⭐	用短例子說明 JSON 怎麼裝資料。
YAML／JSON jq	想從命令列整理 JSON	⭐⭐⭐⭐	可以篩選與整理 API 傳回的資料。

🛠 動手練習（官方版）

完整練習與 starter code

練習摘要取自上游教材；完整程式碼、成本與延遲估算見官方版。

主練習：做一個 GitHub 資料小工具 — 用 Python 拿公開 API 資料、顯示在畫面、寫進檔案，再用 Git 保存（不需帳號、token 或付費服務）。
補充練習：只補不熟的項目 — Python 換帳號重跑、Git branch 與 push、命令列建 src／tests／docs 資料夾、JSON 找欄位、YAML 小設定檔。
選修：安全地體驗 GitHub API 驗證 — 建 fine-grained token、放進環境變數、看到 401 與 200 的差別，結束後撤銷 token。

✅ 自我檢查

終端機顯示 GitHub 帳號與追蹤者數量。
result.txt 有相同的結果。
git log --oneline 看得到剛才的 commit。
程式與 commit 裡沒有密碼或 API token。

本站點改編自 awesome-agentic-ai-zh（MIT 授權，作者 Wenyu Chiou）v2026.09.23，資源連結查核日 2026-08-27。星級為學習優先順序（⭐⭐⭐⭐⭐＝不看會卡住），非人氣排名。 MIT License · 課程結構最後更新：2026-10-03。內容持續補齊中，標記「撰寫中」的課程尚未上線。