前言¶
在 DSH 里来回试提示词时，一段调好的模板往往只留在当前会话或剪贴板里；换会话、换机器就找不到。有人用 Obsidian 或 Git 单独维护文本，但和 composer 之间还要复制粘贴。DeepSeek Harness 的社区插件 dsh-prompt-vault（维护者 ElioFanyu）把提示词落成带 YAML frontmatter 的 .md 文件，在 Web 界面工具栏里搜索、保存、编辑并插入，同时给模型暴露 prompt_vault 工具。下面介绍它的定位、能力与安装配置。
社区目录归类为「记忆」，见 SkillHub 条目；源码与说明以 GitHub 仓库 为准（当前 package.json 版本 1.1.0，MIT 许可证）。
这是什么¶
dsh-prompt-vault 是一个 DSH Web 插件：把可复用提示词存到本机目录（默认在 DSH 主目录下），在任意会话的输入框工具栏通过「提示词」面板插入正文。设计上是「文件即唯一真相」——没有独立数据库，也没有单独的导出流程；库就是一堆 Markdown 笔记，可与 Obsidian 共用同一文件夹。
核心功能¶
人在界面里怎么用¶
安装并刷新后，输入框工具栏左侧会出现「提示词」按钮，点开面板后可：
- 点选一行：将该条正文插入到光标处（先插入空行再接正文）。
- 搜索框兼输入：短文本仍用于过滤列表；粘贴多行长文本后不再过滤列表，可点「保存」或
Ctrl+Enter存为新条（标题默认取正文首行），也可「先改标题…」再存。 - 编辑：改标题、标签、正文；文件名不变，上一版自动进入
.history/。 - 新建 / 存草稿 / 删除：删除默认软删除到
.trash/（带时间戳），需二次确认。 - 库目录：面板底部显示当前
vaultDir。
模型侧 prompt_vault 工具¶
| action | 作用 |
|---|---|
list |
列出全部（标题、id、标签、预览） |
get |
读一条完整正文 |
save |
新建或覆盖（有 id 为改，无则为建） |
import |
把磁盘上的文本文件导入为提示词 |
remove |
删除一条 |
where |
返回库目录与统计 |
需要把本地文件并进库时，可用 import 直接读文件，而不必把全文贴进对话。
文件格式与可靠性¶
每条提示词为 Markdown + frontmatter，例如：
---
title: 雨夜便利店街角
tags: [生图, 场景]
created: "2026-11-10T05:29:57.372Z"
updated: "2026-11-10T05:29:57.372Z"
description: 请制作一个雨夜便利店街角小场景…
---
（正文）
插件读写 title / tags / created / updated / description；你在 Obsidian 里增加的其它属性会保留。没有 frontmatter 的普通 .md 也可被识别。写入采用临时文件再重命名；覆盖前归档历史；超过 maxFileBytes（默认 256 KiB）的文件在列表与读取时会跳过。
安装与启用¶
环境要求（见 package.json）：DSH >=0.2.1-rc.3 <0.3.0-0，Node >=20。
官方 README 给出的安装方式为本地路径链接（将 <本仓库路径> 换为你机器上的仓库绝对路径，勿使用未在文档中出现的 github:owner/repo 拼接）：
dsh plugin --profile <profile> add link:<本仓库路径>
也可用 plugin_manager 的 install_bundle，target 传本仓库绝对路径。装完后刷新页面，工具栏应出现「提示词」按钮。
典型用法：目录与 Obsidian 共存¶
默认目录为 %DSH_HOME%/prompt-vault（Linux/macOS 下多为 ~/.dsh/prompt-vault）。若要与 Obsidian 共用，在 profile 的 cordis.patch.yml 中为本插件设置 vaultDir：
- id: dsh-prompt-vault
name: '@local/dsh-prompt-vault'
config:
vaultDir: 'D:/Workspace/Obsidian/提示词'
改完重启 DSH。该目录下已有的 .md 会被直接识别，无需再导入。
其它常用配置（摘自 README）：
| 键 | 默认 | 说明 |
|---|---|---|
vaultDir |
''（即 <DSH_HOME>/prompt-vault） |
提示词根目录 |
maxFileBytes |
262144 |
单文件大小上限 |
historyLimit |
20 |
每条历史版本数；0 关闭 |
softDelete |
true |
删除时移至 .trash/ |
跨设备同步未内置；可将 vaultDir 放在同步盘或 Git 仓库中自行同步。
适用场景与注意¶
适合谁：经常在 DSH 里复用同一套提示词模板、希望与 Obsidian/Git/任意编辑器共用同一文件库的开发者或写作者。
使用前应知晓：
- 插件在当前 DSH 进程权限下读写本机目录；安装前请自行审阅 源码 与 MIT 许可证。
- 面板内编辑「保存」不会改文件名；重命名需在文件系统或 Obsidian 中操作（有意为之，避免打断
[[链接]]）。 - 无 Markdown 预览；插入依赖 composer 的
insertText，若插入点已失效会提示重新点击，而不是盲目追加。 - HTTP 写操作仅接受本机回环地址（README 安全说明）。
社区插件目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本介绍不构成官方背书。
结尾¶
dsh-prompt-vault 把提示词从「会话里的一次性文本」变成「磁盘上的 Markdown 笔记」，并在界面与 prompt_vault 工具两条路径上复用。需要进一步了解参数与限制时，请直接阅读仓库 README；安装与配置以文档中的 link:<本仓库路径> 与 cordis.patch.yml 为准。
