DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

WinRNGS /

WinRNGS/dsh-session-prompt-standalone

Verified

dsh的提示词注入

★ 1 Stars0 Forks1 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@de6e51d0

@dsh-external/dsh-session-prompt

为 DeepSeek Harness 提供提示词综合编排。可排列和启停宿主正式开放的 System / User Context 提示词段,创建多个全局或工作区命名层,并查看当前装配预览。旧版单层自定义提示词继续保留;其他插件和 Agent 的正文覆盖默认锁定,必须完成两次确认才能写入。受保护方案被选中时,预览还要求页面级验证。

仓库已经包含编译后的 lib/,普通用户和安装 Agent 不需要准备开发环境,也不需要先执行构建。

当前 0.8.1 需要宿主提供下文列出的官方提示词、Connection 与 Web 身份校验接口。已知 DSH 0.1.0-rc.5 不满足这些 API 契约;兼容性以实际宿主 API 为准。若宿主缺少所需接口,请由用户或管理员决定升级,本插件不会自动升级 DSH。

0.8.1 受保护方案预览

选中受保护方案时,查看预览需要本页令牌和对应方案密码。方案库或应用状态变更后需要重新验证;如果先解锁再应用方案,可能会再要求验证一次。再次验证只确认密码,不写入方案库,不会触发重复变更。

只要当前作用域有已选中的受保护方案,管理页面会保守地隐藏全部装配预览和间接来源检查,旧版单层入口的预览也会隐藏;普通设置读取和编辑仍可用。此保护仅覆盖本管理器提供的页面预览,不能阻止宿主或其他插件在各自流程中独立读取模型请求内容。宿主正常投递所用的解锁状态仍按进程管理,与页面预览验证分开。

锁定、关闭页面、切换作用域或验证过期时,会撤销页面授权并清除本页尚未保存的私密表单和草稿,请先保存再锁定或离开。普通 revision 冲突(HTTP 409)会保留草稿,便于处理后重试。

0.8.0 全局暂停与其他来源检查

管理器顶部提供“暂停本管理器全部应用”,不需要先解锁高级编辑。它通过现有宿主认证、同源和版本检查,立即暂停本管理器在全部作用域的方案、命名层、正文覆盖、排序和旧版默认 Agent 注入;保留所有原配置和方案正文,不更改其他插件。恢复应用仍须完成现有高级编辑的两次确认。

暂停会锁回本进程的受保护模板。恢复不会自动解锁 No.0,需要重新输入密钥。暂停状态独立保存,重启后继续有效;暂停期间可以整理普通方案,但不会自动恢复投递。未知或损坏的开关文件保留且只读,按暂停处理。

暂停影响后续正式提示词装配,不会删除或改写已发送的会话历史、旧的上下文消息或模型已处理的内容。要排除历史影响,应使用新会话验证。

“其他提示词来源检查”列出本次可观察的原始与最终 System / User Context 段,包括其他监听器在本管理器之后新增的段落;可展开原文和最终内容、只看其他来源,并检查最终投递、配置覆盖、正文变化和文字重复。名称分类仅是来源线索,不能证明某个具体插件已安装;完整提示词或监听被绕过时会明确标记无法判定,不能把检查结果当作全部插件清单或语义冲突证明。该功能不自动关闭其他提供方。

0.7.0 方案库

在提示词管理器的“方案库”页保存和切换当前作用域的整套命名层、排序、启停与显式正文覆盖。方案不会把动态提供方的正文自动固定为快照。启用方案前,仍需完成现有高级编辑的双重确认;切换作用域时请核对全局与工作区的影响范围。

  • No.0:从用户提供的 dsh-purge 1.1.74 实际内置提示词槽提取的模板,正文加密分发,默认锁定。来源、原文摘要和原许可证/NOTICE 见 third-party/dsh-purge/。未迁移该项目的宿主补丁、审批/沙箱修改、红队平台或更新执行代码。
  • No.1~No.3:三个空白模板位置,可用当前作用域的整套编排填充;也可另存为新的自建方案。
  • 方案可复制、导入和导出。受保护方案及其副本保持加密和密码锁,导出文件不会包含明文提示词或密钥;普通自建方案的导出内容是明文,分享前应自行检查私人内容。
  • No.0 及其受保护副本只在本次宿主运行的内存中解锁;重启或显式锁定后需要重新输入密钥。锁定期间不投递其受保护正文,界面显示选中与锁定状态。
  • 内置模板修改需再次验证密钥,并明确确认“修改后可能失效”。自改版和内置原件分开保留,由用户选择采用内置版本或保留当前修改,不静默刷新用户正文。
  • 项目规则检测只读查看当前会话工作区的候选规则文件,核对其正文与实际装配段的精确/规范化匹配以及重复。匹配不等于证明提供方确实读取了该文件;未匹配也不等于证明文件未被处理。检测不自动删除、去重或改写规则文件。

