Study Private Pack

Study 私用題庫與容量

本頁為私用題庫容量與發布決策正本。現行分包契約由 #160／#161 交付；下方保留先前單包決策的歷史背景。後續內容批次各自追蹤，不因容量調整而自動發布題目。

2026-10-06：社會原選項與圖片容量（#191）

社會 U1（內部 unit 22）的單選沿用原卷二、三或四個選項，不為遷就介面補造第四個選項；builder 驗證、瀏覽器與 Worker 共用的 validator，以及家長試玩的選項數呈現，都須承載同一規格。其他科目的選項與媒體格式不因這項社會變更一併放寬。

社會 unit 22 的單張 PNG 解碼後上限為 192 KiB；其他已開放 PNG 的科目／單元維持 32 KiB。寬高各 1600、每 shard 256 KiB、manifest 512 KiB、單一單元 4 MiB、單次操作 16 MiB、IndexedDB cache 16 MiB 的護欄保持；社會 table 仍未開放。單圖通過不代表整份 shard 或操作可略過容量檢查，也不改每輪最多 10 個活動的界線。

容量判斷先比較實際原圖、壓縮結果與瀏覽器縮放後的可讀性。縮檔若會抹掉原字、必要標號或圖線，才按必要的科目／單元採最小範圍調整；不能讓其他科目跟著取得較大的圖片額度。圖說沿用下方「社會圖表與題答版本核對」的中立規則。這是格式與容量決策，內容核准及發布仍各自完成；歷史批次的 32 KiB 上限保留為當時事實。

2026-10-04：按單元下載與更新

原上限防止意外大檔、圖片或壞輸入拖慢平板，不應限制三科歷年題庫的總量。現行架構先下載私人目錄，選擇練習範圍後才取得該單元的完整題文與圖片。目錄用發布 revision；內容分包以 SHA-256 定址，未修改的單元跨批次沿用同一 hash。

• 每 shard 仍最多 256 KiB、單張 PNG 32 KiB；一個單元可有多 shard。單一單元合計 4 MiB、單次操作合計 16 MiB，下載前檢查。目錄最多 512 KiB。這些是個別請求／操作的護欄，不是全庫容量。
• IndexedDB 保存已驗證的單元，重讀時驗證原始 bytes 與指紋；快取總額 16 MiB。配額不足可使用當輪記憶體並明示下次需連線，不能為存題庫刪除孩子進度。圖片仍留私人 shard，尚未拆獨立媒體服務。
• 開始練習前取得完整所選單元，作答途中不替換。下載失敗可用完整舊單元完成當輪，下一次仍重試新版；缺件不能當作完整新版。每輪最多 10 題與 stable IDs 保持不變，尚未下載題目的既有成果也保留。
• 舊 API 與 localStorage 單包保持 revision 12，供舊 client 使用；新增內容以 catalog 發布。新舊儲存並存，不搬動或重設孩子進度。家長試玩只保留當次記憶體資料。
• 發布順序：Worker 與 Pages（精確引用 URL 核對）→ 全部 immutable shards → 逐份 immediate／傳播後讀回 → 最後更新 manifest → 再讀回。KV 最終一致性仍可能造成不同 edge 暫時缺件，由 client 保留舊完整單元並重試；不以降版 pointer 或刪舊 shard 回復。
• 冷啟動仍需網站靜態檔可載入，不宣稱整站離線可用。隔離 Chromium 驗證不等於實體 iPad Safari 效能實測。未來是否外置圖片或加入 LRU，依實際負載再決定。

重建與驗證入口見 分包操作契約。每批完整 authoring source 與公開 metadata 是下批基線；不要從凍結的舊單包接續擴題。私人原卷、作者稿、獨立審查與完整分包歸檔不進公開 Git。

多 shard 的 ready 驗證要使用真正含多片的單元：其中一片回應 503 時，不能進入部分新版題池或標成新版 ready；補齊後重試，才可啟用完整單元。reload 須重用同一 manifest revision 下已驗證的完整 cache，不能只看畫面已出題就判定新版載入完成。保存逐片請求／回應、manifest revision 與實際 ready 狀態；fixture 變更與等待時機也須記錄，避免把測試判斷錯誤當成 runtime 缺陷。完整舊單元的 fallback 與完整新版 ready 分開核對。

備份與還原

每批封存保存完整 authoring（curated、explanations、mapping）、已核准前版 baseline、原件與審查證據，以及 production builder 所需程式與相依檔；只有新增題目的 delta 或已發布 shard 不足以接續重建。先凍結檔案清單、相對路徑、bytes 與 SHA-256，再複製到新的明確目標，不覆寫舊歸檔。

