deepseekplugins

DeepSeek Harness plugin

dsh-session-delete-akira399

Permanently delete DSH sessions from the file system, right from the sidebar conversation menu (真正的物理删除，不是归档隐藏).

Memory
Jump to install

Source facts

Repository
akira399/dsh-session-delete
Latest update
Aug 15, 2026
Category
Memory
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/akira399/dsh-session-delete
Plugin: dsh-session-delete-akira399
Author: akira399

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-session-delete

> 在 DSH 侧边栏对话菜单中真正永久删除会话 —— 从文件系统层面删除会话日志，而不是像归档那样仅仅隐藏。

DSH 官方客户端目前只提供「归档会话」（把会话从列表隐藏，日志文件仍留在磁盘）。本插件在会话行 ··· 菜单的「归档对话」下方新增「删除对话」入口：点击并确认后，会话的日志文件会从磁盘彻底删除，不可恢复。

功能特性

  • ✅ 真实物理删除：通过官方 sessionPersistence.locate() 定位会话目录并递归删除日志文件，非隐藏、非标记删除
  • ✅ 运行中的会话也能删：自动取消正在进行的回复 → 从内存摘除 → 删除文件，删除后不会被内存日志"复活"
  • ✅ 记账同步清理：workspace.json 的会话席位与全局归档集合一并清除，不留脏数据
  • ✅ 即时刷新：删除后会话行立即消失，无需刷新页面（复用官方 store 刷新与事件帧）
  • ✅ 二次确认：删除前弹出确认框，显示会话标题并明确提示不可恢复
  • ✅ 识别准确：依据官方快照 store + 侧边栏行序 + 标题三重校验定位会话，避免误删
  • ✅ 零依赖：仅使用 Node 内置模块与注入的官方服务，无第三方运行时依赖

使用场景

  • 清理不再需要的实验性对话、临时会话，释放磁盘空间
  • 删除包含敏感内容的会话，确保日志从磁盘彻底消失
  • 归档无法满足的"彻底删除"需求（归档只是隐藏，文件仍可被搜索/导出找回）

安装

npx -p @deepseek-ai/dsh dsh plugin --profile web add <owner>/dsh-session-delete

安装完成后重启 dsh web 生效。

> 也可以从 GitHub 仓库地址安装：npx -p @deepseek-ai/dsh dsh plugin --profile web add github:<owner>/dsh-session-delete

使用

1. 在左侧对话列表找到目标会话，将鼠标移到该行，点击行尾的 ··· 按钮； 2. 菜单中「归档对话」下方点击「删除对话」（英文界面为 Delete session）； 3. 在确认弹窗中点击「确定」； 4. 会话行立即从列表消失，磁盘上的会话日志已永久删除。

> 删除正在运行的会话时，会先中止该会话的回复再执行删除。

工作原理

DSH 官方没有为会话行菜单提供扩展 slot，本插件采用 host + client 双半端实现：

  • Host 半端（lib/index.js）：注册本地路由 POST /session-delete/api/delete。

- 校验 sessionId（严格 session-<uuid> 格式，杜绝路径穿越）与请求来源（仅 localhost）； - 若会话在内存中（打开/运行）：通过官方 agents 服务取消当前 turn，再通过 sessions store 的标准 detach() 路径摘除内存会话（触发官方 host/session-removed 帧），防止内存日志把文件"复活"； - 通过官方 sessionPersistence.locate() 定位会话目录（~/.dsh/sessions/<workspace-key>/session-<uuid>/），递归删除； - 通过官方 workspaceRegistry 的操作队列清理记账（workspace 的 sessionIds 席位与全局归档集合），前端经官方 domain/changed 帧自动同步。

  • Client 半端（lib/client.js）：监听会话菜单渲染 DOM（role="menu"），在「归档会话」下方克隆注入「删除对话」项；点击时依据官方快照 store（ctx.sessions.list / ctx.workspaces.list，与 UI 渲染同一份数据）+ 侧边栏行序定位 sessionId，并以行标题（aria-label）二次校验；确认后调用删除路由，成功后通过官方 ctx.sessions / ctx.workspaces 运行时服务刷新列表。

安全与边界

  • 删除请求仅接受来自 localhost 的访问（DSH Web 同源页面）；
  • sessionId 严格校验为 session-<uuid> 格式，杜绝路径穿越；
  • 附件（图片等）是跨会话共享资源，不随会话删除，避免破坏其他会话的引用；
  • 运行中会话的删除需要先中止其回复（不可恢复的操作，确认框中已明确提示）；
  • 删除的是目标会话本身；其子代理会话（subagents/）各自独立存储，如需一并删除请逐个操作。

已知限制

  • 菜单注入依赖官方客户端的 DOM 结构与「归档会话 / Archive session」菜单文本，DSH 官方升级若调整该菜单结构，本插件可能需要同步适配；
  • 会话的查询/投影缓存不强制清理，官方缓存机制会在下次读取时自愈。

常见问题

问题说明
点击后提示"无法识别该会话"侧边栏行与数据快照短暂不一致时可能出现；刷新页面后重试即可（控制台会输出诊断信息）
提示"该会话当前处于打开状态且无法从内存移除"极少数情况下内存摘除不可用，重启 DSH 后即可正常删除
删除后磁盘占用没有减少附件为跨会话共享资源，不会被删除；仅会话日志目录被移除

免责声明

删除操作不可恢复，请确认后再点击。使用本插件造成的任何数据损失由使用者自行承担；本插件仅提供删除功能，不构成任何担保。

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category