🌍 English | 繁體中文

🏭 程式碼工廠：Python 新手村 (Code Factory)

「把冷冰冰的 Python 程式碼，化作生動的自動化工廠運作指南！」

📖 專案簡介

這是一個專為 0 基礎 Python 初學者（尤其是想要學習編寫 Open WebUI Action / Tools 腳本的開發者）打造的互動式靜態教學網站。

我們打破了傳統「變數、迴圈、物件導向」的枯燥名詞解釋，首創 「工廠化教學法 (Factory Analogy Method)」，將艱澀的程式語法具象化為工廠裡的實體物件與作業流程，帶領學習者一步步從看懂程式碼，到寫出具備「非同步 (Async)」、「API 連線」與「防呆機制」的企業級實戰腳本。

---

🗺️ 課程架構與大綱

本專案包含四大核心關卡，採用「由淺入深、由內而外」的漸進式設計：

• 🏠 首頁：進入 Python 新手村大廳 (💡 貼心提示：建議使用 Ctrl + 點擊 或 滑鼠中鍵 另開新分頁閱讀，以免離開本頁面喔！)

• • 學習目標：了解課程架構與工廠化學習法的核心精神。

• 🧰 第 1 課：基礎工具箱

  • 學習目標：掌握 Python 的基本物料與收納邏輯。
  • 核心比喻：body (物流貨車) / = (貼標籤) / [] (排隊的置物櫃) / .get() (分類標籤箱與安全取貨窗口) / if/else, return (自動分流輸送帶與強制下班鍵)。

• 🚀 第 2 課：Action 進化史

  • 學習目標：看懂 def action() 函式骨架，理解程式碼優化的真實思維。
  • 核心比喻：async def (聘請不卡單的聰明員工)。帶領學員看見傳統代工的災難現場，並導入 __event_emitter__ (大廳廣播器) 進行升級。

• ⚙️ 第 3 課：控制閥與品管局

  • 學習目標：理解物件導向 (OOP) 基礎與 Pydantic 資料驗證。
  • 核心比喻：BaseModel (國家嚴格品管局) / class Valves: (設定面板的設計藍圖) / Field (面板上的防呆說明書)。

• ✈️ 第 4 課：Telegram 實戰篇

  • 學習目標：跨出工廠，學會與外部 API 連線及處理非同步高階語法。
  • 核心比喻：self (機器人的自我意識) / try...except (吸收衝擊的工安防護罩) / await (對講機呼叫並等待) / aiohttp (限時專屬合約物流車隊)。

---

✨ 專案特色

• 100% 具象化比喻：告別天書般的官方文件，每個語法都有對應的「工廠設備」解說。
• 沉浸式 UI 設計：採用 Tailwind CSS + 漫畫風粗框設計，宛如閱讀互動式破關手冊。
• 無痛部署 (GitHub Pages Ready)：純 HTML/CSS 架構，不需任何後端伺服器，秒速上線。

---

🏭 Code Factory: Python Beginner's Village

"Transforming cold Python code into a lively, automated factory operation guide!"

📖 Introduction

This is an interactive static tutorial website designed specifically for absolute Python beginners, especially developers looking to write scripts for Open WebUI Actions / Tools.

We break away from boring traditional explanations of "variables, loops, and OOP" by introducing the "Factory Analogy Method". We visualize complex programming syntax as physical objects and workflows inside a factory, guiding learners step-by-step from reading basic code to writing enterprise-level, asynchronous, API-connected scripts.

---

🗺️ Course Structure

This project features four core levels, progressively designed from the inside out:

• 🏠 Home: Python Beginner's Village Lobby

  • Goal: Understand the course structure and the core philosophy of the Factory Analogy Method.

• 🧰 Chapter 1: The Basic Toolbox

  • Goal: Master basic Python materials and storage logic.
  • Analogy: body (Delivery Truck) / = (Applying Labels) / [] (Waiting Lockers) / .get() (Sorting Bins & Safe Pickup Window).

• 🚀 Chapter 2: The Evolution of Action

  • Goal: Understand the def action() structure and code refactoring mindset.
  • Analogy: async def (Hiring smart, non-blocking workers). We analyze the "disaster scenes" of old methods and upgrade using __event_emitter__ (Lobby Broadcaster).

• ⚙️ Chapter 3: Control Valves & Quality Assurance

  • Goal: Understand OOP basics and Pydantic data validation.
  • Analogy: BaseModel (Strict National QA Bureau) / class Valves: (Control Panel Blueprints) / Field (Foolproof Instruction Manuals).

• ✈️ Chapter 4: Telegram Real-World Combat

  • Goal: Step out of the factory to connect with external APIs using high-level async syntax.
  • Analogy: self (Robot's self-awareness) / try...except (Safety Forcefield) / await (Radio walkie-talkie wait) / aiohttp (Exclusive async logistics fleet).

---

🛠️ How to Use & Deploy

1. Clone the Repo: Clone this project to your local machine.
2. Local Preview: Simply double-click index.html to view the full course in your browser.
3. Deploy with GitHub Pages: Push to your GitHub repo, go to Settings -> Pages, select the main branch, and save. Your site will be live in minutes!

---

🤝 Contribution & License

• Author: liang.hw
• Year: 2026
• License: MIT License. Feel free to fork, modify, and share! Let's make learning Python painless for everyone.