Help

帮助与常见问题

下面每一条都能在《隐私政策》或《用户协议》里找到出处, 我们尽量不在这里临时承诺政策里没写的东西。找不到答案就直接反馈给我们。

开始使用

怎么开始?要配置模型 Key 吗?

不需要配 Key。用邮箱注册(或直接以游客身份进入)就能开聊, 默认走官方免费中转(新用户注册送 75 次、每天签到再得 50 次;MiniMax 非会员每天 20 次,会员不限次)。想长期重度使用,可以在「设置 → LLM 连接」里填自己的 Key—— 请求经我们的后端转发给你选的提供商。

打开网页版开始 →

游客登录和注册账号有什么区别?

游客账号由系统生成一个 @anonymous.local 占位邮箱和随机密码, 不向你索取任何真实身份信息,也不需要手机号。

代价是:换设备、换浏览器或清除站点数据,这段关系和记忆就找不回来了。 想长期保留,在「我的」页绑定邮箱即可转正,此前产生的数据原样保留。

网页版和 Android 客户端有什么区别?数据互通吗?

界面完全一致——Android 客户端是一个轻壳,实时加载官网,所以功能永远同步。 账号与数据双端互通:手机上聊到一半,换电脑打开继续。

App 多出来的是安卓系统能力:消息通知、录音权限、更稳的启动。 装法与包体信息见下载页。

创作角色卡与世界书

角色卡 JSON 从哪里下载,常用字段怎么填?

打开「角色 → 导入」,点「下载 JSON 参考模板」。模板是标准 SillyTavern V2 角色卡,改完以后仍从同一入口导入;也支持 PNG 角色卡和从文件直链导入。

字段用途
name角色名,唯一必填项
description背景与人物经历
personality性格、行为习惯与表达倾向
scenario初见场景,会追加到背景末尾
first_mes第一次见面时的开场白
mes_example对话示例,建议写 2-3 组 {{user}} / {{char}} 交替对白
tags标签数组,导入后成为角色特质
visual_brief立绘视觉提示:年龄、外貌、服饰、光线与构图

模板里的 extensions.banmeng 是半梦自己的展示扩展。酒馆会忽略它; 半梦导出、再导入时会保留状态栏、美化简介和展示预设。

世界书 JSON 怎么写?

打开「世界 → 入梦 → 世界书 → 新建 → 粘贴导入」,点「下载 JSON 示例」会得到一份完整模板。也可以点「填入示例」直接在输入框里修改。

字段用途
name / worldBrief世界名与核心世界观,两项必填
playerRole玩家在这个世界里的身份
worldLayer规则、历史、势力等常驻世界设定
npcPool角色名册:名字、身份、性格、声线、初始关系
eventPool可触发的世界事件与建议行动
stateInitial开场地点、时间与初始在场角色
lore关键词触发的世界档案,适合放大量细节
时间、地点、心动值这类状态栏怎么显示?

角色卡和世界书都支持折叠状态栏。它是卡片上的静态展示, 作者写什么就显示什么,不会由模型每轮自动改写。

"statusBar": [
  {"label": "时间", "value": "傍晚 · 18:40"},
  {"label": "地点", "value": "旧港灯塔"},
  {"label": "心动值", "value": "62 · 有点在意"}
]

角色卡把它放在 extensions.banmeng.statusBar;世界书直接放在 data.statusBar。编辑器里也提供「填个示例」和实时预览。

美化简介能写哪些 HTML?

支持段落、标题、列表、引用、表格、折叠块、基础颜色和渐变。脚本、事件属性、 iframe、外链图片和固定悬浮层会被安全策略拦掉。美化简介和状态栏都只影响展示, 不会进入模型提示词。

费用与额度

真的免费吗?会不会哪天开始收费?

目前是免费内测期:基础功能免费。会员(不自动续费)与梦晶(充值货币)是可选的付费项目;Android 版(官方安装包)里有激励视频广告,看完可得聊天次数(每次 35 次,当天有效)。非会员累计使用满 20 分钟后,需要看完一段广告才能继续聊天,每天最多领 10 次;卡片上也可以先继续用 10 分钟(每个周期一次,每天最多 3 次)。也可以随时主动看广告,每天最多 10 次。会员不用看广告,网页版没有广告。 官方免费中转按梦晶次数计费(新用户注册送 75 次、每天签到 50 次、看广告也能领);MiniMax 非会员每天 20 次,会员不限次。

