拖拽区块,可视化编排 SillyTavern 角色卡开场页 —— 产出自包含单文件 HTML,零手写代码、零运行时依赖
为 SillyTavern(酒馆)角色卡制作开场页组件的本地可视化工具:把欢迎标题、粒子动效、开场白选择、漫画阅读器等区块拖拽编排成页,导出自包含单文件 HTML 贴进 first_mes,由酒馆助手(TavernHelper / JS-Slash-Runner)在聊天里渲染。
- 不写代码:25 种区块 + 59 个可复用组件 + 12 套官方模板,拖拽即所得,改文案改图片即可出成品;
- 纯本地运行:无服务端、零运行时依赖,工程数据只存浏览器 localStorage,数据不出本机;
- 贴进酒馆就能用:两种导出格式覆盖开场白 / 正则脚本;
- AI 也能直接编排:随 Release 分发
opg技能包,ZCode / Claude Code 等 AI 编码助手凭一份工程 JSON 直接产出成品,无需打开可视化界面。
| 区块类型 | 复用组件 | 官方模板 | 页面主题 | 工具主题 |
|---|---|---|---|---|
| 25 种 | 59 个 | 12 套 | 6 套 | 7 套 |
| 特性 | 说明 |
|---|---|
| 🧩 区块编排 | 25 种区块拖拽排序、一键复制;触屏长按把手拖拽,移动端可用 |
| ↩️ 撤销重做 | Ctrl+Z 撤销、Ctrl+Shift+Z / Ctrl+Y 重做,最多 20 步历史;Ctrl+S 立即保存 |
| 🔍 搜索定位 | 按名称实时筛选区块;跨区块全局搜索替换(含角色 / 图片 / 漫画页 / 曲目 / 问答等子项,及正则标记与自定义宏),支持逐个定位后单处或全部替换 |
| 🎛 区块预设 | 欢迎标题 / 引言 / 随机事件 / 骰子 / 入场闸门 5 类内置常用风格,一键套用 |
| 🧱 组件库 | 59 个可复用组件(7 大分类 + 搜索弹窗)——对话气泡、手机聊天窗、终端窗口、监护仪、求签占卜、翻转人物卡……点击追加到自由 HTML 区 |
| 📐 官方模板 | 12 套成品布局,新建工程时一键套用完整排版 |
| 📥 多路导入 | 新建工程弹层支持「从角色卡导入」(PNG / JSON / CHARX,V1/V2/V3 自动识别,映射预览勾选确认,酒馆内可选同时创建角色卡)与「从导出 HTML 反向导入」(粘贴本工具产物:本版本导出自带配置快照完整还原,旧版导出轻量恢复并逐区块标注按默认项,认不出的段落原样进自由 HTML 区待认领) |
| 📚 标题库 | 开场白区块带可编辑的标题库草稿(每行 序号|标题|描述,手动维护),酒馆内打开工具可一键写入世界书(书不存在自动建,同名条目两步重建不动其它条目,position 支持 outlet) |
| 📸 工程快照 | 顶栏「📸 快照」把当前工程完整副本手动存进浏览器 IndexedDB(与 localStorage 分开存储),恢复生成新工程不覆盖现有数据,最多 20 份自动删最旧——localStorage 之外的回退底 |
| 🖼 粘贴图片压缩 | 截图/复制的图片直接 Ctrl+V 进输入框,先在本地 canvas 限宽压缩(WebP/JPEG 到约 180KB 内)再入库,避免超大 base64 撑爆 localStorage;已足够小的图与 GIF 原样保留 |
| 🎨 双主题体系 | 6 套页面主题(紫夜幻金 / 荆棘王室 / 狐火缘日 / 蓝电义体 / 渊语回廊 / 档案机):全部带独立材质、字体、配色与动效,悬停试穿点击套用,旧工程不自动换肤;另有 7 套工具主题(暖铜金 / 星夜 / 蓝图 / 磷光 / 深海 / 绯幕 / 月岩,顶栏切换并记忆,仅改变工具界面) |
| 🔤 宏支持 | {{random}} {{roll}} {{setvar}} {{isotime}} 等酒馆宏自动包装与预览,随机结果带缓存防预览闪变 |
| 特性 | 说明 |
|---|---|
| 📱 双端宽度 | 手机 / PC 宽度一键切换,核对 430px 窄屏下的排版 |
| 🌙 双色底模拟 | 暗色 / 亮色底预览,提前发现深色假设失效的区块 |
| ⚡ 实时刷新 | 内容变更 300ms 防抖重建预览;配置页与预览页分别缓存,切回时同步内容与明暗底色,内容未变则跳过重建 |
| 特性 | 说明 |
|---|---|
| ① 开场白版 | 完整 HTML 文档 + 代码围栏,整段贴进 first_mes 或 alternate_greetings(酒馆助手只渲染「代码块内 + 含 body 标签」的代码) |
| ② 标记 + 正则脚本版 | 生成可直接导入酒馆的正则脚本 JSON:把标记文本贴进开场白 / 世界书条目,由正则替换为完整页面代码 |
导出自检覆盖 </script> 逃逸、vw/vh 基准、position:fixed、Google Fonts 等已知坑,属提示级清单,不阻断导出 |
|
| 🖼 图片连通性 | 付印审读区对图库 / 漫画(封面+页)/ 头像 / 主题背景 / 自由 HTML 里的图片 URL 逐个 Image() 探测(8 秒超时单独标注「可能只是慢」),失效仅提示不阻断 |
| 💾 代码处理 | 导出代码带语法高亮,长代码预览截断显示,复制 / 下载为完整内容 |
| 特性 | 说明 |
|---|---|
| 🔌 本机服务 | npm run nh-serve 启动(只监听 127.0.0.1,零第三方依赖);npm run nh-install 注册 opg-nh:// 协议后,工具页可一键启动 / 停止服务 |
| 🖼 整本抓取 | 贴画廊链接抓全本,缩略图网格支持全选 / 反选 / 按页码选 / 去尾 N 页,也可点卡勾掉广告页,一键写入漫画区块 |
| 🌐 抓取代理 | 页面内直接填本机代理地址(Node 不走系统代理,Clash 默认 http://127.0.0.1:7890),改完即生效;服务出网走零依赖 CONNECT 隧道,抓取走 API → 页面解析双通道自动回落 |
| ⌨️ CLI 兜底 | npm run nh -- <画廊链接> --skip-last 3 直出剪贴板,--pages a-b、--proxy 同样可用 |
| 📦 免安装小包 | 工具单文件已内置助手小包:本页点「📦 导出助手小包」直接下载 ZIP(与 Releases 资产同源同字节),解压 → 双击安装协议 → 工具页点启动;无需另去 Releases 找第二个文件 |
| 特性 | 说明 |
|---|---|
| 🔑 兼容接口 | 接 OpenAI 兼容接口,生成自由 HTML 区内容与主题配色 |
| 🙈 Key 保护 | 输入框默认遮蔽(👁 切换显示);关闭「在本机记住 Key」立即清除持久化值、保留本工程会话内使用,切换工程不串用;导出工程自动剔除 |
| 📋 模型列表 | 填好 URL 与 Key 后可一键拉取 /models 下拉选择,支持关键词本地过滤(只读,不发送对话请求,90 秒超时保护) |
| 🎯 生成目标 | 可选生成目标:自由 HTML / 开场白正文 / 角色简介 / 时间线节点 / 问答组——生成后直接追加进对应区块;最近 5 份草稿本机暂存可恢复或丢弃;酒馆内打开工具时可选「酒馆当前源」走酒馆助手 generate 通道(与自带 API 配置并存,待真机验证) |
| 特性 | 说明 |
|---|---|
| 🤖 技能包 | Release 挂 opg-skill-vX.X.X.zip:SKILL.md + 单文件生成引擎 CLI(esbuild 打包,零 npm 依赖,本机 Node 18+ 即可跑),解压进 ZCode / Claude Code 等技能目录即装 |
| ⌨️ headless CLI | node opg-gen.mjs <工程.json> [--fenced / --regex] 工程 JSON 直出自包含 HTML;--schema 输出 25 种区块字段参考与内置宏表,--new / --template 从骨架或 12 套官方模板起步;产物自检与兼容审查恒跑(报告走 stderr) |
| 🧩 与工具同引擎 | CLI 打包同一份 src/js/gen 生成引擎与 defs 数据,残缺工程 JSON 按工具导入同一路径自动补齐;HTML 产物与工具导出逐字节一致 |
📖 功能明细(29 条完整说明,点击展开)
- 可视化编辑:拖拽排列区块、一键复制区块、实时预览效果(📱手机 / 🖥PC 宽度、🌙暗色 / ☀️亮色底模拟)
- 撤销/重做:Ctrl+Z 撤销、Ctrl+Shift+Z / Ctrl+Y 重做,最多 20 步历史;Ctrl+S 立即保存
- 区块搜索:按名称实时筛选区块,快速定位
- 全局搜索替换:跨区块批量查找替换(含角色/图片/漫画页/曲目/问答/装饰花纹等子项,及正则标记与自定义宏),支持逐个定位后单处或全部替换
- 区块预设:欢迎标题/引言/随机事件/骰子/入场闸门内置常用风格模板,一键套用
- 触屏支持:长按把手拖拽排序,移动端可用
- 丰富区块类型:欢迎标题、装饰背景、粒子动效、开场引言、动态时钟栏、随机事件、掷骰判定、倒计时、时间线/进度、角色简介、问答折叠、图片展示、音频 BGM、开场白选择、分隔装饰线、免责声明、作者的话、自由 HTML、更新日志、入场闸门、解码文本、命运卡池、连击彩蛋、模糊揭示、漫画阅读器,共 25 种
- 宏语法支持:
{{random::}}、{{random_nr::}}(不重复随机)、{{roll::}}、{{setvar}}/{{getvar}}、{{isotime}}等酒馆宏自动包装与预览;random/pick 选项支持一层花括号(如{{random::a{b}::c}}) - 页面主题预设:6 套成品观感保留原名,全部按同一标准重制为独立观感包——紫夜幻金=紫夜星穹(紫电流金、衬线标题、星弧与流光)、荆棘王室=王室藏书票(绯红旧银、衬线标题)、狐火缘日=狐火夜祭(朱砂狐青、楷字与噪点)、蓝电义体=义体检修终端(冰蓝信号橙、网格)、渊语回廊=深渊潮汐(深海珍珠、同心潮线与大圆角)、档案机=旧档案卷宗(炭黑黄铜、等宽标题与横线、静态)。每套含字体+材质+配色+背景+动效——悬停试穿不改工程,点击套用可撤销,两者使用同一套配置;切到任一预设都会复位上一套的材质与字体,不残留。编辑器可单选「主题材质 / 版式」,选「经典(无附加材质)」关闭附加材质;字体/材质等微调偏离已套预设时标「已自定义(基于 X)」。新工程与旧工程默认
skin=classic,缺失或未知材质按 classic 渲染原观感,不按presetRef自动换肤,主动套用才启用新版观感;套用不改区块内容、装饰花纹或标题装饰设置。字体使用本机字体栈与系统回落,不新增外链字体、运行时依赖或酒馆 API。文字色对背景不足 4.5:1、强调色不足 3:1 时警示(不阻止保存;按背景主色估算,图片背景按兜底底色估算)。背景自 v1.24 起归主题统一管理(原装饰区职责上收,旧工程自动迁移);组件库通用强调位随主题变色(终端绿、信纸米黄等场景组件保留原色) - 官方完整模板:12 套成品布局(赛博 AI 连接风、奇幻酒馆风、敦煌秘境·丝路旅记、拍立得物语·校园日常、血月庄园·家族谜局、翠竹灵修·修行面板、雾都疑云·维多利亚侦探、锈壤纪元·废土拾荒、云上航线·蒸汽飞艇、百鬼夜市·灯笼街、黄沙驿站·赏金正午、雾港低语·深潜归航),新建工程时一键套用完整布局
- 组件库:59 个可复用组件(分类+搜索弹窗选择器)——对话气泡组、手机聊天窗口、好友列表、立绘展示位、宠物卡、终端窗口、雷达扫描、监护仪、求签占卜、翻转人物卡、心电图、蒸汽压力表、跑马灯等,点击追加到自由 HTML 区;音乐播放器默认不带音频/封面外链(粘贴后自填
data-src/data-cover,data-src留空自动隐藏) - 入场闸门六主题:经典幕布、剧场帷幕(丝绒双开滑出)、封印法阵(符文扩散消散)、机密金库(转轮旋转闸门升起)、生物识别(指纹扫描验证)、年龄验证(18+ 双按钮 +
/closechat离开),前五种纯 CSS 零脚本,均可配置标题/正文/进入与离开按钮文案 - 漫画导入(nhentai):「📚 漫画导入」页签配合本机辅助服务(
npm run nh-serve,只监听 127.0.0.1 零第三方;npm run nh-install注册一键启动后页面内点按钮即可拉起/停止服务)把画廊整本直链一键填进漫画区块——贴链接抓全本,缩略图网格用全选/反选/按页码选/去尾 N 页或点卡勾掉广告页,一键应用;抓取代理在页面直接填本机代理地址(Node 不走系统代理,Clash 默认http://127.0.0.1:7890,改完即生效),服务出网走零依赖 CONNECT 隧道;单次命令npm run nh -- 画廊链接 --skip-last 3直出剪贴板(--proxy同样可用);抓取走 API→页面解析双通道自动回落;不想折腾仓库也能装——工具单文件已内置助手小包(零 npm 依赖,仍需本机 Node 18+),本页点「📦 导出助手小包」即可拿到 ZIP(与 Releases 资产同源同字节,解压→双击安装协议→回来点启动) - 漫画阅读器:开场页内嵌一部漫画——入口选封面卡片(竖版封面 + 书腰标题 + 页数徽标 + 网点质感,未填封面自动回落横幅按钮)或横幅按钮,点击打开全屏阅读器;条漫(无缝纵排滚动)/翻页(按钮 + 键盘 ←→ + 页码)双模式,✕/Esc 关闭;图床 URL 逐页添加或批量粘贴一次建页,一键清空全部页面;纯客户端交互零 API
- 开场白选择增强:三种选项风格(卡片式/列表式/封面墙——16:9 海报网格,无封面回落主题渐变占位 + 大序号水印);≥6 条开场白时列表上方出现搜索框(按标题/描述/人物名即时过滤,工具预览中同样生效);每条选项带 👁 全文预览(读卡全文需酒馆内,工具预览中点击提示)——先读全文再在预览弹层里切换/填入/选中,不怕点错切走;封面与联动音轨按绑定标题对应开场白(与列表标题一致才命中,卡里插删/重排不错位;未填标题的项按序号回落,可一键从占位列表补标题;切换成功后音轨经宿主文档播放,切楼不中断);当前开场白带 aria-current 标记;排除标签过滤(自动提取前剥除指定标签元素);人物名自动提取(显式字段/成对标签/说话人归属三层启发式,可开关);切换后重读校验并提示
- 七套工具主题:暖铜金(默认)/ 星夜 / 蓝图 / 磷光 / 深海 / 绯幕 / 月岩,顶栏下拉选择并记忆;绯幕以黑樱桃丝绒底、玫瑰色点缀、衬线标题与克制帷幕褶皱营造氛围,月岩采用石墨灰底、银白点缀、利落面板、无衬线标题与细微矿物颗粒;仅改变工具界面,不影响页面主题或导出内容
- 工程管理:本地存储、导入导出、多工程切换;页签栏右侧 GitHub 图标直达仓库源码与问题反馈
- 工厂重置:顶栏「⟲ 重置」三次确认后清空全部本地数据(工程/模板/主题偏好),恢复初始状态——重置前建议先「导出工程」备份
- AI 助手(可选):接 OpenAI 兼容接口生成自由 HTML 区内容与主题配色;API Key 输入框默认遮蔽(👁 切换显示),可勾掉「在本机记住 Key」改为仅本工程会话内使用、不写入 localStorage,切换工程不串用;填好 URL 与 Key 后可一键拉取模型列表(下拉选择,只读 /models 不发送对话请求,90 秒超时保护);Key 导出工程自动剔除
- 多种导出格式:开场白版、标记+正则脚本版,分段切换共用产物查看器(正则版预览省略超长 replaceString,选项字段完整可见);导出代码带语法高亮,长代码预览截断显示(复制/下载为完整内容);「👁 新窗看产物」本地直开最终成品做最后一眼核对;导出自检 + 兼容审查合并「付印审读」逐条列出,阻断级问题拦截复制/下载;v1.29 起导出页顶部有统计行(区块 / 开场白 / 图片 / 产物体积 / 最近修改)与「💾 一键备份全部工程」(合并 JSON、剔除 API Key,可经导入工程整包还原),并内嵌「原生酒馆不执行完整 HTML」说明与三档环境降级对照
- AI 编排技能(opg skill):Release 资产
opg-skill-vX.X.X.zip——SKILL.md + headless 生成 CLI(opg-gen.mjs,esbuild 打包零 npm 依赖,本机 Node 18+),让 ZCode / Claude Code 等 AI 编码助手不开可视化工具直接产出开场页:--schema拿 25 种区块字段与宏参考,--new/--template起步工程 JSON,编辑后--fenced(贴酒馆)/--regex(正则脚本)构建成品;与工具跑同一份生成引擎(HTML 产物逐字节一致),残缺 JSON 自动补齐,构建恒跑自检报告;解压到技能目录即装 - 角色卡导入:新建工程弹层「📥 从角色卡导入」——酒馆卡 PNG(tEXt chara / ccv3)/ JSON / CHARX 三路纯本地解析(手解 PNG chunk 与 zip 中央目录 + 原生 DecompressionStream,不引第三方库),V1 / V2 / V3 自动归一;按卡内容列映射预览(first_mes + alternate_greetings → 开场白占位列表、description + tags → 角色简介;卡自带 character_book 世界书不搬运——装卡时酒馆自动读取),勾选确认后生成工程;酒馆内可选「同时创建进酒馆」(createOrReplaceCharacter,待真机验证)
- 导出 HTML 反向导入:新建工程弹层「🧩 从导出 HTML 反向导入」——v1.32 起导出文档内嵌工程配置快照(data-opg-ver="2"),反向导入优先读快照完整还原:排版开关、颜色、字号、列数、封面音轨绑定等全部配置原样回位,多实例保留不合并,导出 → 导入无损往返;旧版导出(无快照 / 无版本锚)按区块作用域层切块轻量恢复——24 种区块按产物签名识别,卡池 / 彩蛋等脚本型内容从内联脚本原样取回,排版与样式类配置不随产物保留、导入预览逐区块标注「丢了什么」按默认回填,同类型多实例合并;认不出的段落整段进自由 HTML 区并标注待认领
- 数据兜底三件套:粘贴图片本地 canvas 压缩(限宽 + WebP/JPEG 质量递减,约 180KB 内,GIF 与已足够小的图原样保留);工程快照手动存 IndexedDB(与 localStorage 分开存储,恢复生成新工程,最多 20 份);多标签页同改一工程的冲突检测提示(不自动重载,建议先导出备份)
- 图片连通性检查:导出页付印审读区对全工程图片 URL(图库 / 漫画封面与页 / 头像 / 主题背景 / 自由 HTML 内 img)逐个
Image()探测,8 秒超时单独标注「可能只是慢」,失效仅提示不阻断导出 - 标题库写入:开场白区块的标题库草稿(可编辑文本框,手动维护,每行 序号|标题|描述)在酒馆内可一键写入世界书——书不存在自动建,已存在则同名条目两步重建、不动书内其它条目;插入位置支持 before_character_definition 与 outlet(酒馆助手 4.8.1+)
- AI 生成目标扩展:AI 助手页可选生成目标(自由 HTML / 开场白正文 / 角色简介 / 时间线节点 / 问答组),生成后追加进对应区块而非只写自由 HTML;最近 5 份草稿本机暂存(独立键不占工程 schema)可恢复可丢弃;酒馆内可选「酒馆当前源」渠道走 TavernHelper generate(embedded 环境守卫式,待真机验证)
- 酒馆深度适配:BGM 走酒馆助手音频播放器(切楼不重播,缺失降级本地播放);头像可选零 JS 方案(渲染器 char-avatar/user-avatar 自动注入);主题可分别跟随酒馆正文/引用/字体/强调色;导出自检覆盖
</script>逃逸、vw/vh 基准、position:fixed、Google Fonts 等已知坑
环境要求
- 使用工具本体:任意现代浏览器(Chrome / Edge / Firefox),无需安装任何依赖
- 在酒馆内渲染产物:SillyTavern(酒馆)+ 酒馆助手扩展(TavernHelper / JS-Slash-Runner),建议更新到较新版本
- 从源码构建:Node.js ≥ 18(构建依赖 esbuild 的环境要求)+ npm
安装步骤(直接使用,推荐)
- 打开 GitHub Releases,下载最新版
opg-vX.X.X.html - 双击该文件,用浏览器打开,即可开始编排
- 编排完成后在「导出」页复制开场白版代码,贴进角色卡的
first_mes或alternate_greetings - 酒馆内需已安装酒馆助手(TavernHelper / JS-Slash-Runner)扩展,产物才能被渲染
安装步骤(从源码构建)
- 克隆仓库并安装依赖:
npm install - 构建产物:
npm run build(自动压缩,构建后自动跑静态冒烟) - 打开
dist/index.html使用;改动src/时可用npm run watch自动重建(不压缩,便于断点调试) - 提交前跑完整闭环:
npm test(vitest 单元测试)→npm run lint(零依赖 lint)→npm run smoke(静态 + 无头浏览器双冒烟)
⚠️ 开发版src/index.html使用 ES Modules,直接双击会被浏览器 CORS 拦截,请使用构建产物或本地静态服务器。
⚠️ 每个 Release 挂三个资产:opg-vX.X.X.html为工具本体(单文件,下载即用);opg-nh-helper-vX.X.X.zip为「漫画导入助手」小包(免 clone 仓库,解压 → 双击安装协议 → 工具页点启动。这个 ZIP 不必单独下载——工具本体已内嵌同一份小包,在「📚 漫画导入」页点「📦 导出助手小包」即可导出,两者逐字节一致);opg-skill-vX.X.X.zip为 AI 技能包(解压进 ZCode / Claude Code 等的技能目录,AI 凭工程 JSON 直接产出开场页,本机需 Node 18+)。pushv*tag 会自动触发完整流水线(lint → 测试 → 构建 → 双冒烟 → 建 Release)。
⚠️ 工具页离线打开时飞书字体 CDN 加载失败会回落系统字体,不影响任何功能;无 API 环境下组件自动降级显示占位内容。
| 场景 | 操作 |
|---|---|
| 从零做一张开场页 | 「模板配置」页新建工程 → 选 12 套官方模板之一套用布局 → 逐区块改文案 / 图片 → 「预览」页切 📱 / 🖥 与 🌙 / ☀️ 复核 → 「导出」页复制①开场白版 |
| 贴进角色卡 | 复制①开场白版整段(保留代码围栏与 body 标签)→ 酒馆角色卡 first_mes / alternate_greetings |
| 做开场白选择器 | 配置页加「开场白选择」区块 → 选卡片式 / 列表式 / 封面墙 → 逐项填绑定标题 + 封面图与联动音轨(「📋 按占位列表补标题」可一键补)→ 按需开排除标签过滤与人名提取 → 导出 |
| 从角色卡开工 | 顶栏「新建」→「📥 从角色卡导入」→ 选 PNG / JSON / CHARX(V1/V2/V3 自动识别)→ 勾选映射(开场白 / 角色简介)→ 生成工程后微调 → 导出 |
| 把已导出的开场页导回工程 | 顶栏「新建」→「🧩 从导出 HTML 反向导入」→ 粘贴产物完整文档 → 勾选认回的区块 → 生成工程(本版本导出经配置快照完整还原;旧导出轻量恢复并标注按默认项;认不出的段落原样进自由 HTML 区待认领) |
| 把一本漫画填进开场页 | 「📚 漫画导入」页启动本机服务 → 贴 nhentai 画廊链接抓全本 → 勾选页面 / 去尾 N 页 → 一键写入漫画区块 → 「预览」页核对 |
| 用正则方案嵌入 | 「导出」页②生成「标记 + 正则脚本」→ 标记文本贴进开场白或世界书条目 → 酒馆「扩展 → 正则」导入下载的 JSON |
| 让 AI 帮忙出内容 | 「AI 助手」页填 OpenAI 兼容 URL + Key → 生成自由 HTML 内容与主题配色 |
| 让 AI 直接编排整页(skill) | Releases 下载 opg-skill-vX.X.X.zip 解压到 AI 编码助手技能目录(如 ~/.claude/skills/ 或 .zcode/skills/)→ 对 AI 说「用 opg 给某某角色生成一个开场页」——AI 走 --template / --new 起步、改工程 JSON、--fenced 出成品(本机需 Node 18+) |
| 换工具界面配色 | 顶栏主题下拉:暖铜金 / 星夜 / 蓝图 / 磷光 / 深海 / 绯幕 / 月岩,选择自动记忆;仅改变工具界面,不影响导出页面 |
| 重置全部本地数据 | 顶栏「⟲ 重置」三次确认(清空工程 / 模板 / 主题偏好,建议先「导出工程」备份) |
opening-page-generator/
├── src/ # 源码(开发用;ES Modules,直接双击会被 CORS 拦截)
│ ├── index.html # 工具壳:顶栏 / 页签 / 页面容器(版本号占位由 build.js 注入)
│ ├── css/tool.css # 工具界面样式(含 7 套工具主题)
│ └── js/
│ ├── main.js # 入口:顶栏事件 / 工具主题下拉 / 工厂重置
│ ├── utils.js # 工具函数(转义 / 代码高亮 / 模态框 / toast)
│ ├── defs.js # 纯数据汇总出口:主题预设 / 区块预设 / 工具主题 / defaultProject
│ ├── defs/ # 大体量数据子模块(经 defs.js 统一导出)
│ │ ├── blocks.js # 区块定义 BLOCK_DEFS / BLOCK_ORDER / CORE_TYPES
│ │ ├── complib.js # 组件库 COMP_LIB(59 个组件 HTML)
│ │ └── templates.js # 12 套官方模板
│ ├── themes.js # 主题材质枚举 / 预设补丁与匹配 / 共用纹理(纯函数)
│ ├── macros.js # 宏替换引擎(预览用,随机结果带缓存)
│ ├── project.js # 工程管理(分键存储 / 迁移 / 撤销重做 / 导入导出 / IndexedDB 快照)
│ ├── search.js # 全局搜索替换(纯函数)
│ ├── fontdetect.js # 字体检测(纯函数)
│ ├── cardImport.js # 角色卡导入解析(PNG / JSON / CHARX → 工程草稿,纯函数)
│ ├── docImport.js # 导出 HTML 反向解析(产物 → 工程草稿,纯函数)
│ ├── gen/ # 生成引擎
│ │ ├── index.js # 入口:build / 完整文档 / 围栏 / 正则脚本 / 导出自检
│ │ ├── css.js # 产物 CSS 生成
│ │ ├── body.js # 产物 HTML 结构生成(tx / raw 宏双轨)
│ │ ├── scripts.js # 产物运行时脚本(灯箱 / BGM / 酒馆助手交互)
│ │ └── TAVERN_API.md # 生成脚本依赖的酒馆助手 API 契约(守卫 / 降级矩阵)
│ └── ui/ # 界面渲染
│ ├── core.js # UI 壳 + renderAll 总入口 + 预览挂载 + 页签 / 快捷键
│ ├── renderConfig.js # 配置页(主题 / 宏 / 区块列表拖拽 / 搜索替换 UI)
│ ├── blockEditors.js # 25 种区块的编辑表单 + 组件库选择器
│ ├── renderExport.js # 导出页
│ ├── renderAI.js # AI 助手页(连接模式分流)
│ ├── renderNh.js # 漫画导入页(服务探活 / 抓取 / 勾选 / 写入区块)
│ ├── renderHelp.js # 说明页
│ ├── shared.js # 跨页辅助(列表编辑器 / 字体探测)
│ └── extBridge.js # 扩展版桥接(角色卡写入 / 酒馆 AI 通道)
├── tests/ # 单元测试(vitest,18 个测试文件,含 themes.test.js 页面主题、uithemes.test.js 工具主题、helperpack.test.js 助手小包 ZIP 编码、cardImport.test.js 角色卡导入、docImport.test.js 反向导入、opgcli.test.js headless CLI)
├── dist/index.html # 构建产物(自包含单文件,下载即用)
├── skill/ # 「opg skill」技能源码
│ └── SKILL.md # 技能正文(CLI 由 pack-skill.mjs 打包注入后随 Release 分发)
├── scripts/ # 辅助脚本
│ ├── nh-import.mjs # nhentai 导入(页面服务 / CLI / CONNECT 隧道代理)
│ ├── nh-install.mjs # 注册 / 移除 opg-nh:// 本地协议
│ ├── opg-nh.bat # 协议注册双击批处理(进助手小包,检出 CRLF)
│ ├── nh-lib.mjs # 抓取与解析公共库
│ ├── opg-gen-cli.mjs # headless 生成 CLI 源码(type:commonjs 下仅 vitest/esbuild 可加载,运行形态是打包产物)
│ ├── smoke-static.mjs # 构建后静态冒烟
│ ├── smoke-browser.mjs # 无头浏览器冒烟(playwright)
│ ├── helper-pack.mjs # 助手小包文件清单 + store-only ZIP 组装(纯函数)
│ ├── pack-helper.mjs # 打包「漫画导入助手」小包(构建期内嵌与 Release 资产共用同一份字节)
│ └── pack-skill.mjs # 打包「opg skill」(esbuild bundle 生成引擎 + 同一 zipStore;不内嵌工具单文件)
├── .github/ # 工作流(CI / tag 自动发版 + Release 说明模板)+ issue 模板
├── reference/ # 外部参考资料(酒馆助手文档 / API 类型,只读不进构建)
├── build.js # 构建脚本(esbuild + 产物体积预算)
├── lint.js # 零依赖 lint
├── AGENTS.md # AI 协作指南(硬约束 / 常见任务配方 / 发版配方)
├── PITFALLS.md # 防踩坑清单(真实踩坑沉淀)
├── package.json
└── LICENSE # CC BY-NC-SA 4.0
📚 相关文档
| 文档 | 内容 |
|---|---|
| 工具内「使用说明」页 | 区块详解 / 嵌入方式 / 宏支持 / 漫画导入操作 |
skill/SKILL.md |
「opg skill」正文——headless 用法(命令表 / 工程 JSON 结构 / 宏表 / 交付要点) |
src/js/gen/TAVERN_API.md |
生成脚本依赖的酒馆助手 API 契约(守卫 / 降级矩阵) |
AGENTS.md |
AI 协作指南(硬约束 / 常见任务配方 / 发版配方) |
PITFALLS.md |
防踩坑清单(真实踩坑沉淀,AI 协作检查表) |
🛠 自定义与注意事项
自定义
- AI 协作:改动前先参考根目录
AGENTS.md(硬约束清单与常见任务配方);实操踩坑检查表见PITFALLS.md;生成脚本的酒馆助手 API 契约见src/js/gen/TAVERN_API.md - 添加组件:编辑
src/js/defs.js中的COMP_LIB - 添加主题预设:编辑
src/js/defs.js中的THEME_PRESETS;材质枚举、字体回落、预设补丁/匹配与共用纹理见src/js/themes.js,新增材质的产物版式在src/js/gen/css.js中同步 - 添加区块类型:编辑
src/js/defs.js的BLOCK_DEFS+BLOCK_ORDER,渲染逻辑在src/js/gen/目录
注意事项
- 开发版
src/index.html使用 ES Modules,直接双击会被浏览器 CORS 拦截,请使用构建产物或本地静态服务器 - 构建产物
dist/是自包含单文件,可直接分发给酒馆用户;每次发版在 Releases 挂产物(pushv*tag 自动触发) - 工具页顶栏常显版本号与构建日期,页签栏最右侧 GitHub 图标可直达仓库源码与问题反馈;离线打开时飞书字体 CDN 加载失败会回落系统字体,不影响任何功能
- 酒馆需安装「酒馆助手(TavernHelper / JS-Slash-Runner)」扩展;无 API 环境下组件自动降级显示占位内容
Q:双击 src/index.html 打开是空白?
A:开发版使用 ES Modules,直接双击会被浏览器 CORS 拦截。请改用构建产物 dist/index.html,或起一个本地静态服务器。
Q:产物贴进酒馆后没有样式 / 区块不显示? A:产物依赖酒馆助手(TavernHelper / JS-Slash-Runner)扩展渲染;未安装或当前环境无对应 API 时,组件会自动降级显示占位内容,属预期行为。
Q:开场页里的字体或图标会请求外部资源吗? A:产物自包含,样式与脚本全部内联,图标使用 emoji / 内联 SVG。仅工具页本身在离线打开时飞书字体 CDN 会加载失败并回落系统字体,不影响任何功能。
Q:我的工程数据存在哪?会被上传吗?
A:全部存在浏览器 localStorage(openingPageGen_* 键,每个工程独占一个键,保存时只写改动过的工程),本工具无服务端、数据不出本机。粘贴超过 200 KB 的 base64 内嵌图片时会提示改用图床链接,保存失败时提示会指出体积最大的区块。换浏览器或清理站点数据会丢失,重要工程请先用「导出工程」备份。
Q:AI 助手的 API Key 会写进导出的页面吗? A:不会。Key 默认只存本机;勾掉「在本机记住 Key」后仅本次会话使用、不写入 localStorage;导出工程时 Key 会被自动剔除。
Q:想把已导出的开场页 HTML 导回工程继续编辑? A:新建工程弹层的「🧩 从导出 HTML 反向导入」贴入产物即可。本版本导出的页面内嵌配置快照,勾选的区块连同排版开关/颜色/字号/列数/封面音轨绑定完整还原(无损往返);旧版导出轻量恢复——排版与样式类配置不随产物保留,导入预览会逐区块标注,按默认值回填。认不出的段落原样进自由 HTML 区待手动认领,解析纯本地进行。
Q:构建报「产物体积超预算」?
A:build.js 设有体积预算线:超 1024 KB 告警、超 1280 KB 构建失败(CI 会挡下)。请精简产物,或显式调高预算并把理由写进提交说明。
Q:漫画导入抓不到内容?
A:抓取由本机服务完成(npm run nh-serve,只监听 127.0.0.1)。Node 不走系统代理,请在页面「抓取代理」填入本机代理地址(Clash 默认 http://127.0.0.1:7890)。若不想 clone 仓库,在「📚 漫画导入」页点「📦 导出助手小包」拿到 ZIP(工具本体已内置,无需另找下载),解压后双击「安装协议.bat」再回来点启动(仍需本机装有 Node 18+)。
Q:反馈问题时需要提供什么? A:请走 Issue 模板,带上工具版本(顶栏 logo 右侧或「使用说明」页顶部的「vX.X.X · 构建于 日期」)、酒馆助手版本与使用环境。
📋 版本历史表(29 个里程碑,点击展开)
| 版本 | 日期 | 更新内容 |
|---|---|---|
| v1.32.3 | 2026-11-08 | 十四处修复排查(多路审查代理并行扫 + 逐条读源核实)。产物层:导出 HTML 反向导入的 salvage 路径,随机事件行文本与骰子表达式补做 unesc(导出经 esc,实体残留会让再次导出变双转义);时间线当前节点脉冲、年龄闸门面板入场纳入 prefers-reduced-motion 豁免;welcome 荧光笔划入延迟以同特异性写进简写(此前被单值 .08s delay 规则压过,.3s 时序失效);组件库「AI 加载动画」补定义 opg-dots keyframes(此前引用不存在的 pulse,三点永不闪烁,随赛博模板一起发布)。工具层:全局搜索替换补扫工程级字段(正则标记与自定义宏 k/v,UI 支持直接替换);确认弹窗 await 期间经键盘切换工程的陈旧写入补守卫(删区块/删工程/漫画批量导入/清空页面/列表删项五处,与漫画导入页 v1.32 同款);标题库草稿「📋 复制 / 📤 写入世界书」改 container 事件委托(列表增删重建 DOM 后按钮此前静默失灵);标题库写入世界书补防重入(连点不再并发 delete+create 落重复条目)与撤销快照;字体下拉不再把自定义字体名 unshift 进会话级检测缓存(此前跨工程出现假「已装字体」候选、__custom__ 分支成死代码);migrate 的 blocks 遍历补残缺项守卫(null 项此前让启动把整工程当损坏剔除,normalize 的剔除守卫永远轮不到)。脚本/构建层:nh CLI --pages/--skip-last 传空串不再静默回落全本导出;opg skill CLI -o 缺值报错(此前静默打到 stdout)、多余位置参数报错;release.yml 增加 tag ↔ package.json 版本一致性闸门(typo tag 会产出资产名互相矛盾的 Release);浏览器冒烟把字体外链(飞书 CDN)本地打发,断网/代理抖动不再把硬门槛判红。测试 555→562(salvage unesc 往返、marker/macros 搜索替换、migrate 残缺项、CLI 两错误路径、组件动画自包含;紫夜 classic 字节快照随两处 CSS 修复更新)。证据等级:预览过(lint 通过、562 测试全过、构建+双冒烟通过) |
| v1.32.2 | 2026-11-08 | 优化建议落地四连:① 开场白搜索框/👁 在工具预览中生效——预览构建注入一段无 API 依赖的页面级小脚本(搜索过滤与运行时 applyFilter 同规则;导出态不注入,运行时脚本全权接管避免双监听),👁 在预览读不到角色卡全文,点击改为给诚实提示弹层而非无响应;说明页与功能明细同步口径。② 全局搜索替换的逐条定位/输入关键词不再全量重建区块列表(此前每步导航与每次输入关键词都重建整页编辑器 DOM,区块多时明显卡顿)——弹窗打开期间遮罩挡住结构操作、Ctrl+Z 被守卫拦下,blockIdx 不会漂移,定位只展开目标 + 滚动 + 描边闪烁;替换动作(数据变更)仍走重建。③ 工厂重置首次确认弹窗补注「IndexedDB 快照不在清理范围,重置后仍可恢复」——快照本就是重置后的兜底,此前文案会让用户误以为一并清掉。④ esbuild postinstall 经 allowScripts 正式放行——npm ci 后首次 npm test 偶发 5 errors/少文件的抖动消失(两轮冷启动 + 三轮连跑全绿)。测试 554→555(预览小工具注入/导出不注入断言;👁 热区计数改按 -gprev 锚定,预览脚本里的字面量引用不再误入计数)。证据等级:预览过(lint 通过、555 测试全过、构建+双冒烟通过) |
| v1.32.1 | 2026-11-08 | 十一处修复排查:工具层——导出页统计「开场白 N 条」改按占位列表行数计(此前数封面/音轨绑定配置数,未配置绑定的工程恒显 0);全局搜索替换补扫开场白条目的绑定标题 entries[].title(与 v1.30.1 的 titleBookDraft 漏扫同类);AI 页「获取模型列表」90 秒 await 期间切工程的陈旧写入补守卫(与生成按钮同款,不再静默丢结果);AI 生成早退分支(输出为空/区块缺失/问答解析失败)补刷「最近草稿」列表;漫画导入页「按页码选」上限改取真实页码最大值——HTML 解析 rescue 的页码缺口场景(如 1,2,4)此前输入 4 会被按总数 3 钳制选不中。脚本层——nh-serve 畸形请求行不再杀死服务进程(new URL 移入 try,回 400);CLI --pages / --skip-last 缺值从静默导出全本改为报错退出;opg-nh 协议注册脚本未知子参数从静默安装改为报错;opg skill CLI 起步命令组合 --fenced / --regex 不再被静默忽略(直接输出构建产物)。构建层——watch 首建纳入并发防护(首建进行中的源码变更不再并发第二个 build);静态冒烟体积断言改按 UTF-8 字节计(与 build.js 同口径,中文密集产物此前被低估 2-3 倍)。新增 3 项回归(551→554)。证据等级:预览过(lint 通过、554 测试全过、构建+双冒烟通过) |
| v1.32.0 | 2026-11-08 | 五项体验收口 + 「opg skill」AI 技能包。五项体验收口:导出 HTML 反向导入 v2——产物内嵌精简工程配置快照(data-opg-ver 1→2,排版开关/颜色/字号/列数/封面音轨绑定随产物保留),反向导入优先读快照完整还原(多实例保留不合并),旧导出维持 salvage 轻量恢复且导入预览逐区块点名「丢了什么」;开场白选择器加搜索框(≥6 条出现,按标题/描述/人名纯前端过滤)与 👁 全文预览弹层(先读全文再切换/填入/选中,动作按点击行为分派),当前开场白补 aria-current;封面/音轨改按绑定标题对应开场白(卡里插删/重排不错位,序号回落兼容旧数据,编辑器可一键从占位列表补标题);无障碍顺手补——漫画阅读器 dialog 语义 + 打开焦点移入、闸门隐藏开关可键盘聚焦(六主题 focus-visible 描边)、配置页封面/音轨行窄屏折单列;数据兜底——粘贴图片本地 canvas 压缩(限宽 + WebP/JPEG 至约 180KB)、工程快照手动存 IndexedDB(顶栏「📸 快照」,恢复生成新工程,20 份上限)、多标签页同改工程冲突提示。新增 21 项回归(530→551:五项体验收口 13 项 + opg skill 8 项)——反向导入无损往返与快照损坏回落 / 标题绑定 gen+运行时 / 搜索框与预览入口 / v2 快照注入(正则版同源) / 粘贴压缩前置校验;开场白搜索/预览与快照往返的真机行为待真机验证;另新增「opg skill」AI 技能包:Release 挂第三个资产 opg-skill-*.zip(SKILL.md + esbuild 打包的单文件生成 CLI,零 npm 依赖,Node 18+ 直跑),解压进 ZCode / Claude Code 等技能目录后 AI 即可 headless 产出开场页——--schema 输出 25 种区块字段参考与内置宏表,--new / --template 起步工程 JSON,--fenced / --regex 构建成品,产物自检 + 兼容审查恒走 stderr,工程 JSON 经工具导入同一路径补齐(残缺 JSON 直接吃),与工具跑同一份 src/js/gen 引擎、HTML 产物逐字节一致,不内嵌工具单文件(改 CLI 重跑 pack:skill 即可) |
| v1.31.0 | 2026-11-08 | 移除「返回开场页」角色脚本功能(导出页 ③ 整块下线):该功能以独立角色脚本 JSON 注入酒馆助手脚本栏,与正则/开场白两条主路径耦合弱、真机验证负担重,按使用反馈砍掉——删 Gen.backHomeScript 生成器、slots/back-home.json 插槽目录、导出页 ③ 面板与产物源、工程 schema 的 backHome 配置(normalize 按 statusbar/mvu 先例清理旧存档残留字段,无需迁移);导出格式回归两段(开场白版 / 标记+正则),TAVERN_API.md 移除角色脚本形态规则与相关登记,README 入口表/功能明细/使用指南/FAQ/结构树/致谢同步;v1.29/v1.30.1 已发布的 Release 不受影响(历史版本产物含该脚本仍可用,仅新版本不再提供) |
| v1.30.1 | 2026-11-08 | 三区审查修复十三连:产物层——开场白按钮模式页内点选照常切换(此前落进描边死分支,契约「按钮仅快捷方式」不成立);开场白「填入输入框/直接发送」动态文本包引号转义(文本含 | 此前被酒馆解析器当命令分链静默截断,宏 {{...}} 内管道不受影响);随机事件导出与预览同轨转义(导出保留宏)。数据层——反向导入开场白保留空段(空描述行不再被静默改写错位,全空行占位保证行与封面下标对齐);全局搜索替换补扫标题库草稿(titleBookDraft)。工具层——确认弹窗焦点移入模态(Enter 不再复激活背景按钮致一次确认两次执行连删两条);顶栏「导出工程」接回真实方法(此前调用不存在的方法按钮完全失灵);漫画导入页签切入重刷目标下拉(配置页增删排序区块后不再写错 comic 区块);组件库选择器/标题库写入/导入计划等五处弹层与 toast 层级统一置顶(此前被主题纹理层压住);AI 页六处写入补拍撤销快照(AI 生成内容可撤销可重做);watch 首建失败不再杀监听;配置页实时预览补齐预览页同款圆角投影样式;TAVERN_API.md 补 slashArg 转义契约与按钮序号 0 起口径;新增 5 项回归(533→538)——slashArg 真机转义行为待真机验证 |
| v1.30.0 | 2026-11-08 | 第二批五连:角色卡导入(PNG tEXt chara/ccv3 手解 chunk / JSON / CHARX 手解 zip 中央目录 + 原生 DecompressionStream,V1/V2/V3 归一,映射预览勾选确认,可选同时创建进酒馆);导出 HTML 反向解析(data-opg-ver 格式版本锚 + 按区块作用域层切块,24 类产物签名识别,卡池/彩蛋等脚本型内容从内联脚本原样取回,认不出整段进自由 HTML 待认领,旧导出按尽力识别处理);图片连通性检查(付印审读区 Image() 逐 URL 探测,8 秒超时单独标注);AI 生成目标扩展(五目标追加进对应区块 + 最近 5 份草稿恢复 + 酒馆内「酒馆当前源」渠道);标题库写入世界书(自动建书 / 同名条目两步重建,position 支持 outlet);新增 22 项回归(511→533)——角色卡直建酒馆 / 标题库写入 / AI 酒馆源渠道 / 反向导入真机还原,均待真机验证 |
| v1.29.0 | 2026-11-08 | 工程数据 schema 版本锚点(defaultProject 落 schemaVersion,migrate 分段迁移,旧工程首开自动升版)与 updatedAt 最近修改时间;返回开场页脚本表单化——导出页 ③ 可配按钮文案/主色/强调色/图片模式/出现时机(第几张 swipe 起),生成时烘焙进模板 CFG(全默认逐字透传,模板即真相不变);导出页新增统计行(区块/开场白/图片/产物体积/最近修改)与「💾 一键备份全部工程」(合并 JSON 剔除 API Key,可经导入工程整包还原);AI 模型下拉支持关键词本地过滤;自由 HTML 完整权限警示常驻(无脚本时也提示);导出页内嵌「原生酒馆不执行完整 HTML」说明与三档环境降级对照(按酒馆 1.19 源码核对清洗行为);lint 新增 GNUM 双源一致性校验;新增 9 项回归(502→511) |
| v1.28.0 | 2026-11-07 | 导出页付梓台重构:三种导出格式(开场白版/标记+正则/返回开场页脚本)分段切换 + 共用产物查看器,消掉此前 ①② 两卡重复渲染同一份围栏文档的浪费;正则版预览改为脚本 JSON 本体并把超长 replaceString 缩略为字符数说明——placement/runOnEdit/maxDepth 选项字段不再被挤出 2 万字符截断线,标记与选项变更实时重渲染,补「复制脚本 JSON」按钮(此前仅可下载);新增「👁 新窗看产物」本地直开最终成品做最后一眼核对;导出自检 + 兼容审查合并「付印审读」逐条列出(阻断红/提示黄徽章,有阻断自动展开并照旧拦截复制/下载),头部常驻审读钤印 + 工程名/体积徽章;内联样式全部收进 tool.css,全用现有设计令牌,7 套工具主题零改动 |
| :---: | :---: | :--- |
| v1.27.1 | 2026-11-07 | 整体排查修复一批缺陷:开场白运行时支持同类多实例(第二/之后的列表不再停留占位文本,点击行为、封面音轨、卡片风格按各自实例生效;停用的开场白区块不再向产物注入运行时脚本、注册按钮与 3 秒轮询);按钮模式输入序号恰好等于开场白数时误放行导致切换失败(有效域 0..N-1);更新日志行内容预览不再恒显字面宏(补宏双轨);主题主/强调/文字三色与字体同信任面清洗,分享工程 JSON 的恶意色值无法逃逸 <style>;全局搜索替换补齐闸门离开文案、卡池、彩蛋/揭示提示、漫画封面、开场白封面音轨等漏扫字段,「替换当前」对漫画页与开场白项生效;组件库选择器点组件名(加粗文字)可正常插入;搜索替换与写卡弹层不再把统一确认框盖在底下,自绘弹层打开期间 Ctrl+Z/Esc 不再穿透改写已回退的数据;漫画导入「应用到区块」撤销时序修正(此前写入态不可撤销恢复);移除 BGM 无任何效果的「酒馆命令集成」复选框;nhentai CLI 带空格页码范围(1 - 20)不再被截成端点、页码缺口画廊全本导出不再丢尾页、--pages 解析为空显式报错而非静默全本;watch 模式构建加进行中互斥防陈旧 dist;浏览器冒烟异常中断时回放中断前页面报错;复制剪贴板被拒时回落 execCommand;新增 11 项回归(493→504) |
| v1.27.0 | 2026-11-03 | 工程存储分键化与撤销栈提速:每个工程独占 openingPageGen_v1_proj_<id> 键(索引键管顺序),保存只序列化有变化的工程,旧整表单键首次加载自动迁移(空间不足自动回滚保留旧格式,数据不丢);撤销快照改存 JSON 字符串,逐键输入每次少一次序列化/反序列化;任一输入框出现 ≥200 KB 的 base64 内嵌图片即时提醒改用图床链接,保存失败提示指出体积最大的区块;组件插入修复未定义变量 NL(光标在内容中间插入会报错)并清理死分支;defs.js(126 KB)拆出 `defs/blocks |
| v1.26.1 | 2026-10-26 | 修复 v1.26.0 的跨平台字节不一致:CI(Linux 检出 LF)与本地(Windows 检出 CRLF)打出的助手小包差 416 字节,根因是 .bat 行尾随 git autocrlf 浮动。改为在 helperFiles 出口统一归一化行尾(.bat → CRLF、其余 → LF),两种检出现在产出逐字节相同的 ZIP;补 .gitattributes 固定仓库内文本为 LF、.bat 检出 CRLF;新增 2 项行尾回归 |
| v1.26.0 | 2026-10-26 | 「漫画导入助手」小包内置进工具单文件:构建期把 ZIP 以 base64 注入(OPG_HELPER_ZIP),「📚 漫画导入」页新增「📦 导出助手小包」按钮,下载即得与 Releases 资产逐字节一致的 ZIP,不必再去 Releases 找第二个文件;文件清单与 ZIP 编码收敛到单一模块 scripts/helper-pack.mjs(零依赖 store-only + 固定时间戳,同输入同字节),build.js 内嵌与 pack:helper 资产共用;新增 14 项小包编码回归 + 静态冒烟「内嵌 === 现组装」防漂移硬闸 + 浏览器冒烟真实下载字节比对 |
| v1.24.0 | 2026-10-26 | 主题风格卡重排并上收背景:theme.bg 统一管理底色(旧工程自动迁移),预设升级为整套观感包;悬停试穿、选中态与「已自定义(基于 X)」标识、主题进撤销栈;组件库通用强调位改跟主题色;新增对比度警示 |
| v1.23.0 | 2026-10-25 | 新增深色工具主题「绯幕」「月岩」,工具主题增至 7 套;新主题配套弹窗、键盘焦点与窄屏横向页签;仅改变工具界面,不影响页面主题或导出内容;新增主题令牌、对比度与切换持久化回归测试 |
| v1.22.1 | 2026-10-25 | 修复双预览缓存不同步、区块编辑撤销误回退、开场白点击行为被迁移覆盖、AI Key 记住开关与跨工程串用;修复漫画翻页空白、更新日志全角分隔符、本地 BGM 自动下一首;补充回归测试与冒烟断言 |
| v1.22.0 | 2026-10-04 | 「返回开场页」脚本模板外置到 slots/back-home.json,导出页显示当前模板来源,按钮样式由模板自身定义 |
| v1.21.0 | 2026-10-04 | 漫画导入支持本机代理(零依赖 CONNECT 隧道);新增「漫画导入助手」独立小包(Release 第二资产) |
| v1.20.0 | 2026-10-04 | 发布闭环与质量基建:push tag 自动发版、CI 全量检查、产物体积预算、静态 + 浏览器双冒烟、顶栏常显版本号 |
| v1.19.0 | 2026-10-04 | 外部来源清零与安全加固:图标改 emoji / 内联样式、API Key 不落盘、请求超时、按钮 type 与可访问性修补 |
| v1.18.0 | 2026-10-04 | 新增导出③「返回开场页」角色脚本:非首页自动注入返回按钮,点击切回并停掉联动音轨 |
| v1.17.0 | 2026-09-30 | 漫画区块编辑器加「清空全部页面」一键删除导入漫画(确认 + 可撤销) |
| v1.15.0 | 2026-09-30 | 新增「📚 漫画导入」页签:nhentai 画廊整本一键填入漫画区块 |
| v1.14.0 | 2026-09-30 | 新增「漫画阅读器」区块(条漫 / 翻页双模式,封面卡 / 横幅双入口) |
| v1.13.0 | 2026-09-29 | AI 助手接入酒馆主 AI(「酒馆当前连接」静默生成)+ 产物层高危修复 |
| v1.12.0 | 2026-09-29 | 扩展版桥接就绪:导出页「📤 写入角色卡」(独立单文件版自动休眠) |
| v1.11.0 | 2026-09-29 | 开场白选择增强:封面墙 / 排除标签过滤 / 人名自动提取 / 联动音轨与切换校验 |
| v1.10.0 | 2026-09-26 | 入场闸门新增剧场帷幕 / 封印法阵 / 机密金库 / 生物识别四主题(共六主题) |
| v1.9.0 | 2026-09-25 | 初始版本:可视化区块编排 + 自包含单文件导出 |
本代码为纯 AI 编写,作者不对其作任何明示或默示的担保;使用产生的任何问题由使用者自行承担。 本脚本为免费的酒馆玩家向工具,与 SillyTavern 及酒馆助手官方无关。
本项目采用 CC BY-NC-SA 4.0(署名—非商业性使用—相同方式共享 4.0)协议授权,完整法律文本见 LICENSE。
- 酒馆助手(TavernHelper / JS-Slash-Runner)——本工具全部产物所依赖的运行时,官方文档:https://n0vi028.github.io/JS-Slash-Runner-Doc/
🐧 感谢使用!遇到问题欢迎 提 Issue(模板会引导你带上版本信息)。