这款开源调研系统越来越“懂事”了

问卷调查是了解用户需求的重要桥梁,但搭建这座桥的过程却常常让人抓狂:复杂的选项配置、呆板的界面设计、繁琐的数据管理......

调研为什么总是这么"肝"?

今天,HelloGitHub 带来的开源调研系统 XIAOJUSURVEY(小桔调研),由滴滴开源专为调研而生。无论是问卷、考试、测评还是复杂表单,它都能轻松搞定。更酷的是,它还集成了 AI 生成问卷 功能,通过对话即可生成问卷,支持实时预览和调整,真正让问卷设计变得"得心应手"。

GitHub 地址:github.com/didi/xiaoju-survey

一、XIAOJUSURVEY 是什么?

**XIAOJUSURVEY(小桔调研)**是一款轻量、安全的开源调研系统,提供面向个人和企业的一站式解决方案,帮助用户快速构建各类问卷、考试、测评和复杂表单,满足多样化的线上调研需求。

核心功能

易用性

  • 多样化数据采集:支持文本输入、评分、投票、文件上传等多种表单。
  • 智能逻辑编排:配置显示跳转逻辑、选项引用等动态规则,轻松定制复杂问卷。
  • 高效团队协作:支持空间管理与多角色权限管理。
  • 数据分析与导出:内置分题统计、交叉分析和数据导出功能。

美观性

  • 主题定制:支持品牌化定制,包括颜色、背景、Logo 和结果页。
  • 多端适配:通过嵌入式 SDK,轻松适配 Web 与移动端场景。

安全与扩展性

  • 安全保障:内置传输加密、敏感词过滤和发布审查功能。
  • 自定义集成:支持 Hook 配置,灵活对接第三方系统。

二、快速上手

XIAOJUSURVEY(小桔调研)依赖 MongoDB,如果你本地没有现成的 MongoDB,那么最简单的办法就是 docker-compose 一键安装。

只需将项目中的 docker-compose.yml 内容复制到本地,并在文件所在的目录,创建一个名为 .env 的文件,配置数据库和 AI 模型(可选):

复制代码
MONGO_INITDB_ROOT_USERNAME=username
MONGO_INITDB_ROOT_PASSWORD=password
XIAOJU_SURVEY_MONGO_AUTH_SOURCE=admin

# 如需启用 AI 功能
AImodel_API_URL=
AImodel_API_KEY=
AImodel_MODEL=

执行 sudo docker-compose up 命令启动服务。

如果遇到了 Client.Timeout 问题,可在 /etc/docker/daemon.json 中设置 Docker 镜像源,记得重启 Docker 使其生效

复制代码
{
  "registry-mirrors": ["https://docker.m.daocloud.io"]
}

稍等片刻,即可通过 127.0.0.1:8080 访问系统,完成部署!

三、XIAOJUSURVEY 的"新技能"

看到在这里,是不是感觉 XIAOJUSURVEY(小桔调研)表现中规中矩,想知道它的有趣之处,我们接着往下看!

在过去半年,XIAOJUSURVEY 不断进化,新增了一些"懂事儿"的功能,让调研更加智能和高效。

3.1 AI 生成问卷

通过自然语言描述问卷需求(对话),即可自动生成问卷,包括单选、多选、矩阵等常见题型,支持实时编辑和预览。无需逐题配置,使用门槛大幅降低。

3.2 跨端 SDK

基于 React Native 开发的 SDK,支持问卷嵌入 Web 和移动端应用。通过 Survey.init(options) 快速配置,实现灵活适配多端场景。

3.3 Excel 导入问卷

支持直接上传本地 Excel 文件,自动转换为线上可编辑的问卷。

3.4 多级联题

实现选项间的层级化关联,轻松配置复杂逻辑,优化问卷长度,提升用户填写体验。

3.5 回收站功能

完整的问卷删除与恢复管理能力,防止误操作导致数据丢失。

四、技术解读

4.1 AI 驱动的问卷生成

XIAOJUSURVEY 的 AI 问卷生成功能背后,融合了多项热门技术:

  • 提示词工程:通过系统提示词明确题型标注方式,优化生成逻辑。
  • 结构化输出:采用可解析的文本格式作为中间产物,确保生成结果准确映射到内部 Schema。
  • 实时交互:支持流式渲染、反馈与重生成。
  • 稳定性与容错:内置预处理、失败重试机制,降级回退到最小可用问卷骨架。
  • 安全合规:对输入做敏感信息屏蔽,记录调用日志,避免数据泄露。

4.2 跨端适配的技术实现

随着嵌入式调研卡片(embedded survey card)在 Web 和移动应用的广泛应用,越来越多企业通过小巧直观的界面内嵌问卷,高效获取用户反馈与产品数据。研究数据指出,嵌入式调查可在用户无需跳转页面的前提下收集意见,大幅提升响应率与用户体验

基于此背景,XIAOJUSURVEY 利用 React Native 推出了移动端跨端 SDK,为业务方提供了与 Web 端一致的调研接入能力。该 SDK 不依赖第三方 UI 框架,采用自研组件体系,确保跨端界面风格统一且易于定制 。开发者可通过统一的初始化入口 Survey.init(options) 快速配置 host、端口、应用 ID 与渠道等参数,构建灵活适配多端的调研流程。

SDK 架构采用"协议驱动 + 组件化渲染"模式,遵循配置加载、协议解析、组件呈现与回调处理四大流程,底层基于问卷协议与题型协议驱动。

交互层面,目前支持 Radio、CheckBox、Input、TextArea、Star 和 Grade 六类题型,结合主题配置与容器化设计,既满足卡片式嵌入场景,也支持弹窗式展示。基础 UI 组件通过统一主题配置,可轻易实现品牌化定制,提升平台一致性和用户信任感。

五、最后

作为一个开源项目,XIAOJUSURVEY(小桔调研)持续优化迭代,专注于用智能化的方案解决调研难题。如果你正在寻找一款轻量、高效的调研工具,不妨试试小桔调研!

官网:xiaojusurvey.didi.cn

GitHub 地址:github.com/didi/xiaoju-survey

开源不易,欢迎大家为项目点亮 Star