icyliveX 使用教程说明书

截图说明：账号登录页使用 Android 虚拟机运行截图；冰云键、控件池、小窗和手势页面使用基于当前源码功能绘制的教学示意图，用来讲清操作位置和手势逻辑。

1. 先认识 icyliveX

icyliveX 当前主要面向 Android 手机使用。普通用户最常接触三个入口：冰云键、冰云控件池、权限中心。冰云键负责底部悬浮入口和弹窗；冰云控件池决定弹窗里有哪些控制页；权限中心负责把系统授权补齐。

你看到的名称	它是做什么的	什么时候用
冰云键	底部冰云条、通知弹窗、小窗、随心记、外观设置	日常操作入口，开关和体验设置都在这里
冰云控件池	音乐、音量、设备、最近任务、空白面板、第三方面板	想调整弹窗里显示什么、顺序怎么排时使用
权限中心	悬浮窗、通知监听、麦克风、使用情况访问、电池优化等	首次安装、功能没反应、换手机后优先检查
个人中心	会员、账号、日志上传、版本检查、退出登录	账号状态异常或要检查版本时使用

2. 手势总览

冰云键的操作核心都围绕底部冰云条。记住下面这张速查图，再看后面的详细步骤会更容易。

手势	在哪里做	结果	容易误解的点
点按	底部冰云条	打开冰云面板；面板已打开时收起	如果正在随心记录音，点按会结束并保存当前内容
上滑	底部冰云条	展开冰云面板	适合单手从底部直接呼出
左右滑	冰云控件面板内容区	切换音乐、音量、设备、最近任务等控件页	左右滑的是面板，不是底部系统返回手势
向下快速拖动	已展开的冰云面板	收起回到底部冰云条	慢慢拖一点可能不会收起，要有明显下拉动作
长按	底部冰云条	进入小窗选择或随心记	配置了小窗时会先出现小窗选择环
长按拖动	冰云控件池里的控件卡片	调整控件顺序	要按住卡片本体，卡片浮起后再上下拖

3. 安装、登录与会员

序号	操作
1	安装 APK 后打开 icyliveX。
2	在账号验证页选择“登录”“注册”或“重置密码”。
3	登录或注册前，打开“我已阅读并同意服务条款”开关。
4	登录成功后等待会员校验。会员有效时进入主界面；未通过时会停留在会员校验流程。
5	进入主界面后，点左上角个人图标可以刷新账号状态、查看会员等级、检查版本或退出登录。

功能	操作路径	说明
登录	账号验证 -> 登录	输入邮箱和密码，密码至少 8 位，同意条款后继续。
注册	账号验证 -> 注册	输入邮箱、显示名称、密码和确认密码。
重置密码	账号验证 -> 重置密码	输入邮箱、验证码、新密码和确认密码。
个人中心	主界面左上角头像	查看会员、Log 上传、版本信息；LOG 会员必须上传日志，FULL 会员可关闭。

4. 首次使用必须补齐的权限

很多“点了没反应”的问题不是功能坏了，而是 Android 系统没有给权限。首次安装建议先进入权限中心，把下面几项按顺序处理。

权限	影响的功能	没开时的表现
悬浮窗权限	底部冰云条、通知弹窗、冰云控件	底部条不显示，弹窗无法覆盖到其他 App 上
通知监听权限	读取通知并生成瞬时弹窗	收不到通知弹窗，通知列表为空
麦克风权限	冰云随心记语音记录	长按后提示需要麦克风，或无法开始录音
使用情况访问	最近任务面板	最近任务为空或无法读取应用
电池优化白名单	后台监听服务	过一段时间后冰云键消失、通知不再弹出
应用列表读取	小窗选择、应用过滤、快捷应用	应用列表为空、无法选择小窗应用

大众用户建议：如果你不确定问题出在哪里，先去权限中心看有没有未通过项，再重启一次 icyliveX。悬浮窗、通知监听和电池优化是最常见的三个问题点。

5. 冰云键设置逐项说明

