前言¶

DeepSeek Harness (DSH) 的側邊欄處理會話和工作區兩層結構的方式不同。會話在組內默認按 updated 排序，有新活動時會自動置頂。但工作區本身的順序來自 workspaceIds 數組，即手動拖拽的順序，不會響應實際工作內容。如果你希望“當前正在操作的項目浮到頂部”，只有工作區這一層是缺失的，dsh-workspace-promote 正是爲了填補這一空白。

這是什麼¶

dsh-workspace-promote 是一個 DSH host 插件，由 bobobo2026 維護。它的核心功能是：在你提交任務時，將對應的工作區置頂於側邊欄；一旦任務開始執行，側邊欄保持不動，直到下一次提交。

核心功能¶

1. 提交任務時將工作區置頂。
2. 任務執行期間不重排。
3. 僅響應人類提交的 prompt (user/message 事件)，忽略插件事件和工具結果。
4. 無狀態文件，持久化修改 workspaceIds。
5. 操作僅影響工作區順序，不影響子會話或未分組會話。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile web add dsh-workspace-promote

安裝完成後，需要重啓 dsh web（host-plane 插件在啓動時掛載）。

典型用法¶

1. 提交任務後觀察側邊欄，確認工作區是否已置頂。
2. 查看 ~/.dsh/workspace-promote.log 驗證觸發情況。
3. 重啓 dsh web 以掛載插件。

審覈日誌¶

插件會將行爲記錄到 ~/.dsh/workspace-promote.log（遵循 DSH_HOME 路徑）。這是一份追加日誌，用於確認觸發時機：

2026-09-15T09:31:44.809Z boot pid=49220 trigger=human-prompt-only
2026-09-15T09:33:11.770Z promote workspace=039cce9b-... session=session-1ee5c45f-... from=a6680e0c-...

適用場景與注意¶

• 適用場景：需要快速切換當前工作區的開發者。
• 注意：
  • 與手動拖拽衝突：如果你手動將工作區 B 拖到頂部，然後提交任務 A，A 會再次置頂。
  • 不影響子會話或未分組會話。
  • MIT 許可證。

與其他插件的差異¶

它與 dsh-workspace-sort 的區別在於觸發時機與狀態管理：
- dsh-workspace-sort：按日排序後凍結，適合全天固定順序。
- 本插件：在“用戶提交動作”時觸發並即時置頂，無狀態文件，適合需要當前項目常駐頂部的場景。

短結尾¶

如果你需要當前正在操作的項目在側邊欄常駐頂部，可使用該插件。

• 目錄頁：https://www.skillhub.cn/plugins/bobobo2026/dsh-workspace-promote
• GitHub：https://github.com/bobobo2026/dsh-workspace-promote