Skip to content

JimLiu/baocut / skills/baocut

baocut

Flagged

用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。

FileKindSize
SKILL.mdskill md46.5 KB
built-in-skills/README.mdmarkdown9.6 KB
references/catalog/editing.mdmarkdown24.4 KB
references/catalog/export.mdmarkdown6.6 KB
references/catalog/media.mdmarkdown45.1 KB
references/catalog/models.mdmarkdown7.9 KB
references/catalog/music.mdmarkdown17.1 KB
references/catalog/subtitles.mdmarkdown20.8 KB
references/catalog/system.mdmarkdown9.6 KB
references/catalog/voice-gemini-tts.mdmarkdown2.6 KB
references/catalog/voice-language-rates.mdmarkdown6.5 KB
references/catalog/voice.mdmarkdown12.3 KB
references/catalog/web.mdmarkdown10.9 KB
references/conventions.mdmarkdown16.1 KB
references/craft/.gitkeepother0 B
references/craft/README.mdmarkdown480 B
references/craft/character-animation.mdmarkdown6.8 KB
references/craft/character-animation/examples/mini-film/art.example.jsonconfig918 B
references/craft/character-animation/examples/mini-film/index.htmlother628 B
references/craft/character-animation/examples/mini-film/scene.jsscript2.1 KB
references/craft/character-animation/references/art.mdmarkdown4.6 KB
references/craft/character-animation/references/checks.mdmarkdown2.6 KB
references/craft/character-animation/references/rig.mdmarkdown5.3 KB
references/craft/character-animation/references/style-and-story.mdmarkdown5.0 KB
references/craft/character-animation/references/timing-and-sound.mdmarkdown3.1 KB
references/craft/character-animation/rig-kit/rig-kit.jsscript33.0 KB
references/craft/character-animation/scripts/cutout.mjsscript26.9 KB
references/craft/character-animation/scripts/jump-scan.mjsscript3.2 KB
references/craft/character-animation/scripts/place-sfx.mjsscript5.1 KB
references/craft/character-animation/scripts/rig-check.mjsscript8.9 KB
references/craft/clip-montage.mdmarkdown11.5 KB
references/craft/clip-montage/references/assembly.mdmarkdown5.0 KB
references/craft/clip-montage/references/sourcing.mdmarkdown6.3 KB
references/craft/clip-montage/references/structure.mdmarkdown3.8 KB
references/craft/cover-and-title.mdmarkdown5.6 KB
references/craft/cross-video-qa.mdmarkdown5.8 KB
references/craft/design-system.mdmarkdown18.5 KB
references/craft/design-system/references/cover.mdmarkdown6.9 KB
references/craft/design-system/references/craft.mdmarkdown8.8 KB
references/craft/design-system/references/demo.jsonconfig161.1 KB
references/craft/design-system/references/format.mdmarkdown18.6 KB
references/craft/design-system/references/from-code.mdmarkdown11.5 KB
references/craft/design-system/references/from-design-tool.mdmarkdown16.2 KB
references/craft/design-system/references/sample-seazar-tokens.jsonconfig11.0 KB
references/craft/design.mdmarkdown19.3 KB
references/craft/design/references/brand-colors.mdmarkdown2.4 KB
references/craft/design/references/brand-typography.mdmarkdown1.7 KB
references/craft/design/references/craft.mdmarkdown15.4 KB
references/craft/design/references/design-system-components.mdmarkdown11.8 KB
references/craft/design/references/diagrams.mdmarkdown10.1 KB
references/craft/design/references/format.mdmarkdown11.8 KB
references/craft/design/references/print.mdmarkdown5.6 KB
references/craft/design/references/questions.mdmarkdown4.7 KB
references/craft/design/references/view-state.mdmarkdown5.7 KB
references/craft/docs.mdmarkdown19.9 KB
references/craft/docs/references/comments.mdmarkdown4.4 KB
references/craft/docs/references/editing.mdmarkdown12.9 KB
references/craft/docs/references/tabs.mdmarkdown4.7 KB
references/craft/docs/references/uploads.mdmarkdown1.7 KB
references/craft/explainer-video.mdmarkdown23.4 KB
references/craft/explainer-video/references/3d.mdmarkdown5.9 KB
references/craft/explainer-video/references/footage.mdmarkdown9.6 KB
references/craft/explainer-video/references/length-and-pace.mdmarkdown6.7 KB
references/craft/explainer-video/references/script.mdmarkdown14.7 KB
references/craft/explainer-video/references/subject.mdmarkdown12.5 KB
references/craft/history-video.mdmarkdown20.6 KB
references/craft/history-video/references/brief.mdmarkdown5.1 KB
references/craft/history-video/references/forms.mdmarkdown11.2 KB
references/craft/history-video/references/old-recordings.mdmarkdown12.4 KB
references/craft/history-video/references/self-check.mdmarkdown5.3 KB
references/craft/history-video/references/sources.mdmarkdown5.9 KB
references/craft/motion-graphics.mdmarkdown17.3 KB
references/craft/motion-graphics/exemplars/big-number/16x9.htmlother11.4 KB
references/craft/motion-graphics/exemplars/big-number/9x16.htmlother11.5 KB
references/craft/motion-graphics/exemplars/callout-pin/16x9.htmlother11.6 KB
references/craft/motion-graphics/exemplars/callout-pin/9x16.htmlother11.6 KB
references/craft/motion-graphics/exemplars/keyword-caption/16x9.htmlother11.3 KB
references/craft/motion-graphics/exemplars/keyword-caption/9x16.htmlother11.3 KB
references/craft/motion-graphics/exemplars/logo-sting/16x9.htmlother12.1 KB
references/craft/motion-graphics/exemplars/logo-sting/9x16.htmlother12.1 KB
references/craft/motion-graphics/exemplars/lower-third/16x9.htmlother11.2 KB
references/craft/motion-graphics/exemplars/lower-third/9x16.htmlother11.2 KB
references/craft/motion-graphics/references/audio-backdrop.mdmarkdown22.9 KB
references/craft/motion-graphics/references/grammar.mdmarkdown11.1 KB
references/craft/motion-graphics/scaffold.htmlother9.0 KB
references/craft/motion-graphics/scripts/build-bundle.mjsscript25.2 KB
references/craft/narration.mdmarkdown11.1 KB
references/craft/polish-transcript.mdmarkdown13.8 KB
references/craft/production-scripts.mdmarkdown15.7 KB
references/craft/production-scripts/references/pipeline.mdmarkdown37.8 KB
references/craft/production-scripts/scene-kit/geo110.jsscript27.3 KB
references/craft/production-scripts/scene-kit/scene-kit.jsscript38.3 KB
references/craft/production-scripts/scripts/align.mjsscript11.6 KB
references/craft/production-scripts/scripts/assemble.mjsscript26.4 KB
references/craft/production-scripts/scripts/build.mjsscript18.1 KB
references/craft/production-scripts/scripts/captions.mjsscript18.6 KB
references/craft/production-scripts/scripts/clips.example.jsonconfig3.2 KB
references/craft/production-scripts/scripts/coverage.mjsscript10.0 KB
references/craft/production-scripts/scripts/envelope.mjsscript2.9 KB
references/craft/production-scripts/scripts/explainer.example.jsonconfig2.2 KB
references/craft/production-scripts/scripts/fonts.mjsscript7.0 KB
references/craft/production-scripts/scripts/frames.mjsscript7.7 KB
references/craft/production-scripts/scripts/gaps.mjsscript11.3 KB
references/craft/production-scripts/scripts/host.mjsscript14.8 KB
references/craft/production-scripts/scripts/legibility.mjsscript5.7 KB
references/craft/production-scripts/scripts/level.mjsscript9.2 KB
references/craft/production-scripts/scripts/lib.mjsscript19.3 KB
references/craft/production-scripts/scripts/overlay.mjsscript34.7 KB
references/craft/production-scripts/scripts/preview.mjsscript4.6 KB
references/craft/production-scripts/scripts/quotes.mjsscript7.4 KB
references/craft/production-scripts/scripts/sources.mjsscript6.2 KB
references/craft/production-scripts/scripts/srt.mjsscript5.8 KB
references/craft/production-scripts/scripts/voice.mjsscript7.7 KB
references/craft/shorts-segments.mdmarkdown30.8 KB
references/craft/slides.mdmarkdown13.8 KB
references/craft/slides/references/design-system.mdmarkdown6.3 KB
references/craft/slides/references/design.mdmarkdown9.3 KB
references/craft/slides/references/format.mdmarkdown12.2 KB
references/craft/slides/references/images.mdmarkdown4.2 KB
references/craft/speaker-labeling.mdmarkdown6.6 KB
references/craft/subtitle-workflow.mdmarkdown13.1 KB
references/craft/talking-head-cut.mdmarkdown9.3 KB
references/craft/talking-head-cut/references/picture-and-sound.mdmarkdown10.1 KB
references/craft/titles-and-description.mdmarkdown5.2 KB
references/craft/titles-and-description/references/description.mdmarkdown5.1 KB
references/craft/titles-and-description/references/titles.mdmarkdown5.5 KB
references/craft/titles-and-description/references/writing-baseline.mdmarkdown11.9 KB
references/craft/translate-subtitles.mdmarkdown13.4 KB
references/craft/video-blog.mdmarkdown17.1 KB
references/craft/video-blog/references/writing-baseline.mdmarkdown11.9 KB
references/craft/video-chapters.mdmarkdown9.7 KB
references/craft/video-production.mdmarkdown31.9 KB
references/craft/video-production/examples/bundle-preview.htmlother17.7 KB
references/craft/video-production/examples/post-fx.jsscript7.5 KB
references/craft/video-production/references/code-scenes.mdmarkdown31.9 KB
references/craft/video-production/references/shot-plan.mdmarkdown5.1 KB
references/craft/video-production/references/sound-design.mdmarkdown4.4 KB
references/craft/video-production/references/visuals.mdmarkdown19.7 KB
references/craft/video-summary.mdmarkdown22.8 KB
references/craft/video-summary/references/writing-baseline.mdmarkdown11.9 KB
references/craft/virtual-host.mdmarkdown14.9 KB
references/craft/virtual-host/examples/character-partmap.example.jsonconfig600 B
references/craft/virtual-host/examples/character.example.jsonconfig336 B
references/craft/virtual-host/references/art.mdmarkdown22.1 KB
references/craft/virtual-host/references/hosts.mdmarkdown4.4 KB
references/craft/virtual-host/references/lipsync.mdmarkdown10.1 KB
references/craft/virtual-host/scripts/lipsync.mjsscript39.8 KB
references/craft/virtual-host/scripts/pinyin-table.mjsscript83.2 KB
references/craft/virtual-host/scripts/puppet-build.mjsscript48.6 KB
references/craft/virtual-host/scripts/puppet-mask.mjsscript3.0 KB
references/craft/virtual-host/scripts/puppet/align.mjsscript4.1 KB
references/craft/virtual-host/scripts/puppet/brows.mjsscript17.2 KB
references/craft/virtual-host/scripts/puppet/edits.mjsscript4.3 KB
references/craft/virtual-host/scripts/puppet/expression-labels.jsonconfig1.1 KB
references/craft/virtual-host/scripts/puppet/expreyes.mjsscript35.9 KB
references/craft/virtual-host/scripts/puppet/eyes.mjsscript8.6 KB
references/craft/virtual-host/scripts/puppet/fill.mjsscript10.5 KB
references/craft/virtual-host/scripts/puppet/layers.mjsscript5.7 KB
references/craft/virtual-host/scripts/puppet/mapbuild.mjsscript50.4 KB
references/craft/virtual-host/scripts/puppet/ops.mjsscript7.4 KB
references/craft/virtual-host/scripts/puppet/pack.mjsscript10.2 KB
references/craft/virtual-host/scripts/puppet/partmap.mjsscript8.5 KB
references/craft/virtual-host/scripts/puppet/parts.mjsscript7.0 KB
references/craft/virtual-host/scripts/puppet/png.mjsscript5.8 KB
references/craft/virtual-host/scripts/puppet/seg.mjsscript21.6 KB
references/craft/virtual-host/scripts/puppet/segment.mjsscript26.6 KB
references/craft/virtual-host/scripts/puppet/zip.mjsscript2.0 KB
references/craft/virtual-host/scripts/visemes.mjsscript21.4 KB
references/craft/vlog-from-clips.mdmarkdown13.2 KB
references/craft/vlog-from-clips/references/footage-log.mdmarkdown3.3 KB
references/mcp.mdmarkdown8.9 KB
references/start.mdmarkdown6.3 KB
references/workflows.mdmarkdown29.8 KB

