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

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

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

今天，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！