站點工具

DOCUMENTS / DEVELOP

前台開發與驗收

按修改範圍檢查前台,並區分本地效果與真實投稿流程。

本地準備

在前台倉庫確認當前分支與未提交修改,安裝 Node.js 和 pnpm,運行 pnpm install --frozen-lockfile、pnpm dev。説明書只在本倉庫 docs/manuals/ 編輯,再運行 node scripts/sync-docs.mjs 更新工作區鏡像。環境密鑰不得寫進倉庫、截圖或瀏覽器日誌。服務端的運行、發佈和故障處理屬於維護者的私有流程,不在此提供。

按改動檢查

前台變更建議檢查
文檔正文與鏈接node scripts/check-docs.mjs、node scripts/sync-docs.mjs --check。
分類與詞條元數據pnpm validate:content,檢查受影響的語言和目錄。
頁面、控件與閲讀器pnpm check、pnpm build,在桌面和窄屏實際操作。
投稿界面本機草稿、登錄狀態、錯誤提示、提交回執與創作者中心跳轉。

前台構建通過只證明靜態產物可生成。模擬響應、瀏覽器預覽和真實賬號提交應在驗收記錄中分別標註,不能相互代替。測試前保留原有詞條正文和審核記錄,避免用測試內容覆蓋真實資料。

前台發佈邊界

前台候選需記錄提交號、構建結果、受影響頁面、可見迴歸項和恢復版本。上線前由維護者確認依賴服務已可用,再檢查詞條提案、文章公開和圖庫上傳各自的真實流程。若頁面與服務狀態不一致,暫停前台發佈並保留可復現的頁面地址及回執編號;服務端排查和恢復由私有運維流程處理。本公開説明書不包含服務端倉庫、配置、數據遷移或部署命令。

KAMITSUBAKI WIKI

登入觀測站

沿用 AI 助手帳戶。登入後可在不同設備同步收藏,閲讀百科無需登入。

我的空間 →