{"full_name":"RT15548/LittleWhiteBox","owner":"RT15548","name":"LittleWhiteBox","shard":"1","url":"https://github.com/RT15548/LittleWhiteBox","description":null,"homepage":null,"topics":[],"tag_pages":[],"language":"JavaScript","license":null,"avatar":"https://avatars.githubusercontent.com/u/168917470?u=28ded7ed8e4c01106e48261b51d5136b41d06f6c&v=4","created_at":"2025-06-15T09:36:23Z","pushed_at":"2026-11-15T17:22:49Z","metrics":{"stars":305,"forks":61,"watchers":2,"issues":67,"prs":68,"releases":19,"issues_open":38,"issues_closed":29,"prs_open":1,"prs_closed":23,"prs_merged":44,"discussions":0},"growth":{"day":{"stars":1,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[298,299,300,300,302,304,305],"forks":[60,60,61,61,61,61,61],"watchers":[null,2,2,2,2,2,2],"issues_open":[null,39,39,39,39,38,38],"prs_open":[null,3,3,3,3,3,1]},"boards":{},"same_owner":[],"issues":[{"number":35,"title":"【求助】手机端向量化 API 未配置，L2 为 0","comments":15,"created_at":"2026-04-15T03:06:31Z"},{"number":62,"title":"ai生图-图片管理，误操作后能不能恢复图片","comments":13,"created_at":"2026-05-21T14:42:22Z"},{"number":45,"title":"关于向量召回的思考","comments":7,"created_at":"2026-04-22T05:52:53Z"},{"number":58,"title":"扩展程序 \"LittleWhiteBox\" 加载失败：[object Event]","comments":6,"created_at":"2026-05-17T01:17:49Z"},{"number":56,"title":"nai生图llm失败","comments":6,"created_at":"2026-05-13T16:04:44Z"},{"number":75,"title":"关于自动隐藏的问题","comments":5,"created_at":"2026-07-05T02:21:29Z"},{"number":60,"title":"生图LLM的api配置问题","comments":5,"created_at":"2026-05-19T10:31:25Z"},{"number":63,"title":"向量召回以及失忆问题- 生成向量处一直显示 worker / session-cache idle 或 worker / cold","comments":4,"created_at":"2026-05-22T01:52:32Z"}],"discussions":[],"latest_release":{"name":"小白X 3.2.6","tag":"v3.2.6","published_at":"2026-11-15T17:22:49Z","body":"新增变量 3.0（卡规则与结算）、小白助手制卡工作区、Google Vertex AI 渠道，以及 `xiaobaixAgent` 脚本接口和前端卡挂载楼层图片卡接口；改进了绘图的角色服装记忆、图库提示词查看与总结向量恢复，并附带全套本地功能文档。普通后台绘图随扩展自动更新，不用替换后台目录；在后台绘图里使用 Google Vertex 服务账号 JSON 的用户，建议替换一次 `server-plugin/littlewhitebox-server/` 目录。\n\n## 变量 3.0\n\n变量 3.0 是一套跟着角色卡走的**玩法框架**：作者把商店、装备、战斗、经营、事件链直接写成卡上的规则。\n\n以前做复杂的变量卡，只靠字段模板管得住数据格式，管不住「什么条件下允许做、做了之后还会带动什么」；自己写代码搭玩法，每张卡又得自己排计算顺序、处理中途报错回滚、手动对齐世界书说明和面板按钮。3.0 把这套底座直接做成角色卡自带的框架——**模型只报意图，框架负责计算，整批通过才生效；制卡、试算、模型调用、世界书说明和前端面板，全部由同一份定义驱动。**\n\n在 **扩展设置 → 小白X → 数据互动 → 变量控制** 选择 `3.0 · 卡规则与结算` 启用。新安装默认选中 3.0，已有用户保持原选择；没有 3.0 规则的普通角色卡不会激活，不影响日常聊天。\n\n### 一份卡上规则，模型、世界书、面板共用\n- 规则只写一份：在角色卡上写好字段权限、派生计算、带参数和前提条件的动作、越界修正、条件触发与跨字段约束后，插件直接从这一份定义生成**更新模型的提交工具**、供世界书读取玩法说明的 **`{{xbvardesc}}` / `{{xbvardesc::视图名}}` 宏**，并向同源前端面板开放 **`window.parent.LWB_StateV3`**（`inspect()` 读状态、`apply([{ action, params }])` 执行动作）。\n- 模型少算账：模型只需提交「购买」「装备」这类动作或允许直接改的字段；余额检查、扣钱、入库、重算防御负重、达成条件后的连锁触发，全部交给引擎执行。\n- 独立更新：变量由独立的更新模型或卡片面板提交。\n\n### 整批结算、先算再写与状态恢复\n- 整批通过才落盘：一次提交里的改值与动作、派生重算、越界修正、触发和跨字段约束先在临时状态里算完，全部通过才写入聊天。「钱扣了、装备没买上」的半截状态不需要自己写代码搭；被退回的整批提交会连同具体原因（如「购买 · 条件不成立：现金 102，需要 ≥ 297」）交回更新模型自动重交一次。\n- 支持先算账再写正文：卡作者可选「回复前更新」「回复后更新」或两者组合。开启回复前更新时，玩家发消息后先结算，实际执行的动作、数值变化或因条件不足未成立的原因会自动交给本轮正文，`{{xbgetvar::…}}` 和 `<varevent>` 读到的也是结算后的新状态，避免正文先编出结果、事后结算却通不过。停止或重新生成正文直接复用已有前置结果，不重复扣钱、不重掷骰。\n- 结果可查、可撤、防重算：「查看结果」分开列出动作本身、派生计算、规则修正与触发及剧情原因。聊天保存失败时点「重试保存」只重写存档，不会再扣一次钱；切换 swipe、删末尾楼层或点「撤销结算」按每个回复版本的记录直接恢复，不重新请求 AI。\n- 多开场独立初值：在 `openings` 里按开场白顺序填写差异字段，左右切换开场时按对应开场初始化。\n\n### JS 扩展、自定义工具与离线制卡\n- 自定义工具（`variables/tools/`）：更新模型基于插件同一套 Agent Core 运行，支持多轮工具调用。作者可以给卡配自定义工具，让更新模型先工作再决定提交什么动作，每次更新最多调用 5 次。\n- 隔离计算与阶段脚本：复杂公式、排序和回合结算写成 JS 函数（`variables/functions/`），在隔离环境里参与同一次结算，试算结果和实际游玩一致；需要联动酒馆页面的操作（如行动前准备数据、结算成功后播放音效或通知面板）使用 `prepare` / `committed` 阶段脚本，同一张卡、同一套已启用代码只需授权一次。\n- 酒馆内试算与命令行制卡：既可以在酒馆里让小白助手边写边拿当前进度做不改存档的试算，也可以用随插件附带的 `node dist/tools/state3.cjs` 在本地初始化、解包、检查、试算并打包进 JSON / PNG 角色卡。详见内置文档「变量 3.0」与「在外部制作变量 3.0 角色卡」。\n\n## 变量 2.0\n- 新增插件独立更新：除正文内写 `<state>` 外，也可以配置独立模型在回复后读取本轮剧情并提交修改；提交有误时整批退回并附带逐项原因自动纠错一次。\n- 变量面板与更新保存绑定发起修改时的聊天，切换聊天后保存或重试不再串写。\n\n## 小白助手与制卡工作区\n- 卡片工作区：助手可以直接在当前卡的工作区里读写角色设定、多条开场白、世界书条目、循环任务、变量 3.0 规则和前端界面，先改草稿、试算验证，确认后再写回角色卡。内置完整的 2.0 面板示例与 3.0 两份示例供参考。\n- 现场检查与试算：助手能直接读取聊天楼层渲染界面里的实际 DOM 与计算样式、查看插件运行日志，并用当前聊天进度对 3.0 规则做不改存档的试算。\n- 渠道与联网：API 配置新增 `Google Vertex AI`（支持 API Key 与服务账号 JSON 两种鉴权）及全局联网渠道（Exa / Tavily）。修正流式工具调用参数校验、Google 空消息段清理及 Claude 缓存与签名兼容问题。\n- 手机端优化：手机上制卡保持在聊天界面内，最小化助手时保留当前会话状态；恢复按钮与顶栏菜单对齐。\n\n## 绘图\n\n### 沿用角色着装与角色管理\n感谢 @Ephastra 提交的 PR #134。\n\n- 沿用着装修正：上一张图里角色衣着为空，现在记作「没穿」，下一张不会再被当成没有记录而重新穿上衣服。模型未填衣着时沿用记忆，正文发生换装时要求写出完整衣着；切换形态而未写衣着时，按新形态的服装参考重新选择。\n- 规划结果收尾：自动去掉同一角色不同字段里的重复 tag，以及模型照抄回来的「（空＝没穿）」提示文字；浏览器生图与后台生图共用同一套处理。\n- 单图编辑记忆：手动清空或修改某张图片卡里角色的 TAG，只跳过这张图对该角色的记忆，更早楼层的记忆仍然保留。\n- 服装记忆面板：在「沿用角色着装」下方查看每个角色最近被记住的形态、外貌、衣着和来源楼层，可按当前聊天手动修改或清除，也可调整往回读取的楼层数（默认 100 层）和最多记忆角色数（默认 50 个）。\n- 角色页整理：「筛选与管理」拆成「筛选与概览」「智能辅助」「分组预设」三个可单独折叠的模块；新建的角色分组在已有分组预设里默认设为「关」。\n- 预设缩略图：修正菜单里的「更换缩略图」「复制」图标显示成黑方块的问题；缩略图弹层顶部新增「移除缩略图」。\n\n### 图库、过滤与快捷命令\n感谢 @tpy225 提交的 PR #130。\n\n- 查看完整提示词：在放大图库里点提示词按钮，按需读取并展示该图的 TAG、正面提示词、角色提示词、负面提示词和所用的 Vibe 名称。\n- 图片 TAG 提取与插图过滤默认跳过思维链、状态栏和隐藏推理块，避免误匹配里面的内容。\n- 新增斜杠命令 `/xiaobaix` 与 `/助手`，可从输入框快速打开对应面板。\n\n## 前端卡与脚本接口\n- 楼层图片卡挂载：`window.parent.xiaobaixDraw.mountMessageImages({ element, messageId })` 让使用自定义聊天界面的前端卡，在自己的正文容器里直接显示小白X原生的 `[image:…]` 图片卡，翻页、重画、保存、放大和菜单都照常可用。\n- Agent 与联网接口：预设和循环任务脚本可通过 `window.xiaobaixAgent` 调用小白助手配好的主/副模型（支持流式输出与自定义工具声明）和联网搜索，不改动酒馆聊天，也不暴露 API Key。详见文档「Agent 与联网接口」。\n\n## 总结与记忆\n- 向量维护与计费保护：区分锚点提取与向量修复；已经请求成功的 Embedding 会记录回执，缓存不一致或中途中断后恢复时优先复用已有结果，不再对同一批内容重复发起计费请求。\n- 优化手动重试向量、删除聊天时的后台维护取消与清理流程；剧情图表使用的 ECharts 改为本地随插件打包，不再依赖外网加载。\n\n## 文档与其他\n- **扩展设置 → 小白X → 功能文档** 改为打开随插件附带的本地文档阅读器，内容与当前安装版本保持一致。\n- 提高消息预览窗口滚动条的可见度。\n","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}