前言¶

在 DSH 中，模型調用工具時如果每次只向用戶問一個問題，任務開始前需要確認多個事項時會產生多次來回。dsh-survey 把這些問題合併成問卷：模型一次調用 do_a_survey 提交問題列表，用戶在同一個界面中填寫並提交，答案以結構化數據返回。

這是什麼¶

dsh-survey 是 DeepSeek Harness（DSH）插件，倉庫爲 jinhuang712/dsh-survey，許可證爲 MIT。它提供 do_a_survey 工具，用於向用戶一次性提交 1 到 10 個以上的問題。安裝後，do_a_survey 工具和 survey UI 在 Web profile 中永久可用。

核心能力¶

問題類型¶

dsh-survey 支持五種問題類型：

• single
• multi
• yes-no
• compare
• open

呈現模式¶

Web UI 根據 mode 渲染問卷：

• compact：單題卡片，用於正好 1 個問題。
• inline：嵌入對話列，用於多個問題且不含 compare。
• overlay：全屏 1180px 展示，用於 compare 或寬畫布。
• grid：全屏網格矩陣，用於大量簡單問題。

答案與跳過¶

每個問題支持跳過。提交時，被跳過的問題標記爲 skipped: true。答案以如下數據格式返回：

{ id, selected, custom?, skipped? }

如果 30 分鐘內無人提交，survey 會超時失敗，而不是無限掛起。

渲染與無障礙¶

• 支持完整 Markdown 渲染和顏色語法 {color:red}text{/color}。
• 提交後顯示兩列 question → answer recap。
• 支持英文和中文界面，並跟隨 Web UI 語言設置。
• 支持鍵盤焦點和 radio/checkbox 無障礙語義。

安裝與啓用¶

安裝到 web profile：

dsh plugin --profile web add "github:jinhuang712/dsh-survey#v1.1.0"

安裝完成後，重啓 dsh web 並刷新頁面。

如果 dsh profile 目錄是 pnpm workspace，需要透傳 -w 參數：

dsh plugin --profile web add -w "github:jinhuang712/dsh-survey#v1.1.0"

包依賴中列出的 peerDependencies 要求：

@deepseek-ai/dsh-tools ^0.1.0-rc.6
cordis ^4.0.0-rc.7
react ^18.2.0

伴隨技能 dsh-survey 會隨安裝註冊，包含四種模式、五種問題類型的使用指南和 dynamic-plugin fallback recipe。

典型用法¶

告訴模型要收集什麼，模型隨後調用：

do_a_survey(mode, questions)

其中 mode 爲必填。常見選擇如下：

• 正好 1 個問題：使用 compact。
• 多個問題且沒有 compare：使用 inline。
• 有 compare 或需要寬畫布：使用 overlay。
• 大量簡單問題：使用 grid。

一個 inline 示例會包含 single、multi、boolean、open 類型的問題；提交後，模型收到的是每個問題的結構化答案，而不是一段需要自行解析的自然語言。

適用場景與注意¶

適合需要一次性確認多個選項、範圍、是否項或備註的場景。由於答案以數據返回，並且每題可跳過，比較適合把模型需要的決策集中到一次用戶交互中。

使用前注意：

• 資料未給出明確的 permission 聲明；插件以當前 dsh 進程權限運行，安裝前應檢查源碼與 MIT 許可證。
• 如果 30 分鐘內未提交，問卷會超時失敗。
• 安裝命令固定使用 Web profile；如果 profile 目錄是 pnpm workspace，需要加 -w。

鏈接¶

• GitHub：https://github.com/jinhuang712/dsh-survey
• 插件目錄頁：https://www.skillhub.cn/plugins/jinhuang712/dsh-survey