EP15 繳交

檢查清單：別人的裝置（20 分鐘）

先說結論：今天不是自己對著清單打勾。 自己勾，你每一格當然都會打勾——因為東西在你電腦上、你已經登入了、你知道要點哪裡。

所以這一段要做的是：找一個沒看過你們作品的人，照著你們寫的字做一次。

實測分兩層，兩層用的裝置不一樣——這是刻意的：

1. README 用你的螢幕給他看。 你們的 repo 是私有的，他用自己的手機開會看到 404，那不是你們的錯。所以請他坐到你的螢幕前讀 README，你轉過去，一個字都不准說。
2. 作品要用他自己的裝置打開。 這一層不能借你的電腦——「只有在你這台電腦上才會動」正是今天要抓出來的病。他照 README 上的字，在他自己的手機或電腦上把它打開、裝起來、加好友。

先把 README 叫出來（你的螢幕，他來讀）：

https://github.com/shsh-tw/proj-你們的隊名

（上面三格沒填的話，複製出來會是「你們的隊名」四個字。先填。）

三條規則，講死不准破：

1. 測的人只能照 README 上的字做，不准問作者。README 以外的一律不算——作者的口頭補充、螢幕上已經開著的那個視窗，都不算。
2. 作者只准記，不准出手。 你一開口教他，這次實測就作廢了——你測到的是「有你在旁邊的時候它會動」。
3. 測的人做不到的每一件事都要記下來：打不開、看不懂要從哪裡開始、按了沒反應、要登入才看得到、手機上排版爛掉、字看不清楚。那張清單就是接下來要修的東西。

三分鐘後換手，換你們去測他們的。

• LINE Bot：他手機加好友就行，最單純。
• Chrome 外掛／要在電腦上跑的程式：手機本來就裝不了。改用教室裡另一台電腦（不是你那台），他照 README 從第一步裝起來。裝不起來，那正是今天要修的東西。
• 真的連另一台電腦都沒有：至少讓他把 README 的安裝步驟一步一步唸出來，唸到他答不出「下一步在哪」，那一步就是要補的。

修與定稿（60 分鐘）

順序不要顛倒：先開機，再修別人打不開的，再補 README 三件，最後 push 定稿。

〇、先把電腦準備好（跟前面每一堂一模一樣的那幾行）

上一堂下課前你把這台機器的身分清掉了，所以要重新登入：

gh auth login

（GitHub.com → HTTPS → Yes → Login with a web browser → 先看瀏覽器右上角頭像是不是你 → 打八碼 → Authorize）接著四行，一行都不能少：

gh auth setup-git
git config --global user.name "你的帳號"
git config --global user.email "你的專用信箱"
git config --global pull.rebase false

然後進到你們的資料夾（第一次在這台電腦就先 gh repo clone shsh-tw/proj-你們的隊名）：

cd proj-你們的隊名
git pull
git status

git status 前面每一堂都看過：有沒有不認得的檔案跑進來（.env、金鑰檔、別人的照片），有沒有你以為存進去其實還沒的檔案。

一、先修那張清單

排序只有一個原則：「打不開」永遠排在「不好看」前面。

修不完怎麼辦？時間到就停手——把還沒修好的是什麼、下一步是什麼，寫進 README 的說明裡。誠實寫下來，比留一個打不開的網址好。

二、README 三件

加在 README 最下面。上面 EP05 那六個標題一個字都不要改、不要刪（## 我們要幫誰、## 解決什麼問題、## 為什麼值得做、## 第一版最小能做什麼、`## AI 挑了什麼漏洞、我們怎麼回答`、## 下一步）——燈是照標題找內容的，改掉會滅。

也不要叫 AI 重寫整份 README——它會把那六個標題一起蓋掉。

第一件：截圖——在 README 最下面打一個新標題 ## 截圖，下面放：

一張看得到它在做事的畫面，或一段 30 秒錄影。

這是硬規則，不是加分項。 網址哪天死掉、電腦哪天不在手上，這是唯一還能證明你做過的東西。

最快的做法：在 GitHub 打開 README.md → 右上角鉛筆 → 把圖片直接拖進編輯框（它會自己上傳並產生一行連結）→ Commit。

截圖 Win + Shift + S 框選。先截圖，截圖一定做得到。

想錄影的話：Win + Alt + R（Xbox Game Bar，30 秒就夠，從「打開」到「它動了」）。

按了沒反應？學校電腦常常把它關掉了——用手機直接拍螢幕，一樣算。

拍完檔案通常超過 10 MB，GitHub 編輯框傳不上去：傳到自己的雲端硬碟，把連結貼進 README 就好。

第二件：說明——再打一個標題 ## 說明，下面放：

從學期歷程單那七行裡挑三行，串成一段。不寫新文章。

怎麼挑：一行講你們幫的是誰、一行講你們做出來最關鍵的那個東西、一行講卡最久的那件事後來怎麼過的。

照抄你們自己寫的原句，只補連接詞。你要做的是選擇跟排序，不是重新生產。

第三件：怎麼看到它動——最後一個標題 ## 怎麼看到它動，下面放：

這一欄不叫「部署網址」——不是每一組都有網址，Chrome 外掛、LINE Bot、要在電腦上跑的程式本來就沒有。

照你們作品實際的樣子，三種寫法擇一（不要為了交作業把作品改造成網站）：

• (a) 有穩定網址：貼網址。要 https:// 開頭、點得動的完整網址。
• (b) 要安裝、要加好友：寫清楚第一步、第二步、第三步，加一張 QR。
• (c) 沒有網址、要在你們電腦上跑：寫「現場示範」，並且把安裝或啟動的步驟一步一步寫清楚（第一步、第二步、第三步）。

第一件的截圖已經是硬規則，所以這裡不再要求錄影——想錄的話很好（EP16 上台會很好用），但沒錄不扣分。

要 QR 的組用這個（貼上你們的網址或加好友連結，把畫出來的 QR 截圖放進 README）：

三、當堂 push 定稿

push 之前先掃一次：VS Code 按 Ctrl+Shift+F，搜 key、token、password，再搜一次你們訪談那個人的真名、手機號碼、班級座號。

看到就刪」是錯的判準——event.key、Object.keys、keydown 這種是程式本來就有的字，刪掉東西會壞。

真正要處理的只有一種：一串你看不懂的亂碼（通常超過 20 個字、英文數字混在一起）。那才是 key，那才要刪。個資則是看到就刪。

git add -A
git commit -m "EP15 定稿：＿＿"
git push

（＿＿ 換成你們作品一句話的名字，例如「找廁所地圖」。不要照抄底線。）

兩個人都有改東西的話，誰改的誰自己 push：A 先 push，B 先 git pull 再 push（跟前面七堂一樣的兩步）。

口試補問（80–90 分，10 分鐘）

老師會叫還沒被問過的組（缺席過的、上次說要再看的，也在這一段補完）。

被叫到：把螢幕轉過來，指著自己做的東西講。問的就是那三句，跟前面幾堂被問過的組完全一樣：

1. 你們到底在幫誰解決什麼？
2. 指一個你們做過的重要決定，為什麼這樣選？
3. 在作品或 repo 裡指出證據給我看。

不用背答案。 可以結巴、可以想很久、可以看著螢幕慢慢講——問的是你講不講得出來、指不指得出來。

還沒被叫到的組做這件事（這一段大多數人都不會被叫到，這是正常的）：

去測第二組。 找一組今天還沒有人測過的——不是早上跟你換手的那一組，是新的一組。

規矩完全一樣：他的 README 讀在他的螢幕上，作品開在你的裝置上，你只能照字做。

測完把清單交給他。 這是他今天第二次、也是最後一次拿到外人的眼睛。

早上你們是被測的人，現在你是那雙眼睛。這件事對他們的作品比對你自己的更有用。

登出儀式（最後 10 分鐘）

跟前面每一堂一模一樣，公用電腦，90 分整開始，不能拖。

gh auth logout
git config --global --unset-all user.name
git config --global --unset-all user.email

VS Code 左下角人像 → Sign out。最後按這一頁最下面的「清掉這台瀏覽器的紀錄」。

做完了？進階挑戰（不計分）

• 拿去問家人：把「怎麼看到它動」那一段傳給家人，他照著做得到，才算真的寫清楚了。
• 補一段 30 秒錄影：從「打開」到「它動了」。EP16 上台如果網路出事，這段影片就是你的救命稻草。
• 第三組：如果你連第二組都測完了，還有時間，就再找一組。

備援路線

自檢清單