5d2f1b2d9a
- Add envs/README.md explaining the directory purpose and usage rules. - Update .gitignore to exclude only virtual env subdirectories under envs/, allowing deployment guide documents to be tracked. - Track existing deployment docs: - SM120_DSV4_DEPLOYMENT_GUIDE.md - SM120_DSV4_DEPLOYMENT_ISSUES.md - VLLM_DSV4_SM120_FIX.md
45 lines
1.8 KiB
Markdown
45 lines
1.8 KiB
Markdown
# envs 目录说明
|
||
|
||
本目录用于存放**环境搭建相关的文档和指南**，不包括具体的虚拟环境或容器镜像文件。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
envs/
|
||
├── README.md # 本说明文件
|
||
├── SM120_DSV4_DEPLOYMENT_GUIDE.md # SM120 (RTX 6000D) 部署 DSV4 指南
|
||
├── SM120_DSV4_DEPLOYMENT_ISSUES.md # SM120 部署问题汇总与解决方案
|
||
├── VLLM_DSV4_SM120_FIX.md # vLLM 在 SM120 上的代码修复记录
|
||
└── <future guides> # 其他平台/环境的部署文档
|
||
```
|
||
|
||
## 使用规范
|
||
|
||
1. **文档放这里**：与建立环境、部署模型、修复平台兼容性相关的文档，应放到 `envs/` 目录下。
|
||
2. **环境不放这里**：具体的 uv venv、conda env、Docker 镜像构建产物等，**不应**提交到 git。请在对应环境的 `.gitignore` 中排除。
|
||
3. **命名规范**：`{平台}_{模型或框架}_DEPLOYMENT_GUIDE.md` 或 `{框架}_{平台}_FIX.md`。
|
||
4. **内容要求**：
|
||
- 环境信息（GPU、CUDA、驱动版本）
|
||
- 问题现象与错误日志
|
||
- 根因分析
|
||
- 解决步骤（含具体命令或代码修改）
|
||
- 验证结果
|
||
|
||
## 现有文档
|
||
|
||
| 文档 | 说明 |
|
||
|---|---|
|
||
| `SM120_DSV4_DEPLOYMENT_GUIDE.md` | RTX 6000D (SM120) 上部署 DeepSeek-V4-Flash 的完整指南，含 vLLM 和 SGLang 的适配步骤 |
|
||
| `SM120_DSV4_DEPLOYMENT_ISSUES.md` | SM120 部署过程中遇到的具体问题汇总，包括 flashinfer、sgl_kernel 等兼容性问题的解决方案 |
|
||
| `VLLM_DSV4_SM120_FIX.md` | vLLM 在 SM120 上的代码级修复记录，含参数名不匹配等具体修改 |
|
||
|
||
## 排除的环境目录（已加入 .gitignore）
|
||
|
||
以下子目录包含具体的虚拟环境文件，不应提交：
|
||
|
||
- `modelscope-hub/`
|
||
- `modelscope-upload/`
|
||
- `sglang/`
|
||
- `sglang-src/`
|
||
- `vllm/`
|