網站計畫

PLAN.md 會在專案的首次建置完成的那一刻撰寫，其目的是始終描述網站目前的樣貌——而不是記錄它曾發生過的所有事情（那是「版本」分頁和「變更日誌」的用途）。「網站計畫」畫面會將該 Markdown 解析為實際的介面：頁面以表格呈現，模組以清單呈現，未解決的問題以核取清單呈現，而業務資訊、品牌與決策則以純文字段落呈現。

在任何建置完成之前，尚無可讀取的內容：此畫面會顯示「尚無計畫」，清楚說明計畫是由專案的首次建置所撰寫，並提供返回專案自己頁面的連結，而不是顯示空白的表格。

若網站檔案在沒有計畫的情況下匯入（透過連接器從其他 AI 工具發布、匯入或上傳），仍會產生一份計畫：此畫面會以專案簡報、所選的套件與測量過的頁面為基礎開始建立計畫，並顯示一則橫幅「此計畫是為您開始建立的」，提供「儲存此計畫」按鈕，使其成為專案的正式計畫，之後每個區段都可以編輯。「閱讀完整網站計畫」則會連到「計畫與簡報」分頁上的計畫文件。

之後從套件中新增的工具（「加入至計畫」）會以「已規劃」的狀態加入模組清單，並附上「在套件中查看」連結，即使計畫文字是在它們被加入之前撰寫的也是如此。

在標題下方，有一行會顯示計畫上次更新的時間：「計畫已更新 10月2日 下午3:04」。此時間取自 aiKit 上次測量網站實際檔案的時刻，每次變更後都會進行測量（例如聊天編輯、釘選、套件新增、還原、手動編輯計畫，或從其他 AI 工具發布）。

頂部（計畫建立後）：整體完成百分比進度條，下方是三個方塊：已建置頁面（共規劃頁面）、已建置模組（共選定模組）、已回答問題（共計畫中未解決的問題）。每個方塊都是按鈕，點一下會捲動到它所統計的區段。這些數字都不是由計畫文字自行宣告的：只有當 aiKit 在網站的實際檔案中找到該頁面時，才算已建置；模組只有在已驗證的建置報告中或檔案中找到時，才算已建置；問題則是在計畫中勾選完成，或客戶已在「問題」頁面回答，才算已回答。

有兩種情況會讓計畫落後，畫面會說明是哪一種：計畫的 AI 整理程序在上次變更後未完成（「上次變更後，文字計畫未更新」，並附上原因），或網站有比計畫依據的版本更新的版本（「上次更新計畫後，網站已有變更」）。出現這兩種情況時，都會顯示「重新整理計畫」按鈕。開啟頁面時不會自動執行（開啟頁面從不使用 AI）；引擎本來就會在背景將每次變更整合進計畫，這個按鈕是為了處理落後的情況。按下「重新整理計畫」會把最新的變更整合進文字計畫，並重新測量網站。如果仍然無法完成，提示列會保留錯誤原因，你可以再按一次「重新整理計畫」，或直接手動編輯計畫。

健康度卡片會根據 aiKit 在實際檔案中檢查的規則為網站打分（滿分 100 分），而不是依據 AI 的意見。檢查項目包括：頁面標題或搜尋說明缺漏或重複、頁面沒有主標題或有多個主標題、連結到不存在的頁面、沒有任何頁面連結而且選單也未列出的頁面、圖片缺少給螢幕閱讀器使用的說明、頁面過短、表單沒有提交目的地，以及需求中要求但網站上沒有的模組。每個問題都會說明位於哪個頁面、為什麼重要，並附有「修正」按鈕：按下後會將該問題現成的修正指示以請求送出，並交給 AI 處理；處理期間按鈕會顯示「已送出修正請求」，變更完成後會重新測量分數。你可以用高、中、低三種嚴重程度的數量來篩選清單，按「顯示全部」則會清除篩選。

網站地圖會以樹狀圖呈現網站：最上方是首頁，接著依序是選單項目，再來是從這些頁面連結到的其他頁面。沒有任何頁面連結到的頁面會列在自己的群組中；計畫中列出但尚未建置的頁面會以虛線繪製，並標示「已規劃」；已建置但計畫中未提及的頁面會標示「不在計畫中」，並附上「加入計畫」按鈕，點擊後即可將其加入「頁面」區段。

點選任一頁面（在網站地圖或頁面清單中），即可在計畫旁開啟該頁面的詳情。網址列會變成 ?page=/about，因此連結可讓團隊中的任何人開啟同一頁面。詳情包含：該頁面在 Google 上的呈現方式（標題、網址、說明）、區段與主標題、字數、圖片數量及缺少說明的數量、表單以及執行它的套件模組、客戶是否已核准，以及最近一次變更：時間、提出者，以及他們的要求內容。

歷史紀錄會列出 aiKit 保留的版本（原始版本以及最新的 10 個），由新到舊排列，顯示版本編號、變更類型（首次建置、聊天、釘選、套件、發佈、還原、計畫編輯）、時間、要求內容、提出者，以及有哪些頁面變更（點選頁面即可開啟詳情）。最新版本會標示為「目前版本」；較舊的版本會有「還原此版本」，按下後會先詢問，並在還原前儲存目前狀態，因此還原動作可以復原。預設顯示前三筆，按「顯示全部」可列出其餘版本。

