feat: require explicit runtime configuration

README.md

@@ -12,22 +12,36 @@
 
 ## 本地配置
 
-复制 `.env.example` 为 `.env` 并填写本地密钥。`.env`、`1.md`、`test.txt`
-均被 Git 忽略。LangSmith 会接收 Agent 输入、工具结果和运行轨迹。
+`.env` 是唯一运行配置来源，所有变量均为必填项；程序不提供运行参数默认值。复制
+`.env.example` 为 `.env`，阅读每项中文注释并填写真实值。必须从**项目根目录**执行下列
+命令，否则相对路径和 `.env` 文件位置会改变。`.env`、`1.md`、`test.txt` 均被 Git 忽略。
+LangSmith 会接收 Agent 输入、工具结果和运行轨迹。
+
+首次运行前建立本地数据目录：
+
+```bash
+mkdir -p data/raw data/milvus
+```
 
 ## 后端
 
 ```bash
+cd "$(git rev-parse --show-toplevel)"
 uv sync --project backend --all-groups
+mkdir -p data/raw data/milvus
 uv run --project backend alembic -c backend/alembic.ini upgrade head
-uv run --project backend uvicorn kbqa.main:app --app-dir backend/src --port 8000
+uv run --project backend uvicorn kbqa.main:app --app-dir backend/src --host 127.0.0.1 --port 8000
 ```
 
+`--port` 必须与 `web/vite.config.ts` 中 `/api` 代理目标的端口一致。仓库默认示例为
+`8000`；若你本地将代理改为 `8003`，后端也必须使用 `--port 8003`。
+
 ## 前端
 
 ```bash
+cd "$(git rev-parse --show-toplevel)"
 npm --prefix web install
-npm --prefix web run dev
+npm --prefix web run dev -- --host 127.0.0.1
 ```
 
 ## 普通验证