固定共享密钥只提供本地使用门槛;校验值和提示词密文随软件分发,不能保证抵抗离线猜测或有权修改本地程序的人。源码、构建产物和运行时设置不保存明文密钥;解锁后的正文进入模型请求时,遵循 DSH 原有模型数据流。

功能

  • 在统一“提示词编排”页查看并管理当前装配中宿主公开的 System 和 User Context 段;两个身份使用独立顺序;
  • 对提示词段上移、下移、置顶、置底或启停,不会固定提供方动态正文;只有显式保存正文覆盖才会固定当次求值的文本;
  • 支持多个命名层,每层有稳定 ID、名称、System / User Context 身份、启用状态和正文;全局与工作区可分别定义;
  • 工作区按稳定 ID 覆盖全局命名层,可独立改变名称、身份、启用状态和正文;移除工作区定义后恢复继承全局定义;
  • 原有 dsh-session-prompt.json version 2 单层设置及“旧版单层编辑”入口继续保留;
  • 设置长期保存在 DSH 数据目录中,重启和上下文压缩后仍会重新装配;
  • 设置界面可预览当前会话的段落顺序、来源与最终文本;选中受保护方案时须先完成页面级验证,且会隐藏装配预览;
  • 正式 Settings → 提示词管理器与输入栏快捷入口共用同一界面;
  • 所有提示词编排写入默认锁定,包括排序、启停、命名层和正文覆盖;需先确认风险,再核对范围和恢复方式,并手动输入“解锁高级编辑”完成第二次确认;
  • 正文覆盖修改当前求值出的正文,不改提供方源码;高级编辑锁回或重启后,已保存编排和覆盖继续生效;
  • 模型发起的修改必须经过 DSH 原生审批,不能静默改写设置;
  • 支持多 profile 并发保护、revision 冲突检测和外部文件热重载;
  • 管理器设置从 version 1 兼容升级到 version 2;首次成功保存迁移前自动生成带时间戳的原文件备份,未知版本只读保护;
  • 提供版本化设置迁移、异常数据保护和恢复默认。

快速安装

方式一:直接从 Git 仓库安装

这是用户和安装 Agent 的推荐方式:

dsh plugin --profile web add "github:WinRNGS/dsh-session-prompt-standalone#main"

如果实际运行的是其他 profile,把 web 换成对应名称。安装完成后重启该 DSH profile。

方式二:下载后本地安装

gh repo clone WinRNGS/dsh-session-prompt-standalone
cd dsh-session-prompt-standalone
dsh plugin --profile web add .

Windows 上建议把仓库放在不含空格的目录中,以避开部分旧版 DSH CLI 转发本地路径时的参数解析问题。

方式三:安装打包文件

在仓库目录执行:

npm pack
dsh plugin --profile web add ./dsh-external-dsh-session-prompt-0.8.1.tgz

安装 Agent 可以直接执行方式一;若环境禁止 Git 依赖,则下载仓库后执行方式二。无需修改 DSH 源码或手工复制 lib/。

使用

打开 DSH Settings → 提示词管理器,或在会话输入栏右侧点击 提示词管理。设置页需要明确选择“查看的会话”;未选择时只显示全局与宿主预览。输入栏入口直接使用该会话。

在 提示词编排 页中:

  1. 选择“全局默认”或某个实时会话的“当前工作区”;工作区路径由所选 Agent 的真实 cwd 确定;
  2. 分别查看 System 与 User Context 两组段落,并用置顶、上移、下移、置底或启停按钮编排;两种身份的顺序彼此独立;
  3. 需要自定义内容时创建命名层,填写名称、身份、启用状态和正文;系统生成稳定 ID,同一 ID 可在工作区定义独立覆盖;
  4. 展开预览,核对来源、编排顺序、实际投递状态和最终文本。

