4.9 KiB
4.9 KiB
水晶男孩推廣部 — AI 工作上下文
這個檔案讓 AI 在任何裝置（家／學校）都能快速恢復上下文。 每次對話做了重要決定，請叫我更新這裡，然後 git commit。
專案簡介
水晶男孩（Sechs Kies）推廣粉絲網站。靜態 HTML + PHP + 原生 CSS/JS，無框架。 站主（Noopy）2016 年入坑，藝廊式創作風格。
規範速查（詳細見 developer-rules/rules/）
| 規範 | 檔案 |
|---|---|
| 改檔行為守則（必問再改） | agent-must-ask.md |
| 變更邊界（只改被點名的） | ai-change-boundaries.md |
| CSS 顏色 Token | color-tokens.md |
| 版面視覺預設 | design-defaults.md |
| Git commit 規範 | git-commit-required.md |
| 導覽邏輯（portal-nav） | portal-nav-rules.md |
| 文案語調 | site-voice.md |
最重要的三條：
- 沒說「執行」→ 不改檔
- 只改被點名的那一頁／區塊
- 改完必附 commit 指令（禁止在 sandbox 跑 git）
架構重點
- 全站導覽：
assets/js/portal-nav.js（COMING_SOON_PAGES控制開放） - 全站 CSS：
assets/css/style.css（定義所有 color token） - 首頁：
index.html - 站主索引（自用）：
extra/site-guide.html（data-portal-nav-all-open，不對外） - 內頁 header class：
inner-page-header（禁改回舊名）
variety/ 頁面
| 檔案 | 頁面標題 | 說明 |
|---|---|---|
variety/bangxiao.html |
世紀級寶藏 / 爆笑養老院 | 甜蜜負擔計量器；六人卡片選取 + jQuery 計算；CTA → totoga2/ebook.html |
variety/variety-shows.html |
全員發瘋 | 綜藝節目存檔表；tabs + 搜尋；已對齊 albums.html 扁平結構 |
variety/NJTW/NJTW5.html |
新西遊記5 | 各自暴走專頁 |
portal-nav 操作守則（血淚版）
每次新增或修改導覽，必須先讀這裡再動手。
-
先查
extra/site-guide.html確認層級，再動portal-nav.js。
site-guide 的 depth 數字 = nav 的層級：depth-1 是第一層<li>，depth-2 是子選單項目，depth-3 是 subgroup 裡的巢狀項目。 -
COMING_SOON_PAGES只放檔名（不含路徑）。
normalizePageKey只取 href 最後一段，所以variety/bangxiao.html→ 比對bangxiao.html。 -
直接連結不需要 subgroup。
子選單內只要<li><a>就夠；portal-nav__subgroup只在該項目還有巢狀子項目時才用（例如「傳奇的轉折」有時間軸、電子書等四項）。 -
site-guide.html 要同步更新，否則站主索引頁會顯示舊名稱。
-
commit 前網站不會更新。本地端強制重整用
Ctrl+Shift+R；GitHub Pages 需git push後等約 1 分鐘。
目前工作狀態
最後更新： 2026-08-02
進行中：
- 水晶熱舞社重啟：30TH 報名與水晶練習室練舞清單已接上後臺；播放器本身仍待加入合法影片來源
待確認：
- developer-rules 健檢尚未執行
歷史定位（文案不可再寫錯）：
- 水晶熱舞社是水晶男孩粉絲自主成立的舞蹈社團，並非水晶男孩推廣部旗下組織
- 水晶歌詞社、水晶嘻哈社等其他「社」是當時同好為了好玩延伸的稱呼
- 2017 年 20 週年正式應援由「水晶男孩應援站」企劃與執行；應援站看見水晶熱舞社其中部分成員持續練舞後，邀請這些成員擔任活動的舞蹈小組長，相關影片為該次合作紀錄
已完成：
- 建立 AGENTS.md 跨裝置上下文檔案
- 新增
variety/bangxiao.html（世紀級寶藏 / 爆笑養老院，甜蜜負擔計量器） variety/variety-shows.html重構：移除多層包裝，對齊 albums.html 扁平結構- portal-nav 新增世紀級寶藏，正確放入淪陷瞬間子選單
extra/site-guide.html同步更新：全員發瘋 → 世紀級寶藏- 新增
admin/推廣部後臺第一階段：登入、控制台、管理者帳號、通用 CRUD、媒體上傳及公開狀態總覽 - 水晶熱舞社 30TH 募集表單已接上 PHP/PDO/MySQL，可儲存報名、參與內容與參考檔案
- 後臺新增「30TH 應援報名」清單、搜尋、狀態處理、內部備註與受登入保護的檔案下載
- 架構決定：水晶熱舞社暫時共用推廣部後臺；偶像培訓維持獨立資料邊界，之後另拆專案與登入系統
- 水晶練習室的「練舞清單」已改為讀取
dance_practice_items，後臺可管理歌曲、分類、練習重點、影片網址、難度、進度、優先順序與公開狀態 - 練舞清單初始資料沿用原頁面的 Couple、Com' Back、Road Fighter；偶像培訓的練習生／課程／紀錄未接入此資料表
如何使用這個檔案
換裝置後，告訴 AI：
「請先讀 AGENTS.md，再讀 developer-rules/rules/ 裡的所有規範，然後繼續 [任務]。」