公開範圍
本倉庫維護 Astro 前台、百科 Markdown、分類數據、共享組件和站內説明書。服務端是閉源項目；其源代碼、目錄結構、數據模型、權限實現和部署資料不屬於本説明書，也不向外部開發者提供。開發者只需使用前台倉庫中的公開類型、配置和用户可見的行為，不應從前台界面推斷服務端內部實現。
前台內容來源
百科詞條由 src/content/ 中的 Markdown 與元數據構建為靜態頁面。src/data/ 保存分類與時間軸等公開結構化資料。docs/manuals/ 是站內説明書的唯一正文來源；工作區上層的 docs/ 由腳本鏡像，不能在鏡像裏編輯。文章和圖庫由站點服務提供已公開內容，不在前台倉庫內建立同名 Markdown 來假裝其公開狀態。
投稿界面應表達的狀態
| 內容 | 前台入口 | 投稿後的讀者可見條件 |
|---|---|---|
| 百科詞條 | 閲讀器編輯入口、貢獻中心 | GitHub 變更提案審核、合併並更新靜態站後。 |
| 文章 | 文章專欄與共享編輯器 | 投稿審核完成且公開閲讀頁可用後。 |
| 設定圖庫 | 按設定分組的上傳工作台 | 設定資料和至少一張圖片獲批並出現在公開圖庫後。 |
創作者中心將三類記錄並列展示，但保持各自真實狀態。“本機保存”“雲端草稿”“圖片暫存”“提交審核”“已通過”“已公開”不能混寫。前台應以服務返回的結果為準，不能把文件傳輸到 100% 或按鈕點擊當成審核成功。
集成原則
前台只消費為該界面提供的服務結果。登錄失效、加載失敗、版本衝突或權限不足時，保留未提交的正文與資料，給出準確錯誤和恢復入口。公開頁面只呈現公開版本；編輯中的內容僅在投稿人有權訪問的界面展示。涉及服務行為調整時，由維護者通過私有流程確認公開契約，前台文檔只記錄用户能觀察並需要理解的結果。