# DSH Native Session Manager
**在 DeepSeek Harness 原生侧边栏中搜索、恢复和安全清理会话。**
归档管理 · 聊天记录搜索 · 一键恢复 · 安全永久删除
[](https://github.com/WSL043/dsh-native-session-manager/releases/latest)
[](https://github.com/WSL043/dsh-native-session-manager/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/dsh-native-session-delete)
[](https://www.npmjs.com/package/dsh-native-session-delete)
[](#兼容性)
[](LICENSE)
[](https://github.com/WSL043/dsh-native-session-manager/stargazers)
[](https://awesome-dsh-plugin.com)
[English](README.md) · [安装](#安装) · [使用](#使用) · [安全边界](#安全边界)
| 归档可找回 | 聊天可搜索 | 删除更稳妥 |
| --- | --- | --- |
| 从侧边栏打开归档管理器，查看并恢复隐藏的会话 | 按会话名、工作区或用户与助手的聊天内容搜索归档 | 原生菜单保留二次确认；运行中的任务先安全停止，再删除本机会话记录 |
DeepSeek Harness 0.1.1-rc.2 中的原生界面
## 安装
### Windows 快速安装（推荐）
打开 PowerShell，复制这一行：
```powershell
irm 'https://github.com/WSL043/dsh-native-session-manager/releases/download/v1.1.2/install.ps1' | iex
```
助手依次检查当前目录、PATH、`DSH_PORTABLE_ROOT`、下载/桌面/文档目录，以及这些目录和
`LocalAppData\Temp` 下最多三层的 Portable 解压目录；找到后立即调用一次 DSH 官方 `plugin add`。
它不会递归扫盘、安装包管理器、保存 profile 快照、创建常驻命令或重复下载插件。普通 DSH 和
[DSH-Portable](https://github.com/WSL043/DSH-Portable) 的便携版、Windows 安装版都可以作为目标。若同时发现一个长期安装和 Temp
中的测试/解压副本，会自动选择长期安装；若存在多个长期安装，助手会列出真实路径并让你输入编号，
不需要改命令或填写示例路径。若仍未找到，请先进入实际的 DSH-Portable 文件夹再运行同一条命令。
### 官方 CLI（macOS、Linux 或希望直接审阅命令）
```sh
dsh plugin --profile web add dsh-native-session-delete@1.1.2
```
助手和这条命令使用的是同一个标准 bundle 安装机制；助手只是 Windows 入口，不接管安装事务。
安装完成后，保存工作并按 DSH 的正常方式重启一次，使新的 bundle 配置生效。
### 交给 Agent
请使用固定版本的 [AGENTS.md](https://raw.githubusercontent.com/WSL043/dsh-native-session-manager/v1.1.2/AGENTS.md)，
其中写明了安装、更新、验收、卸载和安全边界。不要把 `main` 分支文档当作安装依据。
## 使用
### 管理归档
1. 点击侧边栏标题区域的归档图标，打开 **归档会话**。
2. 直接浏览全部归档，或按会话名、工作区和用户/助手聊天内容搜索。
3. 点击 **恢复** 让会话回到原来的工作区位置；需要彻底清理时，可从同一列表进入永久删除确认。
归档和恢复只改变 DSH 的隐藏状态，不删除聊天记录。搜索范围仅限已归档会话中的当前用户与助手消息，
不会把其他会话或插件数据混入结果。
### 永久删除
1. 打开侧边栏中目标会话右侧的原生操作菜单。
2. 选择红色的 **删除会话**。
3. 在确认弹窗中核对会话名称并再次确认 **永久删除**；也可以随时点击 **取消**。
永久删除无法撤销，确认弹窗会明确显示目标会话
插件生效后，删除逻辑复用 DSH 的生命周期和会话存储能力。正在运行的任务会先停止并等待
收敛，然后删除目标会话；成功后只更新会话列表，不重载整个 DSH 页面。
## 安全边界
> [!WARNING]
> 永久删除无法撤销。点下确认前，请核对会话名称；需要保留的内容请先另行备份。
本插件的责任范围是：在 DSH 默认逐会话 JSONL 存储和宿主生命周期边界内，验证并移除用户明确
确认的目标会话独占目录。DSH 当前没有公开会话删除 API；二次确认是强制步骤，取消不会发送删除请求。
以下内容不在本插件的删除范围内，也不保证被清理：
- 其他会话、其他插件数据、外部附件、缓存、索引、日志、备份和云端/同步副本；
- 非 JSONL 存储或宿主没有安全停止能力的会话；这类情况会拒绝强删并报告未完成；
- 操作系统、文件系统、宿主更新或第三方同步服务造成的额外副本。
如果系统拒绝清理，插件会报告无法确认删除成功，不会把部分完成误报为成功。删除前请确认
自己有权处理目标数据，并遵守适用的数据留存、审计和隐私要求。本项目是非官方社区插件，
与 DeepSeek 无隶属或背书关系；按 [MIT 许可证](LICENSE)提供，不附带担保。
## 兼容性
支持最新版 DeepSeek Harness（`0.1.1-rc.2`）。
归档浏览、恢复和内容搜索使用 DSH 的工作区注册表与会话查询能力；永久删除适用于 DSH 默认的逐会话
JSONL 存储。安装后替换为带会话管理功能的原生工作区列表；卸载后恢复 DSH 原有列表。
## 更新与卸载
更新可重新运行快速安装助手，或安装 npm 上的新版本。v1.1.2 的直接命令是：
```sh
dsh plugin --profile web add dsh-native-session-delete@1.1.2
```
卸载只移除这个插件的 bundle 层，不删除任何会话：
```sh
dsh plugin --profile web remove dsh-native-session-delete
```
DSH-Portable 同样使用标准的 `dsh plugin` 命令。完成安装、更新或卸载后，按 DSH 的正常方式重启，
使配置重新组合。
## 支持与许可证
普通问题请提交 [GitHub Issue](https://github.com/WSL043/dsh-native-session-manager/issues)；安全问题请按
[SECURITY.md](SECURITY.md) 私下报告。
MIT。修改后的上游客户端及其许可说明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。