Commit Graph

3 Commits

Author SHA1 Message Date
zepan
79f839bbf0 docs(AGENTS): codify asset size limits and batch-editing discipline
把这轮媒体治理沉淀成规范,核心是一张体积上限表:

  静态图 300KB/500KB  ·  SVG 500KB/1MB
  3 秒内动图 WebP 500KB/1MB(严禁 GIF,超 5 秒别用 WebP)
  5 秒以上动图 MP4 1MB/2MB,等效 1080p 1Mbps(录屏类 0.5Mbps)
  画质对比样片放宽到 4MB;再大的传 B 站/YouTube 内嵌,不进仓库

新增三节:
- MP4 按「等效 1080p 码率」衡量而不是只看文件大小。实测一个 2.2MB
  的小动图折合 1080p 高达 39.6Mbps,按 1Mbps 重编后 57KB;反过来
  7.7MB 的长录屏折合才 1098k,压它只会糊。先看帧率再调码率,
  120fps 降 30fps 直接省 3/4。
- 不要重复存放同一张图:没有中英差异的只放中文目录一份。清理历史
  重复要同时满足「文件名相同」和「不含同族两个型号」,后者防止把
  lpi3a/lpi4a 这类独立产品线绑在一起。
- 批量处理素材的纪律:基线对比、以构建产物为准、保留 CRLF 行尾、
  替换带定界符、通用文件名不自动匹配、删引用要删整个标记。

自检清单与坑速查表同步更新。
2026-10-07 21:37:48 +08:00
zepan
9f2da4cd6c docs(AGENTS): add image and animation compression guidelines
把这轮媒体治理实测出来的规律写进编写规范,避免后来人重犯:

- 压缩标准补上理由:git 永久保存每个历史版本,一张没压的大图
  即使以后删掉,仍让此后每个完整 clone 的人多下载一次
- 静态图按「照片 vs 合成图形」二分,两类处理方向完全相反
- 动图不要直接提交 GIF;有损 WebP 对文字是灾难(实测 +93%)
- 缩放必须用最近邻而非 lanczos(同尺寸差 3.5 倍),并给出
  2/3(录屏)与 512(实拍)两个尺度
- 长录播转 MP4 的取舍,以及 muted/playsinline 不能省
2026-10-07 20:19:05 +08:00
zepan
b1c057acce docs: add AGENTS.md wiki authoring guide
给后续 AI / 自动化协作者的编写规范:仓库结构、构建与双语机制、
产品文档 5 页模板、图片与叙事规范、首页 layout 与 babel 陷阱、
提交前自检清单与坑速查表。CLAUDE.md 指向它。
2026-10-07 00:20:41 +08:00