From d92dc003666794b7c9d07bb9fe696020b63c5834 Mon Sep 17 00:00:00 2001 From: Civinar-Riley Date: Sat, 7 Nov 2026 21:52:51 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E8=A7=84=E8=8C=83=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E5=B7=A5=E7=A8=8B=20+=20=E7=B2=BE=E7=AE=80=E6=B5=8B=E8=AF=95?= =?UTF-8?q?=E5=86=97=E4=BD=99=20+=20PITFALLS=20=E8=A1=A5=E5=BD=95=EF=BC=88?= =?UTF-8?q?504=E2=86=92502=EF=BC=89=E2=80=94=E2=80=94=E4=B8=A4=E8=B7=AF?= =?UTF-8?q?=E5=AE=A1=E8=AE=A1=EF=BC=88=E6=B5=8B=E8=AF=95=E5=86=97=E4=BD=99?= =?UTF-8?q?=20/=20=E7=BB=93=E6=9E=84=E4=B8=8E=E6=96=87=E6=A1=A3=E4=B8=80?= =?UTF-8?q?=E8=87=B4=E6=80=A7=EF=BC=89=E9=80=90=E6=9D=A1=E6=A0=B8=E5=AE=9E?= =?UTF-8?q?=E5=90=8E=E8=90=BD=E5=9C=B0=E3=80=82=E6=B5=8B=E8=AF=95=E7=B2=BE?= =?UTF-8?q?=E7=AE=80=EF=BC=9A=E5=88=A0=202=20=E4=B8=AA=E8=A2=AB=E5=AE=8C?= =?UTF-8?q?=E5=85=A8=E6=B6=B5=E7=9B=96=E7=9A=84=20it=EF=BC=88project=20?= =?UTF-8?q?=E5=AF=B9=E6=AF=94=E5=BA=A6=E8=BE=BE=E6=A0=87=E9=A1=B9=E7=94=B1?= =?UTF-8?q?=20themes.test.js=20=E5=90=8C=E6=96=AD=E8=A8=80=E6=9B=B4?= =?UTF-8?q?=E4=B8=A5=E8=A6=86=E7=9B=96=E2=80=94=E2=80=94=E9=82=A3=E8=BE=B9?= =?UTF-8?q?=E6=B5=8B=20textColor/accent/primary=20=E4=B8=89=E8=89=B2=20?= =?UTF-8?q?=C3=97=20=E5=8F=8C=E5=BA=95=E8=89=B2=E3=80=81=E8=BF=99=E8=BE=B9?= =?UTF-8?q?=E5=8F=AA=20textColor=20=C3=97=20=E4=B8=BB=E5=BA=95=E8=89=B2?= =?UTF-8?q?=EF=BC=9Bgen=20=E6=A8=A1=E7=B3=8A=E6=8F=AD=E7=A4=BA=E3=80=8C?= =?UTF-8?q?=E9=BB=98=E8=AE=A4=E5=B7=A5=E7=A8=8B=E4=B8=8D=E5=90=AB=20DOM?= =?UTF-8?q?=E3=80=8D=E5=B9=B6=E5=85=A5=E6=96=B0=E5=8C=BA=E5=9D=97=20DOM=20?= =?UTF-8?q?=E7=BC=BA=E5=B8=AD=E6=B5=8B=E8=AF=95=EF=BC=8C=E5=90=8C=E4=B8=80?= =?UTF-8?q?=20defaultProject=20=E8=BE=93=E5=85=A5=EF=BC=89=EF=BC=8C?= =?UTF-8?q?=E5=88=A0=204=20=E5=A4=84=E5=90=8C=E8=BE=93=E5=85=A5=E9=80=90?= =?UTF-8?q?=E5=AD=97=E8=8A=82=E9=87=8D=E5=A4=8D=E6=96=AD=E8=A8=80=EF=BC=88?= =?UTF-8?q?=E6=8D=95=E8=8E=B7=E7=BB=84=2016=20=E4=B8=AA=E8=BF=9E=E5=86=99?= =?UTF-8?q?=E4=B8=A4=E9=81=8D=E3=80=81curtain=20=E7=9A=84=20-gcurval=20?= =?UTF-8?q?=E4=B8=8E=20scan=20=E7=9A=84=20-gscandone=20=E5=9C=A8=E4=B8=A4?= =?UTF-8?q?=E4=B8=AA=E7=9B=B8=E5=90=8C=E6=9E=84=E5=BB=BA=E9=87=8C=E5=90=84?= =?UTF-8?q?=E6=96=AD=E8=A8=80=E4=B8=A4=E6=AC=A1=E3=80=81gate=20=E7=BB=8F?= =?UTF-8?q?=E5=85=B8=E4=B8=BB=E9=A2=98=20-gatecover/-gatebtn=20=E4=B8=8E?= =?UTF-8?q?=E5=90=8C=E8=BE=93=E5=85=A5=E5=85=88=E8=A1=8C=20it=20=E9=87=8D?= =?UTF-8?q?=E5=A4=8D=EF=BC=89=E3=80=811=20=E8=A1=8C=E8=B0=83=E8=AF=95?= =?UTF-8?q?=E6=AE=8B=E7=95=99=20console.log=EF=BC=88complib=20random=5Fnr?= =?UTF-8?q?=EF=BC=89=E3=80=812=20=E5=A4=84=E6=AD=BB=20fixture=20=E5=AD=97?= =?UTF-8?q?=E6=AE=B5=20useTavernCmd=EF=BC=88v1.27.1=20=E5=B7=B2=E5=88=A0?= =?UTF-8?q?=E8=AF=A5=E5=AD=97=E6=AE=B5=EF=BC=89=EF=BC=9B=E7=A1=AE=E8=AE=A4?= =?UTF-8?q?=E4=BF=9D=E7=95=99=E5=85=A8=E9=83=A8=E5=AE=8F=E5=8F=8C=E8=BD=A8?= =?UTF-8?q?/=E9=A2=84=E8=A7=88=E5=AF=BC=E5=87=BA/=E5=A4=9A=E5=AE=9E?= =?UTF-8?q?=E4=BE=8B=E5=8F=8C=E8=B7=AF=E5=BE=84=E6=96=AD=E8=A8=80=E2=80=94?= =?UTF-8?q?=E2=80=94=E9=82=A3=E4=BA=9B=E3=80=8C=E7=9C=8B=E7=9D=80=E9=87=8D?= =?UTF-8?q?=E5=A4=8D=E3=80=8D=E6=98=AF=E4=BA=A4=E4=BB=98=E5=A5=91=E7=BA=A6?= =?UTF-8?q?=E3=80=82=E6=96=87=E6=A1=A3=E5=AF=B9=E9=BD=90=EF=BC=9AREADME=20?= =?UTF-8?q?=E7=BB=93=E6=9E=84=E6=A0=91=E8=A1=A5=E6=BC=8F=20scripts/opg-nh.?= =?UTF-8?q?bat=EF=BC=88=E5=8A=A9=E6=89=8B=E5=B0=8F=E5=8C=85=E5=9B=9B?= =?UTF-8?q?=E4=BB=B6=E5=A5=97=E4=B9=8B=E4=B8=80=EF=BC=8C=E6=A0=91=E9=87=8C?= =?UTF-8?q?=E5=94=AF=E7=8B=AC=E6=BC=8F=E4=BA=86=E5=AE=83=EF=BC=89=EF=BC=9B?= =?UTF-8?q?AGENTS=20=E6=A8=A1=E5=9D=97=E5=9C=B0=E5=9B=BE=E8=A1=A5=20ui/ren?= =?UTF-8?q?derNh.js=20=E4=B8=8E=20ui/extBridge.js=20=E4=B8=A4=E8=A1=8C?= =?UTF-8?q?=EF=BC=88=E5=9C=B0=E5=9B=BE=E5=A3=B0=E7=A7=B0=E8=A6=86=E7=9B=96?= =?UTF-8?q?=20src/js=20=E5=85=A8=E9=83=A8=20js=20=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E4=BD=86=E6=BC=8F=E8=BF=99=E4=B8=A4=E4=B8=AA=EF=BC=89=EF=BC=9B?= =?UTF-8?q?project.js=20=E8=A1=8C=E5=A4=B1=E7=9C=9F=E9=94=AE=E5=90=8D=20`?= =?UTF-8?q?=5Fprojects`=20=E6=94=B9=E5=9B=9E=E7=9C=9F=E5=AE=9E=E9=94=AE=20?= =?UTF-8?q?`openingPageGen=5Fv1=5Fprojects`=EF=BC=9B=E7=A1=AC=E7=BA=A6?= =?UTF-8?q?=E6=9D=9F=201=20=E7=BB=84=E4=BB=B6=E6=95=B0=E3=80=8C55+=20?= =?UTF-8?q?=E6=9D=A1=E3=80=8D=E5=AF=B9=E9=BD=90=E5=AE=9E=E6=B5=8B=2059=20?= =?UTF-8?q?=E6=9D=A1=EF=BC=9B=E5=88=A0=20package.json=20=E6=97=A0=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E6=97=A0=E4=BD=BF=E7=94=A8=E6=96=B9=E7=9A=84=20test:w?= =?UTF-8?q?atch=E3=80=82PITFALLS=20=E8=A1=A5=E5=BD=95=205=20=E6=9D=A1?= =?UTF-8?q?=E6=9C=AC=E6=AC=A1=E5=AE=9E=E9=99=85=E8=B8=A9=E5=9D=91=E5=B9=B6?= =?UTF-8?q?=E9=87=8D=E6=8E=92=E4=B8=BA=E8=8A=82=E5=86=85=E8=BF=9E=E7=BB=AD?= =?UTF-8?q?=E7=BC=96=E5=8F=B7=EF=BC=88=E6=97=A0=E6=8C=89=E7=BC=96=E5=8F=B7?= =?UTF-8?q?=E4=BA=A4=E5=8F=89=E5=BC=95=E7=94=A8=EF=BC=8C=E5=AE=89=E5=85=A8?= =?UTF-8?q?=EF=BC=89=EF=BC=9A14=20=E6=92=A4=E9=94=80=E5=BF=AB=E7=85=A7?= =?UTF-8?q?=E5=BF=85=E9=A1=BB=E3=80=8C=E5=85=88=E6=94=B9=E5=90=8E=E6=8B=8D?= =?UTF-8?q?=E3=80=8D=EF=BC=88=E5=85=88=E6=8B=8D=E4=B8=8E=E6=A0=88=E9=A1=B6?= =?UTF-8?q?=E5=90=8C=E8=A2=AB=E5=8E=BB=E9=87=8D=E9=9D=99=E9=BB=98=E5=90=9E?= =?UTF-8?q?=E6=8E=89=EF=BC=8C=E5=86=99=E5=85=A5=E6=80=81=E6=B0=B8=E4=B9=85?= =?UTF-8?q?=E4=B8=8D=E5=8F=AF=E8=BE=BE=E2=80=94=E2=80=94=E6=BC=AB=E7=94=BB?= =?UTF-8?q?=E5=AF=BC=E5=85=A5=E5=BA=94=E7=94=A8=E5=8C=BA=E5=9D=97=E8=B8=A9?= =?UTF-8?q?=E8=BF=87=EF=BC=89=E3=80=8123=20gen.test=20=E5=AD=97=E7=AC=A6?= =?UTF-8?q?=E4=B8=B2=E6=96=AD=E8=A8=80=E6=9C=89=E6=84=8F=E9=92=89=E4=BD=8F?= =?UTF-8?q?=E8=BF=90=E8=A1=8C=E6=97=B6=E8=84=9A=E6=9C=AC=E5=86=85=E9=83=A8?= =?UTF-8?q?=E5=8F=98=E9=87=8F=E5=90=8D=EF=BC=88=E9=87=8D=E6=9E=84=E6=97=B6?= =?UTF-8?q?=E6=96=AD=E8=A8=80=E8=BF=9E=E7=8E=AF=E7=BA=A2=E5=B1=9E=E9=A2=84?= =?UTF-8?q?=E6=9C=9F=EF=BC=8C=E5=88=AB=E4=B8=BA=E7=BB=BF=E6=B5=8B=E4=BF=9D?= =?UTF-8?q?=E7=95=99=E6=97=A7=E5=8F=98=E9=87=8F=E5=90=8D=EF=BC=89=E3=80=81?= =?UTF-8?q?24=20=E5=88=87=E6=AE=B5=E4=B8=8E=E5=8C=B9=E9=85=8D=E5=85=B1?= =?UTF-8?q?=E7=94=A8=E5=90=8C=E4=B8=80=E5=AD=97=E7=AC=A6=E7=B1=BB=E6=97=B6?= =?UTF-8?q?=E6=AE=B5=E5=86=85=E6=AD=A3=E5=88=99=E5=90=8C=E7=B1=BB=E5=85=9C?= =?UTF-8?q?=E5=BA=95=E6=98=AF=E6=AD=BB=E4=BB=A3=E7=A0=81=EF=BC=88parsePage?= =?UTF-8?q?Expr=20=E7=9A=84=201=20-=2020=20=E8=A2=AB=E6=88=AA=E6=88=90?= =?UTF-8?q?=E7=AB=AF=E7=82=B9=EF=BC=89=E3=80=8125=20=E5=90=8C=E7=BA=A7=20z?= =?UTF-8?q?-index=20=E5=BC=B9=E5=B1=82=E6=8C=89=20DOM=20=E9=A1=BA=E5=BA=8F?= =?UTF-8?q?=E7=BB=98=E5=88=B6=20+=20=E4=B8=BB=E9=A2=98=E7=BA=B9=E7=90=86?= =?UTF-8?q?=E5=B1=82=202147483646=20=E6=98=AF=E8=87=AA=E7=BB=98=E5=BC=B9?= =?UTF-8?q?=E5=B1=82=20z-index=20=E4=B8=8B=E9=99=90=EF=BC=88=E6=A8=A1?= =?UTF-8?q?=E6=80=81=E6=AF=8F=E6=AC=A1=E5=BC=B9=E5=87=BA=E9=87=8D=E6=8C=82?= =?UTF-8?q?=20body=20=E6=9C=AB=E5=B0=BE=E7=BD=AE=E9=A1=B6=EF=BC=89?= =?UTF-8?q?=E3=80=8126=20=E6=96=B0=E5=A2=9E=E8=87=AA=E7=BB=98=E5=BC=B9?= =?UTF-8?q?=E5=B1=82=E5=BF=85=E9=A1=BB=E6=8C=82=20.opg-ov=EF=BC=88?= =?UTF-8?q?=E6=BC=8F=E6=8C=82=E6=97=B6=20Ctrl+Z=20=E7=A9=BF=E9=80=8F?= =?UTF-8?q?=E3=80=81=E5=BC=B9=E5=B1=82=E9=97=AD=E5=8C=85=E5=86=99=E8=BF=9B?= =?UTF-8?q?=E5=B7=B2=E5=9B=9E=E9=80=80=E6=97=A7=E5=AF=B9=E8=B1=A1=EF=BC=89?= =?UTF-8?q?=E3=80=82=E6=9C=AC=E5=9C=B0=20.zcode/tmp=2090+=20=E4=B8=AA?= =?UTF-8?q?=E5=8E=86=E5=8F=B2=E4=BC=9A=E8=AF=9D=E6=AE=8B=E7=95=99=E5=B7=B2?= =?UTF-8?q?=E6=B8=85=E3=80=82lint=20=E9=80=9A=E8=BF=87=E3=80=81502=20?= =?UTF-8?q?=E6=B5=8B=E8=AF=95=E5=85=A8=E8=BF=87=E3=80=81=E6=9E=84=E5=BB=BA?= =?UTF-8?q?=E4=B8=8E=E5=8F=8C=E5=86=92=E7=83=9F=E9=80=9A=E8=BF=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 6 ++++-- PITFALLS.md | 42 ++++++++++++++++++++++++++++++++++-------- README.md | 1 + package.json | 1 - tests/complib.test.js | 1 - tests/gen.test.js | 15 ++++----------- tests/project.test.js | 11 +---------- tests/themes.test.js | 3 +-- 8 files changed, 45 insertions(+), 35 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 78d7240..65763a4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -41,12 +41,14 @@ | `src/js/defs.js` | 纯数据汇总出口(大体量数据拆在 `defs/blocks.js`·`defs/complib.js`·`defs/templates.js`,调用方一律从 defs.js import):`BLOCK_DEFS/BLOCK_ORDER/CORE_TYPES`、`THEME_PRESETS`(6 页面主题)、`COMP_LIB`(59 组件)、`UI_THEMES`(7 工具主题)、`BUILTIN_TEMPLATES`(12 官方模板)、`BLOCK_PRESETS`、`defaultProject()` | | `src/js/themes.js` | **纯函数/数据**:`THEME_SKINS` 材质枚举与本机字体栈、`themeSkin` 兼容兜底、`themePresetPatch` 试穿/套用补丁、`themePresetMatches` 完整匹配、`themeTexture` 卡片/产物共用纹理;不按 presetRef 推断材质 | | `src/js/macros.js` | 预览专用宏引擎(char/user/random/pick/roll/setvar/getvar/时间类),随机结果带缓存防预览闪变 | -| `src/js/project.js` | 工程存储(v1.27 起分键:`openingPageGen_v1_projIndex` 索引 + `openingPageGen_v1_proj_`,save 只写变化工程;首载自动从旧整表单键 `_projects` 迁移,空间不足回滚保留旧格式)/migrate/normalize(含 `_hoistBg` 背景上收)、撤销重做(20 步快照栈存 JSON 字符串,v1.24 起含 theme)、模板、导入导出(剔除 API Key) | +| `src/js/project.js` | 工程存储(v1.27 起分键:`openingPageGen_v1_projIndex` 索引 + `openingPageGen_v1_proj_`,save 只写变化工程;首载自动从旧整表单键 `openingPageGen_v1_projects` 迁移,空间不足回滚保留旧格式)/migrate/normalize(含 `_hoistBg` 背景上收)、撤销重做(20 步快照栈存 JSON 字符串,v1.24 起含 theme)、模板、导入导出(剔除 API Key) | | `src/js/ui/core.js` | UI 壳 + `UI.renderAll()` 总入口(各渲染页有独立 try/catch 隔离)+ renderProjectSelect + 预览四件套(mountPreview/fitPreviewHeight/refreshPreview/debouncedPreview)+ 页签切换/全局快捷键/启动;经 `Object.assign(UI,…)` 挂载页面方法(模块顶层不读 UI 值,规避循环 import TDZ) | | `src/js/ui/renderConfig.js` | 配置页渲染与交互(renderConfig:主题/宏/区块列表拖拽/全局搜索替换 UI 层) | | `src/js/ui/blockEditors.js` | renderBlockBody 各区块编辑表单 + 组件库插入/选择器弹窗 `openCompPicker` | | `src/js/ui/renderExport.js` / `renderAI.js` / `renderHelp.js` | 导出页 / AI 助手页 / 说明页渲染 | +| `src/js/ui/renderNh.js` | 漫画导入页:服务探活 / 抓取 / 勾选筛选 / 应用到区块(`scripts/nh-lib.mjs` 直接 import 进 bundle) | +| `src/js/ui/extBridge.js` | 扩展版桥接(写角色卡 / 酒馆当前连接 AI 生成);桥不存在时功能休眠 | | `src/js/ui/shared.js` | 跨页辅助:bindListEditor / detectFonts | | `src/js/search.js` | **纯函数**全局搜索替换:collectSearchMatches / replaceAllInString / replaceAllInProject(UI 层仅调 API,逻辑可测) | | `src/js/fontdetect.js` | **纯函数**字体检测:COMMON_FONTS / BASE_FONTS / fontExists / detectAvailableFonts(ctx 由调用方注入,测试 mock) | @@ -70,7 +72,7 @@ localStorage(openingPageGen_* 键) ## 硬约束(红线) -1. **组件库 `COMP_LIB`**(`defs/complib.js`,55+ 条带 cat 分类):无 id 选择器(**例外**:`opg-` 前缀 id 供 CSS 交互组件如多标签页/求签,多次插入共享状态为已知取舍)、无全局选择器;`