前言¶
DeepSeek Harness(DSH)在每次对话前会组装系统提示词,其中人设、工具说明等段落由框架与插件共同注册。若你希望在不改核心代码的前提下,追加「工具调用之间如何汇报进度」「沟通风格」一类约束,通常只能改 profile 或 fork 内置逻辑,维护成本偏高。
dsh-prompt-inject 由社区维护者 azazo1 发布,分类为工作流。它只做一件事:在组装阶段把你维护的一段文字(或外部 Markdown 文件)注册为系统提示词段落,每次组装重新读取;默认不注入任何内容,需要时在插件配置里启用并填写文本。插件不注册服务、不注册工具、不做网络访问,源码仅 src/index.ts(Host)与 src/client.ts(设置页)两个文件。
这是什么¶
- 仓库: azazo1/dsh-prompt-inject
- 目录页: skillhub.cn 插件页
- 版本(package.json):
0.1.0 - 许可证:MIT
简介与实现一致:把用户维护的文字块注入 DSH 系统提示词;仓库说明里提到默认可通过预设提供「工具调用之间的进度汇报规范」,用来提高 agent message 输出频率——实际是否注入取决于你是否启用并填写内容,空则组装阶段直接丢弃该段落。
核心功能¶
注入段落¶
Host 侧向 DSH 系统提示词注册一段用户可控文本。段落以 interpolate: false 注册,文本中的 {{...}} 原样保留,不会被当成提示词变量导致组装失败。
配置来源(三选一逻辑)¶
- 插件页多行编辑器(
text):可直接书写,或从预设下拉选中后填入草稿(须保存才写回)。 - 外部 Markdown 文件(
file):非空时每次组装改读该文件(支持~),优先于text;在编辑器里改text后下一轮仍可按文件为准。 - 启用开关(
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 改完会重挂载插件。
典型用法¶
- 安装并重启
dsh web后,打开插件配置卡片,保持 启用注入 打开。 - 在 注入的文字块 中从预设下拉选择例如 Codex 的
Sharing progress updates或 Claude Code 的Reporting outcomes,保存;或自行编写段落。 - 若希望版本管理提示词片段,在 外部 Markdown 文件 填写路径(如
~/notes/agent-style.md),在文件中维护内容,每次组装自动重读。 - 需要指令出现在工具说明之后时,将 段落顺序 或
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 目录页。