📦 构建信息

| 项目 | 内容 | |------|------| | 包名 | stelliberty | | 版本号 | 1.2.260 | | Mihomo 核心 | 1.19.19 |

📋 更新日志

自 v1.2.255 以来的功能和修复：

fix(ci): remove --split-per-abi to avoid duplicate builds

提交: 8b180aa | 作者: ONEUI9

fix(hotkey): require modifier key to prevent crash

提交: 807d846 | 作者: ONEUI9

fix: cleanup WebSocket before stopping core process

• Disconnect all WebSocket connections before terminating Clash
• Prevents "Connection reset without closing handshake" errors
• Use null-aware element syntax for Dart 3.x

提交: e649cba | 作者: ONEUI9

refactor: restructure asset paths and simplify directory layout

• assets/clash-core/ → assets/clash/
• geo files moved from clash/data/ to clash/
• runtime config moved to data/runtime/

提交: 2b172b0 | 作者: ONEUI9

feat(ci): add Android release signing support

提交: 643394e | 作者: ONEUI9

feat(android): support payload mode for config reload

提交: 825db98 | 作者: ONEUI9

refactor(arch): move lazy mode state from Manager to Provider

提交: f8d67fa | 作者: ONEUI9

refactor(arch): extract monitoring services and fix layer separation

提交: 87441ac | 作者: ONEUI9

📱 Android 版本说明

⚠️ 注意：Android 版本始终处于不稳定状态，建议仅用于体验和测试。

如遇问题，请在 Issues 中反馈。

❓ 故障排查

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++ 运行库合集