也说清楚边界:内测期功能与规则可能随时调整,《用户协议》第二节把「不承诺可用性」写在了明面上。 付费项目的完整退款规则分别写在「会员」与「梦晶充值」页面里。 会员退款:付款后 3 个工作日内,且自付款以来聊天消息与玩家行动合计不超过 10 条,可全额退款;超过 10 条不可直接退款,如仍需退款,只能申请注销账号并按会员剩余天数退款。 因平台原因影响 24 小时以上的,先顺延会员时长,坚持退款时按剩余天数处理。梦晶退款按充值页规则。

免费通道有每日对话次数上限吗?

有。MiniMax 非会员每天 20 次成功回复,看广告最多追加 75 次;DeepSeek V4 Flash-0731 非会员每天 500 次;Gemini 3.5 Flash-Lite 每天基础 50 次,每邀请 1 人增加 50 次,封顶 500 次。聊天按梦晶次数计费——新用户注册送 75 次,每天签到得 50 次,看广告也能领(每次 35 次,当天有效)。自己配置了模型 Key 的聊天不计次数、不限次。

有哪些硬性限制?

下表都是服务端强校验,不是建议值;超限时会明确提示,不会静默失败。

限制项 数值 超限时你会看到
单条消息长度 5000 字符 超出的部分会被截断
单次请求携带图片 4 张 多余图片不进入本次请求
单次输入总字符(官方免费中转) 官网写的 8 万字是保守值,实际上限按当时接入的渠道而定 提示本次对话内容过长,可配置自己的 Key 解除
免费通道并发 运营可调(当前未设硬上限) 超过上限时最长等待 30 秒,之后直接放行
MiniMax(非会员) 每天 20 次成功回复;看广告最多追加 75 次 提示额度用完,可先用其它通道,或开通会员
识图(聊天发图片) 免费版每天 1 张;会员每天 10 张 提示今日识图额度已用完,明天恢复
角色数量 12 无法新建
世界书数量 5 本 无法新建
对话卷宗数量 500 个 无法新建
单卷消息条数 3000 条 本卷写满,发不出去;提示开新卷或先织茧
世界(纪元)数量 50 本 无法新建
单角色记忆条数 500 条 无法新增
纪元(箱庭)入口 暂时锁着,功能还在打磨 点「世界 → 纪元」提示「纪元功能还在完善,暂时进不去」
织茧(自动 / 手动) 不限次;平台通道每次成功扣 1 次聊天次数 次数不足时提示充值、签到或开通会员
语音输入 30 次 / 15 分钟 本次识别被拒
登录类接口 20 次 / 15 分钟 请求过于频繁,请稍后再试

记忆与数据

我的对话会被拿去训练模型吗?

不会。我们不把你的对话用于训练自己的模型,也不出售、出租或以其它方式 向第三方提供你的个人信息用于其模型训练。你的对话正文也不会进入我们的访问日志。

但有一件事必须说清楚:半梦自己不生成回复,回复来自第三方大模型。 每次请求携带的不只是你最后一句话——还有该角色的人设与示例对白、被召回的世界记忆、 梦茧摘要、你在「我的设定」里填的信息,以及本次会话的历史消息,且按原样发送,不做脱敏。 这部分受模型服务商自己的条款约束,超出我们的控制范围。

所以:请不要在对话里写身份证号、银行卡号、住址门牌、密码等可以直接定位到你真实身份的信息。 详见《隐私政策》第三节。

我的数据存在哪里?保存多久?

除语音外,你产生的内容(对话、角色、世界、梦茧、图片)都存在我们自己租的服务器上, 不托管于任何第三方内容平台。

账号存续期间不自动过期——直到你删掉它,或申请注销。 浏览器报错信息 30 天后清除;登录令牌 15 分钟 / 7 天到期即清;服务器备份快照约 2 天滚动覆盖。

一个需要理解的机制:「会淡忘也能擦亮」的梦茧本身就在让记忆随时间衰减, 星屑只有权重衰减而没有到期删除——衰减到看不见的记忆仍在库里,可以被擦亮。

记忆和对话能删吗?能导出吗?

