【动态世界书生成】插件分享

[ActivityTime]

narrative-anchor-v0.9.25.zip

侵入性修改，所以不能保证版本适配和更新（大概率不会更新，但所幸我们有AI。。。。。。这玩意可能需要AI的帮助才能安装，安装过程未经测试。。。。。）
提供了在后台结算时同步生成世界书的能力，把剧情人物、物品事件等自动生成可随原生机制召回的世界书条目
还有支线生成功能，通过共享摘要实现多线路世界观推进

[ActivityTime]

如果作者觉得好，可以直接拿去，或者说我其实是在提建议

[ActivityTime]

给一些可扩展钩子

[ActivityTime]

希望能被并本体功能，至于为什么不提PR。。。。。。我一开始做成了插件。。。。。。

[ActivityTime]

或者有大佬觉得不错，可以把随便拿去改

[flizzywine]

DSH本身就是插件体系，做成DSH插件即可。

[ActivityTime]

Narrative Anchor 叙事锚定系统

DSH-Tavern（DSHT）叙事记忆插件：把官方姿势系统的"后台结算 + 前台注入"管道，改造为一套
大纲路线 + 多级记忆 + 当前状态的综合叙事锚定系统，让 AI 跑团拥有跨轮次不丢失的剧情记忆。

• 插件版本：v0.9.25
• 适配 DSHT：v2.5.0（f289d458）
• 形态：标准 DSH Cordis 插件（与 dsh-tavern-plugin 同级安装）

---

功能总览

三大数据模块

模块	内容	更新方式
大纲路线	当前剧情节点、前情衔接、下一幕规划、活跃伏笔	每轮后台结算
当前状态	时间、世界、地点、在场人物、环境、关键物品、故事焦点（focus 备忘）	每轮后台结算，字段级增量合并（未提交字段保留上一轮）
多级记忆	STM 短期记忆 / LTM 长期记忆 / 已知情报 / 伏笔库	见下

多级记忆（STM + LTM）

• STM 短期记忆：每轮恰好 1 条，永远累积不清空；merged_into 标记是否已归并。
• LTM 长期记忆：树形结构——未合并 STM 每 7 条生成一个 depth1 叶节点；同深度每 5 个节点归并为更高层；根节点超 10 个由程序兜底合并。根节点按历史发生顺序展示。
• 已知情报：增量合并（append-only + id 去重），进入会话世界书作为可检索条目。
• 伏笔库：完整替换，只注入 open 状态。

请求期注入（前台）

• 锚定内容作为 foreground-frame 的一个 section 注入，位置可选（默认"写作规则之前"）。
• Memory Snapshot 记忆快照：历史正文的冻结注解——首次出现在请求里时现算一次并落日志，
  此后逐字节原样回放（不破坏提示词前缀缓存）；正文被压缩/改写时成对退役。
• 支线提示：fork 支线会话在开场白前注入 System 提示，随开场白退役。

会话世界书（每会话独立）

• 结算产物（已知情报 / LTM）自动转换为临时世界书条目，关键词激活 + 冷却退役 + 可强制注入。
• 完整世界书管理页：条目增删改、三态标签筛选（选中/反选）、导出当前筛选、批量清空。
• 全局自动绑定：把某本世界书"设为全局"后自动出现在所有会话的可用列表（解除记录带时间戳，
  重新设为全局即覆盖历史解除）。
• 支线系统：一键由官方 fork 链路创建支线；族内成员的 LTM 与已知情报以
  【别名】标记条目互流；支持改名（别名实时刷新标记）、解除关联、并族、手动同步。

后台结算

• 与姿势系统共享同一个后台常驻会话（通过扩展注册点接入官方结算分派口）。
• 工具：narrative_anchor_submit（结算提交）/ narrative_anchor_read（前台+后台检索，
  IDF×命中等级评分，每轮限 3 次）。
• MVU 卡兼容：审计 /stat_data 路径增量提交，拒绝根级 delta_data 等非法格式，字段级合并。

客户端 UI（3 个侧边栏页签）

