From ae81d6ea13e23b8b566f135aa2c63ff07cd8d430 Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:40:14 +0800 Subject: [PATCH 1/8] docs: add course 115 structure --- course-115/README.md | 79 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 course-115/README.md diff --git a/course-115/README.md b/course-115/README.md new file mode 100644 index 0000000..9fac6eb --- /dev/null +++ b/course-115/README.md @@ -0,0 +1,79 @@ +# 多媒體系統 115 學年度課程中心 + +這個資料夾提供日間部與進修部共用的課程主幹。兩班使用同一套核心教材，再依學生背景調整活動、作業支架與專題自由度。 + +## 課程入口 + +- 日間部：[Thu 多媒體系統115（日）資工一](https://hackmd.io/@wiimax/SJemnYy8fg) +- 進修部：[Sat 多媒體系統115（夜）資工一](https://hackmd.io/@wiimax/ryNWHeqSzg) +- 程式與範例：[MediaSystem-Python-Course](https://github.com/willismax/MediaSystem-Python-Course) +- Azure 延伸教材：[azure-multimedia](https://github.com/willismax/books/tree/main/azure-multimedia) + +## 課程定位 + +> 用 AI 協作開發多媒體系統，並能說明媒體資料如何表示、處理、傳輸與驗證。 + +學生完成課程後，應能： + +1. 說明影像、聲音與影片的基本表示方式，以及格式、壓縮與品質之間的關係。 +2. 使用 Python 與現成函式庫處理至少兩種媒體資料。 +3. 將媒體處理功能包裝成可操作的應用程式。 +4. 使用生成式 AI 協助規劃、實作與除錯，並留下驗證過程。 +5. 妥善處理 API 金鑰、個人資料、素材授權與 AI 生成內容。 +6. 展示作品，說明關鍵技術選擇、限制與改善方向。 + +## 教材架構 + +- `common-syllabus.md`：18 週共同課程地圖、日夜間分流與評量方式。 +- `week-01-hackmd-markdown.md`：第一週可直接貼入 HackMD 的學生版教材。 +- `HACKMD_WORKFLOW.md`：HackMD 與 GitHub 的分工、同步流程及 API 採用條件。 +- `templates/weekly-note.md`：後續週次的共同教材模板。 +- `templates/ai-usage.md`：學生專題的 AI 使用紀錄模板。 + +## 日夜間分流原則 + +共用內容約占 70%，班別調整約占 30%。不是準備兩套投影片，而是在同一份教材中標記三種區塊： + +- `共同必學`：兩班都完成。 +- `日間引導`：增加概念比較、逐步操作與固定題型。 +- `進修挑戰`：增加選題彈性、整合需求與專題工作時間。 + +日間部不降低專業內容，而是縮小每次實作範圍並增加檢核點。進修部仍需完成共同基礎，但可把更多課堂時間用於自選專題。 + +## 內容取捨 + +### 核心內容 + +- Python／Colab 與 Git 基礎 +- Markdown 與 HackMD +- Pillow、NumPy、OpenCV +- 聲音取樣、音訊處理與語音辨識 +- 影片影格、容器、編碼、FFmpeg 與攝影機輸入 +- MediaPipe 或其他即時多媒體應用 +- Gradio／Flask +- 多模態 AI API +- 測試、金鑰管理、著作權、個資與無障礙 + +### 延伸內容 + +- Requests 與外部資料 API +- SQLite +- LINE Bot +- pytest 的完整測試流程 +- Azure、GCP 或 Zeabur 部署 + +### 不列入共同主幹 + +- Selenium +- Playwright +- 大型雲端平台的完整服務導覽 + +這些內容仍可保留在原 repo，供專題需要時使用，但不占共同課程週次。 + +## 教材維護原則 + +1. HackMD 是授課正文與課堂互動入口。 +2. GitHub 保存程式、Notebook、固定素材與 Markdown 版本。 +3. 每份共用 HackMD 筆記對應 repo 中的一個 Markdown 檔案。 +4. 兩班首頁只放班級公告、日期、作業期限與共同教材連結。 +5. 不在 HackMD 與 GitHub 同時修改同一份 Markdown；依 `HACKMD_WORKFLOW.md` 操作。 From fe1d389e611f751a01f9ae4b5ad8e1548f1daef0 Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:40:45 +0800 Subject: [PATCH 2/8] docs: add shared 18-week syllabus --- course-115/common-syllabus.md | 88 +++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 course-115/common-syllabus.md diff --git a/course-115/common-syllabus.md b/course-115/common-syllabus.md new file mode 100644 index 0000000..e58ff26 --- /dev/null +++ b/course-115/common-syllabus.md @@ -0,0 +1,88 @@ +# 多媒體系統 115 學年度共同課程地圖 + +## 課程設計比例 + +| 面向 | 日間部資工一 | 進修部資工一 | +|---|---:|---:| +| 多媒體概念 | 35% | 20% | +| 引導式實作 | 35% | 20% | +| AI 協作與驗證 | 15% | 20% | +| 專題整合 | 15% | 40% | + +比例代表課堂投入重點，不直接等同成績配分。 + +## 18 週進度 + +| 週次 | 共同主題 | 日間部安排 | 進修部安排 | 主要產出 | +|---:|---|---|---|---| +| 1 | 課程導覽、HackMD、Markdown、媒體系統初探 | 完成指定語法與媒體觀察表 | 自選主題完成個人媒體名片 | 個人 HackMD 筆記 | +| 2 | Colab、Python、檔案與 AI 協作規範 | 逐步練習變數、函式、檔案路徑 | 快速複習後進行小型改作 | 第一個 Colab | +| 3 | 數位影像：像素、解析度、色彩通道、格式 | 參數比較與概念題 | 自選照片做格式實驗 | 影像觀察紀錄 | +| 4 | Pillow、NumPy 影像處理 | 裁切、縮放、旋轉、濾鏡 | 批次處理或自選效果 | 影像處理程式 | +| 5 | OpenCV 與電腦視覺 | 固定輸入與可重現結果 | 自選偵測或辨識任務 | 視覺小作品 | +| 6 | 數位聲音：取樣率、位元深度、波形、格式 | 比較參數與檔案大小 | 自選錄音素材分析 | 聲音觀察紀錄 | +| 7 | 音訊處理與語音辨識 | 剪輯、音量、轉檔、逐字稿 | 字幕、摘要或會議紀錄工具 | 音訊小作品 | +| 8 | 影像／聲音迷你專題 | 教師提供題目與檢核表 | 自訂需求與完成條件 | 期中專題草稿 | +| 9 | 期中展示與個別說明 | 概念說明與操作驗證 | 設計決策與問題回顧 | 期中作品 | +| 10 | 數位影片：影格率、解析度、容器與編碼 | 參數比較 | 自選影片案例分析 | 影片觀察紀錄 | +| 11 | FFmpeg 與 OpenCV 影片處理 | 指定轉檔、擷取與合成 | 建立批次或半自動流程 | 影片處理程式 | +| 12 | 攝影機、MediaPipe 與即時互動 | 指定手勢或姿態範例 | 自訂互動行為 | 即時互動作品 | +| 13 | 多模態 AI：文字、影像、聲音與影片 | 使用固定資料驗證輸出 | 比較服務或設計工作流程 | AI 驗證紀錄 | +| 14 | Gradio／Flask、API 與金鑰管理 | 完成指定介面 | 整合自選專題功能 | 可操作原型 | +| 15 | 雲端概念、部署、記錄、費用與清除 | 觀摩或完成教師指定路徑 | 可選 Azure、GCP、Zeabur 或其他平台 | 部署紀錄 | +| 16 | 期末專題工作坊一 | 依檢核表完成核心功能 | 需求、架構與里程碑審查 | 專題 Alpha | +| 17 | 期末專題工作坊二 | 測試、錯誤處理與說明練習 | 使用者測試與整合改善 | 專題 Beta | +| 18 | 成果展示與個人口頭說明 | 操作、概念與程式抽問 | 問題、決策、限制與反思 | 期末作品 | + +## 參考評量方式 + +### 日間部 + +- 每週概念檢核與課堂參與：20% +- 引導式實作：30% +- 期中迷你專題：20% +- 期末整合專題：25% +- AI 使用紀錄與個人口頭說明：5% + +### 進修部 + +- 共同基礎與課堂參與：15% +- 階段實作：20% +- 專題里程碑：20% +- 期末整合專題：35% +- AI 使用紀錄與個人口頭說明：10% + +實際配分仍需配合學校規定、授課時數與缺曠課辦法。 + +## 共同專題規範 + +每組或每位學生至少繳交： + +1. 可操作的作品或可重現的執行方式。 +2. `README`：問題、使用者、操作方式、系統架構與已知限制。 +3. 輸入與輸出範例。 +4. 測試紀錄：正常、邊界與錯誤輸入至少各一例。 +5. `AI_USAGE.md`：AI 建議、採用或拒絕理由、驗證方式。 +6. 素材來源與授權說明。 +7. 個人口頭說明；團體作品仍需個別回答。 + +## 可選專題方向 + +- 照片整理、標註、格式轉換或影像增強工具 +- 語音逐字稿、摘要與字幕工具 +- 短片剪輯、精華擷取或影片資訊整理工具 +- 攝影機手勢、姿態或互動展示 +- 多媒體搜尋與問答工具 +- 結合生活或工作情境的自選題目 + +題目不以功能數量評分。核心功能可重現、媒體概念使用正確、能說明 AI 產出如何驗證，比堆疊服務更重要。 + +## AI 協作規範 + +學生可以使用生成式 AI，但需遵守三項原則： + +1. **可以生成**：可用於構想、程式、說明、測試案例與除錯。 +2. **必須驗證**：不得只以「AI 說可以」作為正確證據。 +3. **能夠說明**：需說明關鍵程式、參數、輸入輸出與限制。 + +不得將帳號密碼、API 金鑰、未授權個資或不適合公開的素材貼給外部 AI 服務。 From c5793c68623eb30dfa3be730dd86606aa4243647 Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:41:15 +0800 Subject: [PATCH 3/8] docs: add week 1 HackMD and Markdown lesson --- course-115/week-01-hackmd-markdown.md | 234 ++++++++++++++++++++++++++ 1 file changed, 234 insertions(+) create mode 100644 course-115/week-01-hackmd-markdown.md diff --git a/course-115/week-01-hackmd-markdown.md b/course-115/week-01-hackmd-markdown.md new file mode 100644 index 0000000..c2bed5a --- /dev/null +++ b/course-115/week-01-hackmd-markdown.md @@ -0,0 +1,234 @@ +--- +title: 多媒體系統 W01｜HackMD、Markdown 與第一份媒體筆記 +description: 認識課程運作方式，以 HackMD 練習 Markdown，並從生活中的媒體檔案理解多媒體系統。 +tags: 多媒體系統, Markdown, HackMD, 115學年度 +--- + +# 多媒體系統 W01｜HackMD、Markdown 與第一份媒體筆記 + +:::info +本週任務：建立一份自己的 HackMD 筆記，使用 Markdown 整理一個多媒體案例，並交出分享連結。 +::: + +## 一、這門課要做什麼？ + +這門課會使用 Python 與 AI 工具處理影像、聲音與影片，最後完成一個可以操作的多媒體應用。 + +AI 可以協助寫程式與除錯，但每位同學都要能回答： + +- 輸入資料是什麼？ +- 程式做了哪些處理？ +- 輸出結果如何判斷正確？ +- 哪一部分由 AI 協助？你怎麼驗證？ + +## 二、為什麼第一週先學 Markdown？ + +Markdown 是一種純文字標記方式。文字本身仍看得懂，同時可以呈現標題、清單、連結、圖片、表格與程式碼。 + +這學期會用 Markdown 撰寫： + +- 課堂筆記 +- 實作步驟 +- GitHub README +- 專題規格 +- 測試與除錯紀錄 +- AI 使用紀錄 + +學 Markdown 的目的不是背語法，而是把技術工作整理成別人看得懂、自己日後也能重現的文件。 + +## 三、認識 HackMD + +請先完成以下操作： + +- [ ] 登入 HackMD +- [ ] 建立一份新筆記 +- [ ] 找到編輯、雙欄與閱讀模式 +- [ ] 修改筆記標題 +- [ ] 設定分享權限 +- [ ] 將筆記連結貼到指定繳交位置 + +:::warning +不要把密碼、API 金鑰、身分證字號、私人聯絡資料或未經同意的照片放進公開筆記。 +::: + +## 四、Markdown 基本語法 + +### 1. 標題 + +```markdown +# 第一層標題 +## 第二層標題 +### 第三層標題 +``` + +一份筆記原則上只使用一個第一層標題，再用第二、第三層標題整理內容。 + +### 2. 段落與強調 + +```markdown +這是一個段落。 + +這是第二個段落，**這段文字需要強調**，這是 `檔名或指令`。 +``` + +### 3. 清單與待辦事項 + +```markdown +- 影像 +- 聲音 +- 影片 + +1. 取得素材 +2. 處理素材 +3. 輸出結果 + +- [x] 建立筆記 +- [ ] 完成作業 +``` + +### 4. 連結與圖片 + +```markdown +[課程程式庫](https://github.com/willismax/MediaSystem-Python-Course) + +![替代文字](圖片網址) +``` + +替代文字應簡短描述圖片內容，不能只寫「圖片」。如果圖片無法顯示，讀者仍可從文字知道原本要表達什麼。 + +### 5. 引用 + +```markdown +> 這是一段引用或需要特別標示的內容。 +``` + +### 6. 程式碼 + +````markdown +```python +message = "Hello, multimedia!" +print(message) +``` +```` + +反引號後方標示 `python`、`bash` 或 `json`，可以讓程式碼更容易閱讀。 + +### 7. 表格 + +```markdown +| 檔案 | 類型 | 用途 | +|---|---|---| +| photo.jpg | 影像 | 活動照片 | +| voice.wav | 聲音 | 語音辨識測試 | +| demo.mp4 | 影片 | 專題展示 | +``` + +表格適合比較固定欄位，不要為了排版把每一段文字都塞進表格。 + +## 五、課堂實作：我的多媒體名片 + +請複製下方內容到自己的 HackMD 筆記，再改成自己的資料。 + +```markdown +# 我的多媒體名片 + +## 基本資料 + +- 姓名或課堂暱稱： +- 班級： +- 我最常使用的裝置： + +## 我每天接觸的多媒體 + +| 情境 | 媒體類型 | 常見格式或平台 | 我在意的問題 | +|---|---|---|---| +| 範例：聽 Podcast | 聲音 | MP3、串流平台 | 音質、檔案大小、字幕 | +| | | | | +| | | | | +| | | | | + +## 我想做的作品 + +我希望這學期做一個＿＿＿＿＿＿＿＿，它可以幫助＿＿＿＿＿＿＿＿。 + +## 我目前對 AI 寫程式的看法 + +- 我用過的工具： +- 我覺得最方便的地方： +- 我最擔心的問題： + +## 本週問題 + +1. JPEG 與 PNG 有什麼差別？ +2. MP3 為什麼通常比 WAV 小？ +3. MP4 是影片內容、壓縮方式，還是檔案容器？ + +## 本週完成檢查 + +- [ ] 使用標題 +- [ ] 使用一般清單 +- [ ] 使用待辦清單 +- [ ] 加入至少一個連結 +- [ ] 加入一張可公開使用的圖片 +- [ ] 加入一個表格 +- [ ] 加入一段程式碼 +- [ ] 設定正確分享權限 +``` + +## 六、班別活動 + +### 日間部引導活動 + +兩人一組交換筆記，檢查： + +1. 標題層級是否清楚。 +2. 圖片是否有替代文字。 +3. 連結是否可以開啟。 +4. 表格內容是否完整。 +5. 是否誤放個資或不適合公開的資料。 + +完成後，在同學筆記留下「一項看得懂的地方」與「一項需要補充的地方」。 + +### 進修部挑戰活動 + +從工作、社團或生活經驗選一個流程，用 Mermaid 畫出媒體資料如何流動。 + +````markdown +```mermaid +flowchart LR + A[取得影像或聲音] --> B[處理] + B --> C[儲存] + C --> D[分享或播放] +``` +```` + +再補充兩個問題： + +- 哪一步最可能遇到格式不相容？ +- 哪一步可能涉及個資或著作權？ + +## 七、繳交方式 + +請繳交 HackMD 閱讀連結。繳交前以無痕視窗測試，確認教師可以開啟。 + +最低完成條件： + +- 正確使用六種以上 Markdown 語法。 +- 完成多媒體名片與三個觀察案例。 +- 沒有公開密碼、金鑰或未經同意的個資。 +- 連結權限正確。 + +## 八、離堂小紙條 + +下課前在筆記最後回答： + +1. 今天最有把握的一個 Markdown 語法是什麼？ +2. 還不確定的地方是什麼？ +3. 你希望 AI 在這門課幫你完成什麼？ +4. 哪一件事不能只相信 AI，必須自己檢查？ + +## 延伸閱讀 + +- [HackMD 官方教學](https://hackmd.io/tutorials) +- [GitHub Markdown 基本語法](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) +- [MediaSystem-Python-Course](https://github.com/willismax/MediaSystem-Python-Course) From 58ecc2200e3bec13b2924a0fe083f8abc3d714d9 Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:42:04 +0800 Subject: [PATCH 4/8] docs: define HackMD and GitHub workflow --- course-115/HACKMD_WORKFLOW.md | 130 ++++++++++++++++++++++++++++++++++ 1 file changed, 130 insertions(+) create mode 100644 course-115/HACKMD_WORKFLOW.md diff --git a/course-115/HACKMD_WORKFLOW.md b/course-115/HACKMD_WORKFLOW.md new file mode 100644 index 0000000..2e20bf9 --- /dev/null +++ b/course-115/HACKMD_WORKFLOW.md @@ -0,0 +1,130 @@ +# HackMD 與 GitHub 教材工作流程 + +## 決策 + +目前不導入 HackMD API。 + +先使用 HackMD 內建的 GitHub Sync，原因如下： + +- 只有兩個班級入口與一組共用教材，尚未達到需要批次自動化的規模。 +- 教師平常以 HackMD 編寫授課內容，HackMD 應維持正文來源。 +- GitHub 主要保存程式、Notebook、素材與 Markdown 版本。 +- API 會增加 token 保管、權限、更新衝突與錯誤覆寫風險。 + +## 單一來源 + +| 內容 | 主要來源 | 另一端用途 | +|---|---|---| +| 課堂講義與每週筆記 | HackMD | GitHub 保存版本 | +| Python 程式與 Notebook | GitHub | HackMD 放連結與操作說明 | +| 班級公告與期限 | 各班 HackMD 首頁 | 不需同步 | +| 固定圖片與下載檔 | GitHub `assets` | HackMD 引用 | +| 學生課堂筆記 | 學生自己的 HackMD | 只繳連結 | + +同一份 Markdown 在一段編輯期間只能有一個主要來源。不要在 HackMD 與 GitHub 同時修改後再互相覆蓋。 + +## 建議目錄 + +```text +course-115/ +├─ README.md +├─ common-syllabus.md +├─ notes/ +│ ├─ week-01-hackmd-markdown.md +│ ├─ week-02-python-ai-workflow.md +│ └─ ... +├─ labs/ +│ ├─ common/ +│ ├─ day/ +│ └─ night/ +├─ assets/ +└─ templates/ +``` + +目前第一週教材位於 `course-115/week-01-hackmd-markdown.md`。與正式 repo 整合時，可移至 `notes/`，並同步修正連結。 + +## 初次連結 + +每份共同教材各自連結一個 GitHub Markdown 檔案： + +1. 在 HackMD 開啟共同教材。 +2. 開啟「Versions and GitHub Sync」。 +3. 安裝並授權 HackMD GitHub App，只開放需要的 repo。 +4. 選擇 repo、分支與對應檔案。 +5. 確認換行規則。 +6. 建立命名版本，例如 `W01 初版`。 +7. 將命名版本推送至 GitHub。 + +建議對應： + +```text +HackMD：W01｜HackMD、Markdown 與第一份媒體筆記 +GitHub：course-115/notes/week-01-hackmd-markdown.md +``` + +## 每週發布流程 + +### 課前 + +1. 在 HackMD 修改共同教材。 +2. 用閱讀模式完整檢查一次。 +3. 測試所有連結、圖片、程式碼與分享權限。 +4. 儲存命名版本，例如 `W03 上課版`。 +5. 從 HackMD 推送到 GitHub。 +6. 在日間部與進修部首頁貼上同一份共同教材連結。 +7. 各班首頁補上不同的日期、作業與分流活動。 + +### 課後 + +1. 修正上課時發現的錯誤。 +2. 儲存命名版本，例如 `W03 課後修正版`。 +3. 再推送至 GitHub。 +4. 程式或 Notebook 若有修正，直接在 GitHub 維護，再更新 HackMD 連結。 + +## 衝突處理 + +如果 GitHub 檔案已被修改： + +1. 暫停從 HackMD 推送。 +2. 先比較 HackMD 與 GitHub 版本。 +3. 決定哪一端是這次變更的正本。 +4. 將差異合併至正本。 +5. 儲存 HackMD 命名版本後再同步。 + +不要直接選擇整份覆蓋，尤其是學生或協作者已在 GitHub 提交修改時。 + +## 何時才需要 HackMD API？ + +符合以下任一情況，再導入 API： + +- 要一次建立完整 18 週筆記。 +- 要每天或每週自動備份所有課程筆記。 +- 要批次更新兩班首頁的週次與連結。 +- 要從其他系統自動發布公告或產生筆記。 +- 要建立課程儀表板，讀取多份筆記的標題、標籤與更新時間。 + +不建議用 API 做無人監督的雙向同步。 + +## 未來導入 API 的最低安全規範 + +1. Token 只能放在環境變數或祕密管理服務，不得寫入程式、Notebook 或 HackMD。 +2. 自動化程式預設只讀；確認備份與差異後才開放更新。 +3. 更新前先下載原始內容並保留時間戳記版本。 +4. 維護 `noteId` 與 repo 檔案的明確對照表。 +5. 每次更新只指定一個方向，不做自動雙向合併。 +6. API 回傳失敗時停止，不以空內容覆蓋筆記。 +7. 定期撤銷不再使用的 token。 + +建議的環境變數名稱： + +```text +HACKMD_API_TOKEN +``` + +## 圖片與附件 + +- 課堂臨時示範可使用 HackMD 上傳。 +- 會長期使用的教學圖片放在 GitHub `assets`，並使用清楚檔名。 +- 學生上傳圖片前需確認本人有權公開。 +- 圖片需撰寫替代文字。 +- 不把含個資的原始照片放進公開 repo。 From c52001e6db904905be0ebf2169e5fcf3f57498dd Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:42:19 +0800 Subject: [PATCH 5/8] docs: add weekly HackMD lesson template --- course-115/templates/weekly-note.md | 91 +++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 course-115/templates/weekly-note.md diff --git a/course-115/templates/weekly-note.md b/course-115/templates/weekly-note.md new file mode 100644 index 0000000..cc9f316 --- /dev/null +++ b/course-115/templates/weekly-note.md @@ -0,0 +1,91 @@ +--- +title: 多媒體系統 WXX｜單元名稱 +description: 一句話說明本週要解決的問題。 +tags: 多媒體系統, 115學年度 +--- + +# 多媒體系統 WXX｜單元名稱 + +:::info +本週任務：請填入學生下課前可以完成的具體產出。 +::: + +## 學習目標 + +完成本週課程後，你應能： + +1. 說明＿＿＿＿＿＿＿＿。 +2. 操作＿＿＿＿＿＿＿＿。 +3. 比較＿＿＿＿與＿＿＿＿。 +4. 驗證＿＿＿＿＿＿＿＿。 + +## 課前準備 + +- [ ] 開啟教材與範例 +- [ ] 準備指定素材 +- [ ] 確認執行環境 + +## 共同必學 + +### 概念 + +請以一個實際問題開始，再補上必要名詞、圖示與比較。 + +### 示範 + +```python +# 放入最小可執行範例 +``` + +### 檢查理解 + +1. 輸入是什麼？ +2. 程式做了什麼？ +3. 輸出如何判斷正確？ + +## 課堂實作 + +### 基本任務 + +- [ ] 可以執行 +- [ ] 使用指定輸入 +- [ ] 保存輸出 +- [ ] 記錄參數 + +### 日間部引導 + +提供固定輸入、逐步提示、參數比較與完成檢核。 + +### 進修部挑戰 + +提供可選需求、實務情境或整合方向，但保留明確最低完成條件。 + +## AI 協作紀錄 + +- 我請 AI 協助的問題： +- AI 的建議： +- 我採用或拒絕的理由： +- 我的驗證方式： + +## 常見錯誤 + +| 現象 | 可能原因 | 檢查方式 | +|---|---|---| +| | | | + +## 繳交方式 + +- 繳交內容： +- 分享位置： +- 最低完成條件： +- 截止時間：請在各班首頁公告，不寫死在共同教材。 + +## 離堂問題 + +1. 本週最重要的概念是什麼？ +2. 哪個結果是你實際驗證過的？ +3. 還有哪些限制？ + +## 延伸內容 + +放選讀資料，不把延伸內容混入最低完成條件。 From ed98768e199fd982b7f10336db89ba99fe64d293 Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:42:34 +0800 Subject: [PATCH 6/8] docs: add AI usage record template --- course-115/templates/ai-usage.md | 75 ++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 course-115/templates/ai-usage.md diff --git a/course-115/templates/ai-usage.md b/course-115/templates/ai-usage.md new file mode 100644 index 0000000..6865475 --- /dev/null +++ b/course-115/templates/ai-usage.md @@ -0,0 +1,75 @@ +# AI 使用紀錄 + +## 基本資料 + +- 專題名稱： +- 姓名／組別： +- 使用的 AI 工具與版本： +- 紀錄日期： + +## 使用摘要 + +AI 協助過哪些工作？ + +- [ ] 題目發想 +- [ ] 需求整理 +- [ ] 系統架構 +- [ ] 程式產生 +- [ ] 程式說明 +- [ ] 除錯 +- [ ] 測試案例 +- [ ] 文件撰寫 +- [ ] 圖像、聲音或影片生成 +- [ ] 其他： + +## 關鍵紀錄 + +至少填寫三筆。不要貼完整對話，只保留足以說明決策的內容。 + +### 紀錄一 + +- 我原本要解決的問題： +- 提供給 AI 的必要背景： +- AI 的主要建議： +- 我採用、修改或拒絕了什麼： +- 理由： +- 驗證方式與結果： + +### 紀錄二 + +- 我原本要解決的問題： +- 提供給 AI 的必要背景： +- AI 的主要建議： +- 我採用、修改或拒絕了什麼： +- 理由： +- 驗證方式與結果： + +### 紀錄三 + +- 我原本要解決的問題： +- 提供給 AI 的必要背景： +- AI 的主要建議： +- 我採用、修改或拒絕了什麼： +- 理由： +- 驗證方式與結果： + +## 錯誤與限制 + +- AI 曾經產生什麼錯誤或不適用的建議？ +- 你如何發現？ +- 系統目前還有哪些限制？ + +## 資料與授權 + +- 是否上傳個人資料或他人素材： +- 素材來源與授權： +- API 金鑰是否使用環境變數或祕密管理方式保存： +- AI 生成內容是否經過人工檢查： + +## 個人說明 + +請用自己的話回答： + +1. 專題中最關鍵的一段程式或流程是什麼？ +2. 如果拿掉 AI，你仍然知道如何重現哪幾個步驟？ +3. 下一版最需要改善什麼？ From 24109c26ca2ebed3cdb078aa41c6c8a1830718e6 Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:44:13 +0800 Subject: [PATCH 7/8] docs: add HackMD homepage snippets for both classes --- course-115/hackmd-homepage-snippets.md | 72 ++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 course-115/hackmd-homepage-snippets.md diff --git a/course-115/hackmd-homepage-snippets.md b/course-115/hackmd-homepage-snippets.md new file mode 100644 index 0000000..698fc3b --- /dev/null +++ b/course-115/hackmd-homepage-snippets.md @@ -0,0 +1,72 @@ +# 兩班 HackMD 首頁貼上區塊 + +以下區塊分別貼到日間部與進修部既有 HackMD 首頁。請將 `` 換成第一週共同教材的 HackMD 閱讀連結。 + +## 日間部首頁區塊 + +```markdown +## 多媒體系統 115 學年度 + +> 用 AI 協作開發多媒體系統，並能說明媒體資料如何表示、處理、傳輸與驗證。 + +### 本週課程 + +- [W01｜HackMD、Markdown 與第一份媒體筆記]() +- 課堂任務：完成「我的多媒體名片」HackMD 筆記 +- 本班活動：兩人一組交換檢查標題、連結、圖片替代文字、分享權限與個資 +- 繳交方式：（請填入表單、Teams 作業或指定位置） +- 截止時間：（請填入） + +### 本班學習方式 + +- 每週先理解一個多媒體概念，再完成一個可操作的小實作。 +- AI 可以協助構想、寫程式與除錯，但結果必須驗證，也要能用自己的話說明。 +- 課程共用程式與範例：[MediaSystem-Python-Course](https://github.com/willismax/MediaSystem-Python-Course) + +### 上課前準備 + +- [ ] 可以登入 HackMD +- [ ] 準備 Google 帳號，以便使用 Colab +- [ ] 確認可以開啟 GitHub +- [ ] 不要在公開筆記放入密碼、API 金鑰或未經同意的個資 +``` + +## 進修部首頁區塊 + +```markdown +## 多媒體系統 115 學年度 + +> 用 AI 協作開發多媒體系統，並能說明媒體資料如何表示、處理、傳輸與驗證。 + +### 本週課程 + +- [W01｜HackMD、Markdown 與第一份媒體筆記]() +- 課堂任務：完成「我的多媒體名片」HackMD 筆記 +- 本班挑戰：選擇生活、社團或工作流程，以 Mermaid 畫出媒體資料如何取得、處理、儲存與分享 +- 繳交方式：（請填入表單、Teams 作業或指定位置） +- 截止時間：（請填入） + +### 本班學習方式 + +- 共同基礎會在課堂完成，專題題目與工具保留較多選擇。 +- 可使用自己的工作或生活問題發展專題，但每個階段都要提出可檢查的成果。 +- AI 可以協助構想、寫程式與除錯，但結果必須驗證，也要能說明採用或拒絕建議的理由。 +- 課程共用程式與範例：[MediaSystem-Python-Course](https://github.com/willismax/MediaSystem-Python-Course) + +### 上課前準備 + +- [ ] 可以登入 HackMD +- [ ] 準備 Google 帳號，以便使用 Colab +- [ ] 確認可以開啟 GitHub +- [ ] 可先想一個希望用影像、聲音或影片改善的生活／工作問題 +- [ ] 不要在公開筆記放入密碼、API 金鑰或未經同意的個資 +``` + +## W01 共用筆記建立方式 + +1. 在 HackMD 建立一份空白筆記。 +2. 開啟「Versions and GitHub Sync」。 +3. 將筆記連結到 `course-115/week-01-hackmd-markdown.md`。 +4. 從 `course-115-hackmd-materials` 分支拉入內容；PR 合併後改連結 `main`。 +5. 用閱讀模式檢查程式碼區塊、Mermaid、連結與分享權限。 +6. 把閱讀連結填回兩個首頁的 ``。 From 802048946e92b0d57d31d2795dc2e853cce61d46 Mon Sep 17 00:00:00 2001 From: willis Chen Date: Mon, 10 Aug 2026 19:44:30 +0800 Subject: [PATCH 8/8] docs: link class homepage snippets --- course-115/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/course-115/README.md b/course-115/README.md index 9fac6eb..738a789 100644 --- a/course-115/README.md +++ b/course-115/README.md @@ -26,6 +26,7 @@ - `common-syllabus.md`：18 週共同課程地圖、日夜間分流與評量方式。 - `week-01-hackmd-markdown.md`：第一週可直接貼入 HackMD 的學生版教材。 +- `hackmd-homepage-snippets.md`：日間部與進修部首頁可直接貼上的課程區塊。 - `HACKMD_WORKFLOW.md`：HackMD 與 GitHub 的分工、同步流程及 API 採用條件。 - `templates/weekly-note.md`：後續週次的共同教材模板。 - `templates/ai-usage.md`：學生專題的 AI 使用紀錄模板。