---
name: text-keywords
description: "介绍并执行重点文字强调的三种方式：1）add_text 的 text_styles 关键词高亮；2）错位字幕（上下行/左右行）强调；3）字在人后（调用 text-background）。用户提到“重点词强调/关键词高亮/错位字幕/上下行字幕/左右行字幕/字在人后重点字”时必须使用本技能，且默认优先第三种方式。"
---

# Text Keywords Skill

用于在口播或字幕场景里强化“重点词/重点句”的视觉表达，统一提供三种可靠方案，并按“优先级 + 可执行参数”输出可直接落地的做法。

官方接口文档（方案 1）：
- https://docs.vectcut.com/321240978e0

## 何时使用

- 用户要“强调重点文字/关键词”
- 用户提到“关键词高亮”“重点词变色变大”
- 用户提到“错位字幕（上下行/左右行）”
- 用户要“字在人后”的重点文字表达

## 总体策略（必须遵循）

- 默认优先方案 3（字在人后）：稳定、效果明确、成功率高
- 当用户明确要求“纯字幕层关键词高亮”时，使用方案 1
- 当用户明确要求“排版冲击力/错位布局”时，使用方案 2
- 若用户未指定，先推荐方案 3；用户拒绝后再退到方案 1 或方案 2

## 通用视觉规范

字幕整体推荐字体（任选其一）：
- `思源宋体`
- `细体`
- `俪金黑`
- `研宋体`
- `新青年体`

字幕整体通用参数：
- `shadow_enabled=true`（必须开启阴影）
- `transition_x=0`
- `transition_y=-0.4`

常用配色与字号（普通词 / 重点词）：
- 组合 A：普通 `color=ffffff + font_size=12`，重点 `color=b71c1c + font_size=15`
- 组合 B：普通 `color=ffffff + font_size=12`，重点 `color=00ff4b + font_size=15`

## 方案 1：add_text + text_styles 关键词高亮

适用场景：
- 用户想在同一句里只突出某个词
- 用户希望保持单行字幕结构，只做局部强调

执行要点：
- 使用官方 `add_text` 接口
- 在单条字幕中通过 `text_styles` 指定关键词范围
- 普通文本使用基础样式，关键词单独覆写颜色和字号
- 整体仍保持通用字体、阴影和位移规范（`transition_x=0`、`transition_y=-0.4`）

建议做法：
1. 先确定整句文本与关键词
2. 为整句设置普通样式（白色、12）
3. 在 `text_styles` 中覆盖关键词样式（红色或绿色、15）
4. 确保关键词区间准确，避免高亮错位

## 方案 2：错位字幕（上下行 / 左右行）

适用场景：
- 用户要更强视觉冲击
- 重点信息需要与主句在空间上分离

执行要点：
- 主句与重点词分成两条文本（或两段布局）处理
- 字体与阴影沿用通用规范
- 重点词字号可提升到 `18~20`
- 颜色可沿用方案 1 的两组配色

错位参数建议：
- 上下错位：`transition_y=-0.4`（主句）与 `transition_y=-0.5`（重点）
- 左右错位：`transition_x=0.5` 或 `transition_x=-0.5`
- 需要上下+左右同时错位时，保持一个主方向突出，避免过度分散注意力

建议做法：
1. 主句维持正常阅读位
2. 重点词独立成强调位（上/下或左/右）
3. 重点词放大到 18~20，并套用高对比色
4. 预览检查是否遮挡人像与主体画面

## 方案 3：字在人后（默认优先）

适用场景：
- 用户追求稳定产出与高级感
- 用户接受人物前景 + 文字后置层次表达

执行要点：
- 直接调用 `text-background` 技能
- 该方案由官方链路封装，可靠性最高
- 若用户没有强制指定其他方案，应优先推荐并执行本方案

联动规则：
- 当用户说“字在人后/文字在人物后面/层次感字幕/高级感口播字幕”，必须优先走 `text-background`
- 输出中明确说明采用“方案 3（默认优先）”

## 与用户交互规则

- 用户已明确指定方案时，按用户指定执行，不强行替换
- 用户未指定方案时，先推荐方案 3，并给出一句理由（更稳、更快、更有层次）
- 若用户强调“必须是字幕轨内部高亮”，再切换到方案 1
- 若用户强调“冲击排版/错位设计”，再切换到方案 2

## 输出要求

- 必须明确：本次使用的是方案 1 / 2 / 3
- 必须给出：字体、阴影、位移与颜色字号组合
- 若使用方案 3，必须标注“已调用 text-background 技能”
- 若用户输入不足（缺文本、缺关键词、缺视频素材），先提示补齐，不编造素材