前言¶
在 DeepSeek Harness (DSH) 的开发实践中，ask_user_question 工具通常只能处理扁平的 1-3 个问题。当需要收集跨多个交互维度的期望、验收标准或范围界定时，这种简单的线性提问无法满足需求。我们需要的是具备路径分支、深度选项和快速决策能力的系统。
dsh-rich-questions 插件提供了这种能力。它扩展了 DSH Web GUI 中的 ask_survey 工具，允许智能体从对话上下文中实时构建问卷，并在聊天界面直接渲染和作答。
这是什么¶
这是一个由 svgop 维护的 DSH 客户端插件。它是一个 MIT 许可证的开源项目，零运行时依赖。该插件为 Web GUI 增加了富分支问卷系统，支持基于图的分支逻辑、延迟悬停洞察、Mermaid 流程图、快速模式以及 reroll/push/discuss 等操作。
核心功能¶
该插件提供了以下能力：
- 分支路径：基于图的分支逻辑，每个选项定义了下一题（
next），选择选项 C 会触发不同于选项 A 的后续问题。 - 每选项智能：每个选项携带洞察、来源和引用，以及紧凑的 Mermaid 图。通过点击展开披露（
?文本，分支图标图表），提供信息而非悬停突袭。 - 内联理由：选中选项后可获得铅笔图标，允许在提交前用一行字解释选择原因（Justify），这些理由会随答案一起传递给智能体。
- 快速模式：提供 a-f 六个整体问卷决策模板，点击即可应用完整的、连贯的答案映射并提交。例如，“像 Vercel/Railway 那样交付：优先打磨 + DX”。
- 银行 & 继续：支持每步提交。在长问卷中，当前答案会自动保存在主机端，存活于刷新，并可在任意浏览器中继续。
- 持久化进度：问卷草稿会自动保存。刷新页面或切换标签后返回，进度、问题和答案保持不变。
- 预飞行引导：在第一题之前提供 Reroll（重写并升级）、Push（生成可复用研究产物）和 Discuss（切换到讨论模式）操作。
- 语言跟随：问卷语言根据聊天语言自动切换（英语/中文）。
- 主机权威：待定问卷状态保存在主机端，关闭浏览器或标签页不会丢失状态，重新连接时会自动恢复。
安装与启用¶
使用 DSH CLI 进行安装：
dsh plugin --profile web add dsh-rich-questions
安装完成后，重启 dsh web 进程并刷新浏览器标签页。ask_survey 工具将出现在所有智能体预设中。
如果是通过 Fork 安装：
dsh plugin --profile web add file:/path/to/dsh-rich-questions
典型用法¶
Agent 可以根据对话上下文动态生成问卷。问卷渲染在 composer 座位中，每页显示一个问题，并展示当前路径的进度。Agent 可以使用 JSON 定义问卷结构，例如：
{
"survey": {
"title": "Expectation alignment",
"intro": "Short markdown preamble — the first page.",
"entry": "q1",
"questions": {
"q1": {
"prompt": "Which direction fits this release?",
"options": {
"a": { "label": "Stability", "next": "q2" },
"b": { "label": "Speed", "next": "q3" }
}
}
}
}
}
Agent 响应后，用户在聊天输入框区域直接进行作答。支持多选、自由文本、跳过逻辑等操作。
适用场景与注意¶
该插件适合处理需要分支逻辑、深度选项和快速决策的复杂工作流，如范围界定、验收标准收集等。
注意：
* 需要安装 DSH >= 0.1.2-alpha.1。
* 需要运行 Node >= 20。
* 插件以当前 DSH 进程的权限运行。
* 安装前应检查源码与许可证。
结语¶
dsh-rich-questions 将问卷系统无缝集成到 DSH 的对话流中，解决了传统表单工具在智能体交互中的割裂感。它通过主机权威的状态管理和银行功能，确保了长流程问卷的可用性。
