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