思考语言锁定 wqzhellohhwy/dsh-system-prompts

dsh-system-prompts

DSH 的系统提示词管理器：在设置面板里新增 / 编辑 / 排序 / 删除多条 system 提示词段，保存即生效。
随包预置一条「用简体中文思考」——也就是 1.x 的全部功能，现在你可以改它、也可以再加别的。

设置面板 →「系统提示词」→ 管理页面每条提示词 = 一个独立的 system 提示词段，按顺序拼在 harness 身份之后、部署 persona 之前。

这是什么

DSH 的 system 提示词不是一份静态文件，而是运行时按 order 拼装的：各插件往 ctx.systemPrompt 注册自己的段，按顺序值升序拼接后，作为 system 角色消息写进会话历史。

本插件把这件事变成一个可在界面上管理的列表：

- 设置面板左侧多出一项「系统提示词」，点进去就是管理页面；
- 每条提示词有：标题（仅用于辨认）、正文、启用开关、顺序、删除；
- 支持新增任意多条、上下移动、批量保存；
- 保存后立即生效——当前会话的下一轮请求就带上新内容，不需要重启 DSH。

1.x → 2.0 的变化

| | 1.x（语言钩子） | 2.0（系统提示词管理） |
| 段数 | 固定 1 段 | 任意多条，可增删 |
| 配置方式 | 改 profile 的 cordis.patch.yml | 设置面板里点（仍兼容旧的 config 写法） |
| 生效方式 | 改配置后重启实例 | 保存即生效 |
| 默认行为 | 注入「用中文思考」 | 同左（预置为第一条，可改可删） |

升级到 2.0 不会改变默认行为：首次运行会把「用中文思考」那一条写进配置文件。

安装

方式 A：本地目录 link（开发/改完即生效）
dsh plugin --profile web add "link:D:/dsh-plugins/dsh-system-prompts"

方式 B：直接从 GitHub 装
dsh plugin --profile web add "github:wqzhellohhwy/dsh-system-prompts"

方式 C：装了 dsh-super-injector 的环境，运行时热装配（免重启） dev_install_package <本仓库绝对路径> profile=<你的 profile>

装完重启该入口（桌面版 = 完全退出重开；web 端 = 重启后刷新页面 Ctrl+F5），设置面板就会出现「系统提示词」。

桌面版（Electron）用的是 desktop profile，而 dsh plugin --profile desktop 会被 CLI 拒绝（该 profile 由桌面应用专属管理），需要走桌面版自己的插件界面。

⚠️ 从旧名 dsh-thinking-language 升级

本插件原名 dsh-thinking-language，因 2.0 起已泛化为系统提示词管理器而更名。
GitHub 仓库已重命名（旧地址自动 301 跳转，老链接仍可用），包名变了，所以 profile 里的装配 id 与依赖名也要跟着改：

1) 依赖名 + profile 的 bundles 列表：dsh-thinking-language → dsh-system-prompts （改 <DSH_HOME>/profiles/<你的 profile>/package.json 的 dependencies 与 dsh.profile.bundles）
2) node_modules 里的 junction 重建为新名
3) 重启该入口

不需要迁移数据：配置文件名仍是 <DSH_HOME>/system-prompts.json，默认条目 id 仍是 thinking-language，段名与设置页 id 也都没动——换句话说，改名只影响「包怎么被装上」，不影响「已经配好的提示词」。

用法

1. 打开 设置 → 左侧「系统提示词」；
2. 「＋ 新增提示词」加一条，填标题与正文；
3. 段名可改：每条卡片上有一个 system-prompt: 输入框，直接改后半段（见下）；
4. 用卡片上的「启用 / 停用」开关控制这一条是否注入，用 ▲▼ 调顺序，用「删除」移除（两步确认）；
5. 点「💾 保存并生效」。状态栏显示「✅ 已保存并生效」即完成。

⚠️ 哪些是实时的，哪些要保存？

本插件没有"实时生效"的改动——全部要保存。 页面上唯一的落盘入口是顶部的「💾 保存并生效」。在你点它之前：

