问卷调查是了解用户需求的重要桥梁，但搭建这座桥的过程却常常让人抓狂：复杂的选项配置、呆板的界面设计、繁琐的数据管理……
调研为什么总是这么“肝”？
今天，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！
