---
name: sylvia-novel
version: 3.6.0
author: hsinyuchi (Sylvia 紀老師)
license: CC BY-NC-SA 4.0
description: >-
  【別名 / 舊稱 (Aliases): hsinyuchi-vocab-novel】
  打造專屬「高中職情境單字小說互動閱讀器」(Sylvia's Vocab Novel Pro) 與「小說總覽」(Sylvia's Novels Hub)。
  由 hsinyuchi (Sylvia 紀老師) 為臺灣高中職（普高/技高）學生量身打造之沉浸式單字學習宇宙。
  對齊 108 課綱核心素養、大考中心 7000 單字 Level 2~4、CEFR A2~B1 分級閱讀。
  具備【校園安全與全年齡界線鐵律：嚴格落實 G-rated/PG-13 校園守則，零色情零暴力，霸總言情著重智性戀反差萌與相互尊重，點到為止】、
  【當紅影視多元流派庫：涵蓋傲嬌霸總反差流、Netflix 黑白大廚、K-POP 韓團選秀、韓劇復仇、仙俠修仙、特工電影、劇本殺、戀綜等流行文化題材】、
  【教師純單字極簡輸入 ➔ 全自動原創單字卡與小說生成工作流：老師免備教材、免貼課本，純丟單字即可啟動】、
  【100% 原創單字庫規範 (去教科書化與版權防護)：例句、英英釋義、搭配詞一律自主以 A2~B1 創生，嚴禁抄襲課本，自由開源零風險】、
  【單字便當盒卡片 10 大完整欄位契約：嚴禁空白，例句、中譯、搭配詞、衍生字、同反義 100% 齊備 ＋ 雙軌兼容容錯】、
  【三元橫排 Meta 指標規範：詞彙數、建議閱讀時間、字數三欄一橫排並列】、
  【母板切片替換防護鐵律：嚴禁貪婪正則，必須切片精確替換 vocabDb、storyParagraphs、endingsData，確保 safeStore 完好】、
  【方案 A 網址路由規範：普高 /s-[冊課]/ 與 技高 /v-[冊課]/ 雙軌隔離，舊網址 0 秒跳轉防呆】、
  【唯一黃金母板規範：100% 以 B3L2 重生逆襲篇為基準代碼，後續課次僅更換色系與文本】、
  【短段落呼吸感與台詞獨立成段鐵律：嚴禁大段塞字，重要對話必須獨立成段，排版輕盈無壓力】、
  【生動角色對話鐵律：每篇小說必須包含 2~4 句高衝突角色對話，嚴禁純旁白式乾癟敘事】、
  【純淨零個人名規範：首頁開頭嚴禁「新豐高中研發」、頁尾嚴禁「研發策劃人名」，確保課堂與研習純粹推廣】、
  【Novels Hub 總部三欄對齊規範：總部比照 Songs Hub，大螢幕一排呈現 3 個 (3-Column Grid)】、
  【Portal 標準小卡靠左規範：Portal 內 Novels Hub 為單一標準小卡，靠左放置，右邊留白】、
  【跨 Agent 零歧義標準：原生純前端無依賴，通殺 Antigravity、Codex、Claude Code、ChatGPT】、
  【嚴格字數標準：中文故事本體嚴格 600~800 字（約 5~6 分鐘閱讀），英文純英改寫 400~550 字】、
  【雙重視圖架構：導讀焦點單字預覽頁 ＋ 沉浸式閱讀內文頁】、
  【三階鷹架切換：Step 1 學習版（括號提示）、Step 2 複習版（雙向翻牌遮罩：遮中文測字義 / 遮英文考拼字）、Step 3 全英版（純美語自然語音串流 / 高音質 MP3 外掛）】、
  【零滑動便當盒單字卡：音標、釋義、例句直觀一屏收納】、
  【極致載具防護：雙層吸頂導航列、單字卡五重順滑收合、手機「上一步」popstate 歷史攔截】、
  【命運分水嶺：三分支結局 A/B/C 點擊即刻彩帶爆破 ＋ 英文名言點睛】、
  【純淨版權聲明：頁底 CC BY-NC-SA 4.0 國際授權與大考課綱指示性合理使用免責聲明】、
  【一課一主題色 (如 Songs Hub 體系)】與 Cloudflare Pages 部署規範。
---

# 📚 高中職情境單字小說互動閱讀器 (Sylvia's Vocab Novel Pro / Novels Hub) v3.6.0

