Stelliberty: baixar versions anteriors

- Fixed an issue with core uptime that previously reset the displayed duration when the interface restarted while the core kept running
- Fixed an issue with rule conflict validation that previously blocked unrelated rule additions and edits after a subscription update introduced a conflict
- Fixed an issue with custom rule enabled states that previously re-enabled disabled rules during editing and left toggles inconsistent after rejected saves
- Fixed an issue with macOS TUN service privileges and interface naming that previously prevented TUN from starting; existing installations need to install or update service mode

- 修复了关于核心运行时长的错误，该问题曾导致核心仍在运行时，重启界面却让显示时长归零
- 修复了关于规则冲突校验的错误，该问题曾导致订阅更新产生旧规则冲突后，无关规则也无法添加或编辑
- 修复了关于自定义规则启用状态的错误，该问题曾导致编辑时重新启用已禁用规则，保存被拒绝后开关状态也与实际结果不一致
- 修复了关于 macOS TUN 服务权限和网卡命名的错误，该问题曾导致 TUN 无法启动；已有安装需要重新安装或更新服务模式

- Fixed an issue with macOS Dock integration that previously showed duplicate icons and prevented hidden or minimized windows from reopening correctly
- Fixed an issue with quitting from the macOS Dock that previously hid the window instead of fully exiting the application
- Improved application and tray icons across Windows, macOS, and Linux, which now use consistent artwork and clearer status colors
- Improved macOS background blur, which now adapts its surface color to window activation, and adjusted dark theme card transparency across desktop platforms
- Added macOS application bundle downloads, so you can now extract the app archive and drag the application into the Applications folder

- 修复了关于 macOS 程序坞交互的错误，该问题曾导致重复显示图标，隐藏或最小化的窗口也无法正常重新打开
- 修复了关于 macOS 程序坞退出操作的错误，该问题曾导致窗口被隐藏而应用没有完全退出
- 对 Windows、macOS 和 Linux 的应用及托盘图标进行了改善，这使得图案更加统一，状态配色更加清晰
- 对 macOS 背景模糊进行了改善，这使得背景颜色能够随窗口激活状态变化，同时调整了各桌面平台深色主题卡片的透明度
- 新增了 macOS 应用包下载，现在可以解压应用包压缩文件，再将应用拖入“应用程序”文件夹使用

- Fixed an issue with connection classification that previously counted connections routed to DIRECT through proxy groups as proxied, and showed the wrong proxy group and node in connection details
- Changed the connection chain order, which now starts from the matched policy and ends at the actual outbound, consistent with the core logs
- Fixed an issue with chain proxies that previously left a proxy group empty and broke the configuration when all of its members were filtered out; empty groups now fall back to COMPATIBLE by default
- Moved macOS and Linux user data to the current user's application data directory, so the app installation no longer needs to be writable by all users and service mode can start the core normally in installed packages
Upgrading on macOS and Linux [v2.0.36]
This release changes where user data is stored on macOS and Linux:
- macOS: ~/Library/Application Support/stelliberty/data
- Linux: ~/.local/share/stelliberty/data
Automatically migrating the old location would mean carrying compatibility code through every future release, which would make the app increasingly hard to maintain and more prone to issues. After weighing this, we decided not to migrate automatically this time. We apologize for the inconvenience and ask you to reinstall once as follows:
1. Uninstall service mode in the old version.
2. Back up your data in Settings > Data Management, and save the backup file outside the app's installation location, such as your desktop.
3. Exit the app completely and uninstall the old application package.
4. Install the current version, then restore the backup file in Settings > Data Management.
Once everything works as expected, you can delete the old data directory: Stelliberty.data next to the app on macOS, /opt/stelliberty.data on Linux (along with /opt/stelliberty if it remains after uninstalling), or stelliberty.data next to the AppImage.
Windows is not affected and requires no action.

- 修复了关于连接分类的错误，该问题曾导致经代理组走 DIRECT 的连接被算作代理连接，连接详情中的代理组和节点也显示不正确
- 调整了连接链路的显示顺序，现在从命中的策略开始、到实际出站结束，与核心日志保持一致
- 修复了关于链式代理的错误，该问题曾导致代理组成员被全部过滤后变成空组，使配置失效；现在空组默认会回退到 COMPATIBLE
- 调整了 macOS 和 Linux 的用户数据位置，现在保存在当前用户的应用数据目录中，应用安装目录不再需要对所有用户开放写入权限，安装包版本的服务模式也能正常启动核心
macOS 与 Linux 升级说明 [v2.0.36]
本次更新调整了 macOS 和 Linux 上用户数据的保存位置：
- macOS：~/Library/Application Support/stelliberty/data
- Linux：~/.local/share/stelliberty/data
如果为旧位置做自动迁移，后续每个版本都得一直带着这套兼容逻辑，维护会越来越吃力，也更容易出问题。权衡之后，这次没有做自动迁移，给大家添麻烦了，还请按以下步骤重新安装一次：
1. 在旧版本中卸载服务模式。
2. 在“设置 > 数据管理”中备份数据，并把备份文件保存到应用安装位置以外的地方，例如桌面。
3. 完全退出应用，卸载旧的应用包。
4. 安装当前版本，再到“设置 > 数据管理”中还原刚才的备份文件。
确认一切正常后，可以删除旧的数据目录：macOS 上是应用旁边的 Stelliberty.data，Linux 上是 /opt/stelliberty.data（卸载后如果还残留 /opt/stelliberty，也可以一并删除），AppImage 则是它旁边的 stelliberty.data。
Windows 不受影响，无需任何操作。

- Added traffic and expiry details to remote proxy providers, so you can now view each provider's usage and quota with low-quota and expiry warnings
- Improved subscription cards and the home subscription card, which now show combined remote provider usage and the earliest expiry while identifying unknown totals and incomplete data
- Improved provider usage updates, which now refresh card totals after synchronization and preserve the last recorded usage when switching subscriptions

- 新增了远程代理提供者的流量与到期明细，现在可以查看各提供者的用量、额度，以及余量不足和到期提醒
- 对订阅卡片和主页当前订阅卡片的流量展示进行了改善，这使得多个远程提供者的用量和最早到期时间能够汇总显示，并区分总量未知与数据不完整的情况
- 对提供者流量更新进行了改善，这使得同步后卡片合计能够及时刷新，切换订阅后也能保留上次记录的用量

- Fixed an issue with the rule page that previously hid rules and proxy groups introduced by subscription overrides, which also prevented custom rules from targeting those proxy groups
- Fixed an issue with rule editing before the rule baseline was ready, which previously allowed duplicate rules and a broken rule order to reach the core
- Removed proxy group menus from the tray; this feature is temporarily unavailable because the Avalonia memory usage issue cannot be resolved for now
- Changed the app icons in preparation for the upcoming Stelliberty mobile app

- 修复了关于规则页的错误，该问题曾导致订阅覆写引入的规则和代理组不显示，自定义规则也无法指向这些代理组
- 修复了关于规则基线就绪前编辑规则的错误，该问题曾导致重复规则和错乱的规则顺序进入核心
- 移除了托盘代理组菜单，由于目前无法解决 Avalonia 的内存占用问题，此功能暂时移除
- 调整了应用图标，为即将到来的 Stelliberty 移动端做好准备

- Improved memory usage in normal mode, which now releases cached pages after 60 seconds in the tray and restores their scroll positions when reopened
- Changed how Lightweight Mode releases the interface; it now waits 60 seconds after hiding, allowing quick reopening to reuse the current interface
- Added proxy group menus to the tray, so you can now switch nodes and view delay results shared with the interface
- Improved recovery after system sleep, which now restores normal and service cores and reapplies system proxy settings managed by the app
- Fixed an issue that briefly showed empty states on some pages during startup or configuration loading
- Improved application log export, which now combines interface and tray logs into one file for troubleshooting

- 对普通模式的内存占用进行了改善，现在隐藏到托盘 60 秒后会释放页面缓存，重新打开时恢复页面滚动位置
- 调整了轻量模式释放界面的时机，现在隐藏满 60 秒后才退出界面，期间重新打开可复用当前界面
- 新增了托盘代理组菜单，现在可以直接切换节点并查看与界面同步的测速结果
- 对休眠唤醒后的恢复进行了改善，现在会恢复普通模式和服务模式的核心，并重新应用本应用管理的系统代理设置
- 修复了启动或加载配置时部分页面短暂显示空状态的问题
- 对应用日志导出进行了改善，现在会将界面和托盘日志合并到一个文件，便于排查问题

- Added Lightweight Mode, so you can now free the interface from memory when hiding to the tray and reload it when reopened
- Added the Mips Stack option, so you can now select it in Virtual Network settings
- Fixed an issue with the Copy Terminal Proxy tray command that previously failed on Windows
- Improved the node delay test button, which now offers a larger hit area and is easier to click
- Removed the service mode session switch failure messages; installing or uninstalling service mode no longer reports intermediate failures

