← Croprix 品牌手册 · 源文件 assets/imagery/README.md
Croprix 影像规范
上游：brand/decisions.md §6（影像）、§3（色彩）、§2.3（标志背景规则）。本文把 §6 的一句话展开成可执行规则；
手册第 6 章（brand/manual/06-imagery.html）引用本目录的示范图。规格有冲突时以 decisions.md 为准，改规则先改那里。
imagery/
README.md 本文：影像规范 + grade.py 用法
shot-list.md 一次现场拍摄的镜头清单（22 个镜头，五组）
grade.py 品牌调色脚本（参数在文件顶部）
build.py 重新生成 samples/ misuse/ overlays/ contact-sheet.jpg 与 ../manifest.imagery.json
samples/ 裁切示范（3:2 / 16:9 / 4:5）、调色示范、处理前后对比、preset.json
misuse/ 4 张禁用示例（左上角 ✕）
overlays/ 标志与文字压图示范 3 张（2 对 1 错）
contact-sheet.jpg 全部示范图汇总
素材来源：public/assets/imagery/ 三张现场照片（温室行间部署 ×2、装配车间 ×1）。全部为 Croprix 自有照片，
不用图库、不用 AI 生成。
1. 主题：拍什么
影像是"扎根现场 Grounded"最直接的证据，只拍真实存在的东西。
| 要拍 | 不拍 |
|---|---|
| 真实温室（玻璃 / 塑料）内部，作物行、管轨、吊线、采光顶 | CG 渲染、概念图、未来感场景 |
| 机器人在行间作业，且画面里有作物或人做尺度参照 | 机器人单独抠图放纯白底当"产品照"用于叙事页面 |
| 技术人员调试、装配、巡行——工作状态 | 摆拍、看镜头、举大拇指、合影 |
| 装配车间：工位、线束、整机并列 | 空荡的厂房全景、无人的办公室 |
| 细节：夹爪、传感器、显示屏、番茄串、轨道轮 | 无人机大远景（看不见作物与机器） |
一张照片至少要回答一个问题：这台机器在哪、在做什么、多大。回答不了就不用。
2. 构图
- 沿行看进去：机位放在作物行一端，镜头沿行方向；行间管轨与吊线形成透视线，机器人在线上。
- 并列而有序（协同 Coordinated）：多台机器人、多道作业、多个作物行并列时，保持等间距、同朝向。
- 留白给文字：官网首屏与 deck 封面用图要在左侧或底部留出 30–40% 的低细节区域（阴影、地面、暗部）， 后期用遮罩压标题；不要把主体顶到边缘。
- 水平线放平：管轨、地面、桁架必须水平或垂直，不做倾斜构图，与"精确 Precise"一致。
- 焦段：35–50 mm 等效为主（透视自然、不夸张）；细节用 85–100 mm 微距；不用 ≤ 24 mm 广角拍机器人（形变）。
- 机器人在画面里的比例：主图 30–60% 高度；细节图允许局部；全景图机器人不能小于画面高度的 15%。
3. 光线
- 自然顶光优先：上午 9–11 点或下午 2–4 点，温室采光顶漫射光；避免正午硬光与傍晚色温漂移。
- 补光灯 / LED 植物灯：不作为主光。紫红植物灯开着时不拍宽幅，只拍细节并在后期用
grade.py矫正。 - 不用闪光灯、不用反光板打脸。人物脸部允许有阴影。
- 曝光：以作物叶面为基准，允许采光顶过曝一档以内；机器人绿色外壳不能过曝成黄绿。
- 车间：利用高窗侧光；必要时把整机推到窗边。避免顶棚灯的黄绿色偏。
4. 色彩与调色
原则（decisions §6）：保留绿的真实饱和度，阴影偏暖；不做双色调，不加蓝绿滤镜。
grade.py 是唯一认可的调色流程，参数如下（samples/preset.json，croprix-field v1.0.0）：
| 步骤 | 参数 | 意图 |
|---|---|---|
| 曝光 | +0.10 EV（线性空间） | 温室顶光照片普遍略欠曝 |
| 白平衡 | R ×1.015, G ×1.0, B ×0.975 | 去掉玻璃 + LED 的青蓝偏 |
| 高光软肩 | knee 0.86，指数渐进压缩 | 采光顶、白色部件不硬切 |
| 黑点 | 0.012 | 阴影不发死 |
| 对比 | S 曲线，强度 0.22，支点 0.45，斜率 6；只作用于亮度 | 增加层次，不改色相与饱和度 |
| 阴影偏暖 | 强度 0.26，作用于亮度 < 0.42 的区域，R +0.30 / G +0.02 / B −0.32 相对增益 | 阴影偏暖、不发青 |
| 饱和度保真 | vibrance 0.12，绿色色相带 70–170° 保护 85% | 只抬低饱和区域，作物绿基本不动 |
| 全局饱和度 | ×1.0 | 不加 |
| 输出 | JPEG 质量 92，4:4:4 |
做与不做：
- 只允许：曝光、白平衡、对比、局部减光/加光、去污点、水平校正、裁切。
- 不允许：双色调、青橙 / 蓝绿滤镜、HDR 合成或"清晰度"拉满、暗角、过饱和、磨皮、换天、AI 扩图。
- 机器人的绿色外壳不是品牌 Leaf 色，不要把它调成
leaf.600；保留实物颜色。 - 四种典型错误见
misuse/（与手册 6.2"错"栏对应）：蓝绿滤镜、过饱和、暗角 + HDR 过度、双色调。
5. 人物
- 工作状态：调试、搬运、观察屏幕、走在行间。不看镜头，不摆姿势。
- 穿日常工作服；不穿印有其他品牌 logo 的衣服；安全要求（帽、手套）按现场规定，不为拍照摘掉。
- 人物只作尺度与"有人在现场"的证据，不做主角；脸部可以是侧面或背影。
- 每个可辨识的人签一次影像授权（见 §9）。
6. 裁切
| 比例 | 方向 | 用途 | 示范 |
|---|---|---|---|
| 3:2 | 横 | 官网主图、印刷、deck 内页 | samples/crop-3x2-greenhouse.jpg |
| 16:9 | 横 | 幻灯片全幅、视频封面、官网首屏 | samples/crop-16x9-workshop.jpg |
| 4:5 | 竖 | 社媒（Instagram / 小红书 / LinkedIn 信息流） | samples/crop-4x5-greenhouse.jpg |
- 不用 1:1、21:9 等其他比例；社媒头像位用
../social/模板而不是照片。 - 裁切不改变主体比例（不拉伸）；竖版从横片裁时保留主体完整，允许损失两侧作物行。
- 拍摄时按 3:2 构图并在四周多留 10%，给后期三种比例留余量。
7. 照片上的标志与文字
规则来自 decisions §2.3：彩色照片上一律用单色白（croprix-logo-mono-white.svg）或单色 Navy；
反白（croprix-logo-reverse.svg，白字 + Leaf 叶标）只放在 Navy-900/950 或叶标对比度 ≥ 3:1 的深色照片上。
- 遮罩：
navy.950（#002641）线性渐变，不透明度 0 → 72%，方向自下而上或自左向右。72% 一端保持一段平台 （≥ 25% 边长）用来放标志或文字。CSS：linear-gradient(to top, rgb(0 38 65 / 72%) 28%, transparent 70%)。 - 对比度核验：反白主标压图前量叶标所在区域的背景平均色，与
leaf.600对比度 ≥ 3:1；白色标题 ≥ 4.5:1。build.py会打印数值并在不达标时中止。 - 实测结论：三张现场照的底边都是受光水泥地面，72% 遮罩压上去叶标对比度只有 2.7:1，不达标。 所以反白主标落在左侧作物暗部（自左向右遮罩，4.3:1），底边留给白色文字（自下而上遮罩，10:1）。 一般规律：地面亮的温室照片，标志放暗部、文字放地面。
- 安全空间：交付 SVG 的 viewBox 已含 0.5 L 安全空间，按 viewBox 摆放即可；主标宽度取画面宽 20–30%。
- 不压在作物或人物上：遮罩之外的区域不放标志；标志不与吊线、黄色轨道、采光顶这类高频细节重叠。
- 示范：
overlays/overlay-logo-reverse-gradient.jpg（对）、overlays/overlay-title-gradient.jpg（对）、overlays/overlay-misuse-logo-on-busy.jpg（错：反白主标直接压在顶部杂乱亮部，叶标对比度 1.5:1）。 - 标题字：Montserrat Bold，字距 −0.01em；全大写小标签 +0.08em；中文 Noto Sans SC / PingFang SC 500。
8. 文件命名、分辨率、格式
命名：croprix-<scene>-<yyyymmdd>-<seq>.jpg
<scene>五组之一：rows（温室行间）、robot（机器人作业）、people（人与设备）、workshop（装配车间）、detail（细节）。 需要更细时加一段：robot-harvest、detail-gripper。只用小写字母与连字符。<yyyymmdd>拍摄日期；<seq>三位序号，从 001 起，同一天同一场景连续编号。- 裁切版在序号后加比例：
croprix-rows-20260922-003-16x9.jpg；调色前的原片同名放raw/子目录，不对外。 - 示例：
croprix-robot-harvest-20260922-014.jpg。
交付分辨率与格式：
| 用途 | 长边 | 格式 | 色彩空间 |
|---|---|---|---|
| 母版（存档） | 原始（≥ 6000 px） | RAW + 16-bit TIFF | Adobe RGB 或 ProPhoto |
| 官网 / deck | 2400 px | JPEG 质量 92（grade.py 默认），另出 WebP |
sRGB |
| 社媒 | 2160 px（4:5 竖版 1080×1350 起） | JPEG 90 | sRGB |
| 印刷 | 300 dpi 按成品尺寸 | TIFF 或 JPEG 100 | sRGB（印厂转 CMYK） |
- 网站侧由构建流程再压缩，不在本目录做多尺寸。
- 本目录三张来源照片为网页尺寸（1447–2000 px），只用于示范；正式交付按上表。
9. 元数据与授权
- 保留 EXIF 拍摄日期、相机、焦段；清除 GPS。
- IPTC：
Creator= 摄影者，Copyright=© <年> Croprix. All rights reserved.，Credit=Croprix，Description写场景一句话（地点到"城市/温室类型"为止，不写客户名）。 - 授权：
- 摄影者签全部权利买断（含商用、改作、全球、无期限）；委托合同附本规范。
- 每个可辨识的人签肖像授权（中英双语模板见法务），未成年人不出镜。
- 在客户温室拍摄需客户书面同意；客户标识、品种标签、合同信息入镜要打码或避开。
- 登记：每张交付照片登记到
brand/assets/manifest.imagery.json（path / format / width / height / use / licence， 照片 licence 一律Croprix proprietary photo）。
10. grade.py 用法
# 单张
python3 brand/assets/imagery/grade.py raw/IMG_0123.jpg croprix-rows-20260922-001.jpg
# 同时输出处理前后对比图
python3 brand/assets/imagery/grade.py raw/IMG_0123.jpg out.jpg --compare out-before-after.jpg
# 导出当前参数
python3 brand/assets/imagery/grade.py --dump-preset preset.json
# 没装依赖时
uv run --with pillow --with numpy python brand/assets/imagery/grade.py IN OUT
- 输入 sRGB 8-bit（jpg / webp / png）；RAW 先在 Lightroom / darktable 里以中性设置导出再进本脚本。
- 参数全部在
grade.py顶部PRESET，改完把version加一，重新--dump-preset，并运行build.py更新示范图。 - 重新生成本目录全部示范：
python3 brand/assets/imagery/build.py。