Skip to content

Gitruck/cli / skills/gtrk-cover

gtrk-cover

Verified

封面工作台——把一期视频的封面从「设计诊断 + 文生图 Prompt」到「H5 排字工作台一键导出多尺寸 PNG」两阶段做完。阶段一产诊断与三尺寸中英双版 Prompt(用户拿去 Midjourney / Flux / SDXL / Nano Banana / 即梦 / 可灵 / 通义万相 等任意文生图平台抽图),阶段二收齐背景图后产可拖拽排字的单文件 H5 工作台、浏览器里导出原分辨率 PNG。这是**纯创作 skill、无 gtrk 命令**(抽图在外部平台、排字在用户浏览器,同 /gtrk-ai-drama)。当用户想「做封面 / 出封面 / 封面 prompt / 封面排版 / 封面工作台 / cover」时使用本 skill。通用封面工艺(两阶段交付 / T1 字数布局路由 / Prompt 槽位 / 工作台引擎)由本 skill 自持;栏目封面审美(色板 / 字体 / 意象体系 / T1 样本)从栏目配置 style.skills 里 produces=="cover" 的条目解析注入,绝不硬编某栏目风格。凡给成片配封面,优先用本 skill,别手搓 prompt、别让用户裸排版。

references/workbench-guide.md

View on GitHub
# 工作台实例化指南(workbench-guide)

`assets/workbench-template.html` 是**中性活范本**:一份完整可运行的排字工作台(拖拽 / 方向键 / 数值 / 滚轮微调、逐尺寸与一键导出),实例化 = 逐替换位换成当期值。本文是替换位总表 + 工程注意 + 合规检查。

## 0. 分工提醒

模板的 **JS 引擎层不要动**:拖拽 / 方向键 / 滚轮 / 图层选中 / 舞台缩放(负 margin 占位)/ 导出(html2canvas)都是通用基建。要动的只有**数据与样式**:占位符、常量、DEFAULTS、CSS 变量与字体、图层组。

## 1. 替换位总表

| 替换位 | 位置 | 说明 |
|---|---|---|
| `__BG_16_9__` / `__BG_4_3__` / `__BG_3_4__` | 各 `.cover` 的 `<img class="bg">` | 唯一的显式占位符:换成 `data:image/jpeg;base64,<压缩后>` |
| `<title>` / `<h1>` / `.sub` / 3 个 `.pill` | 头部 | 当期 T1、英文副题、布局名 / 色板名 / 操作提示 |
| `T1_KEYS` 常量 | script 顶部 | **T1 字数驱动的总开关**,见 §2 |
| `#t1-text` 的 `value` 与 `maxlength`、`state.t1Text` | 右栏 + script | T1 初值**两处**必须一致 |
| 各 `.cover` 内的 `char*` div 组 | 三个 cover | 数量与 `T1_KEYS` 一致、initial 文本逐字填 |
| `t2 / t5 / t4` 初始文案 | cover 内 div **与** DEFAULTS `text` 双处 | 副标题(≤12 字钩子)/ 装饰英文 / 品牌戳(用户没给就 `visible:false` 且不编内容) |
| `DEFAULTS` 整块 | script | 三尺寸 × 全图层默认坐标:从 layout-recipes 选配方起步,再按实际画面气口微调 |
| `:root` 色板变量 | CSS | 见 §3 |
| `.t1` 字体 / 描边 / 发光 | CSS **与** `applyT1Style()` | 发光 rgba **两处**(CSS 初值 + JS 滑杆模板串)必须同色;描边缺省 0(见 §8) |
| `T1_DEFAULT_FONT` 常量 | script 顶部 | **当期默认字**(family / weight / label)= skill 按栏目字体选型或中性默认做的审美决策,是字体下拉的首项;与 CSS `.t1` 的 font-family / font-weight **两处一致**(首帧无闪)。下拉其余项来自用户本机字体,见 §10 |
| `#t1-color` 选项 / 发光滑杆 label 与默认值 | 右栏 | 按栏目色板给 2~3 档字色;发光名跟色板叫(银辉 / 琥珀 / …) |
| 装饰件默认开关 | 右栏 checkbox + `applyInner/applyCorner` | 当期装饰件决策的落点 |
| 尺寸 tab 的 `.desc` | 左栏 | 标注当期布局(如「左人右字」「上下分飞」) |

## 2. T1 字数驱动(防「四字机器」回潮)

