提示词工作室 irislilymoon/dsh-prompt-studio

dsh-prompt-studio · 系统提示词工作室

DSH 桌面端 / Web 端插件，用来编辑初始系统提示词，并按需撤掉 DSH 注入的 runtime 上下文、工具 schema、AGENTS.md、时间读数等系统侧输入。普通模式、仅聊天和自定义模式可以在输入框上方切换，新对话使用设置页选定的默认模式。

设计参考：dsh-persona-select（MIT）

本项目是独立实现，额外提供自定义模式、新对话默认模式、旧系统提示词重建、原生主题 UI 和与输入框对齐的模式选择器。

功能概览

- 普通模式：使用 DSH 默认系统提示词与完整工具。
- 仅聊天：只发送设置页里的「仅聊天提示词」，并屏蔽所有系统侧输入。
- 自定义模式：每套模式独立保存名称、系统提示词、屏蔽开关和工具基线保护。
- 新对话默认模式：新会话自动使用普通模式、仅聊天或任意自定义模式。
- 当前对话切换：输入框上方的模式选择器只影响当前对话。
- 实时生效：切换模式后，下一轮会重开请求序列并重建系统提示词，不会继续沿用历史里的旧提示词。
- 原生 UI：使用宿主 Menu / Button / SegmentedControl 和浅色/深色主题服务。

模式

设置页的「新对话默认模式」决定新会话的初始模式；已有对话可以在输入框上方单独切换。

| 模式 | 行为 |
| 普通模式 | 完全使用 DSH 自带的系统提示词与完整工具 |
| 仅聊天 | 只发送「仅聊天提示词」，强制全量替换并屏蔽所有系统侧输入 |
| 自定义模式 | 使用模式自己保存的提示词、屏蔽开关和工具保护配置 |

本版本没有全局模式。设置页编辑的是仅聊天提示词；普通模式固定使用 DSH 默认提示词，其他组合通过自定义模式保存。

仅聊天

「仅聊天」固定使用设置页里的「仅聊天提示词」，并打开四类屏蔽：

- 屏蔽 runtime 上下文：工作目录、沙箱/审批策略、skill 目录等快照。插件会同时拦截 agent.runtimeContext 的投影并注册 suppressRuntimeContext()，连 DSH 必需的 working-directory 上下文也不会发送。
- 屏蔽工具 schema：工具定义走独立协议字段，通常是最大的一笔 token。打开后请求里没有工具。
- 屏蔽 AGENTS.md / 时间等注入：agent-instructions、time-context、skill-catalog、skill-invocation。
- 屏蔽所有非用户注入：用户角色里只要不是用户自己发的消息都过滤，包括 plan-mode、goal、schedule、session reference 等。

仅聊天默认从第一条消息起就不带工具，所以「你好」这一轮也是低 token。代价是：如果之后在同一个会话里重新打开工具，可能因工具声明基线为空被服务端拒绝；此时新建一个会话即可。

自定义模式

设置页的「自定义模式」板块可以新建、编辑、删除模式。每套模式独立配置：

- 提示词模式：不覆盖 / 全量替换 / 只替换开场白。
- 不覆盖：完全使用 DSH 自带的系统提示词。
- 全量替换：整个系统提示词只保留模式里的正文；Agent Teams、工具指引、plan 策略等其余段全部去掉。
- 只替换开场白：用正文替换 harness:identity 和 deployment:persona-prefix，其他段保留。
- 系统提示词正文：按字面注入，不参与 DSH 的 {{变量}} 插值；只有 {{model}} 会被替换成当前模型名。
- 屏蔽开关：runtime、工具 schema、AGENTS.md / 时间注入、非用户注入，可单独开关。
- 工具基线保护：在会话首轮和声明序列重启时保留完整工具一轮，避免之后重新打开工具被服务端拒绝（首轮会多约 9k token）。

新建模式默认使用「全量替换」，并把当前仅聊天提示词作为起点，屏蔽开关默认关闭，可以按需调整。