设置项	怎么操作	打开后的效果	什么时候建议关闭
启用冰云键	打开或关闭总开关	显示底部冰云条，可点按、上滑、长按	临时不想使用任何悬浮功能时关闭
启用瞬时弹窗	打开开关；点“选择”可指定应用	新通知到来时出现短时预览卡片	通知太多、游戏时被打扰时关闭
冰云随心记	打开开关；允许麦克风权限	长按底部条可语音记录内容	不需要语音记录时关闭
冰云小窗	打开开关；点“选择”勾选 1-5 个 App	长按底部条后可快速打开常用 App 小窗	手机系统不支持小窗或误触时关闭
横屏只显示系统控制	横屏场景打开	横屏时减少消息弹窗干扰，只保留系统控制体验	横屏也想看消息通知时关闭
仅指定应用显示消息通知	打开开关；点“选择”勾选 App	只有选中的 App 通知会进入冰云弹窗	想接收所有 App 通知时关闭
冰云键外观设置	点击进入二级页面	配置卡片样式、容器样式、动画和底部条颜色	这是配置入口，不是开关

6. 打开和使用冰云控件面板

序号	操作
1	确认“启用冰云键”已经打开，屏幕底部能看到冰云条。
2	点按底部冰云条，或从底部冰云条向上滑动，打开冰云控件面板。
3	如果当前有通知，面板会优先显示通知；如果没有通知，通常显示冰云控件页。
4	在面板内容区左右滑动，切换音乐、音量、设备、最近任务、空白面板、第三方面板等页面。
5	想关闭面板时，点按底部冰云条，或在面板上向下快速拖动。

页面	用户怎么用	注意事项
通知页	点通知卡片打开来源应用；通知堆叠可上下滑动切换当前通知	如果开了应用过滤，未勾选 App 的通知不会出现
音乐页	播放/暂停、上一首、下一首、音量和部分歌词/封面展示	音乐 App 必须有正在播放或最近播放的媒体会话
冰云控件页	左右滑动切换不同控件页，点击按钮或滑杆执行操作	控件页来自“冰云控件池”的启用项和排序
第三方面板	使用第三方 App 注册的按钮、开关、滑杆、分段按钮	真实控制结果由第三方 App 负责

7. 冰云小窗：配置、唤起和选择逻辑

冰云小窗用于快速打开常用 App。它的关键是：先配置应用，长按底部冰云条出现选择环，再通过左右倾斜手机选择图标，松手打开。

7.1 配置小窗应用

序号	操作
1	进入“冰云键”。
2	打开“冰云小窗”开关。
3	点击右侧“选择”。
4	在应用列表中搜索或勾选常用 App。当前最多保存 5 个。
5	点击完成后返回主界面。

7.2 长按选择逻辑

你的动作	系统反应	下一步
长按底部冰云条约半秒	出现一圈小窗应用图标	手不要立刻松开
手机保持不动	暂时没有高亮选择，继续等待可转入随心记	如果想打开小窗，需要轻轻倾斜
向左或向右轻轻倾斜手机	图标高亮会向对应方向移动	看到目标图标变亮后松手
松手	启动高亮 App，并尝试以小窗/自由窗口打开	若系统不支持，可能退回普通全屏启动
长按后不倾斜并继续按住约 2 秒	如果随心记已开启，会退出小窗选择并开始随心记录音	适合想记事而不是开小窗时

重要：小窗选择不是“手指拖到图标上”。源码逻辑使用手机传感器判断左右倾斜：超过一定角度后开始高亮，继续倾斜会切换到更外侧图标。

7.3 小窗打不开时怎么办

小窗能力依赖手机系统。三星、小米/红米/POCO、OPPO/一加/realme、vivo/iQOO、荣耀、努比亚/ZTE/红魔、魅族、华为等系统会尝试适配，但不保证每个版本都允许第三方自由窗口。
如果系统开发者选项里有“强制活动可调整大小”“启用自由窗口”等选项，打开后成功率会更高。
如果 App 本身禁止小窗，或 ROM 禁止第三方传入小窗参数，可能会全屏打开。
如果选择环没有图标，回到冰云键页重新点“选择”，至少勾选 1 个 App。

8. 冰云随心记：怎么唤起、怎么保存、怎么管理

