ROEGUIDE / 001
← 全部指南

會員開發

從本機開發到提出 PR

指南免登入閱讀 · 網站操作需要會員資格 · 核對 2026-10-02

BatteryHub 的功能修改先在獨立 Forgejo 專案提出 PR，再由管理者審查合併與部署。main 受保護；提交程式不表示正式網站已更新。

操作步驟

  1. Clone 後依 README 安裝 Python 3.11、uv 與符合要求的 Node.js。
  2. 執行 uv sync --frozen、npm ci --prefix frontend 與 npm run build --prefix frontend。
  3. 使用 uv run --frozen python scripts/develop.py --serve 啟動本機開發環境。
  4. 從 main 建立自己的功能分支，閱讀修改範圍的 README／AGENTS，保持 canonical 實作。
  5. 執行完整 unittest、前端 build 與 format:check，更新相關文件。
  6. 推送分支並在 Forgejo 提 PR，說明問題、變更、驗證與限制。

預期結果

PR 等待審查。正式 main 仍人工合併；Nightly 自動預覽與正式部署不同。

限制

本機開發包使用公開樣本，不包含正式會員資料或完整實驗資料庫。