huahuazz/DSH_question_map

在 DSH 对话里选中一段文字横向追问，不再把原始问题越推越远；所有追问会自动连成一张追问网格。

一个 DeepSeek Harness（dsh）的社区插件，适用于 DSH Web 与 DSH Desktop。

English | 中文

---

scripts/probes/ 里是开发期用的一次性浏览器/接口探针，用于排查具体问题，不属于常规自检。

它解决什么问题

大模型对话是线性的：你问一个问题，拿到五条答案，其中某条里的某个词看不懂，只能接着在同一个对话框里问。 问着问着，最初的问题被推到上面去了，上下文也越来越长——而你其实只是想单独搞懂那一个词。

这个插件让你：选中任意一段对话文字 → 点「追问」→ 在旁边开一个空上下文的迷你对话只问它。 每次追问都会记录"从哪段文字问出来的"，最后连成一张可以浏览的网格。

截图摄于 0.3.2；0.3.9 起入口按钮与网格工具栏已改版（见下方「界面」）。

界面

• 入口：输入区左侧一枚方形按钮（Z 形节点图标 + 节点数角标），只在当前会话与追问网格相关时出现。 它挂在 DSH 的 conversation.input.left 插槽里，位置和尺寸由布局决定，输入框变高变宽时自动跟随。
• 浮卡：贴着选区打开；按住标题区可拖动、拖右下角可改大小（尺寸记在浏览器本地，下次打开保持）。 没有「固定」按钮——点卡片外面就收起，不留悬空卡片。
• 网格：全屏画布。最左一列是会话锚点，往右依次是一级追问、子追问；左侧竖排工具栏（导出图片 / 适应画布 / 清空 / 关闭）。 节点按层级着色，悬停会点亮「它从哪来」的整条祖先链、其余压暗。

功能

能力	说明
选词追问	选中对话里的文字，旁边出现「追问」小按钮；点开是一张贴着选区的浮卡，可拖动、可拉大小
空上下文	每次追问都是一个全新的会话，只带"选中的词 + 前后一小段引文"，不继承主对话历史
卡内继续聊	浮卡里可以直接追问，还是同一个横向会话，不会打断主对话
再选词→子孙节点	在浮卡的答案里再选词追问，就长出子节点，越问越细
网格视图	锚点 → 根提问 → 子提问，带箭头连线；滚轮缩放、空白处拖拽平移；节点按层级配色，悬停高亮祖先链
三种跳转	点节点本体 = 切到那次追问的会话；点节点右侧小圆点 = 不离开当前会话、就地开浮卡；点会话锚点 = 回到这串提问的源头会话
右键菜单	右键节点：高亮颜色（5 色）、重命名（同时改会话标题）、删除（会话锚点不可删，其余节点连带子节点一起删）；右键锚点：重命名会话
给提问起标题	卡片标题点一下即可改名，建会话期间也能先填；节点标签优先用你起的标题
导出图片	画布左侧工具栏的下载按钮，把当前网格导出成 PNG
本地留存	网格与浮卡尺寸都存在浏览器本地存储里，重启后还在

安装

# 尚未发布到 npm 时，直接从 GitHub 安装
dsh plugin --profile web add github:huahuazz/DSH_question_map

发布到 npm 之后可以简写成 dsh plugin --profile web add dsh-question-map。

DSH Desktop 用户在 设置 → 插件 里搜索安装，或在终端：

dsh plugin --profile desktop add github:huahuazz/DSH_question_map

装好后完全退出并重启 DSH（客户端 bundle 在启动时装载）。

使用

1. 在任意回复里选中一段文字；
2. 点旁边冒出的「⟂ 追问」（或按 Alt+Enter），浮卡会贴着选区打开并开始回答；
3. 点输入区左下角的 Z 形节点按钮查看追问网格；
4. 在网格里：点节点回到那次追问的会话，点节点右侧的小圆点就地看一眼，点会话锚点回到源头会话。

浮卡	网格

兼容性

• 需要 dsh >= 0.2.1-rc.2（package.json 的 engines.dsh）。
• 只用公开的客户端扩展点：shell.overlay 与 conversation.input.left 两个 slot， uiConversation、uiWorkspace、sessions、locale、remote.session。
• 老版本 DSH 没有 conversation.input.left 插槽时，入口按钮不会出现（浮卡与网格不受影响），也不会报错。
• 不依赖任何宿主内部设置 API，因此不会因为 DSH 升级换掉设置服务而加载失败。

数据与隐私

• 追问网格的节点/连线存在浏览器 localStorage（键 dsh-question-map:graph），浮卡尺寸在同域的 dsh-question-map:card-size。
• 每次追问会在你的会话列表里新增一个真实会话（标题以 ⟂ 开头），内容按 DSH 自己的会话存储规则落盘。
• 插件本身不向任何服务器发请求；模型调用走 DSH 自己的会话通道。

已知限制

• 追问会话会出现在会话列表里（这是"复用真实会话、能力与主对话一致"的代价）。
• 网格按 localStorage 保存：同源即可跨重启；换端口或清缓存会丢（可重新生成）。
• 每个横向提问都会真实调用一次模型。

开发

仓库是零构建的：lib/client.js 手写成 DSH 浏览器模块格式（window.__ModuleLoader__.load）， 没有打包步骤，改完直接放回 profile 即可。

node scripts/smoke.mjs              # 模块格式 / 注入清单 / 本地存储 / 删除与清空
node scripts/flow-test.mjs          # 建会话 → 提问 → 流式读取 → 落库 → 子节点
node scripts/verify-composition.mjs # 清单与 DSH 组合契约（没有本机 DSH 时自动跳过）
node scripts/pack-check.mjs         # npm 发布面自检（files/exports/dsh 清单）
node scripts/ci.mjs               # 本地复现 CI（没有 DSH 的环境）

脚本默认从 ~/.dsh/profiles/desktop 和常见安装位置找 DSH；装在别处时用环境变量指定：

DSH_PROFILE_DIR="/path/to/profiles/desktop" DSH_APP_DIR="/path/to/resources/app" node scripts/verify-composition.mjs

推送前先跑 node scripts/ci.mjs（或 npm test）：它按 GitHub Actions 的顺序、在“没有 DSH 的干净环境”下把检查跑一遍，避免本地绿、CI 红。

发布流程见 docs/PUBLISHING.md。

许可

MIT