错误信息说明

本文档列出了使用zenstory时可能遇到的常见错误信息及其解决方法，帮助您快速定位问题并恢复使用。

---

常见错误信息

通用错误

错误信息	原因	解决方法
服务器内部错误，请稍后重试	服务器遇到未预期的错误	刷新页面重试；如持续出现，请联系客服
请求参数验证失败	提交的数据格式不正确	检查输入内容是否符合要求（如邮箱格式、必填项等）
数据库操作失败	数据保存或读取时出错	稍后重试；如持续出现，请联系客服
服务暂时不可用	系统维护或服务过载	等待几分钟后重试
请求格式错误	API 请求格式不符合规范	刷新页面，清除浏览器缓存后重试
资源不存在	访问的内容已被删除或不存在	返回上一页，检查资源是否仍存在

账号与登录

错误信息	原因	解决方法
用户名或密码错误	输入的账号信息不正确	检查邮箱和密码是否正确；尝试找回密码
登录已过期，请重新登录	Token 已过期	重新登录即可恢复
无效的登录凭证	Token 无效或被篡改	退出登录后重新登录
账户已被禁用	账号被管理员禁用	联系客服了解原因并申请恢复
用户名已被注册	该用户名已存在	更换用户名注册
邮箱已被注册	该邮箱已注册过账号	直接登录，或使用其他邮箱注册
邮箱未验证，请先验证邮箱	注册后未完成邮箱验证	检查邮箱（包括垃圾邮件）获取验证链接
验证码无效或已过期	验证码已过期或输入错误	重新发送验证码

项目相关

错误信息	原因	解决方法
项目不存在	项目可能已被删除	返回项目列表，确认项目是否存在
项目已存在	同名项目已创建	更换项目名称
项目已删除	项目处于回收站状态	在「已删除」中恢复项目
项目中没有草稿可导出	项目内无草稿类型文件	先创建草稿内容后再导出
您没有权限执行此操作	当前账号无该项目权限	确认是否为项目所有者

文件相关

错误信息	原因	解决方法
文件不存在	文件可能已被删除	刷新页面，检查文件树
文件类型无效	文件类型不在支持范围内	使用支持的文件类型（大纲、草稿、角色、设定、素材）
向量搜索服务不可用	AI 搜索功能暂时离线	稍后重试；功能恢复后可继续使用

版本与快照

错误信息	原因	解决方法
版本不存在	指定的版本记录不存在	刷新版本历史列表
未找到文件的版本	该文件尚未创建任何版本	编辑并保存文件后会自动创建版本
删除版本失败	版本删除操作失败	稍后重试
恢复版本失败	版本恢复操作失败	稍后重试
快照不存在	指定的快照不存在	刷新页面后重试
比较快照失败	快照对比时出错	稍后重试
创建快照失败	快照创建失败	检查文件是否有内容，稍后重试

对话与语音

错误信息	原因	解决方法
对话会话不存在	对话记录已被删除	创建新的对话会话
消息不存在	消息记录不存在	刷新对话列表
腾讯云 API 凭证未配置	语音识别服务未启用	该功能需要管理员配置，请联系客服
音频数据解码失败	录音文件格式或内容有问题	重新录音后提交
语音识别 API 请求失败	语音服务暂时不可用	稍后重试

邀请码

错误信息	原因	解决方法
邀请码无效	输入的邀请码不存在	检查邀请码格式（如 A1B2-C3D4）是否正确
邀请码已过期	邀请码已超过有效期	获取新的邀请码
邀请码已用完	邀请码使用次数已达上限	获取新的邀请码
已达到邀请码数量上限	每位用户最多创建 3 个邀请码	删除不用的邀请码后再创建

---

如何报告错误

如果您遇到的错误未在上述列表中，或问题持续无法解决，请按以下步骤提交反馈：

1. 记录错误信息：复制完整的错误提示文字
2. 截图错误界面：包含错误弹窗或高亮区域
3. 描述操作步骤：详细说明出现错误前的操作
4. 提供设备信息：浏览器类型、版本、操作系统

---

联系支持

提交问题时，请附上以下信息以加快处理速度：

• 错误截图：包含完整错误信息
• 复现步骤：一步步描述如何触发错误
• 设备信息：浏览器版本（如 Chrome 120）、操作系统（如 macOS 14）
• 账号信息：出现问题时的账号邮箱（可脱敏处理）

