心链 · 新手使用教程
适用版本：0.15.0 ｜ 可以免登录使用

一、第一次打开，先做这三件事
1. 日常使用请选择“应用版”。“开发者版”保留全部功能，额外提供诊断入口，两版存档互相独立。
2. 打开“设置”，填写你自己的模型服务地址、API 密钥和模型名称，再点击测试连接。
3. 回到消息列表，选一位角色，发一句你好。先确认能正常聊天，再开启后台陪伴。

心链是角色聊天应用，需要连接模型服务。下载心链不等于获得免费的模型额度；模型平台可能按使用量收费。不会设置时，可以先使用平台提供的连接说明。

二、模型怎么填
服务地址：模型平台给你的 HTTPS API 地址，不是它的官网首页。地址格式以设置页说明为准。
API 密钥：在模型平台创建，通常是一长串字符。不要把它截图、公开或发给别人。
模型名称：填平台实际提供的模型 ID，大小写和拼写要准确。“DeepSeek”这样的品牌名不一定是可调用的模型 ID。优先使用获取模型列表的选项，或复制平台文档里的 ID。
点测试连接后，等到明确成功再聊天。

连接失败怎么处理：
HTTP 400：检查模型 ID、地址和所选功能是否受支持。
HTTP 401/403：检查密钥是否正确、有效，账号是否有使用权限。
HTTP 429：可能是余额、额度或请求过快，请查看模型平台。
网络错误或超时：检查手机网络、服务地址和平台状态。反复点击不会修好网络。

三、手机与电脑安装
安卓：更新时直接覆盖安装同一版本类型，不要先卸载。应用版与开发者版的数据各自保存。
Windows：下载 ZIP 后先完整解压，再打开“心链.exe”；开发者版打开“心链 Dev.exe”。不要只把 exe 拖出来运行。已包含运行环境，无需安装 Node.js。
电脑上请保持聊天窗口打开或最小化，角色才会主动联系。只剩托盘程序、关闭聊天窗口时，不会继续生成角色消息。

四、开始相处
私聊：点击角色进入会话。点击头像可以查看角色资料；你可以修改称呼、个性签名和专属声库配置。
用户中心：主界面左上角可以设置自己的头像、名字和希望角色如何称呼你。
添加角色：在联系人或设置中的添加入口创建原创角色，写清楚性格、背景和说话习惯。
群聊：从创建群聊入口选择成员。群设置可调整群头像、介绍、成员和聊天节奏。活跃成员在各自群里积累等级。
免打扰：私聊和群聊分别设置。免打扰会影响通知提醒，不等于删除会话。
长按一条消息：可引用回复、复制文字、删除本地显示；撤回等操作以当前消息菜单提供的选项为准。
聊天背景：可以在会话设置里选择自己的图片。更新默认配图不会替换你自己设置的背景或头像。

五、图片、动图、表情与链接
点击输入栏旁的加号，选择照片或附件。可以只发图片，不必额外输入“看看这张图片”。
“视觉模型”是能够理解图片内容的模型。能聊天的模型不一定能看图；如果主聊天模型不支持图片，需要另配支持图片的服务。
动图会播放；理解动图时会提取多帧交给视觉模型，不等于模型连续看完全部原始视频。
视频、长截图的识别效果受文件大小、提取内容和模型能力影响。不要把上传成功理解为每一帧、每一字都已识别。
公开链接可以尝试读取；需要登录、付费或限制访问的网页可能读不到。
表情包资源独立于安装包。在表情面板选择下载资源包，也可以离线导入。全部资源较大，建议使用 Wi-Fi，按需要下载。
目前没有接入绘图服务。角色可以使用已有素材，不能凭空调用尚未配置的绘图平台。

六、让角色在你忙时也能发消息
先确保模型测试成功，并开启主动联系。在安卓用户中心开启“本机陪伴模式”。
允许消息通知，再到系统通知设置中检查“角色私聊”“群聊消息”的横幅、声音、锁屏选项。能发送测试通知，只代表通知展示通路正常，不代表模型和角色调度一定成功。
如果希望更稳定地后台运行，可以按页面指引设置电池不限制、允许自启动，并保留陪伴服务的常驻通知。不同手机的设置名称会不同；后台陪伴会增加耗电和模型使用量。
默认主动私聊采用全局节奏：在线约 5 分钟、离开应用后约 15 分钟有一次联系机会，再从符合条件的角色中选择；不是每位角色都按这个间隔各发一次。实际还受作息、冷却和模型响应影响。
凌晨 02:00—08:30 暂停主动联系；你主动发消息仍然可以聊天。群聊可以单独调节节奏；上限是最多允许多少条，不是保证每小时一定发满。
安卓系统仍可能在省电、强行停止或重启后限制运行。强行停止应用后，需要重新打开并检查陪伴状态。横幅最终由手机系统、通知分类和系统免打扰决定，应用不能保证每条都强制弹出。
没收到消息时，打开用户中心的后台状态，查看最近执行时间、模型错误和角色筛选原因，不要只反复安排自检。

七、记忆、备份与换手机（很重要）
聊天和角色资料主要保存在本机。角色会结合近期对话与检索到的记忆理解你；不代表模型能永久、逐字记住所有内容。
“语义检索”是按意思寻找旧信息，例如“上班忙完了”和“工作结束了”也可能找到相关记录。它是找记忆的工具，不是另一个聊天角色。
同一个角色可以结合自己在私聊、群聊中获知的经历；其他角色并不会因此自动知道你的全部私聊。模型仍可能遗漏或理解错误。
卸载、清除应用数据或清理浏览器数据前，请导出备份，另存到手机外或自己信任的位置。
换手机、应用版与开发者版之间迁移，请导出备份后，在另一边导入或合并。合并前先保留原始备份。
普通备份不包含 API 密钥，下载的表情资源也需另行保留或重新下载。
官网注册登录是可选项。登录不等于聊天已上传云端，不会自动替你完成手机与电脑的云同步。

八、语音、账号与支持开发
语音入口用于配置角色专属声库，需要你提供对应的服务与合法可用的音色。没有配置声库时，不会用系统朗读代替角色配音。
你可以不注册，直接使用心链。官网邮箱账号由第三方认证服务提供，实际可用注册方式以登录页为准。登录功能与模型平台账号是两回事。
赞助完全自愿，不影响免登录和已有功能。关于页面中可以查看作者主页与支持开发入口。

霖老师主页：https://b23.tv/Jin7L7L
项目灵感：星伴。角色与二创配图的权利归各自权利人，素材记录保留在发布包的 licenses/character-art.json 中。

最后：先把“连接成功、正常聊天、备份可用”走通，再逐步开启其他功能。你不用一次理解所有设置。