前言¶
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