# skill-video-lapian

平台级**短视频拉片技能**: 下载 → 转写 → 抽帧 → 方法论逐段分析 → HTML 报告 → S3 个人空间发布。

## 命名规则(全平台技能以后都遵守)

```
skill-<领域>-<功能>
skill-video-lapian = 处理 video, 功能是 拉片(shot-by-shot breakdown)
其他示例: skill-audio-zhuanxie / skill-image-haibao / skill-data-report
```

## 平台级设计(核心)

任何数字生命克隆本仓库, 只配**自己的身份参数**就能跑全流程, 产物发布到**自己的** S3 个人空间:

```bash
# 飞马身份(每个生命不同)
export FEME_USERID=<Parse objectId>       # 如 sr2WiPsDyQ / pODNJqbURI / dhv9yTqK6K
export FEME_SESSION_TOKEN="r:..."         # 飞马会话
export FEME_NEWAPI_TOKEN="sk-..."         # API计费(VOC网关/转写/调模型都用它)
export FEME_STUDIO_URL=http://server.fmode.cn:<studio端口>

# S3 个人空间
export S3_BUCKET=storage-s3-nkkj
export S3_REGION=cn-north-4
export S3_ENDPOINT=https://obs.cn-north-4.myhuaweicloud.com
# AK/SK: 优先 <STUDIO_URL>/api/storage/credentials 取临时凭证(1小时, 限prefix);
# 过渡期未上线, 直接用容器 env 的 CLOUD_SDK_AK / CLOUD_SDK_SK
```

零硬编码: 全部凭据/路径从 env 或 `/opt/data/fmode-identity.json` 读取
(优先级 `FEME_*` env > identity.json > FMODE_* 兼容旧名)。

## 快速开始

```bash
export FEME_USERID=... FEME_SESSION_TOKEN=... FEME_NEWAPI_TOKEN=...
WD=/tmp/lapian-test
python3 scripts/fetch_video.py --aweme-id 7677548065384877346 --out-dir $WD
python3 scripts/fetch_comments.py --aweme-id 7677548065384877346 --workdir $WD   # 可选
python3 scripts/transcribe.py --workdir $WD
python3 scripts/frame_analysis.py --workdir $WD --max-frames 12
python3 scripts/build_report.py --workdir $WD --title "拉片分析:示例"
python3 scripts/publish.py --workdir $WD   # → 公开URL
```

依赖: python3.8+(纯标准库) / ffmpeg / node+npx。无需 pip 安装任何包。

## 目录

```
SKILL.md                  # 技能入口: 触发词+流程+参数说明
references/
  methodology.md          # 拉片方法论(薛辉/郑经说/三把刀/小希/南门)
  voc-api.md              # VOC采集接口(搜索/详情/评论)
  s3-upload.md            # S3发布规范(virtual-hosted/ACL/相对路径)
scripts/
  common.py               # 共享库: 身份参数/VOC/S3 SigV4(stdlib)
  fetch_video.py          # 下载视频(VOC网关或直链/本地)
  transcribe.py           # fmode-listen 转写(分段时间戳)
  fetch_comments.py       # 评论区采集(可选)
  frame_analysis.py       # 抽帧+豆包视觉逐帧点评
  build_report.py         # 生成HTML报告(内置mini-Jinja, 无第三方依赖)
  publish.py              # S3上传+公开URL+逐产物校验
templates/
  report.html.j2          # 报告模板(暗色/手机自适应/相对路径)
```

## 报告示例

听show·丽江酒吧《云南人的物欲》实测报告:
`user/sr2WiPsDyQ/report/lapian/douyin/20260829/report.html`
(端到端自测记录见 git log / 会话历史)

## License / 治理

- 内部技能, 随数字生命体系分发; 二进制产物只进 S3, 不进 git
- 修改方法论请同步 `/opt/data/knowledge-base/编导/` 源文件