内置聊天使用指南与隐私

悠然 AI 内置聊天是已经接好模型的浏览器聊天应用。它适合日常问答、写作、翻译、总结、图片分析和辅助学习，也可以在手机与电脑浏览器中使用。

第一次使用

请管理员为你创建普通用户账号，并取得用户名和初始密码。
打开悠然 AI 内置聊天并登录。管理员账号不能进入聊天端。
如果页面要求修改初始密码，请按提示设置新密码。完成一次后，聊天与控制台会同步生效。
保持默认模型和默认推理强度，在底部输入框中写下需求，然后发送。
AI 回复后可以继续追问。左侧会话列表会保存上下文，不需要每次重新说明前面的内容。

新建普通用户在创建时就会默认启用按量计费，获得 $10 初始额度和 $5 每日限额，不依赖首次改密操作。聊天与管理端使用相同的账号和登录 Session，普通用户登录一次后，可以在 /admin/ 与 /chat/ 之间切换。

手机上推荐安装为 PWA

移动设备建议将内置聊天安装为 PWA 应用。安装后可以从手机主屏幕直接启动，并在支持的浏览器中使用独立窗口，不需要下载应用安装包。

请查看移动端 PWA 安装指南，其中按 iPhone、华为、小米、OPPO 和 vivo 最新主系统的默认浏览器分别给出了完整步骤。

内置聊天与其他使用方式

使用方式	是否需要手动创建 API Key	适合场景
内置聊天	不需要	日常问答、写作、翻译、总结、图片分析，以及第一次使用 AI
Cherry Studio、Chatbox 等第三方客户端	需要	已经习惯特定客户端，或需要其本地功能
Claude Code、Codex、Cursor 等编程工具	需要	编写、修改和理解代码

如果只是想和 AI 对话，内置聊天是步骤最少的入口。需要接入其他软件时，再前往快速开始创建 API Key。

支持能力

一套响应式界面同时适配手机与桌面浏览器。
流式 Markdown、GFM、KaTeX 数学公式、Mermaid 图表和 Shiki 代码高亮。
图片粘贴与上传、思考摘要、编辑并重发、重新生成和消息分支。
会话列表默认加载最近 20 个会话；历史对话默认加载最新 20 条活动分支消息，并在继续滚动时按页读取更早内容。
浅色、深色与跟随系统主题，以及模型、推理强度、回答详略、语言和自定义指令。
会话 Token、累计 Token、近 30 天 Token、来源分布与存储统计。

数据保存边界

公开 /v1/* API 只保存请求元数据、状态、计费字段和 Token，不保存提示词或模型响应正文。

内置聊天为提供会话历史和跨设备访问，会保存：

所有活动与非活动分支中的用户正文、助手正文和模型提供的思考摘要。
用户上传的 JPEG、PNG 和 WebP 图片。
会话标题、模型、推理强度与活动分支。
每次回复和标题生成的 Token 与计费记录。

标题、数据库索引与历史 Token 记录不计入聊天存储额度。标题生成请求不会创建可见消息。

存储额度与清理

每位普通用户默认拥有 200 MB 存储额度，部署管理员可以通过 CHAT_STORAGE_LIMIT_MB 调整。达到 90% 后，侧栏和设置页会持续提醒；空间不足时会暂停发送、编辑、重新生成和图片上传，但仍可查看、复制、切换分支和删除对话。

存储清理页按最久聊天时间到最近排列。删除一个会话会硬删除该会话的所有分支与图片，并立即释放空间；历史 Token 与计费记录继续保留。

每条消息最多上传 4 张图片，每张最多 10 MB，仅支持 JPEG、PNG 与 WebP。图片通过登录鉴权后的私有接口读取，不会作为公共静态资源暴露。

备份说明

服务端需要同时备份 SQLite 数据库与 CHAT_UPLOADS_PATH 指向的图片目录。Docker 默认将二者放在 /app/backend/data 持久化卷中。恢复时应使用同一时间点的数据库与图片；启动检查会重算存储计数、结束重启前未完成的生成，并清理没有数据库记录的孤儿图片。