DSH (DeepSeek Harness) supports workspace management by default, but when handling temporary sessions or “sandbox” tasks, you often need to switch between multiple sessions frequently. The dsh-task-runner plugin upgrades the sidebar to a dual mode of “Project” and “Task”, providing isolated temporary directories for temporary sessions to facilitate quick isolation and cleanup.

Plugin Introduction

  • Name: dsh-task-runner
  • Core value: Provides a “Project/Task” dual-mode workspace. Tasks automatically create isolated temporary directories (Codex style).
  • Maintainer: jing-hy
  • License: MIT

Core Features

  • Dual-mode workspace: The sidebar is divided into “Project” and “Task” groups. Projects retain the original behavior; Tasks act as an independent group and are not bound to a workspace.
  • Isolated temporary directory: Each time a task is created, an independent folder is created under the default root directory (for example D:\dsh_working\<name>-<timestamp>\) as the session working directory for that task.
  • Task management commands: Provides the /task command (list, new, open, clean) for managing tasks within a session.
  • Sidebar patch: Provides scripts to fix the EAC 4.1/4.2 layout, ensuring the task bar remains visible and displays correctly.

Installation and Activation

Install the plugin using the official DSH command:

dsh plugin --profile web-desktop add dsh-task-runner

After installation, you must completely exit and restart DSH (EAC desktop: close normally and then reopen) so that the sidebar displays the “Project / Task” groups.

Typical Usage

  1. Click the “▦ Task” button at the bottom of the sidebar to open the task panel.
  2. Enter a task name (it can be left empty; if empty, it will be named task-<timestamp> automatically), then click “New”.
  3. A new session opens immediately, with the working directory D:\dsh_working\<name>-<timestamp>\.

/task Command

Execute the following commands in any session:

/task list                 # 列出所有任务
/task new <名称>            # 创建任务目录并登记
/task open <名称|id>        # 查看任务信息（从面板打开会话）
/task clean [名称|id]       # 清理已结束任务（不带参数=清理全部）

Applicable Scenarios and Notes

  • Applicable scenarios: Suitable for scenarios where you need to create temporary sessions frequently, perform experimental development, or require context isolation.
  • Security boundaries: API requests are protected by the browser’s trust perimeter, directory operations are limited to the task root directory, and path traversal is rejected.
  • Configuration: The default task root directory is D:\dsh_working (Windows) or ~/.dsh/tasks (other platforms).
  • Note: After an EAC upgrade, the patch script must be replayed; dsh-side-session built into EAC is a separate official plugin.

Conclusion

This plugin extends the DSH sidebar’s capabilities to separate project flows from temporary task flows, improving the efficiency of parallel multi-task processing. For more details, see the plugin directory or source code.