• narrative-anchor:settings：开关、注入位置、STM 上限、重置、统计。
• narrative-anchor:status：大纲路线 / 当前状态 / STM / LTM 树 / 已知情报 / 伏笔库，全部可直接编辑。
• narrative-anchor:worldbook：会话世界书管理页——条目增删改、三态标签筛选、绑定区
  （本地绑定 + 全局绑定）、支线族谱区（创建支线 / 别名 / 解除关联 / 并族 / 手动同步）、
  导出当前筛选、批量清空。

HTTP API（POST /api/dsh-tavern/<method>，共 28 个端点）

getConfig / setConfig / getData / updateData / getPosture / list / paths；
worldbook/*（list、get、select、entry、bind、settings、history、library、combos、
entries-clear、global-bind）；branch/*（prepare、register、list、rename、sync、bind、
unbind、merge、families、inspectSessions 等）。

---

目录结构

narrative-anchor-v0.9.25/
├── package.json            # 插件清单（v0.9.25）
├── cordis.patch.yml        # Cordis 挂载配置
├── lib/                    # 插件源码
│   ├── index.js            #   主入口：结算逻辑 / 工具注册 / 消息投影 / foreground 注入
│   ├── client.js           #   客户端：3 个侧边栏页签（设置/状态/会话世界书）
│   ├── data-store.js       #   锚点读写
│   ├── family.js           #   支线族谱
│   ├── official-worldbook.js
│   ├── session-worldbook.js#   会话世界书
│   ├── worldbook-combos.js #   全局绑定
│   └── settlement/         #   结算链（orchestrator / strategies / store / mvu-audit）
├── patches/tavern-plugin/  # ★ DSHT 扩展注册点补丁（11 个文件，注入的前提）
├── scripts/sync-patch.ps1  # 补丁同步脚本
└── docs/                   # EXTENSION_POINTS.md / PATCH_MANIFEST.md

关于"注入脚本"：本插件的注入不依赖外置脚本文件——前台注入（frame section /
Memory Snapshot / 支线提示）在 lib/index.js 内以消息投影与扩展钩子实现；
但它依赖 patches/ 内对 DSHT 源码的 11 处扩展注册点补丁，补丁未应用则插件不注入。

---

安装步骤

前提：DSHT v2.5.0 已安装并能正常启动。下文 <DSHT安装目录> 指 DSH-Tavern-Desktop 安装根目录。

1. 应用 DSHT 源码补丁

插件通过 DSHT 扩展注册点接入，必须先把 patches/tavern-plugin/lib/ 下的 11 个文件覆盖到
DSHT 插件源码（会修改官方源码，已含修改点清单 docs/PATCH_MANIFEST.md）：

1. 编辑 scripts/sync-patch.ps1 顶部无需改动——脚本会自动在 L:\SomeGames\*\DSH-Tavern*
   下探测安装目录。若安装在其他盘符/路径，请修改脚本中的探测通配。

2. PowerShell 执行：

   powershell -ExecutionPolicy Bypass -File scripts\sync-patch.ps1

   脚本会：备份被覆盖的官方原文件 → 覆盖补丁 → 同步语法校验（node --check）。

3. 每次 DSHT 官方更新都会覆盖补丁，更新后需重新执行本步骤
   （若官方源码大改，需按 PATCH_MANIFEST 重新适配）。

2. 放置插件目录

把整个 narrative-anchor-v0.9.25 目录放到任意固定位置（不要放在 DSHT 数据目录的
tavern/data/tools/ 下——那是用户工具机制，不是插件）。

3. 修正依赖路径并注册到 profile

1. 编辑 package.json 的 dependencies，把 <DSHT安装目录> 占位符替换为实际安装路径：

   "dependencies": {
     "@deepseek-ai/dsh-tools": "link:L:/SomeGames/AI跑团/DSH-Tavern-Desktop/data/harness/apps/dsh-tavern/tavern-plugin/node_modules/@deepseek-ai/dsh-tools",
     "@deepseek-ai/schemastery": "link:L:/.../tavern-plugin/node_modules/@deepseek-ai/schemastery"
   }

2. 编辑 <DSHT安装目录>/data/harness/profiles/tavern/package.json：

   "dependencies": {
     "narrative-anchor": "link:<插件目录的绝对路径>",
     ...原有依赖
   }

3. 同目录 cordis.patch.yml 的 dsh.profile.bundles 中加入 "narrative-anchor"。

4. 在 profile 目录执行依赖安装（使用 DSHT 自带 pnpm 11.8.0 + CI=true，勿用系统 pnpm 12）：

   cd <DSHT安装目录>\data\harness\profiles\tavern
   $env:CI='true'
   & "<DSHT安装目录>\runtime-*\resources\app\node_modules\pnpm\bin\pnpm.cjs" install

4. 重启 DSH 验证

重启 DSH Tavern 后：

• 侧边栏出现「叙事锚定」两个页签（设置 / 状态）即安装成功；
• 或验证 HTTP：POST http://127.0.0.1:43120/api/narrative-anchor/getConfig 返回 200。

使用

1. 状态页确认开关开启（backgroundTasks.narrativeAnchor，默认开）。
2. 正常游玩即可：每轮后台自动结算（大纲路线/当前状态/记忆），下一轮请求自动注入。
3. 需要支线：会话世界书页签顶部「创建支线」；需要全局世界书：绑定区「设为全局」。

数据存放

• 锚点数据：<DSHT数据目录>/narrative-anchor/data/anchors/（随插件目录，自持）
• 会话世界书：data/session-worldbooks/；支线族谱：data/branch-families.json
• 兼容说明：插件数据按 sessionId 键控，fork 支线通过 chat.narrativeAnchor 副本继承主线设置，
  实体记忆经支线条目机制流入。

已知边界

• 依赖官方扩展注册点补丁，DSHT 大版本更新后需重新适配补丁（见 docs/PATCH_MANIFEST.md）。
• Windows 环境安装（sync-patch 为 PowerShell 脚本）。

[ActivityTime]

还有世界书注入日志分析。。。

[ActivityTime]

不过状态系统的部分其实是被姿势系统覆盖的

[ActivityTime]

我不确定和剧本模式的兼容性，我没有测试过，应该没有关系吧。。。。因为我后台提交时会强制中断后台会话，阻止后台进行Agent循环，以节省token

[ActivityTime]

让AI帮忙蹬几下应该是没什么大问题，我自己在用，不过我个人并不熟悉客户端开发，所以。。。。。AI神力

[flizzywine]

我理解是做了一个可以动态注入新世界书条目的东西对吧？暂时没看到合并到本体的必要性。

[ActivityTime]

我调研了一圈，个人理解来说向量召回和主动召回其实都不够稳定，关键词召回世界书这个最传统的方法其实是最精妙的方法；它同时还解决了上下文负担的问题，世界书应该是酒馆系统最根本的那个东西，它就是一切的根基；而个人觉得单次的压缩不够可靠，实际上现在DSHT的压缩过程还是容易在压缩后感到不连贯，当然，这也和压缩提示词有关，个人采用了一种在类似网站上比较常用的方法，每轮压缩为一个条目，并逐级再压缩，以保证近期连贯性和历史概括性；up用的关键词搜索和分词其实非常好用

[flizzywine]

“实际上现在DSHT的压缩过程还是容易在压缩后感到不连贯，当然，这也和压缩提示词有关，个人采用了一种在类似网站上比较常用的方法”，可以给我PR，我会研究一下，压缩提示词我就随便写的，没有仔细研究

[ActivityTime]

然后是我个人觉得好用的压缩提示词，是隔壁DSH-NextTavern的导演笔记的生成提示词，我改了改：

Condense prior history into structured summary for plot continuation. Include main plot, old summaries & worldbook snapshot facts. Newer main text overrides conflicting old summaries.

篇幅硬约束：全文控制在 4000 token 以内，超限会造成崩溃！！

只输出摘要本身，按以下八段组织，某段无内容写「ToPopulate」：

1. 剧情脉络：Record key events, causal chains & pending items chronologically. Preserve exact time, location, participants and outcomes. Content summary handled separately; prioritize structural links.
2. 人物档案：每位人物一行——身份、外貌特征、性格、口吻习惯、能力、动机、秘密、当前状态（伤势/持有/所在位置/活动）、Sexualization、Erogenous、Allure、Genitalia；Take note of newly introduced characters; Monitor character changes and OfflineActivity for departed characters
3. 关系网：Directed relationships and evolution between characters — relationship type, current stage, key turning-point events, secrets, promises, Amorous, Lust
4. 世界与设定：动态世界书快照与正文中确立的世界规则——地理、组织、能力体系、经济政治规则、公开与秘密状态；不要抄录，整理为关键规则；
5. 物品与资源：重要物品的持有者、所在位置、状态与来历
6. 伏笔与约定：所有未解决线索、未兑现约定、待确认事项、用户否定过的走向；已兑现的注明结果，若篇幅不足，则压缩或删除已兑现的伏笔，仅保留精要事实
7. 当前情况：Time, location, present characters, their states & ongoing actions, ambient mood. Concise, no redundancy. Prioritize off-screen hidden character dynamics. Live scene handled by separate system maintenance. 注意不要和剧情主线段冗余！关注暗线进展！
8. 用户意志：用户明确表达过的偏好、底线与对剧情的纠正；用户表述的事实永远有效

记录要求：

• 保留专名、数字、称谓与用户原话中的关键表述，但不要冗余，拒绝无意义的修辞
• 一次性描写不得写成永久设定，剧情尽量压缩
• 遇到取舍时优先保：用户意志 > 人物关系 > 未兑现伏笔 > 当前生效设定 > 历史事件细节 > 当前现场；结果 > 过程；结构关系 > 场景叙述；暗线发展 > 过期主线; 长期影响 > 短期事态
• 只总结已发生的内容，不续写、不猜测、不评价，只输出摘要
• 已有摘要也一起归纳，合并重复内容，省略琐碎和失效的细节，使摘要显著短于原文
• 核心要务：提炼关键信息，精炼有效的规则集，而非叙述性描写；结构化摘要，各段不要重复冗余，职责清晰

[ActivityTime]

“实际上现在DSHT的压缩过程还是容易在压缩后感到不连贯，当然，这也和压缩提示词有关，个人采用了一种在类似网站上比较常用的方法”，可以给我PR，我会研究一下，压缩提示词我就随便写的，没有仔细研究

说起压缩提示词，我最近的感受是，现在后台任务其实都没有带历史对话轮，而后台压缩用原始提示词很容易触发无效信息错误，后台压缩提示词不是为RP设计的，压出来的东西结构不适合场景

[flizzywine]

可以给点建议，我当时做的很粗糙

[ActivityTime]

在历史时序概括方面我搞了这么个东西，但其必要性我不好说，只不过在压缩后的轮次中STM的引导效果我个人觉得还不错，当然，只是这个问题的话，压缩提示词也能完成，只是我不确定结果的稳定性，所以我选择相信程序流程，而不是完整压缩

[ActivityTime]

这个插件本身是我个人使用习惯做的，发出来主要是分享一下想法

[ActivityTime]

这样搞效果当然是会好点，但是感觉你要考虑缓存利用率，考虑和dsh自身压缩程序的兼容性，考虑时间，等等因素，所以我直接复用agent的压缩程序，而不是自己搞一套。

原生压缩也是好的，不过提示词确实需要更针对性的优化，后台压缩提示词我个人觉得不能用原生提示词，完全不适配，经常压失败

[flizzywine]

可以给点建议，改一下后台压缩词。我当时没仔细考虑

[ActivityTime]

可以给点建议，改一下后台压缩词。我当时没仔细考虑

呃，我实际上改了下流程，在自己的环境，后台压缩我直接放弃了，目前没发现后台上下文保留的必要性，直接抛弃了，而且现在包括结算在内的后台任务不都没有使用对话记录吗？

[ActivityTime]

可以给点建议，改一下后台压缩词。我当时没仔细考虑

不过我不确定对剧本模式的影响

[ActivityTime]

哦，如果真的有人用我这玩意的话，后台结算时出红字是正常的，因为我在结算流程中插入了终止循环的逻辑，以阻止无意义的Agent循环，仍然，我不确定剧本模式兼容性，so，，，，，，，AI神力！

[ActivityTime]

🎬 场景信息

📅 日期：{{YYYY-MM-DD • 星期X}}
🕓 时间：{{HH:MM，时段}}
⛅️ 天气：{{天气现象，光照，温度，空气(气味/湿度)，风力}}
🗺️ 坐标：{{城市→市区→具体区域→建筑→楼层/房间→具体位置}}
💬 周围：{{环境音 | 关键物体与光影 | 周围非关键人物}}

🗂️ 角色档案

🪪 {{主角姓名}}
🔸基本信息：{{年龄数值}}岁，{{性别}} | {{概述身份背景、社会职业、荣誉名号等}}
🔸核心人设：{{性格描述，多维度}} | {{核心价值观}} | {{标志性行为习惯}} | {{社交倾向与模式}}
🔸能力技巧：
  - {{技能（熟练度）、技能（熟练度）…}}
  - {{知识（精通度）、知识（精通度）…}}
  - {{特殊能力（等级）、特殊血脉（等级）…*无则完全省略该项*}}
  …
🔸人际关系：
  - 与{{角色姓名}}：{{与对方的社会关系}} | {{典型互动模式}} | 亲密度: {{具体数值}} ({{关系中的特殊之处}})
  ...
🔸外貌身材：
  - {{身高cm}} | {{整体气质与体型轮廓和肌肉分布}}
  - {{发色/发型，脸型，五官细节}}

[ 场景快照 ]
🔸着装佩饰：
  - {{衣物名称，含款式/颜色/材质}} | {{贴合度、覆盖度、当前状况详述}}
  - {{衣物名称，含款式/颜色/材质}} | {{贴合度、覆盖度、当前状况详述}}
  ...
🔸个人物品：

🪪 {{NPC姓名}}
🔸基本信息：{{年龄数值}}岁，{{性别}} | {{概述身份背景、社会职业、荣誉名号等}}
🔸核心人设：{{性格描述，多维度}} | {{核心价值观}} | {{标志性行为习惯}} | {{社交倾向与模式}}
🔸能力技巧：
  - {{技能（熟练度）、技能（熟练度）…}}
  - {{知识（精通度）、知识（精通度）…}}
  - {{特殊能力（等级）、特殊血脉（等级）…*无则完全省略该项*}}
🔸人际关系：
  - 与{{角色姓名}}：{{与对方的社会关系}} | {{典型互动模式}} | 亲密度: {{具体数值}} ({{关系中的特殊之处}})
  ...
🔸外貌身材：
  - {{身高cm}} | {{整体气质与体型轮廓}}
  - {{发色，发型，脸型，五官细节，肤质，声线特质}}

[ 场景快照 ]
🔸着装佩饰：
  - {{衣物名称，含款式/颜色/材质}} | {{贴合度、覆盖度、当前状况详述}}
  - {{衣物名称，含款式/颜色/材质}} | {{贴合度、覆盖度、当前状况详述}}
  ...
🔸神态表情：{{描述`叙事`结束时的五官动态与流露的情绪}}
🔸身体姿态：{{描述`叙事`结束时从头到脚的完整姿势，包含颈背、腰腹、四肢、手足细节}}
🔸内心独白：‘{{第一人称的核心想法或感受}}’

📑 记忆与情报

📰 已知情报

档案条目	概述
{{该条目的概括性名称}}	{{关于组织/世界/物品/历史的已知设定}}

💾 长期记忆 (LTM)

序号	时间跨度	地点跨度	概述
1	{{起}} - {{止}}	{{A}} → {{B}}	{{STM的叙事性总结，聚焦因果与状态转变}}

📝 短期记忆 (STM)

序号	时间	地点	概述
1	{{YYYY-MM-DD HH:MM}}	{{具体位置，至少精确到区域}}	{{本回合叙事的客观事实陈述}}

🎲 剧情分支

[ActivityTime]

或许也可以把这玩意塞到正文压缩提示词里

[ActivityTime]

这Deepseek调工具还能调错的吗？？？？？？？？