references/craft/virtual-host.md

View on GitHub
<!-- 由 tools/sync-agent-skill.ts 从 skills/baocut/built-in-skills/virtual-host/ 生成,不要手改:改源文件后运行 npm run build:agent-skill -->

# 虚拟主播

> 做会说话的卡通虚拟主播时用:一个卡通角色(半身像)跟着旁白自动对口型,会眨眼、呼吸、点头转头、头发跟着晃,可以换表情,常驻在画面角落讲解或整镜出镜。用户没有自己的角色时从 BaoCut 自带的 19 个原创主播里推荐,要自己的形象时才生成正面像、改图拆成分层的角色包;口型按读音与音量算成动作轨;放上时间线是一个角色贴纸,预览与导出直接画,不用烘焙。不用于:真人照片或实拍视频对口型、换脸与写实数字人;角色走动、拿东西的表演(character-animation);只要一张插图。

一个虚拟主播是时间线上的一个**角色贴纸**,它指着两份素材:

- **角色包**(`.bcpuppet`):一张正面像拆成的分层角色。头发、眼睛、眉毛、嘴、身体各在一层,引擎按物理画出转头点头、头发跟着晃,以及眨眼、呼吸、视线这些待机动作。
- **动作轨**(`baocut-puppet-track` 的 JSON):嘴张多大、圆嘴扁嘴、说话时的点头转头与表情随时间的曲线,由配音算出来;眨眼、呼吸、视线和安静时的小动作由播放器自己加。

