Repository navigation
v0.10.2
Pre-release版本说明
本次为 0.10.2 预发布预览版。Windows 资产随包提供 windows-signing-status.txt;若仓库变量 WINDOWS_SIGNING_REQUIRED 未开启,该清单会明确标记 Windows 包未使用 Authenticode。Android APK(如签名 Secrets 已配置)随包提供 commit、版本码、签名指纹和 SHA-256 manifest。
本版内容
- 提供商高级配置支持受控服务的启动、停止、状态探查、readiness、超时、进程策略和生命周期审计。
- Providers 页面保留每个提供商的服务启停面板状态,面板打开时自动探测服务状态;每个提供商可独立关闭 API 自动探测。
- Laya、StartLux 和 OneJev 的外部脚本生命周期已完成多轮状态、启动、就绪、停止验证;云端 provider 继续保持手工管理。
- 公开本地服务脚本指南包含脱敏示例、逐项环境变量说明、UI 配置步骤、跨平台实现原理和故障排查 FAQ。
- 既有路由 DAG、路由活动、统计、演练场、Android 和稳定品牌图标能力保持兼容。
用户叙事与对照场景
本地服务启停:从手工记命令到可回溯的生命周期
用户为本地模型服务分别维护启动、停止和状态脚本,过去需要离开控制台手工执行,也难以判断“进程存在”是否等于“API 已就绪”。现在在 Providers 的服务启停面板登记通用命令,Jev Switch 只负责安全执行、readiness 探测、状态反馈和审计;脚本仍由用户按自己的模型运行时维护。对照场景是云端 provider:没有可控服务配置时,仍只做 API 探测,不会尝试主机命令。
多轮启停:从一次成功到可重复恢复
Laya、StartLux 和 OneJev 分别经历状态→启动→就绪→停止循环;失败时界面保留错误码、请求 ID 和下一步检查方向,避免把“启动器进程退出”误报为“服务运行中”。脚本的路径、权重和运行时依赖不写入公开发布页,统一放在脱敏指南的占位符中。
安装
Windows 桌面:下载下方 .msi(或 NSIS .exe)双击安装。
Windows 便携版:下载 .zip 并解压,双击其中的 jev-switch.exe;它与同次构建的安装包共享壳、daemon 与 UI 资源,不运行安装器。
Windows 独立版:下载 jev-switch-standalone-*-windows-x64.exe 并双击;首次启动会把内嵌 daemon/UI 校验后释放到当前用户的版本化运行缓存,应用数据仍保存在 %APPDATA%\\jev-switch。
Headless CLI:下载对应平台的 jev-switch-cli-*;Termux/Android arm64 请在设备上执行 cargo install --path rs/crates/jev-switch-cli --locked,避免把主机二进制误当成 Android 包。
Android:仓库配置四个稳定签名 Secrets 后,Release 会附带 jev-switch-<version>-android-aarch64.apk 与 manifest;未配置时 Android job 会明确跳过,但 Windows/CLI/Docker 仍会正常发布。首次从历史 debug-signed APK 升级到稳定签名包时,需先卸载旧版本一次。
Docker(Bash):先将 JEV_ADMIN_PASSWORD 设置为自己的管理员密码。
下例挂载持久数据卷,并只在宿主机回环地址提供控制台。
: "${JEV_ADMIN_PASSWORD:?请先设置管理员密码}"
export JEV_ADMIN_PASSWORD
docker pull ghcr.io/arcj137442/jev-switch:0.10.2
docker run -d --name jev-switch \
-p 127.0.0.1:11435:11435 \
--restart unless-stopped --stop-timeout 15 \
-e JEV_SWITCH_MODE=cloud -e JEV_BIND=0.0.0.0:11435 \
-e JEV_ADMIN_PASSWORD -v jev-switch-data:/data \
ghcr.io/arcj137442/jev-switch:0.10.2打开 http://127.0.0.1:11435,用管理员密码登录,再到 Token 管理创建调用 Token。
远程部署、反向代理和配置导入见 docs/deployment.md。
发版流程与排查见 docs/RELEASE.md。
Full Changelog: v0.10.1...v0.10.2