================================================================
        抖音口播三件套工作流 —— 新用户使用说明
        视频 + 口播音频 + 口播逐字稿
        全程免费、不用注册、不用密钥（Key）
        版本 v1.8.4 ｜ 已通过 Mac 和 Windows 双平台实测
        （本次更新：去掉可执行脚本，改为终端命令安装，
         任何上传平台都不会拦）
================================================================

【先说结论：你不用花一分钱】
本工具默认走「抖音官方分享页」解析视频，不需要注册任何账号、
不需要任何密钥、不扣任何费。语音识别在你自己电脑上离线完成，
视频、声音、文字稿都只存在你电脑里，不会上传给任何人。

本工具已经在 Mac 电脑 和 Windows 电脑（含中文版系统）上都实测
跑通，你照下面的步骤来就行。

----------------------------------------------------------------
一、你解压后看到的是什么
----------------------------------------------------------------
  安装说明-先看我.txt    （就是本文件，先看它）
  SKILL.md                （给 AI 助手看的说明书，你不用管）
  config.yaml            （配置，一般不用改）
  scripts\               （真正干活的几个小程序）
      _setup.py           （安装助手，下面命令会自动调用它）
      douyin_workflow.py
      extract_audio.py
      transcribe_local.py
      transcribe_api.py

----------------------------------------------------------------
二、怎么装（Mac 和 Windows 各看各的）
----------------------------------------------------------------

【Mac 用户】—— 打开「终端」，复制粘贴一条命令即可

  第一步：打开终端
    点屏幕右上角放大镜（Spotlight），输入"终端"，回车打开。

  第二步：粘贴这条命令并回车（把下面的整行一起复制）：
    python3 "$(dirname "$0")/scripts/_setup.py"
    ※ 如果提示 "command not found: python3"，说明你没装 Python。
      Mac 自带 Python，但如果你删掉了，去 python.org 免费下载安装。

  第三步：等它跑完
    终端会显示下载进度，自动装好所有组件 + 预下载语音模型
    （约 560MB，只下这一次，以后离线可用），要几分钟。
    看到「安装完成」就 OK 了。

【Windows 用户】—— 打开「命令提示符」，复制粘贴一条命令

  第一步：打开命令提示符
    按 Win 键，输入"cmd"，回车打开黑色窗口。

  第二步：先用 cd 命令进入解压目录
    例如你解压到了 D:\抖音口播工作流，就输入：
      cd /d D:\抖音口播工作流
    然后回车。

  第三步：粘贴这条命令并回车：
    py -3 scripts\_setup.py
    ※ 如果提示 "'py' 不是内部或外部命令"，说明你没装 Python 或
      没勾选 "Add to PATH"。去 python.org 免费下载安装，安装时
      务必勾选「Add Python to PATH」。需要 3.9 或更高版本。
    ※ 如果 py -3 不行，试试换成：python scripts\_setup.py

  第四步：等它跑完
    窗口会显示进度，自动装好组件 + 预下载模型（约 560MB）。
    看到「安装完成」后可以关掉窗口。

  ⚠️ 下载模型这一步如果中途断网也没关系：第一次真正用的时候会
     自动再补下载，不影响安装。

----------------------------------------------------------------
三、怎么用（把抖音链接发给你的 AI 助手）
----------------------------------------------------------------
装好之后，你不需要自己敲命令。直接在 WorkBuddy（或任何装了
这个技能的 AI 助手）里，把抖音链接发过去，说一句：

    "用抖音口播工作流处理这个链接：<粘贴你的抖音链接>"

AI 会自动帮你：下载视频 → 提取口播声音 → 识别成逐字稿，
最后把三个文件交给你：
    · 视频.mp4          （下载好的视频）
    · 口播.mp3          （提取出来的人声，单声道）
    · 口播逐字稿.txt    （视频里人说的话，已经自动加好标点、断好行）

如果你想处理自己电脑上的视频文件（最稳、完全不联网），就发：
    "我本地有个视频 /Users/me/Downloads/xxx.mp4，直接给我口播稿"
（Windows 上把路径换成 D:\videos\xxx.mp4 这种写法即可）

----------------------------------------------------------------
四、关于「免费」和「国内平台」的说明
----------------------------------------------------------------
  1. 抖音视频解析：默认走抖音官方分享页，免费、免注册、免密钥，
     比网上那些第三方免费接口稳定得多。
  2. 语音识别：在你自己电脑上离线完成，用的是开源模型
     whisper.cpp（约 487MB）加中文标点模型（约 76MB）。这两个模型
     只在国内的镜像站点下载（hf-mirror.com、清华 PyPI 镜像），
     速度很快，不用翻墙。
  3. 万一你电脑识别偶尔抽风：可以配一个国内免费语音平台，
     二选一均可：
     · 硅基流动 cloud.siliconflow.cn（注册送免费额度，
       语音模型 FunAudioLLM/SenseVoiceSmall 免费）
     · 智谱 open.bigmodel.cn（有免费额度，
       语音模型 glm-asr-2512 免费）
     把密钥填到环境变量里即可。绝大多数情况用不到。

----------------------------------------------------------------
五、最常见问题（照着做就行）
----------------------------------------------------------------
问：Mac 终端提示 "command not found: python3"？
答：Mac 一般自带 Python。如果没有，去 python.org 免费下载安装
    一个 Python 3.9+ 版本即可。Mac 用户也可以用 Homebrew 装：
    brew install python@3.12

问：Windows 提示 "'py' 不是内部或外部命令"？
答：你没装 Python，或者装了但没勾选 "Add Python to PATH"。
    去 python.org 下载安装，安装时务必勾选那个选项。
    装完后**重新打开一个新的 cmd 窗口**再试上面的命令。

问：提示「缺少 Python 依赖」？
答：重新运行一次上面的安装命令，让它再装一次组件。

问：链接解析失败、提示「自动解析失败」？
答：这不是 bug。抖音有些视频设为私密或已删除，免密钥通道拿不到。
    最稳的办法：把视频保存到手机/电脑，用上面「本地视频」方式发给
    AI。只要拿到视频文件，口播环节 100% 离线可用。

问：识别出来的稿子没有标点符号？
答：第一次用时标点模型还没下载完。联网一次让脚本自动补下，或重跑一次。

问：Mac 和 Windows 都能用吗？
答：能。两个系统都实测通过。Windows 中文版容易乱码的问题已经修掉。

----------------------------------------------------------------
六、一句话总结
----------------------------------------------------------------
免费、免注册、免密钥，Mac / Windows 都能用。
终端贴一条命令装好 → 把抖音链接丢给 AI
→ 拿到 视频 + 声音 + 逐字稿。
================================================================
