常见问题

账户与登录

忘记密码怎么办？

在登录页面点击”忘记密码”，输入注册时使用的邮箱地址，系统会发送重置密码链接。如果收件箱没有找到邮件，请检查垃圾邮件文件夹。

账户被锁定怎么办？

连续 5 次输入错误密码后，账户会被临时锁定 30 分钟。解锁后建议：

1. 立即修改密码
2. 检查是否有陌生设备登录记录
3. 开启双因素认证

如果你急需解除锁定，请联系技术支持。

可以更换注册邮箱吗？

可以。在”账户设置”中点击”更换邮箱”，系统会向新邮箱发送验证链接。新邮箱验证成功后，旧邮箱将不再可用。

支持哪些登录方式？

目前支持以下登录方式：

• 邮箱 + 密码
• 微信扫码登录
• GitHub 账号登录
• 企业 SSO（企业版）

空间与内容

最多可以创建多少个空间？

各套餐的空间数量限制如下：

内容有存储上限吗？

内容数量没有上限。媒体文件存储容量受套餐限制：

• 免费版：1GB
• 专业版：50GB
• 企业版：按需定制

超出容量后无法上传新文件，建议清理不必要的文件或升级套餐。

可以导入其他平台的内容吗？

支持从以下平台导入内容：

• WordPress（XML 导出文件）
• Medium（导出 HTML）
• Notion（导出 Markdown）
• 通用 Markdown 文件

导入路径：“工具 > 数据导入 > 选择平台 > 上传文件 > 映射字段 > 开始导入”

为什么发布的内容在前端看不到？

请检查以下可能的原因：

1. 内容状态 — 确认内容状态是”已发布”而不是”草稿”
2. 分类可见性 — 确认所属分类没有设置访问密码或隐藏
3. 缓存问题 — 尝试强制刷新或清除 CDN 缓存
4. 域名解析 — 如果使用自定义域名，检查 DNS 解析是否正常
5. 空间状态 — 确认空间没有设置为”维护模式”

如果以上都正常，在浏览器中打开开发者工具（F12）查看 Console 是否有错误信息，这有助于定位问题。

编辑器

为什么 Markdown 渲染和预览不一致？

编辑器和预览使用不同的渲染引擎，极少数情况下渲染结果会有细微差异。如果遇到这种情况：

1. 检查 Markdown 语法是否正确
2. 确保代码块有正确的语言标识
3. HTML 标签在预览时可能被转义

如何备份我编辑中的内容？

编辑器会每 30 秒自动保存草稿，你也可以按 Ctrl + S 手动保存。此外：

• 每次发布或更新都会生成版本快照
• 在版本历史中可以恢复到任意历史版本
• 你可以将内容导出为 Markdown 文件

编辑内容时图片上传失败？

图片上传失败通常由以下原因导致：

API 与集成

API 返回 401 错误？

401 错误表示认证失败，请检查：

1. API Token 是否正确传入请求头
2. Token 是否已经过期或被吊销
3. Token 是否有访问该资源的权限
4. 请求的 Space ID 是否属于该 Token

Webhook 收不到推送？

请逐项排查：

1. 在后台 Webhook 配置页点击”发送测试”，确认测试事件能否到达
2. 检查你的服务器日志是否收到任何请求
3. 确认 Webhook URL 是公网可达的（不支持内网地址）
4. 检查 Webhook 的签名验证逻辑是否正确
5. 确保你的服务器在 5 秒内返回 200 状态码

# 测试 Webhook 连通性
curl -X POST https://your-server.com/webhook \
  -H "Content-Type: application/json" \
  -d '{"type": "test", "data": {"message": "Hello"}}'

API 速率限制是多少？

不同套餐的速率限制：

• 免费版：60 次/分钟
• 专业版：300 次/分钟
• 企业版：1000 次/分钟（可申请提高）

超过限制会返回 429 状态码，建议在客户端实现重试和退避机制。

计费与套餐

免费版和专业版有什么区别？

如何升级或降级套餐？

在”设置 > 计费”页面选择新套餐，系统会按比例折算差价。升级立即生效，降级在当前周期结束后生效。

可以随时取消订阅吗？

可以。取消后当前付费周期仍可使用全部功能，周期结束后自动转为免费版。取消前请确保已备份重要数据。

技术支持

如何联系技术支持？

• 邮件支持 — support@shanjing.space（工作日 4 小时内回复）
• 在线客服 — 后台右下角点击气泡图标（9:00-18:00）
• 帮助中心 — docs.shanjing.space（自助查询）
• 企业客户 — 专属客户经理一对一服务

提交工单时建议提供的信息

为了更快地解决问题，建议在提交工单时提供以下信息：

1. 你的空间 ID（在”设置 > 通用”中查看）
2. 问题发生的具体时间和操作步骤
3. 浏览器类型和版本
4. 相关的截图或录屏
5. 浏览器控制台的错误信息（如有）

总结

本文汇总了使用闪境空间时最常见的问题和解决方法。如果你遇到文中没有覆盖到的问题，欢迎通过技术支持渠道联系我们。闪境空间团队会持续更新本文档，帮助所有用户更顺畅地使用产品。