表情包作品库：统一查看、检索与持续创作

当前文件夹是本作品库的根目录。固定入口为表情包作品库.html，日常可双击打开作品库.command，自动刷新并在浏览器打开本地作品库。无需账户或数据库。当前接入奶思、古德、范恩三套72张成品。

一键入口复用或启动仅监听127.0.0.1的只读服务，默认地址为http://127.0.0.1:8769/表情包作品库.html；端口冲突时给出明确提示，不修改其他服务。当前已按该本地网页方式验证。静态HTML内嵌索引，不依赖外部网络；直接打开本地HTML取决于浏览器权限，本轮应用内浏览器安全策略阻止file协议访问，未将直接离线打开标为已验收。

使用方式

按套查看：看封面、角色、主题、张数、本地状态、微信状态和版本；打开详情即可看整套、填写文案、配套素材、上传包和备份。
找单张：按中文文案、含义词、主题、标签或角色别名检索。例如搜“谢谢”找到三只猫的感谢表情，搜“灰虎斑”找到奶思。
版本：默认展示每个角色/主题/类型的常用成品；没有常用版时展示最新有效成品或正在制作的版本。搜索会查所有未归档版本，呈现匹配版；勾选“显示历史与归档”可看全部版本。
筛选：角色、本地状态、静态/动态和微信审核状态可组合。新草稿不会替换已有常用版。
收藏：可收藏一套或单张；对应浏览方式勾选“只看收藏”。收藏保存在当前浏览器，同一浏览器刷新后保留；更换浏览器、电脑或清除浏览器数据会影响收藏。
分享筛选：复制带查询条件的页面链接，在同一本地库和地址下能恢复筛选；版本详情使用版本ID定位。它不提供公网分享或跨电脑文件同步。
规模：按套每页24项，单张每页48项，图片延迟加载。元数据在页面内，离线可用；新增后由维护工具刷新索引。

目录结构

表情包/
├── 表情包作品库.html              固定查看入口，自动生成
├── index.html                    浏览器根路径跳转入口
├── 打开作品库.command            日常一键打开入口
├── 作品目录.json                 唯一业务登记
├── AGENTS.md                     后续创作代理必须读取的约束
├── 作品库设计与规则.md
├── 00_官方调研/                  官方规则与核对证据
├── 01_作品/
│   └── 角色/主题/版本/v001_YYYYMMDD_静态24张/
│       ├── 01_资料/              需求、文案、参考、资料镜像
│       ├── 02_原画/              01.png至24.png及配套原画
│       ├── 03_工程/              计划、脚本、提示词、规格快照
│       ├── 04_成品/              图片、预览、上传包、完整备份、报告
│       └── 05_验收/              完成锁定及真实平台凭据
├── 02_上传包/                    首批已交付链接的兼容文件
├── 03_工程/                      首批生产工具与记录
├── 04_角色素材/角色/             可复用角色基准
├── 05_制作实验/角色/日期_实验名/
├── 06_待整理/                    后续外来文件入口
├── scripts/                      通用作品库工具和页面模板
└── 99_记录/                      操作日志、检查报告与升级备份

现有根目录三个角色文件夹保留原参考。新创作按上述规则放置，统一页面链接版本内原文件，后续不额外复制全套成品到总成品目录。

主题、版本和状态

每个版本有固定ID；同主题修订递增v001、v002等，序号在同角色同主题内持续递增，日期按北京时间。目录名提供可读信息，ID用于收藏、定位与日志。新版本先登记“制作中”，旧成品仍可用。

情况	放置与入口
全新主题和新一组文案	新主题、v001
原主题改字、改色、动作、描边或输出规格	同主题的新版本
原主题从静态发展为动画	同主题的新版本，类型单独登记，各类型可有常用版
继续尚未完成的一版	使用原版本目录和进度
完成一版	技术、实际目检、ZIP通过后finish，生成完成锁定
设为常用	finish --current或prefer，仅允许验收有效的成品
收起历史	archive，保留原文件；--restore恢复显示
交付文件发生变化	页面显示“需复检”，停用上传下载入口，修正另建版本

本地状态与微信状态为两条记录：本地制作中/本地成品/需复检；微信未投稿/已提交/审核通过/需修改。后者需要真实后台凭据。未确认的权利与本人账户资料继续按实际投稿要求准备，不由状态升级自动补齐。

每套登记的数据

角色、主题、投稿名称、介绍、类型、数量、版本序号、日期、稳定ID、标签、参考路径、画风约束、常用标记、归档标记、微信状态及凭据、完成锁定引用。逐张中文、含义词和素材路径从本版本manifest.json读取，不另外手写第二份检索数据。

根目录作品目录.json保存业务信息；作品信息.json是供阅读的镜像。HTML和README由工具生成。维护工具使用进程文件锁和原子写入，串行分配版本，避免同时开两组时撞号。

创作到入库的实际流程

你只需提出新创作或修改需求。创作代理按以下步骤完成：确认角色和主题关系 → 创建版本 → 填逐张中文和动作 → 锁定参考与当前规范 → 制作原画及导出 → 技术检查与真实逐张目检 → 检查ZIP → finish登记并刷新作品库 → 检查统一入口 → 交付。

维护命令都通过scripts/library.sh运行，它优先使用已配置的图像运行环境。以下供代理或维护者使用：

# 新主题；返回版本ID和绝对路径，自动刷新入口
scripts/library.sh new --cat 奶思 --theme 打工日常 --type 静态 --count 24 \
  --description '奶思陪你应对上班时的小情绪。' --tag 打工 --tag 日常

# 只做文案策划可加--draft；正式制作时更新状态
scripts/library.sh stage --path <版本ID> --state 制作中

# 制作与真实验收后登记；版本ID替换为new实际返回的值
scripts/library.sh finish --path <版本ID或版本路径> --current

# 更新入口，快速检查；交付前完整复算哈希与ZIP
scripts/library.sh refresh
scripts/library.sh check
scripts/library.sh check --deep

# 只改检索标签，不改已经交付的文案和图片
scripts/library.sh describe --path <版本ID> --tag 打工 --tag 情绪

# 已有成品之间调整常用入口
scripts/library.sh prefer --path <版本ID>

# 收起和恢复，文件保留
scripts/library.sh archive --path <版本ID>
scripts/library.sh archive --path <版本ID> --restore

# 实际投稿后记录平台状态，凭据放本版本05_验收内
scripts/library.sh platform --path <版本ID> --state 已提交 \
  --evidence 05_验收/真实投稿凭据.png

--root必须写在子命令前，用于独立库和隔离测试。当前制作默认24张，系统可登记8至24张；现有首批导出器只支持24张静态，其他数量或动画使用适用的制作流程和真实验收记录。

完成门槛与保护

finish核对真实文件与记录：连续编号和登记张数；单猫身份；中文文案和工程顺序；含义词长度与唯一性；主图、封面、图标和横幅的实际尺寸、格式、体积、透明与留边；真实多帧动画和循环；官方核对快照；技术报告全部检查通过；逐张目检及配套素材复核记录和哈希；投稿ZIP内容与成品一致；完整备份和网页引用完整。

finish不会自动做视觉审核或替你填写“目检通过”。目检人必须实际看过素材并留下记录。完成锁定保存版本内资料、原画、工程、成品文件的SHA256、大小和修改时间。常规刷新用文件清单与元信息检查，check --deep复算全部内容并校验ZIP。后续平台凭据与检索标签可新增，已交付生产文件变化需另建版本。

本次升级核对已有三套的真实文件和既有目检记录后接入，不重画图片。旧登记和入口说明保存在99_记录/20261002_作品库升级/。首批三猫预览继续可打开，后续统一从作品库检索。

扩展原则

更多主题沿用现有结构；新增角色先明确身份、参考和别名，再更新配置。不同画风记录在各版本，不混用角色基准。将来需要跨电脑访问时，可把同一库同步到可靠存储，再增加读取或索引服务；当前页面和收藏均为本地能力，尚未部署云同步、多人编辑或公网权限系统。

GitHub公开版本

用户已要求将当前作品库和素材公开到GitHub，并配置独立域名。公开站点配置为https://stickers.saymagic.cn/，仓库为https://github.com/saymagic/cat-sticker-library，发布流程见部署与更新。可从任意设备访问网页；收藏仍保存在各浏览器，不提供账户同步和多人编辑。

网页从同一登记和已验收版本生成，不维护另一套业务数据。原画、工程及图片进入main分支；ZIP存入Release并有完整路径、哈希映射。公开页下载链接指向Release，上传物料字节与本地一致。Git检出后的时间戳不同会复算内容哈希，不重写完成锁定。后续制作代理负责准备、上传新增物料、提交和线上检查。网站读取gh-pages分支；当前账号Actions因GitHub账单问题无法启动，代理在本地执行同一bash scripts/publish_pages.sh验收与发布流程，账单恢复后可使用现有云端自动流程。实际公网检查通过后才交付。