@the-heart-fickle/dsh-session-manager

Readme

# dsh-session-manager

`dsh-session-manager` 是一个面向 DeepSeek Harness（DSH）的会话管理插件，把两个高频需求合在一起：

- **回退（Rewind）**：对话走偏时，一键回到之前某个用户消息，重新开始。
- **归档（Archive）**：暂时不用的会话先归档，保持侧边栏整洁，之后可以恢复或彻底删除。

它只增强 DSH 的会话管理能力，不改变模型、不改变工作区、不绑定特定项目。

## ✨ 功能一览

- **对话回退**
  - 会话头部新增“回退”按钮，也支持 `Ctrl/Cmd+Shift+Z` 快捷键。
  - 可从当前已加载窗口中选择任意一条可定位回退点的历史用户消息；运行中回合里通过 `Ctrl/Cmd+Enter` 插入的 steering 也会立即出现，不需要等该回合结束。
  - 确认后基于该回合之前的状态派生新会话，并把原消息放回输入框，方便重新编辑。

- **文件回退**
  - 默认使用 `shadow git` 在工作区级别保存快照，不触碰项目自身的 `.git`。
  - 回退时可选择“仅会话回退”，也可选择“带文件回退”同时恢复工作区文件。
  - 回退前自动做安全提交，避免误操作丢失后续改动。
  - 支持 `git`、`diff`、`none` 三种文件回退模式。

- **归档会话**
  - 在侧边栏底部提供“归档会话”入口。
  - 已归档会话可从归档列表快速恢复。
  - 支持彻底删除单个会话、删除全部已归档会话、删除全部未分组归档会话。

## 📦 安装

前置条件：已安装 DSH，且 `dsh web` 可以正常运行。

### 通过 npm / DSH CLI 安装

```sh
dsh plugin --profile web add @the-heart-fickle/dsh-session-manager@latest
```

### 通过 plugin-registry 安装

```sh
npm run package:registry
dsh registry install ./registry
dsh registry enable the-heart-fickle/dsh-session-manager
```

> `registry/` 是本地生成的安装暂存目录，不会提交到仓库。

## 🚀 快速上手

1. 安装插件后重启 DSH，并刷新浏览器页面。
2. 在会话头部点击“回退”按钮，或按 `Ctrl/Cmd+Shift+Z`。
3. 从弹出的历史用户消息列表中选择要回到的位置。
4. 按需选择“仅会话回退”或“带文件回退”，确认后会自动创建新会话。
5. 使用侧边栏底部的“归档会话”入口管理不常用的会话。

## ⚙️ 配置

在 profile 的 `cordis.patch.yml` 中配置：

```yaml
- id: session-manager
  name: '@the-heart-fickle/dsh-session-manager'
  config:
    rewindIgnoreFile: 'rewind-common.gitignore'
    rewindFileMode: 'diff'   # 'git' | 'diff' | 'none'
```

- `rewindIgnoreFile`：相对 profile 目录解析的公共 ignore 文件，叠加在工作区自身 `.gitignore` 之上。
- `rewindFileMode`：控制回退时的文件行为。
  - `git`：使用 Git 快照回退，失败时降级为文件读写回退。
  - `diff`（默认）：只使用文件读写回退，不创建 Git 快照。
  - `none`：不启用文件回退，仅回退会话。

## 🔧 环境要求

- Node.js ≥ 20
- DSH（DeepSeek Harness）
- 使用 `git` 模式时需要系统可用的 `git` 命令

## 许可证

MIT