安装与启动

OSW 有桌面端与命令行两种形态，两个形态共用同一份数据目录与配置。桌面端是日常使用的形态；命令行面向无头环境或脚本化运行，目前尚未发布、也未经过人工验收，只有从源码构建才能运行（见命令行）。

下载

到 最新发布页下载对应平台的安装包。文件名遵循 OSW-<版本>-<系统>-<架构>.<扩展名>，每个安装包都配一份 .sha256 供校验。

安装

# 打开 .dmg，把 OSW 拖进「应用程序」。
# 构建是 ad-hoc 签名、未经公证：
#   首次启动若被拦，去「系统设置 → 隐私与安全性」放行，
#   或在访达里右键应用 →「打开」。

# 运行 .exe。
# 若 SmartScreen 提示「未知发布者」，选择「更多信息 → 仍要运行」。

chmod +x OSW-*-linux-*.AppImage
./OSW-*-linux-*.AppImage

第一次启动

启动后 OSW 常驻系统托盘，不会占着主界面。首次运行会打开一个两步引导（见两步搭好网关），因为此时还没有任何上游和客户端配置。

托盘的几件事：

在 macOS 上，菜单栏图标右侧还会显示一段实时指标（默认开启）：最近一次已知的输出速度（{liveTps} TPS）。它衡量请求跑起来后每秒出多少 Token；没有在途请求时回落到最近一条已结束请求的速度（仅限落定后 5 秒内，超时即回到 --），内存里没有任何算得出速度的请求时显示 --。显示什么、显示在哪，都可以在 设置 → 应用 → 实时指标 里改（见设置项）。

开机自启

设置 → 应用 → 外观与启动里的「开机自启」打开后，登录系统时自动启动并隐藏到托盘。日常使用建议开启：这样客户端第一次请求到达时本地服务已经在跑了。

版本更新

OSW 自己检查更新（设置 → 应用 → 版本更新）。

• Windows / Linux：下载并就地安装。
• macOS：因为是 ad-hoc 签名，只能检查更新并打开 DMG 下载页，需要手动装。
• 大版本更新：当新版本包含破坏性变更（数据与配置不再沿用）时，不支持自动更新，界面会提示前往手动下载。

数据目录

桌面端与命令行共用同一个数据目录（默认 ~/.osw），配置、密钥与日志都在里面。开发版用 ~/.osw-development，因此开发实例不会碰到你的真实数据。详见数据目录与保留。

下一步：两步搭好网关，或者先了解核心概念。