mingding-snap-modifier 2.13.1 → 2.14.0

package/dist//345/221/275/345/256/232/344/271/213/350/257/227/345/205/250/351/207/217/344/277/256/346/224/271/345/231/250_v2_14_/351/223/276/346/216/245/347/211/210/344/270/226/347/225/214/344/271/246.json

@@ -0,0 +1,29 @@
+{
+  "entries": [
+    {
+      "uid": 0,
+      "key": [],
+      "keysecondary": [],
+      "comment": "【命定之诗】全量修改器 v2.14",
+      "content": "/* 命定之诗 · 快照全量修改器 v2.14 */\n// 在 酒馆助手 新建脚本后粘贴以下内容后开启脚本并刷新页面：\nimport 'https://cdn.jsdelivr.net/npm/mingding-snap-modifier@2.14.0/dist/mingding-modifier.js';\n",
+      "originalContent": "/* 命定之诗 · 快照全量修改器 v2.14 */\n// 在 酒馆助手 新建脚本后粘贴以下内容后开启脚本并刷新页面：\nimport 'https://cdn.jsdelivr.net/npm/mingding-snap-modifier@2.14.0/dist/mingding-modifier.js';\n",
+      "id": 0,
+      "constant": false,
+      "selective": false,
+      "insertion_order": 100,
+      "enabled": false,
+      "position": "before_char",
+      "extensions": {},
+      "probability": 100,
+      "useProbability": false,
+      "excludeRecursion": false,
+      "displayIndex": 0,
+      "caseSensitive": false,
+      "automationId": "",
+      "role": null
+    }
+  ],
+  "metadata": {
+    "version": 3
+  }
+}

package/docs/v2.14/350/277/255/344/273/243/350/257/264/346/230/216.md