8.1 开启前准备

序号	操作
1	进入“权限中心”，确认麦克风权限已允许。
2	进入“冰云键”，打开“冰云随心记”。
3	建议同时打开“电池优化白名单”，避免后台语音服务被系统回收。

8.2 唤起方式

当前配置	怎么唤起随心记	你会看到什么
没有配置冰云小窗，或小窗开关关闭	长按底部冰云条约 1 秒	出现随心记卡片，开始语音识别
已经配置冰云小窗	长按底部冰云条，小窗图标环出现后不要倾斜，继续按住约 2 秒	小窗环收起，进入随心记录音
正在录音中	松手或点按底部冰云条	结束识别，内容非空时自动保存

8.3 录音和保存规则

随心记使用本地 Sherpa ONNX 中文流式识别模型，不需要把语音上传到服务器完成识别。
说话时尽量靠近麦克风，语速放慢，句子之间稍作停顿。
松手后会等待最终识别结果；有有效文字才会保存。
记录按时间倒序保存，最多保留 200 条。
如果提示“模型未内置”或“离线语音识别启动失败”，说明 APK 资源或设备运行环境需要检查。

8.4 查看、复制、编辑、删除

序号	操作
1	在“冰云键”页找到“冰云随心记”。
2	点击“查看”进入随心记管理弹窗。
3	点击某条记录可编辑文字内容。
4	点击删除图标可删除该条记录。
5	在冰云控件面板的随心记页中，点击记录会复制内容到剪贴板，点击删除图标会删除记录。

9. 冰云控件池：调整弹窗里显示什么

冰云控件池就是“冰云控件面板的菜单”。你在这里启用什么、排在什么顺序，实际打开冰云面板时就会按这个顺序显示。

9.1 长按拖动排序

序号	操作
1	进入底部导航“冰云控件池”。
2	找到要移动的控件卡片，例如“音量”。
3	手指长按卡片本体，不要点到编辑或删除按钮。
4	卡片浮起后，上下拖动到目标位置。
5	松手后顺序自动保存。下次打开冰云控件面板时会按新顺序显示。

9.2 开关、编辑和删除

操作	怎么做	结果
启用/停用	切换控件卡片右侧开关	停用后该页不会出现在冰云控件面板里
编辑	点控件卡片上的“编辑”	进入音乐样式、设备面板、空白面板等配置
删除	只对自定义空白面板显示	删除该自定义页
新增空白面板	点底部“新增空白面板”	创建一个可配置的自定义页

保护规则：系统不允许把所有控件都关闭。至少会保留一个启用控件，避免打开冰云控件时没有任何页面可显示。

10. 主要冰云控件怎么用

控件	用户能做什么	使用前提/注意
音乐	播放/暂停、上一首、下一首、调整媒体音量、显示封面/歌词/波形	先打开音乐 App 播放一次，系统才有媒体会话可控制
音量	调整媒体、通知、铃声三类音量	滑杆变化会直接影响系统音量
设备面板	查看设备名称、型号、系统版本、Android、处理器、内存和设备图片	可以自动读取，也可以在编辑页手动覆盖显示内容
最近任务	查看最近用过的 App；点图标全屏打开；点“小窗”尝试小窗打开	需要使用情况访问权限；最多展示最近任务卡片
空白面板	做快捷应用、桌面小组件或自定义设备页	快捷应用最多 12 个；小组件取决于系统 AppWidget 支持
冰云随心记	查看记录、复制内容、删除记录	要先在冰云键页开启随心记并产生记录
第三方面板	使用第三方 App 注册的控制按钮、开关、滑杆等	第三方 App 需要通过 SDK 注册或声明发现服务

11. 通知弹窗与应用过滤

序号	操作
1	进入“冰云键”，打开“启用瞬时弹窗”。
2	如果只想接收少数 App 的弹窗，再打开“仅指定应用显示消息通知”。
3	点击“选择”，勾选微信、QQ、企业微信、日历等需要提醒的 App。
4	完成后让目标 App 发送一条系统通知，观察是否出现瞬时弹窗。
5	通知太多时，减少勾选 App；通知太少时，检查是否误开过滤或未给通知监听权限。

场景	推荐设置
日常办公	开启瞬时弹窗，只选择通信和日历类 App
游戏/视频横屏	开启“横屏只显示系统控制”，减少消息遮挡
只想用音乐和音量控制	关闭瞬时弹窗，保留冰云控件池中的音乐/音量控件
通知太打扰	开启应用过滤，或直接关闭“启用瞬时弹窗”

12. 外观设置

配置项	可选项	怎么选更合适
通知卡片样式	扁平卡片、液态玻璃、溢彩琉璃	看重清晰度选扁平；看重视觉效果选玻璃/琉璃
透明度	0%-100%	文字看不清时提高透明度；背景太重时降低透明度
通知容器样式	列表式、堆叠式	通知多选列表式；想要卡片层次选堆叠式
面板动画	经典、粒子、回弹、扭转、折叠	老设备建议经典；追求动效可试回弹/扭转
导航条颜色	玻璃、灵动、琉璃、自定义	自定义颜色支持 #RRGGBB 或 #AARRGGBB

13. 第三方面板的用户用法

第三方面板是给其他 App 接入 icyliveX 冰云控件的能力。普通用户不需要写代码，只需要在冰云SDK管理（SDK互联窗）里刷新接入状态，并决定哪些面板加入冰云控件池。

序号	操作
1	安装已经适配 icyliveX SDK 的第三方 App。
2	打开第三方 App，完成登录、设备绑定、蓝牙或网络连接。
3	回到 icyliveX，进入“冰云控件池”。
4	进入“冰云SDK管理”或“SDK互联窗开关”。
5	点击“刷新接入状态”，重新扫描静态发现并合并在线注册和本地快照。
6	查看目标面板状态：在线可直接启用；离线快照可查看旧内容；已发现等待注册需要先打开第三方 App 完成注册。
7	打开对应面板右侧启用开关，返回冰云控件池确认已加入。
8	打开底部冰云条，左右滑到该第三方面板进行控制。

状态	含义	用户该怎么做
在线	第三方 App 当前已注册完整面板	可以直接启用并操作
离线快照	保留上次注册内容，当前没有在线注册	可以查看旧面板；真实控制可能失败，打开第三方 App 后再刷新
已发现，等待注册	只发现 Manifest 接入声明，还没有完整面板	打开第三方 App 完成登录/设备连接，返回后重新刷新
第三方 App 已卸载	旧快照、接入开关和控件池项会在刷新时清理	点击刷新接入状态；重新安装后需要重新注册

按钮、开关和分段选择按提示点按，真实设备控制和状态回写由第三方 App 负责。
普通滑杆左右拖动；如果第三方面板声明了竖向滑杆，则上下拖动。
部分连续操作控件会在操作后保持面板展开，方便连续调节；普通单次操作可能自动收起。
如果面板能看到但控制无反应，先检查是否为离线快照，以及第三方 App 是否登录、联网或被系统限制后台。

14. 推荐日常使用流程

14.1 第一次安装后的 10 分钟设置

序号	操作
1	登录账号并确认会员状态通过。
2	进入权限中心，把悬浮窗、通知监听、麦克风、使用情况访问、电池优化白名单补齐。
3	进入冰云键，打开“启用冰云键”和“启用瞬时弹窗”。
4	如果只想看重要消息，打开“仅指定应用显示消息通知”并选择常用通信 App。
5	打开冰云控件池，长按拖动调整音乐、音量、设备、最近任务的顺序。
6	配置冰云小窗，选择 1-5 个常用 App。
7	如果需要语音记录，打开冰云随心记并测试一次长按录音。

14.2 正在使用手机时

想看控制页：点按或上滑底部冰云条。
想快速切歌或调音量：打开冰云控件，左右滑到音乐或音量页。
想开常用 App 小窗：长按底部条，看到图标环后左右倾斜选择，松手打开。
突然想到一件事：长按底部条；如果小窗环出现，不倾斜并继续按住，进入随心记后说出内容。
不想被打扰：关闭瞬时弹窗，或打开横屏只显示系统控制。

15. 常见问题

15.1 底部冰云条不显示

