Skip to content

小白X 3.2.6

Latest

Choose a tag to compare

@Hhhhenrry-HA Hhhhenrry-HA released this 15 Nov 17:22

新增变量 3.0(卡规则与结算)、小白助手制卡工作区、Google Vertex AI 渠道,以及 xiaobaixAgent 脚本接口和前端卡挂载楼层图片卡接口;改进了绘图的角色服装记忆、图库提示词查看与总结向量恢复,并附带全套本地功能文档。普通后台绘图随扩展自动更新,不用替换后台目录;在后台绘图里使用 Google Vertex 服务账号 JSON 的用户,建议替换一次 server-plugin/littlewhitebox-server/ 目录。

变量 3.0

变量 3.0 是一套跟着角色卡走的玩法框架:作者把商店、装备、战斗、经营、事件链直接写成卡上的规则。

以前做复杂的变量卡,只靠字段模板管得住数据格式,管不住「什么条件下允许做、做了之后还会带动什么」;自己写代码搭玩法,每张卡又得自己排计算顺序、处理中途报错回滚、手动对齐世界书说明和面板按钮。3.0 把这套底座直接做成角色卡自带的框架——模型只报意图,框架负责计算,整批通过才生效;制卡、试算、模型调用、世界书说明和前端面板,全部由同一份定义驱动。

在 扩展设置 → 小白X → 数据互动 → 变量控制 选择 3.0 · 卡规则与结算 启用。新安装默认选中 3.0,已有用户保持原选择;没有 3.0 规则的普通角色卡不会激活,不影响日常聊天。

一份卡上规则,模型、世界书、面板共用

  • 规则只写一份:在角色卡上写好字段权限、派生计算、带参数和前提条件的动作、越界修正、条件触发与跨字段约束后,插件直接从这一份定义生成更新模型的提交工具、供世界书读取玩法说明的 {{xbvardesc}} / {{xbvardesc::视图名}} 宏,并向同源前端面板开放 window.parent.LWB_StateV3(inspect() 读状态、apply([{ action, params }]) 执行动作)。
  • 模型少算账:模型只需提交「购买」「装备」这类动作或允许直接改的字段;余额检查、扣钱、入库、重算防御负重、达成条件后的连锁触发,全部交给引擎执行。
  • 独立更新:变量由独立的更新模型或卡片面板提交。

整批结算、先算再写与状态恢复

  • 整批通过才落盘:一次提交里的改值与动作、派生重算、越界修正、触发和跨字段约束先在临时状态里算完,全部通过才写入聊天。「钱扣了、装备没买上」的半截状态不需要自己写代码搭;被退回的整批提交会连同具体原因(如「购买 · 条件不成立:现金 102,需要 ≥ 297」)交回更新模型自动重交一次。
  • 支持先算账再写正文:卡作者可选「回复前更新」「回复后更新」或两者组合。开启回复前更新时,玩家发消息后先结算,实际执行的动作、数值变化或因条件不足未成立的原因会自动交给本轮正文,{{xbgetvar::…}} 和 <varevent> 读到的也是结算后的新状态,避免正文先编出结果、事后结算却通不过。停止或重新生成正文直接复用已有前置结果,不重复扣钱、不重掷骰。
  • 结果可查、可撤、防重算:「查看结果」分开列出动作本身、派生计算、规则修正与触发及剧情原因。聊天保存失败时点「重试保存」只重写存档,不会再扣一次钱;切换 swipe、删末尾楼层或点「撤销结算」按每个回复版本的记录直接恢复,不重新请求 AI。
  • 多开场独立初值:在 openings 里按开场白顺序填写差异字段,左右切换开场时按对应开场初始化。

JS 扩展、自定义工具与离线制卡

  • 自定义工具(variables/tools/):更新模型基于插件同一套 Agent Core 运行,支持多轮工具调用。作者可以给卡配自定义工具,让更新模型先工作再决定提交什么动作,每次更新最多调用 5 次。
  • 隔离计算与阶段脚本:复杂公式、排序和回合结算写成 JS 函数(variables/functions/),在隔离环境里参与同一次结算,试算结果和实际游玩一致;需要联动酒馆页面的操作(如行动前准备数据、结算成功后播放音效或通知面板)使用 prepare / committed 阶段脚本,同一张卡、同一套已启用代码只需授权一次。
  • 酒馆内试算与命令行制卡:既可以在酒馆里让小白助手边写边拿当前进度做不改存档的试算,也可以用随插件附带的 node dist/tools/state3.cjs 在本地初始化、解包、检查、试算并打包进 JSON / PNG 角色卡。详见内置文档「变量 3.0」与「在外部制作变量 3.0 角色卡」。

