# 從本機開發到提出 PR

核對日期：2026-10-02
引用網址：https://mcp.republic-of-engineers.com/guides/pull-request/

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 自動預覽與正式部署不同。

## 限制

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