WSL2安装Ubuntu 26.04后运行jev_local，无需Windows Python或虚拟机；先执行wsl --install -d Ubuntu-26.04或离线安装镜像，再克隆仓库并运行./run-web.sh启动Web服务，默认监听localhost:8000。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WSL 子系统安装并运行 Jev 模型，核心是“先搭好 Linux 环境，再装 Jev 本地版 jev_local”。整个过程不依赖 Windows 原生 Python 或复杂虚拟机，重点在 WSL2 的轻量性和 jev_local 对 Python 3.12+ 的封装支持。
安装 WSL2 并配置 Ubuntu 26.04
jev_local 官方明确支持 Ubuntu 26.04（非 LTS 版本），需手动指定安装。Windows 10/11 用户可直接启用 WSL2：
- 以管理员身份打开 PowerShell，执行：wsl --install -d Ubuntu-26.04
- 若提示未找到该发行版，说明 WSL 商店缓存未更新，改用离线方式：下载 ubuntu-26.04-wsl-amd64.wsl 镜像（约 400MB），再运行：wsl --install --from-file "完整路径\ubuntu-26.04-wsl-amd64.wsl"
- 首次启动会引导设置 Linux 用户名和密码；建议后续执行 sudo passwd root 设置 root 密码，便于后续权限操作
在 WSL 中安装 jev_local
jev_local 是 Jev 的本地部署替代方案，专为离线/可控环境设计，无需 API 密钥，也不调用云端模型：
- 确保 WSL 内已安装 Python 3.12 或更高版本（Ubuntu 26.04 默认满足）；可通过 python3 --version 验证
- 克隆仓库：git clone https://github.com/typesafe-ai/jev_local.git
- 进入目录后直接运行启动脚本：./run.sh（文本模式）或 ./run-web.sh（带简易 Web UI）
- 脚本会自动创建 venv、安装依赖、加载模型权重（首次运行需下载约 2–3GB 模型文件，建议保持网络畅通）
验证 Jev 本地服务是否就绪
jev_local 启动后默认监听 http://localhost:8000（WSL 内部）；从 Windows 访问需注意端口映射：
- 在 WSL 终端中执行 curl http://localhost:8000/health，返回 {"status":"ok"} 表示服务正常
- 从 Windows 浏览器访问 http://localhost:8000 即可打开 Web UI（WSL2 默认支持 localhost 端口互通）
- 如需调用 API，可用 Python 示例发送结构化请求：{"state":"客户最近7天未登录","questions":{"is_at_risk_of_churn":{"type":"boolean"}}}，响应将严格返回类型安全的 JSON，如 {"is_at_risk_of_churn":{"answer":true,"confidence":0.89}}
注意事项与常见问题
实际部署中容易卡在几个关键点，提前规避可省去大量调试时间：
- CUDA 支持非必需但推荐：jev_local 默认使用 CPU 推理，如需 GPU 加速（尤其处理长上下文），需在 WSL2 中安装 CUDA Toolkit 12.4 + cuDNN 8.9.7，并确认 nvidia-smi 在 WSL 内可见
- 磁盘空间要留足：模型权重 + 缓存 + Python 环境合计需至少 8GB 可用空间；可用 df -h 检查
- 别混淆 jev 和 jev_local：Jev 是 TypeSafe 提供的云端 System One 模型（需 API 调用）；jev_local 是其开源本地实现，功能对齐但无联网能力，也不支持 RLHF 微调等高级特性
- Windows 防火墙一般不影响：WSL2 与宿主机共享 localhost，只要没手动禁用 WSL 的网络代理，无需额外放行端口
