前言¶
DeepSeek Harness (DSH) 的插件體系允許開發者擴展其環境的功能。在智能體開發或工作流配置中，開發者經常需要持久化保存網頁鏈接。現有的瀏覽器書籤往往分散且難以直接在本地文件系統中以結構化方式訪問。直接操作本地文件雖然可行，但缺乏現成的 UI 界面。dsh-link-collect 插件旨在解決這一痛點，它提供了一個本地 Markdown 收藏夾方案，並配備了 Web 界面和 Agent 工具。
是什麼¶
dsh-link-collect 是一個 DeepSeek Harness 插件，旨在將收藏的鏈接（包含標題、簡介、圖標、標籤和正文）持久化爲本地 Markdown 文件。它通過 Web UI 側欄頁面和 Agent 工具提供管理功能。該插件由 suomir1995 維護，採用 MIT 許可證。
核心功能¶
- 本地 Markdown 持久化：所有數據存儲在本地文件夾中，每個集合對應一個 Markdown 文件。
- Web UI 頁面 + host 服務：提供側欄入口和 Web 界面，用於管理收藏。
- Collection 與 Link 管理：支持創建、重命名、刪除收藏夾（集合）和具體鏈接。
- 圖標自動獲取：自動下載並保存網站圖標到本地
icons/目錄。 - 搜索與過濾：支持當前集合內的關鍵詞過濾以及全庫搜索。
- 庫目錄即時切換：可在頁面內切換本地庫目錄，無需重啓。
- Agent 工具：註冊了
link_collect_search、link_collect_add和link_collect_list三個工具。 - Markdown 解析容錯：支持手寫 Markdown 文件作爲收藏夾，容錯解析。
安裝與啓用¶
安裝該插件需要將插件目錄作爲 bundle 添加到 Web 配置文件中。
- 安裝插件：
dsh plugin --profile web add ./dsh-link-collect
- 啓動 Web 配置文件（安裝後必須重啓）：
pnpm dsh web
- 啓動後，左側側欄會出現「鏈接收藏」入口。
典型用法¶
- Web UI 操作：在側欄點擊「鏈接收藏」，進入管理頁面，可創建集合、添加鏈接、編輯標籤或切換庫目錄。
- Agent 工具調用：在 DSH 交互中，可以使用工具
link_collect_add添加鏈接，或使用link_collect_search搜索已有鏈接。
適用場景與注意¶
- 適用場景：需要在本機持久化存儲鏈接、希望利用 Markdown 管理收藏內容、或需要在智能體工作流中直接操作鏈接數據的開發者。
- 注意事項：
- 該插件的客戶端部分需要構建，主機端爲純 ESM。
- React 通過 shell 模塊表解析，不打包。
- 瀏覽器通過 guarded routes 訪問數據，不直接接觸磁盤。
- 安裝前請檢查源碼與許可證（MIT）。
結尾¶
dsh-link-collect 爲 DSH 環境提供了一個輕量級、本地化的鏈接管理方案。它將數據直接落盤爲 Markdown 文件，便於版本控制和手動編輯，同時提供了 Web 界面和 Agent 工具以便於操作。
