前言¶
在 DeepSeek Harness (DSH) 的开发流程中，随着项目注册和持久化会话的积累，清理不再活跃的资源是维护环境整洁的关键步骤。手动删除文件或配置可能遗漏注册信息，导致环境状态不一致。本插件提供了标准化的命令和 Web 界面，用于安全地移除项目注册和持久化会话。
插件介绍¶
dsh-command-delete 是一个 DSH 插件，由用户 wang122818 维护。它的核心功能是提供斜杠命令和 Web UI 管理面板，专门用于删除项目注册和持久化会话，解决了手动管理 DSH 资源带来的繁琐与潜在错误。
核心功能¶
斜杠命令¶
插件提供了三个核心命令：
* /delete-project <workspaceId>：删除项目注册。
* /delete-workspace <workspaceId>：删除工作区注册。
* /delete-session <sessionId>：删除持久化会话。
其中，/delete-workspace 是 /delete-project 的别名，两者行为一致。
Web UI 管理¶
安装 Web UI 捆绑包后，侧边栏底部会出现一个垃圾图标。点击该图标可打开管理面板，列出项目与会话。所有破坏性操作（如删除）都会弹出确认对话框，防止误操作。
删除逻辑¶
- 项目/工作区删除：此操作仅移除 DSH 工作区注册，项目目录及会话日志文件在磁盘上保持不变。
- 会话删除：此操作会永久删除持久化的 JSONL 会话目录。如果会话当前被活跃的 Agent 拥有，删除操作将被拒绝。
安装与启用¶
从包含该插件包的目录运行以下命令。请根据实际使用的配置文件名称替换 default：
dsh plugin --profile default add .
安装后需重启 DSH 进程以使插件生效。
典型用法¶
在 DSH 界面中直接输入以下命令：
/delete-project <workspaceId>
/delete-workspace <workspaceId>
/delete-session <sessionId>
如果不提供 <workspaceId> 或 <sessionId>，命令会打印当前可用的 ID 列表。
注意事项与适用场景¶
适用场景¶
- 清理测试产生的多余工作区注册。
- 归档并删除历史会话日志。
- 通过 Web 界面进行可视化的资源管理。
权限与限制¶
- 权限运行：插件以当前 DSH 进程的权限运行，执行文件系统操作。
- 活跃会话保护：当前 DSH 版本未暴露公共的会话删除生命周期接口。因此，插件设计为拒绝删除当前被活跃 Agent 拥有的会话，以防止数据丢失或进程异常。
- 项目目录保留：删除项目注册不会清理磁盘上的项目目录和日志文件，仅清理 DSH 的内部注册表。
安全建议¶
安装前请检查插件的源码与许可证（MIT），确保符合您的安全合规要求。
总结¶
dsh-command-delete 为 DSH 用户提供了项目注册和会话管理的标准化工具，既支持命令行快速操作，也提供 Web 界面的安全确认机制。对于需要频繁管理开发环境资源的开发者而言，这是一个实用的辅助工具。