> 🏆 **黃金母板唯一鐵律 (Golden Master Law)**：  
> **所有課次（不論普高或技高）必須 100% 嚴格以 B3L2 重生逆襲篇 (`v-b3l2/index.html`) 作為實體「黃金母板」！**  
> 嚴禁任何 Agent 自由發揮重寫版型、拆分組件或改動 DOM 結構。任何新課次**僅允許置換主題色系、單字庫 (vocabDb)、故事 tokens (storyParagraphs) 與結局 (endingsData)**！

---

## 🛡️ 核心原則一：校園安全與全年齡界線鐵律 (Campus Safety & G-Rated Boundary Protocol)

> ⚠️ **最高教育防護線：全系列小說為高中職學生專屬設計，嚴格落實全年齡普遍級 (G-Rated / PG-13) 規範！**  
> 
> 1. **零色情、零低俗擦邊（點到為止的美好情愫）**：  
>    - **嚴禁**任何性暗示、生理描寫、過度親暱或不良擦邊劇情。  
>    - **霸總與言情題材定位**：主打「**智性戀、反差萌、毒舌但默默護短、在專業上相互成就**」。親密互動嚴格**點到為止**（如：專注的眼神肯定、遞上一杯熱咖啡、雨中撐傘、披上外套、並肩作戰後的相視一笑）。透過氛圍感與心理安全感營造高級心動，而非低俗肉麻。  
> 2. **零血腥暴力（智取替代殺戮）**：  
>    - **嚴禁**血肉模糊、斷肢殘殺、虐待或殘酷描寫。  
>    - 動作、仙俠或商戰衝突以「**智商打臉、招式化解、靈能震退、規則制約、商業契約漏洞擊破**」為主，展現腦力與格局上的降維碾壓。  
> 3. **正向人際與性別尊重價值觀**：  
>    - 拒絕病態控制狂或貶低女性的「古早味霸總」。男女主角必須具備平等人格，女主獨立清醒、專業拔尖、有明確的人生追求；男主尊重對方界線、在關鍵時刻做堅實後盾。傳遞健康自尊、互相賦權（Self-Empowerment）的正向戀愛與合作觀。

---

## 🎬 核心原則二：當紅流行文化多元流派庫 (Viral Pop-Culture Genre Library)

> 💡 **題材多元百變，精準命中高中職生多巴胺興奮點**：  
> 每次收到教師單字時，AI 應主動從以下多元題材中挑選 3 ~ 5 款最貼合詞意的爽文大綱供老師挑選：

1. 👑 **【傲嬌霸總／反差護短甜寵流】（青少女最愛爆款）**  
   - *套路亮點*：表面冰山毒舌的集團掌門人或天才科技少爺，遇上面對刁難不卑不亢的獨立女主；男主嘴上說「我只是不想讓專案延誤」，私下卻調動百人智囊團替女主撐腰、當眾打臉傲慢心機反派；兩人以專業实力並肩橫掃商界。
2. 🍳 **【Netflix 爆款／黑白大廚階級逆襲流】**  
   - *套路亮點*：米其林三星「白湯匙」傲慢嘲諷，街頭無名「黑湯匙」用道地老菜尾與極致火候盲測打哭評審。
3. 🎤 **【K-POP 韓團／出道生存戰流】**  
   - *套路亮點*：跨國選秀節目、練習生被惡意剪輯排擠、舞臺事故神級即興救場、高音 C 位絕殺、直拍全網破千萬。
4. 🎬 **【韓劇大女主／財閥復仇爽劇流】**  
   - *套路亮點*：《黑暗榮耀》/《淚之女王》式隱忍多年、反差千金歸來、名流慈善宴會上拿出關鍵證據當場絕殺打臉。
5. ⚔️ **【熱播陸劇／仙俠宗門大比流】**  
   - *套路亮點*：雜役靈根覺醒、食神神技突破天道、宗門大比一劍驚世、五千度丹火炸出萬年寶甲、傲慢長老震驚下跪。
6. 🕶️ **【好萊塢特工／極限逃生電影流】**  
   - *套路亮點*：《不可能的任務》/《捍衛任務》式倒數三十秒、暗夜街道飆車追逐、破解密碼驚天反轉。
7. 🔍 **【沉浸式劇本殺／暴風雪山莊懸疑流】**  
   - *套路亮點*：豪門孤島夜宴離奇事件、不在場證明、抽絲剝繭密室解謎、兇手崩潰認罪。
