前言¶
用 DeepSeek Harness（DSH）跑任務時，產出往往落在會話工作目錄裏：一段 Markdown、一個 out/ 目錄、或某次定時任務生成的 HTML。對話一關，這些路徑還在磁盤上，但和「是哪次會話、哪條任務寫的」之間的關聯要靠你自己記。常見做法是複製到筆記軟件或自建目錄，路徑引用和標籤各管各的，想回到當時的工作區側邊欄再對照上下文，通常要手動找會話。
下面介紹社區插件 dsh-material-library（維護者 yingqi-studio，DSH 目錄分類爲「記憶」）。它在 DSH Web 側欄提供材料庫界面：從對話裏採集文件夾或文件（不復制，只登記引用）、在磁盤上用真實目錄樹和 .md 筆記組織內容，並用標籤索引；對已採集條目可一鍵切回原始會話並在右側打開對應目錄。
這是什麼¶
dsh-material-library 是面向 DeepSeek Harness 的材料庫插件：收集一次對話產生的文件夾、文件或筆記，用真實文件夾和標籤保存，並支持一鍵重新打開來源會話。
插件以 npm 包 dsh-material-library 發佈（當前資料中版本 1.4.4，許可證 MIT）。要求宿主具備側欄入口與右側邊欄等插槽（dsh.web 0.2.x 一類環境），engines.dsh 聲明爲 >=0.2.0。
核心功能¶
從對話採集，磁盤上仍是真文件¶
會話標題欄和材料庫內的「從對話採集 / Collect from chat」會打開選擇器：選會話、瀏覽其工作目錄，再選文件夾或文件，填寫名稱、庫內文件夾和標籤。條目指向原始路徑，不會複製文件。
庫根目錄默認爲 ~/.dsh/materials（可通過插件配置項 root 改路徑）。筆記是磁盤上的 .md；文件夾樹就是庫根下的目錄樹；標籤寫在庫根旁的 .index.json。你可以在 DSH 外直接用編輯器改這些文件。
三欄瀏覽與系統打開方式¶
界面類似 Finder：來源列表（全部材料 / 文件夾 / 標籤）、列表視圖（名稱、更新時間、文件夾、標籤）、詳情 pane（文件卡片、默認應用按鈕、「打開方式…」菜單）。在 macOS 上通過 open 用默認或指定應用打開，或在 Finder 中顯示；圖片可在詳情裏預覽，文本與 Markdown 在 pane 內渲染。
Markdown 渲染風格與會話消息一致（標題、列表、引用、代碼塊、表格等），對外部路徑的引用條目同樣適用。
回到來源會話¶
對已採集條目，Open in original session 會切換到該對話，並在會話右側邊欄打開對應文件夾。
編輯、搜索與版本¶
側欄可重命名或刪除文件夾、標籤（標籤重命名會全局替換；文件夾重命名會移動其下文件）。任意條目可改名稱、文件夾、標籤；支持按名稱、正文、標籤搜索。
筆記每次保存會把上一版正文存到 .history/（每個文件最多 30 版）。詳情頭裏的 Versions 可查看並恢復；恢復前會先快照當前正文，因此恢復本身可再撤銷。引用條目與純文件夾條目沒有版本歷史。
收進庫與導入¶
採集條目可通過「收進庫 / Copy into library」複製爲庫內真實文件，原路徑不動。HTTP 接口 /import 可將用戶主目錄內的文件或目錄複製進庫（單次最多 2000 個文件），命名規則與庫內其它寫入一致、避免衝突。
Agent 工具與自動歸檔¶
宿主在每個會話註冊工具 materials_archive，供智能體或定時任務把產出登記進庫，例如：
materials_archive(path="out/", folder="日報/2026-11", tags=["日報"], include=".html,.md")
參數含義（摘自 README）：path 爲文件或目錄（支持 ~，相對路徑相對會話工作目錄；省略則指工作目錄）；folder 爲庫內文件夾；tags 與已有標籤合併；depth 控制歸檔深度；include 爲後綴或 glob 過濾；limit 默認 50、最大 200。同一路徑重複登記會刷新標籤與文件夾，不會 duplicate 條目，文件本身仍不移動、不復制。
首次人工歸檔某類產出後，庫會記住規則（.rules.json）：在定時任務會話結束時會自動再次歸檔同路徑下的新文件；普通聊天回合結束不會觸發。定時任務提示詞末尾可加一句，例如：跑完把 out/ 收進材料庫，folder 用「日報/當月」，tags 用 ["日報"]。
UI 通過同源 JSON 路由 /api/dsh-materials 與宿主通信（README 中有完整路由表）；變更經串行存儲寫入，衝突返回可讀的 4xx 錯誤。寫入路徑限制在庫根內，採集目標須在用戶主目錄內。
安裝與啓用¶
在終端爲指定 profile 安裝（命令來自官方 README）：
dsh plugin --profile <your-profile> add dsh-material-library
也可從 GitHub 安裝：
dsh plugin --profile <your-profile> add github:yingqi-studio/dsh-material-library
在 DSH Desktop 中打開 Plugins，搜索插件名安裝亦可。安裝後重啓 dsh web 或刷新頁面，側欄會出現材料庫圖標。
如需更換庫位置，在插件配置中設置 root。
典型用法¶
1. 手動從某次對話收一個交付目錄
打開材料庫 →「從對話採集」→ 選會話 → 在工作目錄裏選中文件夾或文件 → 命名並選庫內文件夾、標籤 → 保存。之後在列表裏點 Open in original session 即可回到該會話上下文。
2. 定時任務結束時讓 Agent 登記產出
在任務說明末尾要求調用 materials_archive，或首次在對話裏手動歸檔一次以建立自動規則；後續同路徑新文件在定時任務跑完時可按規則進入庫內對應文件夾與標籤。
3. 把外部樹複製進庫
通過 UI 或 /import 將主目錄下的目錄複製進 ~/.dsh/materials（或你配置的 root），再在庫內用標籤和文件夾繼續整理。
適用場景與注意¶
適合需要把 DSH 會話產出（腳本輸出目錄、說明文檔、任務報表等）和「來源會話」綁在一起、又希望數據落在普通文件夾、便於 Git 或編輯器協作的開發者。
插件邏輯以當前 DSH 進程權限讀寫磁盤與調用系統打開命令；安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證。DSH 社區插件目錄站點與 DeepSeek / 幻方無官方從屬關係，本文介紹的是社區維護的獨立插件。
「打開方式…」等行爲在 README 中按 macOS open 描述；其它操作系統上具體表現取決於宿主與插件實現，以你本地環境爲準。
結尾¶
dsh-material-library 把「對話裏產生的路徑」變成帶標籤、可搜索、可版本管理的庫內索引，並在需要時一鍵回到原始會話與工作區目錄，適合作爲 DSH 工作流裏的長期材料層。
