dsh-prompt-switcher

dsh-prompt-switcher

DeepSeek Harness（DSH） Web 插件。新建对话时输入 /，可以从本地目录里的 .md 提示词模板中选一个。模板的约束力等同于 AGENTS.md，对这个对话之后的每一轮都有效。还可以设置对所有新对话生效的全局提示词，用 {{env:变量名}} 在提示词中引用环境变量，并通过 WebDAV 在多台设备之间同步提示词模板和环境变量。还可以开启删除对话，在左侧对话栏的菜单中彻底删除对话。

• 兼容版本：DSH >=0.1.7-alpha.1，即 0.1.7 系列的 alpha 版及之后的正式版；Node >=22.19
• 插件形式：标准 DSH bundle。package.json 里声明了 dsh.bundle.patch 和 dsh.client，Host 半和 Browser 半都是纯 ESM，没有运行时依赖，安装时不需要构建
• 收录在 mikulo/dsh-plugins 插件清单中

功能

安装

通过 dsh-plugins 清单（推荐）

git clone https://github.com/mikulo/dsh-plugins.git
cd dsh-plugins
node install.mjs --profile web --only dsh-prompt-switcher

直接安装

dsh plugin --profile web add github:mikulo/dsh-prompt-switcher

安装后重启 dsh web 并刷新页面。

• 更新：dsh plugin --profile web update @mikulo/dsh-prompt-switcher，然后重启 dsh web
• 卸载：dsh plugin --profile web remove @mikulo/dsh-prompt-switcher

升级 DSH 前后

DSH 仍是测试版，可能有破坏性更新。本插件和 DSH 本身都做了隔离，插件出问题时一般只是功能失效，不会导致 DSH 起不来：

• DSH 加载 profile 时，读不了或不兼容的插件包会被跳过；插件代码加载或初始化失败只记日志，其他插件照常运行。
• 本插件每个功能单独安装、单独容错：某个 DSH 接口变了，只有对应的功能不出现（例如「删除对话」菜单行），设置页和其余功能不受影响；每一步对话前运行的钩子在出错时原样放行，不会卡住对话。
• 删除相关的操作只在你点击时执行，并且删除前会先检查目录，不对就停止。

万一升级后 dsh web 异常，可以：

1. 卸载插件：dsh plugin --profile web remove @mikulo/dsh-prompt-switcher，再启动 dsh web。设置和环境变量文件保存在 ~/.dsh/，不会丢失。
2. 或者用不含第三方插件的 profile 启动做对比，例如 dsh --profile rescue（profile 里只列 @deepseek-ai/dsh-base 和 @deepseek-ai/dsh-web-app 两个 bundle）。

插件的 Browser 半会随页面热更新，Host 半必须重启 dsh web 才会加载新代码。两边版本不一致时，设置页顶部会提示“请重启 dsh web”。

使用

1. 打开 设置 → 提示词模板，点击「选择文件夹」，选中存放模板的目录。
   • 只读取该目录第一层的 *.md 文件，扩展名不区分大小写。列表按文件名显示。
   • 新目录中的模板默认全部关闭，打开开关才会激活。
   • 目录里的文件增删改之后，点击「刷新」。
2. 新建对话，在输入框输入 /，已激活的模板（例如 代码审查）会出现在菜单里。继续输入文字可以过滤。
3. 选中模板（或直接输入 /代码审查 再按空格）后，输入框为 /代码审查 ，接着输入第一条消息并发送。发送时插件识别开头的模板名并绑定模板，之后这个对话的每一轮都会遵守该模板。
   • /代码审查 以普通文字显示（不再变成蓝色命令词）。这是为了绕开 DSH 输入框的一个问题：命令词高亮会打断中文输入法的组字，导致拼音重复、文字变蓝且无法删除。
   • 中文输入法状态下按 / 键会输入 、。输入框开头的 、（或全角 ／）会自动换成 /，同样弹出模板菜单，两者等效。句子中间的 、（如“苹果、香蕉”）不受影响。

仓库里的 examples/ 有两个示例模板，可以把它设为模板目录来体验。

全局提示词

在 设置 → 提示词模板 → 全局提示词 中配置：

1. 选择来源：
   • 模板文件：从模板目录的 .md 文件中选一个，文件名（不含扩展名）就是全局提示词的名称。之后更换模板目录不影响已选的文件。
   • 自定义文本：填写名称（必填）和内容，点击「保存」或按 Ctrl+S。内容保存为模板目录下的 名称.md（需要先配置模板目录），之后也会出现在模板列表里，可以用「编辑」修改。目录中已有同名的其他文件时，会先询问是否覆盖。改名后保存会写入新文件，旧文件保留。
2. 打开「启用全局提示词」开关。配置不完整时开关打不开，并提示原因。

规则：

• 只对开启之后新建的顶层对话生效；已开始的对话和子代理会话不会被注入。分叉出来的会话沿用原会话的状态（原会话有就有，没有就没有）。
• 对话开始时绑定的是当时的快照：之后修改或关闭全局提示词，只影响再之后新建的对话。上下文压缩后会重新注入同一份快照。
• 在新对话中用 / 选择模板时，会话里依次是 全局提示词 → 模板 → 你的第一条消息。模板追加在全局提示词之后，两者同时生效。/ 菜单中的模板说明会显示“追加在全局提示词「…」之后”。
• 全局提示词启用了但读不到（文件被删、内容为空等）时，设置页显示原因，新对话照常进行，只是不注入。

WebDAV 云同步

在 设置 → 提示词模板 顶部切换到「WebDAV 云同步」标签页：

1. 服务器：填写存放模板的 WebDAV 目录地址（例如 https://dav.jianguoyun.com/dav/prompts/）、用户名和密码（坚果云等服务请使用应用专用密码）。密码只保存在本机，不会回传到页面；再次保存时密码框留空表示保持不变。
2. 代理（默认关闭）：打开「通过代理连接」后，可选 HTTP 或 SOCKS5，地址默认 127.0.0.1:7891，可以修改。开关决定「测试连接」和同步是否经过代理。暂不支持需要认证的代理。
3. 测试连接：用表单里当前（可以尚未保存）的配置访问该目录，显示成功、认证失败、目录不存在、代理连不上等结果。
4. 点「保存配置」后才能同步。

同步（只处理两边目录第一层的 .md 文件，不含子目录）：

• 同步到本地：列出云端目录的 .md 文件，默认全部勾选，「全选 / 取消全选」一键切换。点「同步到本地」下载到模板目录。
• 同步到云端：列出本地模板目录的 .md 文件，操作同上，上传到云端目录；云端目录不存在时自动创建。
• 目标位置已有同名文件时，逐个询问「覆盖 / 跳过」，同名文件不止一个时还可以「全部覆盖 / 全部跳过」，也可以「取消同步」。完成后列出每个文件的结果（新增 / 覆盖 / 跳过 / 失败）。

说明：只支持 Basic 认证；单个文件上限 1 MiB；配置保存在 $DSH_HOME/dsh-prompt-switcher.json，其中密码是明文。

同步环境变量文件

打开「同步」下方的「同步环境变量文件」开关（默认关闭）后，点「同步环境变量…」。插件同时读取本地和云端的 dsh-prompt-switcher.env.json（云端位于 WebDAV 目录根目录），显示两边各有多少变量、哪些相同、哪些只在一边、哪些同名但值不同，然后选择同步方式：

同步时 Host 会重新读取两边的文件；比较之后如果文件又有变化，出现新的冲突时会重新让你选择。

环境变量

在 设置 → 提示词模板 顶部切换到「环境变量」标签页：

• 每行一个变量：左边是变量名，右边是对应的字符串。「新增变量」加一行，「删除」删掉一行，改完点「保存」（或 Ctrl+S）。「复制引用」把 {{env:变量名}} 复制到剪贴板。
• 变量名以字母、汉字或 _ 开头，只能包含字母、汉字、数字、_、.、-，不能重复（区分大小写）。变量名和值都为空的行保存时忽略。
• 在提示词模板或全局提示词里写 {{env:变量名}}（花括号内允许空格，如 {{ env: github_api }}）。例如变量 github_api = 123456，模板里的 github的api是{{env:github_api}} 发送给模型时是 github的api是123456；如果没有定义这个变量，就变成 github的api是。
• 只识别 {{env:…}} 这一种写法。{{name}}、<name>、${name} 等其他写法原样保留，不会被误删。
• 替换发生在新对话绑定提示词的那一刻，写入会话的是替换后的快照。之后修改变量只影响再之后新建的对话。注意：变量值会以明文出现在发送给模型的内容和会话记录里。
• 页面打开后，如果文件被其他程序或云同步改过，保存时会先询问是否覆盖。未保存的修改在切换标签页或关闭设置对话框后保留到页面刷新前。

环境变量保存在 $DSH_HOME/dsh-prompt-switcher.env.json（默认 ~/.dsh/dsh-prompt-switcher.env.json），格式如下，也可以手动编辑（手写成 { "变量名": "值" } 这样的简单对象同样能识别）：

{
  "version": 1,
  "variables": [
    { "name": "github_api", "value": "123456" }
  ]
}

这个文件不在模板目录里，卸载或重装插件都不会丢失。

删除对话

DSH 自带的对话菜单只能归档，不能删除。本插件可以加上删除功能：

1. 打开 设置 → 提示词模板，切换到「允许删除对话」标签页，打开「是否允许删除对话」开关（默认关闭）。
2. 在左侧对话栏把鼠标移到对话标题上，点击出现的「…」图标。菜单在「置顶对话 / 重命名 / 分叉对话 / 归档对话」之后多出红色的「删除对话」。
3. 点击「删除对话」后弹出确认框「是否删除对话，删除不可撤销」，点「是」才会删除，点「否」取消。

删除时插件会：

• 先按「归档对话」的官方流程停止该对话正在运行的工作（当前轮次、后台任务、子代理、定时任务）。如果你正在查看这个对话，页面会自动离开它。
• 卸载该对话在当前 dsh web 进程中已加载的实例，然后删除它在 ~/.dsh/sessions/<项目>/<会话 ID>/ 下的会话记录，连同它的子代理会话一起删除，并清理它的投影缓存、置顶和归档记录。
• 从这个对话分叉出来的对话是独立对话，不会被删除。

删除所有已归档

开关打开后，点击左侧对话栏「工作区」文字右侧的「视图选项」按钮，筛选菜单「隐藏已归档 / 全部对话（显示已归档）/ 仅显示已归档」下面多出红色的「删除所有已归档」。点击后弹出确认框「是否删除所有已归档的对话，删除不可撤销」，并显示将删除的对话数量；点「是」后逐个删除全部已归档的对话（每个都按上面的流程，连同子代理会话），某个失败不影响其余的，失败项会列在确认框里。指向已不存在会话的归档记录会顺便清掉。

这个菜单在 DSH 里是写死的列表，没有提供插件槽位，所以插件在菜单弹出时向它的页面元素里追加这一行（通过菜单的 …_viewOptionsMenu 样式类或「隐藏已归档」这一行识别，外观复用原有菜单行的样式）。DSH 以后改了这个菜单的结构时，这一行可能不再出现，但不会影响菜单原有的功能。

说明：

• 删除不可撤销。插件在删除前会校验目录确实是该会话自己的目录，校验不通过就什么都不做。
• 关闭开关后菜单中不再显示「删除对话」，Host 也会拒绝删除请求。
• 极少数情况下，已加载的对话实例无法卸载：会话记录照样删除，对话会暂时归档隐藏，重启 dsh web 后完全消失。
• 开关保存在 ~/.dsh/dsh-prompt-switcher.json 的 allowDeleteSession 字段，重装插件不会丢失。
• 自定义目录：会话文件的位置由 DSH 自己的会话存储给出（sessionPersistence.locate()），所以用 DSH_HOME 等方式改了数据目录，或在配置里改了会话存储根目录，删除都会作用到实际的位置；DSH 程序本身装在哪个目录与此无关。插件的设置文件同样遵循 DSH_HOME（支持 ~/… 写法）。
• DSH 本身没有删除会话的接口，这个功能依赖当前 DSH 版本（0.2.0-rc.1）的会话存储结构（JSONL）和内部结构。DSH 升级后如果结构变了，删除会报错并停止，不会误删其他文件。

编辑模板

在列表中点「编辑」进入编辑视图：

• 「保存」或 Ctrl+S 保存，「放弃修改」回到上次保存的内容，标题旁显示“已保存 / 未保存”，Tab 键插入两个空格。
• 用其他程序打开…：Windows 上弹出“你要如何打开这个文件？”对话框，macOS 上弹出“选取应用程序”对话框，Linux 上用默认程序打开。在外部编辑器保存后，编辑视图约 2 秒内自动同步。如果这里也有未保存的修改，会让你选择「载入磁盘版本」或「保留我的修改」。
• 文件在打开后被其他程序改过时，保存会被拒绝，并提供「载入磁盘版本 / 仍然覆盖保存」。
• 关闭设置对话框时，未保存的草稿会保留到页面刷新前。
• 保存时保留文件原有的 BOM 和 CRLF 换行。
• 修改模板只影响之后新建的对话。已经开始的对话使用的是第一次发送时的模板快照。

工作原理

注意：

• 子代理（subagent）的会话不继承模板，也不注入全局提示词。
• 单个模板上限为 1 MiB。模板中的 </system-reminder> 会被转义。
• 设置接口只接受本机访问。通过局域网打开的 Web 页面不能修改本插件的设置。

开发

npm run build   # src/ → lib/：写入版本号，校验 Host/Client 协议号与模块 id，并做语法检查
npm test        # 确认 lib/ 与 src/ 一致，然后用伪造的 Harness 服务跑 Host 与 Client 冒烟测试，
                # 并用本地假 WebDAV 服务器、HTTP 代理和 SOCKS5 代理跑同步测试

• 修改 src/ 后运行 npm run build，并把 lib/ 一起提交。插件通过 github: 安装时直接使用仓库里的 lib/，没有安装时构建脚本。
• 修改 Host 与 Client 之间的接口时，同时递增 src/index.js 和 src/client.js 中的 HOST_PROTOCOL。

本地联调可以用 link 安装：dsh plugin --profile web add link:<本仓库绝对路径>。改代码后重新构建，再重启 dsh web。

更新日志

• 1.6.0：新增「允许删除对话」标签页；开启后左侧对话栏的「…」菜单多出红色的「删除对话」，「视图选项」菜单多出红色的「删除所有已归档」，二次确认后彻底删除对话（连同子代理会话）。设置文件路径的 DSH_HOME 支持 ~/… 写法。插件各功能单独容错，DSH 接口变化时只影响对应功能、不影响对话和其余功能。Host/Client 协议号升为 8，更新后需重启 dsh web。
• 1.5.0：中文输入法下输入框开头的 、（及全角 ／）等效于 /，可直接弹出提示词模板菜单。
• 1.4.1：修复在 /模板名 后用中文输入法（如 QQ 拼音）输入时，拼音重复插入、文字变蓝且无法删除的问题。/ 模板不再占用 DSH 输入框的「命令认领」，改为发送时识别；模板名含空格时也能正确匹配。
• 1.4.0：新增「环境变量」标签页，提示词模板和全局提示词中的 {{env:变量名}} 在发送前替换为对应的值；WebDAV 新增「同步环境变量文件」开关，支持合并配置文件（同名不同值逐个选择）、本地覆盖云端、云端覆盖本地。
• 1.3.0：自定义全局提示词保存为模板目录下的 名称.md；新增「WebDAV 云同步」标签页（服务器配置、HTTP / SOCKS5 代理、测试连接、双向选择性同步与同名覆盖确认）。
• 1.2.0：新增全局提示词（模板文件或自定义文本），对之后新建的每个对话生效；/ 模板追加在全局提示词之后。
• 1.1.0：首个公开版本：/ 选择提示词模板、模板编辑器、外部编辑器同步。

许可证

MIT