东哥视频文案提取工具 · 使用说明书
1能做什么
| 场景 | 怎么做 |
|---|---|
| 刷到干货视频，想把口播存成文字 | 复制分享链接 → 粘贴 → 开始处理 |
| 批量整理某博主的多条视频文案 | 一次粘贴多条链接（每行一条），自动排队并发 |
| 视频号 / 本地录音 / 网课录屏转文字 | 用「上传本地音/视频文件」入口，拖进来即可 |
| 小红书 / 抖音的图文笔记存正文和图片 | 同样粘贴链接，自动识别图文并保存文字 + 图片 |
| 想要一份错别字修正过的干净稿 | 设置里填一个 DeepSeek API Key（可选），自动 AI 校对 |
核心特点
- 完全本地转写：语音识别在你自己电脑上跑（OpenAI Whisper 模型），不限次数、不花钱、内容不外传。
- 多平台：抖音（视频+图文）、哔哩哔哩、小红书（视频+图文）、YouTube、X；其它来源可用本地上传兜底。
- 有显卡就飞快：NVIDIA 显卡用户可在设置里一键开启 GPU 加速，转写速度提升数倍。
- 顺手的小功能：任务历史可搜索（含转写正文）、一键打开产物文件夹、深色 / 炫彩主题、批量并发、失败重试。
2系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11（64 位），安装器会自动拒绝更老的系统；或 macOS（Apple 芯片，M 系列，测试版） |
| 磁盘空间 | 程序本体约 1GB；首次使用需下载语音模型（0.07~3GB，按需选择） |
| 内存 | 建议 8GB 以上（用 large 系列模型时建议 16GB） |
| 显卡 | 可选。无独立显卡用 CPU 也能跑；有 NVIDIA 显卡（GTX 10 系及更新、驱动 ≥527.41）可开 GPU 加速 |
| 网络 | 下载视频和首次下载模型时需要；转写本身不需要联网 |
3下载与安装
- 从下载页下载
东哥视频文案提取工具-安装包-v0.1.0.exe（约 129 MB）。 - 如果出现蓝色的「Windows 已保护你的电脑」提示：这是因为软件没有购买微软的商业签名证书，属于正常现象，点「更多信息」→「仍要运行」即可。
- 跟着中文安装向导走：不需要管理员权限，默认装到当前用户目录；可勾选创建桌面快捷方式。
- 如果你的电脑缺少微软 WebView2 运行时（Win11 自带，少数老 Win10 没有），安装器会自动帮你补装，多等约 1 分钟。
- 安装完成后，桌面双击「东哥视频文案提取工具」图标即可打开。
安装向导每一页左下角都有「东哥AI日记官网」链接，需要邀请码或想了解更多可以随时点击访问。
升级：直接下载新版安装包覆盖安装即可。安装器会自动检测到已装的旧版本并提示升级，旧版无需手动卸载，历史记录和设置都会保留。
卸载：开始菜单 →「卸载 东哥视频文案提取工具」。卸载不会删除你已提取的文案和历史记录（它们在 用户目录\VideoExtractor 里，想彻底清除可手动删除该文件夹）。
4快速上手：三步提取第一条文案
第 0 步（仅首次）：打开软件 →「设置」→「本地 Whisper 语音模型」→ 点推荐模型旁的「下载」按钮，等进度条走完（怎么选模型见 7.4）。首次打开时提取页顶部也会有一条引导横幅提醒你先下模型。
- 复制链接：在抖音等 App 里点「分享」→「复制链接」。整段分享文案直接粘贴也行，软件会自己把链接抠出来。
- 粘贴 → 开始处理：回到软件首页，粘贴到大输入框（多条链接就一行一条），点「▶ 开始处理」。
- 等结果：任务卡片会实时显示进度（解析 → 下载 → 转写 → 完成）。完成后点「查看」看文案，或点「打开文件夹」直接找到视频、音频和文字文件。
提取页「导出」选项下方有一行「📂 保存到：…」，直接显示当前文件产物的存放位置，点「更换位置」即可改并立即生效。
5界面总览
- 顶部：左边是工具名 + 「东哥AI日记 出品」标识；右边从左到右是「🌐 官网 dzai.link」按钮、☀️白天 / 🌙夜间 / 🌈炫彩 三个主题按钮、「使用说明」、版本号。
- 支持平台栏：五个平台图标，点击可在浏览器打开对应官网。
- 三个标签页：提取（主工作区：粘贴链接 / 上传文件 / 任务进度 / 保存位置）、历史（所有任务，可按标题/作者/正文内容搜索、查看、重试、删除、打开文件夹）、设置（模型、GPU、Cookie、AI 校对、导出目录等）。
6支持的平台与内容
| 平台 | 视频 | 图文 | 备注 |
|---|---|---|---|
| 抖音 | ✅ | ✅ | 支持短链/分享文案；下载无水印版本 |
| 哔哩哔哩 | ✅ | 无 | 720P 及以上需在设置里填 B站 Cookie（B站官方限制） |
| 小红书 | ✅ | ✅ | 图文笔记保存正文文字 + 所有图片 |
| YouTube | ✅ | 无 | 网络需要能访问 YouTube |
| X（Twitter） | ✅ | ✅ | 需在设置里填 X 的 Cookie（平台限制） |
| 微信视频号 | ⚠️ 不支持直接解析 | 无 | 视频号有强加密，业内无稳定方案；变通：用录屏/下载工具拿到视频文件后走「上传本地文件」 |
| 其它任何来源 | ✅（经上传） | 无 | 只要有音/视频文件，都能上传转写 |
7功能详解
7.1 链接提取
- 多链接批量：一行一条，一次可贴多条；默认同时处理 2 条，其余排队（并发数可在设置改，改后需重启）。
- 失败互不影响：某条链接失效不影响其它任务，失败的在历史里可一键「重试」。
- 导出内容三档（勾选框）：只要视频（当下载器用）/ 视频+音频（额外导出 mp3）/ 视频+音频+转写文案（默认全勾，完整流程）。
7.2 上传本地文件转写
首页第二张卡片，点击选择或直接把文件拖进虚线框：
- 支持 mp4 / mov / mkv / webm / mp3 / m4a / wav 等常见格式，单文件上限 4GB。
- 用你在上方选好的引擎/模型转写；只产出文字，不重复保存视频。
- 典型用途：视频号内容、会议录音、网课、播客。
7.3 ASR 引擎：本地 Whisper vs 云端火山引擎
| 本地 Whisper（默认推荐） | 火山引擎（可选） | |
|---|---|---|
| 费用 | 免费无限量 | 按时长计费（需自开火山账号） |
| 隐私 | 内容不出你的电脑 | 音频会上传到火山云 |
| 速度 | 取决于电脑（GPU 很快，CPU 较慢） | 稳定，和本机性能无关 |
| 适合 | 绝大多数人 | 电脑配置很低又需大量转写的人 |
不折腾云服务的话，保持默认的本地 Whisper 就好。
7.4 模型怎么选（重要）
Whisper 模型越大越准、越慢、越占空间。在「设置 → 本地 Whisper 语音模型」下载，界面会根据你的电脑自动打「推荐」角标：
| 模型 | 大小 | 准确率 | 建议 |
|---|---|---|---|
| tiny | ~75MB | 一般 | 只用来快速尝鲜 |
| small | ~480MB | 中等 | 无显卡（CPU）用户推荐 |
| medium | ~1.5GB | 好 | CPU 也能跑，但较慢 |
| large-v3 | ~3GB | 最准 | 建议 GPU 用户使用 |
| large-v3-turbo | ~1.6GB | ≈large-v3 | GPU 用户首选：准确率接近 large-v3，速度快数倍 |
- 下载源：默认「自动」（检测到代理走官方，否则走国内镜像），下载慢可手动切换试试。
- 提前下载：建议先把要用的模型下好（有进度条），别等提交任务时才现下。
- 语言：自动检测，中文、英文、日语等都支持；中文结果自动繁转简。
7.5 速度模式
- 并行·快速（默认推荐）：批量并行推理，快数倍，时间戳稍粗。
- 顺序·精确：逐句处理，慢，但每句时间戳更精确，需要拿时间轴做字幕的人用。
7.6 历史记录
- 支持按标题 / 作者 / 正文内容搜索（正文也在搜索范围，方便找「记得说过某句话的那条视频」）。
- 每条记录：「查看」看全文并可复制；「打开文件夹」直达产物目录；失败的显示「重试」；「删除」移除记录（已导出文件不动）。
7.7 AI 文案校对（DeepSeek，可选）
转写出来的文字偶尔有错别字。在「设置 → LLM 文案校对」填一个 DeepSeek API Key 后，每条任务转写完会自动多做一步 AI 校对，额外产出一份干净稿（transcript_clean.txt）。
- Key 在
platform.deepseek.com注册即可创建，新用户一般有试用额度；之后按用量计费，一条几分到几角钱。 - 留空则完全跳过此步，不影响其它功能。
7.8 Cookie 什么时候需要填？
大部分场景不需要。以下情况才要（设置页对应位置都有 📘 图文教程）：
| 平台 | 什么时候需要 |
|---|---|
| B站 | 想要 720P 及以上清晰度时（B站要求登录） |
| X（Twitter） | 全部内容都需要（平台限制） |
| 抖音 / 小红书 | 一般不用；偶尔风控严格时填上可提高成功率 |
7.9 导出目录
默认存到 用户目录\VideoExtractor\downloads，按日期自动归档。提取页「保存到」那一行或「设置 → 导出目录」都能改成任意文件夹（比如某个网盘同步目录）。
7.10 主题与退出
- 三个主题即点即换，记住你的选择。
- 关窗口时会弹确认；如果还有任务在跑会红字警告，确认退出则中断任务（记录保留，重开后可重试）。
8GPU 性能加速
这是无显卡也能用、有显卡则强烈建议开启的功能。软件默认用 CPU 转写（人人可用）。如果你的电脑有 NVIDIA 显卡，打开「设置 → ⚡性能加速（GPU）」：
- 软件自动检测你的显卡型号、显存和驱动版本；
- 检测通过会出现「一键下载并启用 GPU 加速」按钮，点它自动从官方源下载 CUDA 运行库（约 530MB，带进度条，失败自动换国内镜像重试）；
- 下载完重启软件，横幅变绿「GPU 加速已生效」，转写速度即提升数倍；
- 之后模型列表的「推荐」角标会自动指向 large-v3-turbo（GPU 下又快又准）。
- 仅支持 NVIDIA 显卡（GTX 10 系及更新；需驱动版本 ≥527.41，过旧会提示先升级驱动）。AMD / Intel 核显不支持加速，继续用 CPU 即可。
- 驱动太旧的常见表现：软件会显示「检测到 XX 显卡，但驱动过旧」，而「一键下载」按钮不出现，去 NVIDIA 官网更新驱动后即恢复。
- 加速包只需下载一次，存在数据目录，升级软件不用重下。
- 提取页顶部若出现橙色「检测到 NVIDIA 显卡」提示条，点「去开启」即可跳到这里。
9产物文件说明
每条任务在 导出目录\{月}月{日}日\{日期_作者_标题}\ 下生成：
7月18日/
└── 20260718_效率研究所_3个让效率翻倍的小习惯/
├── video.mp4 视频原片（抖音为无水印版）
├── audio.mp3 提取的音频
├── transcript.md 转写文案（带作者/标题/数据等信息头）
├── transcript_clean.txt AI 校对后的干净稿（配了 DeepSeek 才有）
├── meta.json 元数据（链接、发布时间、点赞数等）
└── images/ 图文笔记的所有图片（仅图文类内容）- 文件夹名自动清理特殊字符和表情，兼容 Windows 命名规则。
- 在任务卡片或历史页点「打开文件夹」直接跳到对应目录。
10常见问题 FAQ
Q：安装时 Windows 弹蓝色警告「已保护你的电脑」？
正常现象（见第 3 节），点「更多信息 → 仍要运行」。原因是软件没买微软商业签名证书，不是有风险。
Q：杀毒软件报毒/隔离了程序？
PyInstaller 打包的 Python 程序偶尔被误报，添加信任/白名单即可。
Q：第一次转写等了很久没动静？
九成是模型还没下载。去「设置 → 本地 Whisper 语音模型」看下载状态；提取页顶部也有引导提示。
Q：模型下载特别慢或失败？
设置里把「下载源」切到「HF 镜像」；如果你挂了梯子，切到「官方」通常更快。
Q：CPU 转写太慢了？
① 换 small 模型；② 速度选「并行·快速」；③ 有 N 卡就开 GPU 加速（第 8 节），这是质变。
Q：有 NVIDIA 显卡但不弹「检测到显卡」提示 / 没有下载加速包的按钮？
最可能是显卡驱动太旧（需 ≥527.41）。去设置页「性能加速」看那行字：若显示「检测到 XX 显卡，但驱动过旧」→ 到 NVIDIA 官网升级驱动即可；若显示「未检测到 NVIDIA 独立显卡」→ 驱动没装好或是笔记本双显卡，同样先更新驱动。GTX 1650 这类较老的卡也完全支持加速，升级驱动后就正常了。
Q：抖音链接提示「短链已失效」？
分享短链有时效，回抖音重新复制一条最新的分享链接。
Q：B站只下到 480P？
720P 以上 B站要求登录，在「设置 → Cookie」按教程填入 B站 Cookie。
Q：某条任务失败了怎么办？
看任务卡片上的中文错误提示（都写明了原因和解法）；多数情况到「历史」里点「重试」即可。
Q：微信视频号的视频怎么弄？
视频号无法直接解析（全网皆然）。先用其它方式（PC 端录屏、第三方下载工具）拿到视频文件，再用「上传本地文件」转写。
Q：更新新版本要重新下模型吗？
不用。模型、历史记录、设置都在你的用户目录，覆盖安装全部保留；安装器还会自动识别旧版本并提示升级。
Q：文案是 100% 准确的吗？
不是。普通话清晰的视频准确率很高，专有名词、方言、背景音乐嘈杂时会出错。追求出版级准确请配合 DeepSeek 校对（7.7）并人工复核。
以上都解决不了？去下载页加东哥微信，把问题截图发过来，我帮你看。
11隐私与数据说明
- 转写全程本地：默认引擎（本地 Whisper）在你的电脑上运行，视频、音频、文字不上传到任何服务器。
- 联网行为只有三类：① 从视频平台下载你指定的内容；② 首次下载模型/GPU 加速包（HuggingFace/PyPI 官方或国内镜像）；③ 你主动配置的可选云服务（DeepSeek 校对 / 火山引擎转写）。
- 所有数据（配置、历史、产物）都在
用户目录\VideoExtractor，卸载软件不会删除；可随时整体备份或删除这个文件夹。 - 请在遵守各平台服务条款和著作权法的前提下使用，仅提取用于个人学习、研究或已获授权的内容。