klarkxy 的 DSH 插件

提示词优化

@klarkxy/dsh-prompt-override
插件 工作方式

为 DSH 原生系统提示词补上通用工作规范,并改写过于简略的内置工具指引,对所有会话生效。

安装

 dsh plugin --profile web add @klarkxy/dsh-prompt-override

把 web 换成你在用的 profile。装完重启 profile,插件会出现在「设置 → 插件」里。

说明

以下内容来自 README.md(0.1.0)。

为 DSH 原生系统提示词补上通用工作规范,并改写过于简略的内置工具指引,对所有会话生效。

DSH 原生系统提示词只有一句身份说明,后面是零散的单条工具规则,缺少工作方式、验证、安全操作和回复要求等通用约定。本插件在不改动工具、权限和沙箱的前提下补全这些内容。

安装

dsh plugin --profile web add @klarkxy/dsh-prompt-override

将 web 替换为你的 profile 名称,安装后重启 profile。

使用

安装即生效,作用于所有会话(含子代理)。新会话从第一轮起使用新提示词;已有会话在下一次组装提示词时切换。

插件做三件事:

内容 说明
通用工作规范 在身份说明之后插入一段英文规范:先理解再改动、最小改动、改完验证、不虚报结果、危险操作前确认、并行调用独立工具、用用户的语言简洁回复;宿主的计划模式、权限与 Preset 限制优先于本规范
内置工具指引 改写 read、write、edit、glob、grep 的使用指引,补充 edit 唯一匹配、行号前缀、并行搜索等要点;bash/pwsh 不整段替换,在宿主原文后追加 shell 纪律;工具未启用时对应指引照常不出现
DSH 开发说明 默认移除每轮附带的 DSH 自身源码与 Web GUI 开发说明;识别依据是会话的 agent preset(官方 cordis 即定制 DSH,保留),拿不到 preset 时回退 persona 判定并从保留兜底

其他插件贡献的提示词保持原样。

本地覆盖

在 $DSH_HOME/prompt-override/overrides.json(未设置 $DSH_HOME 时为 ~/.dsh/prompt-override/overrides.json)放置配置,修改后重启 profile 生效;格式错误的字段会被忽略,但文件本身无法读取或不是 JSON 对象时插件会加载失败——避免在用户不知情时用内置默认值改写所有会话:

字段 默认值 说明
core true 是否插入通用工作规范
tools true 是否改写内置工具指引
devContext "auto" DSH 开发说明:auto(会话使用 cordis 等 DSH 开发类 Preset 时保留)、keep、drop
coreText — 用自己的文本替换通用工作规范;设为空字符串会完全不插入
sections {} 按提示词段名替换文本,值为 null 时删除该段;显式声明可保留/替换默认会被移除的 DSH 开发说明段

示例:

{
  "devContext": "keep",
  "sections": {
    "tool:edit": "Read a file before editing it. Keep edits small.",
    "ui:deliverable-file-references": null
  }
}

常用段名:tool:read、tool:write、tool:edit、tool:glob、tool:grep、tool:bash、tool:pwsh、tool:jobs、tool:web_search、tool:web_fetch、tool:subagent、ui:deliverable-file-references、harness:source、app:web-surface,插入的规范段为 prompt-override:core。

主要限制

  • 只改写系统提示词,工具自身的说明与参数描述保持原生内容。
  • 使用 minimal Preset 的会话由宿主锁定完整提示词,本插件对其不生效。
  • 替换文本为英文,模型仍按规范使用用户的语言回复。
  • 改写按提示词段名进行:宿主未来改名或重排提示词段时,对应改写会整段失效并保留原生文本,不会错切。