dsh-task-runner

dsh-task-runner

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

• 项目（Project）：现有行为不变 —— 侧边栏顶部有「项目」分组标题，下面各工作区文件夹与会话照常显示。
• 任务（Task）：与项目平级的独立分组 —— 不绑定任何工作区，每次新建任务自动在 D:\dsh_working\<名称>-<时间戳>\ 下创建独立临时目录作为会话工作目录，像 Codex 一样即开即用； 所有无工作区会话（含旧 Ungrouped）都显示在「任务」组下，空时显示「暂无任务」。 「任务」标题右侧有「+」按钮：点击立即创建任务会话并切换到新会话（自动命名，无需弹窗）。

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

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

工作原理（为什么不需要 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）。