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

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

调研为什么总是这么“肝”？

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

！