1

2026-08-17 10:33:40 +08:00
parent eaabd6056e
commit ef3f69fabd
3 changed files with 151 additions and 1 deletions
@@ -173,6 +173,16 @@ npm run dev         # Vite 开发服务器（5173），API 代理见 vite.config

 ## 模型配置

+### 首次部署 / 迁移到新电脑
+
+Python 虚拟环境（`.venv/`）**不可跨机器复制**：其中 `pyvenv.cfg`、`bin/` 下脚本的 shebang 及 `bin/python` 符号链接都写死了本机绝对路径，复制后无法运行，这是 Python 的设计，不能靠改文件修复。复制/迁移项目目录时排除 `.venv/`（`.gitignore` 已排除；整体拷贝时连同复制则先删除），到新机器上重建：
+
+```bash
+./scripts/start_models.sh  # 自动检测 .venv：未就绪（缺失/损坏/依赖未装全）时依 scripts/requirements.txt 重建，就绪则直接启动
+```
+
+> `.venv` 重建需按 `scripts/requirements.txt` 安装 115 个依赖（含 omlx，需可访问 GitHub），仅首次或 venv 失效时执行一次。
+
 任意 OpenAI 兼容接口均可使用：

 - **对话模型**（`/v1/chat/completions`，支持 SSE 流式）：用于问答与知识图谱实体抽取