安装
Scopwis 为主要客户端平台提供原生包，同时发布 Rust Server 和合并的 CLI/TUI。安装格式遵循各平台习惯，而不是强行让所有系统使用同一种压缩包。
选择部署方式
本地开发推荐从源码启动：
git clone https://github.com/scopwis/scopwis.git
cd scopwis
cp .env.example .env
make setup
make dev
只做浏览器端开发时：
make dev-web
本地 Server 默认监听 http://127.0.0.1:3000。
直接启动原生 Server：
cargo run --locked -p scopwis-server --release
使用项目发布的容器镜像：
docker run --rm \
-p 3000:3000 \
-v scopwis-data:/var/lib/scopwis/data \
ghcr.io/scopwis/scopwis-server:<version>
容器内运行时数据默认保存在 /var/lib/scopwis/data。
客户端包
发布资产使用平台原生格式：
| 平台 | 常见包格式 |
|---|---|
| Android | APK / AAB |
| iOS | IPA |
| macOS | DMG / ZIP |
| Windows | MSIX / MSI / ZIP |
| Linux | tar.gz |
| Web | 静态 tar.gz |
| CLI / TUI | 平台压缩包或安装器 |
| Server | Linux 压缩包和 OCI 镜像 |
Beta/testing 资产会和受保护的正式签名资产明确区分。测试包只能视为兼容性构建，不等于稳定签名链路。
最小 Server 配置
SCOPWIS_HOST=127.0.0.1
SCOPWIS_PORT=3000
SCOPWIS_DATA_ROOT=/path/to/data
SCOPWIS_LOAD_PUBLIC_DATA=true
模型运行时单独配置，见模型供应商。
验证 Server
curl http://127.0.0.1:3000/health
源码仓库还提供：
make doctor
make backend-smoke
在公开暴露非 loopback Server 前，先配置认证、允许来源、模型凭据和数据访问策略。生产公开 endpoint 应使用 HTTPS。