diff --git a/run.sh b/run.sh
index 8c89c16..6aee82b 100644
--- a/run.sh
+++ b/run.sh
@@ -6,9 +6,14 @@
 cd "$(dirname "$0")" || exit 1
 
 if [ ! -d ".venv" ]; then
-  echo "[init] 创建虚拟环境并安装依赖..."
+  echo "[init] 创建虚拟环境并安装依赖（含测试依赖）..."
   python3 -m venv .venv
   .venv/bin/pip install -r requirements.txt
+  # 测试依赖（pytest）随本地 venv 一并装好，保证 .qoder/rules 里的
+  # `.venv/bin/python -m pytest` 开箱即用、测试环境可复现。
+  # 生产不走本脚本（systemd 直接拉起 uvicorn），setup.sh/update.sh 也只装
+  # requirements.txt，故 dev 依赖不会带上线。
+  .venv/bin/pip install -r requirements-dev.txt
 fi
 
 # 监听地址/端口可用环境变量覆盖（HOST=127.0.0.1 ./run.sh）。