8. 📺 **【熱門戀綜／修羅場全網直播流】**  
   - *套路亮點*：《單身即地獄》式真心話修羅場、綠茶心機反派設局、主角人間清醒霸氣回懟。
9. 🏫 **【校園逆襲／重生打臉流】**  
   - *套路亮點*：黃金母板 B3L2 標準：時空重置、五分鐘暴風作畫逆襲成神。
10. 📜 **【校園規則怪談／微恐推理流】**  
    - *套路亮點*：深夜封閉校園、泛黃黑板守則、細思極恐智商突圍。
11. 💼 **【反差商戰／特助隱藏大佬流】**  
    - *套路亮點*：看似低調被欺負的小實習生，實為掌握核心代碼的幕後大老闆，一通電話秒調千億資金。

---

## ⚡ 核心原則三：教師純單字極簡輸入 ＆ 100% 原創自主單字庫規範 (Zero-Friction & 100% Native Vocab)

> 💡 **極致懶人思維與原創版權保護鐵律**：  
> 1. **教師零負擔輸入**：  
>    **教師只需提供純單字清單**（例如：`plastic, convenience, eagerly, surround, drift...`），甚至無須拍照上傳課本或講義！提供課本只是方便參考課次，AI 應具備從零自主原創產出全套互動閱讀器的完整能力。
> 2. **全面原創・杜絕教科書抄襲侵權**：  
>    為了確保教材在全臺灣各校推廣、研習分享與開源發布時**100% 零版權風險、零抄襲爭議**，**嚴禁照搬教科書的例句與英英字典原句**！單字卡的所有欄位一律由 AI 依照臺灣高中職學生的認知能力自主原創撰寫：
>    - **英英釋義 (`def_en`)**：嚴格使用 **CEFR A2 ~ B1 基礎清晰詞彙** 解釋，避免「用難字解釋難字」，讓學生一目了然。
>    - **情境例句 (`tb_ex`)**：一律由 AI 原創撰寫 12 ~ 18 字的現代生活、校園或呼應該篇小說世界觀的生動例句，兼顧地道美式文法與臺灣學生學習盲點。
>    - **搭配詞 (`collocation`)**：自主提煉 1 ~ 2 組臺灣學測、統測最高頻出現的 Collocations。
>    - **衍生字與同反義**：自主對齊大考中心 (CEEC) 7000 單規範補充，健全學生的詞彙網絡。

---

## 🍱 核心原則四：單字卡 10 大完整欄位契約 (Complete Bento Card Schema)

> ⚠️ **最高品質鐵律：單字卡嚴禁僅有格式而無實質內容！**  
> 點擊任何單字或預覽藥丸開啟抽屜時，單字便當盒卡片必須完整呈現以下欄位，**嚴禁遺漏、嚴禁為空**：
> 
> | 欄位名稱 | 鍵名 (Key) | 說明與標準範例 |
> | :--- | :--- | :--- |
> | **英文單字** | `word` | 乾淨字形（例如 `convenience`） |
> | **標準音標** | `ipa` | 美式 KK 或國際音標（例如 `[kənˈviːniəns]`） |
> | **詞性標註** | `pos` | 標示可數/不可數（例如 `n. [U]`、`adj. / n.`） |
> | **課綱等級** | `level` | 明確標註學制與等級（例如 `Level 3・普高核心`、`Level 2・技高核心`） |
> | **中文釋義** | `def_zh` | 臺灣繁體中文習慣譯名（例如 `便利；方便`） |
> | **英文英英釋義** | `def_en` | **CEFR A2~B1 地道易懂原創解釋**（例如 `the state of being useful or easy`） |
> | **大考核心搭配詞** | `collocation` | 高頻片語 1~2 組（例如 `for the convenience of (為了…的方便)`） |
> | **重要衍生字** | `derivative` | 標註詞性變化（例如 `convenient (adj. 方便的)`） |
> | **同義詞 / 反義詞**| `syn` / `ant` | 擴充詞彙網絡（例如 `syn: usefulness`, `ant: trouble`） |
> | **原創生動例句** | `tb_ex` | **100% 原創撰寫（杜絕課本抄襲）**，符合高中職 A2~B1 認知難度之完整例句 |
> | **例句繁體中譯** | `tb_ex_zh` | 繁體中文對照翻譯，支援「中譯 ▾」摺疊切換 |
> 
> **前端 openDrawer 雙軌防禦容錯代碼**：
> ```javascript
> // 例句雙軌兼容（支援 tb_ex 或 example_en）
> const exEn = item.tb_ex || item.example_en || '';
> const exZh = item.tb_ex_zh || item.example_zh || '';
> document.getElementById('dExample').textContent = exEn;
> document.getElementById('dExampleZh').textContent = exZh;
> // 搭配詞雙軌兼容（支援字串或陣列）
> const colText = item.collocation || (Array.isArray(item.collocations) ? item.collocations.join('；') : item.collocations);
> if (colText) tagsWrap.innerHTML += `<div class="drawer-tag-pill"><b>搭配</b> ${colText}</div>`;
> if (item.derivative) tagsWrap.innerHTML += `<div class="drawer-tag-pill"><b>衍生</b> ${item.derivative}</div>`;
> if (item.syn) tagsWrap.innerHTML += `<div class="drawer-tag-pill"><b>同義</b> ${item.syn}</div>`;
> if (item.ant) tagsWrap.innerHTML += `<div class="drawer-tag-pill"><b>反義</b> ${item.ant}</div>`;
> ```

