dsh-prompt-inject

English | 中文

DeepSeek Harness（DSH）的会话级系统提示词注入器：每个会话可独立选择一段注入到系统提示词的文本（渲染在 persona 之后、工具引导之前）。

社区项目——非 DeepSeek 官方插件，不代表 DeepSeek 背书。

功能特性

• 按会话注入——每个会话独立选择模板（或「无」），不同会话互不干扰。section 从 agent.ctx 注册（cordis caller 绑定 → 该会话的 scope 层），只影响顶层会话。
• 模板库——保存/编辑/删除命名模板（name + text + order）；可设默认模板，新会话自动套用。
• 输入框工具行下拉——「会话提示词」选择器（conversation.input.right 插槽）直接在输入行为当前会话挑选模板，无需敲命令。
• 设置页两个区块——设置 →「会话提示词模板」管理模板库与新会话默认模板；设置 →「系统提示词」是只读查看器，展示任意 live 会话完整组装出的系统提示词。
• 分层查看——按来源分组：全局层（所有模式共有）、preset 层（该模式专有段）、会话层（仅本会话）、注入段（本插件自定义）——每段带名称、order、字数。
• 变量插值——模板文本支持 {{model}} / {{cwd}}。
• 运行中即时生效——切换模板 = dispose 旧段 + 注册新段，该会话下一个模型请求生效，无需重启。
• 验证端点——GET /assemble 返回实际组装出的系统提示词，并在 preset 锁定提示词时如实报告 completeBlocksInjection。
• 多入口——/prompt 命令、prompt_inject 工具、HTTP API、UI 全部驱动同一份配置。

安装

这是 bundle 型插件：运行在 DSH web profile 进程内，注册宿主端服务 + web 客户端模块。需要 DSH web profile（@deepseek-ai/dsh-web-app）。

1. 克隆或下载本仓库：

   git clone https://github.com/WASD258-jpg/dsh-prompt-inject.git

2. 安装进 DSH profile 依赖目录（二选一）：

   Option A：npm 安装（推荐）

   cd "$env:USERPROFILE\.dsh\profiles"
   npm install @wasd258/dsh-prompt-inject --no-save

   Option B：从源码复制

   $src = '.\dsh-prompt-inject'
   $dst = "$env:USERPROFILE\.dsh\profiles\node_modules\@wasd258\dsh-prompt-inject"
   New-Item -ItemType Directory -Force -Path "$dst\lib" | Out-Null
   Copy-Item "$src\package.json", "$src\lib\index.js", "$src\lib\client.js", "$src\LICENSE", "$src\NOTICE" $dst -Force

   Linux/macOS 请把 $env:USERPROFILE\.dsh 换成 ~/.dsh（或 $DSH_HOME）。

3. 把包加入 profile 的 bundle 列表——在 $DSH_HOME/profiles/<profile>/package.json（如 web）的 dsh.profile.bundles 数组追加 "@wasd258/dsh-prompt-inject"：

   {
     "name": "dsh-profile-web",
     "private": true,
     "dependencies": {},
     "dsh": {
       "profile": {
         "bundles": [
           "@deepseek-ai/dsh-base",
           "@deepseek-ai/dsh-web-app",
           "@wasd258/dsh-prompt-inject"
         ]
       }
     }
   }

4. 重启 DSH web（或热装配 bundle），然后刷新浏览器页面加载客户端模块（lib/client.js——immediately: true，页面加载即注册进 slots 系统）。输入框工具行出现「会话提示词」下拉，设置页出现两个新区块。

使用

命令

在任意会话中执行：

| 命令 | 说明 | |---|---| | /prompt（或 status/list/?） | 查看当前会话提示词、默认模板与模板库 | | /prompt use <模板id\|none> | 当前会话应用 / 移除模板 | | /prompt save <名称> <文本> | 保存模板（名称须为不含空格的一个词；其余整行作为文本） | | /prompt delete <模板id> | 删除模板（若为默认模板则同时清除） | | /prompt default <模板id\|none> | 设置 / 清除新会话默认模板 |

示例会话（输出与插件实际输出一致；模板 id 自动生成：名称 slug 化 + 4 位 base36 时间戳后缀，如 code-reviewer-9k2m）：

