dsh-esc-stop

Readme

# dsh-esc-stop

[![简体中文](https://img.shields.io/badge/语言-简体中文-0969da)](./README.md) [![English](https://img.shields.io/badge/Language-English-57606a)](./README.en.md)

DeepSeek Harness Web 客户端插件：当当前会话正在运行且输入框获得焦点时，按 **Esc** 立即终止本轮任务，无需点击“停止生成”。本项目是非官方社区插件，与 DeepSeek 官方不存在隶属、授权或背书关系。

## 与 DeepSeek 的关系

本插件运行在 DeepSeek Harness Web 客户端中，通过 Harness 官方的 `conversation.cancel()` 接口终止当前回合；不修改 DeepSeek 模型、提示词或会话数据，也不向外部服务发送数据。

## 功能与行为

- 只响应会话输入框内的无修饰 `Esc`。
- 只在普通会话或可继续子代理正在运行时终止，与原生“停止生成”按钮保持一致。
- 弹窗、命令菜单等组件若已消费 `Esc`，插件不会误终止任务。
- 空闲会话、一次性子代理、组合输入、长按重复事件与带修饰键的 `Esc` 均不处理。
- 复用官方取消能力，保留原有队列和错误呈现语义。

## 安装与使用

从 GitHub 安装到 Web Profile（Git 安装会运行 `prepare` 构建；若 pnpm 拦截构建，请按 DSH 输出将 `dsh-esc-stop` 加入 Profile 的 `allowBuilds`）：

```sh
dsh plugin --profile web add github:ClausYang/dsh-esc-stop
```

也可以安装本地 checkout：

```sh
dsh plugin --profile web add /path/to/dsh-esc-stop
```

安装后重启 `dsh web` 并刷新页面。任务运行时保持会话输入框获得焦点，按 `Esc` 即可终止。

## 兼容性

- 目标环境：DeepSeek Harness Web `>=0.0.1`。
- 已在 DeepSeek Harness `0.1.0-rc.5` 源码版本上完成构建、单元测试和实际 Profile 加载验证。
- 使用 `dsh.client` 浏览器插件清单，以及当前公开的会话与取消接口。

## 风险与限制

- 快捷键仅在焦点位于主会话输入框时生效，避免在设置、弹窗或其他文本框中误触。
- 当前没有可配置的按键映射。
- `Esc` 会立即请求终止当前回合；未保存的模型生成进度不会继续。
- 外部 UI 插件如果阻止事件但没有调用 `preventDefault()`，可能与本插件发生快捷键竞争；原生 Harness 弹层已按消费优先处理。

## 维护状态

- 状态：积极维护（Active）。
- 主要维护者：[ClausYang](https://github.com/ClausYang)。
- 问题反馈：[GitHub Issues](https://github.com/ClausYang/dsh-esc-stop/issues)。

## 开发验证

```sh
pnpm install
pnpm test
pnpm run typecheck
pnpm run build
```

## 许可证与版权

Copyright © 2026 ClausYang。项目以 [MIT License](./LICENSE) 开源。DeepSeek 名称、商标、官方模型和材料的权利归 DeepSeek 官方或相应权利人所有。