腾讯视觉大模型 WeVisOne-VL 的免安装整合包来了Python 环境、CUDA 版 PyTorch、模型权重全部内置解压后双击一个 bat 就能跑全程离线、不用装任何东西。之前参考超哥的本地部署教程在几台电脑上装过一遍每台都要重下模型、重建环境、踩一遍坑索性把整个环境打包成了整合包。本文分享整合包下载地址、使用方法以及打包过程中最关键的几个坑希望对你有参考价值。整合包下载地址夸克网盘压缩包约 7.2GBhttps://pan.quark.cn/s/b187c7a9540e链接失效可以在评论区吱一声我会补新链接一、WeVisOne-VL 是什么WeVisOne-VL 是腾讯微信视觉团队WeChat Vision开源的视觉-语言基础模型一个 2B 参数的小模型同时搞定目标级感知和像素级感知两大类任务任务类型任务输出目标级目标定位 / 密集检测检测框目标级指代定位框或 None目标不存在时拒识目标级目标计数框/点 数量目标级点位定位点目标级文字识别 OCR文本 框像素级图像分割框 二值掩码像素级智能抠图框 Alpha Matte透明通道几个 benchmark 数字感受一下LVIS 检测 F1 Mean 55.3超过 9B 的 Qwen3-VL-8B 的 42.9、密集检测 Dense200 71.3、指代分割 ReasonSeg gIoU 71.2、框提示抠图 P3M-500-NP MAD 7.3——很多指标是同级别最强而且它自带可靠拒识图里没有你要找的东西它会老实回答 None而不是硬编一个框出来。模型权重只有 4.88GB2B 参数 9.6M 的轻量像素解码器不需要外挂 SAM一张 8GB 显存的消费级显卡就能跑。二、整合包里有什么解压后约 11GB目录结构如下WeVisOne-VL-Portable/ ├── 启动Demo.bat ← 双击这个 ├── 使用说明.txt ← 常见问题都在这里 ├── app.py ← Demo 程序入口汉化版界面 ├── demo/ ← 界面与 8 张示例图片 ├── WeVisOne-VL-2B/ ← 模型权重4.6GB └── runtime/ ← 内置 Python 3.12 运行环境含全部依赖约 5GB电脑要求Windows 10 / 11 64 位NVIDIA 显卡建议 8GB 显存实测 8GB 卡加载后占用约 7GB6GB 卡可能爆显存硬盘剩余空间约 12GB建议放 SSD不需要联网、不需要登录任何账号全程离线运行三、使用方法四步解压到任意位置路径里别带太深的层级也别放需要管理员权限的目录双击启动Demo.bat脚本会自动检测显卡并启动服务等待 20~40 秒加载模型浏览器会自动打开http://127.0.0.1:8080/在网页里选任务 → 上传图片或直接点示例图片→ 点开始识别界面长这样顶部一排 8 个任务按钮物体级 6 个 像素级 2 个示例图片自带任务和提示词点一下就能加载底部的示例画廊8 张图分别对应目标定位、密集检测、目标计数、点位定位、文字识别、图片描述、图像分割、智能抠图识别框、标签、遮罩透明度都可以在「可视化设置」里调「生成参数」面板里temperature保持 0 结果最稳定。用完退出关掉任务栏最小化的WeVisOne-VL-Server窗口即可。四、整合包是怎么做出来的避坑干货如果你只是想用看上面就够了。这部分写给想自己做整合包的朋友。1. 内置 Python 运行时直接把 Python 3.12 的完整安装目录复制成runtime/。python.exe是按自身所在目录定位标准库的整个目录拷走就能用。但注意必须排除安装目录里的Lib\site-packages和Scripts——全局环境里往往混着别的包带过去又乱又大robocopy C:\Python312.\runtime/E/XD site-packages Scripts __pycache__2. 搬运虚拟环境的全部依赖把 venv 里的Lib\site-packages整个搬进runtime\Lib\site-packages5GB光 CUDA 版 torch 就占一大半。这里有个必炸的坑项目用pip install -e .安装时site-packages 里会生成__editable__*.pth和__editable___*_finder.py两个文件里面写死了开发机的绝对路径比如F:\WeVisOne-VL-main拷到别的电脑一 import 就报错。解法复制时排除这两个文件然后把包本体直接复制进 site-packages替代 editable 安装robocopy.\.venv\Lib\site-packages.\runtime\Lib\site-packages/E/XF __editable__.wevisone_vl-1.0.0.pth __editable___wevisone_vl_1_0_0_finder.py robocopy.\wevisone_vl.\runtime\Lib\site-packages\wevisone_vl/E3. CUDA 版 PyTorch 与 VC 运行库requirements.txt里的torch2.11.0在 Windows 上默认装成 CPU 版必须从 PyTorch 官方源装 CUDA 构建约 2.7GBpipinstalltorch2.11.0torchvision0.26.0 --index-url https://download.pytorch.org/whl/cu128另外从C:\Windows\System32拷msvcp140.dll、vcruntime140.dll、vcruntime140_1.dll三个 VC 运行库放进runtime/——没装 VC Redist 的电脑也能直接跑。4. 启动 bat 的中文乱码坑这是最隐蔽的一个cmd 是按系统当前代码页中文系统默认 GBK解析 bat 文件的bat 里写 UTF-8 中文字节会被错误解码把整个脚本的结构打乱——exit不生效、后面的行被当成命令一条条执行、满屏xxx is not recognized。解法很简单bat 全部用 ASCII 英文中文说明放到 txt 里echo off title WeVisOne-VL Demo cd /d %~dp0 set PYTHONUTF81 set HF_HUB_OFFLINE1 set TRANSFORMERS_OFFLINE1 start WeVisOne-VL-Server /min runtime\python.exe app.py --model WeVisOne-VL-2B --server-name 127.0.0.1 --server-port 8080 :waitloop ping -n 3 127.0.0.1 nul curl -s -o nul --max-time 2 http://127.0.0.1:8080/ nul 21 if not errorlevel 1 goto ready goto waitloop :ready start http://127.0.0.1:8080/start /min让服务跑在最小化窗口里关掉那个窗口就是退出轮询到 HTTP 200 才弹浏览器避免打开一个加载失败的页面。延时用ping -n而不是timeout是为了避免 PATH 里同名工具的干扰。GPU 检测同理多做几路兜底System32、NVIDIA 安装目录、PATH检测不到也只警告不拦人。5. 免防火墙弹窗--server-name 127.0.0.1只监听本机回环Windows 防火墙不会弹授权窗想给局域网其他电脑用再改成0.0.0.0首次会弹防火墙提示选允许。五、常见问题FAQQ1报 OutOfMemoryError 显存不足关掉占显存的程序游戏、开硬件加速的浏览器再试。6GB 显存的卡比较勉强建议 8GB 起步。Q2bat 提示 NVIDIA driver not detected电脑有 N 卡的话先安装/更新 NVIDIA 驱动没有 N 卡则无法使用整合包内置的是 CUDA 版运行环境纯 CPU 跑 2B 模型没有实用价值。Q3杀毒软件报毒或把 runtime 目录删了内置 Python 运行时属于常见误报把整合包文件夹加入白名单后重新解压即可。Q48080 端口被占用编辑启动Demo.bat把--server-port 8080改成别的端口如 9090。Q5想让局域网其他设备访问把 bat 里的--server-name 127.0.0.1改成--server-name 0.0.0.0防火墙弹窗选允许。Q6双击后提示启动超时看任务栏最小化的WeVisOne-VL-Server窗口里面的报错信息就是真实原因多数是显存不足或驱动太旧。总结WeVisOne-VL 是腾讯开源的 2B 视觉大模型一个模型同时搞定检测、指代、计数、指点、OCR、分割、抠图且支持拒识本文整合包把 Python 环境、CUDA 版 PyTorch、VC 运行库、模型权重全部内置解压双击启动Demo.bat即用全程离线电脑要求Windows 10/11 64 位 NVIDIA 显卡建议 8GB 显存硬盘留 12GB自制整合包的三个关键坑editable 安装的绝对路径文件必须剔除、PyTorch 要从官方源装 CUDA 构建、bat 里不能写中文下载地址夸克网盘https://pan.quark.cn/s/b187c7a9540e参考资料WeVisOne-VL 官方仓库https://github.com/Tencent/WeVisOne-VL模型权重Hugging Facehttps://huggingface.co/tencent/WeVisOne-VL-2B写在最后整合包体积不小7.2GB解压需要一点耐心如果运行中遇到别的报错欢迎评论区贴出来一起排查觉得有用的话点个赞收藏再走~
