前言¶
在 DeepSeek Harness(dsh)里做智能体或长对话时,经常要把项目说明、规范文档或 AGENTS 类文件稳定地交给模型。手工复制粘贴容易漏改,单靠工作区索引也未必等价于「整份文件按固定策略进上下文」。下面介绍社区插件 dsh-prompt-file-injector(维护者 pgnqukezrdxmhjso,分类:模型推理):在侧边栏 Plugins 页为本插件卡片提供配置区,列出路径并选择每条路径如何进入模型上下文。
这是什么¶
dsh-prompt-file-injector 把用户指定的文件注入 dsh 的模型上下文(README 英文说明:Injects files you choose into the model context of DeepSeek Harness (dsh))。npm 包名与插件名均为 dsh-prompt-file-injector,当前 package 版本为 0.1.0,许可证 MIT。插件基于 dsh 0.1.7-rc.2 构建;更细的设计说明见仓库内 design/en/current.md。
三种注入模式¶
在插件卡片里为每个路径选择模式:
| 模式 | 作用 |
|---|---|
| System prompt | 将文件全文作为固定的 system 段落注入,整段对话期间保持存在。 |
| Every turn | 每一轮把文件内容重新放进对话,贴近当前话题并反映磁盘上最新内容;代价是 token 用量持续增加。 |
| AGENTS | 把文件名加入 dsh 自带的 AGENTS 加载体系,在工作区内与 AGENTS.md 同类方式加载。 |
同一路径若需要两种策略,在列表里添加两条 entry,分别指定不同 mode 即可。
提醒与范围¶
列表旁有一项 reminder,在对话末尾附近提醒模型回看已注入到 system 的内容,可选 Off、Every turn、Every step。
每条路径可限定只在一个 workspace 生效;省略 workspace 限制则在所有 workspace 注入。AGENTS 模式不能按 workspace 限定,选择器在 UI 上禁用,且始终对所有 workspace 生效。
配置项说明¶
除侧边栏 UI 外,配置结构与 README 中的 Settings 表一致:
| 参数 | 说明 |
|---|---|
entries |
要注入的路径列表(数组,可选) |
entries[].path |
文件路径;AGENTS 模式下可为工作区内的文件名(必填) |
entries[].mode |
system、everyRound、agents 之一(必填) |
entries[].workspaceId |
仅在该 workspace 注入;省略则全局。AGENTS 模式忽略此项 |
reminder |
off、turn(每轮一次)、step(含每次 tool call 之后) |
everyRoundInMinimal |
在 minimal 模式下仍持续注入 Every turn 内容(默认 false;此时 system 由 preset persona 占用) |
maxFileBytes |
单文件字节上限,超出则跳过;作用于 System prompt 与 Every turn;AGENTS 使用内置限制(默认 65536,配置区以 KB 输入) |
路径解析规则:相对路径相对各次对话的工作目录;绝对路径原样使用。无法读取、超过上限或判定为二进制(非文本)的文件会被静默跳过。
安装与启用¶
官方安装方式来自 README,且明确说明不支持从 GitHub 直接安装插件:
dsh plugin --profile web add dsh-prompt-file-injector
安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。插件在当前 dsh 进程权限下运行,注入的路径即该进程能读到的路径,请勿把不可信路径或过大文件 blindly 加入列表。
典型用法步骤¶
- 执行上述命令,在 web profile 下安装插件。
- 打开 dsh 侧边栏 Plugins,找到 dsh-prompt-file-injector 卡片。
- 在配置区添加 entry:填写
path,选择 System prompt、Every turn 或 AGENTS;需要时设置 workspace 限定与 reminder。 - 若某规范文档既要常驻 system、又要每轮刷新,添加两条 entry,同一
path、不同mode。 - 开始对话,确认模型能访问注入内容;Every turn 模式下注意 token 与
maxFileBytes限制。
适用场景与注意¶
适合需要把固定说明文档、团队规范或 AGENTS 类文件稳定纳入上下文的 dsh 用户。Every turn 适合内容会变、且必须让模型每轮看到最新版的文件;System prompt 适合整段会话不变的约束;AGENTS 适合与 dsh 现有 AGENTS 加载行为对齐的文件名。
社区目录 SkillHub 插件页 与 GitHub 为独立信息源,与 DeepSeek / 幻方无官方从属关系;DSH 生态强调「一切皆插件」,安装与配置以仓库 README 为准。
链接¶
- 目录页:https://www.skillhub.cn/plugins/pgnqukezrdxmhjso/dsh-prompt-file-injector
- GitHub:https://github.com/pgnqukezrdxmhjso/dsh-prompt-file-injector