# Media 约定

- Markdown 只引用 `shared/`、`chapters/`、`cases/` 下的出版资产。
- 流程图优先使用 SVG；UI 截图使用 PNG；照片才使用 WebP/JPEG。
- 原始截图写入被忽略的 `.cache/media-raw/`，脱敏、裁剪和压缩后才能进入出版目录。
- 章节图片命名为 `fig-<chapter>-<sequence>-<slug>.<ext>`；案例图片命名为 `fig-case-<id>-<sequence>-<slug>.<ext>`。
- 不在文件名中加入日期或随机 hash。内容更新时替换稳定路径。
- 演示数据必须使用虚构公司、人员、金额和域名，禁止先截取真实敏感数据再打码。