Skip to content

About

拖拽区块可视化编排 SillyTavern 角色卡开场页的纯本地工具:25 种区块 / 59 组件 / 12 套模板,导出自包含单文件 HTML,含漫画阅读器、开场白选择、返回开场页脚本与 AI 助手。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

🐧 企鹅的酒馆开场页生成器

拖拽区块,可视化编排 SillyTavern 角色卡开场页 —— 产出自包含单文件 HTML,零手写代码、零运行时依赖

Release CI License Node Stars Last Commit

项目简介 · 功能特性 · 安装 · 使用指南 · 仓库结构 · 常见问题 · 版本历史 · 声明与授权 · 致谢


📖 项目简介

为 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 秒超时单独标注「可能只是慢」),失效仅提示不阻断
💾 代码处理 导出代码带语法高亮,长代码预览截断显示,复制 / 下载为完整内容

入口四 · 「📚 漫画导入」页 —— nhentai 整本直填

特性 说明
🔌 本机服务 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 找第二个文件

入口五 · 「🤖 AI 助手」页 —— 可选能力

特性 说明
🔑 兼容接口 接 OpenAI 兼容接口,生成自由 HTML 区内容与主题配色
🙈 Key 保护 输入框默认遮蔽(👁 切换显示);关闭「在本机记住 Key」立即清除持久化值、保留本工程会话内使用,切换工程不串用;导出工程自动剔除
📋 模型列表 填好 URL 与 Key 后可一键拉取 /models 下拉选择,支持关键词本地过滤(只读,不发送对话请求,90 秒超时保护)
🎯 生成目标 可选生成目标:自由 HTML / 开场白正文 / 角色简介 / 时间线节点 / 问答组——生成后直接追加进对应区块;最近 5 份草稿本机暂存可恢复或丢弃;酒馆内打开工具时可选「酒馆当前源」走酒馆助手 generate 通道(与自带 API 配置并存,待真机验证)

独立分发 · 「opg skill」—— AI 编码助手 headless 生成

特性 说明
🤖 技能包 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

安装步骤(直接使用,推荐)

  1. 打开 GitHub Releases,下载最新版 opg-vX.X.X.html
  2. 双击该文件,用浏览器打开,即可开始编排
  3. 编排完成后在「导出」页复制开场白版代码,贴进角色卡的 first_mes 或 alternate_greetings
  4. 酒馆内需已安装酒馆助手(TavernHelper / JS-Slash-Runner)扩展,产物才能被渲染

安装步骤(从源码构建)

  1. 克隆仓库并安装依赖:npm install
  2. 构建产物:npm run build(自动压缩,构建后自动跑静态冒烟)
  3. 打开 dist/index.html 使用;改动 src/ 时可用 npm run watch 自动重建(不压缩,便于断点调试)
  4. 提交前跑完整闭环: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+)。push v* 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 挂产物(push v* 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。

🙏 致谢


🐧 感谢使用!遇到问题欢迎 提 Issue(模板会引导你带上版本信息)。

About

拖拽区块可视化编排 SillyTavern 角色卡开场页的纯本地工具:25 种区块 / 59 组件 / 12 套模板,导出自包含单文件 HTML,含漫画阅读器、开场白选择、返回开场页脚本与 AI 助手。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages