dsh-quiz:把 DSH 对话回答变成可作答题库

前言

在 DeepSeek Harness(DSH)Web UI 中,一次问答往往只停留在当前上下文里。阅读完一段技术解释后,如果缺少即时检查,内容很快会混进聊天记录,不容易回头验证是否真正理解。

dsh-quiz 针对这个问题:它面向 DSH Web UI,把已完成的 AI 回答转换为单选题、多选题或判断题,让用户即时作答、查看解析,并按自己的意愿决定是否加入个人题库与复习列表。

这是什么

dsh-quiz 是面向 DeepSeek Harness(DSH)Web UI 的对话式题库插件,由 cungphammanh590-star 维护,许可证为 MIT。

它解决的问题是:对话式 AI 回答适合解释概念,但缺少一种轻量方式把回答变成可检验的材料。使用该插件后,用户可以在不离开当前 DSH Web 会话的情况下,对某条 AI 回答出题、作答、查看解析,并将需要保留的题目保存到个人题库。

核心功能

下面介绍 dsh-quiz 已提供的能力:

  • 在每条已完成的 AI 回答下方显示“出题”按钮。
  • 点击后在右侧抽屉后台生成并展示题目,不向当前对话追加消息,也不创建新的可见会话。
  • 出题期间可以继续当前话题;关闭抽屉会取消仍在运行的生成请求。
  • 支持单选题、多选题、判断题和混合题。
  • 可选择题目数量与难度。
  • 使用原生单选框和复选框作答,提交后即时判题并显示解析。
  • 题目默认只是临时草稿,只有用户明确操作后才会加入题库。
  • “加入题库”和“加入复习”相互独立,不会自动安排复习。
  • 左侧题库入口支持关键词搜索、待复习筛选和历史作答统计。
  • 每道题保留来源会话及回答摘录,方便回到知识上下文。
  • 题目数据写入 DSH domain storage;未保存草稿不会长期占用存储。
  • Web UI 的“出题”按钮直接使用插件 Host 的辅助模型调用,不经过对话工具。
  • 提供 quiz_create_draftquiz_answerquiz_savequiz_list 等模型工具,用于自然语言出题、判题、保存和查询。

安装与启用

使用插件前需要满足以下条件:

  • DeepSeek Harness 0.1.x Web profile
  • Node.js ^22.19>=24
  • pnpm
  • 已在 DSH 中配置可用的模型服务

当前插件版本基于 DSH 0.1.0-rc.6 API 构建。DSH 尚处于预发布阶段,升级 DSH 后如遇兼容问题,请先重新安装插件并查看仓库 Issues。

推荐从 GitHub 安装。进入任意目录后运行:

npx @deepseek-ai/dsh plugin --profile web add github:cungphammanh590-star/dsh-quiz
npx @deepseek-ai/dsh web

安装完成后,刷新 DSH Web 页面。左侧出现“题库”入口,并且 AI 回答下方出现“出题”按钮,即表示插件已启用。

GitHub 安装会执行仓库的 prepare 构建脚本。pnpm 10 及更高版本默认可能阻止 Git 依赖执行构建;首次安装失败时,请按照 DSH 在终端给出的提示,把 dsh-quiz 加入对应 Web profile 的 pnpm-workspace.yaml 中的 allowBuilds,然后重新运行安装命令。只应为你信任的插件源码授予构建权限。

由于插件会以当前 dsh 进程拥有的权限运行,安装前应检查插件源码、许可证和构建脚本是否符合预期。

典型用法

按钮方式使用步骤如下:

  1. 在 DSH Web 中提问并等待 AI 完成回答。
  2. 点击回答下方的“出题”。
  3. 选择题型、题量和难度,然后点击“开始出题”;右侧抽屉立即打开,原对话不新增消息。
  4. 可以继续当前对话,也可以等待题目在抽屉中生成,然后使用单选框或复选框作答。
  5. 查看判题结果和解析。
  6. 需要保留时,可勾选“加入复习”,再点击“加入题库”。
  7. 点击左侧“题库”浏览、搜索或筛选已保存题目。

也可以直接通过对话调用插件能力,例如:

根据刚才关于 JavaScript 闭包的回答,给我出两道单选题,先不要显示答案。
第一题选 B。把这道题加入题库,但暂时不要加入复习。

模型工具

插件提供以下模型工具,用于用户在自然语言中明确要求出题、判题、保存或查询时调用:

  • quiz_create_draft:创建 1–10 道尚未保存的题目,并关联当前 DSH 会话。
  • quiz_answer:按选项索引判题,并更新作答统计。
  • quiz_save:保存指定草稿,并独立设置是否加入复习。
  • quiz_list:按主题或复习状态查询已保存题目。

Web UI 的“出题”按钮不经过这些对话工具,它直接使用插件 Host 的辅助模型调用。quiz_create_draft 等工具保留给用户明确通过自然语言要求出题的场景。

数据、权限与限制

与数据相关的行为如下:

  • 已保存题目使用当前 Web profile 配置的 DSH domain storage。
  • 未保存题目是有数量上限的进程内草稿;重启 DSH 后会被丢弃。
  • 题目会记录生成所依据的 AI 回答摘录和来源会话 ID。
  • 按钮出题只把所点回答发送给当前会话使用的模型路由,不发送整个聊天历史。
  • 辅助出题请求不写入聊天消息序列,也不会成为后续对话上下文。
  • 插件本身不提供外部同步、遥测或独立账号系统。
  • 生成内容仍由当前 DSH 模型提供商处理,适用其现有配置与隐私政策。

使用限制如下:

  • 已记录复习意愿,但尚未实现间隔重复或自动复习提醒。
  • 出题质量依赖当前模型;保存前应检查题目与解析是否可靠。
  • 已保存题目暂不支持编辑和版本历史。
  • 题库目前跟随单个 DSH storage 配置,不提供跨设备同步界面。

插件 bundle 默认配置如下,可在 DSH profile patch 中覆盖:

maxDrafts: 50
maxQuestionsPerBatch: 10
maxSourceChars: 16000
maxGenerationTokens: 4096
generationTimeoutMs: 60000

generationTimeoutMs 同时约束模型请求;关闭题库抽屉也会主动取消当前请求。

链接

  • GitHub:https://github.com/cungphammanh590-star/dsh-quiz
  • 目录页:如使用 DeepSeek Harness 插件目录,可按名称 dsh-quiz 查找;本页未提供具体目录 URL。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye