前言¶
在使用 DeepSeek Harness (DSH) Web 进行开发或操作时，常会遇到需要介入处理的场景：等待授权（如写文件、运行命令）、回答用户提问、确认计划、或查看目标阻断原因。DSH 默认的处理方式要求进入会话并翻看对话，这种方式需要频繁切换上下文，容易打断思路。
dsh-hover-approve 插件将交互停留在会话列表这一行：当会话处于等待授权、提问、计划确认或目标阻断状态时，会在左侧会话行旁自动弹出气泡，通过一条引线和圆点指明对应会话，气泡内可直接拒绝、授权或作答，无需进入会话。
插件概览¶
- 名称：
dsh-hover-approve - 作者：wydddddcool
- 分类：客户端
- 许可证：MIT
- 核心价值：DSH Web 侧边栏锚定气泡，在会话列表行旁一键处理等待授权/提问/计划确认/目标阻断的会话。
核心功能¶
- 授权操作：当会话请求权限（写文件、运行命令等）时，气泡展示操作类型、智能体说明、要写入的文件（高亮块）与命令，支持直接拒绝或授权。
- 回答用户提问：当
askUserQuestion提问到来时，气泡展示问题与选项（单选或多选），支持直接作答。 - 确认计划：当需要确认计划时，气泡以卡片形式展示计划正文与批准/拒绝选项，点击即答。
- 处理目标阻断：当目标进入 blocked 阶段时，气泡以红色大字展示阻断原因与目标内容，可一键“去会话查看”。
- 气泡特性：
- 自动弹出，无需悬停。
- 信息完整，文件路径高亮，命令可展开。
- 点气泡外任意区域或关闭按钮关闭，本轮不再弹，新一轮交互重新弹出。
- 跟随列表滚动，多个会话同时有交互时横向错开。
- 已归档会话不弹出。
安装与启用¶
插件通过官方插件命令安装。安装完成后需重启 DSH Web 服务。
dsh plugin --profile web add https://github.com/wydddddcool/dsh-hover-approve
执行上述命令后，依赖会自动安装并注册到 cordis.patch.yml，重启服务即可生效。
使用方式¶
安装并重启 DSH Web 后，插件会自动监听会话状态。
1. 当有交互需求时，会话行右侧会出现锚定气泡。
2. 在气泡中直接进行拒绝、授权或作答操作。
3. 点击气泡外部区域可关闭气泡。
适用场景与注意¶
- 适用场景：DSH Web 用户需要频繁处理列表中的待确认事项，希望减少在会话列表和会话详情之间切换的频率。
- 运行机制：命令只在
callId匹配到 running call 时显示（bash 类工具）；非 bash 工具只显示操作类型和说明。 - 依赖限制：行到会话的映射依靠标题评分匹配（精确匹配优先），极端重复标题可能存在错锚风险（概率极低）。
- DOM 结构依赖：气泡依赖 DSH 内置列表的 DOM 结构
[role="treeitem"]。若 DSH 升级改动此结构，气泡可能静默失效。 - 归档处理：归档会话不会触发气泡弹出，归档或取消归档操作会即时生效。
- 非官方产品：本插件为社区插件，遵循 MIT License，非 DeepSeek 官方产品。
结尾¶
dsh-hover-approve 通过锚定气泡的方式，简化了 DSH Web 中对会话交互的响应流程。如果你在处理会话列表时需要频繁打断流程去确认权限或回答问题，可以考虑使用此插件。
