正式版 · 9 个分支
日常使用走这条
分支稳定、说明齐全，适合办公、门店、售后等需要长期稳定运行的场景。每个分支的条目都写明适用版本范围与最后校对日期。
- 适合新装与长期使用
- 条目齐全，问题描述有对应处理方向
- 遇到异常可直接进排障教程按步骤走
01 · 版本选择
先定版本，再动手装
客户端分成两条线：一条是天天用的正式版，一条是提前观察下一版的升级分支。两条线的安装包和说明分开存放，开头分清楚，能省掉后面大半的排查时间。
升级观察 · 4 个分支
想提前看变化走这条
面向愿意提前试用下一版、并把问题反馈回来的用户。分支说明偏观察向，会写清这一版相对上一版动了什么。
- 适合测试机与备用设备
- 切换前后版本、问题现象、复现步骤都可提交
- 反馈内容会进入版本观察专题
02 · 资料库条目
每条记录长什么样
正式版优乐在线资料库按环境适配清单组织，一条记录对应一个环境，字段固定四格，方便你从系统版本一路对到状态标签。
- 环境编号
- 桌面 D1–D6、移动 M1–M6，与页面下方清单一一对应
- 系统版本
- Windows、macOS、Android、iOS 各自的版本区间
- 客户端版本
- 该环境适用的客户端版本，跨版本时分行列出
- 状态标签
- 通过、待复核、不适用三种，含义在状态说明里展开
- 140+累计版本记录
- 2019开始整理至今
- 2每月例行校对次数
- 18团队规模
版本观察 7 人、资料校对 6 人、用户支持 5 人分工推进。版本切换窗口会额外增加一次专项复核，所以切换期前后条目变动会比平时密。新分支上线与旧分支收尾，都会在观察报告里留一篇专题。
03 · 桌面端 D1–D6
桌面 6 项：装完先比这六条
Windows 与 macOS 共用一份清单，六项各自独立。哪一项对不上就停在哪一项处理，不用整包卸载重装。
D1 分辨率 通过
可用宽度从 1366 像素起，1920×1080 及以上窗口排布最舒展，侧栏、主区、状态列能同时展开。多屏或超宽屏用户顺手看一眼 D2 的缩放比例。
D2 缩放比例 通过
系统缩放留在 100%–125% 时布局正常。设到 150% 以上，部分面板按钮会换行，这时把客户端窗口拉宽或收窄侧栏即可，不需要改系统设置。
D3 浏览器内核 待复核
客户端内嵌页面依赖系统 WebView 内核。系统长期未更新时内核偏旧，个别页面可能停在空白。先更新系统组件再看本条，更新后仍异常就带上内核版本联系我们。
D4 系统版本 通过
Windows 10 及以上、macOS 12 及以上在条目中已有对应记录。更早的系统仍可安装，但需要先看该分支说明里的遗留项，部分新界面元素不会显示。
D5 显卡渲染 待复核
双显卡笔记本在切换显卡时可能出现短暂黑屏或画面撕裂。把客户端加入独显白名单，或在设置里关掉硬件加速后重启，多数情况会恢复。
D6 网络代理 不适用
直连网络下这一项跳过即可，不影响登录。走代理或 VPN 的用户，先确认出口策略允许客户端端口，再进入客户端，避免会话被中途切断。
04 · 移动端 M1–M6
移动 6 项：屏幕、系统、权限各有讲究
Android 与 iOS 走同一套六项。移动端的问题大多集中在权限与缓存两处，先看这两行往往最快见效。
M1 屏幕尺寸 通过
5.5 至 7.0 英寸区间布局正常，列表与详情页都能完整显示。折叠屏展开后按平板宽度重排，左侧导航会自动收起。
M2 系统版本 通过
Android 9 及以上、iOS 14 及以上已有对应条目。系统版本偏低时客户端仍可打开，但通知与后台刷新会受系统限制。
M3 客户端版本 待复核
同一台设备上不同客户端版本的表现差异明显。装完先看设置里的版本号是否落在条目范围内，落在范围外先升级，再判断其他五项。
M4 网络制式 通过
4G、5G 与 Wi-Fi 下登录流程一致。移动网络与 Wi-Fi 之间切换时，页面会重新拉取一次会话，短暂等待属正常现象。
M5 缓存状态 通过
长期未清理的设备建议先清一次缓存。页面停在加载中、头像不刷新这类情况，清缓存后大多能直接恢复，不必重装。
M6 权限设置 待复核
存储权限被系统回收后，客户端写不进缓存，表现为每次打开都要重新登录。把存储与网络权限设为允许，再重启客户端。
05 · 状态怎么读
三种状态，对应三种动作
从左栏先选一个系统，页面会带你到对应清单；再按客户端版本挑行，最后看状态点决定做什么。三种状态的用法差别很大，别混着看。
通过
该环境下的表现与说明一致，可以直接安装使用。装完仍建议把 D1、M5 这类基础项快速过一眼。
待复核
条目近期有变动，或结论依赖系统组件更新。装之前先展开读一遍说明，按提示处理后再判断。
不适用
该场景下不需要配置此项，跳过即可，不影响其他条目的结论。例如直连网络下的代理项。
06 · 装完自查
安装完成后的两步
安装包跑完不代表结束。先花两分钟确认网络与缓存，能挡掉大部分“装完打不开”的情况。
-
01
先看网络
确认设备已连上可用的网络，代理或 VPN 场景下检查出口是否放行客户端端口。企业内网环境建议先联系网络管理员确认策略。
-
02
再看缓存
桌面端清理客户端缓存目录，移动端在系统设置里清缓存。清理后重启客户端再登录一次，看是否还停在原地。
两步做完仍有异常，按现象对照处理步骤继续往下走，登录异常与主页打不开都有独立的排查页。
进排障教程07 · 更新与订阅
什么时候会变，变在哪
收藏与订阅的更新时间统一标注为 4 月第 2 周。版本切换窗口前后条目变动最密，其余时间以例行校对为主。
更新时间
4 月第 2 周
每个版本阶段会出一批专题：迭代记录讲这一版改了什么，环境变化讲系统升级带来的影响，故障复盘讲一次具体问题的处理过程。每月发布 4 至 6 篇，切换窗口会集中一些。