每份副本都須逐檔讀回核對，並在獨立暫存目錄只用該副本自身的 authoring、前版 baseline 與 production snapshot 重建。重建 source、manifest、全部 shards 的檔案集合與原始 bytes 均須一致；一份副本成功不能代替另一份。長路徑可使用短路徑別名，但須保留原相對路徑與別名的對照，讓證據仍可定位。

批次 phase helper 可能綁定原 worktree 的目錄層級與核准 gate，不能直接當作可攜的還原入口；接續時先讀該封存的恢復說明與收據。Dropbox 本機副本讀回成功只證明該機副本，另一裝置實際收到並核對後才確認跨裝置同步。最新封存入口、最後文件 merge、plan SHA、各副本收據與 housekeeping 狀態以原 Issue 的最新 checkpoint 為準；備份完成不授權刪除原件或未核對資料。

2026-10-03 決策

家長核准將單一家庭題包上限由 128 KiB 提高到 256 KiB（262144 bytes），同步 production builder、瀏覽器與 Worker 共用 validator、自動下載與手動匯入。計算的是 UTF-8 原始位元組，包含空白與換行；下載不得只相信 Content-Length，還需限制實際串流 bytes。

• 既有 revision 8 為 97 個活動（數學 57、自然 40），130,248 bytes；新上限下尚餘 131,896 bytes（約 128.8 KiB）。這是容量餘額，不能換算成固定可新增題數，因為圖片大小與題文長度不同。
• 保留既有 pack ID、題目 ID、revision、內容、pretty JSON 與孩子進度。僅改容量時不需重建或重新寫入 KV；但 Worker 在打包時會包含共用 validator，必須一起重新部署，否則大包仍被伺服器拒絕。此次先更新 Worker，再發布並核對孩子頁及家長試玩頁載入新版 loader，才具備後續擴題條件。
• 個別 PNG 解碼後仍最多 32 KiB；題型、媒體格式與其他驗證規則保持不變。
• 每批練習仍最多 10 題。題包可容納更多內容不等於一次出更多題。
• 未來擴題仍先逐題核對來源／答案與跨版本概念，保留既有內容並提高 revision。接近新上限時重新評估實際體積，不預先導入拆包或外置圖片。
• Pages 完成前不要先請求新 cache 版本的資產 URL：CDN 可能把舊檔快取到新版本 URL。發布驗證必須等 Pages 成功後，核對 HTML 精確引用 URL 的 bytes，而不只核對另外加 query 的 origin 新檔；本次因此追加 20261003-pack-256k-r2 版本。

操作入口

• 私用題包重建
• JSON 格式與載入契約
• 數學題型覆蓋
• 自然來源與候選

歷史各批次紀錄中的 128 KiB 與 824 bytes 為當時事實，不追改舊產物或歸檔。容量調整本身不新增考題；後續 #148 數學文字題補充 的題數、實際 bytes、正式讀回與封存見批次紀錄。

歷屆題轉入原則

2026-10-05：國小教材判準

家長在 #178 明確修正判準：「國小教材可能會做一定程度簡化，所以先以國小課綱作為判斷標準，不追求100%科學事實」。課綱用來界定年級範圍與學習深度，不是逐題答案清單；答案依目標年級、康軒教材的教學情境與題目條件判讀，接受符合該情境的合理簡化。

• 不以尚未教過的罕見物種、進階術語或間接因果，把教材預期答案判錯、拒收題目或算孩子答錯。只有在該教學情境仍有多解、轉寫有誤、答案明確不符題目條件，或涉及實際不安全的操作時，才針對問題作最小修正。
• 先讀原卷完整條件，包括「通常」「一般」等限定詞，再判斷答案是否唯一。一般教材情境不等於無例外的普遍定律；不能因高階例外逕自改題，或加入原卷沒有的小數門檻。確需修題時保留原稿、依據與核准處置，解說也不把合理簡化擴大成「一律如此」。
• 證據分別標示為本年教材、舊年度同版課程、校方答案或教學推定，不互相冒充。未取得 115 版每頁原文，不代表所有題目一律無法判斷；可依已取得的證據與明確條件逐題決定，保留尚未確認的部分。
• 給孩子的解說簡短、符合年級深度；「教材預期答案」與額外科學補充分開，進階例外留在家長備註。接受教材簡化不等於可以虛構來源，或把已證實錯誤的說法當成普遍真理。

