在 DSH 的插件生態中，爲不同場景動態注入提示詞是常見需求。傳統做法通常將提示詞寫入會話上下文，這會導致上下文污染，即注入內容永久存在於對話歷史中，影響後續推理的準確性和 Token 消耗。dsh-universal-worldbook 解決了這一問題，它提供酒館風格的通用世界書，能夠在請求級進行提示詞注入，且注入內容僅存在於當前請求中，不污染上下文。
核心功能¶
- 請求級注入與無污染：注入操作發生在
llm/stream請求重寫階段，內容僅存在於出站請求副本，絕不附加到 Session，舊注入不進入後續輪上下文。注入位置恆定爲 D0 前部，緩存在 D2 之前全部命中。 - 靈活的觸發機制：支持常駐觸發、關鍵詞匹配和正則匹配。提供酒館同款過濾器邏輯（與所有/與任意/非所有/非任何），主關鍵詞之間恆爲或邏輯。掃描深度可調（1~5）。
- lore_lookup 工具：支持索引式條目聲明子條目存在。主 Agent 可調用該工具按需查詢子條目詳情。查詢結果逐輪剝離（從 D0 前的 tool-call/tool-result 中剔除），不污染後續上下文。
- D1 回合追蹤器：用於錨定“上一回合最終正文”。
- 界面與數據管理：提供酒館風格 UI，支持拖拽排序、自動保存、JSON 導入導出、作用域開關和命中預覽。數據存儲於
DSH_HOME/WorldBook/，兼容酒館世界書，代碼與數據分離。
安裝與啓用¶
網頁版安裝命令如下：
dsh plugin --profile web add github:TritiumWang/dsh-universal-worldbook
桌面版安裝命令如下：
dsh plugin --profile desktop add github:TritiumWang/dsh-universal-worldbook
典型用法¶
- 工具調用查詢：配置“索引式”條目聲明子條目存在，並在 Agent 配置中註冊
lore_lookup工具，Agent 即可根據上下文調用該工具獲取詳情。 - 掃描深度調整：通過掃描深度滑塊調整匹配掃描深度（1~5），以控制匹配邏輯的掃描範圍。
- 提示詞自定義：通過通用頭/尾提示詞塊自定義提示詞內容。
適用場景與注意¶
- 隱私與權限：該插件僅本地讀寫
DSH_HOME/WorldBook，無網絡外發。隱私設置包括cloud=false,offlineMode=true,retention=none。 - 診斷功能：可通過環境變量
DSH_UWB_TRACE=1導出出站上下文快照，DSH_UWB_JOURNAL=1記錄注入臺賬，DSH_UWB_DEBUG=1記錄 debug 日誌。 - 數據持久化：升級插件時數據與代碼分離，不會丟失。
dsh-universal-worldbook 爲 DSH 用戶提供了輕量級、無污染的提示詞管理方案，通過工具調用機制實現了上下文的動態隔離。