预览与导出都由引擎直接画这个贴纸,不经代码画面,不用烘焙。

它是 `video-production` 的一种形态:简报、能力盘点、审片、导出照那份做法(动手前读它第 1–3 节),旁白照 `narration`;这里只补主播特有的部分。

本 skill 的 `scripts/` 要命令行环境:Node 22 以上与 ffmpeg,不调 API、不碰 API Key。用时把整个目录拷进工程(例如 `<工程>/tools/virtual-host/`):能直接读到文件时拷目录,读不到时读 `scripts/` 下每个文件(含 `scripts/puppet/`)原样写进去;脚本互相 import,要拷全。没有命令行环境时这条路走不通,如实告诉用户。

## 1. 先定下来

| 项 | 缺省 | 说明 |
| --- | --- | --- |
| 角色 | 内置主播 | 用户没有自己的角色时,读 [内置主播:怎么挑](virtual-host/references/hosts.md):按片子的内容与观众,从 BaoCut 自带的原创角色(半身动漫与 Q 版,表里有性别、年龄、气质、适合的片子与配音建议)里推荐两三个,缩略图给用户看,用户选定再用,跳过第 2 节。用户要自己的形象或指定的长相时才生成:照自己的照片或已有形象画可以(本人或有授权),不画真实的他人;正面像先给用户看,定了再改图 |
| 画风 | 扁平矢量、粗描边、平涂色块 | 平涂的脚本按颜色自己分出头发、皮肤、眼白和线条。柔和阴影的动漫、厚涂、Q 版这类分不开颜色的画风,多出一张分区图([角色包:正面像、光头重绘、改图与打包](virtual-host/references/art.md) 第 5 节),同时出一份 LivLiv 角色包(`.livliv`) |
| 出镜 | 右下角常驻 | 也可以左下角、整镜出镜(放大放到画面中间)、两人对话(两个角色包、两条动作轨) |
| 表情 | 不加 | 笑、害羞、生气、难过这类,每种多一张改图,按句写进 `faces.json`;同一处可配点头、摇头、歪头、轻跳、低头侧脸的动作(`act`) |
| 预算 | 内置主播不调图片;生成约 9 次图片调用 | 正面像 1 次(出 2 张挑)、光头重绘 1、嘴 4、闭眼 1、每种表情 1,分区图 1(只有柔和阴影的画风要),再留两三次重画;按 `baocut models capabilities` 的 `cost` 估价写进计划 |

