📦 构建信息
| 项目 | 内容 |
|---|---|
| 包名 | stelliberty
|
| 版本号 | 1.1.20
|
| Mihomo 核心 | 1.19.17
|
| 提交哈希 | 5b7aa27de55402e7c2f968dd04f7ce79ebab87e2
|
📋 更新日志
自 v1.1.1 以来的功能和修复:
Add: macOS platform support and Linux desktop integration
macOS:
- Create macOS runner with Flutter and CocoaPods
- Configure bundle identifier (com.stelliberty.app)
- Add app icons for all required sizes (16-1024px)
- Integrate window_manager for window control
- Support tray residence (don't quit on window close)
- Handle Dock click to restore window
- Disable app sandbox for proxy network access
Linux:
- Add window icon loading from flutter_assets
- Create .desktop file for desktop integration
- Add 256px app icon resource
提交: 9533289 | 作者: ONEUI9
Refactor: Rename message modules to signals and fix override naming
- Rename all messages.rs to signals.rs for consistency with rinf terminology
- Rename override folder/module to overrides to avoid Rust keyword escaping (r#override)
- Update all module references and imports accordingly
提交: bc2f5cd | 作者: ONEUI9
Docs: Update README and bump version to 1.1.20
- Fix rinf installation command (rinf -> rinf_cli)
- Add Linux packaging formats (DEB/RPM/AppImage) to build docs
- Update prebuild docs with Linux packaging tools
- Fix Windows badge icon (windows11)
- Remove outdated project structure and contributing sections
- Bump app version to 1.1.20, service to 1.5.0
提交: 921107d | 作者: ONEUI9
Add: Linux and macOS service mode support
- Implement systemd service installer for Linux (pkexec elevation)
- Add launchd service support for macOS
- Add cross-platform IPC error detection (os error 2/111/61)
- Improve service status detection for non-Windows platforms
提交: 9e9249d | 作者: ONEUI9
Improve: Graceful application shutdown handling
- Add lifecycle manager for coordinated cleanup
- Improve tray event handling on exit
- Clean up network resources (IPC pool, WebSocket) on stop
- Ensure proper shutdown sequence in title bar actions
提交: 20d05e4 | 作者: ONEUI9
Improve: Service mode logging and CLI output
- Add structured logging with timestamps and levels
- Improve CLI help messages and error reporting
- Enhance IPC client/server debug logging
- Add heartbeat mechanism for connection health
提交: f80158e | 作者: ONEUI9
Refactor: Unify page-specific spacing constants
- Extract common spacing values to centralized constants
- Apply consistent padding across connection/log/subscription pages
- Reduce code duplication in UI components
提交: 8dd78d8 | 作者: ONEUI9
Improve: Add node search functionality to proxy page
- Add search input field to proxy action bar
- Implement real-time node filtering by name/address
- Add search-related i18n strings for EN/CN
- Optimize proxy notifier for search state management
提交: d487f33 | 作者: ONEUI9
Fix: UWP loopback manager search box display issue
- Wrap TextField in Material widget for proper rendering
- Ensure search input displays correctly in dialog context
提交: 9a07294 | 作者: ONEUI9
Fix: White border appearing on Linux startup
- Disable GTK window decoration to prevent border flash
- Remove header bar logic for cleaner window initialization
- Adjust default window size to 900x660
提交: 79fecc5 | 作者: ONEUI9
统计信息
- 📊 总提交数: 13
- ✅ 功能/修复提交: 10
- 🔧 CI/维护提交: 3 (已过滤)
❓ 故障排查
Linux 启动问题
如果无法启动应用,请确保已为可执行文件赋予运行权限:
# 进入应用目录
cd /path/to/stelliberty
# 赋予权限
chmod +x ./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++ 运行库合集