后续任务建议 littepointR/dsh-suggested-task

Suggested Task for DSH

给 DeepSeek Harness（DSH）用的常驻插件：每轮对话结束后，在对话流末尾给出几个可执行的后续任务建议（类似 Claude Desktop 的 Suggested Tasks），支持单个点击开始或一键开始全部，每个任务会自动 Fork 当前对话上下文、在独立的 Git 工作树（.agents/worktrees/<branch>）中作为独立子会话并行完成。

功能

- 轮次末尾后续任务卡片（conversation.chat.turnTail）：
- 每轮对话正常结束后，自动基于当前对话上下文生成 2～3 个具体的后续任务建议（标题、简短说明、执行提示词与目标 Git 分支名）。
- 支持点击单个任务的 「开始」，或点击卡片右上角的 「全部开始 (N)」 一键并行启动所有未开始的任务。
- 任务启动后，卡片实时展示对应子会话的运行状态（进行中 / 已就绪）以及一键跳转按钮 「查看子会话 →」。
- 独立 Git 工作树隔离（.agents/worktrees/...）：
- 每个启动的任务都会先在当前完成轮次的边界处 Fork 父会话（完整继承当前对话的上下文），然后自动在仓库的 .agents/worktrees/<branch> 下创建独立 Git 工作树与分支，并将子会话的工作目录切换到该工作树中执行，互不干扰。
- Claude 风格子会话展示与导航：
- 左侧会话栏自动缩进与父子关联：新建的任务子会话会自动排列在父会话正下方，带有缩进导引线、子会话分支图标（sidebar.session.row.leading）以及悬浮详情卡片（sidebar.session.row.hover，显示所属父会话与工作树分支）。
- 会话顶部父子面包屑与切换器（conversation.session.header.actions）：
- 在子会话中查看时，顶部标题旁显示可点击的 ↖ 父会话：<标题> 胶囊与 ⎇ <branch> 工作树分支标签，一键返回父会话。
- 在父会话中查看时，顶部标题旁显示 ↳ N 个子会话 状态下拉菜单，随时查看各子会话进度并切换过去。
- /tasks 命令：
- /tasks 或 /tasks generate [turn]：按需为最近一轮（或指定轮次）生成/重新生成后续任务建议。
- /tasks start <turn> <taskId>：启动指定轮次的单个建议任务。
- /tasks start-all [turn]：一键启动指定轮次的全部未开始建议任务。

环境要求

- DSH >=0.2.1-rc.2 —— package.json 通过 engines.dsh 声明了运行时下限。

安装

从 GitHub 安装（无需构建）

dsh plugin --profile web add github:littepointR/dsh-suggested-task
dsh web

dsh plugin add 会把安装转发给所选 profile 内的 pnpm；由于插件通过 dsh.bundle.patch 声明了 bundle，安装完成后会自动把该 bundle 加入 dsh.profile.bundles。插件是纯 JavaScript 实现、没有 prepare 构建脚本，因此从 Git 安装无需额外的 pnpm 构建授权。若 profile 未启用 HMR，重启 profile 后插件生效。

需要固定发布版本时：

dsh plugin --profile web add github:littepointR/dsh-suggested-task#v1.0.0

桌面应用的 desktop profile 由 Electron 应用独占管理，独立安装的 dsh CLI 会拒绝 --profile desktop。桌面版请在 设置 → 插件 → 添加 中粘贴仓库地址 https://github.com/littepointR/dsh-suggested-task，插件会即时生效，无需重启应用。

从本地检出安装

git clone https://github.com/littepointR/dsh-suggested-task.git
dsh plugin --profile <profile> add link:<本地检出目录的绝对路径>

bundle 的 cordis.patch.yml 会插入一行配置：

- insert:
- id: suggested-task
name: '@local/dsh-suggested-task'

配置

所有字段均可选，可在 profile 的 cordis.patch.yml 中按 suggested-task 行覆盖：

| 字段 | 默认值 | 含义 |
| enabled | true | false 时不注册投影、轮次监听与 /tasks 命令 |
| mode | 'fork' | 'fork' 复用完整对话前缀；'digest' 发送紧凑 JSON 摘要 |
| maxTasks | 3 | 每轮最多给出的后续任务数量（1..5） |
| maxTokens | 1024 | 建议任务请求的输出 token 上限 |
| temperature | 0.3 | 采样温度 |
| timeoutMs | 15000 | 单次建议生成请求的超时时间（毫秒） |
| maxForkChars | 12000 | fork 模式保留的对话窗口字符上限 |
| maxInputChars | 6000 | digest 模式摘要字符上限 |
| fallback | true | fork 模式无结果时是否自动回退到 digest 模式 |
| skipSubagents | true | 子代理会话不自动生成建议任务 |
| skipTaskSessions | true | 由建议任务派生出的子会话默认不再自动生成下一层建议任务 |
| worktreePrefix | 'task/' | Git 工作树分支名前缀（如 task/add-unit-tests） |
| worktreeFallback | true | 当前目录不是 Git 仓库时，允许回退为在原工作目录中启动子会话 |
| provider、model | 未设置 | 显式指定模型路由；默认复用本轮自己的模型路由 |

开发与测试

npm test # 运行 Host 与 Client 单元测试
npm run check # 语法检查

许可

MIT，详见 LICENSE。