Repository navigation
版本说明
本次为 0.10.3 正式版本。Windows 资产随包提供 windows-signing-status.txt;若仓库变量 WINDOWS_SIGNING_REQUIRED 未开启,该清单会明确标记 Windows 包未使用 Authenticode。Android APK(如签名 Secrets 已配置)随包提供 commit、版本码、签名指纹和 SHA-256 manifest。
本版内容
- 修复 Windows 后台请求未采用系统代理的问题:恢复 reqwest
system-proxy,公网上游调用、API 探测与模型目录发现遵循用户已经配置的代理。 localhost、127/8、IPv6 回环和映射回环的本地服务调用、探测与 readiness 始终直连,避免代理错误页被误判为服务可达。- TypeSafe HTTP 451 保留上游状态码与错误正文,按非重试错误处理;不修改 Jev 请求 JSON、Bearer 鉴权或 TLS 校验。
- 同步代理故障排查与旧版临时恢复指南,保留原子配置写入、路由、历史和生命周期能力。
用户叙事与对照场景
云端上游:让后台请求采用已配置的系统代理
- 起点:Windows 用户已开启系统代理,浏览器使用预期的海外出口;Jev Switch 配置了官方 TypeSafe 地址、API key 和
jev-latest。 - 问题:daemon 关闭 reqwest 默认 features 时漏启用系统代理支持,后台仍然直连;没有正文的 GET 也返回地区不可用的 HTTP 451,容易被误认为模型格式或凭据问题。
- 操作:完整退出旧 APP(包括托盘驻留),安装或启动本版,保持原提供商地址和凭据;先刷新提供商模型目录,再到演练场执行一次实际调用。
- 结果:本地修复对照中,Rust 客户端通过现有代理进入官方鉴权处理;使用现有凭据访问模型目录返回 HTTP 200、2 个模型,未发送付费推理请求。
- 对照:同机直连返回 451,现有代理路径通过地区门禁;本机 Laya、StartLux、OneJev 等回环服务继续直连,不依赖公网上游代理。
- 边界:代理必须由用户正确配置,本版不提供代理节点、不承诺地区持续可用。旧进程必须退出后重新启动,新 EXE 不会更新旧进程已创建的 HTTP 客户端。
验证范围与发布后检查
Rust 默认/ts-rs 测试、Clippy、fmt、本地服务探测和监听回归已通过;本页附件由同一 tag 的 Release workflow 构建。模型目录 HTTP 200 是网络与鉴权证据,不等于模型推理成功。
发行包启动后的真实 TypeSafe 推理、原生 UI 和本地模型状态抽查留到发布后验证,当前尚未完成。 本次没有新增 Android/Linux 的系统代理行为,也没有重复执行先前本地服务的整套人工验收。调查证据见 TypeSafe 系统代理核验,完整变化见 CHANGELOG。
安装
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.3
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.3打开 http://127.0.0.1:11435,用管理员密码登录,再到 Token 管理创建调用 Token。
远程部署、反向代理和配置导入见 docs/deployment.md。
发版流程与排查见 docs/RELEASE.md。
Full Changelog: v0.10.2...v0.10.3