变量 2.0

  • 新增插件独立更新:除正文内写 <state> 外,也可以配置独立模型在回复后读取本轮剧情并提交修改;提交有误时整批退回并附带逐项原因自动纠错一次。
  • 变量面板与更新保存绑定发起修改时的聊天,切换聊天后保存或重试不再串写。

小白助手与制卡工作区

  • 卡片工作区:助手可以直接在当前卡的工作区里读写角色设定、多条开场白、世界书条目、循环任务、变量 3.0 规则和前端界面,先改草稿、试算验证,确认后再写回角色卡。内置完整的 2.0 面板示例与 3.0 两份示例供参考。
  • 现场检查与试算:助手能直接读取聊天楼层渲染界面里的实际 DOM 与计算样式、查看插件运行日志,并用当前聊天进度对 3.0 规则做不改存档的试算。
  • 渠道与联网:API 配置新增 Google Vertex AI(支持 API Key 与服务账号 JSON 两种鉴权)及全局联网渠道(Exa / Tavily)。修正流式工具调用参数校验、Google 空消息段清理及 Claude 缓存与签名兼容问题。
  • 手机端优化:手机上制卡保持在聊天界面内,最小化助手时保留当前会话状态;恢复按钮与顶栏菜单对齐。

绘图

沿用角色着装与角色管理

感谢 @Ephastra 提交的 PR #134。

  • 沿用着装修正:上一张图里角色衣着为空,现在记作「没穿」,下一张不会再被当成没有记录而重新穿上衣服。模型未填衣着时沿用记忆,正文发生换装时要求写出完整衣着;切换形态而未写衣着时,按新形态的服装参考重新选择。
  • 规划结果收尾:自动去掉同一角色不同字段里的重复 tag,以及模型照抄回来的「(空=没穿)」提示文字;浏览器生图与后台生图共用同一套处理。
  • 单图编辑记忆:手动清空或修改某张图片卡里角色的 TAG,只跳过这张图对该角色的记忆,更早楼层的记忆仍然保留。
  • 服装记忆面板:在「沿用角色着装」下方查看每个角色最近被记住的形态、外貌、衣着和来源楼层,可按当前聊天手动修改或清除,也可调整往回读取的楼层数(默认 100 层)和最多记忆角色数(默认 50 个)。
  • 角色页整理:「筛选与管理」拆成「筛选与概览」「智能辅助」「分组预设」三个可单独折叠的模块;新建的角色分组在已有分组预设里默认设为「关」。
  • 预设缩略图:修正菜单里的「更换缩略图」「复制」图标显示成黑方块的问题;缩略图弹层顶部新增「移除缩略图」。

图库、过滤与快捷命令

感谢 @tpy225 提交的 PR #130。

  • 查看完整提示词:在放大图库里点提示词按钮,按需读取并展示该图的 TAG、正面提示词、角色提示词、负面提示词和所用的 Vibe 名称。
  • 图片 TAG 提取与插图过滤默认跳过思维链、状态栏和隐藏推理块,避免误匹配里面的内容。
  • 新增斜杠命令 /xiaobaix 与 /助手,可从输入框快速打开对应面板。

前端卡与脚本接口

  • 楼层图片卡挂载:window.parent.xiaobaixDraw.mountMessageImages({ element, messageId }) 让使用自定义聊天界面的前端卡,在自己的正文容器里直接显示小白X原生的 [image:…] 图片卡,翻页、重画、保存、放大和菜单都照常可用。
  • Agent 与联网接口:预设和循环任务脚本可通过 window.xiaobaixAgent 调用小白助手配好的主/副模型(支持流式输出与自定义工具声明)和联网搜索,不改动酒馆聊天,也不暴露 API Key。详见文档「Agent 与联网接口」。

总结与记忆

  • 向量维护与计费保护:区分锚点提取与向量修复;已经请求成功的 Embedding 会记录回执,缓存不一致或中途中断后恢复时优先复用已有结果,不再对同一批内容重复发起计费请求。
  • 优化手动重试向量、删除聊天时的后台维护取消与清理流程;剧情图表使用的 ECharts 改为本地随插件打包,不再依赖外网加载。

文档与其他

  • 扩展设置 → 小白X → 功能文档 改为打开随插件附带的本地文档阅读器,内容与当前安装版本保持一致。
  • 提高消息预览窗口滚动条的可见度。