dsh-prompt-inject:把自定义文字块注入 DSH 系统提示词

前言

DeepSeek Harness(DSH)在每次对话前会组装系统提示词,其中人设、工具说明等段落由框架与插件共同注册。若你希望在不改核心代码的前提下,追加「工具调用之间如何汇报进度」「沟通风格」一类约束,通常只能改 profile 或 fork 内置逻辑,维护成本偏高。

dsh-prompt-inject 由社区维护者 azazo1 发布,分类为工作流。它只做一件事:在组装阶段把你维护的一段文字(或外部 Markdown 文件)注册为系统提示词段落,每次组装重新读取;默认不注入任何内容,需要时在插件配置里启用并填写文本。插件不注册服务、不注册工具、不做网络访问,源码仅 src/index.ts(Host)与 src/client.ts(设置页)两个文件。

这是什么

简介与实现一致:把用户维护的文字块注入 DSH 系统提示词;仓库说明里提到默认可通过预设提供「工具调用之间的进度汇报规范」,用来提高 agent message 输出频率——实际是否注入取决于你是否启用并填写内容,空则组装阶段直接丢弃该段落。

核心功能

注入段落

Host 侧向 DSH 系统提示词注册一段用户可控文本。段落以 interpolate: false 注册,文本中的 {{...}} 原样保留,不会被当成提示词变量导致组装失败。

配置来源(三选一逻辑)

  1. 插件页多行编辑器(text):可直接书写,或从预设下拉选中后填入草稿(须保存才写回)。
  2. 外部 Markdown 文件(file):非空时每次组装改读该文件(支持 ~),优先于 text;在编辑器里改 text 后下一轮仍可按文件为准。
  3. 启用开关(enabled):关闭后段落为空并在组装阶段丢弃,已保存的文本保留,可随时再打开。

file 读不到时会退回 text 并记一条 warn,不静默丢内容。文字块与文件都为空时注入空段落,不留痕迹。

段落顺序

order 默认 100,紧跟人设前缀(0),在第一方工具引导(500 起)之前。需要更靠后的强调时,可设为 10250(人设后缀 10200 之后)。修改 order 会重挂载插件并按新顺序重新注册。

内置预设

预设位于仓库 presets/,一个文件一条;front matter 含标题与来源 URL,正文为逐字保留的原文。当前共 15 条,来源包括 OpenAI Codex 相关 prompt 文档与社区整理的 Claude Code system prompts;每条对 DSH 的专名适配写在对应 front matter 的 note 里。README 明确未保留与 DSH 内置 grep/glob、todo_write 等重复或冲突的三条。不必整包使用,可按需拼成一份文字块。

安装与启用

在插件目录执行(资料原文安装方式,需在本地 clone 或解压后的目录内运行):

dsh plugin --profile web add "link:$(pwd)"

装完重启 dsh web。卸载:

dsh plugin --profile web remove dsh-prompt-inject

配置入口:设置 → 插件 → dsh-prompt-inject 卡片。页面上有四个控件:启用注入、注入的文字块(含预设下拉)、外部 Markdown 文件路径、段落顺序。

也可在 profile 的 cordis.patch.yml 中按插件 id 覆盖,例如:

- id: dsh-prompt-inject
  config:
    order: 400
    file: ~/notes/agent-style.md
字段 默认值 说明
enabled true 关闭后注入空段落并在组装阶段丢弃
order 100 段落顺序
text '' 注入文本;默认空
file '' 非空时读该 Markdown,优先于 text

enabled、text、file 为 volatile 字段,保存后立刻生效;order 改完会重挂载插件。

典型用法

  1. 安装并重启 dsh web 后,打开插件配置卡片,保持 启用注入 打开。
  2. 在 注入的文字块 中从预设下拉选择例如 Codex 的 Sharing progress updates 或 Claude Code 的 Reporting outcomes,保存;或自行编写段落。
  3. 若希望版本管理提示词片段,在 外部 Markdown 文件 填写路径(如 ~/notes/agent-style.md),在文件中维护内容,每次组装自动重读。
  4. 需要指令出现在工具说明之后时,将 段落顺序 或 order 调整为 10250 等更大值后保存。

开发构建(维护者流程,摘自 README):

just install
just verify

运行环境要求 Node ^22.19 || >=24(见 package.json engines)。

适用场景与注意

适合:希望在 DSH Web profile 下统一追加沟通/进度汇报/工程习惯类系统提示,且希望改文件或改配置下一轮即生效、又不想写独立 Cordis 插件的开发者。

注意:

  • 插件随当前 dsh 进程权限运行,安装前请自行查看 GitHub 源码 与 MIT 许可证,确认可接受其行为(仅读本地配置与可选的 file 路径,无网络访问)。
  • 社区目录 skillhub.cn 为独立站点,与 DeepSeek / 幻方无官方从属关系;安装命令以 README 为准,勿凭插件名臆造 dsh plugin add github:... 形式。
  • 预设来源于第三方 prompt 整理,使用前请理解每条 note 中的 DSH 适配说明,避免与内置系统提示重复叠加。

结尾

dsh-prompt-inject 把「可编辑、可外置、可排序」的一段系统提示词交给用户维护,默认零注入,需要时再启用。进一步说明与预设列表见 GitHub README 与 SkillHub 目录页。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye