前言¶

DeepSeek Harness (DSH) 采用插件化架构。在开发调试或进行临时实验时，开发者往往需要一个与长期工作区隔离的环境。dsh-temptask 插件为 DSH 增加了“临时任务”模式：一键创建隔离的临时工作目录，即开即用、用完即弃。如果临时任务产出了成果，可以通过“转正”功能将其转化为正式工作区。

安装与启用¶

安装插件需要使用 DSH 的包管理器命令。

# 安装插件
dsh plugin add @aeroscis/dsh-temptask

安装完成后必须重启 DSH，插件才能生效。侧边栏顶部（“新建会话”下方）会新增一行“临时任务”。点击主区域可新建，右侧五个按钮依次为清理、转正、打开根目录、说明和设置。

注意：desktop 是 Electron 保留的 profile 名，终端命令无法管理。桌面版请使用应用内的插件管理界面。

核心功能¶

1. 一键创建隔离目录
   新建任务会在 <DSH_HOME>/dsh-temptask/<时间戳>/ 下创建一个目录，并在此处开启会话。侧边栏会将其渲染为标准工作区，支持展开、归档和搜索。

2. 自动总结会话标题
   工作区名默认为时间戳目录，DSH 会根据首条消息自动总结会话标题并显示在会话行上，无需手动起名。

3. 转正功能
   当临时任务需要长期保留时，可点击侧边栏的 ♥ 按钮或使用命令将其转换为正式工作区。该过程会移动目录、重命名，并将对话历史复刻进新工作区。

4. 清理功能
   支持删除不需要的临时任务。清理操作有二次确认，且默认只删除任务根目录下的子目录，根目录本身不会被触碰。

命令与用法¶

插件提供了完整的命令行接口。

/temptask list                       列出全部任务
/temptask new                        新建任务并打开会话
/temptask open <ID|目录名|标题>      打开任务
/temptask promote <ID|目录名|标题> --dir <父目录> [--name <新名>] [--yes]
                                     转正任务：搬目录 + 建正式工作区
/temptask clean <ID|目录名|标题>     删除任务（需 --yes 确认）
/temptask clean --all --yes          清理全部任务

配置与数据¶

插件数据存储在 DSH 的配置目录下。

<DSH_HOME>/dsh-temptask/            ← 任务根目录（任务目录）
└── 2026-09-27-14-30-00/            ← 每个任务一个目录

<DSH_HOME>/plugin-data/dsh-temptask/
├── tasks.json                      ← 任务元数据
└── config.json                     ← 插件配置

配置项位于“设置 → 插件 → 临时任务”。主要配置包括任务根目录、自动清理天数（清理超过 N 天的已关闭任务）以及删除任务时如何处理会话（归档或留在未分组）。

注意事项与限制¶

• 会话不可真正删除：DSH 不提供删除会话的能力，插件只能将其归档（日志仍留在磁盘上）。
• 转正限制：转正功能只复刻“已完成的一轮”对话。如果最后一个回合未完成，或没有任何已完成回合，新会话将为空。
• 目标目录限制：转正的目标目录不能落在任务根目录内部，否则会变成新的临时任务。
• 版本兼容：该插件对 DSH 版本有要求。如果版本不兼容，DSH 日志会显示 skipping profile bundle，侧边栏不会出现该插件入口。