#178 第一輪研究採用的舊判準結果保留為歷史紀錄；現行逐題處置與下一步以原 Issue 的最新交接紀錄為準，本頁不另維護候選題數或重判結果。下方歷屆題轉入規則中的答案可靠性與歧義，均按上述年級與教學情境判斷；其餘分包、來源保存與發布規則維持既有契約。

2026-10-04：累積練習量與題型覆蓋分開追蹤

家長在 #175 確認恢復三下的擴題方向：已有考卷中，範圍相符、答案可核且適合 iPad 操作的題目持續納入。同概念、同方法的不同問法有反覆練習價值，不因題型已出現就延期；只有真正重複的題目才去重。不能把「各題型至少有一題」當作歷屆題庫已整理完成。

先消化現有原卷的可用題，再針對缺少題型尋找新來源。文字是非、選擇題可批量轉寫與逐題覆核；需要圖表、共同材料或其他操作的題目保留具體待做原因，不裁掉判讀條件。官方答案仍須驗算；沒有官方答案者由作者與獨立 reviewer 各自解題。歧義、殘缺與範圍未確認者分開記錄，不為增加題數降低標準。

獨立 reviewer 先從原卷解題、凍結 oracle 與來源定位／指紋，再讀作者的 key、解說與轉寫稿逐項比對，避免答案先入為主。核准須綁定實際受審稿與最新處置；沒有官方答案時如實標示兩次獨立解答，不冒充校方標答。renderer 與 key 判分一致只能證明介面行為，不能代替內容正確性的獨立依據。

每批同時回報已收考卷數、已上線活動數／原卷作答位置、已盤點來源的剩餘狀態，以及各概念的練習量。共用選項或材料的多小題按實際活動計數，不拆成更多活動以膨脹數字。題庫可持續增加，每輪仍最多 10 個活動；題庫總量與單次練習份量是不同決策。

選擇既有介面可承載的題目時，核對完整大題指示與作答要求。能輸入最終數字不代表已保留列式、列出全部可能值、畫圖或測量能力；題文沒有明訂過程要求時，也不因參考答案示範列式就擅自排除。只有章節順序調整而概念相同的來源仍可依概念對齊；不同原卷作答單位與數位 activity 的數量分開統計。

自然跨年級原卷也按實際概念與推理深度判讀，保留原年級、評量及出版社身分。定性情境比較不等於完整控制變因實驗，更不能計入實測數據表判讀的缺口。沒有校方答案時，可以在題目條件完整且作者與 reviewer 能獨立可靠解題後收錄；印刷選項殘缺不能用合理猜測補字，再宣稱保留原題。審查只核准部分候選時，保留凍結前稿、原審查、排除原因與唯一核准 ID，重建流程只帶入這個已核准集合。

角度原圖的轉入界線（#151）

數學 U3（內部 unit 17）沿用自然既有 PNG 與放大介面；只開放此單元 PNG，其他數學單元媒體與 table 仍未開放。每圖 32 KiB、寬高各 1600、題包 256 KiB 上限不變。圖由原卷題目頁擷取，保留幾何比例、文字、標號、量角器中心與零線；若重排選項，完整保留各圖比例與辨識細節。

來源無官方答案並不一律排除，但作者與獨立 reviewer 必須能可靠重算。近似圖形的小差異可能讓初看判斷出錯；高倍率核對仍無法可靠確定答案時，保留候選及勘誤、排除該題，不為湊題數猜答案。量角器對準／讀值、畫角、實際量測是不同能力，本批看圖題不代表作圖能力已支援。

此次 runtime gate 同時由 builder、瀏覽器與 Worker bundle 使用，發布依新版 Worker → Pages 與精確 loader URL 讀回 → 核准題包前向寫入的順序；即使 Worker source 沒有直接修改，也要重新部署引入新版 parser 的 bundle。內容指紋、獨立覆核、兩階段管理端讀回與恢復路徑見 #151 批次紀錄。本頁記可沿用的決策，不另維護題數或即時服務狀態。

社會題庫與跨年度課程（#154）

四上社會沿用同一家庭題包與家長試玩，歷史 packId 不作為科目判斷。首批開放社會 U1（內部 unit 22）「家鄉的自然環境」，只用純文字四選一／是非，選單保留「地圖與位置」「地形與生活」「氣候與水資源」三個大主題。加入科目時，同時核對家庭學期選擇、首頁入口、家長安排、試玩、validator 及分類報表，不能把「不是自然」都算成數學，也不能把所有大於等於 20 的單元都歸自然。

