【插件开发问题】latestAssistantTurn 会返回过期值（同一视图里 settlementTurn = 4 而它是 1）

[lidochka77]

纯外行手搓小插件，今天调试的时候大肥鱼说这个是源码有点问题，最好提报给原作者看看，所以就让大肥鱼写了一份报告，请作者审阅！

标题

latestAssistantTurn 会返回过期值（同一视图里 settlementTurn = 4 而它是 1），按文档用 registerComposerAction 的 context.turn 挂媒体项的插件会把卡片挂到开场白那一轮，用户正看的那一轮里永远不显示

---

正文

环境

• DSH Tavern 2.5.0 / DSH 0.1.5-rc.2（Windows，CLI 安装）
• 插件侧只用接口文档列出的东西：tavern apiVersion 2（getTurn / getCardContext /
  backgroundModel / attach / update / list / remove / getHistory）+
  tavernUi apiVersion 2（registerComposerAction / registerMediaRenderer / registerPanel）。
  没有改酒馆源码，也没有读写酒馆的数据目录。

现象

在新开的一局里（开场白之后又正常玩了几轮），点插件按钮挂一个自定义 kind 的媒体项：

• 卡片确实生成成功（status: "ready"，内容是完整的），但它落在 turn 1（开场白）下面；
• 用户正看的那一轮里什么都不显示（看起来像"点了没反应"）；
• 换成另一个「开得较早、已经玩了三四轮」的老对话，同样的操作完全正常。

证据链（全部通过酒馆自己的接口读到，没有猜）

1. host 端绑定是对的 —— 媒体项确实存在、且与第 1 轮的当前版本精确匹配：

POST /api/dsh-tavern/pluginMediaTurns   {sessionId}
  → {"turns":[1]}

POST /api/dsh-tavern/pluginMediaForTurn {sessionId, turn:1}
  → {"key":"6bfe3b55…","items":[{"status":"ready","turn":1}, {"status":"ready","turn":1}]}

POST /api/dsh-tavern/pluginMediaForTurn {sessionId, turn:2} → {"key":"ec3331bb…"}   // 存在
POST /api/dsh-tavern/pluginMediaForTurn {sessionId, turn:3} → {"key":null}
POST /api/dsh-tavern/pluginMediaForTurn {sessionId, turn:4} → {"key":"2cf2b157…"}   // 存在（用户当时看的就是这一轮）
POST /api/dsh-tavern/pluginMediaForTurn {sessionId, turn:5} → {"key":null}

即：卡片和 currentKey(1) 完全一致，酒馆愿意把这两项交给页面。问题不在存储、也不在绑定。

2. 同一份 getSession 视图自相矛盾：

view.latestAssistantTurn      = 1        ← 插件从 registerComposerAction 拿到的就是这个
view.latestAssistantMessageId = "tavern-opening:…"
view.settlementTurn           = 4
view.rollbackTargetTurn       = 4
view.debugTurns               = [ {turn: 1} ]                   // 只有 1 条
view.replyProjections         = [ {turn: 1, textVersion: ""} ]   // 只有 1 条，textVersion 还是空串

3. 用户侧确认：往上翻到最上面，那两张卡就挂在开场白下面 ——
   说明渲染本身没问题，只是挂错了轮次。

4. 反过来看历史：这位用户以前在第 5 轮 / 第 37 轮挂的卡片都正常显示 ——
   只有这次"新开的对话"错位，所以它是状态相关的、不是每次必现。

根因（源码级）

tavern-plugin/lib/index.js:1832-1840（安装版 2.5.0）：

const debugTurns = []
for (const message of Array.isArray(chat.messages) ? chat.messages : []) {
  if (!message || message.role !== 'assistant') continue
  const turn = Math.max(0, Number(message.turn) || (message.greeting === true ? 1 : 0))
  if (turn === 0) continue
  debugTurns.push({ turn, … })
}
const latestStoryTurn = Number(debugTurns[debugTurns.length - 1]?.turn) || 0

而 latestAssistantTurn 直接取它（:1904 latestAssistantTurn: latestStoryTurn）。

也就是说 latestAssistantTurn 并不是"最新的故事轮次"，而是
「chat.messages 里最后一条 assistant 消息的 turn」，而开场白那条的 turn
兜底值是 1。我们这份对话里数组最后一条 assistant 消息正是开场白
（latestAssistantMessageId 也报 tavern-opening:…），于是算出 1 —— 可
settlementTurn / rollbackTargetTurn 已经都是 4 了。
该数组的顺序／窗口在新对话与老对话里不同，这正好解释了"老对话正常、新对话错位"。

影响面（这条最要紧）

接口文档里 registerComposerAction 写的是「针对当前最新一轮」，context = { gameId, turn, busy }。
于是任何按文档用 context.turn 去 attach({ turn }) 的插件，在这种状态下都会把媒体项挂到第 1 轮；
而渲染只看「你正看的那条消息的那一轮」，结果就是卡片静默消失：
host 端一切正常、pluginMediaForTurn 也返回了数据，日志里没有任何报错，用户只会觉得"点了没反应"。
这不是某一个插件的问题。

我们目前的临时绕法（供参考）

不直接用 context.turn，而用

const history = await ctx.tavern.getHistory({ gameId, from: reported, to: reported + 12 })
// 取其中「实际存在」的最高一轮 —— 轮次只增不减、被回退的读不到，所以这个判据是稳的

拿不到 getHistory（老版本酒馆、或这一轮还没结算）就沿用原值。
但这只是防守：插件多了一次本地调用，而且一旦酒馆的编号语义再变，绕法也会跟着错。

可能的方向（供你判断，不一定按这个做）

1. 让 latestStoryTurn 取「真正最新的一轮」：例如取 chat.messages 里 turn 的最大值，
   或直接复用 settlementTurn / 投影里的最新轮次，而不是"数组最后一个元素"；
2. 或者让 registerComposerAction 的 context.turn 与渲染器用同一套编号
   （消息节点那个 tavernStoryTurnForDshTurn(...) 的结果），两边就不会打架；
3. 或者给插件一个明确的"当前轮次"读取入口（例如 tavern.getCurrentTurn({gameId})），
   并在文档里点名「不要拿 context.turn 直接 attach」；
4. 最小改动：算 latestStoryTurn 时排除 message.greeting === true 的那条。

最短复现路径

新建一局 → 只说一两轮 → 用一个按文档实现的小插件（registerComposerAction 取 context.turn）
attach 一个自定义 kind 的媒体项 → 到 getSession 里看：
latestAssistantTurn 会明显小于 settlementTurn，而媒体项落在 turn 1、页面里看不到。

顺带一条正面反馈：pluginMediaForTurn / pluginMediaTurns 这套接口很好用 ——
我们正是靠它把"卡片到底存到哪一轮去了"一次问清楚的，否则这个问题会更难查。

[flizzywine]

感谢详细的报告，证据链很清楚，问题确认并已修复，已推送，在应用里更新到最新即可生效。

实际原因和推测的稍有不同：不是数组顺序问题，而是每轮结束后界面视图只重算有变化的部分，latestAssistantTurn 不在重算范围内，一直停留在上次完整重算时的那一轮（新开的局就是开场白那一轮）。所以老对话也可能偏到打开对话时的那一轮，只是不一定被注意到。

修复后每次都会按最新消息计算。registerComposerAction 的 context.turn 就是当前最新一轮，可以直接用于 attach，更新后用 getHistory 的绕法可以去掉。

[lidochka77]

好的！我跟大肥鱼也派上了点用场。😄