口型按读音定闭唇(b p m)、咬唇(f v)、圆唇(o u w)这些特征,按音量定张多大。中文、日文假名、韩文、英文有读音规则,西班牙文、德文这类拉丁字母语言按拼写粗略推;日文汉字、生僻字与俄文、阿拉伯文这类文字读不出读音,只按音量开合,需要时用读音表补(第 3 节)。做中、日、韩、英以外的语言时先告诉用户这一点。

## 2. 角色包

用内置主播时不做这一节:`baocut hosts show`(`id`)把角色包备好在本机,给出路径与一条现成的 `importAsset`,第 4 节直接用。内置主播都带 `smile`、`shy`、`angry`、`sad`、`surprised` 五种表情,`faces.json` 只用这几个名字。

下面是生成新角色:

1. 用 `baocut image` 生成正面像,提示词在 [角色包:正面像、光头重绘、改图与打包](virtual-host/references/art.md) 第 1 节(柔和阴影的画风看第 5 节),一次出两张给用户挑。下面说的范围是平涂的;有分区图时不看画风与颜色,只要纯色底、正面、有头发、眼睛睁开、嘴闭着。平涂脚本能拆的范围:纯色饱和底;正面;有头发(光头角色还不支持);两只眼睛睁开、露出眼白;嘴闭成一条线;皮肤是浅的暖色(别的肤色在 `character.json` 写 `skin`);描边是一种深色(黑、深棕都行)。
2. 用 `baocut artifacts save` 把选定的图存进工程,照 [`examples/character.example.json`](virtual-host/examples/character.example.json) 写 `character.json`(字段见 [角色包:正面像、光头重绘、改图与打包](virtual-host/references/art.md) 第 4 节;柔和阴影的画风先出分区图写进 `partmap`,照 [`examples/character-partmap.example.json`](virtual-host/examples/character-partmap.example.json)),运行 `node puppet-mask.mjs character.json`。它找出头发,写出 `hair-mask.json`(`baocut retouch` 的选区)和 `hair-mask.png`(白色是头发)。看一眼 PNG:白色应该正好盖住头发,不带耳朵、脸的轮廓。
3. 光头重绘:`baocut retouch` `op: "repaint"`,`files` 给正面像,`mask` 给 `hair-mask.json` 的内容,`prompt` 照 [角色包:正面像、光头重绘、改图与打包](virtual-host/references/art.md) 第 2 节。结果(`<原名>-repainted.png`)是头发下面的头皮:头发晃开、转头时露出来的就是它。写进 `bald`。
4. 改图:以正面像为输入(`images` 给它的 entryId),出 4 种嘴(`half`、`open`、`round`、`wide`)、闭眼(`lids`)和要的表情,模板与每张的描述在 [角色包:正面像、光头重绘、改图与打包](virtual-host/references/art.md) 第 3 节。各张互不依赖,可以同时提交。存进工程,写进 `character.json`。
5. 运行 `node puppet-build.mjs character.json`。每项检查打一行:`ok` 能用,`FIX` 后面写着重画哪一张、为什么;有 `FIX` 时退出码是 1。重画那一张后整个重跑(几秒到半分钟)。全部 `ok` 后看 `puppet/rest-diff.png`:几乎全黑才对,亮的地方是静止时和正面像不一样的地方。成品是 `puppet/<name>.bcpuppet`;有分区图时另有 `puppet/<name>.livliv`,LivLiv 播放器直接能开。每项检查的读法在 [角色包:正面像、光头重绘、改图与打包](virtual-host/references/art.md) 第 4、5 节。