今年校方出版社表、今年同版教材內容、當校正式考試範圍是三份不同證據。其他學校的同版教學計畫可核教材概念與頁碼，不能代替桃子腳實際進度。舊卷未註明出版社時保留 unknown；同校今年採康軒，不代表過去每年也能直接標康軒。

115 版 U1「家鄉的自然環境」與較早「家鄉的環境」有可重用概念；舊版「家鄉的生活」則可能包含新版拆至住屋、器物、信仰等不同單元的內容。依題目實際條件與深度對齊，不能用舊章號整卷放行。學校尚未公告範圍時明記暫定，先收錄有充分課程與答案證據的部分。原題要求「正確打勾、錯誤留白」時，核對官方答案的留白規則後才轉為是非按鈕；需共享背景的敘述保留，不能把未勾一概當成缺答案。

收卷與正式題庫分開計數，原 PDF、作者稿、獨立解題及來源指紋保留在私人歸檔；公開只保存來源與概念。詳細來源、候選排除、驗證及正式狀態見 #154 批次紀錄與社會課程對照。

自然原題選項與比較能力（#169）

自然單選支援原卷的三選一與四選一，不為遷就介面虛構第四個選項；數學與社會各自維持原有選項數限制。配合題若各小題的選項池不同，可以拆成各自保留完整表格及前置指示的單選活動，不硬湊成共用選項池。builder、瀏覽器與 Worker 的共用 validator 必須一起更新，家長試玩也須正確顯示實際選項數。

題目身分須包含學年度、年級、學期、考次和原題定位，不能只憑同校同年就沿用另一題的採用或排除結論。同款測風計的圖可以練風力強弱判讀，但不等於驗證風蝕實驗的控制條件。地表、坡度、降雨的條件表可以練推論，但若沒有量測結果，就不能計作實測數據表；校方標為送分的題目先排除，不拿推測答案補缺口。本批來源、審查和交付狀態見 #169。

社會圖表與題答版本核對（#157）

社會 unit 22 可沿用私人 PNG 與圖片放大，MC 保留原卷的二選一或四選一，不為了遷就介面添加假選項。配對題可用 2～5 個共享選項、2～8 個小題的 grouped_choice；一次只呈現一小題，整組完成才計一個活動。不同指示與不同選項池不硬合為同一組，也不把每個作答格膨脹成活動數。自然原有選項上限和其他科目格式不隨社會擴充一起放寬；社會 table 仍未開放。

官方答案需與原題的實際條件逐項對照。題卷、答案卷即使同校同年，也可能印著不同月份或數據；遇到這種版本差異，先保留整組並記錄兩份原件指紋，不能直接套官方標答，更不能將不一致算成孩子答錯。作者與獨立 reviewer 先自行解題，再核官方答案，可發現只讀答案看不到的來源問題。

同題號或最後答案相同，不足以證明官方答案與採用的題卷對版；要核對題意、限定條件、完整選項與共同材料的實際版本。沒有取得與採用題卷對版的官方答案時，可以依前述國小年級與教材情境，由作者與獨立 reviewer 各自可靠解題，再如實標示 independently_solved_twice_no_official_answer；保留未對版原件與核對理由，不冒充官方核答，也不因答案碰巧相同而沿用官方來源聲明。

原圖由題卷裁切，保留判讀所需的軸、單位、標號與比例，不能截到答案卷的標記。Study 的 PNG alt 同時顯示為可見圖說，因此只描述圖號、軸與單位等中性資訊；不得先說哪張雨量圖符合季節，替孩子完成原題要考的判讀。原件等價性、解碼後大小與實際平板縮放可讀性分別驗證；圖表能通過格式檢查，不代表孩子看得清楚。來源與交付證據見 #157 批次紀錄。

自然共同材料與合併後補證（#178）

圖文題轉入時，保留原圖、完整閱讀材料與觀察表，以及共同指示和資料來源；題組一次只呈現一小題，仍讓孩子能查看完整共同材料。數位活動數與原卷作答位置數分開記錄，共用材料的多個作答格不拆成多個活動來計數。

若合併時併入其他功能，保留他人成果並比對原 PR head 與實際 merge 的差異；原 PR head 的 CI 不可當作 merge runtime 已受測的證據。只對受影響流程補驗，再以真正測過的 merge CI、Pages 與頁面精確引用 URL 的原始 bytes 綁定發布。原 draft QA 與 merge 補驗各保留身分和相互引用，備份須包含被引用的來源與證據，才能重建查核。實作與證據見 #178 批次紀錄。