欢迎来到知识星系
在这里,你将找到驾驭 SurveyKit 的一切所需,从启航到精通,每一步都有星光指引。
前往工具中心快速导航
常见问题 (FAQ)
入门与账户
SaaS模式和旧版静态模式有什么区别?
SaaS 模式 (推荐) 是 SurveyKit
的核心。它支持用户注册、登录,并拥有一个私人的管理后台,可以创建和管理多份问卷,并在线查看每份问卷的统计结果。这是功能最完整、最强大的使用方式。
旧版静态模式 则是一个无需登录的单问卷展示方案。您需要手动修改
public/questions.json
文件来定义一份问卷,它不支持多问卷管理和在线结果分析。这种方式更适合快速部署一个简单的、一次性的信息收集页面。
如果我忘记了密码怎么办?
目前我们正在开发密码找回功能。如果您急需重置密码,可以联系项目管理员进行手动处理。我们建议您使用密码管理器来妥善保管您的登录凭证。
数据安全是如何保障的?
我们极为重视数据安全。用户密码使用 `bcrypt` 加盐哈希存储;会话管理采用安全的 JWT;所有敏感API均需授权访问并设有速率限制;前后端数据传输经过严格校验。您可以查阅我们的安全中心文档了解更多细节。
问卷创建与管理
如何定制我问卷的外观(主题)?
请前往 工具中心,找到并进入“主题定制器”。在这里,您可以实时预览并调整问卷的主色调、背景、字体等视觉元素。完成设计后,一键即可生成对应的主题CSS代码,您可以将其应用到您的项目中。
目前支持哪些问题类型?
当前核心版本主要支持深度访谈式的单项选择题(包括“其他”选项的文本输入)。我们的 发展路线图 中已经规划了支持更多丰富的问题类型,如多选题、填空题、矩阵题、文件上传等,敬请期待!
AI分析是如何工作的?它会看到我的哪些数据?
AI人格分析功能会将您在问卷中提交的所有答案文本(不包括您的邮箱等个人身份信息)发送给火山方舟大模型。AI会基于这些回答内容,综合分析您的性格特质、思维方式和价值观,从而生成一份MBTI风格的报告。我们不会存储AI生成的报告,它仅在您的会话中一次性生成并展示。
部署与技术
部署到 Vercel 时最重要的步骤是什么?
最关键的一步是:在 Vercel 项目设置的 "General" 标签页下,将 **Root Directory
(根目录)** 修改为 public。这能确保 Vercel 正确地将
public 目录作为网站的根来提供静态文件服务,否则页面和API路由将无法正常工作。
我必须设置所有的环境变量吗?
不完全是,这取决于您需要的功能:
JWT_SECRET: 必需。用于用户认证核心功能。ARK_API_KEY: 如果您想使用AI人格分析功能,则为必需。RESEND_API_KEY&SENDER_EMAIL: 如果您想使用旧版邮件找回链接功能,则为必需。SaaS模式下此功能已弱化。ADMIN_TOKEN: 仅用于旧版API的后门访问,建议不设置或保持高度机密。
我该如何为这个项目做出贡献?
我们非常欢迎任何形式的贡献!您可以 Fork 我们的 GitHub 仓库,创建一个新分支进行修改(如修复Bug、实现新功能或改进文档),然后向我们提交一个 Pull Request。请在 PR 中详细描述您的更改。