@@ -0,0 +1,143 @@
+# v2.14 迭代说明（MD-2026-09-04-01）
+
+> 2026-09-06 更新：项目所有者授权当前版本通过 npm 发行，包版本 2.14.0，界面版本 v2.14。下方各轮“未发布”等表述是当时的历史记录；自动测试数字和发布授权不代表所有宿主环境均已验证。
+
+## 2026-09-06 发行调整
+
+- “关于”页移除主要更新卡片，在第一张产品信息卡片加入“作者：@gunkoishi_50181”；更新说明继续保留在本文档中。
+- 链接版世界书沿用旧版安装方式，`content` 与 `originalContent` 同步保存 `import 'https://cdn.jsdelivr.net/npm/mingding-snap-modifier@2.14.0/dist/mingding-modifier.js';`，条目仍保持禁用，供玩家在酒馆助手新建脚本时使用。
+- 本轮不改动变量读取、写入、生成检测、备份、回滚和性能缓存；不新增修改器运行时第三方依赖。链接安装只在加载时从 CDN 取得本版本脚本。
+
+## V2.13.2 → V2.14 主要更新
+
+1. 适配了角色卡 V4.3.2 的事件字段。
+2. 重构了主角、NPC、世界、日历和模板变量的编辑页面，增加“结构化编辑”与“原始 JSON 编辑”的按钮。
+3. 简化了变量修改的应用流程，现在在底栏能直接选择方式并确认应用，不用来回切换页面提交。
+4. 改进直接写入的规则检查与目标保护，减少无效修改和写错回复的问题。
+5. 改进日历与模板变量的提交方式，模板变量不再输入后立即保存。
+6. 整理历史、操作记录和设置页面，改进悬浮窗及页面输入状态的保留。
+7. 重构了UI界面。
+8. 修复了一些BUG。
+
+## 本次修复与使用边界
+
+- 背包、装备等集合使用搜索与普通下拉框选择，只显示当前详情；内部用分隔标题和字段行组织，标签逐行增删，下拉、搜索与标签框沿用统一输入样式。脚本重载时会更新已存在的样式节点。
+- 历史、日志、正文注入记录使用浏览器原生 IndexedDB 分条保存，不再挤占 localStorage 的历史配额。正常保留变量快照和相关指令，条数上限自动 FIFO；空间不足需要额外淘汰、只存变量或无持久备份时先询问一次。取消不写入、不删旧备份，接受后才按需降级；无持久回滚明确提示。权限、数据库损坏或不可用等非容量错误仍停止。
+- 自动复制已识别的旧 v2.14 三类记录，保留原 localStorage 键；旧记录缺少目标或超出容量时明确提示，不假称全部迁移。历史维持 1 MiB、默认 20 条、可设置 1 至 100 条的限制。
+- 日志失败只提示记录未保存，不把已经成功的变量修改变成失败或触发补偿。历史页按需读取数据库，不做常驻检查。
+- 正文方式的变更预览分别展示数值更新与正文指令记录；“关于”不再显示开发状态，玩家说明不使用“基线”等开发用语。
+- 效果可以逐项添加名称与说明、改名和删除；无需手写 JSON。结构化与原始 JSON 相互同步，错误输入必须修正后再应用。
+- 历史按操作保存变量快照和修改前后的指令块；附近文字只保存长度与指纹，不保存剧情或 Analysis 明文，也不会回滚剧情。
+- 默认“撤销本次操作”只恢复该次实际改过的字段和指令，保留后来无关值；同字段新变化由用户选择覆盖或保留。另有“完整快照恢复”，覆盖记录内完整变量范围，旧历史没有逐项信息只能使用该入口。声明编辑/删除只恢复指令，重新处理只恢复其变量变化；两者均不恢复剧情。
+- 相关指令块仍存在且唯一时，附近剧情及无关块变化不阻断回滚。相关块被改过、删除块的插入位置无法唯一定位时停止；旧版未保存的数据无法重建。重新处理会执行正文中的指令，增减可能重复生效；冲突中选择保留的项不再重新处理。
+- 默认经典固定深色；简洁主题使用平面标题与细线分区。已保存的其他配色不强制覆盖；恢复默认同时同步窗口、控件和实际配置。
+- 备份后读取最新数据、正式解析一次，按实际改动合并，不要求完整数据静止。真实字段分歧展示“原值 / 现在的值 / 你的修改”，可覆盖、保留或取消；数组整项选择，移动两端联动。保留的项不再作为新指令注入正文。弹窗后复核选定字段，不重演解析；真正目标或校验规则变化仍停止。辅助变量按路径合并，纯声明编辑不检查无关变量。
+- 写后只核对本次涉及的业务字段，无关更新不再伪报失败；失败补偿也只撤回仍属于本次操作的值。历史记录区分已应用、未应用、结果待确认与需要检查；旧记录不推断成功。未实际应用的记录禁用回滚，结果标记失败只给警告，不把已成功的写入改报为失败。
+- 正文显示使用宿主公开渲染接口，只通知 `MESSAGE_UPDATED`；不伪造编辑前处理、新回复、聊天切换或生成结束。
+- 预览只读取并展示准备提交的修改，不调用 MVU 解析；确认后正式处理一次，避免角色卡自动化在预览或取消时累计 FP。自动化已经保存的同结果值直接接受，包括 FP 与日历统计混合提交；不会再次执行 delta/move。
+- 有草稿时保留输入及原目标，普通数据更新通知不再单独阻止应用；没有草稿时随消息/MVU 完成事件自动同步，隐藏时推迟到打开，迟到请求不能覆盖新输入。真正目标改变仍停止，不将旧编辑转移到新回复。
+- 正式解析后的失败可能已有角色卡自动化副作用，保留历史恢复入口并提示，不宣称完全未写入；自动补偿不保证撤销监听器额外写入。
+- 数字与原始 JSON 格式错误在输入时提示，无快照禁用编辑与应用；无效或未失焦草稿仍受保护。前端只检查改过的字段，不以未动过的旧异常值挡住其他编辑。MVU 不可用时仍停止，不增加绕过规则的写入方式。
+- 自动同步是读取当前快照，不是自动提交编辑。若已执行保存但写后结果或补偿不明确，先提示重新读取检查，不自动重复写入，也不把它显示为“AI 正在回复”。
+
+## 2026-09-05 性能与界面层级修补
+
+本次只调整面板的创建时机、页面缓存、状态保存和字段视觉分组，不改变 MVU、补丁、目标锁定、生成状态、备份、事务、正文注入或回滚语义。
+
+- 模板变量改为“搜索变量名 → 下拉选择 → 查看当前变量详情”。首次进入只创建选中变量的编辑区域；对象、数组和复杂卡片在展开时才创建内部控件，完整值仍保留在工作副本，原始 JSON 仍可随时打开。
+- 已创建的模板变量和编辑卡片留在当前页面缓存中。切换 Tab 或收起再展开只隐藏/显示已有 DOM，不重新读取快照；刷新、聊天目标变化、快照替换或脚本卸载时才清除缓存。
+- 卡片展开状态、筛选、滚动位置、选中 NPC/变量、未提交输入和错误提示继续沿用原有记忆规则。状态仓库在一组页面状态变化结束后合并写入，避免逐张卡片反复落盘。
+- 背包、装备、技能和资产的结构化内容按“基本属性、标签、效果、描述、扩展字段”分组。描述使用与条目同级的标题、间距和分隔线，不再视觉上缩进到上一条效果下面；没有增加嵌套业务卡片。
+- 面板隐藏时不启动新的轮询或整树扫描；单字段输入只记录该字段草稿，更新忙碌状态时才重新扫描禁用控件。
+
+本轮不把“记住上次 Tab/卡片/滚动”改成启动重置，也不删除任何字段或旧编辑入口。
+
+## 本轮目标
+
+将 v2.13 单文件重构为模块化 v2.14 主线，修复目标解析、MVU 调用、字段模型、补丁语义与回滚范围的不一致，统一交互闭环。
+
+## 关键修复（相对 v2.13）
+
+1. **精确目标解析**：锁定最新活动 swipe 内含有效 `stat_data` 的消息，记录 chatId/messageId/swipeId/role/fingerprint；目标变化即中止。
+2. **MVU 正式链路**：严格 `waitGlobalInitialized → getMvuData → parseMessage(完整旧数据) → replaceMvuData`，所有 `stat_data` 改动来自 parseMessage 返回值，合并时保留无关最新字段；弃用 Current 系列接口、禁止空对象模拟。
+3. **字段模型**：修正 `事件.开启/结束`、`阿斯塔利亚快讯`、状态效果 `增益/减益/特殊`、`升级所需经验 number|"MAX"`、`_` 只读。
+4. **统一补丁语义**：路径相对 `stat_data`（`/主角/金钱`）；union diff 生成 insert/remove/replace；数组整体替换；delta/move 只在显式选择时生成；事件 `信号` 纯追加；`_` 路径拒绝整次应用。
+5. **统一事务**：`stat_data`、`date`、`calendar_float_store`、聊天模板变量统一暂存、预览、确认、备份、写入、复核与补偿回滚。
+6. **布局与可访问性**：默认 420px 无横溢、`minmax(0,1fr)` 网格、窄单列宽双列；label[for]、aria-selected、dialog 焦点约束、Escape 关闭。
+7. **性能与生命周期**：事件驱动失效、面板关闭零常驻轮询；卸载后监听/DOM/定时器/对象 URL/父窗口标记清理。
+8. **可用业务界面**：补齐主角、NPC、世界、日历、开局、模板变量、历史、设置和关于页；复杂集合按需编辑并提供顶层键筛选；面板支持拖动、最小化、全屏和视口钳制。
+9. **正文模式防重演**：正文保存合并后的可审计 JSONPatch 块，但 MVU 本次只解析用户确认的 ChangeSet，避免把历史 `delta` / `insert` 再执行一次；正文与直接模式得到相同的新状态。
+10. **发行一致性**：运行时、构建名和 npm semver 共用 `src/version.js`；核验脚本逐字节检查中英文 JS、酒馆助手 `content`，以及世界书的 `content` / `originalContent`。
+
+## 已知限制
+
+- 本机 SillyTavern 1.13.3 集成测试与桌面/移动/键盘/触屏视觉验收需在宿主环境进行。
+- 生成状态改为能力探测公开 `builtin.duringGenerating()`，内部保留 `generating / idle / unknown` 三态；不再猜测 `streamingProcessor`、私有布尔字段或 Promise。真实生成、dryRun、quiet 和中途加载仍需在宿主场景复核。
+- creator-app（转生点）改为按操作触发的限界 Vue / Pinia 对象搜索，不做常驻轮询；实际组件树与动作仍需在自定义开局界面实测。
+- MVU 没有原子比较写入接口；单次解析和按路径合并不能完全消除并发，尤其无法自动推断全部跨字段规则依赖。显示镜像 `display_data`、差分报告 `delta_data` 采用本次解析输出，不用旧报告做业务冲突锁。
+- 历史完整快照表示备份时刻，可能早于正式写入。逐项撤销另存实际改动前后值；若成功后的元数据保存失败，该记录只能使用明确标注的完整快照恢复，界面提示，不静默删旧历史来补存。完整恢复可能覆盖之后无关数值；不会恢复剧情。
+
+## 上轮自动验证记录（历史，非人工验收）
+
+- `node --test`：187/187 通过（含第五次人工检验问题回归测试）；
+- 全部源码、测试、脚本和 dist JS：`node --check` 全部通过；
+- 发行载体逐字节一致性：PASS（中英文 JS、TavernHelper JSON content、世界书 JSON content 逐字节一致）；
+- `npm pack --dry-run`：9 个文件；
+- 未压缩单文件：287,468 字节、5,729 行，包含生成状态诊断、事务通知令牌、草稿过期保护、加载请求序号和高级设置消费者；相对本轮修复前 275,179 字节增加约 4.47%，相对 v2.13 接管基线增加 46.69%，需在人工验收前确认体积取舍；
+- 本轮未发布，等待第五轮本机 SillyTavern 宿主实测。
+
+## 2026-09-05 指令回滚轮验证（历史记录）
+
+- 代码修复与自动验证完成，真实宿主人工检验尚未执行，未对外发布。
+- `node --test`：234/234；63 个 JS/CJS 语法检查、3 个载体 JSON 缩进/解析检查通过。
+- Edge Chromium 152.0.4191.62 隔离宿主：12 组实际 DOM 操作通过、零页面异常，包括正文应用与回滚、效果增删、无效草稿、主题设置及键盘/触屏。模拟 MVU 不等于真实角色卡 Zod 验证。
+- 最终可读单文件：328,931 字节、6,316 行，SHA-256 `7A14122A05AFBFAF561C77904704105892D5C7D9CE1F7E98437B693F019BC653`。
+- 相对本轮开始增长 14.42%；用户已确认 318,936 字节阶段的体积取舍，后续核验及指纹定位收尾增加 3.13%。无新增运行时依赖、网络请求或常驻轮询。
+- 源码重建与 dist 一致，载体内容逐字节核验通过；npm 试打包仍为 9 个文件，无实际 tgz 或对外发布。
+
+## 2026-09-05 备份存储与集合布局轮（历史记录）
+
+- 本轮完成原生数据库备份、历史页异步读取、集合选择式详情、玩家文案与正文预览修正。导入后的旧草稿覆盖、变更计数以及被取消的重新加载报告同步修复。
+- 用户已确认约 6.6% 的体积增量后继续收尾；最终 JS 为 356,938 字节、6,773 行，相对上轮增加 8.51%，相对专项确认时增加 1.80%。SHA-256：`AF3BDBB6B6F020D0915EECE8B4FDF0F11DDA06D28A5B621FC96A1D65791A81E2`。
+- 只执行本轮受影响的定向回归，未重复上一轮完整测试。源码/载体语法、UTF-8、JSON 缩进及内容一致性通过。
+- 隔离 Edge 本轮风险 9 组通过；最后修改单独补测导入与取消重载 2 组，对应最终源码哈希。均使用真实数据库和模拟聊天/MVU，不代表实际酒馆或真实角色卡通过。
+- 数据库仍受浏览器权限和空间限制；保留旧 localStorage 键不等于释放主题设置空间。真实宿主与大型快照性能的边界见工作区完整开发报告。
+- 未修复性能问题：约 90K 字符快照在原生文本插入阶段出现主线程阻塞，尚未执行导入解析。无法判定由本轮引入，不宣称大快照粘贴稳定；大文件导入也未作为替代路径验证。
+- 本轮未对外发布，等待用户检查本地导入文件。
+
+## 2026-09-05 写前冲突与容量降级、下拉样式修复（历史记录）
+
+- 修复备份等待后全量比较造成的键序误判；无关更新重新读取、正式解析并合并，最多三次。真正的目标路径、数组、派生字段和正文冲突继续停止。
+- 按用户确认增加仅容量不足时的 FIFO、仅快照、无持久回滚警告降级；正常保留正文指令备份。一般存储错误仍停止，旧数据不因失败试写被清空。
+- 集合改为普通下拉，统一搜索与标签样式，重载会更新旧 CSS 节点；手机底栏分两行避免截字。
+- 当前单文件 368,758 字节、6,956 行，相对上份 356,938 字节增长 3.31%；SHA-256 `B607C463C6E606BE299D26CCB0799CBFD269B93488B5A71D4BF3121407BDB739`。源码、载体一致性、格式与语法通过。
+- 只执行受影响的模块与隔离浏览器定向检查，没有把旧完整测试重新跑一遍。各检查的源码哈希和边界见工作区本轮报告，不代表真实 SillyTavern、角色卡 MVU/Zod 或人工验收已通过。
+- 本地测试件，无对外发布；上一节的大快照性能遗留问题未在本轮处理。
+
+## 2026-09-05 真实复现后整桶误阻断修复（历史记录）
+
+- 真实酒馆旧脚本已复现“预览正确、确认后因三次数据稳定检查失败而未写入”，但尚未捕获具体变化字段，不将其断言为 AI 回复、空间不足或某个插件问题。
+- 普通应用与重新处理取消整桶稳定重试：备份一次后读取最新变量，正式解析一次，按实际改动路径合并与核验。目标、正文、真正修改路径及解析规则冲突仍停止。预览仍独立解析一次。
+- 自动失败补偿只撤回仍属于本次写入的值；手动回滚仍恢复备份时刻的所列完整范围。失败备份标记“未应用”并禁用回滚；历史结果标记失败只警告，不推翻业务成功。
+- 自动测试 324/324 通过；76 个 JS/CJS 的语法及 UTF-8、3 个载体 JSON 缩进通过，源码构建与五个本地载体一致，敏感信息模式扫描无命中；npm 试打包包含 9 文件，无实际 tgz。
+- 隔离 Edge 152.0.4191.62、实际 DOM 和原生 IndexedDB、模拟宿主/MVU：桌面 1280px 与移动 390px 共 6 组通过，8 张截图、零页面异常。覆盖正文应用 → 回滚 → 直接再次应用、真实路径冲突零写入以及历史结果保存失败提示。
+- 最终 JS 为 376,088 字节、7,064 行，比本轮起点增加 7,330 字节（1.99%）；SHA-256 `0B9C70B37C7E5A0C59CDDDCB7776B1BC7210B5AF935E8102859C9E87E820C5B0`。无新增运行时依赖、网络请求或轮询。
+- 新产物尚未载入真实 SillyTavern；旧脚本的真实失败与新版的隔离测试分开记录，不宣称人工验收通过。MVU 非原子写入及跨字段并发限制仍在；本轮未对外发布。
+
+## 2026-09-05 FP 自动化同结果误阻断与只读预览修复（历史记录）
+
+- 核实角色卡自动化 3.4.5 会在 MVU 更新结束时累计 `date.log.totalFPGained` 并直接写入宿主。此前“解析副本不影响宿主”的预览假设错误，同结果也被当成并发冲突。
+- 修复只读预览、确认单次解析、同结果合并及混合辅助变量提交；保留真实分歧、目标与角色卡规则检查。普通过期事件不再锁死草稿，无草稿时按事件自动同步。
+- 自动测试 355/355；最终 JS 380,836 字节、7,147 行，比上份增加 1.26%，SHA-256 `C5D85176EEAF5E05577F495DC2AFBD4279D4D72B980278DD2B5A085ED2D668AC`。源码和五个载体已同步，内容一致性通过，无新增运行时依赖、网络请求或轮询。
+- 当前 DOM 专项为 `scripts/qa-preview-automation.cjs`，最终 Edge 隔离检查桌面/390px 共 8 组通过，16 张截图、零页面异常，源码/dist 哈希一致；宿主/MVU 为合成实现，不代表真实酒馆通过。79 个 JS/CJS 语法/UTF-8、3 个载体 JSON 格式及 npm 试打包 9 文件通过。旧脚本预览解析计数预期作为历史保留；详见工作区《2026-09-05_v2.14_FP自动化误阻断修复与写入限制审计》。
+- 本轮未改写用户真实聊天及旧 FP 统计，未对外发布，未宣称真实宿主或人工验收通过。完整正文锁、全树字段校验、回滚范围锁等仍有收窄空间；未一并静默取消。
+
+## 2026-09-05 逐项回滚与冲突选择修复
+
+- 用户确认默认局部撤销、完整恢复另列、真实字段差异交由玩家选择，任何容量降级前询问一次；专项允许本轮可读 JS 上限 407,494 字节（相对 380,836 为 +7%）。当前实现替代上节“遇真实字段冲突一律停止”和完整范围默认回滚，不抹去旧记录。
+- 新增共享操作前后值记录与冲突选择，正文/直接/重新处理/回滚共用；局部回滚包含实际改动的自动化统计，明确覆盖新值后的撤销恢复该新值，保留无关字段、剧情和指令块。弹窗期间重新核对目标，确认一次不等于永久授权。
+- 容量取消不继续写入或删旧备份；正常条数 FIFO 不询问。IndexedDB 确认降级后分别覆盖只存变量和无持久回滚路径，写后逐项信息存储失败只警告。
+- 自动测试 383/383，通过内容包括本轮 28 项操作恢复用例；声明编辑/删除的写后核验也只检查相关块，新增无关指令不误报。最终哈希的 Edge 152.0.4191.62 隔离 DOM/IndexedDB 专项桌面 1280px、移动 390px 共 16 组通过，28 张截图、零页面异常；使用合成宿主与 MVU，不代表真实酒馆或真实角色卡通过。
+- 恢复默认设置按明确完成反馈后核对控件、运行时、存储和重新加载一致；原始 JSON 错误草稿保留。第一次专项读值过早的失败证据保留，修正测试等待并重验；新增冲突弹窗下拉框补齐主题样式。
+- 最终 JS：407,015 字节，比上份增加 26,179 字节（6.87%），不超过批准上限。SHA-256 `245C64257E3AA8260201E1A6346865706C8E2B7235E19250CC4DF77C6A8B07B6`。无新增运行时依赖、网络请求或常驻轮询，版本仍为 2.14 / npm 2.14.0。
+- 本轮未操作真实聊天、未调整历史 FP 统计、未对外发布。真实生成、远程 MVU/Zod 和跨脚本并发仍需用户人工验证，旧大快照粘贴性能问题未在本轮处理。详细过程见工作区《2026-09-05_v2.14_逐项回滚与冲突选择修复进度》。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mingding-snap-modifier",
-  "version": "2.13.1",
-  "description": "命定之诗与黄昏之歌 · 快照全量修改器（SillyTavern 角色卡变量编辑脚本）—— v2.13：修复跟随状态栏UI主题、卡片折叠失效、Tab切换滚动记忆",
+  "version": "2.14.0",
+  "description": "命定之诗与黄昏之歌 · 快照全量修改器（SillyTavern 角色卡变量编辑脚本）—— v2.14：重构为模块化主线，修复目标解析、MVU 调用、字段模型、补丁语义与回滚范围，统一交互闭环",
   "license": "MIT",
   "keywords": [
     "sillytavern",
@@ -11,21 +11,19 @@
     "mingding",
     "命定之诗"
   ],
-  "main": "dist/命定之诗全量修改器_v2_13.js",
+  "main": "dist/mingding-modifier.js",
   "files": [
     "dist/",
     "docs/",
     "README.md",
     "LICENSE"
   ],
-  "repository": {
-    "type": "git",
-    "url": ""
-  },
   "engines": {
     "node": ">=14"
   },
   "scripts": {
-    "check": "node --check dist/命定之诗全量修改器_v2_13.js"
+    "check": "node --check scripts/build.js && node --check dist/mingding-modifier.js",
+    "test": "node --test",
+    "build": "node scripts/build.js"
   }
 }