第 27 堂｜整理兩項可以交接的作品
分清靜態發布、真實後端與私有資料，留下可重做文件。
公開根目錄與私有後端分開
兩作品入口與必要素材完整，公開根不含私密內容。
先準備
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- 實際檔案清單、兩作品版本識別與部署目標（未知明示）
portfolio是靜態作品，service-site需要真正Node後端。只發布所需前端，不能把私有資料與設定一併公開。
先分清自己的作品、線上畫面與可啟動參考包；線上參考不提供API，請在本機閱讀隨包OPEN_REFERENCE.html後操作。
一起拆解：兩項作品，各有公開邊界
本關18分鐘觀念：3分鐘看輸入、6分鐘逐步推演、5分鐘正常與錯誤對照、4分鐘先預測再說明。
這次的輸入
delivery包含portfolio、service-site/frontend、backend及交接HTML。
作品一公開根：portfolio
作品二公開根：service-site/frontend
後端與DATA_DIR：留在私有執行環境這段是觀念縮圖，完整可操作檔案在本關參考成果；請依當前階段判讀，不把片段直接貼到任意位置。
一步一步推演
- 先列實際檔案與入口，分清兩項作品不能互相漏素材。
- 只整理可公開與需私有的清單；根交接指南不是要整包上傳的站。
- 核對index.html相對連結與本機素材，不把.env、案件或備份上傳。
正常應看到
接手者知道各自怎麼開啟，公開根沒有私有資料。
常見錯誤對照
把整個delivery丟到Pages，既不會自動執行Node，也可能公開不該分享的檔。
先預測，再說明原因
若作品一可開啟，為何仍不能宣稱作品二API已部署？
跟著觀察
- 先讀「兩項作品，各有公開邊界」的輸入，指出本關實際檔案或資料。
- 若作品一可開啟，為何仍不能宣稱作品二API已部署？
- 依例子逐步說明正常結果與錯誤差別，再記下自己的預測；參考結果不是已完成的實測。
做完，自己確認
- 兩作品入口與必要素材完整，公開根不含私密內容。
- 能指出指定檔案與作用範圍。
兩項作品，各有清楚的入口
兩作品入口與必要素材完整，公開根不含私密內容。
先準備
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- 實際檔案清單、兩作品版本識別與部署目標（未知明示）
自己列兩作品入口、公開檔與私有檔，先不公開部署。
跟著做
- 下載delivery，核對portfolio與service-site/frontend、backend、指南。
- 請AI依實際檔案清單產公開包與交付文件清單，不替我部署。
- 檢查圖片、相對index.html連結與無私密檔，保留兩份原始碼。
整理兩項作品的最小交付包
主要使用 Cursor 內建 AI；先附資料，再送出指令。
- 1．附上這些檔案與資料
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- 實際檔案清單、兩作品版本識別與部署目標（未知明示）
- 2．貼到哪裡
- 在 Cursor 開啟自己的本關練習副本，進入內建 AI 對話；正常版與故障副本分開。
- 用 @ 附上本關指定檔案，核對完整路徑；補實際觀察、輸入與結果，再貼下方 Prompt。
- 先讀回覆與差異，只保存指定範圍；回到瀏覽器實際檢查。版本保存由自己操作，不讓 AI 代替驗收或提交。
- 3．預期回覆與操作
- 請AI依實際檔案清單產公開包與交付文件清單，不替我部署。
- 部署與公開URL待實際驗收，不假填成功。
- 4．自己檢查結果
- 兩作品入口與必要素材完整，公開根不含私密內容。
- 部署與公開URL待實際驗收，不假填成功。
整理兩項作品的最小交付包 Prompt（可收合）
你是協助零基礎學員的網站開發助手。我使用 Cursor 免費版編輯原生 HTML、CSS、JavaScript；必要時把你提供的內容手動貼入檔案。
情境與本次輸入：兩項作品放delivery/portfolio與delivery/service-site，原正式網站不動。含可操作HTML交付指南與無秘密環境樣板。作品一靜態發布；作品二同來源Node22+及私有持久JSON，需要講師提供實際HTTPS環境、帳號與重啟方式。未提供或未做的公開部署/免費帳號/另一裝置保持待完成，本機不可替代。
本次任務：依附delivery實際清單，分作品一portfolio（3頁加case、projects/navigation、樣式、本機assets、robots/sitemap範本）及作品二service-site/frontend公開、backend/私有DATA_DIR與指南。只列可公開與需留後端/私有的檔案，不把.env、資料、session、驗證、歷史或教師文件納公開根，不刪必需素材。檢查明寫index.html及可讀HTML指南；環境example只放名稱/假值，密碼不寫前端。不自行發布、改三個既有站或宣稱正式URL成功；產可操作交接清單、待填版本與網址。
請先閱讀我附上的相關檔案或資料，資訊缺漏時精確列出需要補充的項目，不猜檔名、API 或測試結果。說明以繁體中文撰寫，指出檔案與修改位置；檢查結果區分已知、待驗與未完成。只處理學生自己的練習副本，不改現有展示網站，不要求付費訂閱。Cursor AI 無法使用？改用 ChatGPT 備援
把上方指定的檔案內容、清單與補充資料，連同同一份 Prompt 貼入 ChatGPT 對話。只貼電腦上的路徑，無法讓它讀取你的檔案。
收到程式碼時，先核對檔名與修改位置，再手動存回自己的練習副本；若收到檢查表或補檔步驟，就逐項操作。不要把 Prompt 或程式碼框的反引號貼進 HTML／CSS。
兩邊都受限時，可先看既有參考成果、檢查差異與手動修改；未做過的 AI 生成或公開發布仍記待完成。不要貼入帳密、金鑰或真實個資。
複製只取得 Prompt 文字，檔案需自行在 Cursor 附上；本頁不會呼叫 AI 或自動完成關卡。
做完，自己確認
- 兩作品入口與必要素材完整，公開根不含私密內容。
- 部署與公開URL待實際驗收，不假填成功。
線上只看前端畫面；完整操作請下載。本頁不提供案件API。把參考包解壓到新的資料夾，先讀 OPEN_REFERENCE.html，再啟動隨包後端；不要覆蓋自己的作品或案件。
下載本關可啟動參考包後端執行環境、來源與資料都要對應
從真正後端啟動兩作品，詢問重啟後仍在。
先準備
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- 公開環境實際資訊或未知清單、本機啟動與同案證據
完成版使用同來源apiBase空字串，需從Node服務開啟。靜態上傳不會自動執行API；公開環境必須由講師提供並實測。
一起拆解：空apiBase代表同來源
本關18分鐘觀念：3分鐘看輸入、6分鐘逐步推演、5分鐘正常與錯誤對照、4分鐘先預測再說明。
這次的輸入
完成版apiBase=""，由Node8780同時提供frontend與/api。
http://127.0.0.1:8780/inquiry.html
fetch("/api/services") → 同一來源8780/api/services這段是觀念縮圖，完整可操作檔案在本關參考成果；請依當前階段判讀，不把片段直接貼到任意位置。
一步一步推演
- 依START_HERE啟動Node，不從靜態8791或Pages期待API。
- 本機核對同案保存與重啟；正式環境另需HTTPS、持久資料及來源設定。
- 缺主機、帳號或公開URL時明示待完成，不用本機ready代替。
正常應看到
接手文件分清已實測本機與待驗正式環境。
常見錯誤對照
apiBase空字串卻從Pages開前端，請求會去Pages/api而不是自己的Node。
先預測，再說明原因
開啟前端的來源不同，空apiBase會讓API網址怎麼改變？
跟著觀察
- 先讀「空apiBase代表同來源」的輸入，指出本關實際檔案或資料。
- 開啟前端的來源不同，空apiBase會讓API網址怎麼改變？
- 依例子逐步說明正常結果與錯誤差別，再記下自己的預測；參考結果不是已完成的實測。
做完，自己確認
- 從真正後端啟動兩作品，詢問重啟後仍在。
- 能指出指定檔案與作用範圍。
能啟動，也要能交接
從真正後端啟動兩作品，詢問重啟後仍在。
先準備
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- 公開環境實際資訊或未知清單、本機啟動與同案證據
自己寫啟動方式、真正API來源與資料持久位置，公開未知列待完成。
跟著做
- 依delivery/index啟動Node，從8780開前端。
- 請AI只核對同來源config與交付README，列正式環境必要條件。
- 本機完成同案讀寫與重啟，再由自己的帳號/講師環境另行驗公開URL與另一裝置。
核對可重現的啟動與部署交接
主要使用 Cursor 內建 AI；先附資料，再送出指令。
- 1．附上這些檔案與資料
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- 公開環境實際資訊或未知清單、本機啟動與同案證據
- 2．貼到哪裡
- 在 Cursor 開啟自己的本關練習副本，進入內建 AI 對話；正常版與故障副本分開。
- 用 @ 附上本關指定檔案，核對完整路徑；補實際觀察、輸入與結果，再貼下方 Prompt。
- 先讀回覆與差異，只保存指定範圍；回到瀏覽器實際檢查。版本保存由自己操作，不讓 AI 代替驗收或提交。
- 3．預期回覆與操作
- 請AI只核對同來源config與交付README，列正式環境必要條件。
- 交接文件明列實際值與待測，公開帳號/URL不冒充完成。
- 4．自己檢查結果
- 從真正後端啟動兩作品，詢問重啟後仍在。
- 交接文件明列實際值與待測，公開帳號/URL不冒充完成。
核對可重現的啟動與部署交接 Prompt（可收合）
你是協助零基礎學員的網站開發助手。我使用 Cursor 免費版編輯原生 HTML、CSS、JavaScript；必要時把你提供的內容手動貼入檔案。
情境與本次輸入：兩項作品放delivery/portfolio與delivery/service-site，原正式網站不動。含可操作HTML交付指南與無秘密環境樣板。作品一靜態發布；作品二同來源Node22+及私有持久JSON，需要講師提供實際HTTPS環境、帳號與重啟方式。未提供或未做的公開部署/免費帳號/另一裝置保持待完成，本機不可替代。
本次任務：只把service-site/frontend/config.js的apiBase改空字串以同來源部署，timeout不變；依START_HERE由Node後端開8780前端，不把靜態preview的404當後端成功。整理交付HTML：Node22+、管理密碼只後端環境、私有持久DATA_DIR、PUBLIC_ORIGIN/ALLOWED_ORIGINS實際HTTPS、正式TEACHING_MODE=0、同來源/api代理、重啟/備份方式、同案正常及匿名拒絕驗收。作品一用自己Cloudflare Pages Direct Upload獨立專案，作品二需講師實際可用持久後端；若缺帳號/主機/網址明示待測，不捏造永久免費、mock或部署成功。不操作既有三個站，不自動部署。
請先閱讀我附上的相關檔案或資料，資訊缺漏時精確列出需要補充的項目，不猜檔名、API 或測試結果。說明以繁體中文撰寫，指出檔案與修改位置；檢查結果區分已知、待驗與未完成。只處理學生自己的練習副本，不改現有展示網站，不要求付費訂閱。Cursor AI 無法使用？改用 ChatGPT 備援
把上方指定的檔案內容、清單與補充資料，連同同一份 Prompt 貼入 ChatGPT 對話。只貼電腦上的路徑，無法讓它讀取你的檔案。
收到程式碼時，先核對檔名與修改位置，再手動存回自己的練習副本；若收到檢查表或補檔步驟，就逐項操作。不要把 Prompt 或程式碼框的反引號貼進 HTML／CSS。
兩邊都受限時，可先看既有參考成果、檢查差異與手動修改；未做過的 AI 生成或公開發布仍記待完成。不要貼入帳密、金鑰或真實個資。
複製只取得 Prompt 文字，檔案需自行在 Cursor 附上；本頁不會呼叫 AI 或自動完成關卡。
做完，自己確認
- 從真正後端啟動兩作品，詢問重啟後仍在。
- 交接文件明列實際值與待測，公開帳號/URL不冒充完成。
線上只看前端畫面；完整操作請下載。本頁不提供案件API。把參考包解壓到新的資料夾，先讀 OPEN_REFERENCE.html，再啟動隨包後端；不要覆蓋自己的作品或案件。
下載本關可啟動參考包apiBase與端點不能重複拼接
實際API路徑正確，無重複/api與假選項。
先準備
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- fault-L27 config.js、實際Network404與API_CONTRACT
故障apiBase末尾多/api，程式再接/api/services變/api/api/services。先核對Network路徑，不放寬CORS。
一起拆解：不要把/api接兩次
本關18分鐘觀念：3分鐘看輸入、6分鐘逐步推演、5分鐘正常與錯誤對照、4分鐘先預測再說明。
這次的輸入
故障config的base末尾已有/api，程式又追加/api/services。
錯：http://127.0.0.1:8780/api/api/services
對：http://127.0.0.1:8780 + /api/services這段是觀念縮圖，完整可操作檔案在本關參考成果；請依當前階段判讀，不把片段直接貼到任意位置。
一步一步推演
- 從Network抄完整404網址，不只看最後的services。
- 只把base恢復後端根，或依同來源環境設空字串；其他端點不動。
- 重跑服務、新詢問、同id管理、重啟與匿名拒絕，保留作品一。
正常應看到
路徑符合契約，正常身份與持久資料不受影響。
常見錯誤對照
在每支JS亂刪/api，可能讓修好的服務路徑以外又壞其他端點。
先預測，再說明原因
為何修一個base設定比改所有端點更貼近這次原因？
跟著觀察
- 先讀「不要把/api接兩次」的輸入，指出本關實際檔案或資料。
- 為何修一個base設定比改所有端點更貼近這次原因？
- 依例子逐步說明正常結果與錯誤差別，再記下自己的預測；參考結果不是已完成的實測。
做完，自己確認
- 實際API路徑正確，無重複/api與假選項。
- 能指出指定檔案與作用範圍。
部署設定多一段，也會找不到API
實際API路徑正確，無重複/api與假選項。
先準備
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- fault-L27 config.js、實際Network404與API_CONTRACT
親手記故障請求完整URL與404，核對真正服務根網址。
跟著做
- 獨立fault-L27啟動自己的後端，觀察/api/api/services404。
- 請AI只移除apiBase多出的/api或依同來源正常設定回空字串。
- 讀服務、新詢問、同案管理、重啟與匿名拒絕回歸，文件保持一致。
修復API來源的重複前綴
主要使用 Cursor 內建 AI；先附資料，再送出指令。
- 1．附上這些檔案與資料
- 自己的delivery/portfolio及delivery/service-site/frontend指定完整檔案
- delivery/index.html、environment.example.txt、service-site/START_HERE.html及BACKUP_RESTORE.html；秘密不附給AI
- fault-L27 config.js、實際Network404與API_CONTRACT
- 2．貼到哪裡
- 在 Cursor 開啟自己的本關練習副本，進入內建 AI 對話；正常版與故障副本分開。
- 用 @ 附上本關指定檔案，核對完整路徑；補實際觀察、輸入與結果，再貼下方 Prompt。
- 先讀回覆與差異，只保存指定範圍；回到瀏覽器實際檢查。版本保存由自己操作，不讓 AI 代替驗收或提交。
- 3．預期回覆與操作
- 請AI只移除apiBase多出的/api或依同來源正常設定回空字串。
- 兩作品及完整同案流程保留，文件與設定一致。
- 4．自己檢查結果
- 實際API路徑正確，無重複/api與假選項。
- 兩作品及完整同案流程保留，文件與設定一致。
修復API來源的重複前綴 Prompt（可收合）
你是協助零基礎學員的網站開發助手。我使用 Cursor 免費版編輯原生 HTML、CSS、JavaScript；必要時把你提供的內容手動貼入檔案。
情境與本次輸入：兩項作品放delivery/portfolio與delivery/service-site，原正式網站不動。含可操作HTML交付指南與無秘密環境樣板。作品一靜態發布；作品二同來源Node22+及私有持久JSON，需要講師提供實際HTTPS環境、帳號與重啟方式。未提供或未做的公開部署/免費帳號/另一裝置保持待完成，本機不可替代。
本次任務：故障delivery/service-site/frontend/config.js apiBase是http://127.0.0.1:8780/api，inquiry.js再接/api/services造成/api/api/services404。依附完整URL和契約只改config來源為真正根網址http://127.0.0.1:8780，或在同來源Node部署用空字串；不要改所有端點、放寬CORS為*、no-cors、塞假服務或回mock。保留timeout/身份/持久資料/作品一，列服務讀取、新詢問真實id、同案管理、重啟與匿名拒絕回歸；正式URL仍需自己實測，不替我部署。
請先閱讀我附上的相關檔案或資料，資訊缺漏時精確列出需要補充的項目，不猜檔名、API 或測試結果。說明以繁體中文撰寫，指出檔案與修改位置；檢查結果區分已知、待驗與未完成。只處理學生自己的練習副本，不改現有展示網站，不要求付費訂閱。Cursor AI 無法使用？改用 ChatGPT 備援
把上方指定的檔案內容、清單與補充資料，連同同一份 Prompt 貼入 ChatGPT 對話。只貼電腦上的路徑，無法讓它讀取你的檔案。
收到程式碼時，先核對檔名與修改位置，再手動存回自己的練習副本；若收到檢查表或補檔步驟，就逐項操作。不要把 Prompt 或程式碼框的反引號貼進 HTML／CSS。
兩邊都受限時，可先看既有參考成果、檢查差異與手動修改；未做過的 AI 生成或公開發布仍記待完成。不要貼入帳密、金鑰或真實個資。
複製只取得 Prompt 文字，檔案需自行在 Cursor 附上；本頁不會呼叫 AI 或自動完成關卡。
做完，自己確認
- 實際API路徑正確，無重複/api與假選項。
- 兩作品及完整同案流程保留，文件與設定一致。
線上只看前端畫面；完整操作請下載。本頁不提供案件API。把參考包解壓到新的資料夾，先讀 OPEN_REFERENCE.html，再啟動隨包後端；不要覆蓋自己的作品或案件。
下載本關可啟動參考包留下自己的檢查紀錄
記下實際做過的操作、差異與結果。還沒做的項目寫「待完成」。
勾選與筆記只保存在這個瀏覽器。
重設只清除勾選，網站檔案與檢查筆記都保留。