前言¶
在 DSH 里做课堂或现场答疑，常见做法是切回客户端、新建会话、把题目贴进去，再说明要参考哪份讲义。题目在投影或网页上时，还要截图、保存、再上传。步骤多，注意力容易从讲解上被拉走。
dsh-quick-qa（快速问答）把入口做成桌面上的横向快捷栏：可以框选屏幕上的题目发送，也可以手打题目；作答时会从当前绑定的工作区里检索文档片段，一起交给模型。下面介绍它做什么、怎么装、怎么用，以及使用时要注意的限制。
这是什么¶
dsh-quick-qa 是维护者 CW-1209 发布的 DSH 客户端插件（当前 package 版本 0.1.0，MIT 许可证）。定位是「课堂随手一问」：框选屏幕题目或输入文字 → 结合工作区里的资料 → 在桌面弹出答案框。
入口在 DSH 左侧栏「新会话」下方的 快速问答。第一次点击会启动一个独立的 PowerShell 小进程，负责快捷栏窗口、全局热键和鼠标侧键；宿主侧用 lib/impl.js 做索引、检索和作答，客户端侧用 lib/client.js 提供面板与工作区切换。
核心功能¶
桌面快捷栏与框选¶
- 点 快速问答 后，桌面出现横向细条（类似输入法候选框）。
- 鼠标键 4（侧键靠后）：光标变十字，只画选区边框，不遮暗屏幕；按住左键拖出题目区域，松开即截图；只点一下无效；右键或
Esc取消。截图成功后缩略图出现在快捷栏上方。 - 鼠标键 5 或回车：在确认缩略图后发送；不满意可
Esc丢掉重框。 - Alt+Q：显示或收起快捷栏（含答案框），位置会记住。
也可以不截图：在细条输入框手打题目，回车或鼠标键 5 发送。README 在 DeepSeek-V4.1-Flash 本机实测中，手打路径合计约 1～3 秒，截图框选路径约 3.5～9 秒（读题、检索、作答分阶段统计）。
鼠标键 4/5 默认经全局低级钩子「吞掉」，浏览器里不再触发前进/后退；若不需要该行为，可在快捷栏脚本传 -MouseSwallow 0。
工作区与资料检索¶
- 细条上的 工作区胶囊（默认显示当前工作区名）与左侧面板下拉框共用同一份绑定，可随时切换。
- 作答前会对工作区内的 文档 / PDF / PPTX，以及 docx、xlsx、md、txt 等抽文本建索引；取 8 段最相关资料随题目交给模型。面板可查看「已索引片段 / 资料文件 / 索引耗时」。
- 索引按文件修改时间缓存；资料更新后点 重建索引。
文档抽取依赖 Python 及 pypdf、python-pptx、python-docx、openpyxl 等（README 还提到 pypdfium2 用于抽取脚本）。解析顺序为环境变量 DSH_QUICK_QA_PYTHON → 本机 venv → PATH 中的 python；都找不到时降级为只索引纯文本，插件仍可启动。
答案展示与外观¶
提交后约 1～9 秒在细条下方弹出答案框：答案在最前，其后是简要解释、依据（引用资料）、参考资料列表和各阶段耗时。答案框可滚动，比细条宽约 120 像素。
提交后满 15 秒仍未完成时，答案区先显示等待提示；资料准备、识图与作答共用 90 秒总预算，完成后自动替换为正式答案，达到上限则显示超时结果。
快捷栏与答案框跟随 DSH 主题：客户端约每 2.5 秒把 --dsw-alias-* token 推给宿主。细条可拖动位置、左右边缘 9 像素内可改宽度（480～1320），⚙ 可调整体透明度（最低 30%）。
安装与启用¶
需要已安装 DeepSeek Harness（DSH）。插件无需编译，按 README 是「一个 profile 依赖 + 一行 patch」：
- 把仓库放到 profile 的
node_modules，例如：
%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-quick-qa
（可用 file: 或 npm 方式引用。）
- 在
%USERPROFILE%\.dsh\profiles\desktop\package.json的dependencies中加入：
"dsh-quick-qa"
- 在
%USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml中加入：
- insert:
- id: dsh-quick-qa
name: dsh-quick-qa
- 重启 DSH，左侧栏「新会话」下方应出现 快速问答。
卸载时删除 package.json 中的依赖与 cordis.patch.yml 里对应 insert 行即可（也可用插件管理器移除）。
安装前建议阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，快捷栏为独立 PowerShell 进程，会注册全局热键与鼠标钩子。
典型用法¶
截图答题
- 打开 DSH，点一次 快速问答（冷启动后必须先点一次，鼠标键与 Alt+Q 才绑定到小进程）。
- 在面板或胶囊里选好要讲的那门课对应的工作区，必要时 重建索引。
- 按鼠标键 4，框住投影或屏幕上的题干与选项，松手确认缩略图。
- 按鼠标键 5 或回车发送，在答案框查看结论与引用依据。
手打快问
在快捷栏输入框输入题目，回车或鼠标键 5，适合题目已在剪贴板或很短、无需识图的场景。
随时收起
讲课不需要条栏时按 Alt+Q 收起；细条右侧 ✕ 也可关闭整个快捷栏，Alt+Q 仍可用。
开发或排障时，README 给出宿主路由前缀 /dsh-quick-qa/v1（如 GET state、POST ask 等），日志在 %TEMP%\dsh-quick-qa\quickbar.log，框选图在 %TEMP%\dsh-quick-qa\sel-*.png。
适用场景与注意¶
适合谁
- 在 Windows 上用 DSH，需要在讲课、答疑现场「看一眼屏幕就出题」的场景。
- 已经把课件、讲义 PDF、PPTX 等放进 DSH 工作区，希望答案带可核对依据的用户。
架构与平台
- 快捷栏本体是 Windows PowerShell 5.1 + WPF（
lib/quickbar.ps1），与 DSH 宿主通过 HTTP 轮询通信，崩溃时不拖垮主进程。 - 全局热键、框选层、鼠标侧键逻辑均在该小进程内；README 未描述 macOS/Linux 上的同等快捷栏。
已知限制（摘自 README）
- DSH 重启后须先点一次 快速问答，侧键与 Alt+Q 才生效。
- 模型通道与其它长对话共用，并发时墙上等待可能长于插件内统计的耗时。
- 截图识图依赖框选是否包含完整题干；偶发识图超过 10 秒会提示未识别到题目，可重框。
- 面板「快捷栏在运行」等状态依赖心跳路由，需重启一次 DSH 后新路由才会被识别。
社区插件目录 SkillHub 上的 dsh-quick-qa 页 与 GitHub 仓库相互独立，均非 DeepSeek / 幻方官方应用商店；选用前自行核对版本与源码即可。
结尾¶
dsh-quick-qa 把「框选或输入题目」和「工作区资料检索」收成桌面一条快捷栏，适合课堂里少切窗口、少重复粘贴的速答流程。安装走 desktop profile 的依赖与 cordis.patch.yml，用法上记住冷启动后先点开入口、绑定好工作区并按需建索引。