能删:

  • 整份卷宗(对话)——删除后连带其中全部消息一并移除
  • 单条消息
  • 角色——连带清理它的卷宗、消息、梦茧三层数据、世界居民、织茧任务与角色日报
  • 世界、世界页面、记忆条目、群、梦信会话
  • 「重置角色」可清空某角色的全部往来记录,而保留角色卡本身

能导:

  • 在「我的」或「设置」页点「导出数据备份」,会下载一个 JSON, 包含你的全部角色卡、世界设定,以及逐页取齐的完整对话记录(长卷宗不会被截断)。
  • 单张角色卡还可导出为 PNG / JSON(SillyTavern V2 格式),可分享或导入他处。

三处不彻底,我们如实写在政策里:

  • 撤回的消息:界面显示为「已撤回」,正文在数据库中是被标记而非立即销毁
  • 梦茧的星屑与章节:删除是标记状态,不再参与展示与召回,但记录本身仍在库中
  • 上传的图片文件:删除消息或角色,不保证磁盘文件被同步物理删除

这三类如需彻底物理清除,请按注销的方式联系我们,我们会定位记录手工删除并回执确认。 详见《隐私政策》第十节。

我配置的 API Key 存在哪里?

只保存在你自己浏览器的本地存储里随请求发送, 不写入我们的数据库,也不写入日志(日志层对 authorization、*apiKey、 *token 字段做了强制脱敏)。

公用或他人可访问的电脑上,请用浏览器访客模式,用完退出登录—— 退出会清空本机的这些数据。

语音会被保存或用于克隆吗?

不会。录音在你的设备上转为 16kHz 单声道后上传, 服务器只在内存中把它转成文字:不落盘、不备份、不进访问日志、 不转发给任何第三方、不用于训练。识别由我们自己部署的开源模型完成,不调用任何外部语音识别接口。

不做声纹识别、不做说话人验证、不做声音克隆。识别结果只填进输入框,你确认发送才会成为消息。

「角色声音」和「按住说话」是同一个功能吗?

不是。「按住说话」是语音输入:把你的录音在本地服务器转成文字; 「角色声音」是朗读:把角色的回复文字交给 MiniMax 语音合成服务生成音频。

角色声音默认只展示“即将开放”。内测开启后,可点消息里的“朗读”,或在角色声音页为单个角色选择音色、开启自动朗读。自动朗读可能被 iOS 的媒体播放策略拦截,此时手动点“朗读”即可。

天气同步会拿到我的位置吗?

默认关闭。开启后,服务端用你请求的来源 IP 查出城市级坐标 (约 11 公里精度,四舍五入到 0.1° 格点)和时区,据此获取当地天气; 数据库只保留这个格点值,不保留 IP。

注入给模型的内容里只有天气现象(阴晴、气温、风力等),城市名与坐标既不写入该内容,也不随接口返回。 角色能感知「外面在下雨」,无法得知你在哪个城市。

发出去的照片是怎么处理的?

图片先在你的设备上压缩,再上传到我们的服务器落盘,然后以链接形式交给视觉模型—— 「发照片祂真的看得见」这个功能必然要求图片可被推理服务读取。

  • 只接受 png / jpg / webp / gif,解码后不超过 900KB,单条消息最多 4 张
  • 上传前已在你的设备上重新编码压缩为 JPEG(质量 85%),原始文件名与 EXIF 元数据 (拍摄时间、可能写入的拍摄位置)不随文件保留
  • 注意:图片通过链接直接访问,链接本身就等于访问凭证,请不要把图片链接转发给他人

故障排查

APK 装不上,或提示「无法安装」?

安卓对浏览器下载的安装包默认会拦一下,提示「此类文件可能有害」或「禁止安装未知应用」, 这是系统行为。请在提示里选择「仍然下载」,并按系统指引允许当前浏览器「安装未知应用」。

如果提示「解析包错误」,通常是包没下完或系统版本过旧:重新下载一次试试。 步骤详见下载页的装机说明。

安卓里往上翻历史,整页刷新了?

这是 v1.4.2 修掉的问题:壳会把页面上任何位置的拖动都当成顶部下拉, 所以翻历史时手一拖就整页重载、滚动清零。请到下载页更新到 v1.4.2。

聊着聊着黑屏动不了,或者启动就是一片黑?

聊到一半黑屏:原因是渲染进程被系统回收后留下了不可用的引擎。 v1.4.2 起会自动重建界面(你只会看到闪一下);更早的版本只能清后台重进。

启动就黑:页面会自己给出一张「人话 + 重试」的卡片。 先点「重试」;重试后仍打不开,卡片会变成「换条线路重试」——它会绕开被中间缓存卡住的旧文件重新拉取。 如果提示浏览器版本太旧,请换最新版 Chrome / Safari / Edge,或升级微信、QQ、系统浏览器。

怎么知道是不是服务端出问题了?

看服务状态页:官网与接口、模型服务、语音输入三项各自是否正常, 近 24 小时可用率,以及最近一次异常发生在什么时候。

这一页每 30 秒自动刷新,能帮你把「服务端故障」和「你那边网络不好」区分开。 它只报我们这一侧,也不会显示请求量等业务数据。

角色不回消息,或者一直转圈?

先看一眼服务状态——如果「模型服务」显示降级或故障, 那就是我们这边的问题,不用折腾你的网络。

半梦自己不生成回复,回复来自第三方大模型。 上游限流或故障导致的延迟与失败,属于这类产品的固有边界(《用户协议》第二节),我们无法替你承诺。

常见的两种情况:上游限流或排队时,高峰期可能等一会儿(最长 30 秒后放行); 模型服务商临时故障时会持续失败。先等一下再试,长时间不恢复请通过 意见反馈告诉我们。

「按住说话」的按钮不见了?

语音识别跑在我们自己服务器的一个独立进程上,它不在线时, 应用会直接把麦克风按钮收起来——我们不给点了没反应的死按钮。 文字对话完全不受影响。

当前状态可以在服务状态页看到。

麦克风打不开 / 提示被占用、没有权限?

先按提示处理:第一次用,要在系统弹出的提示里点「允许」; 如果之前误点过「禁止」,去 系统设置 → 应用 → 半梦 → 权限里把麦克风打开。 QQ、录音、语音助手这类正在用麦克风的应用也会抢占它,先关掉再试。

还不行就点下面的自检:它会把「权限状态、是不是在半梦 App 里、 采集成不成功、失败的具体原因」一次列出来,截图发给客服即可,不用自己猜。


              
图片发不出去?

逐条对一下:格式只支持 png / jpg / webp / gif;单张解码后不超过 900KB; 单条消息最多 4 张,多出来的不会进入本次请求。

反馈与账号

怎么反馈 Bug 或提建议?

应用内:半梦桌面 → 回声 → 写一条回声。 反馈默认只提交私密工单;勾选公开后,标题和正文才会进入回声广场。 应用内的「我的 → 应用设置 → 帮助与关于 → 半梦入门手册」还有一份可搜索的分章说明。

确认修复的反馈会进入「回声榜」的贡献统计。赞和「我也遇到」只表示共鸣, 不会直接改变贡献名次,也不能充值或兑换。

邮件也可以:tommaso20021203@gmail.com

怎么注销账号、彻底删除数据?

在 App 里点「我的 → 应用设置 → 账户与安全 → 注销账号」提交申请(需输入登录密码确认是本人)。 提交只是申请,账号照常可用,我们确认之前你随时可以撤销。 我们会在 15 个工作日内确认并删除该账号下的全部数据(账号、对话、角色、世界、梦茧、图片、统计事件)。 注销完成后,该注册邮箱永久不能再次注册,使用过该账号的设备也永久不能继续使用半梦。 登不进 App 时,也可以通过上面任一渠道联系我们,注明「注销」并说明注册邮箱。

内容分级和未成年人保护是怎么做的?

本应用面向 14 周岁以上用户。应用内提供「纯爱模式」「未成年模式」收敛内容尺度, 「心动模式」需填写生日并确认已满 18 岁后开启。

要如实说明的是:这些开关与生日保存在你的设备本地,作用是决定注入给模型的内容取向; 服务端不做年龄校验、不采集生日、也不主动过滤内容,换一台浏览器或清除本地数据后模式会回到默认状态。 因此它不能替代家长端的设备级管控,请把它视为使用者的自助工具,而不是我们对内容尺度的承诺 (《用户协议》第七节)。

没找到答案?先看《隐私政策》与《用户协议》—— 关于数据流向、删除边界与限制数值,那两份是唯一有效的口径。 也可以在更新日志里看这个问题是不是已经修掉了。