docs: update OpenViking installation requirements

- Add Python version compatibility notes (3.10-3.12 required)
- Add Windows-specific installation instructions
- Add conda/WSL alternatives for Python 3.13+ users
- Update binaries README with system requirements table
- Clarify that CLI requires server to run

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
iven
2026-03-16 08:28:27 +08:00
parent 0eb30c0531
commit 131b9c93ae
2 changed files with 118 additions and 5 deletions

View File

@@ -277,22 +277,56 @@ await invoke<VikingServerStatus>('viking_server_restart');
### 系统要求
- Python 3.10+
- 可选: Go 1.22+ (用于构建 AGFS 组件)
- 可选: C++ 编译器: GCC 9+ 或 Clang 11+
| 组件 | 要求 | 说明 |
|------|------|------|
| Python | 3.10 - 3.12 | ⚠️ Python 3.13+ 可能没有预编译 wheel |
| Go | 1.22+ | 可选,用于从源码构建 AGFS 组件 |
| C++ 编译器 | GCC 9+ / Clang 11+ / MSVC | 可选,从源码构建时需要 |
### ⚠️ Windows 安装注意事项
**如果使用 Python 3.13+**,预编译 wheel 可能不可用。推荐方案:
1. **安装 Python 3.12**(推荐):
- 从 [python.org](https://www.python.org/downloads/) 下载 Python 3.12
- 或使用 `py -3.12 -m pip install openviking`
2. **使用 conda 创建 3.12 环境**
```bash
conda create -n openviking python=3.12
conda activate openviking
pip install openviking
```
3. **使用 WSL2 + Linux**
```bash
wsl --install -d Ubuntu
# 在 WSL 中
pip install openviking
```
### 快速安装 (推荐)
ZCLAW 会自动管理本地 OpenViking 服务器。你只需要安装 OpenViking Python 包:
```bash
# 使用 pip 安装
pip install openviking --upgrade --force-reinstall
# 使用 pip 安装 (Python 3.10-3.12)
pip install openviking --upgrade
# 验证安装
openviking-server --version
```
### 安装验证
```bash
# 检查 OpenViking 是否正确安装
python -c "import openviking; print(openviking.__version__)"
# 检查服务器命令是否可用
openviking-server --help
```
### 自动服务器管理
ZCLAW 的 `viking-server-manager.ts` 会自动: