butubb
2112c1a870
移植自 mac-agent-os 的 mediacrawler_adapter：不起子进程、不开页面，用浏览器里那份
登录态直接调抖音 Web 接口。产物键名照抄 store/douyin，所以 ingest 那条链路一个字不用改。
**目前能用的（真环境实测，非推断）**：
profile/other : 200, 7075 字节 —— 博主主页指标（粉丝/获赞/作品数/昵称）
aweme/detail : 200, 45425 字节 —— 单条作品详情（含点赞/评论/收藏/分享）
**目前不能用的：作品列表 `aweme/post`。** 两个互相独立的原因：
1. 这个接口被抖音单独升级成了真校验：不带 x-tt-argus 回 403「Uifid Not Found」，
带上 dummy 值回 200 + **空 body**。也就是说「头在不在」骗得过，「真校验」过不了。
同一套头打 profile/other 和 aweme/detail 都是通的 —— 抖音是挑着接口加保护的，
挑中的恰好是「批量拉作品列表」这个最敏感的动作。
2. 改走页面截获也不行：CDP 浏览器打开博主主页会落到「验证码中间页」（当天大量探测的
代价，过几小时要重测）。
所以现在的边界是：**已知作品的指标刷新能做，自动发现新作品做不了**。
**排查中控住变量后得到的两条事实**（都写进注释了）：
· `Accept` / `Accept-Language` / `Referer` 才是主页接口能返回真数据的原因 —— 只有
UA+client hints+Cookie 时是 200 但仅 121 字节的空壳，补上这三个头变 7074 字节。
（我先前猜的 sec-ch-ua 不是关键。）
· 因此 UA 与 client hints 必须**成套地取自同一个浏览器**，所以 BrowserIdentity 一次
从 CDP 取齐 cookie + UA + hints，而不是各自写死。
「200 + 空 body 必须当场报错」也是刻意写死的：放过去它会在下游变成「这个博主没作品」，
把一次失败伪装成一条正常结果 —— 爬虫那条路正是这么栽的，还被翻译成「账号被封」。
测试 +11：cookie 解析、请求头成套性（含 uifid 缺失/回退）、产物键名与 store 对齐、
以及 _get 的三条失败路径（空 body / 403 带网关原话 / 正常返回）。
4.3 KiB
4.3 KiB
collected, collected_date
| collected | collected_date |
|---|---|
| true | 2026-05-16 |
Ch18: 常见问题解决方案库
结果导向：从"不想看到的成果"反推修复方案
核心问题分类
A. 画面类问题
A1. 人脸变形/身份漂移
| 症状 | 修复方案 | 优先级 |
|---|---|---|
| 人脸扭曲变形 | 提供清晰角色参考图锁定身份 | ⭐⭐⭐ |
| 不同镜头角色变脸 | 使用静止或缓慢移动的镜头 | ⭐⭐⭐ |
| 面部特写变形严重 | 减少面部特写时长，动态场景切换镜头 | ⭐⭐ |
| 首帧OK后续崩 | 用第1帧好的脸作为参考图重生成 | ⭐⭐⭐ |
提示词修复：
[角色描述]，面部始终保持完全一致，无变形。
A2. 物体漂移/元素消失
| 症状 | 修复方案 | 优先级 |
|---|---|---|
| 物体位置随机漂移 | 提示词中文字锚定关键物体 | ⭐⭐⭐ |
| 物体中途消失 | 最小化画面中物体数量 | ⭐⭐ |
| 场景元素乱变 | 使用静态构图(锁定机位) | ⭐⭐⭐ |
| 长视频不一致 | 生成更短的片段(3-5秒)后拼接 | ⭐⭐⭐ |
提示词修复：
红色咖啡杯始终保持在桌子上，位置固定不变。
A3. 光影闪烁/曝光变化
| 症状 | 修复方案 | 优先级 |
|---|---|---|
| 光照忽明忽暗 | 提示词指定光照：持续柔和的日光从左侧照射，无光照变化 | ⭐⭐⭐ |
| 多光源打架 | 使用单一光源，室内场景更稳定 | ⭐⭐ |
| 画面闪烁 | 使用平光风格，避免戏剧性光照 | ⭐⭐ |
后期补救：调色工具统一曝光。
A4. 画面风格跑偏
- 检查参考示例是否明确
- 换适配大模型（如写实→Kling，动漫→Pika）
- 提示词加入风格锚点：
cinematic, photorealistic, anime style
B. 运动类问题
B1. 不自然动作/飘忽运动
| 症状 | 修复方案 | 优先级 |
|---|---|---|
| 动作漂浮感 | 提示词明确描述物理效果：沉重的脚步声，可见的地面冲击 | ⭐⭐⭐ |
| 运动逻辑诡异 | 参考真实运动：像一个疲惫的人提着购物袋走路 | ⭐⭐ |
| 与环境无交互 | 包含环境交互：脚踢起灰尘，手按入靠垫 | ⭐⭐ |
| 动作过快看不清 | 放慢动作速度，隐藏飘忽感 | ⭐ |
B2. 手部与手指问题
- 裁剪手部或让其失焦
- 使用简单手部姿势（握拳、张开手掌）
- 避免手部特写，使用广角镜头
- 多次生成并挑选最佳版本
B3. 时间不一致性（"梦境"效果）
- 分段生成：3-5秒片段后拼接
- 每个片段重复关键视觉描述符
- 使用相同种子保证一致起点
- 应用风格参考帧
C. 音频类问题
| 问题 | 修复方案 |
|---|---|
| 背景音乐盖过对白 | 降低音乐音量，提升对白混响清晰度 |
| 音画不同步 | 检查视频帧率与音频时间轴对齐 |
| 环境音违和 | 根据场景选择匹配的环境音类型 |
| AI配音无情感 | 加入语气/情绪描述参数 |
D. 工具类问题
| 问题 | Workaround |
|---|---|
| 排队时间过长 | 选择低峰时段/换用替代工具 |
| 生成失败/报错 | 缩短提示词至50-100词 |
| 风格不符合预期 | 换用更适配的大模型 |
| 角色一致性差 | 切换到Pika(多镜头锚点)或Kling(人脸模型) |
提示词优化技巧
1. 明确指出"什么不应该改变"
光照始终保持恒定
角色外观保持完全一致
机位固定，无运动
2. 描述物理效果，而非仅视觉
❌ "一个球弹跳"
✅ "一个橡皮球落下，撞击地面时压缩，并以递减的高度弹回"
3. 使用电影语言
中景，锁定机位，50mm镜头
缓慢推进，平稳运动
自然光，无人工光源
4. 包含时间锚点
场景开始于...然后...最后...
在整个片段中始终...
在任何时候都不要...
5. 文字与Logo
- ❌ 不要在视频中生成文字
- ✅ 务必在后期添加
- 模糊或隐藏Logo
采集来源
| 来源 | 内容 |
|---|---|
| genra.ai | 7个消除AI痕迹的方法 |
| chooseai.net | 人物一致性实操指南 |
| yileai.cn | 画面不连贯修复 |
| smzdm.com | 参考图工作流+模型适配 |