貢獻與驗證

變更原則

• 保持改動小且可審查；不要順手重構無關檔案。
• 自動化仍應只通過 UI、OCR、系統音訊和常規輸入與遊戲互動。
• 不要提交使用者日誌、截圖、配置、賬號資訊、金鑰或個人路徑。
• 涉及戰鬥 planner、戰鬥狀態、聲音捕獲或使用者資料相容性時，補充相應測試並說明風險。

文件貢獻

• 將面向使用者的說明放在“開始使用”“功能”或“指南”。
• 將 API、架構和實現說明放在“開發”。
• 新頁面必須新增到根目錄 mkdocs.yml 的 nav，否則不會出現在網站導航中。
• 使用相對 Markdown 連結；提交前執行嚴格構建檢查斷鏈和配置錯誤。

.\.venv\Scripts\python.exe -m mkdocs build --strict

程式碼驗證

.\.venv\Scripts\python.exe -m unittest discover -s tests -p "*.py"

請在提交說明中寫明已執行的驗證，以及因環境限制未執行的驗證。