![dsh-prompt-stash — Save the thought. Ask the detour.](docs/assets/dsh-prompt-stash-cover.jpg)

> 当前源码适配版：0.3.2 / DSH 0.2.0-rc.1。已迁移到官方 Config/configForms 和输入框订阅接口；快捷键写入 profile 配置，暂存内容保留原 localStorage 键。图片、文件附件和引用均禁止按纯文本暂存。旧 DSH 请继续使用 0.2.x。

# dsh-prompt-stash

[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
[![npm version](https://img.shields.io/npm/v/dsh-prompt-stash.svg)](https://www.npmjs.com/package/dsh-prompt-stash)
[![CI](https://github.com/Wine-Red/dsh-prompt-stash/actions/workflows/ci.yml/badge.svg)](https://github.com/Wine-Red/dsh-prompt-stash/actions/workflows/ci.yml)
[![DSH compatibility](https://img.shields.io/badge/DSH%20compatibility-0.2.0--rc.1-blue.svg)](https://deepseek-harness.github.io/deepseek-harness/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

[简体中文](README.md) | [English](README.en.md)

DeepSeek Harness Web 的本地输入暂存插件。把尚未发送的纯文本压入当前会话的 LIFO 暂存栈，先处理临时问题，之后再安全恢复原输入。

> 输入暂存不是草稿同步。DSH 已负责保存当前输入框草稿；本插件提供的是一组可明确存入、恢复和删除的临时输入副本。

## 功能

- 每个 DSH 会话独立保存，最新内容优先，最多保留 10 条。
- 暂存后立即在输入框上方显示折叠栏，可展开预览、恢复、删除或清空。
- 当前输入非空时不会直接覆盖；恢复前必须确认先暂存当前内容。
- 使用 DSH 官方 `inputActions.setDraft()` 清空和恢复，不操作 `textarea` 或内部 Store。
- 暂存内容只保存在当前浏览器的 `localStorage`；快捷键配置通过 DSH Host settings 保存，可跨刷新和浏览器生效。
- 支持中英文、深浅主题、键盘操作和 DSH 原生队列组合布局。
- 可在“设置 → 内置插件 → Prompt Stash”中录入单键或组合键快捷键，默认使用 `Ctrl+S`。

当前版本仅支持纯文本。带图片、附件或文件引用的输入不会被暂存。

## 效果

![暂存消息与 DSH 原生排队消息组合显示](docs/assets/dsh-prompt-stash-demo.png)

暂存内容默认折叠；展开后可查看创建时间与两行文本预览，并执行恢复、删除或清空操作。

## 要求

- DeepSeek Harness `0.2.0-rc.1`
- Web profile
- Node.js 20 或更高版本（仅源码开发需要）

插件的 Host、设置、样式和 slot 注册均采用故障隔离；单个挂载点冲突时会禁用对应功能并记录错误，不会把异常抛回 DSH 启动链。

## 安装

> npm 与 GitHub Release 提供预构建发布包；安装后重启 DSH。桌面端可在插件管理中安装包名，CLI 用户使用实际 profile 名称（例如 `web` 或 `desktop`）。

### npm registry（推荐）

直接安装到 DSH Web profile：

```sh
dsh plugin --profile web add dsh-prompt-stash
```

npm 包已包含构建产物，不需要允许安装期构建脚本。安装后重启 DSH Web。

更新到最新版本：

```sh
dsh plugin --profile web update dsh-prompt-stash
```

### GitHub Release tarball（备用）

从 [Releases](https://github.com/Wine-Red/dsh-prompt-stash/releases/latest) 下载 `dsh-prompt-stash-0.3.2.tgz`，然后安装到 Web profile：

```sh
dsh plugin --profile web add ./dsh-prompt-stash-0.3.2.tgz
```

tarball 同样包含预构建产物。安装后重启 DSH Web。

### 本地源码 checkout

```sh
git clone https://github.com/Wine-Red/dsh-prompt-stash.git
cd dsh-prompt-stash
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add .
```

`dsh plugin` 会把组合包加入目标 profile 的 `dsh.profile.bundles`。可在启动前检查最终配置：

```sh
dsh --profile web --dump-config
```

输出中应包含 `dsh-prompt-stash` 组合层与 `prompt-stash` 插件行。

### 卸载

```sh
dsh plugin --profile web remove dsh-prompt-stash
```

卸载插件不会主动删除浏览器中已有的 `dsh.promptStash.v1` 数据。如需清除，可在浏览器站点数据中删除对应 `localStorage` 项。

## 使用

1. 在输入框中编写一段纯文本。
2. 点击工具栏中的“暂存”，或在消息输入框内按下暂存快捷键。输入框会被清空，上方立即出现折叠的暂存消息栏。
3. 输入并发送临时问题。
4. 展开暂存消息，点击目标内容恢复。
5. 如果输入框已有内容，选择“暂存当前内容并恢复此条”，或取消操作。

添加或删除成功时不会弹出通知；只有存储或输入更新失败时才会显示错误提示。

消息输入框为空时按下快捷键，会恢复并弹出最新一条暂存。恢复后若内容保持不变，继续按同一快捷键会按“最新 → 较早”的顺序轮换其他暂存，当前显示的内容会安全放到轮换队尾，循环一周后再次出现。只要修改了恢复内容、清空后重写或输入了新消息，再按快捷键就会退出轮换，将当前内容新增到暂存并清空输入框，因此仍可连续加入多条暂存。只有一条内容可轮换时，再按一次也按普通暂存处理。快捷键不会覆盖空白字符、图片或文件引用等当前输入。

### 配置快捷键

打开“设置 → 内置插件 → Prompt Stash → 输入暂存”，点击快捷键输入框后直接按下一个按键或组合键，再保存即可立即生效。默认快捷键为 `Ctrl+S`，也可以配置为 `F8` 等单键。输入非空时快捷键执行暂存，输入为空时恢复最新一条；进入恢复状态后，重复按键可循环轮换其余暂存。快捷键只在消息输入框内生效；使用单个可打印字符会占用该字符原本的输入行为。

## 数据与安全边界

- 存储键：`dsh.promptStash.v1`
- 设置命名空间：`prompt-stash`（profile 的 `cordis.patch.yml`）
- 暂存范围：当前浏览器、按 `sessionId` 隔离
- 内容：文本、ID、创建与更新时间、结构版本
- 不存储：图片二进制、附件正文、文件内容、凭据或环境信息
- 暂存内容不发送网络请求、不收集遥测；快捷键只通过 DSH 内置 settings 通道读写 Host 配置

浏览器站点数据被清理时，暂存内容也会被删除。

## 开发与打包

```sh
pnpm install --frozen-lockfile
pnpm format
pnpm typecheck
pnpm test
pnpm build
pnpm pack
```

项目按照 DSH 官方组合包格式提供：

- `package.json` 中的 `dsh.bundle.patch` 声明配置层。
- `cordis.patch.yml` 通过包名挂载插件。
- `lib/` 是预构建运行入口，并被收录进 tarball。
- Host 注册 `dsh-prompt-stash` settings 命名空间；客户端注册 `conversation.input.left`、`conversation.input.dock` 和以该命名空间为键的 `settings.plugin.item` 插槽。

打包与安装机制参见 [DeepSeek Harness 官方文档](https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish)。

## 许可证

[MIT](LICENSE)

### DSH 0.2.0-rc.1 兼容更新（2026-09-29）

支持 DSH `0.2.0-rc.1`，并保留 `0.1.7-rc.1` / `0.1.7-rc.2` 的兼容声明。宿主核心包通过可选 peerDependencies 声明，不再作为生产依赖安装，避免插件带入旧版核心。升级插件后请重启 DSH；未来版本仍需验证后扩展兼容范围。