我们将尽快处理您反馈的问题，感谢您的支持与理解！

---

Error Messages Reference

This document lists common error messages you may encounter while using zenstory and their solutions, helping you quickly identify issues and resume usage.

---

Common Error Messages

General Errors

Error Message	Cause	Solution
Internal server error, please try again later	Server encountered an unexpected error	Refresh page and retry; if persistent, contact customer support
Request parameter validation failed	Submitted data format is incorrect	Check if input content meets requirements (e.g., email format, required fields)
Database operation failed	Error during data save or read	Retry later; if persistent, contact customer support
Service temporarily unavailable	System maintenance or service overload	Wait a few minutes then retry
Request format error	API request format doesn't match specifications	Refresh page, clear browser cache then retry
Resource not found	Accessed content has been deleted or doesn't exist	Go back to previous page, check if resource still exists

Account & Login

Error Message	Cause	Solution
Invalid username or password	Entered account information is incorrect	Check if email and password are correct; try password recovery
Login expired, please log in again	Token has expired	Simply log in again to restore
Invalid login credentials	Token is invalid or has been tampered with	Log out then log in again
Account has been disabled	Account has been disabled by administrator	Contact customer support to understand reason and apply for restoration
Username already registered	This username already exists	Choose a different username to register
Email already registered	This email has already been used to register	Log in directly, or register with a different email
Email not verified, please verify email first	Email verification not completed after registration	Check email (including spam folder) for verification link
Invalid or expired verification code	Verification code has expired or was entered incorrectly	Resend verification code

Project Related

Error Message	Cause	Solution
Project not found	Project may have been deleted	Return to project list, confirm if project exists
Project already exists	Project with same name has been created	Choose a different project name
Project has been deleted	Project is in trash status	Restore project from "Deleted"
No drafts available for export in project	No draft-type files in project	Create draft content before exporting
You don't have permission to perform this operation	Current account doesn't have permission for this project	Confirm if you are the project owner

File Related

Error Message	Cause	Solution
File not found	File may have been deleted	Refresh page, check file tree
Invalid file type	File type is not within supported range	Use supported file types (outline, draft, character, lore, material)
Vector search service unavailable	AI search feature is temporarily offline	Retry later; feature will be available after restoration

Versions & Snapshots

Error Message	Cause	Solution
Version not found	Specified version record doesn't exist	Refresh version history list
No versions found for file	This file hasn't created any versions yet	Version will be created automatically after editing and saving file
Failed to delete version	Version deletion operation failed	Retry later
Failed to restore version	Version restoration operation failed	Retry later
Snapshot not found	Specified snapshot doesn't exist	Refresh page and retry
Failed to compare snapshots	Error during snapshot comparison	Retry later
Failed to create snapshot	Snapshot creation failed	Check if file has content, retry later

Conversations & Voice

Error Message	Cause	Solution
Conversation session not found	Conversation record has been deleted	Create new conversation session
Message not found	Message record doesn't exist	Refresh conversation list
Tencent Cloud API credentials not configured	Voice recognition service not enabled	This feature requires administrator configuration, contact customer support
Audio data decoding failed	Recording file format or content has issues	Re-record and submit
Voice recognition API request failed	Voice service temporarily unavailable	Retry later

Invitation Codes

Error Message	Cause	Solution
Invalid invitation code	Entered invitation code doesn't exist	Check if invitation code format (e.g., A1B2-C3D4) is correct
Invitation code expired	Invitation code has passed expiration date	Obtain a new invitation code
Invitation code used up	Invitation code usage limit reached	Obtain a new invitation code
Maximum invitation code limit reached	Each user can create at most 3 invitation codes	Delete unused invitation codes before creating new ones

---

How to Report Errors

If you encounter an error not listed above, or if the issue persists, please submit feedback following these steps:

1. Record Error Message: Copy the complete error prompt text
2. Screenshot Error Interface: Include error popup or highlighted area
3. Describe Operation Steps: Explain in detail the operations before the error occurred
4. Provide Device Information: Browser type, version, operating system

---

Contact Support

When submitting an issue, please include the following information to speed up processing:

• Error Screenshot: Include complete error message
• Reproduction Steps: Step-by-step description of how to trigger the error
• Device Information: Browser version (e.g., Chrome 120), operating system (e.g., macOS 14)
• Account Information: Account email when problem occurred (can be anonymized)

We will process your reported issue as soon as possible. Thank you for your support and understanding!