# Changelog ## v2.4.3 (2026-09-23) ### 🧹 清理：播种不再追加 user 引导消息 + 手动注入防重复 - **A. 播种只留下 assistant 开场白楼**：`seedGreetingMessage` 不再在开场白之后 append 一条 `GREETING_PREAMBLE` 的 user/message —— 它必然落在消息面上（dsh-session 要求 user/message 带 surfaceOp），界面上多一条引导楼且回合开始后删不掉 （toast「删除失败：这条消息可能已经开始发送」）；实测网关接受 assistant 打头， 这条引导是白付的代价。 - **网关拒 assistant 打头的退路保留**：`agent/request-error` 撞 400 时先自动补种 一条 user 引导（`appendGreetingPreamble`）再试，并把补种结果写进 `greeting-seed.log`；仍不通则日志给出退路 `POST /api/tavern/state {"greetingSeedEnabled":false}` 关掉播种。 - **B. 手动注入防重复**：`POST /api/tavern/greeting/insert` 若会话 log 里已有 `source.model === 'character-card'` 的 assistant 楼（播种与手动注入打同一个标记）， 返回 `200 { ok:false, error:'greeting-already-present' }`，不再叠加第二条开场白 （用户截图里足控会话出现多条【主页】开场白就是这么来的）。 ★ 判据按 `source.model`，**不比文本** —— 占位符会被卡正则换掉，比文本必然漏判。 - **C. 面板提示**：「📌 开场白」卡收到 `greeting-already-present` 时显示 「ℹ️ 本会话已有开场白，无需重复注入」（蓝色提示，不是报错）。 测试：`tests/greeting-seed.test.js` 22 → 30 例；新增「播种后没有 user 引导」 「两次注入第二次失败」「占位符变了仍认得出已注入」三组断言，均已验证对照臂能真红 （把旧行为放回去 ⇒ 7 例变红）。全套 8 文件 181 例全绿。 ## v2.4.2 (2026-09-23) ### 🐛 修复：开场白播种从未触发（时序自相矛盾） 旧实现在**组装提示词时**才挂 `agent/inbox/inserted` 监听，且要求 `session.log.length === 0` —— 但那一刻日志里已有前置事件（预设选择等）， 条件永假 ⇒ `greeting-seed.log` 从未出现、播种从未触发、首楼永远没有开场白。 修法（照 DSH 官方事件序列重写时机）： - **路径① `agent/created`**：会话发布即评估（早于任何用户消息），能解析出权威预设 就直接把 `first_mes` 种成 turn 1；解析不出则留给路径②。 - **路径② `agent/inbox/inserted`**：首条用户消息入队、驱动器开回合之前兜底评估一次。 - 判重改为「日志里还没有 turn/assistant」（不再要求日志为空）；安全阀全保留： `greetingSeedEnabled` 开关、子会话不种、同一会话只种一次。 - **日志不再静默**：每个评估分叉都写 `greeting-seed.log`（带 via 与原因）， 另保留网关拒 assistant 打头的 400 记录。 - **手动兜底**：新增 `POST /api/tavern/greeting/insert`（sessionId/presetId/cardName）， 把启用中第一张卡（或指定卡）的 first 注入当前会话**末尾**——旧会话也能用； 面板「🔢 变量面板」旁新增「📌 开场白」卡，一键注入并显示结果/原因。 测试：`tests/greeting-seed.test.js` 重写至 22 例（含对旧实现必红的对照臂： 非空日志但没开过回合 ⇒ 必须能播种）。 ## v2.4.1 (2026-09-20) ### 🐛 修复：状态栏被一个死的门控掐死 加载 `` 的 HTML 时，客户端用 `if (d.ok && d.zodSource)` 当门控 —— 而**服务端从不看 `zodSource`**（全仓库 grep 零命中；muv-engine 的 `extractStatusBarHtml` 读的是 `regexScripts` / `data.extensions.regex_scripts`）。 后果：明明能算出来的状态栏被客户端直接跳过，iframe 永远空白。实测同一张卡 （足控天堂2）服务端返回 **210219 字节** 的状态栏 HTML，客户端 SKIPPED。 由于真机上极少有卡把 Zod 脚本命名为 `zod`，`zodSource` 基本恒为空 —— **等于所有预设都渲染不出状态栏**。 修法：门控改为 `d.regexScripts && d.regexScripts.length`（这正是服务端真正需要的）。 顺带补上 `presetId`——原先这次请求不带任何参数，服务端按「最近写入的会话」猜预设， 多会话下会渲染成**别的会话的卡**。 ## v2.4.0 (2026-09-20) ### ♻️ 渲染职责交割给 dsh-muv-engine - 剧情/状态美化不再由本插件执行：原先 `beautifyContentEl` 与 muv-engine 的 状态栏级联同时运行、互相覆盖，用户看到的是半成品（『』表头被当对话平铺）。 现在三处调用点统一走 `delegateBeautify(msgEl)` → `window.MuvEngine`， muv-engine 未安装时静默跳过（本插件仍可单独使用）。 - `beautifyContentEl` 定义保留作为回退，但不再被调用。 - 消息定位改为按结构匹配（`_markdown_*` 形状 + 块级子节点过滤），不再依赖 CSS Modules 哈希，DSH 重新构建后不会失配。 - 新建/复制预设后同步刷新预设绑定与 DOM 标签，修复「新建预设后添加角色卡/ 世界书写进了另一个预设」。 ## v2.3.9 (2026-09-14) ### 🐛 会话隔离补完：破限段 / 事实修正段也必须过闸门 v2.3.8 修好了「世界书和角色卡不再漏进非酒馆会话」，但**只修了一半**。实测数字露了馅： ``` presetId = default card=0 wb=0 edits=0 nsfw=1819 total=1819 ``` 世界书已经不注入了，**破限段却还在**——因为 `tavern:nsfw` 和 `tavern:edits` 这两段 各有一套自己的判断，**只检查「sid 存不存在」，从不问这个会话挂的是不是酒馆预设**： ```js if (state.nsfwEnabled !== true) { … return '' } // 就这一道闸，与会话无关 ``` 于是只要全局开关开着，**每一个会话**（包括标准模式的编码会话）都会被塞进这 1,819 字符。 修法：把「本会话该不该被注入」抽成统一判据 `isTavernSession(sid, context)`， 与 `tavern:card` 完全同一套规则（DSH 会话预设为权威；子 Agent 继承父会话）， 三段共用。修好后本会话四项全归零： ``` card=0 wb=0 edits=0 nsfw=0 total=0 本会话系统提示 42,599 字符 ≈ 13,312 tokens → 12,159 字符 ≈ 3,800 tokens （降 71.5%） ``` ### 🗑 取消「版本锁」注入 系统提示里原先硬编码注入过一条版本标记： ``` 【酒馆版本: 3.0.0+】本会话使用 dsh-tavern@^3.0.0（PolyForm-Noncommercial-Copyleft-1.0.0）， 不兼容 1.9.1 及以下版本。 ``` 两个问题：**版本号是错的**（实际 2.3.x，从来不是 3.0.0），而且它每轮都白占提示词、 却没有任何程序在读它。已按要求整条取消。 ### 📝 诊断工具的两个自身缺陷（一并修掉，避免再得出错误结论） 这一轮排查中，最大的干扰不是插件，而是**我自己的诊断脚本**： 1. 「破限段」的标记字符串写成了 `'Adult mode / 成人模式 — 已启用'` —— 多出一个前缀，**永远匹配不上**，于是持续报「无」。这是个**假阴性**， 直接导致上一轮误判「破限段也没了」。 2. 结论行**只检查世界书标记、没算破限段**，出现「表里报有 / 结论说没有」的自相矛盾。 现在结论**直接由标记表推出**，不再手写第二个判断条件。另记一条经验： `prompt-stats` 说 `nsfw=1819` 而诊断说「无」时，**两边数据打架要先怀疑测量本身** —— 这次就是靠这个矛盾发现脚本有 bug 的。 > 还有一个环境陷阱值得记下来：本机计划任务的电源策略默认是 > `true`， > 重启脚本在 60 秒等待期间一旦遇到电源事件就会被 Windows 停掉， > 表现为「重启没执行、日志却停在启动那一行」。 ## v2.3.8 (2026-09-14) ### 🐛 修复「预设 / 会话隔离」失效：选了标准模式，世界书照样注入 用户报告：某个会话在顶部选的是**标准模式**（`standard`），但酒馆的世界书、角色卡、预设模块 照样被注入 —— 会话隔离形同虚设。查下来是**三个缺陷叠在一起**，最后一个才是要害。 **① 从日志行取会话预设时，多加了一个行内字样条件。** DSH 把「会话当前的预设」写在**创建记录**那一行： ```json {"type":"session","id":"session-…","agentPreset":"standard","cwd":"…"} ``` 旧实现却要求该行**同时**含有 `agent-preset/selected` 或 `"header"` 字样才认， 而创建记录这两个字样**一个都不含** → 永远提取不到值。 （实测：整个会话日志里，正则真能提取出值的行**只有第 1 行**。） 现在**只看正则、不看行内其他字样**，并抽成纯函数 `extractAgentPresetFromLine()` 便于单测。 **② 最新显式选择不是酒馆预设时，旧实现会继续往前翻历史选择。** `standard` 不是酒馆目录，于是循环不返回、继续往前翻，翻到历史上那条酒馆预设就返回。 新规则：**事件流里有显式选择就只认它** —— 是酒馆预设就用；是内置预设就判定「本会话不注入」， **直接返回**，不再翻历史。抽成纯函数 `pickAuthoritativePreset()`。 **③ 注入闸门拿过期的 `session-bindings.json` 记账当通行证。** ```js if (!sid || (!bindings[sid] && !resolvedOnDsh)) { … } // 旧 if (!sid || !resolvedOnDsh) { … } // 新 ``` `presetId` 已按「显式选择 > bindings > default」合过了，再拿 bindings 当通行证， 等于让一条过期记账推翻用户在顶部的选择 —— 这正是隔离失效的直接表现。 修好后的行为：**在哪个会话选什么预设，就只影响那个会话。** 想让某个会话完全不要酒馆注入，把它的预设设成任意非酒馆预设（如 `standard`）即可。 > 诊断过程本身也踩了坑，记一笔：用 `grep agentPreset` 过滤会话日志时，命中的"最后几条" > 全是我们自己诊断脚本的源码（源码里当然含这个词），于是得出完全错误的结论。 > 改成**只统计正则真能提取出值的行**才看清真相 —— 「读日志辅助判断」时必须排除自身输出污染。 ## v2.3.7 (2026-09-13) ### ✨ 回复体检：把「插件没注入」和「模型拒绝了」分开 一个被反复误判的问题：写不出来的时候，界面**没有任何地方**告诉你为什么。 于是「换新对话看不到角色卡」「NSFW 不生效」「血腥内容写不了」全都被当成插件 bug 去查， 而其中有些根本不是插件的问题 —— 是模型自己拒绝了，插件只是没能把这件事说出来。 新增 `🩺 回复体检` 卡片 + `GET /api/tavern/reply-check`： - 服务端取**最后一条助手正文**（`readLastAssistantText`，只取 text 块，工具调用与 推理块不混进来），交给纯函数 `detectRefusal()` 判定。 - **判定的难点是别误报**：角色扮演正文里出现「我不能」是完全正常的 —— 角色在台词里 拒绝某件事。所以不做裸子串匹配，而是抓**元语言**（提到 AI 身份 / 内容政策 / 无法协助）与**篇幅特征**（拒绝通常很短），加权打分： 强证据 45 分、中等证据 25 分、短回复（< 500 字符）出现任何证据 +15， **≥ 60 判拒绝、≥ 30 判可疑**。 - 命中会**摊开给你看**（命中了哪些词 + 引用片段 + 可疑分），而不是只丢一个徽标 —— 让人自己判断，比替人下结论可靠。 - 三种结论给三套口语化建议。判为拒绝时直说：**换模型最直接**，因为不同模型对这类 内容的容忍度差得很远，插件改不了这个；要么就把话说成情节（谁在什么处境下受的伤、 后果是什么），比直接点菜好使。 - 卡片挂在面板里，随焦点重同步一起刷新，另有「🔄 重新体检」按钮。 设计取舍：**不做内容层面的规避**。插件能做的只有把文字放进提示词、以及把结果说清楚； 让模型写下它拒绝写的内容，不是改一个提示词文件能做到的事，也不该由插件去尝试。 ### 🐛 「反八股」和「联网搜索」各有两个控件，去重并修掉互相覆盖 面板里有**两套控件管同一个状态**，而且走的是**两个不同端点**： | 状态 | 控件 A（✍️ 写作辅助卡片） | 控件 B（下方「系统开关」条） | |---|---|---| | `antiCliche` | `#tavern-anti-cliche` 勾选 + 💾 保存 | `#tavern-anticliche-toggle` 改动即写 | | `networkEnabled` | `#tavern-network-enabled` 勾选 + 💾 保存 | `#tavern-network-toggle` 改动即写 | | 写入端点 | `POST /api/tavern/config` | `POST /api/tavern/state` | 这不只是看起来重复，它会**丢改动**：控件 A 的勾选值只在 `loadCurrent()` 时同步一次， 而 A 的保存处理器写的是 ```js antiCliche: document.getElementById('tavern-anti-cliche')?.checked !== false ``` 于是「在下方开关条改了反八股 → 回到写作辅助卡片点保存」会用 A 里那份**过期的勾选值** 把改动覆盖回去。顺带一提，这行还有个更阴的写法：元素一旦不存在， `undefined !== false` 会算成 `true`，即**静默把反八股强行打开**。 修法： - **每个状态只留一个控件**，统一到下方「系统开关」条（改动即写 + 带实时状态， 与同区的 NSFW / 剧情选项开关行为一致）。写作辅助卡片里那两个重复勾选框删除。 - 写作辅助卡片的保存按钮改为只提交 `bannedWords`（改名「💾 保存违禁词」）。 `/api/tavern/config` 是**局部更新**（只在 `typeof body.X === 'boolean'` 时写）， 所以只发一个字段不会误伤另外两个。 - 三个开关（工具 / 联网 / 反八股）的状态对齐并入 `refreshToggleStates()` —— 原先它们只在面板挂载时同步一次，别处改过之后回到面板就会显示成过期状态； 现在窗口重新获得焦点 / 切回标签页时也会一起拉回正确值。 ### 🐛 修掉 DSH 预设管理器里那两行「加载失败」 **DSH 自带的预设管理器**（`packages/client/ui-agent-preset`，红字徽标 `brokenBadge`） 会把 `/.agent-presets/` 下**每个「名字是合法预设 id」的目录**都当成一行预设； 缺 `agent.cordis.yml` 就标 broken，提示语是： > `the composition file agent.cordis.yml is missing — the directory still occupies the id; delete it or restore the file` 只有名字不合法的目录（`.DS_Store` 那种）才会被跳过 —— 这条规则写在 `packages/preset/agent-presets/src/discovery.ts` 的文档注释里，明确说了「把垃圾当预设 报错会教用户无视这个标记」。而插件往这个根目录里塞了两个**不是预设**的目录： | 目录 | 真实身份 | 出问题的原因 | |---|---|---| | `sessions/` | 插件的**会话级存储**（每会话独立的记忆/关系网） | `sessionDir()` 把它建在 `ROOT` 里，名字合法又没有组合文件 | | `tavern-lite/` | 插件的**旧版默认预设目录名**（注册为 `default` /「酒馆默认」） | `ensureDefaultPreset()` 只 `mkdirSync` 建空目录，**从不写** `agent.cordis.yml` | 修法： - **会话存储搬出预设根目录**：新位置 `/tavern-data/sessions/`。新增 `migrateSessionStorageOutOfPresetRoot()` 在启动时把老数据搬走并删掉旧目录 —— 空壳直接丢弃（`readSessionMemory()` 里连**读**都会 mkdir，历史上因此留下一堆空目录）， 非空目录搬运失败时回退成逐条 rename；目标已存在则不覆盖。 - **默认预设目录必须带组合文件**：`ensureDefaultPreset()` 现在会写入一份最小可用的 `agent.cordis.yml`（persona 行，正文字段是 `prefix:` 而不是 `text:` —— 后者会让挂载 直接失败，见 `migratePersonaTextField`）和一份 `preset.yml`（`name: 酒馆默认`， DSH 用同目录的 `preset.yml` 决定卡片上显示的名字）。 诊断过程中确认了一个有用的因果：插件**每轮组装提示词**都会调用 `readSessionMemory()`， 而它开头就 `fs.mkdirSync(...)`，所以只要会话在跑，被删掉的 `sessions//` 立刻会被 旧代码重新造出来 —— 想验证修复是否生效，必须在**重启加载新代码之后**再看。 ### ✨ 提示词体积指示器 + 全量注入超限告警 **这一版加的是「看得见」。** 世界书「全量注入」的代价此前完全不可见， 实测一本 154 条的预设能把系统提示顶到 **138,408 字符 ≈ 43,253 tokens**， 其中世界书一条就吃掉约 **12 万字符（87%）**： ``` 系统提示 138,408 字符 ├─ 世界书全量注入 ~120,000 87% ├─ 角色卡 / 固定段 ~18,000 13% └─ 破限块位置 128,696 ← 距末尾仅 9,712 字符（深度 93%） ``` 位置比总量更要命：提示词**尾部**（破限块、DSH 原生身份段）是上下文超限时 **最先被截断**的部分。这解释了一个此前查不出的现象 —— 同一个开关有时有效、 有时没效，且对话越长越容易失效。 改动分四处： - **服务端量体积**：三个注入段（`tavern:card` order -999999、`tavern:edits` 0、 `tavern:nsfw` 1.5）在返回前回填各自字符数；`tavern:nsfw` 是最后被组装的段， 由它统一把快照落盘到 `prompt-stats.json`（2 秒节流，避免同轮多次组装反复写盘）。 破限关闭、白名单外两种提前返回路径**也会落盘**，否则关掉开关就看不到数据。 - **新路由 `GET/POST /api/tavern/prompt-stats`**：返回上一轮实测体积、 全量/关键词两种模式的**实算**对比（复用 card 段同一套条目过滤与选择逻辑， 保证口径一致）、以及除世界书外的固定开销。纯函数 `estimatePromptBudget()` 按 **3.2 字符/token** 估算占窗口比例，**60% 报偏大、90% 报危险**。 - **设置页新增「📏 提示词体积」卡片**：三档体积 + 颜色告警 + 上下文窗口输入框 （默认 65536，可改成模型实际标称值）。处于全量模式且已超限时，直接给出 「切关键词触发可降到约 N 字符、省 M%」的提示。 - **客户端面板同步**：世界书工具栏内新增体积条（5 秒节流），显示本轮实测 / 全量 / 关键词三档与上次组装明细（卡片 / 世界书 / 事实修正 / 破限各多少字符）。 测得的效果对照：**全量注入 138k 字符（占 64k 窗口 66%） → 关键词触发约 2.8 万字符（13%）**。 > 说明：本仓库没有独立的客户端源码目录，`lib/client.manager.bundle.js` 即唯一入口， > 因此该文件按既有流程直接修改并逐项校验（`_verify-prompt-size.mjs`，62 项）。 ### ✨ NSFW / 剧情选项做成显式入口，并实时同步 **这两个开关原先根本不在界面上。** 它们被放在「⚙️ 高级功能」卡片里， 而那张卡片是 `style="display:none"` 默认折叠的： ```js '
', ' ⚙️ 高级功能 ...', '