从清楚了解开始。
Serylane 是管理你已有订阅与配置的独立桌面客户端，不提供代理节点或订阅服务。
v0.7.27：路由双入口与紧凑配置
顶部全局「路由」和页内「开启／关闭路由」共享状态与操作锁。页面保留刷新状态，工具域名按需展开；草稿保存和确认应用仍分开，不切换系统代理／TUN，不新增 Codex 接入。下载版本以正式安装包为准。
v0.7.25：路由与交互更新
路由使用常见 AI 工具预置与自定义域名，统一校验、去重和应用，不新增 Codex 接入。程序代理与增强稳定灾备暂时隐藏并关闭，保留基础 Fallback 与预算限制。订阅卡片支持右键或更多菜单编辑信息；保存不改变选用状态，新地址手动刷新。节点详情关闭后丢弃迟到结果，按钮选中悬浮保持清晰。
下面带版本号的章节记录旧版能力，涉及程序代理和增强稳定策略的操作暂不适用于 v0.7.25；其他平台限制不变。
快速开始
- 前往下载区域，选择系统与处理器架构，默认从下载中心获取对应安装包，GitHub 为同版本公开备用。Gitee 当前受平台公开限制，请使用下载中心或 GitHub。以正式发布页实际附件为准；没有对应附件时，不要下载其他架构的包代替。
- 根据对应版本的发布说明核对功能和平台要求；源码中的功能不代表已经进入当前安装包。
- 打开客户端，通过「订阅 → ＋ 添加订阅」添加自己的 Clash Meta / Mihomo YAML 订阅；本地 YAML 请在「配置」页面导入。订阅地址通常包含访问凭据，不要公开分享。
- 已有当前配置时，添加订阅默认不选用；只有勾选「添加后选用」才会替换当前配置。添加或选用不会自动启动代理，需要连接时再点击「启动」。使用系统代理或 TUN 前，先关闭其他代理客户端的同类接管功能，避免相互覆盖。
- AI 工具域名路由是可选功能，不是日常代理使用的前置条件。没有需要时，保持默认关闭即可。
统一下载入口
应用下载默认使用下载中心项目页。固定入口自动跟随已核验的正式发行，历史文件保留独立版本地址。下载中心连接异常时，可回到官网选择 GitHub 备用。客户端自动更新的实际渠道以已安装版本为准。v0.7.22 起，桌面更新设置和状态提示统一使用“下载中心”；自动模式同版本依次使用下载中心、Gitee、GitHub，原有渠道偏好与签名校验保持不变。Gitee 当前公开访问受限，自动模式会按同版本候选继续尝试；固定选择 Gitee 时请切换为自动或 GitHub。
选择 Mac 芯片版本
macOS 安装包分为 Intel 芯片（x64） 与 Apple 芯片（M 系列，ARM64）。打开苹果菜单 →「关于本机」：显示 Intel 处理器时选 Intel 版；显示 Apple M 系列芯片时选 Apple 芯片版。不要仅凭 macOS 版本或机型年份猜测。
下载最新 Intel 芯片版 · 下载最新 Apple 芯片（M 系列）版。每次点击都会重新核对最新正式版；国内没有对应包时转到 GitHub 同版本包，不以另一种芯片的包代替。
v0.7.20：订阅进度、取消与稳定性
「订阅下载路径」仅影响本页手动添加与更新：默认跟随 Serylane，核心未运行时明确直连；也可选择直连或已运行的本地 HTTP 代理端口。不自动启动核心，不改系统代理，不扫描其他软件；代理失败不静默改走直连。后台用量检查仍跟随核心状态。
连接、完整下载、内容检查、等待配置操作、Mihomo 校验与保存分别显示。正文中断、限流和选定临时服务错误有限重试，遵循总预算与 Retry-After；格式错误与规则资源缺失分别说明。
保存开始前可取消；取消校验会结束子进程并清理临时文件。进入保存事务后等待结果，不中断半份提交。添加失败保留草稿和原有配置，成功后的列表读取失败不会被误报为添加失败。日志仅记录任务编号及固定阶段/路径/计数，不记录订阅链接与原始正文。继续保留紧凑卡片。
本轮不包含 TUN 修复或 Codex 路由接入；安装包以正式发行记录为准。macOS 兼容包的签名和 TUN 边界见对应发布说明。
v0.7.24：下载、安装与路由名单
官网下载时重新核对包身份，显示本次实际来源。客户端同时显示当前来源、网络路径、备用源尝试和安装阶段。网页只确认交给浏览器，不把它写成下载完成。
安装先检查空间、目录权限和服务记录，再停止代理。macOS 增加旧应用备份及失败回退；可选 TUN 服务待恢复不再成为后续更新锁。旧客户端若已被旧记录阻断，首次使用完整安装包替换原位置应用；新版保留原服务意图，不需要删除用户配置。Developer ID、公证与 TUN 支持边界不变。
系统代理兼容性检查仅 Windows 展示，其他平台代理能力不变。路由页可编辑 HTTPS URL 名单，不接管系统流量、不修改其他代理模式，也不自动接入 Codex。实际可下载版本以正式发行结果为准。
v0.7.23：一键测试、双节点与真实选用高亮
自选节点页点击“测试全部”，检查当前配置策略组中的实际节点，包含已加载提供器；嵌套组防环去重，排除 DIRECT、REJECT 等伪节点。显示可用、超时、失败、暂未测得与未测试，可停止和重试。最多 4 个并发、单节点 5 秒探测、整轮 15 分钟、最多 1,000 个实际节点；超限提示拆分，不静默截断。
切换配置、模式或核心重启时旧结果失效。测试不自动启动核心，不主动改选出口；自动组仍按原策略运行。基础连通性不等于带宽、AI 登录或模型验证。
AI 代理支持 2–10 个合格节点，两个即可一主一备；展示提取、地区、预算、探测和入选数量。保留硬性资格与质量要求，相对排名不再淘汰唯一合格备份。AI 筛选仍要求显式 proxies，只有 proxy-providers 的配置可在自选页使用。
订阅蓝色高亮只跟随实际选用项；添加但未选用、导入定位和键盘焦点不改变高亮。活动本地 YAML 时不高亮远程订阅。本轮不调整 TUN 或 Codex 接入；实际安装包以下载中心发行结果为准。
v0.7.19：订阅与自选节点
安装包可用性以下载中心的正式发行记录为准。本轮精简订阅卡片：名称、用量、到期和更新时间集中展示，更多操作按需展开，刷新失败仍直接显示；配置档案中的订阅同步更新，本地 YAML 独立保留。
核心已运行时，订阅下载和用量检查复用 Serylane 本地代理端口，不为下载自动启动核心。瞬时失败有限重试，HTTPS 校验与总等待上限保持；不同错误提供对应操作说明。
「自选节点」按订阅原策略组选点，支持搜索、延迟排序与测速，以及规则／全局／直连模式。与「AI 代理」二选一，自选模式保留订阅和用户分流规则；切换需确认，失败保留原配置。AI 专用分流在规则模式参与；Codex 路由接入独立，不受互斥切换影响。选点不自动开启系统代理或 TUN。
支持删除当前和最后一个订阅。当前配置删除前确认停止代理及恢复本应用接管的系统设置，不自动选用其他订阅。没有配置时仍可添加订阅或导入 YAML，本地原始文件不受影响。macOS 本轮为兼容包，TUN 所需 Developer ID 与公证另行推进。
理解订阅用量
订阅卡片展示服务商返回的上传、下载、总套餐流量与到期信息。这些数据是订阅响应中的采样，不是客户端实时统计的账单。
未提供的字段会明确标注。刷新失败时，客户端可能保留上一次成功采样；请同时留意更新时间与错误说明。缺失数据不等于零用量、无限套餐或永久有效。
选择适合的代理方式
- 系统代理：供遵循系统代理设置的应用使用，不保证覆盖全部程序与连接协议。
- 程序代理：为支持代理参数或环境变量的应用提供启动入口。不会强制关闭已有实例；旧实例可能忽略新启动参数，需要你方便时自行退出再启动。
- 本地路由：仅对支持的 Codex 模型 API 提供独立入口，不代表接管整个 Codex 应用，也不保证登录、遥测或其他连接统一走该入口。
v0.7.17：TUN 启动与平台兼容
修复“预检完成却没有启动”的中断：权限和配置检查通过后，继续执行模式切换、启动和验收。预检通过不等于已接管网络；失败会保留具体阶段，切换后失败会尝试恢复原模式，并说明恢复结果。
macOS：首次使用需安装并在系统设置批准辅助服务。本版辅助服务协议更新为 v2；旧服务显示“需要更新”时，先停止代理，再在设置中主动更新辅助服务，并按提示核对系统授权。正在检查不表示授权丢失，短暂连接异常不会自动重新安装。Windows：继续使用管理员会话，不调用 macOS Helper，TUN 仍为实验性。Linux：目前未实现 TUN 网络接管，相关入口置灰；应用快选、程序代理与 TUN 是独立能力。
应用日志区分预检、配置校验及启动，不记录订阅正文或凭据。跨平台自动化不等于真实路由、DNS、休眠唤醒和长期网络验收。本节描述 v0.7.17 源码行为，安装包以实际发布版本为准。
Windows TUN：实验性功能
目前不将 Windows TUN 描述为已完成日常网络接管验收。管理员会话与内核进程生命周期已实现，但真实路由、DNS、停止和异常退出后的网络恢复仍需独立验收。
需要试用时，先保存工作并阅读当前版本发布说明。Windows 使用管理员会话：从托盘退出客户端后，自行选择「以管理员身份运行」。普通系统代理不要求管理员会话。
停止或退出时，客户端会按自身状态尝试恢复网络设置；关闭主窗口通常只是隐藏到托盘。系统代理恢复会核对控制权，避免覆盖后来由其他客户端设置的代理。不要同时开启多个客户端的系统代理或 TUN。
如果恢复失败，不要反复切换多个接管工具。先记录当前错误与状态，停止相关接管，再核对系统代理和 DNS 设置。遇到不明确的网络状态时，保留日志并通过项目问题追踪反馈，分享前删除订阅链接、令牌和个人信息。
0.7.7 起：启动恢复与应用日志
主「启动」按钮使用当前保存的网络模式，不再强制切换为系统代理。「登录时启动」「开机静默启动」和「恢复上次运行状态」分别设置；静默仅影响登录自动启动，手动打开仍显示主窗口。恢复沿用保存的配置和代理方式，遇到权限不足或其他代理占用时暂停，不会自动提权或强行接管。
旧版没有保存运行意图时，首次升级保持停止。在新版成功启动一次后，后续登录才有明确的恢复依据。在任务管理器中禁用的自启动项不会仅因迁移或调整静默选项而重新启用。
「日志」中的应用日志默认保留 3 天，可在设置改为 1–90 天。采用有容量上限的紧凑存储并合并重复事件，查看时格式化展示；达到容量上限时可能提前移除最旧记录。日志不记录对话正文、订阅凭据或请求头。
v0.7.8：启动模式与状态保持
设置提供三种明确的启动模式：不随系统启动、登录后后台恢复上次状态、登录后打开窗口并恢复。上次开启则恢复原模式和配置，上次停止则保持停止；关闭主窗口只是隐藏，托盘退出保留原启停记录。
系统登录项核对区分登记、禁用和未知状态。临时网络故障采用退避等待，用户停止可取消等待或清除已暂停恢复的开启记录；权限和代理所有权冲突不自动接管。
macOS 双行速率托盘的正常字体和备用路径均从应用同一份 S 图标生成，不再显示旧 M；菜单栏图形采用系统模板着色。对应功能随 v0.7.8 安装包交付，当前可用版本以下载区实时核对结果为准。
v0.7.9：更清晰的 macOS 双行网速
保留应用同源 S 图标，右侧上下行数字改用原生双行文字。等宽数字、独立的数值与单位列、固定宽度，让速率变化时更容易扫读，旁边的菜单栏图标不再随位数伸缩。
数字使用 9.5pt Medium 字号，箭头与单位较小；根据实际按钮高度完整排布两行，跟随系统亮暗外观。菜单栏紧凑显示 K/M/G 等单位，悬停查看 KiB/s、MiB/s 等完整速率。关闭流量显示后恢复纯 S 图标，重新开启恢复双行。
此改进仅调整 macOS 显示，不修改启动模式、代理或路由设置。对应功能随 v0.7.9 安装包交付，当前可用版本仍以下载区实时核对结果为准。
v0.7.16：三平台应用快选与更新跟随
「程序代理」从已安装应用清单搜索选择，保留普通文件入口。Windows 以 MSIX / Store 包系列和应用 ID 绑定；macOS 选择完整 .app，以 Bundle ID、原选位置和可用签名身份绑定；Linux 读取 XDG .desktop，按 Desktop File ID 和来源关联。正常更新后重新解析，不凭最高版本目录替换应用，也不负责下载或安装更新。
缓存清单立即可搜索，后台单次刷新不锁编辑、不丢草稿与焦点；普通打开复用 30 秒缓存，「重新扫描」主动强刷。失败保留旧清单并显示状态；点击启动仍重新核对身份和入口，展示缓存不作为启动依据。
macOS 使用 NSWorkspace 原生启动新实例并传入代理环境和参数；已有实例请先自行退出。GUI 使用系统原生工作目录，旧自定义目录保留，需明确选择默认目录后保存；未签名或 ad-hoc 应用移动后需重新关联。Linux 普通入口按 Exec 独立参数和 Path 启动，支持手选可执行文件或 AppImage；D-Bus、Terminal、Flatpak/Snap 及包装启动器显示「启动方式待适配」。Windows 普通 .exe 及现有代理参数保持兼容。
清单升级 v3 前保留旧 v1/v2 原始备份。未安装、读取失败、需要重新关联、已有实例及启动结果待确认分别说明下一步。保存不启动应用，不切换系统代理／TUN或改全局环境。启动成功不等于所有流量已走代理，真实应用登录和长会话另行验证。实际发行版本以下载区为准；详细说明与迁移。
v0.7.11：更快开启，更清楚地了解状态
系统代理在本地接管完成后即可使用，网络检查随后在后台执行。界面分别显示代理已开启、正在检查和部分检测未通过；OpenAI 接口可达不等于模型会话已验证。
已运行的本地端口模式与系统代理模式之间切换时，不主动重启核心。配置、端口、系统设置读回及失败恢复仍保留；TUN 继续走完整权限流程。错误提示提供下一步操作与技术详情，不再只有一长串错误码。
以上功能随 v0.7.11 安装包交付，下载区查询实际公开版本。真实网络、登录和重启另行验收。
v0.7.10：静默启动与自主选点
修正旧设置没有静默字段时仍弹出主页的问题。新设置和缺失该字段的旧设置默认登录后仅在托盘运行，不需要先保存一次设置；明确选择“打开窗口”的偏好保持不变。重复自启动不唤起主页，主动点击托盘或打开应用才显示窗口。需开启登录启动；代理仍按已保存的启停状态与原模式恢复。
v0.7.10 首次支持普通节点和 OpenAI 灾备候选手动选择；v0.7.19 起分别位于「自选节点」和「AI 代理」，两种方式互斥。概览显示实际选用节点与脱敏详情。手动固定 OpenAI 节点后自动切换暂停，可明确恢复自动；选点不主动关闭既有连接。
“成本与性价比”支持按服务商信息填写流量倍率、设置上限，并在质量接近时优选低倍率节点。未知倍率默认不参与；无符合预算的健康节点时拒绝后续新请求。手动固定仍优先，未知或超预算选择需要确认。省流筛选跳过大流量带宽测试，但基础探测仍耗流量；实际计费以服务商为准。
以上能力随 v0.7.10 安装包交付，请先在下载区核对实际发布版本。真实登录/重启及模型流稳定性不以合成界面或单元测试代替验收。
版本与开源说明
完整功能、平台限制和升级注意事项，以对应版本的发布说明为准。应用源码采用 GPL-3.0-only，第三方依赖沿用各自许可证。
这是独立项目，非 Mihomo、Clash 或 OpenAI 官方产品。Serylane 不承诺特定服务可达、节点稳定或已断开的数据流能够无缝续接。