# win-base-env

**Repository Path**: sz-ai/win-base-env

## Basic Information

- **Project Name**: win-base-env
- **Description**: 支叶运行windows系统环境补充库，对于未安装VS的电脑可能缺少基本运行库，此项目专为补充运行库而建。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-13
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 支叶 Windows 基础运行环境

本目录提供支叶平台在 Windows 系统上运行所需的全部基础依赖，适用于以下场景：

- **未安装 Visual Studio 的电脑**（Win7 / Win8 / Win10 / Win11）
- **全新 Windows 系统**，缺少 VC++ 运行时库
- **需要使用 Tauri 交互视窗**的电脑

## 目录结构

```
win-base-env/
├── README.md                  # 本说明文档
├── install_vc_runtime.bat     # 安装 VC++ 运行时 ← 解决 dll 缺失
├── install_webview2.bat       # 安装 WebView2      ← 解决视窗白屏
├── vc_runtime/                # VC++ 运行时库安装包
│   ├── x86/               #   32 位 VC++ Redistributable
│   │   └── VC_redist.x86.exe (*)
│   └── x64/               #   64 位 VC++ Redistributable
│       └── VC_redist.x64.exe (*)
└── tauri_deps/            # Tauri 交互视窗依赖
    ├── WebView2/          #   Microsoft Edge WebView2 Runtime (*)
    │   └── MicrosoftEdgeWebview2Setup.exe
    └── README.md          #   Tauri 依赖说明
```

> 标注 (*) 的文件需从官网手动下载放入对应目录，或运行 `install_deps.bat` 自动检测。

## 一、VC++ 运行时库

支叶主程序 `_zhiye.exe` 及扩展 DLL 使用 **Visual Studio 2022 (v143)** 编译，依赖 VC++ 运行时。

### 所需版本

| 系统架构 | 运行时 | 下载地址 |
|---------|--------|---------|
| 32 位 (x86) | Visual C++ 2015-2022 Redistributable (x86) | [Microsoft 官方](https://aka.ms/vs/17/release/vc_redist.x86.exe) |
| 64 位 (x64) | Visual C++ 2015-2022 Redistributable (x64) | [Microsoft 官方](https://aka.ms/vs/17/release/vc_redist.x64.exe) |

### 安装方式

**方式一：自动检测（推荐）**

运行 `install_deps.bat`，脚本会自动检测当前系统是否已安装 VC++ 运行时，如缺失则提示下载。

**方式二：手动安装**

1. 根据系统位数下载对应 `VC_redist.*.exe`
2. 双击运行，按提示安装
3. 安装完成后重启电脑

### 兼容性

| Windows 版本 | VC++ 2022 支持 | 备注 |
|-------------|---------------|------|
| Win11 / Win10 | ✅ 完全支持 | |
| Win8.1 | ✅ 支持 | |
| Win8 | ✅ 支持 | |
| Win7 SP1 | ⚠️ 需要安装 KB2999226 补丁 | 详见 Microsoft 官方说明 |

---

## 二、Tauri 交互视窗依赖

支叶的图形化交互视窗（Chat UI）基于 **Tauri v2** 框架开发。运行时依赖 WebView2。

### WebView2 Runtime

| 系统 | 说明 |
|------|------|
| Win11 | 系统已内置，无需额外安装 |
| Win10 | 通常已内置，如缺失请安装 |
| Win7 / Win8 | 需要手动安装 |

### 下载与安装

| 方式 | 链接 |
|------|------|
| 在线安装（推荐） | [Microsoft Edge WebView2 引导程序](https://go.microsoft.com/fwlink/p/?LinkId=2124703)（1.6MB，运行时自动下载最新版） |
| 离线安装包 | [Microsoft Edge WebView2 独立安装](https://developer.microsoft.com/microsoft-edge/webview2/) |

> 运行 `install_deps.bat` 时会自动检测 WebView2 是否已安装。

---

## 三、完整安装流程

### 新电脑首次使用支叶

```
1. 运行 install_vc_runtime.bat → 安装 VC++ 运行时（解决 dll 缺失）
2. 运行 install_webview2.bat   → 安装 WebView2（解决视窗白屏）
3. 下载支叶运行时包（nlurh）
4. 双击 _zhiye.exe 或 支叶.cmd 启动
```

### 快速验证环境

```cmd
:: 检查 VC++ 运行时
reg query "HKLM\SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64" /v Version 2>nul && echo [OK] VC++ x64 已安装 || echo [MISS] VC++ x64 未安装

:: 检查 WebView2
reg query "HKLM\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" 2>nul && echo [OK] WebView2 已安装 || echo [MISS] WebView2 未安装
```

---

## 四、常见问题

**Q: 运行 _zhiye.exe 提示缺少 VCRUNTIME140.dll？**

A: 未安装 VC++ 运行时库，请安装 `vc_runtime/` 下对应版本的 `VC_redist.*.exe`。

**Q: 交互视窗打开后白屏？**

A: 缺少 WebView2 Runtime，请安装 `tauri_deps/` 下的 WebView2 安装包。

**Q: Win7 系统安装 VC++ 后仍然报错？**

A: Win7 SP1 需要先安装 KB2999226 补丁（Windows6.1-KB2999226-x64.msu），可在 Microsoft Update Catalog 搜索下载。