模板 T1 图层数由 `T1_KEYS` 常量驱动。当期 T1 为 N 字时,改四处并保持一致:
1. `T1_KEYS = ['char1', …, 'charN']`;
2. 每个 `.cover` 内放 N 个 `char*` div(initial 逐字填);
3. `#t1-text` 的 `maxlength="N"` 与 `value`;
4. `DEFAULTS` 三尺寸各含 N 条 `char*` 坐标。

`applyT1Text / renderCharBlocks / applyT1SizeAll` 都吃 `T1_KEYS`,不用改。`#t1-size-all` 滑杆的 min/max 按字号量级调(4 字大字 280~800;5 字竖排 150~700)。

## 3. 色板 CSS 变量(变量名固定、换值即换装)

| 变量 | 语义 | 用途 |
|---|---|---|
| `--midnight` | 最深底色 | 画布底、T1 描边、色块 |
| `--indigo` | 次深色 | 氛围渐变 |
| `--amber` | **强调色**(语义槽位,不必是琥珀) | UI 强调、选中框、导出钮、T5/装饰可用 |
| `--amber-soft` | 强调色柔化档 | hover、副文本 |
| `--bone` | 浅色字底 | T1 默认字色、浅 UI 文本 |

值从**栏目封面风格资产的色板表**取;无资产用模板自带中性值。UI chrome 与画布共用这套变量——换值后整个工作台会跟着栏目气质走,这是特性不是 bug。

## 4. 附加文字图层(品牌戳 / 拟声词 / 任意)

图层机制对非 T1 图层是通用的(`applyLayers` 按 `ls.type !== 't1'` 走 text/visible 同步)。加一个图层四步:
1. `DEFAULTS` 三尺寸各加条目 `{type:'<自定义>', pos, text, left, top, size, visible}`;
2. 每个 `.cover` 加 `<div class="layer-text <类名>" data-layer-key="<key>">初值</div>`;
3. `SUB_KEYS` / `SUB_LABELS` 登记(右栏出微调 block);
4. CSS 加 `.<类名>` 样式(字体 / 颜色 / z-index;旋转等静态变换写在类里,不影响拖拽)。

已验证先例:品牌戳(手写体、可拖)、拟声词(手写体 + 静态旋转 + 强调色,「全画面唯一与强调色同源的字」这类点睛用法)。

## 5. 逐尺寸样式覆写(浅底反转墨色技法)

某一尺寸的背景局部是浅色(如竖版下段渐变成纸面)时,可把该尺寸的文字整体反转为深色:

```css
/* 覆写 .t1 必须 !important —— applyT1Style() 会写内联样式 */
.cover[data-size="3_4"] .t1 { color: #16233A !important; -webkit-text-stroke: 0 transparent !important; text-shadow: 0 2px 12px rgba(20,30,50,0.18) !important; }
/* t2/t5/t4 无内联色,普通级联即可 */
.cover[data-size="3_4"] .t2 { color: rgba(30,58,95,0.92); text-shadow: none; }
```

交付时必须告知用户:**该尺寸不受全局字色 / 发光滑杆影响**,是当期审美决策。

## 6. 装饰件片段

- **薄内框**(装裱感):`.inner-frame { position:absolute; inset:50px; border:2px solid <色>; pointer-events:none; z-index:5; }` + 右栏开关 + `applyInner()`(模板已带,默认关)。浅底尺寸配 §5 覆写深色框。
- **四角断线框**:模板已带(`.corner` ×4 + 开关,默认关)。
- 胶带 / 撕痕 / REC 取景框等:按当期气质现写(绝对定位 + `pointer-events:none` + `z-index:5`,加进每个 `.cover`);**装饰件是显式决策**——用或不用都要说理由。

## 7. 背景图归位与压缩

- **归位按宽高比**:`w/h ≥ 1.55 → 16:9`;`≥ 1.15 → 4:3`;否则 `3:4`。同档有多张时显式选择并告知备选(用户可用左栏「上传当前尺寸的背景图」随时换)。归不上任何档就问,别硬塞。
- **压缩参数**(JPEG、渐进式):16:9 长边 ≤1280 / q82;4:3 ≤1600 / q78;3:4 ≤1400 / q78。纹理极密的图压不动属正常,别为体积牺牲画质到 q70 以下。
- **体积红线**:整份 HTML **>1MB 必须回头降参**(浏览器打开明显变慢);>600KB 提示一句即可。
- **纪律**:从**原路径**读用户图,压缩产物直接 base64 进 HTML;压缩脚本落**系统 temp、用完即删**;不留任何中间图片副本。

## 8. 工程注意(踩过的坑)

- **缩放占位**:画布用 `transform: scale` 只缩视觉不缩布局,模板已用「`transform-origin: top left` + 负 margin」把占位收缩到缩放后尺寸——**别改回直接设小宽高**(会让外框阴影只包住左上角)。
- **导出**:html2canvas 对发光 text-shadow 的还原略弱于屏显,用户觉得弱就把发光滑杆 +10~15% 再导;一键导出首次会触发浏览器「允许下载多个文件」授权,交付时提示。
- **布局状态在内存**:刷新页面回默认坐标——交付时提醒「调好就导出,导出前别刷新」。
- **字体**:模板经字体服务引入(含手写体),首次打开需联网;断网回退系统字体、不阻塞。
- **描边缺省 0,别再调回 2**:思源黑 / 思源宋这类**重叠轮廓**(overlapping contours)的特黑字体,`-webkit-text-stroke` 会把每个部件的内部轮廓全描出来——字变成镂空积木;缩略预览看不出,导出才炸(2026-09-08 真机)。托底靠 `.t1` 的暗色多层 `text-shadow`;描边滑杆保留给单轮廓字体。

## 9. 实例化后合规检查(交付前必过)

- [ ] 占位符零残留(全文检索 `__BG_` 无命中);
- [ ] `T1_KEYS` 长度 = 各 cover 的 char div 数 = `maxlength` = DEFAULTS char 条目数;
- [ ] T1 初值两处一致(`#t1-text` value 与 `state.t1Text`);
- [ ] DEFAULTS 三尺寸齐、每尺寸含全部图层条目;
- [ ] 发光 rgba 在 CSS 与 `applyT1Style()` 两处同色;
- [ ] 默认坐标避开用户分发平台的安全区(如 B 站横版底部 1/10 进度条灰化区、右上 1/8 角标区);
- [ ] 能验就在浏览器验一遍:控制台零报错、三尺寸切换正常、图层可拖;
- [ ] 字体下拉首项 = `T1_DEFAULT_FONT`,打开即列出本机已装字体(候选表探测),Chromium 点「读取本机字体」能拿全量,自由输入回车生效;描边为 0 时字形无镂空。

## 10. T1 字体:读用户本机(主理人 2026-09-08 拍板)

字体是用户本机能决定的事,模板不再把它当实例化期常量。右栏「字体」下拉三级取数,任一级成功即可用:

| 级 | 手段 | 何时 | 说明 |
|---|---|---|---|
| ① | Local Font Access API `queryLocalFonts()` | 用户点「读取本机字体」并授权(Chromium 103+,`file://` 与 `localhost` 都算安全上下文) | 全量 family,按 family 去重,中文名排前 |
| ② | 候选表探测 | 打开即跑,且 ① 不存在 / 被拒时兜底 | 对模板常量 `LOCAL_FONT_CANDIDATES`(常见中文字体,中英文名两写法)逐个用 canvas `measureText` 宽度对比判是否已装。**不用 `document.fonts.check()`**,它对系统字体恒 true |
| ③ | 自由输入 | ①② 都没列出(刚装的、名字带空格的) | 文本框敲 family 名回车即应用;探测不到会提示核对名字 |

三级全失败不阻塞:下拉只剩「当期默认」,其余功能照常。

- **默认字仍归 skill**:`T1_DEFAULT_FONT` 是审美决策(栏目封面风格资产的字体选型 / 中性默认),交付时说理由;下拉切换是微调面(SKILL.md 铁律 3)。
- **字重独立成档**(400 / 700 / 900,写数值):本机字体字重面各异,浏览器按最近字面匹配。
- **不持久化**:与坐标同口径,刷新回默认。
- **不嵌字体文件**:一款中文字体 5–20MB,体积红线直接爆。
- **`LOCAL_FONT_CANDIDATES` 是引擎层常量**,按栏目改的是 `T1_DEFAULT_FONT`,不是候选表;想让某款字体免授权出现在下拉里再往候选表加。

### 与 MG 颗粒字体口径的分界(别互相套)

| | MG 颗粒 | 封面工作台 |
|---|---|---|
| 渲染在哪 | 同合云渲染服务端(gsap-emit v1 铁律 6:字体名 MUST 命中服务端注册表) | 用户本机浏览器 |
| 导出在哪 | 服务端逐帧 seek | 本机 `html2canvas` |
| 本机字体 | **不可用** | **完全可用** |
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall