会话头部提示词 masknull/dsh-session-prompt

dsh-session-prompt

DeepSeek Harness 插件：在每个会话的系统提示词最顶部注入自定义提示词，并可在 Web 设置页中即时编辑。

A DeepSeek Harness plugin that injects a user-configured custom prompt at the very top of every session's system prompt, editable live from the web settings page.

- 注入位置 Where it lands：每次模型请求组装系统提示词时的第一节（order: -200，位于内置身份 -100 与角色设定 0 之前）——所有会话、每一次请求。
- 界面 GUI：设置页「插件配置」标签中的一张卡片，含启用开关、多行提示词编辑、保存/放弃、恢复默认。
- 即时生效 Live：提示词文本在每次组装时读取最新设置，保存后对下一次请求立即生效，无需重启。

中文文档

环境要求

- 安装了 Web UI 的 DSH 实例（含 profile 与用户设置提供方），且 dsh CLI 在 PATH 中。
- 版本 v0.2.3 起要求 DSH ≥ 0.1.7-rc.1（本版起仅支持 0.1.7 线：0.1.5 的兼容路径——插件 tab 的 settings.plugin.item 座位、settingsScope 控制器、legacy settings.yaml 迁移链——已全部移除）。在更老的宿主上本插件无法加载；DSH 0.1.5-rc.x 线请使用 v0.2.2，dsh-v0.1.2-alpha.1 ~ 0.1.4.x 请使用 v0.2.0，更早的宿主请使用 v0.1.x。

安装

本包自带构建产物（lib/），从 Git 安装无需构建脚本、无需构建放行：

dsh plugin --profile <你的profile名> add github:masknull/dsh-session-prompt

该命令会链接包、记入依赖，并因包声明了 dsh.bundle 而自动加入 profile 的 bundle 列表。重启 DSH 使新的 bundle 层生效，然后打开 Web 界面。

供应链安全可固定提交：github:masknull/dsh-session-prompt#<commit sha>。

使用

1. 打开 设置 → 插件配置；
2. 展开「会话头部提示词」卡片；
3. 勾选 启用注入，编辑 提示词内容，点 保存。

说明：

- 提示词注入到每个会话（全局根 section），不是单会话。
- 关闭开关或提示词为空时不注入任何内容。
- {{…}} 限制：系统提示词渲染器会对 {{变量}} 做严格模板插值，遇到未注册或格式错误的组会直接报错；本插件会在保存时拒绝包含完整 {{…}} 组的文本，保证坏提示词永远不会弄坏请求。单独的 {{（无闭合 }}）是字面量，允许。

卸载

dsh plugin --profile <你的profile名> remove dsh-session-prompt

如曾手工把配置行加进 profile 的 cordis.patch.yml，请一并删除。

从源码构建

git clone https://github.com/masknull/dsh-session-prompt
cd dsh-session-prompt
npm install # 仅开发依赖:tsdown
npm run bundle # 产出 lib/index.js(宿主半区)+ lib/client.js(浏览器半区)
npm run smoke # 冒烟:验证宿主 apply() 与 section 文本 provider

lib/ 已提交进仓库；改动 src/ 后请连同重建产物一起提交。

npm run smoke 需要能解析 @deepseek-ai peer 依赖的环境（即已安装进 profile 的副本）；在裸克隆中运行会给出提示而非崩溃。

目录结构

dsh-session-prompt/
├── package.json # dsh.bundle + dsh.client 声明;运行时依赖仅为 peer ├── cordis.patch.yml # bundle 补丁:插入插件行(含默认配置) ├── tsdown.config.ts # 自包含的双半区构建 ├── smoke.mjs # 宿主半区冒烟测试 ├── src/ │ ├── index.js # 宿主半区:设置注册 + 头部提示词 section │ └── client/ # 浏览器半区:设置卡片 └── lib/ # 构建产物(已提交)

宿主半区的运行时依赖（@deepseek-ai/cordis、@deepseek-ai/schemastery、@deepseek-ai/dsh-settings）声明为 peer dependencies，由 DSH 宿主解析——插件不携带、不遮蔽宿主包。

许可证

MIT

English Documentation

Requirements

- A DSH installation that hosts the web UI (a profile and the user-settings provider must be present), and the dsh CLI on PATH.
- v0.2.3+ 要求 DSH ≥ 0.1.7-rc.1（本版本只支持 0.1.7 这一线：0.1.5 的兼容面——插件页签的 settings.plugin.item 座位、settingsScope 控制器，以及旧版 settings.yaml 迁移链——已全部移除）。旧版宿主无法加载本插件；DSH 0.1.5-rc.x 线请用 v0.2.2，dsh-v0.1.2-alpha.1 ~ 0.1.4.x 请用 v0.2.0，更早的版本请用 v0.1.x 线。

安装

包里已经带了构建好的产物（lib/），所以用 git 安装不需要构建脚本，也不需要构建授权：

dsh plugin --profile <your-profile> add github:masknull/dsh-session-prompt

这条命令会链接包、把它记为依赖，并且——因为包里声明了 dsh.bundle——把它追加到配置档的 bundle 列表。重启 DSH 让新的 bundle 层生效，然后打开 Web UI。

可选：钉住某个 commit，保证供应链卫生：github:masknull/dsh-session-prompt#<sha>。

使用

1. 打开 Settings → Plugin configuration。
2. 展开 Session head prompt 卡片。
3. 打开 Enable injection，编辑 Prompt text，然后 Save。

注意：

- 提示词会注入到每一个会话（属于根级全局 section），不是按对话注入。
- 提示词为空，或开关关闭，就什么都不注入。
- {{…}} 限制：系统提示词渲染器会插值严格的 {{variable}} 引用，遇到未知或格式错误的组会抛错。插件拒绝保存含有完整 {{…}} 组的文本，所以坏提示词永远不会弄坏请求。只有 {{ 没有闭合的 }}，算普通文本，允许保存。

卸载

dsh plugin --profile <your-profile> remove dsh-session-prompt

如果你之前手动往配置档的 cordis.patch.yml 里加过这一行，也把它删掉。

从源码构建

git clone https://github.com/masknull/dsh-session-prompt
cd dsh-session-prompt
npm install # dev-only: tsdown
npm run bundle # -> lib/index.js (host half) + lib/client.js (browser half)
npm run smoke # sanity-checks the host half's apply() and section provider

lib/ 已经提交进仓库，所以贡献者可以改 src/，再把重新构建的产物一起提交，留给下个版本。

npm run smoke 需要一个能解析 @deepseek-ai peer 依赖的环境（也就是装进配置档里的那份副本）；在裸克隆上它只会打印提示，不会崩。

目录结构

dsh-session-prompt/
├── package.json # dsh.bundle + dsh.client declarations, peer-only deps
├── cordis.patch.yml # bundle patch: inserts the plugin row with default config
├── tsdown.config.ts # self-contained build for both halves
├── smoke.mjs # host-half smoke test
├── src/
│ ├── index.js # host half: settings registration + head prompt section
│ └── client/ # browser half: settings card
└── lib/ # built artifacts (committed)
宿主侧的运行时依赖（@deepseek-ai/cordis、@deepseek-ai/schemastery、@deepseek-ai/dsh-settings）声明为 peer dependencies，由 DSH 宿主解析——插件不会自带或遮蔽宿主包。

许可证

MIT