## 3. 动作轨

1. 旁白先定稿配好(`narration`)。逐字时间来自 `production-scripts` 的 `timing/<段>.json`;或者给配音单独转写一次:`baocut transcribe` 给 `file` 并带 `noVideo: true`,`baocut jobs inspect` 等到 completed,`pipeline.summary.transcribeJobId` 是内层转写任务,再 `baocut jobs inspect` 它,用 `baocut artifacts save` 把转写结果存成 `<名>.words.json`(`baocut.asr-result/v1`)。
2. 运行 `node lipsync.mjs --words intro.words.json --audio intro.wav --out host/intro.track.json --lang zh-CN`(timing 用 `--timing`)。一定给 `--audio`,而且是放进视频的那份配音:音量决定静音时闭嘴、轻读时嘴小,也兜住对齐误差。轨的 0 秒是配音的 0 秒。选项、`faces.json` 与读音表的写法在 [动作轨:输入、选项与核对](virtual-host/references/lipsync.md)。
   旁白按段配、用 `production-scripts` 的脚本摆时间线的片子,这一步与第 4 节交给它的 `host.mjs`(读 [`references/craft/production-scripts.md`](production-scripts.md),再按它「按顺序跑」读):它按段算口型,把连着出镜的几段拼成一条动作轨、放成一个贴纸,重配或改稿后重跑只动变了的。不要一段一个贴纸首尾相接:每个贴纸从头开始待机,段与段相接处头和头发会跳一下。
