- Startseite
- Plugins
- Sitzungen & Nachrichten
- dsh-prompt-lab
dsh-prompt-lab
eustia-ast/dsh-prompt-lab
Per-session DeepSeek Harness system-prompt section editing with templates, presets, automatic backups, blank-window drafts, message appends and per-session global-tool switches; only explicitly enabled sessions are affected. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Installation
dsh plugin --profile web add github:eustia-ast/dsh-prompt-labREADME
Prompt Lab(提示词实验室)
以会话为范围控制系统提示词分段 section,支持覆盖/置空/新增,保留漂移检测与恢复机制。
Prompt Lab 是一个 DeepSeek Harness(DSH)插件。打开一个会话的 Prompt Lab 并显式开启后,它可以改写、置空或在任意位置新增该会话的提示词分段;其他没有开启的会话继续使用 DSH 的官方装配。同时插件提供追加user消息和伪造的assistant消息的能力。它还提供模板库、预设、自动备份、空白窗口草稿和按会话的 global 工具开关。本插件暂不提供破限文本或预设。
当前版本:
1.0.0。面板 UI 为中文;支持 DSH0.2.2-rc.2到0.2.2-rc.5。Prompt Lab 会改变模型收到的系统提示词和工具可见性,从而影响 Agent 的真实动作。修改系统提示词不是权限边界,也不能替代 DSH 的审批、沙箱或工具策略。
功能
- 按会话生效:只处理你明确打开「对本会话生效」的会话;其他会话不受影响。
- 分段编辑:替换或置空系统提示词中的单个 section,不重写整篇提示词。
- 可复用模板:同一 section 可以保存多个模板,随时切换或另存。
- 新增段与临时段:在指定官方 section 前后插入自定义内容;临时段只用于下一轮。
- 追加user消息:可在单轮对话内主动追加多条user消息。
- 追加assistant消息:构造完整轮次以达到人为构造一条assistant消息的效果。(该功能偏实验性,为防止轮次编号出现问题导致会话损坏,需要重启dsh以同步轮次)
- 预设:把覆盖、新增段、临时段和工具开关保存为一组配置,应用到其他会话。
- 自动备份与恢复:每次写入前保存会话快照;手动备份单独计数,恢复前再留一份快照。
- 空白窗口草稿:会话开始首轮前先把配置写成草稿,首轮开始时自动提交;关闭窗口不会丢弃全局模板。
- 漂移检测:官方 section 文本变化时,已保存的覆盖会显示为「挂起」,不会静默覆盖新文本。
- 完整提示词识别:如果当前 preset 使用
complete整篇提示词,面板会明确提示分段编辑不生效。 - 工具开关:按会话关闭 global 工具,并同步隐藏对应的
tool:<name>提示词段;agent preset/scoped 工具仍由 preset 控制。 - 敏感、越级项只读:展示 AGENTS/CLAUDE 指令文件、工具列表和当前装配结构,不修改这些来源。
安装
要求:
- DeepSeek Harness
0.2.2-rc.2到0.2.2-rc.5 - Node.js
22.19+或24+
从 npm 安装:
dsh plugin --profile desktop add dsh-prompt-lab
如果你使用 web 或其他 profile,把 desktop 换成对应的 profile 名。
从 GitHub 源码安装:
dsh plugin --profile desktop add github:Eustia-Ast/dsh-prompt-lab
安装或升级后,完全退出 DSH 再重启,让 Host 重新加载插件。
使用
- 打开一个会话。
- 点击输入框左下角的 Prompt Lab。
- 打开 「对本会话生效」。
- 在「提示词」页编辑需要的 section,或在「预设」「文本管理」「备份」「设置」页管理配置。
首次打开时,插件会尝试读取当前会话的官方装配。这个操作不会发送模型请求,也不会写入会话日志。
草稿窗口
如果会话还没有开始首轮对话,编辑会先写入这个窗口的草稿:
- 模板、预设、文本库属于全局内容,立即生效;
- 当前窗口的映射、新增段和启用状态在首轮对话开始时提交;
- 关闭窗口不会丢掉全局模板;未提交的窗口映射会按清理规则处理。
完整提示词
如果会话的 agent preset 使用 complete 模式(比如dsh自带的极简模式),DSH 会用 preset 的整篇提示词替代普通分段。此时 Prompt Lab 仍可保存配置,但分段改动不会生效;需要更换 preset 或修改 preset 配置后新建会话。
消息管理
「消息管理」里的追加 user / assistant 消息是显式操作,会写入真实的会话日志和合成轮次。它不是编辑器预览;使用前请确认你了解它会改变模型的可见历史。追加的assistant消息会被模型默认为是模型自己输出的消息,写入 assistant 消息后,插件会锁定该会话并要求重启 DSH,避免 turn 编号不一致。
安全边界
Prompt Lab 能改变 Agent 看到的内容,因此请把它当作高权限的提示词编辑器:
- 插入或改写人格类 section 可能误导 Agent 的身份认定;
- 改写工具协议、权限说明、计划规则等 section 可能让 Agent 误用工具或误判权限;
- 关闭 global 工具会影响该会话能执行的动作;
- 新增段可以写入任意指令,包括与 DSH 官方规则冲突的指令;
- 完整提示词 preset 不受分段编辑控制。
插件自身不做权限判断,不替代 DSH 的审批、沙箱和工具策略。请只在你信任的会话里使用,并保留备份。
本地 HTTP 接口
面板通过 DSH Web server 上的同源路由 /prompt-lab/api 读写配置。该接口:
- 写请求必须是
application/json;带Origin时会校验它必须与 loopback Host 同源; - 某些 DSH 宿主在同源 POST 上不发送
Origin,此时仍要求 loopback 客户端、loopback Host,并校验存在时的Sec-Fetch-Site; - 非本机网络客户端、非 loopback Host、
nullOrigin 和跨站Sec-Fetch-Site会被拒绝; - 不提供远程鉴权,也不应该通过反向代理、隧道或其他方式向不可信网络开放;
- 不调用模型、不发送遥测、不访问外部网络。
如果 DSH 的 Web server 绑定到非本机地址,请不要直接把这个插件暴露给不可信网络。
数据与隐私
默认数据目录:
$DSH_HOME/plugins/dsh-prompt-lab(设置了DSH_HOME时)- 否则
~/.dsh/plugins/dsh-prompt-lab
可以在「设置」里改到其他绝对路径;路径不能位于当前工作区或磁盘根目录,改路径时新旧目录不能互相包含,也不能包含插件配置目录。改路径不会立即移动数据,重启 DSH 时迁移。
目录内容:
| 内容 | 说明 |
|---|---|
config.json | bootstrap 配置:数据目录、备份/预设上限 |
library/ | 分段模板、消息文本、预设 |
sessions/ | 每个会话的覆盖、新增段、工具策略和备份 |
drafts/ | 首轮前的窗口草稿 |
pending/ | 预填充/追加消息后的重启锁 |
PROMPT-LAB-WORKSPACE-WARNING.md | 提醒 Agent 不要改这个目录 |
.prompt-lab-owner.json | 删除/清理操作的所有权标记 |
插件不会读取凭据,不会把提示词内容发送到任何服务器。所有数据都在本机;请自行备份重要模板。
兼容性与限制
- 支持 DSH
0.2.2-rc.2到0.2.2-rc.5;使用agent.ctx.systemPrompt.section()、tools.restrict()等接口。 clientModules.graph().release、systemPrompt.layers等 DSH 内部接口在后续版本可能变化;升级 DSH 后建议重新验证分段采样和工具开关。systemPrompt.layers仅作为兼容回退,不是稳定扩展契约。- 可能与其他提供提示词修改能力的插件冲突。
- 面板 UI 目前只有中文;locale 中的英文仅有标题和描述。
- 分段编辑对
completepreset 不生效。 - 工具开关只覆盖 global 工具;scoped/preset 工具不可在面板里控制。
- 没有云同步、跨设备同步或团队共享。
- 大文本库/消息库会一次性加载到面板;非常大的库可能变慢。
开发
仓库没有运行时 npm 依赖。
npm test
测试覆盖 Host 装配、API、草稿、迁移、预设/文本库、诊断、客户端 bundle smoke 和本版本的回归检查。
目录结构:
index.js Host 装配与生命周期
client.js Web 面板
lib/engine.js section 注册与装配采样
lib/store.js 数据存储
lib/api.js JSON API
lib/migrate.js 数据目录迁移
lib/pending.js 重启锁
lib/liveness.js 会话状态分类
lib/diagnostics.js 装配失败归因
locale/ 插件标题/描述
License
MIT。见 LICENSE。
Ähnliche Plugins
billion-context
ranxianglei/billion-context
dsh-web-ui (dsh-chat-recovery)
zhu1090093659/dsh-web-ui
dsh-synapse
liangmianya/dsh-synapse
dsh-archive-manager
michengai/dsh-archive-manager