- 新增了轻量模式，现在可以在隐藏到托盘时释放界面内存，再次打开时重新加载
- 新增了 Mips 网络栈选项，现在可以在虚拟网卡配置中选择
- 修复了关于托盘“复制终端指令”的错误，该问题曾导致在 Windows 上复制失败
- 对节点延迟检测按钮进行了改善，现在可点击区域更大，更容易点击
- 移除了服务模式会话切换失败的提示，安装或卸载服务模式不再报告中间失败

- Fixed an issue with copying terminal proxy commands from the tray that previously caused copying to fail while the main window stayed hidden after silent startup
- Fixed an issue with service-mode core status that previously caused false error reports during system shutdown or sign-out

- 修复了关于托盘复制终端代理命令的错误，该问题曾导致静默启动后主窗口隐藏时无法复制命令
- 修复了关于服务模式核心状态的错误，该问题曾导致系统关机或注销期间状态误报异常

- Applying config changes in service mode now reloads the core in place, so proxies no longer drop for a few seconds on subscription updates and setting changes
- Fixed service-mode core status briefly showing as unavailable while the core kept running, which also caused unnecessary proxy selection reloads
- Fixed a race during app shutdown that could crash the app while disposing the service-mode core client
- Added a --minimized startup flag that launches the app with the main window minimized

- 服务模式下应用配置变更改为原地重载核心，更新订阅或修改设置时代理节点不再短暂丢失
- 修复了服务模式下核心仍在运行时状态短暂显示为不可用的问题，该问题此前还会引发多余的代理选择重载
- 修复了应用退出时服务模式核心客户端释放竞态可能导致崩溃的问题
- 新增了 --minimized 启动参数，现在可以让应用以主窗口最小化的方式启动

- Fixed manually picking a node in a url-test or fallback group permanently suspending its automatic selection, which previously could only be undone by deleting the subscription
- Running a delay test now releases manual picks on url-test and fallback groups, and a restart returns them to automatic selection
- Fixed batch delay results disappearing from rows that scrolled out of view while the batch was still running
- Dialogs now open scrolled to the top instead of keeping the position left by the previous session
- Filtered rule lists now show the same centered empty card as the other list pages
- Add and refresh moved into the rule page header, so the toolbar no longer overlaps at the narrowest window width

- 修复了在 url-test 或 fallback 分组手动选择节点后自动择优被永久挂起的问题，该问题此前只能通过删除订阅解除
- 测试延迟现在会解除 url-test 和 fallback 分组的手动选择，重启后这类分组也会回到自动择优
- 修复了批量测速期间滚出视图的条目丢失延迟结果的问题
- 弹窗现在每次打开都从顶部开始，不再保留上一次的滚动位置
- 规则列表被过滤为空时，现在显示与其它列表页一致的居中空状态卡片
- 规则页的新增和刷新移入页头，最窄窗口宽度下工具栏不再重叠

- Fixed proxy and subscription selections being lost after an abrupt exit, which previously reset the selected nodes and current subscription without warning
- Fixed delay testing a node cancelling tests already running on other nodes, so each node now keeps its own result
- Deleting a subscription now also clears the proxy selections it left behind
- Traffic curves on the home page now scroll smoothly, without the small jump that appeared every second
- Removed the end point dot from the traffic curves
- Hovering the tray icon now shows the app name

- 修复了异常退出后代理和订阅选择丢失的问题，该问题曾导致已选节点和当前订阅被无声重置
- 修复了测试某个节点延迟会取消其它节点正在进行的测试的问题，现在每个节点都能保留自己的结果
- 删除订阅时现在会同时清理它遗留的代理选择记录
- 首页流量曲线现在会平滑滚动，不再每秒轻微跳动一下
- 移除了流量曲线末端的圆点
- 悬停托盘图标现在会显示应用名称

- Fixed an issue with subscription updates that previously caused the selected subscription to be cleared and replaced with an empty config when a chain hop or custom rule outbound no longer existed
- Improved dialog error alignment, which now matches the text above it

- 修复了关于订阅更新的错误，该问题曾导致链式跳点或自定义规则出站目标不存在时清空当前订阅并切回空配置
- 对对话框错误提示的对齐进行了改善，这使得错误文字与上方内容对齐

- Text and cards now stay sharp and aligned while dragging items to reorder a list
- Custom rule cards now provide direct edit and delete actions
- Custom rules now only accept available outbound targets and validate CIDR values before saving

- 拖动列表项排序时，文字和卡片现在保持清晰，不再出现模糊或错位
- 自定义规则卡片现在提供直接编辑和删除操作
- 自定义规则现在仅允许选择可用出站目标，并在保存前校验 CIDR

- Reorderable lists now auto-scroll near their edges, and proxy nodes in chain dialogs can be reordered directly
- Custom chain proxies can now target a specific proxy group and use a proxy group as the first hop
- Chain proxy cycles are detected at runtime and warned about; configurations rejected by the core fall back to an empty runtime configuration
- Subscription, override, rule, and custom chain proxy forms now show field-specific errors and focus the first invalid field when save validation fails
- Dialog shadows no longer show black corners, and custom chain proxy controls, rule toggles, and dialog input focus borders now use consistent styling
- The rules toolbar can now reset a custom rule order back to the default without removing local rules
- The main window now stays inside the usable screen area on high-DPI scaled displays
- Improve translation text

- 可拖动排序的列表现在支持边缘自动滚动，代理链对话框中的代理节点也可直接拖动调整顺序
- 自定义代理链现在可指定所属代理组，并可将代理组作为第一个跳点
- 代理链循环会在运行时被检测并提示；核心拒绝循环配置时会恢复为空运行配置
- 订阅、覆写、规则和自定义代理链表单在保存校验失败时会显示具体字段错误，并聚焦第一个无效字段
- 对话框阴影不再出现黑色边角，并统一自定义代理链控件、规则开关和对话框输入框焦点边框样式
- 规则页工具栏可将自定义排序恢复为默认顺序，本地规则不会被删除
- 高缩放屏幕下，主窗口启动时会限制在可用显示区域内
- 翻译文本改进

- You can now edit rules per subscription: disable built-in rules, add local custom rules, and drag to reorder them
- Rule templates let you save local rules and reuse them in other subscriptions
- Page switching no longer dims the content, and the loading indicator no longer gets stuck when first opening a page

- 规则页现在支持按订阅编辑规则：停用内置规则、添加本地自定义规则并拖动排序
- 规则模板可保存本地规则，并在其它订阅中复用
- 页面切换不再出现遮罩变暗，首次进入页面时加载指示不再卡住

- Service-mode core logs now resume correctly after the service recovers
- Service Mode now detects the bundled service version before offering an update
- Before or after installing this update, uninstall Service Mode once and then reinstall it

- 服务恢复运行后，服务模式的核心日志现在会正常继续显示
- 服务模式现在会先检测安装包内的服务版本，再提示更新
- 安装此次更新前或安装后，请先卸载一次服务模式，再重新安装

- Reverted to single-process mode because process separation did not provide clear benefits
- Fixed some override scripts not taking effect

- 回退到单进程模式，目前看起来并没有得到有效反馈
- 修复某些覆写脚本不生效的问题

- Separate the tray and desktop UI into independent processes, keeping hidden-window memory usage in the low double-digit megabytes.

- 完成托盘与桌面界面进程分离，窗口隐藏时内存占用仅保持在两位数 MB。

- Fixed service mode failing to detect available updates.

- 修复服务模式无法正确检测到新版本的问题。

- Excessive frame-rate drops when switching to the proxy page have been eliminated.
- Service mode now stops the core correctly when the app exits.
- The selected subscription and proxy choices now survive app restarts, core restarts, and service mode installation or removal.
- The chain proxy dialog scrollbar is now aligned correctly.

- 彻底消除切换到代理页时的帧数过度下降。
- 服务模式会在应用退出时正确停止核心。
- 选中的订阅和代理节点现在会在应用重启、核心重启以及服务模式安装或卸载后保持不变。
- 链式代理对话框的滚动条现已正确对齐。

- Saved subscriptions and overrides are no longer cleared when a state file is temporarily locked or inaccessible.
- Core restarts now stop when the previous core process cannot be confirmed closed.
- Subscription and override operations no longer report false success, and canceled updates stay silent.
- File picker failures now show a clear message while normal cancellation remains silent.

- 状态文件暂时被占用或无法访问时，已保存的订阅和覆写不再被清空。
- 无法确认旧核心进程已关闭时，核心重启会立即停止。
- 订阅和覆写操作不再虚假提示成功，主动取消更新时也不会提示失败。
- 文件选择器异常时会显示明确提示，正常取消仍保持静默。

- During batch proxy delay tests, each proxy now shows its testing state only when its test actually begins.

- 批量代理测速时，每个代理会在实际开始测速后才显示测速状态。