「商業資訊」區段會將客戶檔案中的電話、電子郵件、地址與營業時間，與已建置頁面的文字進行比對（優先比對首頁與聯絡頁面）。每項資訊會顯示「已在網站上」或「網站上找不到」（並註明檢查了多少頁面，因為網站可能仍顯示舊的資料），另有「在客戶檔案中編輯」連結，讓客戶檔案保持為唯一的正確來源。

• 頁面——表格，包含：頁面、路徑、用途與狀態（已建置或已規劃）；當頁面已建置且網站已上線時，會出現真正的「檢視」連結，可前往線上頁面。
• 模組與工具——計畫中列出的每個模組，各附「已建置」或「已規劃」標籤，以及各自的備註。
• 商業資訊——營業時間、地址、服務項目、價格，以及任何關於業務的事實資料，以純文字呈現。
• 品牌——計畫中記錄的色彩配置、語氣與任何風格備註。
• 決策——已經確定的正式決定，下一次編輯時不應再重新討論。
• 未解決問題——仍真正未定案事項的清單，每項會顯示「已回答」或「仍未解決」。

每張區段卡片都有相同的兩個按鈕。「編輯」會以一般文字框開啟該區段的原始 Markdown，並直接儲存回 PLAN.md——這是實際且立即的寫入（透過專案本身的 PUT 端點），但刻意不會觸發建置或部署；它只會改變計畫文件的內容，就像編輯其他備註一樣。

「要求修改」刻意與眾不同：它會開啟一個小表單（「您希望修改 <section> 的哪些內容？」），送出後會在專案的「回饋」分頁建立一筆正式請求，標題為「網站規劃 — <Section>：…」，與任何標記或快速編輯請求一樣，並有自己的狀態流程；送出後還會出現「查看請求」連結。當您想自己更正或改寫規劃本身的文字時，請使用「編輯」；當您希望實際網站（進而規劃）一併更新時，請使用「要求修改」。

這份計畫分為兩層。量測數據（頁面、標題、章節、連結、表單、模組、健康狀況）由程式在每次變更後直接從實際檔案擷取，因此不會與實際內容脫節。文字計畫（目標、業務資訊、品牌、決策、待解問題）則由 AI 在每次變更後更新，且只改寫受該變更影響的部分。它從不新增變更記錄或帶日期的條目；變更紀錄都保存在「歷史」中。

如果這次 AI 更新失敗，文字計畫會維持原樣，不會只改寫一半；失敗會被記錄下來，畫面會顯示「重新整理計畫」（見上方），而不是悄悄顯示過時的計畫。

計畫旁的側欄放有各項操作（在手機上，側欄會變成緊接在進度區塊下方、全寬的「複製客戶連結」按鈕，其餘操作收合在「更多操作 (3)」下）。「與客戶分享」會複製唯讀連結（aikit.ai/p/<project>/plan），不含員工工具、編輯按鈕或任何內部內容。「開啟正式網站」是直接連到正式網站的連結；若網站尚未上線，側欄會清楚顯示「尚未上線」。「檔案」會顯示實際檔案數量，可展開查看每個檔案的路徑與大小。「下載計畫」會下載目前實際的 PLAN.md 檔案，為真正的 .md 檔，內容與畫面讀取的位元組完全相同，而不是重新產生的摘要。

客戶的頁面會開在「計畫」分頁，顯示員工在「計畫與簡報」分頁看到的同一份網站計畫文件（概述與目標、目標受眾、策略、網站地圖、每個工具及其對業務的用途與狀態、內容計畫、時程、決策與待解問題），但不含僅限員工的部分：不顯示新增工具時輸入的備註、不顯示誰新增了什麼、不提供連到 aiKit 工具包的連結，也沒有「撰寫計畫」按鈕。第二個分頁「頁面與核准」則保留下方的逐頁檢視。

在「頁面與核准」中，客戶使用他們already用來留下意見回饋的同一組存取碼即可進入（不需另外登入），會看到相同的進度區塊、其頁面的網站地圖、附有「檢視」連結的頁面清單、模組、業務資訊、品牌、決策與待解問題，以及「計畫已更新」的說明文字。他們看不到健康狀況、修正說明、歷史紀錄、誰提出了什麼要求、檔案清單，也沒有任何編輯或「要求變更」按鈕。

員工為自己標記的任何內容，會在頁面傳送前於伺服器端移除，每個章節皆如此：包含「(internal)」、「[internal]」或「(staff only)」的行，以「Internal:」或「Staff only:」開頭的行，標題為 Internal 或 Staff only 的任何章節，以及隱藏的註解。這些行完全不會送到客戶的瀏覽器，即使在頁面的網路資料中也不會出現。

每個已建置的頁面都有「核准」按鈕。客戶輸入姓名（以及選填的備註）即可核准；核准會綁定該頁面的確切內容，因此如果之後頁面有變動，會顯示「自您核准後已變更」，並再次請您確認。只有使用客戶存取碼的人可以核准。若您在以員工身分登入時開啟客戶連結，您會看到每個頁面的核准狀態，但不會看到「核准」按鈕，因此無人能代客戶核准。在員工的網站計畫中，已核准的頁面會顯示「客戶已核准」，有變動的頁面則顯示「自核准後已變更」。

頁面底部有「傳送意見回饋」按鈕：若網站已上線，會開啟正式網站並自動開啟意見回饋浮層（使用客戶自己的存取碼）；若尚未上線，則改為開啟其「近期更新」頁面。