排序或启停只保存顺序/启用状态,不会把提供方当前生成的正文复制下来。若需要固定某次求值内容,请显式保存正文覆盖;该操作会以当前正文替换动态提供方文本。所有这些写操作默认锁定,必须阅读并确认风险、核对影响范围和恢复方式,再手动输入“解锁高级编辑”完成第二次确认。确认挑战和编辑令牌只在内存中保存;切换会话或作用域、认证失败(401/403/423)及服务端重启会锁回编辑权限,已保存内容仍继续装配。

工作区命名层按稳定 ID 覆盖全局定义,因此可以单独更改名称、身份、启用状态和正文。删除工作区定义后会恢复继承同 ID 的全局定义;如果没有全局定义,则该层不再存在。工作区的命名层定义、显式顺序和正文/启停覆盖分别优先于全局。

当当前会话的工作区用同一 ID 把全局命名层改成另一种身份时,Settings 中仍选着该会话而正在编辑“全局默认”,相关身份组的置顶、上移、下移、置底会暂时停用,避免把工作区有效段排进全局的错误身份序列。需要调整全局顺序时,在 Settings 取消“查看的会话”选择后再编排;也可切换到该会话工作区修改本地顺序。

旧版单层编辑入口保留 dsh-session-prompt.json version 2 自定义层与原模型审批工具的兼容路径。统一编排中的重置不会删除这份旧设置;“恢复默认”会回到 bundle 配置中的初始全局值,“移除覆盖”只清除当前作用域对应的旧单层。

提示词管理器也提供其他插件 / Agent 段落的只读预览,显示来源、身份、原件与最终文本及实际位置。高级正文覆盖保留提供方的变量解释方式:已启用模板插值的段使用当前可用的 {{变量}},未知变量会被拒绝;不插值的段保留字面文本。工具指导文本可编排或覆盖,但工具 schema 不在此处修改。宿主完整 complete 系统提示词、空或无效原件,以及当前模式下求值为空 / inactive 的 provider 不会被普通正文覆盖激活;完整 complete 的系统段和系统顺序仍由宿主保护。原件与最终位置是同身份列表中的位置,不是提供方注册排序值。

模型可以调用 dsh_session_prompt_set 提议修改全局正文,但真正写入前必须经过 DSH 原生审批界面的人工确认。工具结果不会重复回显完整提示词。

注入身份

身份 旧版单层入口的注册机制 行为
System systemPrompt.section() 每次模型请求时重新装配进真正的 system prompt;恢复会话或压缩上下文后仍然存在。
User Context systemPrompt.context() 生成带来源信息的 user-role runtime-context 快照;只在内容变化时投影新快照,不会每轮机械重复追加。

新命名层通过正式的 system-prompt/assemble 机制加入当前装配的 sections 或 contexts;上表描述的是旧版单层设置入口。User Context 是 DSH 当前最接近“聊天中注入”的原生通道,但不是任意历史深度插入。编排只作用于宿主本次正式公开并参与装配的提示词段,不承诺覆盖所有隐藏提示词、任意历史消息或某条历史位置。插件不伪造 Assistant 消息,也不提供“倒数第 N 条消息”注入,以免破坏会话恢复、工具调用与消息配对。

编排范围与顺序

全局默认和工作区编排可以同时存在。工作区顺序、命名层定义及正文 / 启停覆盖按各自规则优先于全局;工作区以当前实时 Agent 工作目录的规范化路径作为内部键,浏览器不能自行指定其他路径。每个作用域都对 System 与 User Context 分别保存顺序,重置其中一组不会重置另一组。

新编排页的顺序按钮直接排列本次装配列表。旧版单层设置仍使用自身的排序值;该字段不会取代新编排页中按身份保存的显式顺序。

设置与安全

自定义层设置以明文 JSON 保存在本地 DSH 数据目录的 dsh-session-prompt.json 中。当前格式版本为 2:

