前言¶
在 DSH 裏做多工作區、多會話協作時，常見做法是手動複製聊天記錄、在筆記裏記「下一步」，或靠記憶回到某個會話繼續。會話本身不會被整理成可檢索的結構，跨工作區交接時也容易漏段、超長上下文又不好直接貼進新會話。DSH Task Shelf 1（社區試用版）把「資料夾、會話引用、下一步便籤」和「交接包生成與壓縮」放在同一套界面裏，原會話不移動、不修改，適合需要暫停後再續、或要把多段討論合成一份草稿的場景。
下面介紹插件定位、已實現能力、安裝方式、典型用法與使用邊界。
這是什麼¶
DSH Task Shelf 1 · 任務資料夾 由社區維護者 xin505 發佈，包版本 1.0.1，目標宿主爲 DSH 0.2.1-rc.3（package.json 中 engines.dsh 與 peer 依賴均指向該版本）。在 SkillHub 等社區目錄中分類爲「記憶」；GitHub 倉庫：https://github.com/xin505/dsh-task-shelf。
一句話定位：把相關會話和下一步放在一個資料夾裏，下次回來繼續工作；並在交接區域按「工作區 → 會話」選擇多個來源，合成交接包並按需壓縮，再帶入目標工作區的新會話草稿（不自動發送）。
獨立社區項目，與 DeepSeek 官方無隸屬關係；採用 MIT 許可證。
核心功能¶
以下均來自倉庫 README 的「已實現」說明，未列入項（如文件引用、消息收藏、整份資料夾 Markdown 導出、跨機器映射）當前包未實現。
資料夾與會話管理¶
- 按工作區新建、改名、搜索資料夾，編輯下一步便籤。
- 從不同工作區關聯會話、設置主會話、打開會話和繼續任務；原會話不移動。
- 每窗口獨立的當前任務標記；回收區、恢復和永久刪除。
- JSON 備份導出、預覽後新增導入；同一備份阻止重複導入。
- 保存衝突保留草稿；結果不明時可查詢，原操作重試去重。
啓動自檢與診斷¶
每次插件加載自動檢查數據格式、上一代備份和目錄臨時文件讀寫；界面顯示啓動自檢結果，可導出不含內容的診斷報告。
跨工作區、跨會話交接¶
在交接區域直接展開工作區，合選 1–5 段會話，不必先關聯到資料夾。兩份材料均標明來源，支持分別編輯、複製下載和目標工作區草稿。
- 單段超過 12,000 字符時，按所選方式自動壓縮。
- 整包超過 30,000 字符時停下，列出各段大小，由用戶選擇壓縮哪一段。
- AI 摘要與本地精簡可自由選擇；界面說明優劣。本地精簡保留開頭與結尾；AI 摘要使用 DSH 默認模型。默認本地精簡不調用模型；用戶選用 AI 摘要並點擊生成或壓縮時會調用 DSH 默認模型，可能產生費用。壓縮失敗保留原內容，不靜默換用其他方式。
- 帶入新會話仍只准備草稿，不自動發送。
雙版本與查看方式¶
默認左側原始記錄、右側易讀版；右上角可切換原始記錄、易讀版或並排查看。兩份分別編輯且不會互相覆蓋；輸出版本默認易讀版。未經壓縮的來源展示原文；壓縮後的來源明確標註爲 AI 摘要或本地精簡。
本地數據與限額¶
數據保存在 $DSH_HOME/task-shelf/state.json；未設置 DSH_HOME 時爲 ~/.dsh/task-shelf/state.json。每次替換前保留上一代 state.json.previous。停用、卸載沒有刪除數據的邏輯。
試用限額（README 原文）：100 個資料夾（含回收區）、每個 50 個會話引用、便籤 4096 字節、資料夾數據 2 MiB；加操作回執後狀態文件最多 4 MiB。備份包含便籤、會話標題和標識，請按個人資料保管。
交接選擇和壓縮結果不寫入任務狀態。範圍限同一 DSH 環境，不支持跨機器或獨立 profile 自動同步。
安裝與啓用¶
安裝步驟以 README 與試用說明爲準，不是 dsh plugin add github:... 一類命令。
- 在 GitHub 倉庫 Releases 下載
dsh-task-shelf-1.0.1.zip（勿選源碼 ZIP）。 - 解壓到長期保留的位置，使用直接包含
package.json的目錄。 - 在 DSH 中：插件 → 添加插件 → 安裝第三方插件 → 填入上述本地包目錄。
- 安裝後不要刪除該目錄。另提供
.tgz和 SHA-256 校驗文件；未發佈 npm 包。
詳細試用步驟見倉庫內 docs/TRY-IT.md。更新前請導出備份；需要回退時請按試用說明保留升級前完整狀態文件。
典型用法¶
README 給出的跨區示例可復現如下。
- 打開任意資料夾，在下方交接區域展開工作區 A、B，分別勾選討論後生成一個包。
- 若合計超過 30,000 字符限制，按界面提示選擇壓縮 B 的某段討論。
- 將交接目標設爲工作區 C，點擊「帶入新會話草稿」，檢查後再發送。
- 若 C 已有空白會話，DSH 會複用並追加草稿。
- 交接選擇不會自動新增資料夾關聯。
資料夾日常用法：關聯會話、寫下一步便籤、標記當前任務；需要換機器或留檔時用 JSON 備份導出，在新環境預覽後導入（同一備份不會重複導入）。
適用場景與注意¶
適合誰： 在同一 DSH 環境內管理多個工作區任務、需要把多段會話合成交接包並控制長度、希望原會話保持不動只通過引用和草稿續作的使用者。
環境與驗證邊界： README 寫明已在隔離 Web 運行時與 Edge 中驗證界面和本地精簡；AI 適配使用模擬流測試，未驗證真實模型質量、費用和日常桌面插件組合。插件以當前 DSH 進程權限運行，安裝前應閱讀源碼與 MIT 許可證，並知悉備份可能含會話標題與標識。
未實現與承諾範圍： 文件引用、消息收藏、整份資料夾 Markdown 導出、跨機器映射尚未實現（交接包可以下載）。歷史設計 v0.2 中的完整功能和容量目標不是當前包的承諾。
持久性： 原子寫入和文件鎖複用官方工具；壞文件不會被自動清空；官方寫入工具沒有 fsync，本版不提供斷電持久性保證。
結尾¶
DSH Task Shelf 1 把任務資料夾、跨區會話引用和交接包壓縮收進一個社區試用插件，強調原會話不動、草稿不自動發送，以及本地精簡與可選 AI 摘要的分工。若要試用或查版本信息，可看社區目錄頁 https://www.skillhub.cn/plugins/xin505/dsh-task-shelf 與 GitHub 倉庫 https://github.com/xin505/dsh-task-shelf。