3. 读同目录的 `lipsync-check.txt`:每个字的读音、读音给的口型和画面上实际出的口型。读音不对(多音字、日文汉字、品牌名、缩写)写进读音表、带 `--readings` 重跑;`?` 是读不出的字,按音量张嘴。

## 4. 放上时间线

用 `baocut edits apply` 一笔做完:两次 importAsset(角色包与动作轨,`storage: "managed"`,各给一个 `ref`;内置主播的那条照抄 `baocut hosts show` 给的 `importAsset`),加一条 insertItems。主播放在最上面一条视觉轨(没有空的就同一笔 addTrack,用 `trackRef`):

```json
{ "type": "insertItems", "items": [{
  "type": "sticker", "trackId": "<视觉轨>", "span": { "fromFrame": 0, "durationFrames": 900 },
  "place": { "x": 84, "y": 74, "w": 30 },
  "sticker": { "source": "asset" }, "assetImportRef": "host", "motionImportRef": "intro",
  "motionIn": { "ticks": "0", "timescale": 1 }
}] }
```

- **对齐配音**:`motionIn` 是贴纸开头对着动作轨的第几秒。贴纸和配音同时开始写 0;贴纸比配音早 2 秒出现(先待机再开口)写 `{"ticks": "-2", "timescale": 1}`(`ticks` 是整数字符串,负半秒写 `{"ticks": "-1", "timescale": 2}`)。嘴早了或晚了一截,多半是这里没对上。
- **位置**:贴纸的框宽是画布宽的 `w`%,高按角色画布的比例(竖版立绘多是 2:3)。16:9 画面放右下角约 `{"x": 84, "y": 74, "w": 30}`,下沿压在画外;9:16 约 `{"x": 74, "y": 86, "w": 50}`。整镜出镜放中间,`w` 加大。半身角色的下沿要压在画外:压出去多少,轻跳就能往上跳多少,下沿在画面里时只往下沉。
- **给主播留位置**:常驻的主播占着画面的一块,这期的版式从分镜起就把这一块留出来,字幕、水印、角标与要读的内容都不压在他身上,也不让他挡住;哪几段需要整幅画面(满幅的图表、实拍、片头片尾)就让他那几段不出镜,不靠缩小内容迁就。
- **长度**:`span` 盖住要出镜的整段。动作轨之外(配音前、配音后)角色照样眨眼呼吸,嘴闭着。
- **换配音**:重新算动作轨,replaceItemAsset 给这个贴纸和新动作轨的 `assetImportRef`:只换动作轨,位置与长度不变。换角色同样用 replaceItemAsset,给新的角色包。
- **用户已从元素面板放了内置主播**(编辑器元素面板的「虚拟主播」一节:一个没挂动作轨、只做待机动作的角色贴纸):不再导入角色包。贴纸开头正对着配音开头时,同一笔 importAsset 动作轨、replaceItemAsset 给这个贴纸和动作轨的 `assetImportRef`(`motionIn` 缺省 0);没对上时同一笔 deleteItems 它,再照上面 insertItems 一个,`assetRef` 用它的角色包,`place` 照抄它的。
- **两个主播**:两个角色包、两条动作轨、两个贴纸;`--seed` 给不同的值,免得点头同步。

审片照 `video-production`:`baocut videos frames` 取的帧不含贴纸,看主播要在编辑器的预览里看(直接画),或者用 `baocut export` 导出那一段的预览(`purpose: "preview"`,`range`)。请用户听着看一遍主播那块:闭唇的字要闭上、长元音要张开、句间停顿要闭嘴。用户看过再导出成片。

## 5. 常见问题

