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:
@@ -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` 会自动:
|
||||
|
||||
Reference in New Issue
Block a user