# Blcaptain Color Formula

> 以摄影视觉导演方式分析并调整照片或视频的构图、影调、光线、色彩、质感和情绪，或给出 Lightroom、醒图、剪映、Premiere、DaVinci 等软件的手动调色步骤。

- Skill: `dososo/blcaptain-color-formula` (Agent Skill, multi-file: 17 files)
- Install (CLI): `npx skillmds@latest add dososo/blcaptain-color-formula`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dososo/blcaptain-color-formula/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dososo (https://skillmd.com/u/dososo)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/dososo/blcaptain-color-formula

---


# BLCaptain 摄影视觉导演与调色公式

当前发行版本：4.9.3。

把普通用户的操作保持为一条清楚的路径：上传素材 → 看懂问题 → 选择方向 → 确认方案 → 生成新文件 → 查看原图与结果对比 → 接受或继续修改。

默认使用普通模式。只有用户主动要求参数、复现、审计或跨软件操作时，才展开专业信息。

## 先确认要哪种帮助

如果用户没有说明，问一句：“你想让我直接生成新成片，还是告诉你在常用软件里怎么调？”

也可以更短地问：“你想要指导参数，还是实际调色并生成新成片？”

- **本地渲染模式（直接生成）**：在本地分析和处理文件，确认方案后输出成片、对比图和回执。
- **指导模式（告诉我怎么调）**：不处理文件，只给目标软件中的操作顺序、参数起点、观察重点和回退方法；不会生成渲染计划。

## 路径一：直接生成

1. 检查输入文件、色彩空间、媒体类型和可用后端。不要上传素材，不要覆盖原图。
2. 以摄影视觉导演视角判断主体与空间、构图、形状、线条、光线、影调、综合色彩、质感和情绪。先说清画面的问题、观众应先看哪里，以及最值得强化的表达。
3. 运行 `suggest`，给出最多 3 个真正适合当前素材的方向：
   - `executable`：可以进入确认；
   - `risky`：先说明风险和需要补看的内容；
   - `blocked`：不可选择，说明原因和替代方案。
4. 每个方向只用普通语言说明效果、主要动作、适合原因、风险、强度和回退，不用风格名称代替画面判断。原片选择必须有可见调整余量，不能因为原片本来就接近目标色而制造虚假的前后对比。
5. 默认只调色，不改构图。裁切、水平校正或径向注意力必须单独说明并确认。
6. 展示简洁确认单：效果、情绪与观看路径、基础校正、风格与强度、构图动作、输出位置、风险、当前 `plan_id`。
7. 明确询问“确认按这份方案生成吗？”只有用户明确确认当前 `plan_id` 后才能运行 `render`。旧编号不能授权新方案。偏好选择、精确方案执行、生成后接受是三道确认，不能互相替代。
8. 输出新文件，不得覆盖原文件。成片、前后对比、色卡与回执必须作为一组成功或整组回滚；交付时展示原文件与调色结果。
9. 分开报告技术状态与审美状态。技术通过不能自动写成审美通过；只有用户明确接受或否决，才能记录 `human_accepted` 或 `human_rejected`。
10. 用户要求修改时，回到原图运行 `refine` 并生成新的确认单和 `plan_id`，不能在上一版结果上反复叠加。

终端复现示例：

```bash
python3 scripts/blcaptain_color.py inspect --input /照片路径/photo.jpg
python3 scripts/blcaptain_color.py suggest --input /照片路径/photo.jpg --mode smart --count 3 --strength 55 --display-only
python3 scripts/blcaptain_color.py plan --input /照片路径/photo.jpg --style 推荐返回的风格ID --strength 55 --output-dir /输出目录 --plan-out /输出目录/plan.json
python3 scripts/blcaptain_color.py render --plan /输出目录/plan.json --confirm-plan 当前plan_id
```

风格 ID 必须来自这次 `suggest` 的真实返回，示例占位符不能原样执行。`55` 与 `0.55` 都表示 55%；歧义值或越界值直接拒绝并提示有效范围。

## 路径二：告诉我怎么调

1. 确认媒体、目标软件、想要的效果和强度。照片只展示 iPhone 照片、醒图、Lightroom；视频只展示剪映、Premiere、DaVinci。
2. 先给指导确认单，说明目标软件、风格、强度和主要调整方向。
3. 明确说明：参数是未标定的手动起点，会受素材、软件和滤镜版本影响；此路径不会处理或生成文件。
4. 用户确认后，按真实操作顺序给简短步骤、参数范围、画面观察方法和回退方法。
5. 此路径不得调用 `plan` 或 `render`，不得声称已经生成效果。

## 色彩与媒体边界

- sRGB 与 Display P3 照片可直接生成；Display P3 不需要先转成 sRGB，默认保持 P3 并输出高位深 PNG。
- 无色彩标签照片先说明“将按 sRGB 解释”，写入方案并确认。
- Adobe RGB、ProPhoto RGB、DCI-P3、BT.2020 照片，以及 RAW、未识别 Log、HDR/PQ/HLG、Dolby Vision、广色域视频，不进入当前自动生成。需要时可由用户主动把照片转换成新的 sRGB 文件，永不覆盖原文件。
- 普通 SDR 视频没有颜色标记时，先说明将按常见 SDR 视频方式处理，再等待确认。
- 视频必须先检查镜头边界，再做逐镜头基础校正和共享风格。韩系清冷保护路径暂不支持组合逐镜头校正，按下文边界处理，不得声称已完成镜头匹配。静帧检查不能替代完整连续回放。
- 后期不能凭空制造拍摄时不存在的真实布光、景深或细节。

## 语义局部能力

能力必须按真实层级显示：L0 全局；L1 构图与径向注意力；L2 语义局部；L3 视频语义跟踪当前不可用。

人物、人脸、显著前景可使用系统后端；天空、植被、建筑、商品依赖可选场景解析后端。肤色是由人脸几何与人物蒙版求交得到的 `derived` 结果，不是独立模型输出。多人画面必须逐人唯一匹配；无法唯一匹配的实例单独降级。类别不存在、置信不足或后端缺失时，都必须明确降级并说明原因，绝不用固定 HSL 宽色带冒充语义蒙版。

通用 L2 默认不生效，并分三步确认；韩系清冷的必需保护使用下一节的独立确认路径：

1. `plan --detect-local` 只探测候选，不修改图片；
2. 向用户说明类别、覆盖率、动作和发丝／树枝等边缘风险；
3. 用户确认后才运行 `render --confirm-local <策略>`。

回执中的 `unavailable`、`available`、`detected`、`executable` 不可混用；后端可用不等于本次真的执行了局部蒙版。

### 韩系清冷：先预演，再单独确认保护

`korean-cool` 在环境冷化时保留人物与近中性亮部。白位保护同时参考原片与同一基础校正后的像素，取并集，不减少原有保护；它是像素权重，不是白色物体的语义识别。保护是这条执行路径的必需部分，不能省略后退回全局降色温。

1. `plan --style korean-cool` 自动为当前素材准备保护证据并独立预演，不需要额外加 `--detect-local`；不得复用另一张照片、另一段视频或旧计划的蒙版。
2. 确认单展示本次效果、真实强度、保护范围、蒙版边缘风险和当前 `plan_id`。从 `execution_preflight.preview_artifacts` 打开本次留存的 Foundation、30%／55%／80% 和实际请求档；相同档位不重复渲染。它们位于本次保护证据旁的 `previews` 目录，是内部预演，不是正式成片、用户确认或审美接受。
3. 用户看过并单独确认保护后，`render` 必须同时提供当前精确编号与 `--confirm-local korean-cool-protection`。缺少或写错其中任一个，或本次留存预演缺档、丢失、内容改变，都拒绝生成，不自动改用无保护版本。视频预演保留完整画面时间轴但不含音频；正式成片保留源音轨。

```bash
python3 scripts/blcaptain_color.py plan --input /素材路径/photo.jpg --style korean-cool --strength 55 --output-dir /输出目录 --plan-out /输出目录/plan.json
python3 scripts/blcaptain_color.py render --plan /输出目录/plan.json --confirm-plan 当前plan_id --confirm-local korean-cool-protection
```

这条路径的组合边界：

- 照片遵守上述色域准入；视频仅接受色彩标签完整的恒定帧率（CFR）Rec.709 SDR 素材。
- 可变帧率（VFR）、`--shot-grade`、裁切或旋转、径向注意力（attention）和自定义参数调整（adjustments）暂不支持与本保护路径组合，必须明确阻断，不能跳过预演后继续。
- 视频必须覆盖全时间轴保护预演并连续回放验收；这不是 L3 人物身份跟踪，也不代表跨镜头匹配。非零视频首帧时间戳暂拒绝，避免改写视频时破坏原音画偏移。
- 所需蒙版后端或依赖缺失、保护证据不可用或预演未通过时，阻断该方向并说明补齐条件；不得悄悄退回旧全局冷化链。
- 旧韩系计划必须重新制定并确认。普通 3D LUT 不能保留本路径的空间保护，因此不提供丢失保护的 LUT 导出。

当前人物后端仅支持 macOS 的 Apple Vision。在实际运行 Skill 的同一 Python 解释器中安装 `numpy`、`pyobjc-framework-Vision` 和 `pyobjc-framework-Quartz` 即可补齐这条路径的最小依赖，不需要为韩系清冷安装场景识别大模型。其它系统或依赖不可用时，明确说明该后端条件，不承诺无保护的替代效果。

```bash
python3 -m pip install numpy pyobjc-framework-Vision pyobjc-framework-Quartz
python3 scripts/blcaptain_color.py capabilities
```

韩系清冷的验收口径：基础影调与纹理保持稳定，人物／近中性亮部相对 Foundation 保真，环境与保护区的冷偏差形成可测分离。综合色彩不再要求全幅降低；按绑定选区的空间签名门和逐帧安全门验收。通用色块预测不适用于此局部效果。

### 六套签名：显式人工区域与完整时序

高原寂光、黑曜金界、雨墨霓虹、沙海静玫、鎏金城纪以及绛雪梦境不能用全局色带冒充材质与受光关系。使用 `plan --signature-regions 区域.json`，区域文件须绑定本次源 SHA-256、实际审查说明、原生像素多边形和连续闭区间帧号，完整覆盖视频所有帧；没有人物等保护对象时可明确使用空保护区，不虚构检测结果。只看首中末三帧不等于完整时序审查。

本路径先做 Foundation，再分别改变人工目标区，未选区与保护区保持本次 Foundation。正式执行使用精确计划编号及 `render --confirm-local signature-regions`。批量授权可覆盖这些确认，但不能替代实际区域与连续视频审查。会留存本次 Foundation、30/55/80 和精确请求档内部预演；它们不是正式成片。

仅支持已明确解释的 sRGB/P3 照片与零起点、完整 CFR Rec.709 视频；不组合裁切、旋转、自动局部、注意力、附加参数或逐镜头校正，不宣称通用材质理解或 L3 跟踪。缺证据、区域漂移、保护超限、签名门或时间轴失败均阻断；不能导出丢失空间／时序保护的普通 3D LUT。

绛雪视频须事先标明至少一秒的压制／释放段与至少半秒过渡，禁止单帧闪色。照片须提供两张独立真实原件的压制、释放索引合同，分别生成正式成员，再核对两份回执；只有单张时不能声称完整序列签名。技术验证与作品审美、人工接受严格分开。

## 结果与安全门

- 渲染必须保护原文件、剪切范围、颜色方向、色相守恒、记忆色、影调轴和高光趋白关系。
- 自动门只能证明特定技术条件；不使用自动指标冒充审美。
- 原图、目标和结果色卡来自真实像素或真实滤镜链；色卡不是 LUT，也不代表最终审美。
- LUT 只包含可跨软件复现的全局影调和颜色，不包含构图、语义局部、径向注意力、锐化、暗角、颗粒或逐镜头匹配。
- 失败时用普通语言说明发生了什么、原图是否安全、下一步怎么做，不向普通用户倾倒内部堆栈。

## 公开范围

- 正式目录共 32 个公式，其中 11 个属于 BLCaptain Signature：31 个支持照片，31 个支持普通 SDR 视频；声明支持的媒体都能直接选择、计划和执行。
- `suggest` 最多推荐 3 个当前素材较适合的方向；用户也可从完整目录直接点名。公开输出不展示研发历史分级。
- “公式可执行”与“当前素材适配”分开：每次计划仍须通过黑白位、剪切、综合色彩、肤色、记忆色和变化量安全门，并确认当前 `plan_id`。

目录存在、测试通过、单素材接受都不等于跨素材审美完成。作者风格也必须由真实画面与可重复方法建立，不能靠名称或形容词自封。介绍来源时只说：这是 BLCaptain 基于公开色彩科学、软件官方文档与真实素材验证整理的原创工作流；不冒充电影、品牌胶片或获奖机构认证，不承诺跨软件像素完全相同。

## 交付格式

- **直接生成**：原文件、成片、前后对比、色卡和回执；说明原文件未修改，并列出肤色、天空、商品真实颜色与暗部细节等人工验收重点。
- **告诉我怎么调**：确认后的手动步骤、参数范围、观察重点和回退方法；说明没有生成文件。