📦 构建信息
| 项目 | 内容 |
|---|---|
| 包名 | stelliberty
|
| 版本号 | 1.1.140
|
| Mihomo 核心 | 1.19.18
|
| 提交哈希 | d9e2d67944938f995d5cb8164b3a65f7b7362b31
|
📋 更新日志
自 v1.1.128 以来的功能和修复:
fix: 订阅更新失败智能重试策略
修复订阅更新失败后无限重试的问题,根据错误类型采取不同策略:
- 临时性错误(网络/超时/5xx/证书):更新 lastUpdateTime,按正常间隔重试
- 永久性错误(404/401/403/格式错误):禁用自动更新,需用户手动修复
避免了订阅 500 错误时每分钟重试,同时保证临时故障可自动恢复
提交: d9e2d67 | 作者: ONEUI9
Android 编译支援
提交: 04b4334 | 作者: ONEUI9
统一路径管理,消除硬编码
将所有 Clash 核心相关路径统一交给 PathService 管理,消除 3 处硬编码的 Platform.resolvedExecutable 使用
提交: ff7c70d | 作者: ONEUI9
fix: 修复查看运行时配置显示原始订阅文件的问题
现在正确读取 runtime_config.yaml(应用覆写后的配置)而非原始订阅文件
提交: ec1636b | 作者: ONEUI9
refactor: 优化配置回退机制与代码重复
- 提取 _generateConfig() 辅助方法消除重复参数传递
- 修复默认配置启动后仍监听失败文件的问题
- 添加 try-finally 保护防止回退标记未重置
提交: 03b3150 | 作者: ONEUI9
统一 rinf 信号订阅变量命名规范
- 修复 tun_config_card.dart 信号监听器内存泄漏
- 统一使用 *Subscription 后缀替代 *Listener
- 简化 override_service.dart 中的冗余变量
提交: 449a868 | 作者: ONEUI9
feat: 实现服务原地更新与心跳管理优化
提交: 06abe7e | 作者: ONEUI9
feat: 添加服务模式版本检测与更新功能,重构 Rust 路径管理
- 实现服务模式版本检测:比较已安装版本与内置版本
- 添加服务更新功能
- 引入统一的 Rust 路径服务(path_service),集中管理所有文件路径
- 更新相关国际化翻译
提交: 9194434 | 作者: ONEUI9
i18n: 移除日韩语支持,添加启动更新翻译键
- 移除日语和韩语翻译文件及生成代码
- 从语言切换器中移除日语和韩语选项
- 为所有保留语言添加 autoUpdateOnStartup 翻译键
- 移除 GitHub Actions 工作流中的依赖缓存机制
提交: 56354c9 | 作者: ONEUI9
❓ 故障排查
Linux 启动问题
如果无法启动应用,请确保已为应用文件夹赋予权限:
# 进入应用目录
cd /path/to/stelliberty
# 赋予权限
chmod 777 -R ./stelliberty端口被占用(Windows)
如果遇到端口冲突:
# 1. 查找占用端口的进程
netstat -ano | findstr :端口号
# 2. 结束进程(以管理员身份运行)
taskkill /F /PID XXX⚠️ 重要:必须以管理员身份运行命令提示符。服务模式启动的核心进程需要提升权限才能终止。
软件工作不正常
路径要求(ZIP 和 EXE 均适用):
- 路径中不应包含特殊字符(空格除外)
- 路径中不应包含非 ASCII 字符(如中文字符)
- 支持空格:
D:\Program Files\Stelliberty✅
EXE 安装程序的位置限制:
如果使用 EXE 安装程序,还有额外的安装位置限制:
- 系统盘(C:):仅允许
%LOCALAPPDATA%\Programs\*(如C:\Users\用户名\AppData\Local\Programs\Stelliberty) - 其他盘(D:、E: 等):无限制
💡 如需安装到 EXE 不允许的位置,请使用便携版 ZIP(无位置限制,但仍可能受系统目录权限影响)。
缺少运行库(Windows)
如果应用程序在 Windows 上无法启动或立即崩溃,可能是缺少必需的 Visual C++ 运行库。
解决方案:
安装 Visual C++ 运行库:vcredist - Visual C++ 运行库合集