前言¶
DeepSeek Harness（DSH）的插件化架构允许通过扩展来增强核心功能。当本地积累了大量智能体预设时，直接在 DSH 界面中查找和管理会变得低效。dsh-preset-library 旨在解决这一问题，它提供了一套元数据管理方案，允许在不修改预设本体代码的情况下，通过标签、分组和状态筛选来组织预设集合。
插件简介¶
dsh-preset-library 是一个开源的社区插件，由开发者 LiweiDonVee 维护，采用 MIT 许可证。它提供了一种紧凑、可搜索且基于标签的预设管理方式，支持网格、列表和分组视图，并允许对预设元数据进行批量操作。
核心功能¶
插件主要提供以下能力：
- 视图与筛选：支持紧凑的网格、列表和分组视图，并提供状态筛选功能。
- 批量操作：支持对预设进行批量打标签。
- 层级关系：支持一级的父子预设关联。
- 元数据管理：元数据版本化、原子化保存，并内置修订冲突检查。
- 多语言支持：界面支持英文和中文。
安装与启用¶
安装前需确保环境满足以下要求：Node.js 24、npm 以及一个可用的 DSH 0.1.7-rc.2 Web profile。
- 克隆仓库：
git clone https://github.com/LiweiDonVee/dsh-preset-library.git
cd dsh-preset-library
- 安装依赖并检查：
npm ci
npm run check
- 添加插件：
npx --yes @deepseek-ai/dsh@0.1.7-rc.2 plugin --profile web add .
- 启动 Web Profile：
npx --yes @deepseek-ai/dsh@0.1.7-rc.2 web
安装完成后，重启 DSH，登录后在设置菜单中打开 Preset Library。
文件位置与使用¶
插件的元数据文件位于默认的 $DSH_HOME/preset-library.json（即 ~/.dsh/preset-library.json）。
- 文件管理：如果包管理器将其作为本地链接安装，请保持该仓库克隆原位。
- 备份：在进行批量更改前，建议先备份此 JSON 文件。
局限性与注意事项¶
- 预设声明只读：在该插件中，预设的声明被视为只读。
- API 限制：元数据 API 仅接受回环请求（loopback），即使主机本身被远程暴露。
- 关系层级：目前仅支持一级的父子关系。
- 依赖契约：这是一个预览插件，依赖于 DSH 正在演进的 Remote/slot 契约。
- 卸载残留：卸载插件不会自动删除已保存的标签元数据。
- 社区性质：这是原始的社区实现，与 DeepSeek AI 无官方隶属关系。
总结¶
dsh-preset-library 为 DeepSeek Harness 用户提供了一个管理预设元数据的实用工具。通过版本控制和冲突检查机制，它有助于维护预设库的整洁与一致性。对于需要管理大量预设的用户，这是一个值得尝试的辅助插件。
更多详情与源码请访问：GitHub 仓库
