前言¶
在 DeepSeek Harness（DSH）裏寫提示詞或草稿時，若材料說明散在磁盤上的多篇 markdown 筆記裏，常見做法是每開一個新會話就讓模型去「找文件、讀幾篇、自己歸納賣點」。同一件事反覆做，歸納結果往往沒有出處，筆記裏空的「待補充」段落還會被一併塞進上下文。
dsh-material-cards（材料卡）針對的是另一類需求：把整個庫預先壓成一張約 1400 字符以內的卡片——標題、一句話定義、標籤、三個最有用的分節，加一行相對出處——從輸入框旁一鍵搜、選、插入，而不是在對話裏當文件瀏覽器用。
這是什麼¶
維護者 accoutmissing 在 GitHub 開源的 DSH 插件（@local/dsh-material-cards，當前包版本 0.3.0，MIT）。社區目錄 SkillHub 將其歸類爲「記憶」。
插件在輸入區工具欄增加「材料卡」入口：從你配置的本地 markdown 材料庫檢索，把服務端渲染好的成品卡文本追加到當前草稿末尾。庫路徑不在插件包內，需自行配置；任何按「一篇筆記講一種材料」組織的目錄都適用。
核心功能¶
界面與操作¶
- 輸入區工具欄左側出現材料卡圖標；點開光標進入搜索框。
- 輸入即過濾（180ms 防抖，走宿主檢索，非前端本地過濾）。
↑/↓選擇，Home/End跳首尾，Enter插入；Esc兩級——先清空搜索，再按一次關閉面板。- 卡片追加到草稿末尾（空草稿直接寫入）；已有內容時中間空一行，插入爲一次可撤銷編輯，不覆蓋已有文字。
搜索框爲空時展示三個「架子」：置頂（行尾圖釘）、最近（最多 8 條，插入時自動記錄）、全部（其餘按最近改動）。僅一個架子有內容時不顯示架子標題；開始搜索後合併爲平鋪結果。搜索框右側有清空、命中計數、行距（寬鬆/緊湊）；置頂、最近、行距僅存本機 localStorage。
卡片內容與筆記格式¶
插入文本包含【材料】標題、一句話描述、標籤行、三個二級標題分節（由插件按用途打分選取，非固定白名單標題名），以及相對出處（默認不給絕對路徑，避免模型再去讀盤）。示例結構見倉庫 README。
筆記需 frontmatter + ## 分節；title、description、tags、confidence 等可缺省，缺省時從第一個 # 標題或文件名、首段正文推導。行內左側的 medium / low 來自 frontmatter 的 confidence。
可選：規則注入提示詞¶
同一配置文件可指定 rules（相對 root 或絕對路徑的文件，或無路徑時當作內聯正文）、rulesSections、rulesMax（默認 6000，範圍 500–12000）。內容註冊爲系統提示詞段，前綴說明「只在相關內容上生效」。GET /plugins/material-cards/rules 可查看當前正文、來源與是否已註冊。
服務端行爲（只讀）¶
- 不寫回筆記；不做向量檢索；未配置庫時不掃全盤。
- 檢索：標題 8、description 4、標籤 4、slug 3、正文 2 加權；全庫內存掃描，5 秒緩存。
- 三個 loopback
GET接口：/plugins/material-cards/search（q≤64 字，limit默認 8、上限 35）、/plugins/material-cards/card（slug，返回prompt即插入文本）、/plugins/material-cards/rules。
安裝與啓用¶
安裝命令以倉庫 README 爲準：
plugin_manager action: install_bundle
target: <絕對路徑>\dsh-material-cards
裝完後關閉再打開插件（set_plugin，enabled: false → true）以加載新代碼，Ctrl+R 刷新頁面，再通過本機配置指向筆記目錄。
插件以當前 DSH 進程權限讀取你配置的目錄；安裝前請自行查看 源碼 與 MIT 許可證，確認路徑與只讀行爲符合你的環境。
配置庫位置¶
優先級從高到低：
| 順序 | 來源 | 說明 |
|---|---|---|
| 1 | 插件 config 的 root / dir |
bundle patch 內，隨 profile |
| 2 | 環境變量 DSH_MATERIAL_CARDS_ROOT |
只覆蓋 root |
| 3 | ~/.dsh/material-cards.json |
本機文件，不進倉庫 |
| 4 | 兜底 ~/materials |
dir 爲空時用 root 本身 |
本機文件示例：
{
"root": "D:\\notes",
"dir": "materials",
"fullPath": false
}
dir 不存在或目錄下無 .md 時檢索爲空，面板提示「材料庫裏還沒有筆記」。需要出處爲絕對路徑時，將 fullPath 設爲 true。
典型用法¶
- 在
~/.dsh/material-cards.json寫好root（及可選dir）。 - 按 README 的 frontmatter 與
## 定義、## 核心特性等結構維護材料筆記。 - 在 DSH 輸入框點材料卡，輸入材料名過濾，
Enter將卡片插入當前草稿，與模型對話時上下文裏已帶定義、要點與出處。
適用場景與邊界¶
適合：已有本地 markdown 材料庫、希望在 composer 裏快速引用結構化摘要且保留出處、筆記量在幾百文件量級、不需要向量檢索的場景。
不適合或需知悉：插件不替你在合規或宣傳層面判斷「能不能這麼寫」；卡片裏的置信度與出處供你對照筆記自行決定。它不猜庫路徑、不修改筆記、不承擔索引與筆記同步的向量方案。
鏈接¶
- 社區目錄：https://www.skillhub.cn/plugins/accoutmissing/dsh-material-cards
- 源碼與完整說明：https://github.com/accoutmissing/dsh-material-cards
DSH 生態強調「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