| 现象 | 原因与改法 |
| --- | --- |
| 嘴整体比声音早或晚一截 | `motionIn` 没对上配音:贴纸开头比配音早几秒就写负几秒 |
| 整句嘴都半张、停顿也不闭 | 算动作轨时没给 `--audio`,或给的不是放进视频的那份配音 |
| 某个字口型不对 | 先看核对表:读音错了补读音表;读音对、口型不对多半是逐字时间偏了,重新对齐或重新转写 |
| 只眨眼、不说话 | 贴纸没挂动作轨(`motionRef`),或 `motionIn` 让配音落到了贴纸之外 |
| `puppet-mask` 或 `puppet-build` 第一行就是 `FIX portrait` | 正面像不在能拆的范围(第 2 节第 1 步):照后面的原因重画正面像,或在 `character.json` 写 `skin`、`line`、`hair` |
| 转头、头发晃开时露出头发的残影或一块底色 | 光头重绘不干净:照 `FIX bald repaint` 的原因重画,或重跑 `puppet-mask` 再重画 |
| 说话时嘴边一圈色块、线条断开 | 那张嘴的改图动了嘴外面的像素:重画那一张 |
| 笑的时候脸上一块颜色不对 | 表情的改图动了脸的别处:重画,提示词强调只改嘴 |
| 主播太小看不清嘴 | 加大 `w`;1024 像素的角色画到 300 像素以下时嘴型很难看出来 |

## 同目录的文件

在 `references/craft/virtual-host/` 下,用到时再打开;代码与样例原样复制,按正文说的用法取用。

- [`examples/character-partmap.example.json`](virtual-host/examples/character-partmap.example.json)
- [`examples/character.example.json`](virtual-host/examples/character.example.json)
- [角色包:正面像、光头重绘、改图与打包](virtual-host/references/art.md)
- [内置主播:怎么挑](virtual-host/references/hosts.md)
- [动作轨:输入、选项与核对](virtual-host/references/lipsync.md)
- [`scripts/lipsync.mjs`](virtual-host/scripts/lipsync.mjs)
- [`scripts/pinyin-table.mjs`](virtual-host/scripts/pinyin-table.mjs)
- [`scripts/puppet/align.mjs`](virtual-host/scripts/puppet/align.mjs)
- [`scripts/puppet/brows.mjs`](virtual-host/scripts/puppet/brows.mjs)
- [`scripts/puppet/edits.mjs`](virtual-host/scripts/puppet/edits.mjs)
- [`scripts/puppet/expression-labels.json`](virtual-host/scripts/puppet/expression-labels.json)
- [`scripts/puppet/expreyes.mjs`](virtual-host/scripts/puppet/expreyes.mjs)
- [`scripts/puppet/eyes.mjs`](virtual-host/scripts/puppet/eyes.mjs)
- [`scripts/puppet/fill.mjs`](virtual-host/scripts/puppet/fill.mjs)
- [`scripts/puppet/layers.mjs`](virtual-host/scripts/puppet/layers.mjs)
- [`scripts/puppet/mapbuild.mjs`](virtual-host/scripts/puppet/mapbuild.mjs)
- [`scripts/puppet/ops.mjs`](virtual-host/scripts/puppet/ops.mjs)
- [`scripts/puppet/pack.mjs`](virtual-host/scripts/puppet/pack.mjs)
- [`scripts/puppet/partmap.mjs`](virtual-host/scripts/puppet/partmap.mjs)
- [`scripts/puppet/parts.mjs`](virtual-host/scripts/puppet/parts.mjs)
- [`scripts/puppet/png.mjs`](virtual-host/scripts/puppet/png.mjs)
- [`scripts/puppet/seg.mjs`](virtual-host/scripts/puppet/seg.mjs)
- [`scripts/puppet/segment.mjs`](virtual-host/scripts/puppet/segment.mjs)
- [`scripts/puppet/zip.mjs`](virtual-host/scripts/puppet/zip.mjs)
- [`scripts/puppet-build.mjs`](virtual-host/scripts/puppet-build.mjs)
- [`scripts/puppet-mask.mjs`](virtual-host/scripts/puppet-mask.mjs)
- [`scripts/visemes.mjs`](virtual-host/scripts/visemes.mjs)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall