deepseekplugins

DeepSeek Harness plugin

dsh-task-runner

Project/task dual-mode workspaces for DSH: a task skips the workspace picker and gets a fresh scratch directory (D:\dsh_working\<name>-<timestamp>) per conversation, Codex-style; no-workspace sessions are grouped under a persistent Tasks section in the sidebar with empty states, and the new-session workspace picker gains a "no workspace (task)" option.

Tools & Capabilities
Jump to install

Source facts

Repository
jing-hy/dsh-task-runner
Latest update
Aug 19, 2026
Category
Tools & Capabilities
GitHub stars
0

Install

Start with a prompt that asks an agent to read the 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 read the page and repository first.

Do not install anything yet. Read this DeepSeek Harness plugin and explain what it does, which files, networks, or credentials it can access, and how to install and remove it.

Plugin page: https://deepseekplugins.org/plugins/jing-hy/dsh-task-runner
GitHub: https://github.com/jing-hy/dsh-task-runner
Plugin: dsh-task-runner
Author: jing-hy
Install command: dsh plugin --profile web add github:jing-hy/dsh-task-runner

Do not run the install command until I confirm.

Check the source files

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

File explorer3 files
README.mdSource · read only

dsh-task-runner

DSH（DeepSeek Harness，含 DSH EAC 桌面版）插件：把侧边栏升级为「项目 / 任务」双模式。

  • 项目（Project）：现有行为不变 —— 侧边栏顶部有「项目」分组标题，下面各工作区文件夹与会话照常显示。
  • 任务（Task）：与项目平级的独立分组 —— 不绑定任何工作区，每次新建任务自动在

D:\dsh_working\<名称>-<时间戳>\ 下创建独立临时目录作为会话工作目录，像 Codex 一样即开即用； 所有无工作区会话（含旧 Ungrouped）都显示在「任务」组下，空时显示「暂无任务」。 「任务」标题右侧有「+」按钮：点击立即创建任务会话并切换到新会话（自动命名，无需弹窗）。

> EAC 桌面版注意：EAC 内置的「临时会话」是另一个官方插件（dsh-side-session，侧边栏底部图标 + > Ctrl+Shift+S），与本插件的「任务」是两回事。若想隐藏它，见下文[临时会话按钮](#临时会话按钮临时会话-temp-session-button)。

新建对话走官方流程：点「新建会话」→ 空状态 →「选择工作区」菜单里除了各工作区，还多了一项 「无工作区（任务）」，点击即在任务根目录下创建新会话并直接打开。

工作原理（为什么不需要 hack 核心）

DSH 的 session.create API 原生支持 cwd 参数（与 workspaceId 互斥）： 传 cwd 创建的会话不 attach 任何工作区，且 host 会自动 mkdir 该目录。 本插件只是把这个被 UI 隐藏的能力接出来：

  • host 侧维护任务清单（D:\dsh_working\.tasks.json），提供 fenced JSON API 与 /task 命令；
  • client 侧通过官方选择器/侧边栏的「任务」分组提供「无工作区」入口，用 sessions.create({ cwd }) 创建无工作区会话；
  • host 钩子兜底：任何 cwd 落在任务根目录下的会话都会自动登记/回收，即使绕过了 UI。

支持版本

环境侧边栏布局说明
DSH EAC 4.2.0（dsh-client-ui-workspace 0.1.0-rc.7）官方移除了任务钩子，分组改为 ProjectRowItem 组件补丁脚本 v3 在 rc.7 上重建「项目 / 任务」标题行：任务分组渲染成与「项目」完全一致的纯标题行（同字体、无 hover），点击可折叠，行尾「+」新建。
DSH EAC 4.1.0 / dsh 0.1.0-rc.6官方内置任务钩子项目/任务标题行 + 「添加工作区」按钮移位。

补丁脚本 scripts/patch-sidebar-always-visible.mjs 会自动检测上表布局（找 ProjectRowItem）， 自动适配 4.1 / 4.2，逐补丁幂等（已打的跳过、缺的补齐）。

安装

# 开发路径安装（本地改代码即时生效，推荐开发时）
dsh plugin --profile web-desktop add link:D:\coding\dsh-task-runner

# 或从 npm / GitHub 安装
dsh plugin --profile web-desktop add dsh-task-runner

EAC 桌面端运行的是 web-desktop profile（~/.dsh/profiles/web-desktop）；若你回切到共享 web profile（settings.json 的 shareWebProfile: true），把上面 --profile 换成 web。

仓库：https://github.com/jing-hy/dsh-task-runner

装完完全退出并重启 DSH（EAC 桌面端：正常关闭后重新打开）才会生效。 验证：profile 的 package.json 里 dsh.profile.bundles 已包含 dsh-task-runner， 侧边栏出现「项目 / 任务」分组。

侧边栏补丁（EAC 升级后需重放）

插件补丁了官方宿主文件（resources\app\node_modules\@deepseek-ai\dsh-client-ui-workspace\lib\client.js， 由 /plugins/@deepseek-ai/dsh-client-ui-workspace/client.js 动态提供）。EAC 升级会覆盖该文件， 升级后任务栏、项目/任务标题会变回官方原样 —— 重跑一次补丁脚本即可全部恢复：

# 脚本随 npm 包分发，位于 node_modules/dsh-task-runner/scripts/ 下
node node_modules/dsh-task-runner/scripts/patch-sidebar-always-visible.mjs
# 或直接从仓库运行
node scripts/patch-sidebar-always-visible.mjs

脚本各补丁（EAC 4.2 / rc.7 布局）：

patch作用
1任务分组常驻（即使无任务也不消失）
2空分组显示「暂无任务」
3a任务分组标题显示「任务」（替代英文 Ungrouped）
3b任务分组「+」按钮接线 createTask()
3c「项目」分组标题行
3d任务行隐藏文件夹/折叠图标
3e任务分组渲染为与「项目」完全一致的纯标题行（无 hover、同字体）

改的是官方宿主动态模块，强刷 Ctrl+Shift+R 即生效，无需重启。每次执行前自动备份 （client.js.bak-taskbar-<时间戳>）。脚本逐补丁幂等，可重复执行。

使用

任务面板（推荐）

1. 点侧边栏底部的「▦ 任务」按钮打开任务面板； 2. 输入任务名称（可留空，留空自动命名 task-<时间戳>），点「新建」； 3. 新会话立即打开，工作目录为 D:\dsh_working\<名称>-<时间戳>\； 4. 面板里每个任务可「打开」（恢复其会话；会话已删除则在原目录新开）或「清理」（删除目录与登记）； 5. 「清理全部已结束任务」只清理 finished / missing 状态的任务；活跃任务需先结束其会话，面板不会误删。

/task 命令（会话内管理）

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

临时会话按钮（EAC 内置 side-session）

EAC 桌面版自带的「临时会话」（dsh-side-session，侧边栏底部图标 + Ctrl+Shift+S）是独立官方插件。 若不需要，可在 profile 配置里禁用它（属配置文件改动，改后需重启 EAC 生效）：

# ~/.dsh/profiles/web-desktop/cordis.patch.yml
- insert:
    - id: side-session
      name: '@dsh-external/dsh-side-session'
      disabled: true

> ⚠️ EAC 升级会重写 cordis.patch.yml，可能把你手改的 disabled: true 弄丢，临时会话按钮会 > 重新出现 —— 升级后检查并重加一次即可。

配置

默认值开箱即用（Windows 任务根目录为 D:\dsh_working，其他平台为 ~/.dsh/tasks）。 需要覆盖时，在 profile 的 cordis.patch.yml 里给插件行加 config：

- insert:
    - id: task-runner
      name: 'dsh-task-runner'
      config:
        rootDir: 'E:\\dsh_tasks'   # 自定义任务根目录
        nameMaxLength: 60          # 名称长度上限（默认 40）

卸载

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

移除后重启 DSH。任务目录与 D:\dsh_working\.tasks.json 不会被删除（保留你的数据），可手动清理。 侧边栏宿主补丁（如果打过）：重装 EAC 或运行脚本前用备份文件回滚，或直接让 EAC 升级覆盖。

与已有 dsh_working 工作区的说明

若你的 ~/.dsh/storages/workspace.json 里已手工注册过 D:\dsh_working 为工作区，建议删除该注册 （任务目录改为通过 cwd 直接创建，不经过工作区注册表；留着它也不会影响任务，只是侧边栏多一个 没有新会话的空工作区）。删除方式：设置 → 工作区，或直接编辑 workspace.json 并重启。

安全与边界

  • /task-runner/api/* 采用与官方插件一致的浏览器信任围栏（loopback / trusted-host / 同源校验），

仅接受 POST；

  • 所有目录操作都限制在任务根目录内（withinRoot 校验），拒绝路径穿越；

任务根目录本身永远不会被当作任务（adopt 与会话钩子均排除），即便出现指向根目录的脏注册记录， cleanup 也只会注销记录、绝不触碰根目录内容；

  • 清理默认拒绝活跃任务（需 force）；任务目录被手动删除会标记为 missing，清理时只清注册不报错；
  • 子代理会话（origin: 'subagent'）不会被登记为任务。

开发

npm test                          # registry 单测（node:test）
node test/host-smoke.mjs          # host 挂载 + API 全链路冒烟
node test/client-load-sim.mjs     # client 加载模拟（ModuleLoader + apply）
node scripts/patch-sidebar-always-visible.mjs   # 重放宿主侧边栏补丁（幂等）

插件结构：

lib/index.js        host 插件：Config / API / 会话钩子 / /task 命令
lib/registry.js     TaskRegistry：任务清单与目录生命周期（纯 Node，可单测）
lib/wire.js         JSON API 工具（受限 body 读取、响应封装）
lib/trust-fence.js  浏览器信任围栏
lib/client.js       client 插件：任务面板 + createTask / openPanel / isTaskDir
scripts/patch-sidebar-always-visible.mjs  宿主侧边栏补丁（EAC 4.1/4.2 自动适配，逐补丁幂等）
test/               单测与冒烟

兼容性：v1.1.0 起支持 DSH EAC 4.2.0（rc.7 布局）；v1.0.1–1.0.2 支持 DSH EAC 4.1.0 （web-desktop profile / dsh.profile.bundles 加载机制）；向下兼容 dsh 0.1.0-rc.6 （EAC 3.0.1）的 web profile 插件机制（dsh.bundle.patch）。

疑难排查

  • 侧边栏任务区看不到会话：任务组（无工作区分组）默认折叠，本插件已将其强制展开；强刷页面（Ctrl+Shift+R）后生效。
  • 没有任务时侧边栏「任务」栏整个消失：宿主只在存在无工作区会话时才渲染「任务」分组。

运行补丁脚本让任务栏常驻并在空时显示「暂无任务」（改的是宿主动态模块，强刷生效，无需重启）。

  • EAC 升级后「项目 / 任务」标题、任务栏布局变回官方原样：EAC 覆盖了宿主文件，重跑

node scripts/patch-sidebar-always-visible.mjs 即可（脚本逐补丁幂等，自动备份）。

  • 创建任务时报 "session create failed"：客户端偶发把已成功的创建误报为失败（host 实际已建）。

本插件已容错：从任务清单找回真实会话并打开；如仍复现，查看浏览器控制台 [dsh-task-runner] createTask failed: 日志。

  • 右侧栏（better-sidebar）看不到新建文件：better-sidebar 的 explorer 不自动刷新（设计如此），点其右上角刷新按钮即可。
  • 任务根目录可改：profile 的 cordis.patch.yml 里给插件行加 config.rootDir（默认 D:\dsh_working）。
Back to searchOpen GitHub repository

More related plugins

View category