前言¶

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，側邊欄不會出現該插件入口。