dsh-hover-approve

Readme

<h1 align="center">dsh-hover-approve</h1>

<p align="center">
  <strong>授权？不用点进会话。</strong><br>
  DSH Web 侧边栏锚定气泡：等待授权、提问、计划确认、目标阻断的会话，在列表行旁一键处理。
</p>

<p align="center">
  <a href="https://github.com/wydddddcool/dsh-hover-approve/stargazers"><img src="https://img.shields.io/github/stars/wydddddcool/dsh-hover-approve?style=flat&label=%E2%98%85&color=08C" alt="GitHub stars"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT License"></a>
  <a href="https://github.com/wydddddcool/dsh-hover-approve/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/wydddddcool/dsh-hover-approve/test.yml?style=flat&label=CI" alt="CI"></a>
  <img src="https://img.shields.io/badge/dsh%20web-0.1.0--rc.6-4D6BFE?style=flat" alt="dsh 0.1.0-rc.6">
</p>

<p align="center"><sub>中文 · <a href="README.en.md">English</a></sub></p>

<p align="center">
  <img src="assets/shot-approval.png" alt="需要你授权：操作/智能体说明/文件高亮/一键拒绝或授权" width="85%">
</p>

## 为什么需要它

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

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

## 功能

<table>
  <tr>
    <td width="50%" valign="top">
      <h3>🟠 需要你授权</h3>
      <p>会话请求权限（写文件 / 跑命令等）时，展示操作类型、智能体说明、要写入的文件（高亮块）与命令，气泡里直接「拒绝 / 授权」。</p>
    </td>
    <td width="50%" valign="top">
      <h3>🟠 需要你选择</h3>
      <p>askUserQuestion 提问到来时，展示问题与选项：单选点选即答，多选勾选后统一确认，推荐项 ⭐ 高亮。</p>
    </td>
  </tr>
  <tr>
    <td width="50%" valign="top">
      <h3>🟠 需要你确认计划</h3>
      <p>plan-review 计划确认以卡片展示计划正文 + 批准 / 拒绝选项，点击即答。</p>
    </td>
    <td width="50%" valign="top">
      <h3>🔴 目标已阻断</h3>
      <p>目标进入 blocked 阶段时，红色大字展示阻断原因与目标内容，纯通知不打扰，可一键「去会话查看」。</p>
    </td>
  </tr>
</table>

## 效果

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

![需要你授权：操作/智能体说明/写入文件高亮/一键拒绝或授权](assets/shot-approval.png)

![目标已阻断：红色原因 + 目标内容 + 去会话查看](assets/shot-goal-blocked.png)

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

## 安装

**快速安装**（推荐）：

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

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

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

```sh
# 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）。

## 测试

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

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

## 局限

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

## License

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