/prompt
当前会话提示词：「Code Reviewer」（code-reviewer-9k2m）
默认模板：（无）
模板库：
  code-reviewer-9k2m「Code Reviewer」(120 字) ← 当前会话
  safety-auditor-1b7e「安全审查员」(85 字)

用法：
  /prompt use <模板id|none>       —— 当前会话应用 / 移除模板
  /prompt save <名称> <文本>      —— 保存新模板
  /prompt delete <模板id>         —— 删除模板
  /prompt default <模板id|none>   —— 设置新会话默认模板

/prompt use code-reviewer-9k2m
当前会话已应用「Code Reviewer」（下一轮生效）。
/prompt use none
当前会话已移除提示词（下一轮生效）。
/prompt save 安全审查员 You are a strict safety auditor.
模板已保存：安全审查员-abc1「安全审查员」
使用：/prompt use 安全审查员-abc1
/prompt delete safety-auditor-1b7e
模板已删除：safety-auditor-1b7e
/prompt default code-reviewer-9k2m
默认模板已设置：code-reviewer-9k2m（此后新会话自动应用）。
/prompt default none
已清除默认模板。
/prompt use missing-id
模板不存在：missing-id（/prompt list 查看）

UI 操作

• 输入框工具行 →「会话提示词」下拉：为当前会话挑模板（「提示词：无」= 不注入）。选择立即应用、下一轮请求生效；下拉每 5 秒向服务端刷新一次。
• 设置 →「会话提示词模板」：新建 / 编辑 / 删除模板（删除带确认）并设置新会话默认模板。
• 设置 →「系统提示词」：选一个 live 会话，按层（全局 / preset / 会话 / 注入）查看完整组装出的系统提示词；若该会话 preset 是 complete persona，显示琥珀色警告说明注入不生效。

prompt_inject 工具

模型自己也能通过 prompt_inject 工具管理提示词（"Per-session system prompt injection… Changes take effect on the NEXT model request of that session"）：

| action | 必填参数 | 效果 | |---|---|---| | get | — | 当前会话模板、默认模板、完整模板库 | | apply | templateId（"none" 解除） | 设置 / 解除当前会话模板 | | save | name、text；可选 templateId、order | 新建模板；templateId 命中已有模板则更新 | | delete | templateId | 删除模板 | | default | templateId（"none"/"" 清除） | 设置新会话默认模板 |

HTTP API

宿主端在 /api/dsh-prompt-inject 下注册路由：

| 方法 | 路径 | 说明 | |---|---|---| | GET | /status?sessionId= | 会话当前模板 + 默认模板 + 模板库（sessionId 可选） | | GET | /assemble?sessionId= | 完整组装出的系统提示词 + 分层明细 + complete persona 检测 | | GET | /sessions | 运行中的（顶层）会话及 preset id | | POST | /apply | {"sessionId","templateId"} —— 给会话应用模板 | | POST | /save | {"name","text","id"?,"order"?} —— 新建/更新模板 | | POST | /delete | {"id"} —— 删除模板 | | POST | /default | {"templateId"} —— 设置新会话默认模板 |

GET /status

GET /api/dsh-prompt-inject/status?sessionId=abc123

{ "ok": true, "sessionId": "abc123", "current": "code-reviewer-9k2m", "currentName": "Code Reviewer", "defaultTemplate": "", "templates": [{ "id": "code-reviewer-9k2m", "name": "Code Reviewer", "text": "You are a strict code reviewer…", "order": 1 }] }

GET /assemble

GET /api/dsh-prompt-inject/assemble?sessionId=abc123

{ "ok": true, "sessionId": "abc123", "presetId": "standard", "presetName": "Standard",
  "length": 3842, "injectedLength": 120, "injected": "You are a strict code reviewer…",
  "complete": null, "completeBlocksInjection": false,
  "sections": [
    { "name": "persona", "order": 0, "text": "…", "layer": "global", "category": "system" },
    { "name": "tool-guidance", "order": 100, "text": "…", "layer": "standard", "category": "system" },
    { "name": "prompt-inject", "order": 1, "text": "…", "layer": "agent", "category": "injected" } ],
  "prompt": "…" }

sections 是逐段明细：layer 为 global / preset id / agent；category 为 injected（本插件自定义段）或 system。遇到 complete persona preset 时，响应含 complete: "<段名>" 且 completeBlocksInjection: true。

错误情况

