問卷調(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！