- 段名、标题、正文、顺序、启用/停用开关的改动都只是本页草稿，既没写进配置文件，也没重新注册提示词段；当前会话的下一轮请求还是旧内容；
- 顶部会显示「有未保存的改动」，且「保存并生效」按钮此时才可点（未改动时是灰的）；
- 每条段名输入框旁会出现 ⏳ 未保存（只在有改动时出现；没改动时不显示任何状态，避免常驻噪音）。

点了「保存并生效」之后才一步到位：写盘（原子写）+ 立即重新注册所有提示词段（先 dispose 再重建），当前会话的下一轮请求就带上新内容，不需要重启 DSH。

换句话说："立即生效"指的是"点保存后不用重启"，不是"边打字边生效"。
之所以不做成实时，是因为每一次改动都会触发一次全量重新注册并广播 system-prompt/change；逐字符触发既浪费，也会让提示词前缀在输入过程中反复抖动。

改段名

每条提示词注册出来的段名是 system-prompt:<id>，卡片上的输入框改的就是那个 <id>：

- 允许字符：A-Z a-z 0-9 . _ -，首字符必须是字母或数字，最长 64 位；输入不合法或与自己列表里的另一条重名时，输入框会变红并给出行内提示（提示是即时的，但段名本身不是——仍要点保存）；
- 改完点「💾 保存并生效」才真正写入；保存后底部段序会立刻显示新段名；
- 兜底：即使前端校验被绕过（比如直接改配置文件），host 半也会把非法或重名的 id 自动换成一个新 id，不会导致注册失败；此时该条会多出一行「⚠️ 实际注册为 system-prompt:xxx」，明确告诉你真正生效的名字是什么；
- 改名不影响正文，也不影响其它条目的顺序。

为什么要能改：段名是你在提示词组装结果里辨认某一条的唯一标识，也是排查「到底注入了什么」时的抓手。默认那条叫 thinking-language （沿用 1.x 的历史名），想改成 chinese-reasoning 之类更贴切的名字，现在可以自己改。

页面底部还会实时显示当前组装出来的段序（如 harness:identity | system-prompt:xxx | deployment:persona-prefix | …），用来核对到底注入了什么、排在哪儿。

几个约定：

- 正文留空的条目不注册（页面上会给黄色提示）；
- 顺序：第 i 条的 order = 基线 + i（i 是列表下标）。默认基线 -900，即紧跟 harness 身份（-1000）、排在所有部署 persona（0）之前。
用下标而不是"启用条目的序号"，是为了让停用某一条时后面的段不平移——提示词前缀保持稳定，不破坏 KV 缓存的复用位置。
- 总开关停用后一条都不注册（依赖仍在，随时开回来）。
- 恢复默认回到出厂状态（只留「用中文思考」那一条，两步确认）。

配置文件

运行时权威是：

<DSH_HOME>/system-prompts.json # DSH_HOME 缺省 ~/.dsh

{
"version": 2,
"enabled": true,
"order": -900,
"prompts": [
{ "id": "thinking-language", "title": "思考语言：简体中文", "text": "…", "enabled": true } ] }

- 写入是原子的（先写 .tmp 再 rename），半截文件不会污染状态；
- 文件损坏时回落内置默认，不覆盖坏文件（保留现场）；删掉该文件即恢复出厂；
- id 只允许 [A-Za-z0-9][A-Za-z0-9._-]{0,63}，段名是 system-prompt:<id>；非法或与同列表内另一条重名时，host 保存时自动换成新 id（p-…），不会注册失败。
这也是为什么改段名不可能把插件改坏——最差情况只是 id 被换掉。
- 段名在同一个 system 提示词层内必须唯一：两条提示词的 id 相同会被 host 改号，而不是静默覆盖。

profile 里的 config（仅首次初始化时生效）

- id: system-prompts
name: dsh-system-prompts
config:
language: ja # 首次初始化时，预置那条换成日文 text: 自定义正文 # 给了就完全覆盖语言模板 enabled: false # 首次初始化即为停用

⚠️ 已经生成过 system-prompts.json 的机器上，改这里没有任何效果——那是 1.x 的写法， 2.0 只为平滑升级保留了首次初始化的兼容。之后请一律用设置面板。

它做什么 / 不做什么

做

- 注册 system-prompt:<id> 形式的 system 提示词段，内容与顺序由设置页决定；
- 保存即生效（section() 返回 disposer，改动时先撤销全部再按新列表重建）；
- 通过宿主 webserver 暴露 /system-prompt/api（设置页同源 fetch 读写）。

