wydddddcool/dsh-hover-approve

为什么需要它

DSH 的会话经常需要你停下来处理：授权写文件、回答一个问题、确认一个计划、看一眼目标为什么断了。内置面板要求你点进会话、翻到对话里才能操作——来回切换很打断思路。

这个插件让处理停留在会话列表这一行：有交互需求的会话旁边自动弹出气泡，一条引线 + 圆点指给你是哪一个，气泡里直接拒绝 / 授权 / 作答，不用点进会话。

功能

效果

真实 DSH Web 界面演示（会话行右侧锚定气泡，引线 + 圆点连到对应会话）：

• 自动弹出，不用悬停：锚定在会话行右侧，一眼看出是哪个会话在等你；
• 信息完整：操作类型用大白话（bash→运行终端命令、write→写入文件…）、文件路径高亮块、命令默认单行截断点击展开、智能体说明重点显示；
• 点外部关闭：点气泡外任意区域或 × 关闭，本轮不再弹，新一轮交互重新弹出；
• 跟随列表：滚动 / 行重渲染时气泡和引线跟随行位置；多个会话同时有交互各自锚定、横向错开；
• 归档会话不弹：已归档的旧对话不再弹任何通知，归档 / 取消归档即时生效（已弹的立即收起）。

安装

快速安装（推荐）：

dsh plugin --profile web add https://github.com/wydddddcool/dsh-hover-approve

一条命令完成依赖安装与 bundle 注册（自动应用 cordis.patch.yml），重启 dsh web 后生效。

也可以手动在 profile（如 ~/.dsh/profiles/web）里安装：

# 1. package.json dependencies 加：
#    "dsh-hover-approve": "https://github.com/wydddddcool/dsh-hover-approve"
# 2. dsh.profile.bundles 加 "dsh-hover-approve"（自动应用 cordis.patch.yml）
pnpm install
# 3. 重启 dsh web

本地开发用 file: 路径依赖；注意 pnpm 的 file: 依赖是拷贝，改源码后需手动同步： cp <src>/lib/client.js ~/.dsh/profiles/web/node_modules/dsh-hover-approve/lib/client.js

与 DSH 的关系

本插件是 DeepSeek Harness Web 的社区插件（非官方产品）。它通过官方客户端注入机制（ctx.sessions / ctx.workspaces / ctx.locale）读取会话状态，并通过官方 PendingWait.respond() 通道应答——与会话内面板走同一服务端路径、有审计；应答绑定时捕获的 approvalId，审批被替换 / 处理后拒绝发送，杜绝「所见非所批」。实测兼容 dsh 0.1.0-rc.6（依赖 pendingInteraction / projectionValues / sessions.open / PendingWait 等客户端 API）。

测试

npm install   # 首次：安装 jsdom
npm test      # 16 个用例：四种模式、归档过滤、应答编码、状态切换、重试、视口钳制、卸载清理

CI（GitHub Actions）会在每次 push 自动运行测试。

局限

• 命令只在 callId 匹配到 running call 时显示（bash 类工具）；非 bash 工具只显示操作类型和说明——与内置面板行为一致。
• 行→会话映射靠标题评分匹配（精确匹配优先），极端重复标题仍可能错锚（概率极低）。
• 气泡依赖内置列表 DOM 结构（[role="treeitem"]）。DSH 升级若改动该结构，气泡可能静默失效（不报错），届时需适配。

License

本项目遵循 MIT License。DeepSeek 是 DeepSeek AI 的商标，本项目是独立的社区项目，与 DeepSeek 官方没有隶属关系，也未获得其背书。