划词提问:选中回答里的文字,在继承主对话上下文的右侧栏会话里追问,支持流式回答与图片、文件附件。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-ask-aside
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:AZ-666316/dsh-ask-aside
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
划词提问,答案长在侧栏里,不打断主对话。
读长回答时碰到不懂的术语、跳步的推导,不用在正文下面接着追问(那会把主线顶走、把上下文搅浑):选中那几个字 → 点「提问」→ 右侧栏开一个独立会话,流式回答,边看边追。
给 DeepSeek Harness(DSH)用的插件。
为什么
在主对话里问「这个术语什么意思」,代价是双向的:
- 主对话被术语解释、追问、来回澄清占满,真正的主线(论文、实验、代码)被挤到上面去了;
- 你并不总是想为一句「PARP 是什么」新开一整个会话,回来还得自己找。
dsh-ask-aside 的做法是:每次划词提问 = 一条独立的旁支会话,它默认承接主对话的全部上下文(答得准),但在界面上与主线完全分离(不污染);问完就关,值得留再升格成正式对话。
能力
| 能力 | 说明 |
|---|---|
| 划词浮层 | 选中「主对话里的文字」→ 选区上方浮出「提问」按钮(沿用老版 dsh-study-ask 的位置,它的同名按钮会被隐藏),样式与宿主自带的「引用文本」一致,重叠时自动翻到另一边 |
| 侧栏直接问 | 不划词也行:右侧栏页签条「+」→「问答」,或点主输入框 + 旁边的那个小图标,直接接着当前主对话的上下文追问 |
| 承接上下文 | 默认 fork 主会话:新会话继承主会话到此刻为止的完整历史,前缀缓存命中,回答知道你在说什么 |
| 只看引文 | 面板顶部可切「只看引文」,只带选中文字、不带历史,省 token / 免得把旧话题带进来 |
| 一个主对话一条旁支 | 同一个主对话只维护一条旁支会话(映射落盘),再问接着聊,不会每问一次在左栏堆一条新会话 |
| 悄悄存在 | 旁支会话用 CSS 从左侧列表隐藏,主对话列表保持干净;需要时「在会话中打开」随时能找回 |
| 流式回答 | 逐字上屏,可中途停止(关闭面板即中止订阅) |
| 附件 | 输入框左侧只有一个 +:点它选图片/文件,也可以直接把文件粘贴或拖进面板(不显示任何原生选择器或提示文字);走宿主同一条上传链路,最多 8 个,只发附件不写字也行 |
| 多轮追问 | 在同一个旁支会话里连续问,互相关联 |
| 升格 | 「在会话中打开」跳到该旁支会话,之后就是普通会话,可续聊、改标题、归档 |
| 失败可见 | 上游报错 / 被中断会显示原因,不会静默空白 |
| 不抢焦点 | 面板不夺输入焦点;主对话的草稿不会被覆盖 |
| 与视频皮肤共存 | 装了 dsh-video-skin 时,它贴屏幕右下角的透明度圆钮会在「问答」面板打开期间自动让到侧栏左边(面板关掉回原位),原生 title 提示框换成主题化气泡;不改对方文件 |
| 任务进度带 | 主对话在跑长任务时,面板顶部出现一条细进度带:任务名、第几步/共几步、当前动作、已用时间、预计剩余;点一下展开阶段清单。卡住(blocked)变橙、失败变红、完成变绿且 6 秒后自动收起。数据来源见下面「任务进度带」一节 |
安装
从 npm(推荐,已发布 dsh-ask-aside):
npm i dsh-ask-aside
# 或
dsh plugin install dsh-ask-aside
源码在 AZ-666316/dsh-ask-aside,也可以从本地目录以 link: 方式开发调试。
插件以普通 DSH bundle 形式安装(profile 内 link: 或 npm 包皆可):
// <DSH_HOME>/profiles/desktop/package.json
{
"dependencies": {
"dsh-ask-aside": "link:D:/path/to/dsh-ask-aside"
},
"dsh": { "profile": { "bundles": ["dsh-ask-aside"] } }
}
然后在 DSH 里启用并应用:
plugin_manager set_bundle target=dsh-ask-aside enabled=true
刷新页面后:
- 在任意回答里选中一段文字 → 选区上方出现「提问」(与「引用文本」互不遮挡);也可以不划词,直接用右侧栏页签条的「+」打开「问答」;
- 点它 → 右侧栏打开「问答」页签,问题自动带引文发出;
- 想换话题就点「新对话」;想留下就点「在会话中打开」;
- 想带材料问,点输入框下的
+选图片/文件,或者直接把文件粘贴/拖进面板(最多 8 个;只发附件不写字也可以)。
依赖:dsh >= 0.2.0、node >= 20。宿主侧只用 webServer,提供两个路由:
GET /dsh-ask-aside/api/status 插件状态
GET /dsh-ask-aside/api/map 读「主对话 → 旁支」映射
POST /dsh-ask-aside/api/map 写一条映射 { parent, side, strategy }
映射存放在 <DSH_HOME>/dsh-ask-aside-map.json(原子写),所以重启桌面端之后仍然认回同一条旁支;删掉这个文件等于全部重来。
它是怎么实现的
整个插件是「一个客户端模块 + 一个空壳宿主模块」,用的是 DSH 公开的客户端服务:
- 浮层:监听
selectionchange/mouseup,要求选区落在[data-chat-anchor-key]内且起止同一锚点(避免跨消息引用产生歧义);流式生成中的消息(带[data-streaming])拒绝提问,因为那段文字还在变。 - 开旁支:
ctx.remote.session.fork({ sessionId })继承历史;父会话正在生成时 fork 不可用,自动降级为create()+ 只带引文,并在面板上标注「本次未承接上下文」。 - 提问:
ctx.remote.session.prompt({ requestId, sessionId, mode: 'queue', content: [...] }),首问把引文拼成> 引用+ 问题。 - 看回话:
ctx.remote.session.follow({ address, maxMessages: 60, assistantStream: true }, signal)是一条 async iterable,assistant-stream帧负责逐字、event帧负责落库消息,两条线按 seq 合并 —— 少任何一条,流式或历史都会漏。 - 进侧栏:
tabs.register({ id, kind, title, guide })声明页签类型,slots.inject('sidebar.right.pane.tab', …)挂面板。所有侧栏服务用ctx.get()探测而不是inject—— cordis 没有可选依赖,注入一个宿主没有的服务会把 fiber 挂住、整个 web 白屏。 - 一条旁支:
<DSH_HOME>/dsh-ask-aside-map.json记录主对话 id → 旁支 id;面板打开时先查表,有就接着用,没有才fork。换「新对话」时把旧的 id 归档进retired数组,用一段注入的 CSS([data-row-key="session:<id>"]{display:none})把它们从左栏藏掉 —— 只改显示,不动数据,所以「在会话中打开」仍能找到完整记录。
不做的事:不写宿主状态、不读你的会话文件、不联网(除了走 DSH 自己的会话通道)。
任务进度带(主动汇报)
第三件事是「主动汇报」:agent 跑长任务时,你在侧栏问问题,还能看见主对话跑到哪一步,不用切回去翻。
数据走三个来源,谁在就用谁(按顺序探测,前面的没有就换下一个):
- 进度插件:装了
dsh-progress-widget(源码 uuhihj/task-progress-bar)且启用时,读它的GET /dsh-progress/status(字段最全,含阶段、ETA、stale 提示); - 进度 tab 插件:装了
dsh-progress-tab时读GET /dsh-progress-tab/api/status,数据文件<DSH_HOME>/dsh-progress-tab.json(多任务格式,和那个 tab 共用一份数据); - 本插件兜底:
GET /dsh-ask-aside/api/progress?session=<主会话 id>,宿主直接读上面两个文件(dsh-progress.json+dsh-progress-tab.json),任何一个插件都没装/被禁用时也照样能显示。
agent 上报协议(长任务开始写、每步更新、结束写终态)。单任务写 <DSH_HOME>/dsh-progress.json:
{
"task": "整理 SBRT-RDN 的 DSA 随访数据",
"session": "<当前主会话 id,原样填>",
"project": "SBRT-RDN",
"stages": ["读原始表", "清洗", "配对统计", "出图"], // 可选,≤8 条
"current": 2, // 当前阶段下标,从 0 开始
"pct": 62, // 0-100,进度条
"action": "正在核对 12 只猪的血压基线", // 可选,当前动作
"etaMin": 4, // 可选,预计还要几分钟
"status": "running", // running | blocked | done | failed | cancelled
"issue": "等你确认:「封堵组」算不算对照组?", // blocked/failed 时写原因
"startedAt": 1794835500000,
"updatedAt": 1794835740000,
"endedAt": 0 // 结束时可写
}
status为blocked时进度带变橙并直接显示issue(需要你决策的事,在侧栏就看得到);running超过 10 分钟没更新、或结束超过 2 分钟,进度带自动消失(避免把上次任务的残留当"正在跑");session不匹配当前面板的主对话时不显示——别的窗口的任务不会串到这个面板里;- 多任务(同时跑几件)写
<DSH_HOME>/dsh-progress-tab.json:{ "tasks": [ {...同上...} ] },按session各取各的; - 面板打开期间会把
dsh-progress-widget的悬浮条藏起来(同一件事不占两个位置),关掉面板它就回来。
已知限制
- 只支持 DSH 桌面/Web 界面内的消息,不支持浏览器外部页面里的划词;
- 左栏隐藏依赖宿主的
data-row-key="session:<id>"属性,宿主改版可能失效(失效只是「又看得见」,不影响功能); - 旁支会话是真的会话(名字带「❓」前缀),会出现在「最近会话」/搜索里;
- 浮层默认贴在选区上方(和老版
dsh-study-ask的按钮同一位置),上方顶到屏幕就翻到下方;与宿主「引用文本」重叠时再换到另一边;同一页面里如果还装着dsh-study-ask,它那个重复的「提问」按钮会被本插件的样式隐藏(只隐藏按钮,它的「提问对话」标签不受影响); - 从页签「+」进入时面板没有引文,提问会直接 fork 当前主对话,回答里不带「你选的那句」;
- 附件上传依赖宿主的
fileUpload客户端服务(本机 0.2.2-rc.3 有),宿主没有时会在面板里明确报错; - 一次最多 8 个附件;图片类型限
png/jpeg/webp/gif,其他类型按普通文件上传; - 暂不做:嵌套追问树、历史列表、追问记录面板。
开发
node --check lib/client.js # 语法
node smoke-test.cjs # 无浏览器冒烟:tab 注册 / 日志折叠 / 首问拼装 / store / markdown
node render-test.cjs # 真 React + jsdom 渲染:面板、浮层、旁支复用、附件入口与上传契约
lib/client.js 是手写的浏览器模块(没有构建步骤),通过 window.__ModuleLoader__.load({ id, factory }) 注册,factory 里只能 require 平台种子模块:react、react-dom/client。
打包 / 发布
npm pack # 产出 dsh-ask-aside-1.0.0.tgz(只含 files 里列的文件)
npm publish # 需要 npm 登录;DSH 插件市场按 npm 包名索引
git tag v1.0.0 && git push origin main --tags
仓库地址在 package.json 的 repository / homepage / bugs 里,发布前替换成真实账号。
License
MIT
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7797
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5191
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1007
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。