跳转到内容
悠然 AI 文档

移动端 PWA 安装指南

在手机或平板上，推荐将悠然 AI 内置聊天安装为 PWA 应用。安装后可以从主屏幕直接启动，并在支持的浏览器中使用独立窗口；无需下载应用安装包，也不会额外创建账号。

安装前准备

Section titled “安装前准备”
  1. 在手机的默认浏览器中直接打开 https://youran-ai.du-fu.com/chat/，不要在微信、QQ 或其他应用的内置浏览器中操作。
  2. 建议先完成登录和首次密码修改，再将当前页面安装到主屏幕。
  3. 如果聊天页面显示“一键安装悠然 AI 聊天”，可以直接轻点并确认；没有该按钮时，继续按下方的手动步骤操作。
  4. 安装完成后，从手机主屏幕上的“悠然聊天”图标启动。

图标与深浅色支持

Section titled “图标与深浅色支持”

内置聊天已经分别配置常规图标、Android 自适应图标、单色图标和 iOS 触控图标。常规与自适应图标使用当前悠然 AI 标志；自适应图标的主体位于 PWA 标准安全区内，系统裁切为圆形、圆角矩形或其他形状时不会切掉关键内容。

系统与场景 支持情况
iPhone 与 iPad 主屏幕 Safari 优先使用固定的 apple-touch-icon。系统可以统一处理图标外观，但网页目前不能像原生 App 一样分别提供可依赖的浅色、深色和着色图标。
Android 手机主屏幕 支持 PWA 清单的浏览器可以使用 maskable 自适应图标。monochrome 单色图标也已提供，浏览器或桌面支持时可以跟随系统着色。
HarmonyOS 与各品牌网页快捷方式 是否读取 PWA 清单取决于浏览器版本；不能稳定读取时会退回固定彩色图标或网页截图。
浏览器标签页与应用界面 浏览器标签页图标会在支持响应式 SVG 图标的浏览器中适配深色背景；聊天界面和浏览器主题色会根据聊天内选择的浅色、深色或跟随系统模式切换。

为了保证 iOS、HarmonyOS 和不同 Android 桌面上的识别度，安装后的彩色图标使用不依赖系统背景色的浅色底板。已经安装过旧图标时，系统可能继续使用缓存；删除主屏幕旧图标后重新添加即可更新。

以下以 2026 年 7 月各品牌最新主系统及其默认浏览器为例：iOS 26、HarmonyOS 6.1、Xiaomi HyperOS 3、ColorOS 16 和 OriginOS 6。浏览器应用可能独立更新，个别菜单名称请以设备实际显示为准。

iPhone：iOS 26 与 Safari 浏览器

Section titled “iPhone：iOS 26 与 Safari 浏览器”
  1. 使用 Safari 浏览器打开悠然 AI 内置聊天并登录。
  2. 轻点浏览器中的“更多”，再轻点“共享”。如果当前标签页布局直接显示共享按钮，也可以直接轻点该按钮。
  3. 向下滚动共享操作，轻点“添加到主屏幕”。
  4. 打开“作为网页 App 打开”。
  5. 轻点“添加”，返回主屏幕后再轻点“悠然聊天”图标启动。

如果共享列表中没有“添加到主屏幕”，请滚动到列表底部，轻点“编辑操作”，再添加“添加到主屏幕”。完整菜单路径可参考 Apple 的 iPhone 使用手册。

华为：HarmonyOS 6.1 与华为浏览器

Section titled “华为：HarmonyOS 6.1 与华为浏览器”
  1. 使用华为浏览器打开悠然 AI 内置聊天并登录。
  2. 轻点网页中的“∷”。
  3. 轻点“添加至桌面”。
  4. 保留或修改名称，轻点确认图标完成添加。
  5. 返回桌面，从“悠然聊天”图标启动。

华为浏览器可能将支持 PWA 的网站显示为快应用快捷方式，这不影响从桌面启动。华为官方将这一路径列为 HarmonyOS 5.0 及以上版本的操作方式，详情见华为浏览器网站桌面快捷方式说明。

小米与 REDMI：Xiaomi HyperOS 3 与小米浏览器

Section titled “小米与 REDMI：Xiaomi HyperOS 3 与小米浏览器”
  1. 使用小米浏览器打开悠然 AI 内置聊天并登录。
  2. 轻点底部“菜单”，进入“工具箱”。
  3. 轻点“添加快捷方式”或“添加到桌面”。
  4. 选择“手机桌面”，确认名称后轻点“确定”或“添加”。
  5. 返回桌面，从“悠然聊天”图标启动。

如果没有生成图标，请进入“设置 → 应用 → 应用管理 → 浏览器 → 其他权限”，将“桌面快捷方式”或“创建桌面快捷方式”设为允许，再重新添加。

OPPO：ColorOS 16 与 OPPO 浏览器

Section titled “OPPO：ColorOS 16 与 OPPO 浏览器”
  1. 使用 OPPO 浏览器打开悠然 AI 内置聊天并登录。
  2. 轻点底部“菜单”，选择“收藏网页”。
  3. 在保存选项中勾选“桌面书签”或选择“添加至桌面”，再确认添加。
  4. 如果当前版本没有显示桌面选项，请进入“书签／历史”，长按刚保存的网页，再选择“添加至桌面”。
  5. 返回桌面，从“悠然聊天”图标启动。

vivo 与 iQOO：OriginOS 6 与 vivo 浏览器

Section titled “vivo 与 iQOO：OriginOS 6 与 vivo 浏览器”
  1. 使用 vivo 浏览器打开悠然 AI 内置聊天并登录。
  2. 将当前网页加入收藏，或确保历史记录中已有当前网页。
  3. 进入“收藏／历史”，长按悠然 AI 内置聊天的访问记录。
  4. 轻点“添加至桌面”并确认。
  5. 返回桌面，从“悠然聊天”图标启动。

vivo 官方社区给出的同类网页桌面入口路径也是“浏览器 → 收藏／历史 → 长按访问记录 → 添加至桌面”，可参考 vivo 浏览器桌面入口示例。

找不到安装或桌面选项

Section titled “找不到安装或桌面选项”
  • 确认页面由系统默认浏览器直接打开，而不是微信、QQ、微博等应用的内置浏览器。
  • 刷新页面并等待片刻。部分浏览器只有在页面通过 HTTPS 提供、PWA 信息加载完成且用户与页面交互后，才显示安装入口。
  • 在系统设置中检查默认浏览器的“创建桌面快捷方式”或“桌面快捷方式”权限，并设为允许。
  • 如果默认浏览器只能创建普通网页快捷方式，可改用最新版 Chrome 或 Edge 打开同一地址，然后选择“安装应用”或“添加到主屏幕”。
  • 删除失败的旧图标后重新添加。删除主屏幕图标不会删除聊天记录和账号数据。

如何确认安装成功

Section titled “如何确认安装成功”
  1. 回到手机主屏幕，找到名称为“悠然聊天”的图标。
  2. 轻点图标后应直接进入内置聊天。
  3. 如果打开后没有普通浏览器的地址栏，说明当前浏览器提供了独立 PWA 或网页 App 体验。
  4. 如果仍有地址栏，当前浏览器创建的是网页快捷方式；它可以正常使用，但不是完整的独立窗口体验。

需要移除时，长按主屏幕图标并选择“移除”或“卸载”即可。账号、服务端会话和图片不会随主屏幕图标一起删除。