前言¶
DSH 的插件機制是「一切皆插件」，功能靠掛在宿主上的插件提供。但單插件裝得多了，管理就成了實際問題：每個模塊自己管更新，配置和數據放在不同位置，裝新功能還要翻一遍源碼。
sakayorilove/laurel 是一套給 DeepSeek Harness 的套件，包含一個控制中心和六個可單獨開關的模塊。它的思路是先裝一個控制中心，剩下的功能在控制中心裏按需下載、獨立啓用、獨立更新，配置與數據保留。下面按 README 裏寫明的內容介紹。
這是什麼¶
Laurel 套件，維護者 Sakayorilove，倉庫在 GitHub 上叫 Sakayorilove/dsh-Laurel。定位是「給 DeepSeek Harness 的控制中心與模塊商店」，核心能力是模塊的獨立安裝、啓用、更新、回退與卸載，並保留既有配置和數據。
按社區目錄的分類，它歸在「工作流」下。代碼採用 MIT 許可。
核心功能¶
控制中心本身不提供業務功能，作用是三件事：提供「模塊商店與更新」界面、統一外觀與聲音設置、在運行時掛載已啓用的模塊。模塊有六個，出廠全部關閉：
- Laurel 通知：不在窗口前時，提問、審批、完成各推一條系統通知。
- 記憶核心：跨會話記住事實、要求與經驗；零推理也能記錄、檢索、糾正、搬家。
- 上下文壓縮：長對話瘦身，把大結果外置成引用、按需回讀原文、做分級摘要。
- 自動繼續：超時或網絡報錯中斷後自動續跑，可限定生效時段；有推薦項時替你選。
- 內耗護欄：給子代理等待套上限、結論趕去寫文件、按文件計返工、共享目錄加鎖。
- 思考滾動窗：把「思考」收成限高滾動窗，加漸變淡出、流式貼底、結束收起。
共用的存儲、鎖與賬本由 laurel-core 提供，作爲隱藏公共庫隨需要它的模塊自動下載，不單獨開關。
更新機制上，控制中心和模塊分別檢測更新：啓動後檢查一次，此後每六小時檢查，也可手動檢查。發現更新時顯示常駐提示，點擊進入「模塊商店與更新」。控制中心更新成功後需要完全退出並重新打開 DSH。
安裝與啓用¶
裝之前先看環境前提：Node.js ^22.19.0 || >=24.0.0；當前版本聲明兼容 Harness 0.2.1-rc.5 / 0.2.2-rc.1，其他版本需先驗證。
方式一：客戶端原生插件頁（推薦）
安裝包是 tgz，可以從 Release 獲取，也可以自己構建：
npx --yes pnpm@11.28.3 install --frozen-lockfile --ignore-scripts
npx --yes pnpm@11.28.3 run build:client
npx --yes pnpm@11.28.3 pack # 得到 laurel-center-1.9.2.tgz
然後在 Harness 裏走「插件 → 添加插件 → 安裝第三方插件」，選中這個 tgz。裝完完全退出（含托盤）再打開。
方式二：命令行裝進 profile
cd ~/.dsh/profiles/desktop # Windows: %USERPROFILE%\.dsh\profiles\desktop
pnpm add "file:/絕對路徑/laurel-center-1.9.2.tgz"
同樣要完全退出再打開。注意不要用比客戶端更新的 pnpm 大版本，否則可能重寫整個 profile 的 lockfile。
安裝完成後，在控制中心的「模塊商店與更新」裏查看每個模塊的已裝版本和適配版本，再逐個安裝、啓用、更新、回退或卸載。
典型用法¶
日常使用的順序是：先完成上面的安裝，打開控制中心，在模塊商店裏勾選需要的模塊。模塊首次下載默認關閉，用戶啓用後等待宿主與客戶端 Fiber激活。
下載和更新的規則：
- 正在執行任務時拒絕代碼變更，等任務結束再操作；
- 下載失敗或校驗失敗保留原版本；
- 斷網時已安裝模塊仍可使用，新增安裝與更新需重新檢查成功；
- 卸載只移除安裝登記和開關，保留用戶數據及代碼緩存，重新安裝後可再次啓用。
模塊開關的狀態寫在安裝目錄下：下載代碼、安裝記錄和新模塊開關位於當前 <profile>/.laurel-modules/；用戶數據在 $DSH_HOME 下各自的目錄裏，默認是 ~/.dsh 下的 laurel/、laurel-continue/、warden/、laurel-reasoning-scroll/、laurel-center/，記憶與上下文的庫在 laurel-core/。卸載會保留這些目錄，所以「先卸後裝」不會丟配置。
適用場景與注意¶
適合已經在 DSH 裏裝了多個插件、希望把功能按模塊管理和控制的人，尤其是在長對話、跨會話記憶、子代理併發這些場景下需要更細粒度控制的人。六個模塊都出廠關閉，可以只挑需要的裝。
安全和權限方面需要留意幾點：
- 插件以當前 dsh 進程權限運行，裝之前應先讀源碼和許可證，確認它對文件系統、網絡和子代理的訪問符合預期。
- 可選模型功能可能通過宿主把相關正文交給所選 provider，細節見倉庫的 SECURITY.md。
- 控制中心只從 Laurel 官方目錄與固定 GitHub Release 包取模塊，當前不支持第三方商店源。
- 外觀素材不隨代碼包分發，需要本機放一份 manifest 和文件；沒有素材目錄時會回退到純色主題和程序粒子，功能不受影響。
- 外觀資源接口只允許白名單內、hash 匹配的 GET/HEAD，不提供任意文件訪問；不要把會話、賬號信息、密鑰或原始對話截圖放進素材目錄。
結尾¶
Laurel 的價值在於把「裝插件」變成「裝控制中心 + 按需下模塊」，更新、回退、卸載都有清晰入口，數據也留在本機。它現在是 1.9.2 預發佈版本，兼容 Harness 0.2.1-rc.5 / 0.2.2-rc.1，其他版本需先驗證。
目錄頁：https://www.skillhub.cn/plugins/Sakayorilove/laurel
倉庫：https://github.com/Sakayorilove/dsh-Laurel
