前言¶
在 DSH Web GUI 里写提示词，常见做法是复制粘贴外部文档，或在编辑器里翻历史记录。条目一多，分类、搜索和「插入时还要改占位符」都会拖慢节奏。把模板放在云端又涉及隐私与离线可用性。
下面介绍维护者 JianhangLy 的客户端插件 dsh-prompt-library（社区目录分类：客户端）：把常用提示词存成本机一个 JSON 文件，在对话输入框旁用按钮或快捷键打开取用浮层，支持分组、分词搜索、{{变量}} 填值后再写入草稿，并自带 13 套内置模板。数据不联网、不上传。
这是什么¶
dsh-prompt-library 是 DSH 的「提示词库」插件：宿主侧提供回环 HTTP 读写与落盘，客户端在 composer 输入区注册 ▤ 按钮、取用浮层和设置页。解决的是「反复写同类提示、又要本地可控」的问题，与单纯依赖剪贴板或外部笔记相比，插入、追加、置顶和整库导入导出都在同一界面完成。
- 仓库：JianhangLy/dsh-prompt-library
- 社区目录：SkillHub 插件页
- 当前 package 版本：0.3.0，许可证 MIT
核心功能¶
取用浮层（composer）¶
- 输入框工具行有 ▤ 按钮，或按 Alt+P 打开浮层。
- 顶部分类行：全部 / 未分组 / 各分组（带条数），可与搜索、置顶叠加。
- 搜索按空格分词、逐词 AND，匹配标题、正文、分组。
- 点击一条：正文替换当前草稿；Shift+点击：追加到草稿末尾（空行分隔）。
- 键盘：↑↓ 选择，Enter 插入，Esc 关闭。
- 每条右侧 ▸ 可展开完整正文（限高 40vh，可多条同时展开）。
- 正文含
{{变量}}时，插入前弹小表单；{{date}}、{{time}}自动填当天日期与时间，留空变量保留原样。 - 「存当前草稿」可把草稿存成一条，存前可填标题与分组。
设置页（设置 → 提示词库）¶
- 列表上方搜索框与分类 chips；单条「编辑」在条目下方内联展开，同一时间只编辑一条。
- ★ 置顶；删除二次确认后 6 秒内可撤销。
- 导入并合并（按 id 覆盖同名、保留其余）/ 导入并替换（清空后写入，再确认）；导出 下载整库 JSON。
- 分组管理：重命名（与已有组名相同即合并）、解散（只清分组名不删条目）。
- 补齐内置模板：按
id（builtin:*）补缺失项，不覆盖已改过的正文。 - 页面会显示数据文件与备份文件路径。
内置模板¶
首次加载自动补 13 套模板，分 6 组（开工、排错、验收、工程、写作、学习），正文预留 {{变量}}。播种只补缺失 id，每个版本在浏览器 localStorage 记 dsh-prompt-library:builtin 自动补一次；内置条目可像普通条目一样编辑、改分组或删除。
数据与并发¶
- 文件名固定
prompt-library.json，目录优先级：DSH_PROFILE_DIR→DSH_HOME→~/.dsh→ 插件目录（兜底）。 - 整库字段含
version、rev（单调递增）、prompts数组；排序：置顶 → 最近使用 → 最近修改。 - PUT 带
rev做乐观锁；与磁盘不一致返回 409 并带回最新整库。写盘先.tmp再rename；整库保存前复制上一版为prompt-library.backup.json（仅更新lastUsedAt的写入不备份）。 - 请求体上限 200 KB，单条正文上限 64 K 字符。
宿主注册三条回环路由（仅回环 Host，无鉴权）：GET/PUT /prompt-library、POST /prompt-library/used。
安装与启用¶
从 GitHub 安装（命令来自仓库 README）：
dsh plugin --profile desktop add github:JianhangLy/dsh-prompt-library
本地开发可 link，改客户端后刷新页面即可；改 lib/index.js 需重启 DSH：
dsh plugin --profile desktop add link:<插件目录>
卸载：
dsh plugin --profile desktop remove dsh-prompt-library
典型用法¶
- 在输入框旁点 ▤（或 Alt+P）打开浮层。
- 点分类 chip 缩小范围，或在搜索框输入关键词。
- 点某一条 → 替换草稿；要在后面接着写 → Shift+点击。
- 有
{{变量}}时先填值再进入草稿。 - 改内容、分组、置顶 → 「设置 → 提示词库」。
导出得到纯 JSON，可手工编辑后用「导入并替换」灌回。
适用场景与注意¶
适合：经常在 DSH 里复用审查清单、排错话术、文档润色模板等，且希望数据只在本机、可备份可迁移的开发者。
注意：
- 选中即替换草稿，无确认步骤；插错需自行重写。
- 备份仅保留「上一版」，长期留底请用导出。
- 浮层为
position: fixed贴按钮定位；个别主题位置偏时需改client/client.js里LibraryPanel的样式计算。 - 列表全量渲染，百条以内无压力；上千条需虚拟滚动（README 已知限制）。
- 接口只允许回环访问、无鉴权；勿将 DSH 端口暴露到公网。
- 插件以当前 dsh 进程权限 运行；安装前请自行查看源码与 MIT 许可证，确认符合你的安全策略。
DSH 生态强调「一切皆插件」；SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-prompt-library 把提示词库嵌进 composer：分组 chips、分词搜索、变量填值、替换或追加草稿，以及单文件本地存储与 rev 乐观锁，适合把日常模板收拢在 DSH 里一键取用。
- 目录页：https://www.skillhub.cn/plugins/JianhangLy/dsh-prompt-library
- GitHub：https://github.com/JianhangLy/dsh-prompt-library
