這款開源調(diào)研系統(tǒng)越來越“懂事”了
問卷調(diào)查是了解用戶需求的重要橋梁,但搭建這座橋的過程卻常常讓人抓狂:復雜的選項配置、呆板的界面設計、繁瑣的數(shù)據(jù)管理……
調(diào)研為什么總是這么“肝”?

今天,HelloGitHub 帶來的開源調(diào)研系統(tǒng) XIAOJUSURVEY(小桔調(diào)研),由滴滴開源專為調(diào)研而生。無論是問卷、考試、測評還是復雜表單,它都能輕松搞定。更酷的是,它還集成了 AI 生成問卷 功能,通過對話即可生成問卷,支持實時預覽和調(diào)整,真正讓問卷設計變得“得心應手”。

GitHub 地址:github.com/didi/xiaoju-survey
一、XIAOJUSURVEY 是什么?
XIAOJUSURVEY(小桔調(diào)研)是一款輕量、安全的開源調(diào)研系統(tǒng),提供面向個人和企業(yè)的一站式解決方案,幫助用戶快速構建各類問卷、考試、測評和復雜表單,滿足多樣化的線上調(diào)研需求。

核心功能
易用性
- 多樣化數(shù)據(jù)采集:支持文本輸入、評分、投票、文件上傳等多種表單。
- 智能邏輯編排:配置顯示跳轉(zhuǎn)邏輯、選項引用等動態(tài)規(guī)則,輕松定制復雜問卷。
- 高效團隊協(xié)作:支持空間管理與多角色權限管理。
- 數(shù)據(jù)分析與導出:內(nèi)置分題統(tǒng)計、交叉分析和數(shù)據(jù)導出功能。
美觀性
- 主題定制:支持品牌化定制,包括顏色、背景、Logo 和結果頁。
- 多端適配:通過嵌入式 SDK,輕松適配 Web 與移動端場景。
安全與擴展性
- 安全保障:內(nèi)置傳輸加密、敏感詞過濾和發(fā)布審查功能。
- 自定義集成:支持 Hook 配置,靈活對接第三方系統(tǒng)。
二、快速上手
XIAOJUSURVEY(小桔調(diào)研)依賴 MongoDB,如果你本地沒有現(xiàn)成的 MongoDB,那么最簡單的辦法就是 docker-compose 一鍵安裝。
只需將項目中的 docker-compose.yml 內(nèi)容復制到本地,并在文件所在的目錄,創(chuàng)建一個名為 .env 的文件,配置數(shù)據(jù)庫和 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=
執(zhí)行 sudo docker-compose up 命令啟動服務。
如果遇到了 Client.Timeout 問題,可在 /etc/docker/daemon.json 中設置 Docker 鏡像源,記得重啟 Docker 使其生效。
{
"registry-mirrors": ["https://docker.m.daocloud.io"]
}
稍等片刻,即可通過 127.0.0.1:8080 訪問系統(tǒng),完成部署!

三、XIAOJUSURVEY 的“新技能”
看到在這里,是不是感覺 XIAOJUSURVEY(小桔調(diào)研)表現(xiàn)中規(guī)中矩,想知道它的有趣之處,我們接著往下看!
在過去半年,XIAOJUSURVEY 不斷進化,新增了一些“懂事兒”的功能,讓調(diào)研更加智能和高效。
3.1 AI 生成問卷
通過自然語言描述問卷需求(對話),即可自動生成問卷,包括單選、多選、矩陣等常見題型,支持實時編輯和預覽。無需逐題配置,使用門檻大幅降低。

3.2 跨端 SDK
基于 React Native 開發(fā)的 SDK,支持問卷嵌入 Web 和移動端應用。通過 Survey.init(options) 快速配置,實現(xiàn)靈活適配多端場景。

3.3 Excel 導入問卷
支持直接上傳本地 Excel 文件,自動轉(zhuǎn)換為線上可編輯的問卷。

3.4 多級聯(lián)題
實現(xiàn)選項間的層級化關聯(lián),輕松配置復雜邏輯,優(yōu)化問卷長度,提升用戶填寫體驗。

3.5 回收站功能
完整的問卷刪除與恢復管理能力,防止誤操作導致數(shù)據(jù)丟失。

四、技術解讀
4.1 AI 驅(qū)動的問卷生成

XIAOJUSURVEY 的 AI 問卷生成功能背后,融合了多項熱門技術:
- 提示詞工程:通過系統(tǒng)提示詞明確題型標注方式,優(yōu)化生成邏輯。
- 結構化輸出:采用可解析的文本格式作為中間產(chǎn)物,確保生成結果準確映射到內(nèi)部 Schema。
- 實時交互:支持流式渲染、反饋與重生成。
- 穩(wěn)定性與容錯:內(nèi)置預處理、失敗重試機制,降級回退到最小可用問卷骨架。
- 安全合規(guī):對輸入做敏感信息屏蔽,記錄調(diào)用日志,避免數(shù)據(jù)泄露。
4.2 跨端適配的技術實現(xiàn)
隨著嵌入式調(diào)研卡片(embedded survey card)在 Web 和移動應用的廣泛應用,越來越多企業(yè)通過小巧直觀的界面內(nèi)嵌問卷,高效獲取用戶反饋與產(chǎn)品數(shù)據(jù)。研究數(shù)據(jù)指出,嵌入式調(diào)查可在用戶無需跳轉(zhuǎn)頁面的前提下收集意見,大幅提升響應率與用戶體驗。
基于此背景,XIAOJUSURVEY 利用 React Native 推出了移動端跨端 SDK,為業(yè)務方提供了與 Web 端一致的調(diào)研接入能力。該 SDK 不依賴第三方 UI 框架,采用自研組件體系,確保跨端界面風格統(tǒng)一且易于定制。開發(fā)者可通過統(tǒng)一的初始化入口 Survey.init(options) 快速配置 host、端口、應用 ID 與渠道等參數(shù),構建靈活適配多端的調(diào)研流程。

SDK 架構采用“協(xié)議驅(qū)動 + 組件化渲染”模式,遵循配置加載、協(xié)議解析、組件呈現(xiàn)與回調(diào)處理四大流程,底層基于問卷協(xié)議與題型協(xié)議驅(qū)動。

交互層面,目前支持 Radio、CheckBox、Input、TextArea、Star 和 Grade 六類題型,結合主題配置與容器化設計,既滿足卡片式嵌入場景,也支持彈窗式展示。基礎 UI 組件通過統(tǒng)一主題配置,可輕易實現(xiàn)品牌化定制,提升平臺一致性和用戶信任感。
五、最后
作為一個開源項目,XIAOJUSURVEY(小桔調(diào)研)持續(xù)優(yōu)化迭代,專注于用智能化的方案解決調(diào)研難題。如果你正在尋找一款輕量、高效的調(diào)研工具,不妨試試小桔調(diào)研!

官網(wǎng):xiaojusurvey.didi.cn
GitHub 地址:github.com/didi/xiaoju-survey
開源不易,歡迎大家為項目點亮 Star!
作者:削微寒
掃描左側(cè)的二維碼可以聯(lián)系到我

本作品采用署名-非商業(yè)性使用-禁止演繹 4.0 國際 進行許可。


浙公網(wǎng)安備 33010602011771號