從原始碼執行

環境準備

• Python 3.12 或更高版本。
• 推薦安裝 uv。
• Windows 開發環境。

git clone https://github.com/BnanZ0/ok-nte.git
cd ok-nte
uv sync

啟動

# 正式入口
python main.py

# 调试入口，输出更详细的日志
python main_debug.py

測試與靜態檢查

倉庫使用 unittest。有本地虛擬環境時，優先使用它的直譯器：

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

如已安裝 Ruff，可執行：

ruff check .

構建文件站點

文件依賴與應用依賴分離。安裝後可生成可由任意靜態網站伺服器託管的 HTML：

.\.venv\Scripts\python.exe -m pip install -r requirements-docs.txt
.\.venv\Scripts\python.exe -m mkdocs build --strict

預設輸出目錄為 site/。本地預覽可執行：

.\.venv\Scripts\python.exe -m mkdocs serve