| 条件 | 状态码 | 响应体 | |---|---|---| | 非回环来源 | 403 | {"ok":false,"error":"prompt-inject API is loopback-only"} | | Host 头非法 | 403 | {"ok":false,"error":"invalid host header"} | | 跨域 POST | 403 | {"ok":false,"error":"cross-origin request rejected"} | | Content-Type 非 JSON | 415 | {"ok":false,"error":"Content-Type 必须是 application/json"} | | JSON 无效 / 请求体超限（上限 128 KiB） | 400 | {"ok":false,"error":"请求体不是有效 JSON"} | | 未知路由 | 404 | {"ok":false,"error":"unknown route: <route>"} | | 会话不在运行（/assemble、/apply） | 404 | {"ok":false,"error":"会话 <id> 不在运行中"} | | 模板不存在 / 入参非法（业务错误） | 200 | {"ok":false,"error":"模板不存在：<id>"}（或 name 不能为空、文本过长（上限 65536 字符）） |

工作原理

• agent 作用域注入——agent/created 时按 sessions[id] ?? defaultTemplate 解析该会话模板，从 agent.ctx 注册 prompt-inject section；cordis caller 绑定让段落落在该 agent 的 scope 层，只影响这一个会话。只注入顶层（root）会话，agent/disposed 时自动清理。
• 运行中切换——applyForSession 先 dispose 旧段再注册新段；section 的 text 是函数，每次组装动态求值，所以下一轮请求即生效——无需重启。
• 持久化——配置存于 $DSH_HOME/dsh-prompt-inject.json（templates、sessions、defaultTemplate），原子写入（临时文件 + rename）；resume/重启后 agent 重建，选择自动重新应用。
• 排序与变量——模板默认 order: 1（persona 在 0、工具引导在 100+）；文本支持 {{model}} / {{cwd}}；空文本段自动从组装中消失。
• KV 缓存说明——注入文本进入该会话每个请求的系统提示词；修改会改变 KV 缓存前缀，下一轮缓存复用失效——这是修改的正常代价。
• 宿主端——注入 systemPrompt、tools、commands、agents、webServer；web 端注入 slots 系统（conversation.input.right + 两个 settings.section）。

隐私与安全

• 威胁模型——本 API 设计上无鉴权，只服务本机：任何本地进程都能读取组装出的系统提示词与模板库，并能驱动写操作。请在可信的本机环境运行 DSH；不要把 DSH 绑到公网接口并指望本插件防护——回环校验是纵深防御，不是认证边界。
• 仅限回环——来源地址必须是 127.0.0.1、::1 或 ::ffff:127.0.0.1，否则直接 403。
• 防 DNS rebinding——Host 头必须是当前端口的回环主机名（无 Host 头回退到地址校验）。GET /assemble 可能返回敏感数据，因此 GET/POST 一视同仁。
• 写操作防跨站——POST 额外要求同源 Origin 头 + Content-Type: application/json，阻止恶意网页驱动修改。
• 无遥测——不发起外部请求、不采集统计、不读写凭据。配置明文落盘在 $DSH_HOME/dsh-prompt-inject.json；模板本身可能敏感，请保护好 home 目录。
• 请求体上限 128 KiB（131072 字节）。

兼容性

• 需要 DSH（DeepSeek Harness）web profile（@deepseek-ai/dsh-web-app）。
• Node.js >= 22.19.0。当前版本 0.1.1（npm 包名 @wasd258/dsh-prompt-inject）。
• 官方仓库 commit 47f9438 时代实测（bundle 接口、web profile、Windows 11）。
• complete persona 边界——persona 配置 complete: true 的 preset（如 minimal、anchored-standard）会把系统提示词锁定为唯一段：注入对这类会话不生效。/assemble 通过 completeBlocksInjection 如实报告，设置页查看器显示琥珀色警告。请使用非 complete 的 preset（Standard、Creator…），或把文本写进 preset 的 persona。
• 查看器默认优先选中非 complete 会话（这类会话才能看到有意义的注入结果）。

官方生态要求

按 DeepSeek Harness CONTRIBUTING，官方仓库不接受外部 PR；社区插件放在各自仓库并添加 dsh-plugin topic。本仓库遵循此约定：独立社区项目，与 DeepSeek 无隶属或背书关系。

许可

MIT —— 见 LICENSE。部分内容参考 DeepSeek Harness；来源与免责声明见 NOTICE。