@dsh-external/dsh-session-prompt
为 DeepSeek Harness 提供持久提示词注入。插件保留 DSH 原有的 Harness Identity、Agent Preset 和工具说明，并在其基础上增加可管理的全局层与工作区层。
仓库已经包含编译后的 lib/，普通用户和安装 Agent 不需要准备开发环境，也不需要先执行构建。
功能
- 全局默认提示词与当前工作区提示词可以同时启用；
- 每层可选择
System 或 User Context 身份；
- 每层可独立设置启用状态和排序值；
- 设置长期保存在 DSH 数据目录中，重启和上下文压缩后仍会重新装配；
- 设置界面可预览当前会话的段落顺序、来源与最终文本；
- 模型发起的修改必须经过 DSH 原生审批，不能静默改写设置；
- 支持多 profile 并发保护、revision 冲突检测和外部文件热重载；
- 提供版本化设置迁移、异常数据保护和恢复默认。
快速安装
方式一：直接从 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.4.0.tgz
安装 Agent 可以直接执行方式一；若环境禁止 Git 依赖，则下载仓库后执行方式二。无需修改 DSH 源码或手工复制 lib/。
使用
在会话输入栏右侧点击 Prompt 注入：
- 选择“全局默认”或“当前工作区”；
- 选择
System 或 User Context；
- 设置排序值、启用状态和正文；
- 保存，下一次模型请求生效；
- 展开装配预览，检查顺序、来源与最终文本。
“恢复默认”会恢复插件配置中的初始全局值；“移除覆盖”只删除当前工作区层。
模型可以调用 dsh_session_prompt_set 提议修改全局正文，但真正写入前必须经过 DSH 原生审批界面的人工确认。工具结果不会重复回显完整提示词。
注入身份
| 身份 | DSH 原生机制 | 行为 |
|---|
System | systemPrompt.section() | 每次模型请求时重新装配进真正的 system prompt；恢复会话或压缩上下文后仍然存在。 |
User Context | systemPrompt.context() | 生成带来源信息的 user-role runtime-context 快照；只在内容变化时投影新快照，不会每轮机械重复追加。 |
User Context 是 DSH 当前最接近“聊天中注入”的原生通道，但不是任意历史深度插入。插件不伪造 Assistant 消息，也不提供“倒数第 N 条消息”注入，以免破坏会话恢复、工具调用与消息配对。
层级与排序
全局层和工作区层可以同时生效。工作区层使用当前会话工作目录的规范化路径作为内部键，浏览器不能自行指定其他工作区路径。
排序值越小越靠前。参考顺序：
- Harness Identity：
-100
- Agent Preset / Persona：
0
- 插件全局层：
10
- 插件工作区层：
20
- DSH 工具说明：通常为
100–199
System 和 User Context 属于两个独立序列，排序值只在各自序列内比较。
设置与安全
设置保存在 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 请求；
- 外部文件变化会触发热重载；未知的新格式版本或超大文件进入只读保护；
- 单个无效层会保留可恢复正文但自动禁用，不影响其他有效层；
- 整份 JSON 损坏时，下次保存前会生成带时间标记的备份；
- DSH 会解释完整的双花括号模板变量。插件定位为纯文本注入，因此拒绝这种结构，避免未知变量导致后续模型请求失败。
提示词只能影响模型行为，不能保证任何模型百分之百遵循。
可选初始值
在 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 pack
PowerShell 可先设置同名环境变量，再执行这些命令。构建脚本会临时链接 DSH workspace 依赖；这些依赖不会进入仓库或发布包。
主要目录：
src/index.ts 宿主端：设置、注入、工具、API、预览
src/default-prompt.ts 内置默认提示词
src/client/index.ts 输入栏设置界面与预览
lib/ 已编译、可直接安装的发布产物
scripts/ 构建与冒烟测试
cordis.patch.yml DSH bundle 装配层
License
MIT
