在 DeepSeek Harness (DSH) 的使用場景中，頻繁使用的命令、代碼片段或提示詞往往需要手動複製粘貼，缺乏一個輕量級的持久化存儲方案。dsh-snippets 旨在解決這個問題，它是一個極簡的“收藏夾”工具箱，將常用片段保存在本地文件中，供 AI 在會話中按需檢索。
核心定位¶
該插件由 taxueseek 維護，屬於記憶類插件。它不依賴任何數據庫、向量庫或 UI 面板，僅通過 JSONL 文件存儲數據。它的核心邏輯是“顯式記憶”：AI 不會自動記錄對話內容，只有用戶明確調用工具時纔會進行讀寫操作。
核心功能¶
插件提供 5 個語義明確的工具，功能一目瞭然：
- snippet_save：保存或覆蓋一條片段。如果名稱已存在，會更新內容並更新時間戳。
- snippet_search：按子串搜索，匹配範圍包括片段名稱、正文內容以及標籤，不區分大小寫。
- snippet_get：按確切名稱取回一條片段。
- snippet_delete：刪除指定的片段。
- snippet_count：統計當前存儲的總條數。
安裝¶
在命令行中執行以下命令安裝：
dsh plugin --profile web add "github:taxueseek/dsh-snippets#main&path:."
安裝完成後，需要重啓 DSH Web 服務以加載插件。
典型用法¶
在 DSH 的對話或工具調用中，可以使用如下語法：
保存片段：
snippet_save(name: "docker-logs", text: "docker logs -f --tail 100 myapp", tags: ["ops"])
搜索片段：
snippet_search(query: "logs")
取回片段：
snippet_get(name: "docker-logs")
數據與規則¶
- 存儲路徑：
~/.dsh/snippets/snippets.l - 存儲格式：JSONL（每行一個 JSON 對象），包含
name、text、tags、updatedAt字段。文件支持人類閱讀和手工編輯。 - 命名與長度限制：片段名限制爲
[A-Za-z0-9._-]{1,80}，單條內容上限爲 2 萬字符。 - 容錯性：如果 JSONL 文件中存在格式損壞的行，解析器會自動跳過，不影響其他數據的讀取。
適用場景與注意¶
- 適用人羣：需要高頻複用特定命令、代碼片段或提示詞的開發者與運維人員。
- 運行特性：插件完全本地運行，零 UI、零網絡、零數據庫依賴（僅依賴 Harness SDK）。
- 注意：請確保安裝前已閱讀源碼並確認許可證（MIT）符合要求。