不做

- 不读取、不替换、不改写任何别人的段（纯追加）；
- 不碰工具面、不注册工具、不改运行时上下文；
- 不翻译代码：提示词里怎么写就怎么注入，标识符、路径、命令名保持原样。

HTTP API（自检 / 脚本化用）

挂在宿主 webserver 上（桌面版即 GUI 那个端口）：

读当前状态：配置 + 实际注册的段 + 组装后的段序
curl http://127.0.0.1:<port>/system-prompt/api/state

保存（整体替换；enabled / order / prompts）
curl -X POST http://127.0.0.1:<port>/system-prompt/api/state
-H "content-type: application/json"
-d '{"enabled":true,"order":-900,"prompts":[{"id":"demo","title":"示例","text":"Always answer briefly.","enabled":true}]}'

恢复默认
curl -X POST http://127.0.0.1:<port>/system-prompt/api/reset

state 返回里有两个字段专门用于验证生效：

- live：当前真正注册上的段（id / 段名 / order）；
- sections：systemPrompt.assemble() 组装出来的完整段序（含官方各段）。

开发与验证

lib/index.js（host）与 lib/client.js（client）都是手写 JS，无需构建： client 半走的是 DSH 页面的模块协议 window.__ModuleLoader__.load({ id, factory })，内部用 React.createElement（不依赖 JSX 转译），改完直接生效。

scripts/render-harness.mjs 是一个不打开浏览器的组件级回归脚本：mock window.__ModuleLoader__ / document / fetch，用 react-test-renderer 真跑一遍「加载 → 渲染 → 新增 → 编辑 → 保存 → 删除 → 总开关 → 恢复默认」（36 项断言）：

npm i --no-save react@18.3.1 react-test-renderer@18.3.1
node scripts/render-harness.mjs

改了 client 界面后跑一次，比盯着页面刷新快。依赖不写进 package.json（只在本地临时装）。

热重载（装了 dsh-super-injector 时）：dev_reload_package dsh-system-prompts 重建 host fiber 即可。注意 client 半还有一层 pkgMeta 缓存：包在 client-modules 首次扫描时若没有 dsh.client 声明，结果会被进程级缓存，加了声明必须「清缓存 + 重扫」才会被重新识别（~/.dsh/super-injector/ 下的自愈日志会记录此事）。

兼容性

| 项 | 要求 |
| Node | >= 22.19（DSH 自身的要求） |
| @deepseek-ai/dsh-system-prompt | >= 0.1.0-rc.6 < 2（peer，optional） |
| @deepseek-ai/cordis | >= 4.0.0-rc < 5（peer，optional） |
| DSH 版本 | 已在 0.2.0-rc.2 上实测；peer 范围刻意放宽 |

常见问题

Q：改了没反应？ 正文改完要点「💾 保存并生效」。保存成功后是下一轮请求生效（已经在跑的那一轮不会变）。
页面底部的段序就是当时的真实状态。

Q：为什么 AGENTS.md 里写「必须用中文思考」不管用？ AGENTS.md 由 dsh-agent-instructions 收集，落地成一条 user 角色的 <system-reminder> 快照——它是"建议"，不是"不变量"。而"用哪种语言推理"是模型的底层行为，需要落在 system 角色里。
本插件的预置条目就是干这个的。

Q：同一个 profile 装两次会怎样？ 不要这么干。 systemPrompt 把段名当唯一键，同名重复注册会被直接拒绝（prompt section "..." is already registered）。本插件内部对同一次保存的列表做了去重，但两个插件实例各注册一份同名段仍会互相顶掉。

Q：order 能排到别的段后面吗？ 能。把基线顺序改成比目标段更大的值即可（例如 10300）。官方段序在设置页底部可见。

Q：会拖慢请求吗？ 每轮多几段固定文本，属于固定成本。默认位置在提示词最前面，前缀稳定，不破坏 KV 缓存复用。

Q：system-prompt:xxx 这些段是在哪一段被消费的？ 作为 system 角色消息写进会话历史；DSH 也会把组装好的 system 提示词原样写进会话日志，导出即可逐字核对。

许可证

MIT © 2026 wqzhellohhwy