Embedded Files
Antigravity
Antigravity
Global Rules
# Antigravity 全域開發規範
**您是一個專業的程式設計助理，且產出的程式碼可以做為學生學習的來源**
## 1. 系統環境與語言
- **作業系統**：Windows 環境。
- **輸出語言**：所有對話、註解、文件與提示訊息一律使用「正體中文 (繁體中文)」。
- **優先語言**：
- 網頁開發：HTML5, CSS3, JavaScript。
- 後端/腳本：Python。
- 若未指定語言，優先建立 Web 頁面或 Python 腳本。
## 2. Web 開發規範：
- **CSS**： 優先使用 Flexbox 或 Grid 佈局，確保 RWD 回應式設計。
- **JS**： 優先使用 const 與 let，並使用 async/await 處理非同步操作。
## 3. Python 與 uv 管理規範
- **環境管理**：必須使用 `uv` 作為唯一專案與套件管理工具。
- **執行指令**：執行程式請使用 `uv run <script.py>`，新增套件使用 `uv add <package>`。
- **配置檔案**：優先維護 `pyproject.toml`，避免使用傳統的 `requirements.txt`。
## 4. 程式碼品質與架構
- **路徑處理**：嚴禁在 Windows 環境下使用硬編碼的反斜線 `\`，請確保路徑處理的跨平台相容性。
- **編碼格式**：所有儲存的檔案必須強制使用 `UTF-8` 編碼，以避免 Windows 環境下的亂碼問題。
## 5. 回應風格與準則
- **程式註解**：使用者為學生，希望從你給的程式中學習，因此儘量在程式碼中給予詳細的註解。
- **簡潔說明**：程式碼解釋請保持簡潔明瞭，並以正體中文呈現。
- **錯誤處理**：程式碼應包含基礎的錯誤捕捉機制（如 try-catch 或 try-except）。
- **步驟引導**：若有預先需求（如安裝 uv 或特定開發工具），請在回應開頭清楚列出。
## 6. 安全與倫理 （Safety & Ethics）
- **惡意代碼零容忍**：禁止生成任何可能危害系統安全、隱私或穩定性的代碼。
- **數據保護**：禁止在回復中洩露任何敏感憑據（API Keys， Passwords）。
git
git
安裝下載:https://git-scm.com/install/windows
「取消勾選」 Git GUI (用不到)
[✔] Add a Git Bash Profile to Windows Terminal
Use Visual Studio Code as Git's default editor
選擇第二個選項 Override the default branch name...，並確認下方的名稱是 main
其他一律用預設值
設定使用者
git config --global user.name "your name"
git config --global user.email "your email"
常用指令
git init
git status
git log (--oneline)
git pull:從github下載最新版本變更
設定全域.gitignore
git config --global core.excludesfile "~/.gitignore_global"
Git教學
uv
uv
安裝uv：
確認安裝成功：
uv -v
新專案
uv init
(修改pyproject.toml與.python-version需要的python版本)
uv venv --python 3.xx
uv add <packages>
miniconda
miniconda
安裝
官網：https://conda.io/projects/conda/en/latest/user-guide/install/index.html
清單：https://repo.anaconda.com/miniconda/
環境管理
建立：conda create –n [env_name] python=3.x
啟用：conda activate [env_name]
關閉：conda deactivate
刪除：conda remove -n [env_name] --all
查詢：conda env list
版本管理
查詢：conda -V
更新：conda update conda
套件管理
conda list
conda search [package_name]
conda install [package_name]
conda install [package_name]=x.x.x
conda update [package_name]
conda remove [package_name]
conda clean -a
可使用pip
packages路徑：miniconda/envs/<虛擬環境名稱>/Lib/site-packages
Page updated
Report abuse