- Fixed error notifications appearing when closing the app while service mode is active.
- Corrupt settings files are now automatically backed up before being reset to defaults.
- Data files are now saved using atomic operations to prevent corruption during writes.
- Update checks now retry automatically after network failures.
- Fixed connection list occasionally becoming empty or unresponsive during refresh.
- Subscription delay tests that fail no longer interfere with other operations.
- Copying subscription links now shows a confirmation message.
- Notification display timing has been refined for better visibility.
- The app now responds more quickly when loading.

- 修复了在服务模式运行时关闭应用弹出错误提示的问题。
- 损坏的设置文件现在会在重置为默认值之前自动备份。
- 数据文件现在使用原子操作保存，防止写入过程中损坏。
- 更新检查在网络失败后会自动重试。
- 修复了连接列表在刷新时偶尔变空或无响应的问题。
- 订阅延迟测试失败不再影响其他操作。
- 复制订阅链接时现在会显示确认消息。
- 优化了通知显示时长，提升可见性。
- 应用加载时响应更快。

- Update checks now fall back to the system and core proxies, and update alerts appear on every page.
- Vertical proxy groups now expand and collapse with smoother chevron and height animations.
- Automatic delay-test and subscription-update intervals now show their minute units.
- The close-all-connections action now uses a clearer close icon.

- 更新检查现在会依次尝试系统代理与核心代理，更新提醒可在任意页面显示。
- 竖向代理组现在以更流畅的箭头和高度动画展开、折叠。
- 自动测试延迟和订阅更新间隔现在会显示分钟单位。
- 关闭全部连接操作现在使用更明确的关闭图标。

- Dialogs now animate smoothly the first time they open.

- 弹窗首次打开时现在也会平滑播放动画。

- Pages now open on demand with a loading animation, reducing startup work and keeping navigation responsive.
- Proxy lists with thousands of nodes now remain smooth while scrolling in both layouts.

- 页面现在按需打开并显示加载动画，减少启动时的额外工作，同时保持导航响应流畅。
- 代理列表包含数千个节点时，横向和纵向布局的滚动依然流畅。

- Remote subscriptions now work with more restrictive download services and reject HTML error pages without exposing subscription details.
- Rapid sidebar clicks no longer interrupt page navigation.

- 远程订阅现在可兼容限制更严格的下载服务，并会在不泄露订阅信息的情况下拒绝 HTML 错误页面。
- 快速点击侧栏时不再打断页面切换。

- Added an application behavior option to show or hide the live frame rate in the title bar, enabled by default.

- 新增在标题栏显示或隐藏实时帧率的应用行为选项，并默认开启。

- Added bouncier page, settings subpage, and dialog transitions, with smoother enter and exit motion during rapid navigation.
- Page and dialog transitions now avoid stale hover states, visual overlap, and unfinished closing animations.
- Pages are warmed up after the window opens, making the first visit to each section feel more responsive.
- Hiding the app in the system tray now releases page content after 30 seconds to reduce memory use, while restoring the current page and scroll positions when reopened.
- Settings subpages are now created only when needed and remember their individual scroll positions.
- Large proxy node lists now render items on demand in a virtualized grid, improving first-open speed and scrolling smoothness.
- The proxy page now rebuilds correctly after language changes or node selections that finish while the page is hidden.
- Proxy delay tests now use a pulsing ellipsis indicator and keep results synchronized with nodes rendered later.
- Connection and core log pause controls now switch between pause and resume icons with matching tooltips.
- Scrollbar thumbs now keep fully rounded ends.
- Installing or updating service mode now switches the current session to the service core immediately, while uninstalling returns to the normal core without restarting the app.
- Service mode changes now recover the normal core after failed or canceled transitions and prevent normal and service cores from competing for the same runtime channel.
- Service mode notices now distinguish installation, uninstallation, cancellation, session activation failure, and normal-mode recovery failure.
- A failed proxy selection, proxy list, or rule refresh during startup no longer prevents the remaining runtime lists from loading.

- 新增更加 Q 弹的页面、设置子页与对话框切换动画，快速切换时的进入和退出动效也更加顺滑。
- 页面与对话框切换现在会避免残留悬停状态、画面重叠以及关闭动画未完成的问题。
- 窗口打开后会在后台预热各个页面，首次进入不同功能区时响应更加流畅。
- 应用隐藏到系统托盘 30 秒后会释放页面内容以降低内存占用，再次打开时会恢复当前页面和滚动位置。
- 设置子页现在只在需要时创建，并会分别记住各自的滚动位置。
- 大型代理节点列表现在会通过虚拟化网格按需渲染，首次打开速度和滚动流畅度得到改善。
- 切换语言或节点选择在代理页隐藏期间完成后，再次进入代理页时也能正确重建显示状态。
- 代理延迟测试现在使用呼吸变化的省略号提示，并会让稍后渲染的节点保持正确的测试结果。
- 连接与核心日志页面的暂停控件现在会在暂停和继续图标之间切换，并同步更新提示文字。
- 滚动条滑块现在会始终保持完整的圆角端点。
- 安装或更新服务模式后，当前会话会立即切换到服务核心；卸载后也会直接恢复普通核心，无需重启应用。
- 服务模式切换失败或取消后现在会恢复普通核心，并避免普通核心与服务核心争用同一个运行通道。
- 服务模式提示现在会分别说明安装、卸载、取消、当前会话激活失败以及普通模式恢复失败。
- 启动时恢复代理选择、刷新代理列表或刷新规则中的某一步失败，不再阻止其余运行列表继续加载。

- You can now register separate global shortcuts to show or hide the window, toggle the system proxy, and toggle virtual network adapter mode.
- Shortcut registration rejects unsupported or duplicate combinations, pauses activation while recording, and ignores repeated activations for 500 milliseconds.
- Pressing Escape now returns from a settings subpage.
- Windows upgrades now turn off the system proxy after stopping the app, preventing an unusable proxy from remaining enabled.
- Opening the main window after a silent startup is now faster because page preparation begins only after the window appears.
- Locating the selected proxy no longer repeatedly pulls the node list back after you scroll elsewhere.
- Wrapped grid items now stay aligned at fractional display scaling without clipping or overflowing the final column.
Upgrading from versions before 2.0.0 [v2.0.0]
Version 2.0.0 was a major rewrite and does not retain compatibility with installation state from the old Flutter version. Before installing this release over an older version:
1. Disable and uninstall startup integration in the old version.
2. Uninstall service mode in the old version.
3. Exit and uninstall the old application completely.
4. Install the current version only after the previous steps are complete.
Skipping these steps may leave old startup or service components on the system and cause unexpected behavior.

- 现在可以分别注册全局快捷键，用于显示或隐藏窗口、切换系统代理以及切换虚拟网卡模式。
- 快捷键注册会拒绝不支持或重复的组合，录制期间暂停触发，并忽略 500 毫秒内的重复操作。
- 现在可以在设置子页按 Escape 返回上一级。
- Windows 升级安装停止应用后会关闭系统代理，避免留下无法使用的代理开关。
- 静默启动后打开主窗口的速度得到改善，页面准备会在窗口显示后再开始。
- 定位已选代理后，即使滚动到其他位置，节点列表也不会再被后续刷新反复拉回。
- 分数缩放下的网格项目现在能够保持对齐，最后一列不再被裁切或越出边界。
从 2.0.0 之前的版本升级 [v2.0.0]
2.0.0 是一次大规模重构，不兼容旧 Flutter 版本留下的安装状态。从旧版本升级到当前版本前，请依次完成以下操作：
1. 在旧版本中关闭并卸载开机启动。
2. 在旧版本中卸载服务模式。
3. 完全退出并卸载旧应用。
4. 确认以上步骤完成后，再安装当前版本。
跳过这些步骤可能导致系统中残留旧版开机启动项或服务组件，进而引发异常行为。

- Windows startup settings now wait for permission-sensitive changes to succeed, avoid unrelated task prompts, and start after a one-second delay.
- Proxy sorting now persists across app and core restarts, while horizontal group navigation supports smooth wheel and button scrolling.
- Replacing the macOS or Linux application now preserves portable user data outside the replaceable application payload.
- macOS now reports the correct application name and follows simplified Chinese system localization more reliably.
- Subscription imports no longer fail when the stored subscription list is missing or incomplete.
Upgrading from versions before 2.0.0 [v2.0.0]
Version 2.0.0 was a major rewrite and does not retain compatibility with installation state from the old Flutter version. Before installing this release over an older version:
1. Disable and uninstall startup integration in the old version.
2. Uninstall service mode in the old version.
3. Exit and uninstall the old application completely.
4. Install the current version only after the previous steps are complete.
Skipping these steps may leave old startup or service components on the system and cause unexpected behavior.

- Windows 开机启动设置现在会等待权限相关操作成功后再更新状态，不再触发无关的任务弹窗，并在 1 秒延时后启动。
- 代理排序现在能够在应用和内核重启后保持，横向分组导航同时支持平滑的滚轮与按钮滚动。
- 替换 macOS 或 Linux 应用时，便携用户数据现在会保存在可替换应用文件之外，不再随应用一起被覆盖。
- macOS 现在能够显示正确的应用名称，并能更可靠地跟随简体中文系统语言。
- 订阅列表缺失或内容不完整时，导入订阅不再失败。
从 2.0.0 之前的版本升级 [v2.0.0]
2.0.0 是一次大规模重构，不兼容旧 Flutter 版本留下的安装状态。从旧版本升级到当前版本前，请依次完成以下操作：
1. 在旧版本中关闭并卸载开机启动。
2. 在旧版本中卸载服务模式。
3. 完全退出并卸载旧应用。
4. 确认以上步骤完成后，再安装当前版本。
跳过这些步骤可能导致系统中残留旧版开机启动项或服务组件，进而引发异常行为。

- Service mode remains available after installing an app update.

- 安装应用更新后，服务模式仍可正常使用。

- Proxy Provider nodes remain visible, selectable, and available for delay testing with the latest mihomo core.
- Individual and batch delay tests can run together without losing completed results.
- Long proxy node tooltips now wrap within a limited height.

- 使用最新版 mihomo 核心时，Proxy Provider 节点仍可正常显示、选择并进行延迟测试。
- 单节点与批量延迟测试现在可以同时运行，已完成的结果不会丢失。
- 较长的代理节点提示文字现在会在限定高度内换行显示。

- Beta releases can now be detected when the update channel is set to Beta.
- Subscription and override updates now report individual results and batch success or failure counts.

- 更新通道设为测试版后，现在可以检测测试版发布。
- 订阅和覆写更新现在会反馈单项结果，以及批量更新的成功和失败数量。

- This is the .NET version of Stelliberty and is still in testing. The source code will be opened after it becomes stable. Please help test it and report any issues.

- 这是 Stelliberty 的 .NET 版本，目前仍在测试中，稳定后才会开源。希望大家多多测试并反馈问题。

- System proxy and TUN switches now update immediately while their changes continue in the background.
- The home page subscription metadata now aligns more consistently.
- The outbound mode card now uses concise strategy descriptions instead of repeating the selected mode.
- macOS now keeps the native window controls without also showing the custom controls.

- 系统代理和 TUN 开关现在会立即更新状态，实际变更在后台继续执行。
- 主页订阅信息的更新时间和到期时间对齐更一致。
- 出站模式卡片现在改用简短策略说明，不再重复显示当前模式。
- macOS 现在保留系统标题栏按钮，不再同时显示自绘窗口控制。

- You can now choose whether the tray icon uses a left double-click or a single click to show and hide the window.
- App behavior settings now include clearer descriptions and no longer show a redundant applied message.
- Lazy Mode now enables the system proxy automatically when the app starts.

- 现在可以选择托盘图标使用鼠标左键双击或单击来显示和隐藏窗口。
- 应用行为设置现在有更清晰的说明，并且不再显示多余的已应用提示。
- 懒惰模式现在会在应用启动时自动开启系统代理。

- The config editor's syntax highlighting now adapts to the theme, with clearer contrast in both light and dark modes.
- The config editor no longer scrolls far past the last line, keeping only a small bottom margin.
- This is the .NET version of Stelliberty and is still in testing. The source code will be opened after it becomes stable. Please help test it and report any issues.

- 配置编辑器的语法高亮现在会随主题适配，亮色和暗色下的对比度都更清晰。
- 配置编辑器不再能滚动到超出末行很远的位置，只保留少量底部留白。
- 这是 Stelliberty 的 .NET 版本，目前仍在测试中，稳定后才会开源。希望大家多多测试并反馈问题。

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.290
Mihomo 核心 1.19.27
- 修复 Arch Linux 服务模式下 GUI 无法连接后端与 Clash 核心的问题
- Flutter 版本将在未来废弃，将由全新的 stelliberty-net 替代，欢迎测试：https://github.com/Kindness-Kismet/stelliberty-net
English Version
- Fixed an issue where the GUI could not connect to the backend service and Clash core in service mode on Arch Linux
- The Flutter version will be deprecated in the future and replaced by the new stelliberty-net. Testing is welcome: https://github.com/Kindness-Kismet/stelliberty-net

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.289
Mihomo 核心 1.19.27
- 新增订阅支持 age 加密密钥解密（mihomo age secret key）
English Version
- Added support for age encryption key decryption in subscriptions (mihomo age secret key)

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.288
Mihomo 核心 1.19.27
- 修复 Windows 关机或注销时系统代理可能残留的问题
English Version
- Fixed system proxy possibly remaining enabled during Windows shutdown or sign-out

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.287
Mihomo 核心 1.19.25
- 修复 Windows 关机或注销时系统代理可能残留的问题
English Version
- Fixed system proxy possibly remaining enabled during Windows shutdown or sign-out

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.286
Mihomo 核心 1.19.25
- 修复编辑远程订阅的链式代理时提示配置路径不可用的问题
- 已添加 macOS 安装包生成，欢迎 macOS 用户协助测试
English Version
- Fixed the unavailable configuration path error when editing chain proxies for remote subscriptions
- Added macOS installer generation, and macOS users are welcome to help test it

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.285
Mihomo 核心 1.19.25
- 修复更新当前订阅后切到代理页时节点列表不立即刷新的问题
English Version
- Fixed proxy nodes not refreshing immediately after updating the active subscription

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.284
Mihomo 核心 1.19.24
- 修复 Windows 剪贴板历史无法在应用内正常粘贴的问题
English Version
- Fixed Windows clipboard history not pasting correctly inside the app

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.283
Mihomo 核心 1.19.24
- 修复 Windows 剪贴板历史无法在应用内正常粘贴的问题
English Version
- Fixed Windows clipboard history not pasting correctly inside the app

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.282
Mihomo 核心 1.19.24
- 修复 JS 覆写偶尔未生效的问题，避免代理分组和 DNS 设置在启动或切换配置时丢失
English Version
- Fixed an issue where JS overrides could occasionally fail to apply, preventing proxy groups and DNS settings from being lost during startup or configuration changes

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.281
Mihomo 核心 1.19.24
- 修复 Reality 节点配置生成异常，避免部分 VLESS 节点无法使用
- 优化代理页滚动体验，节点名称提示会在悬停 1 秒后再显示，减少滚动时的遮挡
English Version
- Fixed Reality node configuration generation to prevent some VLESS nodes from failing to connect
- Improved scrolling on the proxy page by showing node name tips after hovering for 1 second, reducing interruptions while scrolling

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.280
Mihomo 核心 1.19.24
- 优化代理页滚动体验，节点名称提示会在悬停片刻后再显示，减少滚动时的遮挡
English Version
- Improved scrolling on the proxy page by showing node name tips only after hovering briefly, reducing interruptions while scrolling

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.279
Mihomo 核心 1.19.24
- 新增链式代理配置，可为订阅单独设置多跳链式路径
English Version
- Added chain proxy configuration so each subscription can use its own multi-hop chain path

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.278
Mihomo 核心 1.19.24
- 虚拟网卡 MTU 按平台自动采用最佳默认值（Android 9000 / iOS 4064 / 桌面 65535），并按平台放宽输入上限
English Version
- TUN MTU now defaults to the optimal value per platform (Android 9000 / iOS 4064 / Desktop 65535), with upper limits relaxed per platform

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.277
Mihomo 核心 1.19.23
- 修复延迟测试结果在一段时间后自动消失的问题
English Version
- Fix delay test results disappearing after a period of time

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.276
Mihomo 核心 1.19.23
- 支持为当前订阅设置自动测试延迟间隔，输入 0 即可关闭
- 在更新订阅、调整覆写或系统唤醒后，自动测试延迟会按当前状态重新恢复，延迟结果与当前配置保持一致
English Version
- Add an auto delay test interval for the current subscription, with 0 used to disable it
- Restore auto delay tests after subscription updates, override changes, or system wake-up so latency results stay consistent with the current configuration

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.275
Mihomo 核心 1.19.23
- 支持为当前订阅设置自动测试延迟间隔，输入 0 即可关闭
- 在更新订阅、调整覆写或系统唤醒后，自动测试延迟会按当前状态重新恢复，延迟结果与当前配置保持一致
English Version
- Add an auto delay test interval for the current subscription, with 0 used to disable it
- Restore auto delay tests after subscription updates, override changes, or system wake-up so latency results stay consistent with the current configuration

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.274
Mihomo 核心 1.19.23
- 避免更新订阅或覆写后旧的测速结果重新显示，列表中的延迟信息会与当前配置保持一致
English Version
- Prevent outdated speed test results from reappearing after updating subscriptions or overrides, so latency information stays consistent with the current configuration

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.272
Mihomo 核心 1.19.21
- 不再使用 Windows 上 Flutter run UI on separate thread 策略
English Version
- Drop the Flutter run UI on separate thread strategy on Windows

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.271
Mihomo 核心 1.19.21
📋 更新日志
自 v1.2.270 以来的功能和修复：
fix(linux): restore silent start and window resizing
提交：aa3b76a | 作者：oneui
fix(loopback): flags 降级策略与防火墙服务诊断
NetworkIsolationEnumAppContainers 在部分 Win11 环境中即使
以管理员身份运行仍返回 Access Denied，根因可能是 mpssvc/BFE
服务异常而非进程权限不足。
- 枚举时先用 flags=1 再降级 flags=0，兼容更多环境
- Access Denied 时自动检测 mpssvc 和 BFE 服务状态
- 错误信息附带诊断结果，替代笼统的"权限不足"
- set_loopback_exemption 复用同一降级逻辑
提交：8991d95 | 作者：ONEUI9
refactor(logging): 简化 Dart 与 Rust 日志级别前缀
提交：61f39d8 | 作者：ONEUI9
fix(loopback): 提升 NetIso 失败上下文日志可见性
提交：deaca59 | 作者：ONEUI9
fix(loopback): 增强 UWP NetIso 诊断日志
提交：c91090a | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.270
Mihomo 核心 1.19.21
📋 更新日志
自 v1.2.269 以来的功能和修复：

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.269
Mihomo 核心 1.19.21
📋 更新日志
自 v1.2.268 以来的功能和修复：
feat(settings): 局域网代理新增用户名密码认证
Closes #54
提交：e1ad9e1 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.268
Mihomo 核心 1.19.21
📋 更新日志
自 v1.2.267 以来的功能和修复：
fix: restore linux text input
提交：1d9ad41 | 作者：ONE
revert: 7b35f73 跳过 bitsdojo_window 修复
提交：fe607c8 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.267
Mihomo 核心 1.19.21
📋 更新日志
自 v1.2.266 以来的功能和修复：
fix(proxy): 同步写入 KDE 与 dconf 系统代理配置
Linux 系统代理改为并行兼容 KDE、gsettings 与 dconf 后端，
修复 KDE 下 Firefox 无法读取系统代理的问题，并兼容 Plasma 6 的 config 命令。
Closes #53
提交：76d37a9 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.266
Mihomo 核心 1.19.20
📋 更新日志
自 v1.2.265 以来的功能和修复：
fix(linux): 跳过 bitsdojo_window 插件注册，修复 Linux 文本框无法输入
bitsdojo_window_linux 在插件注册时通过 enhanceFlutterView 挂载
GTK 信号 hook，在 Wayland/KDE 等环境下破坏键盘事件传递链，
导致所有文本输入框无法键入字符。
Linux 端改为手动注册其余插件以绕过该问题；
Dart 侧 bitsdojo_window API 限定仅 Windows 调用。
Closes #52
提交：7b35f73 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.265
Mihomo 核心 1.19.20
📋 更新日志
自 v1.2.263 以来的功能和修复：
fix(proxy): URLTest/Fallback 自动选择组不再被本地缓存覆盖
提交：09e49a4 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.263
Mihomo 核心 1.19.20
📋 更新日志
自 v1.2.261 以来的功能和修复：
feat(settings): 应用日志卡片新增导出按钮，支持通过系统保存对话框导出日志文件
提交：bea44da | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.261
Mihomo 核心 1.19.20
📋 更新日志
自 v1.2.260 以来的功能和修复：
fix(ui): 桌面端对话框按钮恢复默认尺寸，禁用 release Android 构建
提交：30062d4 | 作者：ONEUI9
refactor(android): simplify Gradle ABI filtering
- Extract targetAbi to top level, remove 2 duplicate definitions
- Remove redundant ndk.abiFilters in defaultConfig
- Remove unused splits configuration
- Remove unused shouldSplitPerAbi variable
- Reduced from ~160 to ~140 lines
提交：b444da5 | 作者：ONEUI9
fix(android): filter SO files by target ABI
- Add packaging.jniLibs.excludes to filter unwanted ABI SO files
- Fix build.dart to handle 'apk' platform when setting targetAbi
- Clear targetAbi from gradle.properties when not specified
提交：bcda51c | 作者：ONEUI9
fix(ci): remove --split-per-abi to avoid duplicate builds
提交：8b180aa | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.255
Mihomo 核心 1.19.19
📋 更新日志
自 v1.2.250 以来的功能和修复：
feat: WebSocket for connections and fix Android log monitoring
- Add WebSocket stream support for connections on desktop
- Fix Android log monitoring to start when core initializes
- Use ClashProvider for log page state instead of ClashManager
- Unify log monitoring management in ClashManager
提交：59ead88 | 作者：ONEUI9
feat(ui): responsive layout based on screen orientation
- Add ResponsiveSizing utility for width/height comparison
- Mobile: landscape shows sidebar, portrait shows bottom nav
- Rename MobileBottomNav to MobileNavBar
- Bottom nav: Home, Proxy, Subscriptions, More (menu)
- More menu: Settings, Connections, Logs
- Add common.more translation
提交：13a13ef | 作者：ONEUI9
chore(android): update adaptive icon foreground
提交：8669405 | 作者：ONEUI9
fix(ui): reduce dialog button height on mobile
Decrease vertical padding for mobile buttons and actions bar
提交：830d3f1 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.250
Mihomo 核心 1.19.19
📋 更新日志
自 v1.2.222 以来的功能和修复：
fix(android): use app-private external storage for logs
提交：5dead19 | 作者：ONEUI9
feat(ui): optimize proxy node layout for mobile
提交：2792526 | 作者：ONEUI9
fix(android): fix delay test with concurrent thread pool
提交：210d46d | 作者：ONEUI9
fix(android): fix config reload by passing config-path to setupConfig
提交：8aa4758 | 作者：ONEUI9
feat(android): add adaptive icon support
提交：51aa52d | 作者：ONEUI9
feat(android): add predictive back gesture support
- Enable predictive back in AndroidManifest
- Add handleBack method to ContentProvider for navigation
- Implement PopScope for proper back gesture handling on mobile
提交：b95603b | 作者：ONEUI9
feat(android): add memory monitoring and log optimization
- Add event-based core memory streaming for Android
- Parse memory events from core log stream
- Optimize log output by deduplicating event type messages
提交：04b0132 | 作者：ONEUI9
fix(android): resolve delay test, geodata path and platform detection
- Fix delay test always returning -1 by removing double JSON encoding
- Use ClashDefaults for test URL and timeout
- Fix geodata path using getApplicationSupportDirectory for mobile
- Fix platform detection for Android in app update check
- Use broadcast StreamController for multi-subscriber support
提交：daf023e | 作者：ONEUI9
feat(android): add JNI bridge with TLS and build optimization
- Add ndk-context initialization for Rust crates
- Initialize rustls-platform-verifier for reqwest 0.13 TLS support
- Enable minify and shrink resources for release builds
- Add proguard rules for JNI and system components
提交：e1c7a44 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.222
Mihomo 核心 1.19.19
📋 更新日志
自 v1.2.200 以来的功能和修复：
feat(android): add per-app VPN access control
提交：84c24e5 | 作者：ONEUI9
refactor: unify platform detection with PlatformHelper
提交：a744611 | 作者：ONEUI9
fix: fix layout overflow on mobile for setting cards and option selector
提交：725c5a7 | 作者：ONEUI9
refactor(dialog): add mobile responsive layout for modern dialog
- Hide left hint text on mobile
- Adjust font sizes, paddings, and icon sizes for mobile
- Apply responsive layout to sub-components
提交：9dc9473 | 作者：ONEUI9
refactor(subscription): remove switching indicator UI
移除订阅切换时的顶部提示条，保留切换功能逻辑
提交：0803923 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.200
Mihomo 核心 1.19.19
📋 更新日志
自 v1.2.171 以来的功能和修复：
fix(traffic): fix waveform chart stops updating after core restart
提交：42b69b3 | 作者：ONEUI9
refactor(config): use payload for reload and sync runtime config
提交：24b9cb7 | 作者：ONEUI9
fix(tun): fix UI state not refreshing after config changes
提交：3217a62 | 作者：ONEUI9
feat(tun): optimize TUN config defaults and UI
提交：63ba160 | 作者：ONEUI9
feat(android): adapt app behavior settings page for Android
提交：7431255 | 作者：ONEUI9
feat(android): Android VPN 模式与 JNI 核心桥接
- 新增 C++ JNI 桥接层与 Go 核心通信
- 新增 Kotlin VpnService 实现 Android VPN 模式
- 新增 JniCoreClient 替代 IPC 调用
- 新增 VpnService Dart 封装
提交：3761022 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.171
Mihomo 核心 1.19.19
📋 更新日志
自 v1.2.170 以来的功能和修复：
fix(config): apply http/socks ports to runtime config
提交：694f8d5 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.170
Mihomo 核心 1.19.19
📋 更新日志
自 v1.2.150 以来的功能和修复：
feat(ui): 設定頁面關於項添加 GitHub 連結圖標
提交：ad14acf | 作者：ONEUI9
fix(config): 應用日誌開關預設值改為啟用
提交：6a1dada | 作者：ONEUI9
feat(update): 便攜版更新檢測支援
- 打包腳本在 ZIP 便攜版中添加 data/.portable 標識文件
- 更新檢測服務檢測標識文件判斷是否為便攜版
- Rust 端根據便攜版標識匹配 ZIP 下載連結而非安裝包
- 所有匹配規則排除 debug 版本
提交：581d2ca | 作者：ONEUI9
chore(service): trim deps, avoid panics, bump to 1.5.2
提交：cfbaf1f | 作者：ONEUI9
fix(core): Sync log monitor state on log level change
提交：40ef7cb | 作者：ONEUI9
fix(i18n): Sync translation keys
- Add missing update_on_startup_label to zh_TW
- Remove unused hint keys
Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com
提交：59979ed | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.150
Mihomo 核心 1.19.19
提交哈希 15cf04c06c4a397de4cd5e8ba048cc833098df13
📋 更新日志
自 v1.2.102 以来的功能和修复：
fix(core): Fix JavaScript override parsing
提交：15cf04c | 作者：ONEUI9
refactor(core): Unify outbound mode switching entry point
提交：75634cf | 作者：ONEUI9
fix(ui): Stabilize home page top spacing
提交：8d5e2f8 | 作者：ONEUI9
style(ui): Adjust waveform chart maximum height
提交：0306d26 | 作者：ONEUI9
feat(core): Optimize delay testing and IPC connection pool
提交：77e3332 | 作者：ONEUI9
style(ui): Adjust traffic speed waveform display
提交：2a0233b | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.102
Mihomo 核心 1.19.19
提交哈希 a065f2e2b6510be3bdf64b682a6de757fe885f5e
📋 更新日志
自 v1.2.100 以来的功能和修复：
允许更小的窗口
⚠️ 警告：此次更新，应用的设置全部变更到应用所在目录的 data 文件夹，需要重新配置，当然你也可以手动从原私有目录复制到新版所需目录
提交：a065f2e | 作者：ONEUI9
调整卡片样式并适配暗色模式阴影
提交：8cfb6b8 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.100
Mihomo 核心 1.19.19
提交哈希 b5a094e930ea58f368ab7e6047bcb49420194364
📋 更新日志
自 v1.2.070 以来的功能和修复：
主页布局调整
提交：b5a094e | 作者：ONEUI9
桌面端发布版应用配置便携式
警告说明：此次更新，应用的设置全部变更到应用所在目录的 data 文件夹，需要重新配置，当然你也可以手动从原私有目录复制到新版所需目录
提交：40d0ac0 | 作者：ONEUI9
chore: normalize catch variable names
提交：f82b839 | 作者：ONEUI9
refactor: move viewmodels and improve backup/subscription handling
提交：294adba | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.070
Mihomo 核心 1.19.19
提交哈希 2461c1b446209c17fa3e15ae67a1699452f60132
📋 更新日志
自 v1.2.060 以来的功能和修复：
尝试修复特定设备中托盘未能正确销毁
提交：86230f3 | 作者：ONEUI9
Clash 配置注入器补充缺失配置
提交：526fc86 | 作者：ONEUI9
style(ui): 重做顶部按钮布局
- 顶部按钮改为圆角矩形
- 统一按钮组容器样式
提交：6bfa144 | 作者：ONEUI9
chore(rules): 移除顶部提供者按钮
提交：54b7ae8 | 作者：ONEUI9
非 IPC 繁忙的重试次数调整
提交：bf561a7 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.060
Mihomo 核心 1.19.19
提交哈希 9434ccaa1be52c25ef9e7b6e19829076affab672
📋 更新日志
自 v1.2.055 以来的功能和修复：
fix(delay-test): 修复批量延迟测试偶发失败
- 解决 Windows Release 下批量测速时偶发出现 -1 超时/结果错乱的问题
- 针对 Named Pipe 繁忙（os error 231）与 HTTP 503/504 做了更稳健的重试与读取处理
提交：25ae2a4 | 作者：ONEUI9
feat(rules): 添加规则页面
提交：5020513 | 作者：ONEUI9
chore(backup): 移除备份与还原提示对话框
提交：39e30d6 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.055
Mihomo 核心 1.19.19
提交哈希 2436be0515887268d14e645c4b6bfbe4fd0e60ab
📋 更新日志
自 v1.2.050 以来的功能和修复：
fix(system-proxy): 简化 PAC 脚本
提交：2436be0 | 作者：ONEUI9
feat(subscription): 添加二维码分享功能
提交：137b8b7 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.050
Mihomo 核心 1.19.18
提交哈希 3763dcf84e91aed129bab6c4fbab55f4c1821054
📋 更新日志
自 v1.2.039 以来的功能和修复：
feat(tray): copy terminal proxy commands
提交：6699800 | 作者：ONEUI9
refactor: 重构 hub 模块架构以符合分层规范
提交：990edda | 作者：ONEUI9
fix: 修复服务启动时 IPC 未就绪及卸载时连接异常
提交：39b004e | 作者：ONEUI9
fix: 修复连接页计时器不实时更新的问题
提交：160f6ac | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.039
Mihomo 核心 1.19.18
提交哈希 ef59f576b68f3c2129e1d69a96f3f4ebf15e82af
📋 更新日志
自 v1.2.030 以来的功能和修复：
chore: 优化冗余代码
提交：ef59f57 | 作者：ONEUI9
perf: 优化服务安装/卸载超时时间
提交：937ad68 | 作者：ONEUI9
fix: 修复 Windows 服务模式不工作的问题
提交：db856cb | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.030
Mihomo 核心 1.19.18
提交哈希 70040234b0f5aefd0f1197e8f40ecbf354252dde
📋 更新日志
自 v1.2.020 以来的功能和修复：
refactor: 优化核心状态管理
- 重命名方法以更准确反映功能
- 精简日志输出
提交：7004023 | 作者：ONEUI9
security: remove unreliable validation logic in service mode
提交：29fecf0 | 作者：ONEUI9
fix：修复日志页全部等级按钮切换后无法切回
提交：eaa71c9 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.020
Mihomo 核心 1.19.18
提交哈希 812f35ac45e390d874a847d51d49a98e24b6226b
📋 更新日志
自 v1.2.010 以来的功能和修复：
fix: 修复出站模式切换和 TUN 切换的状态同步问题
修复应用恢复后出站模式状态不一致的问题
修复 TUN 切换未同步状态的问题
修复提供者错误传递问题
提交：812f35a | 作者：ONEUI9
refactor: 精简冗余日志输出
提交：6bb6d8f | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.010
Mihomo 核心 1.19.18
提交哈希 b1d05bf32891c64ab28952693129abfb7417dfd8
📋 更新日志
自 v1.2.001 以来的功能和修复：
fix: 修复某些情况下 Windows 自启权限不足的问题
现在 windows 的自启总是以最高权限运行，这意味着 TUN 开机自启即为可用状态
提交：b1d05bf | 作者：ONEUI9
fix: 修复流量统计显示为 0 的问题
提交：73c9c63 | 作者：ONEUI9
refactor: 优化 Provider 状态管理与代码结构
提交：2c6ab50 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.2.001
Mihomo 核心 1.19.18
提交哈希 1b1c2e551c978dc90132b03746af1cb595a2a81b
📋 更新日志
自 v1.1.182 以来的功能和修复：
增强连接页和日志页日志输出并修复重启核心后的显示问题
- 版本号更新至 1.2.001
- 增强日志：显示原始连接数和过滤后连接数
- 修复：重启核心时重置搜索关键字和过滤级别，避免使用旧的过滤条件导致列表显示为空
- 连接页和日志页均已修复
提交：1b1c2e5 | 作者：ONEUI9
代码可读性调整与 TUN 加载机制回退，修复内存泄漏
- 简化 TUN 配置修改逻辑，移除自动重载机制
- 优化 dynamic_theme 和 basic UI 代码可读性
- 修复 ClashManager 和 OverrideProvider 的内存泄漏问题
提交：8235ee1 | 作者：ONEUI9
refactor: 变量命名风格调整
提交：aca5e67 | 作者：ONEUI9
refactor: 精简日志输出，修复权限检查竞态条件
提交：68af723 | 作者：ONEUI9
refactor: 架构重构，明确 Manager/Provider/Service/State 职能
- 进一步完善 Manager 层实现业务逻辑
- Provider 层统一通过 Manager 访问 Service
- Service 层纯技术实现，无业务逻辑
- State 层不可变数据类
提交：2110f9d | 作者：ONEUI9
refactor: 项目结构大型重构
提交：4597a1f | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.182
Mihomo 核心 1.19.18
提交哈希 91ef3590906b3dbd2e7637f7ed6687ecbae99e7d
📋 更新日志
自 v1.1.180 以来的功能和修复：
减小软件编译体积
提交：91ef359 | 作者：ONEUI9
feat: 订阅菜单分页与外部打开
提交：ebb718b | 作者：ONEUI9
fix(rust): 修复 Linux 平台编译错误
提交：5096d93 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.170
Mihomo 核心 1.19.18
提交哈希 e40b96a81d71fd77125e68a7d63e7e5b8953eaa5
📋 更新日志
自 v1.1.161 以来的功能和修复：
fix: 修复系统唤醒后核心停止的问题 (#28)
提交：e40b96a | 作者：ONEUI9
refactor(i18n): 规范化国际化键名并修复相关代码
提交：e9ba314 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.161
Mihomo 核心 1.19.18
提交哈希 1d9b66fdf12a3385de291b2cfdb0e06b1a6b154f
📋 更新日志
自 v1.1.160 以来的功能和修复：
feat: 优化竖向代理列表交互体验
- 整个卡片头部可点击展开/收起节点列表
- 添加搜索框支持筛选节点
- 版本号提升到 1.1.161
🤖 Generated with Claude Code
Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com
提交：1d9b66f | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.160
Mihomo 核心 1.19.18
提交哈希 80ae4d9428dc4d7ed63ee4b6c5b190817448298c
📋 更新日志
自 v1.1.152 以来的功能和修复：
feat: 实现事件驱动全局快捷键
提交：316c14e | 作者：ONEUI9
feat: 实现 Windows 休眠唤醒自动重载 TUN
提交：b64427d | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.152
Mihomo 核心 1.19.18
提交哈希 e767bd1b2cbe58bdb3bb9b889abbdb7dbc4b6865
📋 更新日志
自 v1.1.150 以来的功能和修复：
fix: 修复服务模式安装时核心进程未正确停止的问题
提交：e767bd1 | 作者：ONEUI9
fix: 修复服务版本号获取时终端窗口闪屏问题
Windows 平台使用 CREATE_NO_WINDOW 标志执行服务程序 version 命令，
避免进入系统集成页面时终端窗口短暂闪现。
提交：03489fb | 作者：ONEUI9
refactor: 变量名规范化
提交：2635db8 | 作者：ONEUI9
fix: 修复规则提供者同步后类型错误显示为代理提供者的问题
提交：bc2b7b7 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.150
Mihomo 核心 1.19.18
提交哈希 3cdb9ea086319a3fb7cba7b00f8793d5633768af
📋 更新日志
自 v1.1.146 以来的功能和修复：
fix: 修复服务卸载后核心重启失败的三层状态同步问题
- 服务安装/卸载时重置 CoreStateManager 和 ProcessService 状态
- 服务卸载后清理 Rust PROCESS_MANAGER 全局状态
提交：3cdb9ea | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.146
Mihomo 核心 1.19.18
提交哈希 0b758429561aedb3f7d182ea7f75754a55a0724a
📋 更新日志
自 v1.1.145 以来的功能和修复：
fix: 修复重启核心时代理组加载失败的问题
问题原因：
重启按钮调用 stop() 后再调用 start() 时未传递 configPath，
导致核心使用默认空配置启动，代理节点无法加载。
解决方案：
在 ClashProvider 中新增 restart() 方法，封装配置路径保存逻辑，
确保重启后使用原有配置文件。
提交：0b75842 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.145
Mihomo 核心 1.19.18
提交哈希 c333a8c7bbe327a758ffad3e7e540513c7f33cda
📋 更新日志
自 v1.1.140 以来的功能和修复：
布局修复
提交：c333a8c | 作者：ONEUI9
fix: DNS 覆写配置注入与变量命名规范化
- 添加 DNS 覆写字段到 RuntimeConfigParams（修复 #25）
- 重命名 http_port → mixed_port，准确反映 Clash mixed-port 语义
- 重命名 current_mode → enhanced_mode，与配置项名称一致
- 精简注释，移除冗余代码
提交：7d1731b | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.128
Mihomo 核心 1.19.18
提交哈希 56354c9ca6f968865acbffbcecfa208aaec9f413
📋 更新日志
自 v1.1.126 以来的功能和修复：
i18n: 移除日韩语支持，添加启动更新翻译键
- 移除日语和韩语翻译文件及生成代码
- 从语言切换器中移除日语和韩语选项
- 为所有保留语言添加 autoUpdateOnStartup 翻译键
- 移除 GitHub Actions 工作流中的依赖缓存机制
提交：56354c9 | 作者：ONEUI9
feat: 自动更新选项重构
- 启动时更新不再作为禁用更新的子选项，改为独立选项
- 统一使用 OptionSelectorWidget 组件
- 优化选项间距，根据选项数量动态调整
注意：本次更新后，如果之前配置了仅启动时更新，需要重新保存订阅配置
提交：dbe4685 | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.126
Mihomo 核心 1.19.18
提交哈希 42f312c07ab70d7ec1766bf7e191dba8cc119ddb
📋 更新日志
自 v1.1.125 以来的功能和修复：
修复连接详情对话框代理组和节点显示错误，更新 Linux 权限说明
提交：42f312c | 作者：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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.125
Mihomo 核心 1.19.18
提交哈希 f32cc31fe8daa1686802736073d2422293c91fb8
📋 更新日志
自 v1.1.120 以来的功能和修复：
修复订阅并发下载混淆问题并优化内存管理
提交：f32cc31 | 作者：ONEUI9
自适应行号间距
提交：ef7e00f | 作者：ONEUI9

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.120
Mihomo 核心 1.19.17
提交哈希 c22029857aacffd82cd7dfda2d2507df74341620
📋 更新日志
自 v1.1.111 以来的功能和修复：
fix: 修复问题订阅导致数据丢失的 bug - 原子写入 + 备份恢复机制防止数据丢失 - 失败订阅自动取消选中，回退默认配置 - 简化初始化逻辑，仅恢复上次选中的订阅
提交：c220298 | 作者：ONEUI9
fix: 修复 Inno Setup 安装程序无法正常关闭应用的问题
- 在 win32_window.cpp 中添加 WM_QUERYENDSESSION 和 WM_ENDSESSION 消息处理
- 响应 Windows RestartManager 的会话结束请求，允许安装程序快速关闭应用
- 优化 Inno Setup 脚本的进程检测和终止逻辑
- 移除调试日志输出，简化安装流程
提交：cd5f3cf | 作者：ONEUI9
添加动态行扩展和数值输入限制到输入字段
提交：f240eb2 | 作者：ONEUI9
统一外部控制器卡片 UI
提交：56a39ca | 作者：ONEUI9

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.111
Mihomo 核心 1.19.17
提交哈希 e56370e933c5007bfe64a1aa2cb7ecc3ffe84356
📋 更新日志
自 v1.1.100 以来的功能和修复：
バージョン 1.1.111 へ更新と UI の微調整
提交：e56370e | 作者：ONEUI9
ブール変数の命名規則を統一
提交：ba0a1a2 | 作者：ONEUI9
サブスクリプション一括更新後の設定リロード問題を修正
提交：d21e520 | 作者：ONEUI9
デスクトッププラットフォームの条件付きコンパイルサポートを追加
提交：208f495 | 作者：ONEUI9
プロキシノード UI を最適化
提交：a65a004 | 作者：ONEUI9
サブスクリプションカード更新時のグレーアウトを廃止
提交：ec2acac | 作者：ONEUI9

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.81
Mihomo 核心 1.19.17
提交哈希 0d0e1d62fbb9761c823c6f5dc408eea1bc93caad
📋 更新日志
自 v1.1.80 以来的功能和修复：
迁移订阅下载、备份还原、核心更新服务至 Rust 层，同时移除不使用的代码，希望这不会导致 bug
提交：0d0e1d6 | 作者：ONEUI9
fix: resolve InheritedWidget access in initState and update restore message
- Move _loadVersion() call from initState to didChangeDependencies to fix InheritedWidget access timing issue
- Remove "please restart app" from backup restore success message as it's no longer needed
- Update translations across all languages (zh_CN, zh_TW, en, ja, ko)
提交：a1888e0 | 作者：ONEUI9

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.80
Mihomo 核心 1.19.17
提交哈希 403690b727db7a562d25c7bcd9139c5f62fb58a5
📋 更新日志
自 v1.1.70 以来的功能和修复：
refactor: trigger startup update immediately after initialization
提交：403690b | 作者：ONEUI9
perf: cache displayName to avoid redundant calls
提交：8abfef5 | 作者：ONEUI9
feat: add multi-language support with LanguageProvider
提交：c07ca67 | 作者：ONEUI9
docs: add and refine i18n READMEs
- Add translations for Japanese, Korean, German, and French.
- Move all README files to .github/docs/.
- Update language switcher badges in all READMEs.
- Refine translations for better localization.
- Fix badge encoding issues for non-English languages.
- Remove changelog statistics from the build workflow.
提交：8a6b273 | 作者：ONEUI9
refactor: use trans variable for i18n text access
提交：0ca6787 | 作者：ONEUI9
fix: add i18n support for subscription proxy mode options
提交：761f4bd | 作者：ONEUI9
refactor: remove unused TunConfig class
提交：1a8c78c | 作者：ONEUI9
refactor: rename updateSystemProxy to restartSystemProxy
提交：11230d5 | 作者：ONEUI9
fix: sync state and restart core after backup restore
提交：a3b3ae5 | 作者：ONEUI9
refactor: unify boolean variable naming style
提交：421eb6f | 作者：ONEUI9
feat: optimize proxy latency test logic
提交：2b43780 | 作者：ONEUI9
feat: add proxy group icon support
提交：505a8d4 | 作者：ONEUI9
refactor: rename enableConfigReload to isConfigReloadEnabled
提交：290643b | 作者：ONEUI9
refactor: rename isPaused to isMonitoringPaused
提交：55c630f | 作者：ONEUI9
refactor: rename tunEnable to tunEnabled
提交：3f876db | 作者：ONEUI9
fix: clear subscription config failure flag correctly
提交：665b47b | 作者：ONEUI9
refactor: improve global variable naming clarity
提交：409dfd8 | 作者：ONEUI9

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.50
Mihomo 核心 1.19.17
提交哈希 91e5e27faeb204a1e721e547d6a171bd1026cffe
📋 更新日志
自 v1.1.30 以来的功能和修复：
统一配置访问路径：UI 组件通过 ClashManager 访问配置
将 UI 层的配置访问统一到 ClashManager，不再直接访问 ClashPreferences。
修改内容：
- 在 ClashManager 中添加 keepAliveEnabled 和 keepAliveInterval 获取器
- 更新 keep_alive_card.dart 使用 ClashManager 获取 TCP 保持活动配置
- 更新 port_settings_card.dart 使用 ClashManager 获取端口配置
- 更新 test_url_card.dart 使用 ClashManager 获取测试网址
- 更新 log_level_card.dart 使用 ClashManager 获取日志等级
- 移除所有这些文件中的 ClashPreferences 导入
提交：91e5e27 | 作者：ONEUI9

简化重启逻辑并修复外部控制器节点选中同步问题
提交：8c49488 | 作者：ONEUI9

修复代理组类型不支持切换时的警告传递问题
- 移除 changeProxy 中设置 errorMessage 的逻辑
- 使用 ModernToast 在 UI 层显示友好提示
- 添加 unsupportedGroupType 国际化文本
提交：cfdc33d | 作者：ONEUI9

优化现代特性卡片间距和布局
- 修复卡片双重 padding 导致高度增加的问题
- 移除卡片水波纹效果（splash/highlight）
- 更新间距常量命名：iconTextSpacing → featureIconToTextSpacing
- 新增 auxiliaryIconToControlSpacing 常量（辅助图标到控件间距）
- 统一所有卡片使用间距常量，移除硬编码值
- 为 Column 添加 mainAxisSize.min 避免不必要的垂直扩展
- 主题颜色选择器设置 padding 为 zero
提交：86a7f9b | 作者：ONEUI9

优化代理组选择器布局和常量命名规范
- 分离代理组间距常量：开头、中间、末尾独立控制
- 统一常量命名规范：按功能模块使用一致前缀（outer、scrollButton、group、tab、underline）
- 添加滚动按钮常驻圆角背景（透明度 0.3）及悬停加深效果（透明度 0.5）
- 在两个滚动按钮之间添加 8px 间距
- 移除父布局横向间距，由组件自身控制所有间距
提交：70aca50 | 作者：ONEUI9

修复代理组选择器滚动按钮状态更新问题并优化代码结构
修复了窗口大小改变时滚动按钮状态不及时更新的问题，通过结合 ScrollController.addListener 和 NotificationListener 实现双重监听机制。同时将所有魔法数字提取为命名常量，提高代码可维护性和可读性。
提交：19f45d0 | 作者：ONEUI9

feat: 实现订阅覆写独立排序和自动重载功能
- 添加 overrideSortPreference 字段存储覆写排序偏好
- 支持拖拽调整覆写顺序，即使不启用也能保存排序
- 覆写内容更新时自动重载使用该覆写的当前订阅
- 优化逻辑：仅在覆写启用状态变化或内容更新时重载配置
提交：54ea354 | 作者：ONEUI9

feat: 实现备份与还原功能并使用 Dart 3.0+ 语法优化 UI 组件
提交：47205d5 | 作者：ONEUI9

fix: 防止任务栏关闭窗口直接杀死进程
提交：7eb401d | 作者：ONEUI9

refactor: 统一删除确认对话框并支持危险按钮样式
提交：d92d8a5 | 作者：ONEUI9

fix: 改善 JSON 文件可读性，使用格式化输出
提交：94b95bb | 作者：ONEUI9

feat: 优化订阅对话框 UA 输入框，使用 placeholder 显示默认值
提交：36da82f | 作者：ONEUI9

统计信息
- 📊 总提交数：12
- ✅ 功能/修复提交：12
- 🔧 CI/维护提交：0 (已过滤)

❓ 故障排查
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++ 运行库合集

📦 构建信息
项目 内容
包名 stelliberty
版本号 1.1.30
Mihomo 核心 1.19.17
提交哈希 27bc22702806554188f88d8fe75f6b7f3feef108
📋 更新日志
自 v1.1.21 以来的功能和修复：
优化滚动条显示和间距
提交：1da645f | 作者：ONEUI9

refactor: 优化翻译和 DNS 配置
提交：619b761 | 作者：ONEUI9

format request
提交：0a0ae7a | 作者：ONEUI9

refactor: unify scrollbar style and improve log display
- Add explicit Scrollbar to proxy page, override page, and home page
- Ensures consistent scrollbar appearance across all pages
- Reverse log display order (newest at top)
- Remove auto-scroll logic from log page
- Add multi-size icons for different UI contexts
提交：eb78cd3 | 作者：ONEUI9

fix: apply consistent scrollbar spacing across all pages
- Add missing scrollbar padding to connection page
- Replace hardcoded spacing (3.0px) with SpacingConstants.scrollbarPadding in proxy page
- Ensure all pages follow the unified spacing standard (1.0px right padding)
提交：eb9086b | 作者：ONEUI9

refactor: migrate User-Agent from global to per-subscription settings
- Add userAgent field to Subscription model with default value from ClashDefaults
- Each subscription can now customize its User-Agent independently
- Override downloads use global default User-Agent (ClashDefaults.defaultUserAgent)
- Remove global User-Agent settings UI (UserAgentCard)
- Optimize performance by caching default UA in subscription dialog
- Improve code clarity with guard clauses in subscription provider
- Simplify preferences by removing UA persistence logic
- Fix input field icon size across all dialogs
提交：f2f69bf | 作者：ONEUI9

refactor: remove dead code and improve type safety
- Remove redundant YamlList check in config_parser.dart (already covered
by List check)
- Replace if-else chain with switch expression in theme_selector.dart for
sealed class ThemeColorOption, ensuring exhaustive handling and better
type safety
This eliminates all dead code warnings from dart analyzer.
提交：27eedda | 作者：ONEUI9

fix: correct scrollbar spacing compensation across all pages
- Add Scrollbar with ScrollController to connection_page.dart and
subscription_page.dart to match spacing compensation usage
- Fix incorrect padding in all settings pages (8 files):
Changed from EdgeInsets.symmetric (which applied compensation to both
left and right) to EdgeInsets.fromLTRB (only right side compensated)
Before: left=31px, right=31px (incorrect)
After: left=32px, right=31px (correct)
This ensures consistent scrollbar spacing using SpacingConstants across
all pages that have scrollable content.
提交：8a22b57 | 作者：ONEUI9

refactor: remove unused ClashConfig class
提交：afef435 | 作者：ONEUI9

refactor: improve code clarity and fix UI flickering
- Rename variables for better readability:
- isRunning → isCoreRunning
- isLoading → isLoadingProxies
- isBatchTesting → isBatchTestingDelay
- mode → outboundMode
- currentMode → currentOutboundMode
- _selectedMode → _selectedOutboundMode
- Fix home card flickering by using Selector to prevent rebuilds
when unrelated state changes (e.g., isLoadingProxies)
- ProxySwitchCard, ClashInfoCard, OutboundModeCard
- TrafficStatsCard, TunModeCard, ProxyPage
- Merge setMode and setModeOffline into single setOutboundMode
that auto-detects core running state
- Remove duplicate tray menu update calls in ProxySwitchCard
- Reduce verbose logging in proxy enable request
提交：0c91948 | 作者：ONEUI9

统计信息
- 📊 总提交数：12
- ✅ 功能/修复提交：10
- 🔧 CI/维护提交：2 (已过滤)

❓ 故障排查
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++ 运行库。

📦 构建信息
项目 内容
包名 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++ 运行库合集