# 常见问题

| 现象 | 先做什么 | 可能原因 |
| --- | --- | --- |
| 页面打不开 | 换网络，稍后刷新，确认网址 | 静态部署失败、网络或域名问题 |
| 点输入框后画面异常 | 更新浏览器，收起键盘再打开，记录设备版本 | 可见视口变化或旧缓存 |
| 角色没回复 | 等自动重试结束，再用重试按钮 | 上游超时、限流、断网或接口配置 |
| 突然只显示半段 | 点重试，或说明从上段继续 | 传输中断或模型输出额度 |
| 新角色无法生成 | 按提示的行列修改，补全name和personality后再生成 | 缺少逗号、引号或括号；必填项、年龄或长度错误 |
| 仍显示“格式不对，请使用角色模板” | 重新打开原网址一次；今后有新版时点“更新页面” | 手机仍停留在旧解析器；当前版本提供具体行列或字段提示 |
| 上传后没新增 | 检查代码框，再点生成；修改已有角色先选择它 | 上传只载入草稿；已有id需要保存修改 |
| 头像无法加载 | 从相册另存JPEG/PNG再选 | 图片解码失败或外部地址不可用 |
| 换手机没有聊天 | 下载原备份，再恢复记忆 | 本机记录没有自动云同步 |
| Google Drive没文件 | 在Drive确认文件，必要时手动上传 | 分享未完成或浏览器仅下载 |
| 提示空间不足 | 先保存备份，再处理不需要的角色 | 浏览器本地存储配额 |
| 恢复失败 | 确认是JSON备份且小于15MiB | 格式、文件大小、空间或回复仍进行中 |
| 本地预览不能聊天 | 检查config/app.js和后台响应 | 接口未配置、跨域或认证不兼容 |

## 为什么长消息可以发送，回复仍不算很长

输入容量和模型输出额度分别控制。网站单条支持30000字符，长回复请求6000 token。模型会按题目、上游配置和上下文决定篇幅，token也不等于中文字数。给出明确主题、段落要求和期望长度，效果通常比只说“多写”更稳定。

## 为什么会忘掉某段旧聊天

完整历史保存在本机，但每次回复只带有限的近期上下文与相关记忆。重要信息可以明确说“记住”，或写入资料。每条长期细节有长度限制，建议拆开表达。角色不会从未保存、已删除或另一浏览器的数据里猜出你的身份。

## 如何反馈问题

描述“设备与浏览器版本、从哪个页面点了什么、期待什么、实际出现什么”。截图先遮住私人对话。不要上传完整备份、密钥或未经遮挡的个人照片。发布者可通过GitHub问题区接收报告，涉及敏感信息时使用私下渠道。

## 维护者排查顺序

先检查静态资产实际返回状态与内容，再核对接口配置。对API检查OPTIONS、POST、Content-Type、SSE完成标记和请求时长。确认未把PPT、图片或脚本路径重写成首页。构建检查通过只说明仓库文件可用，真实模型仍需单独验证。