douyin-style-profiler

抖音作品 DNA 提取与聚合工具。输入是视频转录文本（口播全文 + 标题 / 描述 / 时长 / 互动线索）或图文文本（标题 + 正文 + 话题标签），由 Agent 先整理成 .md / .txt；可选封面 / 首帧 / 配图作为视觉证据。不接受视频文件或链接作为直接输入（取数走 viral-chaser 或平台工具）。

DNA 的用途是指导 main agent 选题、包装、出内容或出视频制作 Brief；不指导成片制作, , 创作细节、脚本结构、镜头与编码参数归 Content Producer。

作品类型（--kind）

抖音有两套维度框架，用 --kind 选择；一个 dna-id 只承载一种作品类型：

kind	作品	维度框架	默认 dna-id
video	视频	references/video-dna-framework.md	dna-0
note	图文	references/note-dna-framework.md	dna-0-note

• 不传 --kind 时默认 video（抖音的主作品类型）。
• build / update 会校验同一 DNA 目录下 report 的 kind 一致，混型直接报错, , 另一种类型请另建 dna-id。
• 默认 dna-id 只是约定：用户可以指定任意 dna-id，脚本不强制命名。

产物模型

单篇作品 -> DNA report
同一 dna-id 下全部 report + 权重 / focus + 用户输入转译 -> DNA 文档
DNA 文档 -> DNA template

• DNA report：单篇作品的样本观测 + 维度提取结果；跨篇共性与生产规则由聚合阶段给出，report 本身不是模板。
• DNA 文档：聚合后的生产规则、样本覆盖度、子模块结论与用户输入转译区。
• DNA template：main agent 的生产输入模板（视频 = Brief 正文 + 口播文案；图文 = 写作模板）。

存储结构

douyin/dna/{dna-id}/
  reports/
    {sample-id}.report.md
  covers/
    {sample-id}.{ext}
  {dna-id}.dna.md
  {dna-id}.template.md

原始转录 / 正文文本可临时放在 douyin/ref/{dna-id}/transcripts/；生成后的 report 必须进入目标 DNA 的 reports/ 目录。

职责边界

• 抖音视频与图文都常见：先判作品类型再选框架，不要把图文笔记塞进视频 DNA。
• 单篇 report 只提供候选信号，不判断跨篇稳定性；共性、偏好、孤例由聚合阶段判断。
• 视觉维度必须有图片 / 关键帧证据，由视觉模型读取；缺失写「未提供」，不得凭文本想象补齐。
• 口播文案子模块只在口播类作品启用；样本不足写「未启用」。
• 账号运营子模块（简介写法、内容形式比例、发布习惯）只在样本来自对标账号批量提取时填写，且不进 template。
• 不输出风格评分或账号权重；合规只记「必须避免项」（虚假承诺、利益诱导互动、隐藏站外联系方式、谐音绕检测），不出具合规审查结论。

Report, 单篇提取

# 视频样本（不传 --kind，默认 video）
douyin-style-profiler report \
  --input path/to/transcript.md \
  --dna-id {dna-id} \
  --sample-id {sample-id} \
  --duration 36 \
  --cover-image path/to/cover.jpg \
  --source-url "https://www.douyin.com/video/..." \
  --output-dir douyin/dna/{dna-id}/reports