Gallery Pack

Gallery Pack

内置画廊的 HTML 和清单随 Skill 走；位图样本大约 64 MB，不进 git。clone 之后 gallery/images/ 通常是空的。Release 包是 HTML 能显示的 160 张。工作区 visual-reviews/images 可能更多（含 try 残片），两边文件数不必相等。

打开之前

Agent 必须先在 Skill 根目录运行：

python scripts/ensure_pack.py --check

通过才打开 {skill_root}/gallery/index.html。本会话只开一次浏览器，不要为刷新反复弹窗。

html 不存在：告诉用户路径，停止。不要改去打开工作区里的 visual-reviews/。

缺包时先问

--check 失败时，stdout 是 JSON。用里面的 missing_mb 和 source 问一句，例如：

风格画廊样本大约 64 MB，来源是 GitHub Release
https://github.com/Aafff623/tta-visual/releases/download/v0.0.1/gallery-samples.zip
同意的话再执行下载。

用户点头之前不要下载，也不要拷文件。

同意之后：

python scripts/ensure_pack.py --install

--install 会拉 Release 资产 gallery-samples.zip，解压到 gallery/，使 images/... 就位，然后再跑一遍 --check。

开发工作区若 {skill_root}/../visual-reviews/images 齐全，并且用户明确说用这份本地对照灌包，才可以：

python scripts/ensure_pack.py --from-local

页上组名可能长这样

画廊 HTML 是对照壳，组标题可能出现「小黑」「橙线」「小人书」这类来源称呼。它们只用来对上 section id，不是 tta 产品名。对外提问用视觉特征；用户如果照抄组名，按对照表路由即可。

本地自己看

样本齐了以后，用浏览器打开仓库里的 gallery/index.html。不要把 64 MB PNG 提交进 git。