{
  "version": 2,
  "global": {
    "enabled": true,
    "prompt": "全局规则",
    "role": "system",
    "order": 10
  },
  "workspaces": {
    "normalized-workspace-key": {
      "path": "workspace-path",
      "enabled": true,
      "prompt": "项目规则",
      "role": "user-context",
      "order": 20
    }
  }
}
  • 单段正文上限 256 KiB,请求体上限 1 MiB,设置文件上限 4 MiB;
  • 最多保存 512 个工作区层;
  • 写入使用临时文件与原子替换,并用跨 profile 文件锁保护;
  • API 使用 revision 与 If-Match 检测陈旧草稿,冲突返回 409;
  • 写入要求 JSON 请求,并使用 revision / If-Match 检测陈旧草稿;这些格式与并发检查不代表用户身份认证;
  • 外部文件变化会触发热重载;未知的新格式版本或超大文件进入只读保护;
  • 单个无效层会保留可恢复正文但自动禁用,不影响其他有效层;
  • 整份 JSON 损坏时,下次保存前会生成带时间标记的备份;
  • DSH 会解释完整的双花括号模板变量。插件定位为纯文本注入,因此拒绝这种结构,避免未知变量导致后续模型请求失败。

旧版单层提示词与新命名层都按纯文本处理,并拒绝 DSH 双花括号变量模板;对其他 provider 正文的显式覆盖则保留该 provider 原有的变量解释模式。

编排、命名层和正文覆盖独立保存在同一数据目录的明文 JSON 文件 dsh-prompt-manager.json(version 2),不会迁移或覆盖原有 dsh-session-prompt.json version 2 单层设置。管理器可读取 version 1;首次成功写入时升级为 version 2,并先在同目录创建原文件字节备份 dsh-prompt-manager.json.<时间戳>.V0.01,写入时请求 0600 mode。实际访问权限取决于运行平台和目录 ACL,不能据此保证 Windows 上获得等价权限。未知版本或字段进入只读保护,不覆盖原文件。0.5.0 管理器不理解 version 2;若要回退到旧版,必须由用户明确选择并恢复相应迁移备份。

管理器设置使用原子写入、revision、跨进程锁和文件热重载。WebServer 模式下,旧单层 API 与管理器 API 两类正式提示词 HTTP 接口均经过 DSH 标准 requestRejection 与连接 Cookie 身份校验,复用宿主已有凭证,不需要额外插件密码或 API Key;管理器 Web 写操作还检查真实 socket 是否为 loopback、请求来源是否同源,并要求两次人工确认。没有 WebServer 的宿主通过官方 @deepseek-ai/dsh-client-connection 本地 Connection carrier 提供标准本地路径;本地 Fetch 适配使用 POST /delete 以兼容不支持 DELETE 的 Connection 契约。协议标记、请求头、revision 或来源字符串本身都不授予权限。服务端重启会清除编辑授权,但继续装配已保存内容。

两次确认是降低误操作风险的操作门槛,不是登录、身份认证或模型安全沙箱;loopback、同源和宿主连接校验也不构成绝对安全保证。提示词仍由用户配置的模型服务按正常模型请求处理。

提示词只能影响模型行为,不能保证任何模型百分之百遵循。

数据流与隐私边界

  • 两份设置文件都以明文 JSON 保存在本地 DSH 数据目录。它们可包含自定义提示词、高级覆盖正文及工作区路径;插件不会对这些文件内容加密。
  • 如果 dsh-session-prompt.json 损坏,插件会在下一次保存前保留原文件的带时间标记备份;管理器 version 1 首次成功迁移到 version 2 时也会备份原文件。两类备份都包含原始 JSON,可能含私密提示词或工作区路径;迁移备份写入时请求 0600 mode,实际权限依运行平台与父目录 ACL,项目 .gitignore 会排除 dsh-prompt-manager.json.*.V0.01。
  • 管理器预览在可查看时会展示其他插件或 Agent 的原件、渲染文本、最终文本以及会话对应的工作区路径;这些内容可能敏感,请谨慎复制、截图或分享。选中受保护方案时,页面会隐藏装配预览和间接来源检查;该限制不阻止宿主或其他插件独立读取正常模型请求内容。
  • 插件装配的 System / User Context 内容会作为正常 DSH 模型请求的一部分发送至用户配置的模型服务。插件源码审查未发现本插件主动进行额外第三方上报或遥测;这不涵盖 DSH 宿主、其他插件、依赖或模型服务自身的数据处理。
  • 两类提示词 HTTP 接口复用宿主标准连接 Cookie 身份校验;管理器写入另外要求真实 loopback socket、同源来源和两次人工确认。没有 WebServer 时只使用正式 Connection carrier 的本地路径。任何不满足预期传输或认证契约的请求都应拒绝,不将自定义 headers 或协议标记当作权限凭证。
  • 双确认仅用于降低误操作风险,不是身份认证或模型沙箱;认证与传输检查不能保证模型遵守提示词,也不提供绝对安全保证。

兼容性与验证范围

  • 兼容性以宿主 API 契约为准,而不是仅凭 Desktop 外壳版本推定;宿主必须提供官方 SystemPrompt、Connection,以及 WebServer 模式下的标准连接认证能力。
  • 已知 DSH 0.1.0-rc.5 缺少这些所需契约。其他宿主版本按实际提供的官方 API 判断;若当前宿主缺少所需接口,需要由用户或管理员决定升级,插件不会自动升级,也不承诺未经验证的版本区间。
  • 第三方 DSH Desktop 2.0.9(内嵌 DSH 0.1.5-rc.1)此前的只读 UI 检查属于 0.5.0,不代表 0.8.1 的写入、认证或桌面兼容性验收。
  • DSH 0.1.6-alpha.1 是本地隔离门禁所用宿主 checkout;该环境中的构建和合成数据测试不等同于正式 Windows 窗口端到端或真实用户数据写入。
  • 尚未在官方 DSH 0.1.6-alpha.1 Windows 桌面窗口上做 0.8.1 端到端验证,也未完成真实用户数据的写入矩阵;不能据此宣称所有宿主版本、桌面窗口、隐藏提示词或任意历史消息均已验证。

可选初始值

在 bundle 配置中设置初始全局提示词:

- insert:
    - id: dsh-session-prompt
      name: '@dsh-external/dsh-session-prompt'
      config:
        prompt: '你的初始全局提示词'

设置文件优先于该初始值。“恢复默认”会回到此值;未配置时使用插件内置文本。

更新与卸载

更新时重新执行对应的安装命令,然后重启 DSH。设置文件独立于插件包,正常更新不会清除已有提示词。

卸载请使用 DSH 自身的插件管理命令。卸载插件不会自动删除设置文件,便于重新安装后恢复;如需彻底清理,应由用户自行确认后删除该设置文件。

开发与验证

只有修改 TypeScript 源码时才需要一份已经安装依赖的 DSH checkout:

DSH_CHECKOUT=<path-to-dsh-checkout> npm run typecheck
DSH_CHECKOUT=<path-to-dsh-checkout> npm run build
npm run test:smoke
npm run test:manager
npm run test:client
npm run test:client -- --local
DSH_CHECKOUT=<path-to-dsh-checkout> npm run test:transport
npm run test:library
npm run test:library-integration
npm run test:library-client
npm run test:library-client -- --local
npm run test:application
npm run test:application-integration
npm run test:application-client
npm run test:application-client -- --local
npm pack

方案库和应用的受保护模板回归使用 scripts/synthetic-builtin-test-helper.mjs 在测试进程中生成随机密码与加密合成模板;无需生产密钥、No.0 密文或 DSP_TEST_PASSWORD,不会改写生产模板。本次隔离验证使用 Node 24.19.0 和当前本地 DSH checkout;这不代表未经修改的官方 SDK,也不等同于 Windows 桌面端端到端测试。

PowerShell 可先设置同名环境变量,再执行这些命令。构建脚本会临时链接 DSH workspace 依赖;这些依赖不会进入仓库或发布包。

主要目录:

src/                  宿主端设置、注入、方案库、预览、应用状态和来源检查
src/client/           Web / 本地 Connection 适配、管理器与方案库界面
lib/                  已编译、可直接安装的发布产物
scripts/              构建、冒烟、管理器、客户端、传输、方案库与应用测试
cordis.patch.yml      DSH bundle 装配层
third-party/          No.0 模板来源声明及原许可证、NOTICE

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit de6e51d0dd4d

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout