前言¶
DeepSeek Harness (DSH) 的插件生态中,提示词注入是一个常见需求。现有的方案多直接堆砌文本或依赖随机性。dsh-lorebooklike-prompt-tool 提供了一个声明式的注入层,它借鉴了 SillyTavern 世界书的逻辑,但剥离了角色扮演的前端属性,专注于提示词工程。
设计边界¶
这个插件通过 ctx.effect() 注册,不新增会话事件类型,不改 agent-loop 源码。它只依赖 node:* 生态,不含任何酒馆代码,也不注册任何工具。这意味着规则完全由人工编排,不再具备 Agent 自助改写的能力,从而保证了审计的可追溯性。
核心功能¶
- 分层锚点:对齐 DSH 的
SECTION_ORDERS,精确插入系统提示的指定位置,而不是一律堆在末尾。 - 蓝绿灯模式:
- 蓝灯(constant):无条件常驻。
- 绿灯(selective):按关键词或正则命中才激活。 - 可复现概率:使用 FNV-1a 算法而非随机数,确保同一会话同一轮次永远得到同一个判定。
- 三面正则替换:支持在条目正文、整段系统提示、用户消息上执行正则改写,支持捕获组。
与酒馆世界书的主要区别¶
拿掉角色扮演背景后,本插件在以下几个方面做了适配:
- 位置含义不同:酒馆的位置是相对角色卡的,DSH 的
layer直接对齐@deepseek-ai/dsh-system-prompt的SECTION_ORDERS。 - 概率必须确定:酒馆使用随机数,本插件使用稳定哈希,满足日志可重放的要求。
- 多出一层通道:DSH 有两个注入面。
channel: "system"用于风格约束等稳定内容;channel: "message"用于每轮独立的动态上下文。
使用说明¶
- 配置规则:将注入规则写成 JSON 文件。插件支持热重载。
- 概率语义:这里的概率 30% 表示“按轮次确定性抽取”,而非“每次掷骰子”。这对调试提示词工程行为非常有用。
- 图形编辑器:配合类酒馆世界书的图形编辑器使用,便于编辑规则。
注意事项¶
- 不适用角色扮演:本插件不含任何酒馆代码,不适用于角色扮演和小说创作场景。
- 零依赖:不含任何
@deepseek-ai/*运行时依赖。 - 审计风险:不注册任何工具,规则完全由人工编排。
生态位¶
在 DSH 社区目录中,这个插件填补了“世界书/系统提示注入”的空白。它不同于通用的世界书插件,因为它强制使用分层锚点和确定性概率,解决了缓存安全和可复现性的问题。
获取方式¶
GitHub: https://github.com/erlingmijiang/dsh-lorebooklike-prompt-tool