确认“冰云键 -> 启用冰云键”已打开。
确认权限中心里的悬浮窗权限已允许。
确认通知监听权限已允许，因为服务依赖通知监听刷新状态。
把 icyliveX 加入电池优化白名单，避免后台服务被系统回收。
如果刚改完权限，回到 icyliveX 后等待几秒，或重启一次 App。

15.2 长按底部条为什么出来的是小窗，不是随心记

这是正常逻辑。配置了冰云小窗时，长按会优先出现小窗选择环。如果你想进入随心记，不要左右倾斜手机，继续按住约 2 秒，系统会从小窗选择转入随心记录音。

15.3 小窗选择环没有高亮

手机需要轻轻向左或向右倾斜，超过一定角度后才会出现高亮。
如果仍然没有高亮，检查设备传感器是否异常，或先关闭再打开冰云小窗。
只配置 1 个 App 时，倾斜后会直接高亮唯一应用。

15.4 小窗打开成了全屏

小窗不是 Android 标准统一能力，强依赖厂商 ROM。icyliveX 会尝试自由窗口参数和启动边界参数；如果系统或目标 App 不允许，就可能退回全屏启动。

15.5 随心记没有保存

检查麦克风权限是否允许。
确认“冰云随心记”开关已打开。
录音时要说出能识别的内容，空内容不会保存。
如果提示模型未内置，检查 APK 是否包含 sherpa-onnx-streaming-zipformer-ctc-zh-int8 资源。
如果被系统打断，加入电池优化白名单后再试。

15.6 收不到通知弹窗

确认通知监听权限已开启。
确认“启用瞬时弹窗”已开启。
如果打开了“仅指定应用显示消息通知”，确认目标 App 已被勾选。
确认目标 App 在系统通知设置里允许发通知。
有些静默通知、服务通知或被系统折叠的通知可能不会按普通消息展示。

15.7 最近任务为空

去权限中心开启“最近任务读取权限/使用情况访问”。
先打开几个 App，再回到 icyliveX 查看最近任务。
部分 ROM 会限制使用情况访问，可能需要在系统管家里单独允许。

15.8 音乐控制没反应

先打开音乐 App 播放一首歌，让系统生成媒体会话。
确认音乐 App 没有被系统后台限制。
不同音乐 App 对歌词、喜欢、播放模式等扩展控制支持不同。

15.9 控件池拖不动

要长按控件卡片空白区域或文字区域，不要按编辑、删除、开关。
卡片浮起后再上下拖动，松手保存。
如果页面正在滚动，先停住页面再长按。

15.10 第三方面板不出现

确认第三方 App 已安装，并且它本身支持 icyliveX SDK。
打开第三方 App 完成登录或设备连接。
回到“冰云SDK管理/SDK互联窗开关”，点击“刷新接入状态”。
如果显示“已发现，等待注册”，说明只扫描到接入声明，需要先让第三方 App 完成在线注册。
如果只看到离线快照，说明第三方 App 当前没有在线注册最新面板。
第三方 App 已卸载时，刷新会清理旧快照、接入开关和控件池项。

15.11 第三方面板能看到但不能控制

先确认接入状态是否为“在线”；离线快照中的真实控制可能失败。
打开第三方 App，恢复登录、设备连接和网络，再回到 icyliveX 刷新。
普通滑杆左右拖动，第三方声明的竖向滑杆上下拖动。
连续操作控件可能保持面板展开，这不是卡住；普通操作可能自动收起。
仍无反应时，检查第三方 App 的后台权限，或向第三方 App 开发者反馈。

16. 管理员补充：后台功能

这一部分面向管理员或运维人员。普通用户可以跳过。

后台模块	能做什么
概览	查看用户、会话、设备、验证码等指标。
用户管理	新增用户、搜索用户、修改状态/角色/显示名、删除账号。
会员管理	激活 LOG/FULL 会员，升级 FULL 会员。
设备与会话	查看设备，禁用设备，撤销登录会话。
日志	请求 LOG 会员上传，查看、导出、清理使用日志。
版本发布	维护公告、版本号、下载地址和 APK 元数据。