模式切换与实时生效

切换当前对话的模式后，下一轮 agent/pre-step 会返回 startsRequestSeries: true，DSH 随即将当前激活的 system 节点替换为新模式的系统提示词，并清空后续旧节点。例如从仅聊天切到普通模式，新一轮会重新注入 DSH 的普通系统提示词，而不是继续沿用历史里的仅聊天提示词。

- 修改提示词、切换模式或删除当前会话正在使用的自定义模式，都会触发相应的重建。
- 重新打开已有会话时，如果历史里已经存在旧系统提示词，插件会在第一次装配时做一次干净重建，确保运行期间保存的配置继续生效。
- 设置页的「上一轮装配结果」会显示系统提示词段数、工具数、过滤数量，以及本轮是否重开了请求序列。

实现位置

- 系统提示词：监听 system-prompt/assemble，重写 sections / tools。
- 用户侧注入：监听 agent/pre-step，按 source.kind 过滤 messages。
- 请求序列：模式变化或旧 system 节点不匹配时，在 agent/pre-step 设置 startsRequestSeries: true，由 DSH 用当前模式的提示词覆盖旧节点。
- runtime 上下文：按 agent 替换 agent.runtimeContext.project，并在 agent 作用域注册 systemPrompt.suppressRuntimeContext()。
- 设置：<DSH_HOME>/prompt-studio/settings.json（默认 ~/.dsh/prompt-studio/settings.json），原子写入。自定义模式的会话引用格式为 custom:<id>。
- UI：宿主 Menu / Button / SegmentedControl 与宿主 theme 服务。

目录结构

dsh-prompt-studio/
├── index.js # 宿主半侧：装配重写、注入过滤、HTTP 路由 ├── client.js # 浏览器半侧：设置页、输入区模式选择器 ├── cordis.patch.yml # bundle patch ├── package.json ├── locale/ # 插件市场显示用的中文/英文元数据 │ ├── zh.json │ └── en.json ├── icon.svg ├── README.md ├── CHANGELOG.md └── LICENSE

安装

桌面端插件页（推荐）

把本目录放到任意位置，然后在 DSH 中打开：

设置 → 插件 → 添加插件 → 填写该目录的绝对路径：

<插件目录>\dsh-prompt-studio

安装后插件会出现在「已安装插件」，确认开关是开启状态即可；客户端部分会热更新，宿主部分按提示重启 DSH。

卸载：设置 → 插件 → 系统提示词工作室 → 卸载。

命令行（仅非桌面 profile）

桌面 profile 由 Electron 应用独占管理，dsh plugin --profile desktop ... 会被拒绝。桌面端请使用上面的插件页；Web / CLI profile 可以用：

dsh plugin --profile <profile-name> add "<插件目录>/dsh-prompt-studio"

限制

- minimal 模式：如果某个 agent preset 自己声明了 complete: true 的系统提示词段（DSH 内置 minimal 模式会），平台会在装配最后把它恢复为唯一段，本插件的提示词段无法进入。请改用 standard / cordis / ptc 等模式。
- 工具恢复：仅聊天或开启了工具屏蔽的自定义模式，从首轮起工具基线为空，之后在同一会话打开工具可能被服务端拒绝；请新建会话，或在模式里预先开启「工具基线保护」。
- 已有工具调用的会话：把已经调用过工具的会话切换到仅聊天时，工具历史与空声明可能对不上，容易被服务端拒绝；仅聊天建议使用新会话。
- KV 缓存：切换提示词、模式或屏蔽开关会让下一轮请求内容变化，已有会话的缓存会重建一次，之后恢复稳定；重开请求序列也会重建一次缓存。
- 插件只处理 role === 'user' 的注入消息；assistant / tool 历史原样保留，避免破坏会话结构。
- 兼容性：需要提供 Menu / Button / SegmentedControl 客户端 primitives 与 theme 服务的 DSH 0.2.x。

数据文件

~/.dsh/prompt-studio/settings.json

- prompt.text: 仅聊天提示词正文
- defaultMode: 新对话默认模式，normal / pure / custom:<id>
- modes: 自定义模式数组，每项包含 id、name、promptMode、promptText、suppress、toolSafety
- sessions: 每个会话的模式覆盖；没有覆盖的会话跟随 defaultMode
- prompt.mode / suppress / toolSafety: 旧版兼容字段；仅聊天固定全量替换和全部屏蔽，自定义模式使用各自的配置

删除该文件即可恢复默认（插件仍会挂载，但所有功能关闭）。

隐私

- 插件只在本地读写 <DSH_HOME>/prompt-studio/settings.json；设置页通过同源本地路由存取，不访问外部服务。
- 仓库内不包含用户设置、会话日志、凭据、账号信息或本机绝对路径。
- 提交 issue / 截图时请注意：轨迹和会话内容可能包含个人信息，发布前自行脱敏；本插件本身不收集这些数据。

DSH Desktop/Web 插件，让初始系统提示词可编辑，并屏蔽运行时上下文、工具 schema、AGENTS.md、时间读取等系统侧输入。普通模式、仅聊天和自定义模式从输入框上方的提示词行切换；新对话使用设置里选定的默认模式。

设计参考：dsh-persona-select（MIT）

这是独立实现。它新增了自定义模式、新对话默认模式、干净替换过期系统提示词、原生主题感知 UI，以及与输入框对齐的模式选择器。

- 普通模式：DSH 默认系统提示词和完整工具。
- 仅聊天：只发送设置里的仅聊天提示词，并屏蔽全部系统侧输入。
- 自定义模式：按模式分别保存名称、系统提示词、屏蔽开关和工具基线保护。
- 默认模式：新对话以普通模式、仅聊天或任意自定义模式开始。
- 按会话覆盖：输入框上方的选择器只影响当前对话。
- 实时更新：切换模式后，下一轮会开启新的请求序列并重建系统提示词，不会复用旧的仅聊天提示词。
- 原生 UI：使用宿主的 Menu、Button、SegmentedControl 和宿主明暗主题服务。
自定义模式内部可用的提示词模式有 do not override、replace whole prompt 和 replace opener only。{{model}} 会替换为当前模型名；其余文本按字面注入。新建的自定义模式从仅聊天提示词起步，启用完整替换，不开启任何抑制。

数据存放在 ~/.dsh/prompt-studio/settings.json。安装时进入 Settings → Plugins → Add plugin，填入本目录的绝对路径（桌面配置档由 Electron 应用管理；dsh plugin --profile desktop ... 会被拒绝）。Web/CLI 配置档可以用 dsh plugin --profile <profile-name> add "<plugin-dir>/dsh-prompt-studio"。

限制：带 complete 提示词区段的极简智能体预设会覆盖本插件的提示词；已经用过工具的会话，可能拒绝之后设置的空工具基线；每次改动模式或提示词都会重建一次 KV 缓存。插件只过滤 user 角色注入的消息，assistant/tool 历史保持原样。需要 DSH 0.2.x，并具备客户端原语和主题服务。

隐私：所有设置都留在本地 ~/.dsh/prompt-studio/settings.json。插件没有遥测，也不发起外部网络请求；仓库不附带任何用户设置、会话日志、凭据、账户数据或机器相关路径。

参考与致谢

- dsh-persona-select：本插件在 DSH 插件结构、系统提示词注入/屏蔽、仅聊天开关和会话级覆盖的设计上参考了该项目（MIT）。
- 本项目为独立实现，不包含 dsh-persona-select 的内置人设、历史对话导入/导出、PNG 角色卡等功能，也不包含其鲸鱼娘形象素材。
- 如果后续引入或改编该项目的代码，请同时保留其 MIT 许可证声明。

License

MIT — see LICENSE.