Quantong Qiu 5d2f1b2d9a docs(envs): add envs README and track deployment guides
- 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
2026-07-14 10:54:46 +00:00
..

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/