前言¶
DeepSeek Harness (DSH) 的設計理念是插件化，旨在擴展客戶端功能。在進行多步驟任務或長時間對話時，後臺運行狀態、子代理進度以及會話概覽往往分散在界面各處，不易集中管理。dsh-task-console 插件通過翻轉界面，提供了一個懸浮的毛玻璃任務控制台，將當前會話的核心數據整合在統一的視圖下。
插件定位¶
這是一款由 He2way 維護的 DSH 客戶端插件。它將當前的對話頁面翻轉至背面，呈現一個毛玻璃質感的任務板，實時展示會話概覽、後臺任務、子代理、工作區及插件狀態。插件支持自定義卡片、無限畫布協作以及通過對話直接生成卡片。
核心功能¶
一體兩面翻轉與統一懸浮窗¶
點擊頁面右下角的玻璃按鈕，頁面會圍繞垂直中心軸翻轉，露出背面的任務控制台。此時對話輸入框會保持固定並自動變形爲懸浮窗，確保在查看任務板時仍可正常輸入和發送消息。關閉或按 Esc 鍵可返回會話界面。窗口初始大小爲 440×480，支持通過拖拽頂部欄移動，拖拽右下角調整大小（320–viewport 限制）。
當前會話實時數據¶
任務板通過 DSH 的標準數據源 useSessions 提供實時數據：
* 會話概覽：標題、運行/空閒狀態、階段、來源及實時任務/子代理計數。
* 後臺任務：實時展示後臺任務的狀態、類型標籤、標籤及運行時長。
* 子代理：會話中子代理的目錄，包含子任務/分叉、運行/空閒狀態及 ID。
* 工作區：當前工作目錄、會話 ID 及最後更新時間。
* 插件管理：動態插件清單，顯示插件名稱、運行/停止狀態及操作（停止/移除）。
卡片交互與持久化¶
任務板由多個卡片組成，內置卡片（會話、任務等）爲只讀，用戶卡片支持：
* 操作：置頂（📌）、刪除（🗑，需二次確認）、摺疊（▴/▾）。
* 持久化：卡片的位置、大小和狀態保存在瀏覽器的 localStorage 中（鍵名 dsh.taskconsole.v1）。
* 復位：可恢復內置佈局，同時保留用戶自定義卡片。
無限畫布與多人協作¶
任務板支持無限畫布功能。點擊頂部的“畫布”按鈕可進入全屏模式，支持滾輪縮放（指針錨點）、拖拽平移。用戶可將卡片發佈到畫布上，畫布支持圖片拖拽或粘貼。
多人協作需啓動 relay/server.mjs（零依賴 WebSocket 中繼）。通過“複製分享串”發送房間快照，使用“協作 → 加入”加入。衝突解決策略爲“最後寫入者勝出”。
對話生成卡片與內嵌應用¶
- 對話生成：在對話中使用
[taskcard]...[/taskcard]語法，AI 可根據內容自由創建卡片，支持文本、表格、圖表、按鈕等多種控件。 - 內嵌網頁應用：卡片可託管其他 Web 應用。通過
embed控件或編輯器的“內嵌網頁應用”區域設置。僅支持絕對路徑的http或httpsURL，不支持javascript、data:、file:或blob:協議。
安裝與啓用¶
目前資料中未明確給出官方安裝命令。建議直接訪問 GitHub 倉庫查看安裝說明。
典型用法¶
- 切換視圖：點擊右下角玻璃按鈕切換至任務臺，或使用
⇄ 任務臺/Esc返回。 - 調整卡片：按住卡片頂部欄拖拽移動，按住右下角拖拽調整大小。
- 生成卡片：在對話中輸入包含
[taskcard]的內容，助手將自動在任務板上生成對應卡片。 - 加載外部應用：在卡片編輯器中配置
embed控件，輸入http://localhost:5173等地址，拖拽卡片底部邊緣調整 iframe 高度。
注意事項¶
- 動畫偏好：插件會尊重系統的
prefers-reduced-motion設置。 - iframe 限制：內嵌網頁應用僅支持
http和https協議。 - 協作環境：多人協作功能需要單獨啓動
relay/server.mjs服務。 - 權限範圍：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
結尾¶
dsh-task-console 將任務管理從分散的界面中提取出來，通過懸浮卡片和實時數據流，爲長對話和複雜任務提供了一種直觀的管理方式。更多細節和更新請查閱項目目錄或 GitHub 倉庫。
