前言¶
DeepSeek Harness(DSH)采用插件化架构。在调试智能体或构建复杂工作流时,提示词的复用往往依赖手动复制粘贴,不仅效率低下,也不利于维护。dsh-prompt-library 插件旨在解决这一问题,它将可复用提示词集中管理,提供保存、搜索和编辑的能力。
插件定位¶
该插件由 ManoloRemiddi 维护,属于记忆类插件。它允许在 DSH 的设置界面中保存、搜索、预览、编辑和删除提示词。提示词文本以纯文本形式渲染,保存时不会调用模型或发送聊天消息。该插件可以独立运行,也可以连接现有的 Augmentor 服务。
核心功能¶
- 界面管理:在 DSH 的
Settings → Prompt library中进行增删改查。 - 独立存储:使用本地 SQLite 数据库存储提示词。
- 服务集成:连接现有的 Augmentor 提示词服务。
- 并发处理:通过版本(revision)机制处理并发保存冲突。
安装与启用¶
该插件以 .tgz 压缩包形式分发。
-
下载安装包
从 v0.2.1 的发布页面下载.tgz资产。 -
执行安装
使用 DSH 的插件管理命令安装。假设使用webprofile:
dsh plugin --profile web add https://github.com/ManoloRemiddi/dsh-prompt-library/releases/download/v0.2.1/dsh-prompt-library-0.2.1.tgz
- 完成配置
安装需要 Linux 环境、Node.js 22.19+ 以及一个可用的 DSH web profile。独立模式还需要 Python 3(标准 Python 构建通常已包含 SQLite 支持)。
安装完成后,重启 DSH 进程并刷新页面,进入Settings → Prompt library即可开始使用。
使用方式¶
安装后,可以通过以下步骤使用提示词库。
创建与保存¶
在设置页面点击 New prompt,输入快捷方式名称和提示词文本,点击 Save prompt。
存储模式¶
插件提供两种存储模式:
* 独立模式(默认):数据存储在 $XDG_DATA_HOME/dsh-prompt-library/prompts.sqlite3。可以通过环境变量 DSH_PROMPT_LIBRARY_DATA 指定不同目录,通过 AUGMENTOR_PYTHON 指定 Python 解释器。
* Augmentor 服务模式:将环境变量 DSH_PROMPT_LIBRARY_SOCKET 指向现有的 Augmentor Unix socket,例如 $HOME/.local/state/augmentor/prompts.sock。插件会连接该服务,无需启动 Python 进程。
插入提示词¶
在聊天编辑器中插入提示词需要兼容的 Augmentor 接口(如斜杠菜单)。[clipboard] 标记会被原样存储,具体展开由消费应用处理。
注意事项¶
- 数据迁移:版本 0.2.1 不会自动迁移 0.1.0 或 0.2.0 的数据。新安装的独立模式会从空数据库开始,旧的数据库保持不变。若要保留数据,需手动复制或配置 Augmentor 服务模式。
- 并发冲突:处理并发保存时,如果发生冲突,过时的草稿稿仍会可见。遇到冲突时,建议将内容复制到安全位置,刷新并重新选择当前提示词后再应用更改。插件不会自动重试写入。
- 存储限制:独立模式存在硬性限制:最多 1,000 条提示词,总内容大小不超过 500,000 字节。快捷方式名称仅支持 1-128 个字母、数字、连字符或下划线。
- 卸载清理:执行
dsh plugin --profile web remove dsh-prompt-library仅卸载插件界面。已保存的数据库文件和 Augmentor 服务保持不变,需手动删除。 - 版本兼容性:插件在 DSH 0.1.5-rc.1 上验证过,其他版本可能会改变 web/UI 界面。
结语¶
dsh-prompt-library 为 DSH 提供了一个轻量级的本地提示词管理方案,适合需要在本地管理大量 Prompt 的工作流。更多详情或反馈,请访问其 GitHub 仓库 或 技能中心插件目录。