---

## 📊 核心原則五：首頁 Meta 三元指標橫排規範 (Three-Metric Horizontal Meta Bar)

> 💡 **首頁導讀資訊視覺規範**：  
> 頂部標題下方 `.intro-meta` 必須包含**三大客觀指標並排成單一橫排**：
> 1. **核心詞彙量**：`<span>📚 [X] 個核心詞彙</span>`（例如：`📚 21 個核心詞彙`）
> 2. **建議閱讀時間**：`<span>⏱ 建議閱讀 [Y] 分鐘</span>`（通常為 4 ~ 5 分鐘）
> 3. **故事文字總量**：`<span>📝 全文約 [Z] 字</span>`（例如：`📝 全文約 920 字`）

---

## 🛡️ 核心原則六：母板切片替換與運行驗證防護鐵律 (Splicing & Runtime Verification)

> ⚠️ **最高技術禁令：嚴禁貪婪正則取代跨區塊代碼！**  
> 1. **切片拼接替換（Slicing Protocol）**：定位母板 `vocabDb`、`storyParagraphs`、`endingsData`、`currentMode` 之物理索引，以精確切片拼接，確保 `storyParagraphs`、`endingsData`、`safeStore` 100% 留存。  
> 2. **動態運行斷言檢查（Runtime Smoke Test）**：產出後必須經由 Node.js 模擬 DOM 執行環境，驗證 `renderIntroGrid()`、`startReading(1/2/3)` 以及 `openDrawer(k)`（抽屜全欄位填滿率 100%）均無報錯。

---

## 🌐 核心原則七：網址路由規範（方案 A：普高 s- / 技高 v- 雙軌制）

> 1. **普高（Senior High）**：`/s-[冊課]/`（例如 `s-b1l5/`、`s-b3l2/`）
> 2. **技高（Vocational High）**：`/v-[冊課]/`（例如 `v-b3l2/`、`v-b3l4/`）
> 3. **舊網址 0 秒跳轉防呆**：原有舊目錄（如 `/b3l2/`、`/b3l4/`、`/b1l5/`）必須保留 `<meta http-equiv="refresh" content="0; url=../[新路由]/">` 跳轉頁。

---

## ⚡ 核心原則八：文字去 AI 味 ＆ 生動角色對話鐵律 (Dialogue Mandate)

> 每篇小說必須包含 2 ~ 4 句高戲劇張力、帶有強烈衝突的真人角色對話：
> 1. **反派的傲慢叫囂或挑釁**
> 2. **主角從容霸氣的打臉回懟**
> 3. **第三方/評審/群眾的震撼驚呼**

---

## 📱 核心原則九：短段落呼吸感 ＆ 台詞獨立成段排版 (Short Paragraph & Standalone Dialogue)

> 1. **短段落原則**：每個敘事段落以 **1 ~ 3 句話** 為限，交代一個動作、反應或場景轉換即可斷段。全篇應切分為 **12 ~ 20 個段落**。
> 2. **台詞獨立成段**：凡是角色的核心對白（引號「……」之言），**一律獨立成為單獨一段**！
> 3. **雙語段落 1:1 對齊**：英文文本 (`en_tokens`) 必須與中文文本 (`zh_tokens`) 的段落切分保持 100% 嚴格對應。

---

## 🏛️ 唯一黃金母板克隆守則 (Golden Master Protocol)

