dsh-session-cleaner DSH 插件

dsh-session-cleaner 为 DeepSeek Harness Web 运行时增加了会话删除功能。它通过侧边栏菜单项和服务器 API 端点，永久删除会话及其工作区记录和工件文件，无需重启。

如何安装 dsh-session-cleaner DSH 插件

dsh plugin --profile web add dsh-session-cleaner            # from npm

复制不会执行命令。安装 dsh-session-cleaner DSH 插件前请核对仓库和版本。

dsh-session-cleaner DSH 插件数据来源

dsh-session-cleaner DSH 插件快照日期：2026年8月16日

discovered

dsh-session-cleaner DSH 插件能做什么

在侧边栏会话行菜单中添加“删除会话”项（当行标题不模糊时显示）。
提供 POST /api-ext/session.delete 端点用于编程删除。
从内存中的实时存储中移除会话，从工作区记录中分离，并删除磁盘上的工件目录。
拒绝删除带有已附加代理（运行中或空闲）的会话。
阻止删除当前活动的对话。

dsh-session-cleaner DSH 插件适合哪些场景

清理不需要的或未完成的会话，保持侧边栏整洁。
移除无法恢复的损坏或卡住的会话。
通过删除已删除会话的工件目录来释放磁盘空间。
通过 API 自动化会话管理，以便与外部工具集成。

dsh-session-cleaner DSH 插件适合谁

想要在不重启服务器的情况下删除特定会话的 DSH 用户。
需要编程方式删除会话以集成外部系统的开发者。

dsh-session-cleaner DSH 插件的限制

无法删除带有已附加代理（运行中或空闲）的会话；只能删除没有代理的空闲会话。
无法删除当前活动的对话。
删除操作不可逆：工件、工作区成员身份和实时条目都会被移除。
会话投影缓存可能会保留一条无害的过期行，直到下一次服务器重启。

dsh-session-cleaner DSH 插件的仓库 README 摘录

以下文字摘自 dsh-session-cleaner DSH 插件的上游仓库 fountunt/dsh-session-cleaner 的 README，版权归原作者，仅作引用。

Delete DeepSeek Harness sessions from a **running** web runtime — files, live store, and workspace records — without restarting `dsh web`. The official web API only offers `workspace.archiveSession` (hide); there is no `session.delete`. This bundle closes that gap. ## Install ```sh dsh plugin --profile web add dsh-session-cleaner # from npm dsh plugin --profile web add github:fountunt/dsh-session-cleaner # from git # or from a local checkout dsh plugin --profile web add file:/path/to/dsh-session-cleaner ``` Then restart `dsh web` (a running instance does not hot-load new bundles). ## Usage ### Web UI (v1.0.0) The client half adds a **🗑 "Delete session" item** at the bottom of the sidebar session row ⋮ menu — the item is skipped when the row title is ambiguous (duplicate titles). Click, confirm, and the session is deleted and the sidebar refreshes. The item is disabled (greyed) while the session is running; sessions opened in the UI (idle agents) are stopped first, then deleted. The current running conversation can never be deleted. ### API The plugin registers one route on the web server: ```http POST /api-ext/session.delete Content-Type: application/json

阅读完整 README仓库许可: MIT

dsh-session-cleaner DSH 插件常见问题

如何在 DSH web 中删除会话？

安装插件后，侧边栏每个会话行的 ⋮ 菜单中会出现“删除会话”项。点击它并确认，会话会立即被删除。对于运行中的会话和当前对话，该选项是禁用的。

我可以删除正在运行的会话吗？

不可以。插件拒绝删除任何带有已附加代理的会话，无论是运行中还是空闲。你必须先停止该会话才能删除。当前活动对话永远无法删除。

有没有编程方式删除会话的 API？

有。插件注册了一个 POST 端点 /api-ext/session.delete。你可以发送包含 sessionId 的 JSON 请求体。响应会指示成功或失败。这可以从 harness 页面的浏览器控制台调用。

删除会话时，会话文件会发生什么？

插件会从实时存储中移除会话，从工作区记录中分离，并删除磁盘上的工件目录。删除操作不可逆——会话及其文件将永久消失。

为什么不能删除当前对话？

插件有意阻止删除当前活动对话，以避免数据丢失。你必须先切换到其他对话，才能删除之前的对话。当前会话的菜单项会显示为灰色。