前言¶
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 工具以便于操作。
