TritiumWang/dsh-universal-worldbook

dsh-universal-worldbook / 通用世界书

DSH通用世界书/临时提示词注入器：

关键字 / 正则 / 常驻触发的提示词片段，经 llm/stream 请求级改写临时注入到任意会话场景（角色扮演、编程、科研…），永不写入会话历史。

主体思路仍然是酒馆式的提示词预组装+上下文隔离，但增加了检索功能，允许agent自主查阅世界书条目，查询到的内容同样仅在本轮生效，不会在后续对话的context中出现。

尽量保证了UI简洁，理解成本最低：世界书按工作区决定哪些生效，条目布局基本还原酒馆风格，额外加了拖动排序和命中条目预览功能

插入位置恒定为D0前部（拼接在用户最新消息之前，身份为user），缓存在D2之前全部命中，不在整个消息头部插入（会导致缓存全部破坏）。

独立小功能，尽量与其他功能解耦，数据兼容酒馆世界书。

特性

- 请求级注入，无上下文污染：注入只存在于最终发送给 API 的出站请求副本中 (llm/stream 重写)，绝不附加到 Session，轨迹中不可见，旧注入不进后续轮上下文。
- 匹配：常驻则每轮都插入，关键词（支持正则）命中插入，扫描深度可调（1~5），默认为 3；酒馆同款过滤器逻辑（与所有/与任意/非所有/非任何，主关键词之间恒为或逻辑）。
- lore_lookup 工具：主 agent 可调用（agent 作用域注册，子代理默认不可见），用法："索引式"条目声明子条目存在 + 工具调用，由模型按需查询子条目详情。查询结果逐轮剥离（D0 前的 tool-call/tool-result 从请求中剔除），不会污染后续上下文；长场景靠子条目关键词自动续供；若待查条目在同一轮内已经自动注入，返回兜底防重复。
- D1 回合追踪器：以 session/event 锚定“上一回合最终正文”。
- UI：世界书/条目 CRUD、JSON 导入导出、作用域开关、世界书条目复原酒馆风格UI、整卡/整行拖拽排序、自动保存(切换/关闭落盘)、通用头/尾提示词块、扫描深度滑块 + 命中预览(基于会话真实消息实时计算)。
- 数据：存储于DSH_HOME/WorldBook/，酒馆世界书兼容的 JSON 无损读写（一些过于冗杂的ST世界书功能未开发，未知字段保留）。数据与插件代码分离，升级不丢失。

安装
网页版：

桌面版：dsh plugin --profile desktop add github:TritiumWang/dsh-universal-worldbook

数据与作用域

- 世界书文件：DSH_HOME/WorldBook/worldbooks/.json(ST 兼容:{ "entries": { "0": {...} } })
- 启用表：enabled.json(global[] ∪ workspace[])
- 顺序：index.json;通用头/尾:format.json;行为设置:settings.json(scanDepth / hitPreview)
- lore_lookup 只查当前作用域已启用条目，与注入同源。

诊断功能

| 环境变量 | 作用 |
|---|---|
| DSH_UWB_TRACE=1 | 每次主请求的出站上下文全文快照(含注入/剥离改写版)，储存到 WorldBook/.trace/.jsonl |
| DSH_UWB_JOURNAL=1 | 注入台账(命中明细)，储存到 WorldBook/.injections/.jsonl(24h 自动清理) |
| DSH_UWB_DEBUG=1 | .uwb-debug.log 追加 debug 日志 (注册自检/D1 锚定等)，错误/警告始终记录 |

相关代码以环境变量门控关闭, debug / 后续开发备用。