# Kira 绮梦使用指南
Kira 是一款面向角色对话与故事创作的 AI 聊天应用。你可以导入角色卡，整理世界书、预设和记忆，再选择平台服务或自行配置兼容的 AI 接口。本文按实际使用顺序介绍主要功能。
> 本指南基于当前应用界面编写。不同版本、平台和所选服务可能略有差异；生成内容和功能可用性取决于所用模型、网络及服务状态。
## 目录
- [快速开始](#start)
- [角色卡与对话](#characters)
- [模型与 API 连接](#connections)
- [世界书、预设与长记忆](#library)
- [本地备份与恢复](#backup)
- [数据与隐私](#data)
- [常见问题](#faq)
## 快速开始
1. 打开底部的 **角色**，新建角色，或选择 **导入角色** 添加 PNG / JSON 角色卡。
2. 选择 AI 服务：使用应用提供的平台服务，或打开底部的 **API** 添加自己的连接。使用自定义连接时，填写服务地址、API Key 和模型，并进行连接测试。
3. 选择角色，创建聊天会话，在输入框发送第一条消息。
如果还没有角色，可以先从角色页新建一个。若发送失败，先确认当前会话使用的连接和模型，再检查网络与服务额度。
## 角色卡与对话
### 导入角色卡
在 **角色 → 导入角色** 中，可以从文件、相册、剪贴板或 URL 导入。文件导入支持 PNG、JSON；相册导入使用 PNG；剪贴板可粘贴角色卡 JSON。URL 导入支持部分角色页面及 PNG / JSON 直链，具体支持范围以应用内提示为准。
导入前会显示预览和校验提示。核对角色名称、头像、首条消息等信息后，再点 **确认导入**。如果角色卡内包含世界书或正则规则，导入结果会分别提示。普通图片不一定含有角色卡元数据，不能仅凭 PNG 扩展名判断可导入。
### 开始和管理对话
在角色页选择角色开始聊天；已有会话可从 **聊天** 页继续打开。聊天页支持搜索角色或最近对话。发送消息前确认当前使用的模型与连接，生成中可点击 **停止**。
会话内的回复操作可能包括重新生成、继续生成、切换候选回复，以及编辑后重发。编辑后重发会从所选消息重新生成后续对话；删除或撤回前请阅读确认提示。
## 模型与 API 连接
打开底部 **API** 管理连接。添加自定义连接时，选择提供商或兼容协议，填写服务地址与 API Key，选择或手动输入模型 ID，然后保存。不同服务的地址、模型和密钥权限并不相同，请以对应服务商的文档为准。
连接测试依次检查模型列表与探测消息。即使模型列表不可读取，也可能通过手动填写模型 ID 完成探测；以最终探测结果为准。测试成功后可将该连接设为默认，或在会话中切换连接。
> 不要把 API Key 发给他人，也不要将密钥写进角色卡或公开截图。为非本机自定义端点优先使用 HTTPS。
## 世界书、预设与长记忆
在 **更多 → 资料库** 中可以打开 **世界书资料库** 与 **预设资料库**，导入已有资料或手动创建。世界书用于组织设定条目；预设用于管理回复风格、生成参数和提示词片段。资料可以有全局默认设置，也可以针对会话选择，具体以选择页显示的生效状态为准。
在 **更多 → 长记忆设置** 中可以查看和调整记忆相关选项。长记忆用于整理较长对话中的信息，但不保证模型在每次回复中完整记住所有细节；重要设定仍建议在角色卡、世界书或对话中明确写出。
回复风格与生成参数会受到模型和服务端能力约束。例如平台官方聊天的流式输出设置与自定义连接不同，应用内会标注不生效的选项。修改后可用一段短对话比较效果。
## 本地备份与恢复
打开 **更多 → 聊天记录备份**。选择 **导出**，检查需要包含的内容后，将备份保存到你选择的位置或通过系统分享；选择 **导入** 时，先选文件并核对预览，再确认合并。
备份包含所选聊天及关联资料，可能包含角色卡、世界书、正则和预设；媒体与上下文日志按导出选项处理。备份不包含 API 密钥、登录信息和设备绝对路径。导入是合并流程，完成后应查看结果中的新建、复用与警告数量。
> 备份文件可能包含私人聊天内容。请妥善保管，分享前核对接收方。**重置应用** 会删除本机数据，不能用作备份操作；先确认已有可读取的备份文件。
## 数据与隐私
聊天记录、角色卡、预设、世界书和连接配置主要保存在设备本地，本地备份也由你主动选择保存位置。使用自定义 AI 连接时，完成请求所需的输入、上下文、设定和认证信息会发送到你配置的端点；使用平台 AI、语音、图片、账户或购买等功能时，相应资料会经 Kira 平台及实际服务提供方处理。
因此，“本地保存”不代表“所有功能都离线运行”或“聊天内容绝不发送到网络”。使用前请了解所选服务商的数据处理方式，不要在不信任的服务中输入敏感资料。账号删除与删除本机数据、取消商店订阅是不同操作。
## 常见问题
### 角色卡导入失败怎么办？
先确认文件是包含角色数据的 PNG 或有效 JSON，并查看导入预览中的错误。URL 导入失败时，检查网络、链接类型及应用内支持范围；也可以先保存为文件再导入。
### 连接成功却无法发送消息？
确认当前会话选择的连接和模型，检查 API Key 权限、余额/额度、服务地址与网络。模型列表读取失败不一定代表聊天不可用，可手动填写模型 ID 并运行探测消息测试。
### 更换手机后聊天会自动出现吗？
不要假设本地数据会自动同步。请在旧设备上导出聊天备份，安全地传到新设备后再导入，并检查导入结果。API Key 等敏感配置需要按实际情况重新设置。
### 长记忆为什么没有提到某个细节？
记忆整理和模型上下文都存在限制。检查长记忆是否开启、相关设定是否写入，以及当前预设与世界书的生效范围。对关键情节可在对话里重新明确，而不是只依赖自动召回。
---
本文是功能使用说明，不替代应用内的隐私政策、服务条款及第三方 AI 服务商的说明。