所有新課次必須直接以 `v-b3l2/index.html` 進行切片克隆，**僅置換以下六大要素**：
1. **主題色系變數**：`--wine`, `--wine-light`, `--mark-bg`, `--mark-ink`, `--banner-bg`, `--banner-border` 及暗色對應變數。
2. **網頁標題與 Meta 課綱指示條**：
   - `<title>`：`《書名：副標題》｜ Sylvia's Novel Hub`
   - `.intro-compat-pill`：`💡 搭配龍騰版[普高/技高]英語 [冊次課號] 核心單字片語情境閱讀`
   - `.intro-title`：`《中文小說書名》`
   - `.intro-sub-en`：`English Novel Subtitle`
   - `.intro-meta`：`<span>📚 X 個核心詞彙</span>`、`<span>⏱ 建議閱讀 5 分鐘</span>`、`<span>📝 全文約 Z 字</span>`
3. **單字庫 (`vocabDb`)**：完整音標、詞性、等級、定義、搭配詞、例句與翻譯。
4. **小說段落 Tokens (`storyParagraphs`)**：**嚴格 600 ~ 800 中文字**，落實短段落與台詞獨立成段，配搭 400 ~ 550 字純英改寫。
5. **結局分支資料 (`endingsData`)**：A/B/C 三分支情節與英文名言。
6. **本機儲存鍵名**：`sylvia_starred_[學制]_[課號]`。

---

## 🖼️ Portal 標準小卡與 Novels Hub 總部三欄對齊規範

1. **教師總部 Portal (`00_Portal/index.html`)**：
   - 保持全站規格高度一致，**Novels Hub、Four-Stage Learning Hub、AI Agent Workflow Hub 一律採用與 One Teaching Hub 相同的標準小卡 (`md:col-span-6`)**。
   - Novels Hub 卡片靠左放置，右邊保持留白，卡片內部不塞入故事卡，僅提供總覽跳轉按鈕。
2. **Novels Hub 總部頁面 (`08_Vocab_Novel/index.html`)**：
   - 點擊 Portal 的「開啟 Novels Hub ➜」按鈕後進入。
   - 總部內部比照 Songs Hub，在桌機大螢幕採用 **三欄對齊網格 (`@media (min-width: 1024px) { grid-template-columns: repeat(3, 1fr); }`)**，一排展示 3 篇獨立小說卡片。

---

## 🛡️ 純淨品牌與去個人名規範 (Zero-Personal-Branding Mandate)

1. **首頁開頭與閱讀器頂部 (Intro Card)**：徽章統一為純粹簡約的 **`單字小說`**。
2. **頁尾結尾 (Footer)**：統一採用純淨版權宣告與 **CC BY-NC-SA 4.0** 國際授權。

---

## 🔤 核心原則八：Tokens 結構契約鐵律 (Story Tokens Contract)

> ⚠️ **最高渲染防護線：目標單字物件嚴禁包含 `t` 屬性！**  
> 在 `storyParagraphs` 的 `zh_tokens` 與 `en_tokens` 中：
> 1. **一般純文字**：必須且僅能包含 `{"t": "純文字段落"}`。
> 2. **目標核心單字**：必須為 `{"w": "單字鍵值", "zh": "情境釋義", "display": "英文單字"}`，**嚴禁帶有 `"t"` 屬性**！
> 3. **核心原因**：前端 `renderStory()` 會優先判定 `if (tok.t)`；若目標單字帶有 `"t"`，會被誤判為一般文字直接輸出，導致英文單字、高亮按鈕、發音抽屜與遮罩翻牌效果全數失效！

---

## 🎭 核心原則九：命運分水嶺三結局字數與敘事深度契約 (Branching Endings Contract)

> ⚠️ **最高劇情深度標準：三大結局嚴禁短小乾癟！必須 100% 對齊黃金母板規格！**  
> 1. **中文結局字數深度**：每個分支結局的 `desc_zh` 嚴格要求 **130 ~ 160 字**（嚴禁低於 120 字）。  
> 2. **英文改寫規格**：每個結局的 `desc_en` 嚴格要求 **40 ~ 55 字**，英文金句 (`quote_en`) 與中文對照 (`quote_zh`) 必須精準點睛。  
> 3. **敘事結構契約**：必須包含「**角色高光動作/台詞** ➔ **震撼現場的客觀數據或外界反應（如全場起立、票數暴衝、國際簽約）** ➔ **反派/質疑者的狼狽退場或格局折服** ➔ **主角長遠人生維度的昇華與價值觀錨定**」，帶給學生無可替代的閱讀爽感與靈魂啟發！
