常见问题 — SaveXTube

产品与选型

不确定装哪一个？先看这三条。

SaveXTube Desktop、Server、Client 有什么区别？

三个形态共享同一套下载能力，区别在于「装在哪、由谁执行任务」：

SaveXTube Desktop：装在 Mac 与 Windows 上的本地工具。下载、语音转写与 AI 整理都在本机完成，文件直接落进这台电脑的磁盘。

SaveXTube Server：常驻在 NAS 或服务器上的下载中心。手机、电脑、微信与 Telegram 把链接交给它，任务由设备自己完成，媒体落进共享存储，Web 仪表盘随时查看进度。

SaveXTube Client：手机与平板上的随身入口。只负责发起任务和查看进度，本身不做下载，也不占用手机存储。

Client 需要配合哪个产品使用？能直接连 Desktop 吗？

Client 必须配合 SaveXTube Server 使用，不支持连接 SaveXTube Desktop。下载与存储都由 Server 负责，Client 只负责在手机上发起任务、查看进度，所以使用前需要先部署好一台 Server。

如果你只有一台电脑、没有常驻设备，用 Desktop 就够了；想在手机上远程丢链接进来，也可以用 Desktop 的微信遥控器、Telegram Bot 或 HTTP API，不必安装 Client。

三个产品我该装哪些？

只有一台 Mac 或 Windows：装 Desktop 即可，本机下载、转录、整理一条龙。

有 NAS 或长期开机的服务器：装 Server，让设备自己下载，媒体直接进共享存储。

想在手机上随手发起下载：Server 加 Client 的组合——Server 干活，Client 当入口。

三者可以并存：Desktop 管你面前的电脑，Server 管常驻设备，Client 负责手机上的入口。

通用问题

平台支持、画质、联网与授权，三个产品共通。

SaveXTube 支持哪些平台？

支持 YouTube、X、抖音、小红书、哔哩哔哩、微信视频号、Instagram、Facebook、Telegram 及更多 yt-dlp 与 gallery-dl 覆盖的平台。平台规则变化时，实际可用性可能发生变化。

SaveXTube 支持哪些图片网站？

目前支持保存站酷（ZCOOL）作品、小红书（Xiaohongshu）图文笔记、Instagram 图集、Telegraph 页面和 X 帖子中的图片；多图内容会在源站提供文件时批量下载。登录后可见、私密或受限内容可能需要先配置对应平台的 Cookies。平台页面或接口发生变化时，实际可用性可能暂时受到影响。

为什么微博视频不能下载无水印版本？

部分微博视频的水印是在微博服务端转码或分发时直接写入视频画面的。SaveXTube 下载的是微博实际提供的 MP4 或 M3U8 媒体流，因此无法从已经硬编码水印的版本中还原无水印视频；是否有无水印源取决于微博是否提供作者原始文件或其他未加水印的媒体版本。

如何下载 Telegram 视频？

下载 Telegram 频道、群组或私聊中的视频，需要先建立 Telegram 用户会话。打开 Telegram 官方的 API development tools，使用自己的 Telegram 手机号登录，创建一个应用，然后复制页面中的 API ID 和 API Hash。

在 SaveXTube 中打开「设置 → Cookies → Telegram」，填写 API ID、API Hash 和手机号，点击“发送验证码”；输入 Telegram 中收到的验证码。如果账号启用了两步验证，还需要填写 2FA 密码。验证成功后，把 https://t.me/... 格式的消息链接粘贴到 SaveXTube 即可下载。下载私密频道或群组内容时，该 Telegram 账号必须已加入并拥有访问权限。

Bot Token 只用于 Telegram Bot 远程控制，不能替代 API ID、API Hash 和用户会话。API Hash 与生成的 Session 都属于敏感凭据，请仅保存在自己的电脑上，不要发送给他人。

如何下载微信视频号视频？

SaveXTube 通过腾讯元宝的解析能力获取微信视频号的可下载地址，因此需要有效的腾讯元宝 Web Cookies。先在 Chrome 或 Edge 中打开并登录腾讯元宝，再使用 Get cookies.txt LOCALLY 扩展导出 Netscape 格式的 Cookies。然后打开 SaveXTube 的「设置 → Cookies」，选择「视频号」，粘贴 Cookies 并保存；之后即可粘贴微信视频号分享链接开始下载。Cookies 只需保存在本机，请勿发送给他人。

是否支持 4K 或更高画质？

可用的清晰度与格式取决于源站点，且受登录状态（Cookie）影响——部分平台在登录后才开放更高画质或特定格式。在站点提供对应选项的前提下，SaveXTube 能自动选择最佳视频与音频流进行合并。

需要联网才能使用吗？

下载和调用在线 AI 服务时需要联网；已下载文件的管理、本地转录与部分整理能力可离线运行。

下载的视频可以商用吗？

请仅下载你有权访问和保存的内容，并遵守内容版权、平台条款与当地法律。

遇到问题可以在哪里求助？

先在本页搜索关键词，大多数安装、平台与 Cookies 问题都能找到说明。没找到答案时，欢迎加入官方 QQ 交流群（群号 908769885，也可以扫码加入）：群里既有 Mac / Windows 桌面端用户，也有把 SaveXTube Server 跑在 NAS 上的自托管玩家，通常几分钟就有人回。

提问时请附上系统版本、SaveXTube 版本、要做的事与具体报错信息（截图或日志更好），能明显加快定位速度。涉及 API Key、Cookies、Telegram Session 等敏感信息时请先打码。

购买授权后可以在多台电脑上使用吗？

可以。每份个人授权最多可在 3 台个人电脑上激活使用，方便你在常用设备间使用 SaveXTube。

Desktop 桌面端

Mac 与 Windows 桌面版的安装、故障与本地功能。

macOS 提示“Apple 无法验证 SaveXTube Desktop”怎么办？

这是 macOS Gatekeeper 的安全提示。当前官网安装包使用临时签名，尚未完成 Apple 开发者公证；从浏览器下载后，文件还会带有隔离标记，因此系统无法确认开发者与公证状态。该提示表示“Apple 无法验证”，并不代表 macOS 已经检测到恶意软件。请仅对从 SaveXTube 官网下载的应用执行以下操作。

方法一：macOS Assistant（macOS 小助手）
在你信任的 macOS 小助手中选择“绕过签名”，仅选择 SaveXTube Desktop.app 进行处理。不要全局关闭 Gatekeeper。

方法二：终端命令
先将应用拖入“应用程序”文件夹，再打开“终端”并执行：

sudo xattr -rd com.apple.quarantine "/Applications/SaveXTube Desktop.app"

输入 Mac 登录密码后重新打开应用。输入密码时终端不会显示字符，这是正常现象。

Windows 安装后提示“无法定位程序输入点 PowerUnregisterFromEffectivePowerModeNotifications”怎么办？

这通常不是安装包损坏，而是 Windows 版本低于当前客户端要求。SaveXTube 使用的 WinUI 3 / Windows App SDK 最低支持 Windows 10 1809（OS Build 17763）；更早版本缺少该运行时所需的系统 API。请在 PowerShell 或“运行”窗口中输入 winver 查看版本和 OS 内部版本，确认系统至少为 Windows 10 1809 / Build 17763。若版本更低，请先通过 Windows 更新升级，建议升级到 Windows 10 22H2 或 Windows 11。

悬浮下载球、DIY 皮肤和 Codex 宠物怎么使用？

在 SaveXTube 的「设置 → 悬浮下载」中，可以选择默认下载球或 Codex 宠物作为桌面下载入口：把浏览器链接直接拖到悬浮入口即可下载；复制 URL 后点击右键也能立即创建任务，左键单击则会打开主窗口。想更换应用外观，可以从 SaveXTube Skins 获取社区皮肤；想亲手设计专属皮肤，可使用 SaveXTube Skin Builder Skill；想制作自己的桌面宠物，则可使用 Codex Pet Builder Skill。SaveXTube 还支持从 codex-pet.org 页面链接或 ZIP 安装宠物，并会以只读方式发现本机 Codex 已安装的宠物。以上皮肤、Skill 与宠物目录均为社区资源；codex-pet.org 并非 OpenAI 官方服务，SaveXTube 不预装或重新分发其中的第三方宠物。

字幕和转录准确吗？

转录准确度主要取决于所选模型的能力。SaveXTube 同时支持本地模型与云端模型：本地模型完全离线、隐私更安心；云端模型通常在复杂场景下准确度更高。你可以根据实际需求灵活切换。

如何把视频或音频转成文字？

先打开 SaveXTube 的「设置 → 大模型 → 语音转写」，选择本地 MLX / Whisper、阿里云百炼或 OpenAI 兼容服务；使用本地引擎时按提示安装并检查模型，使用云端服务时填写 API Key、模型等信息并保存。然后进入「文件」页，找到已下载的视频或音频，点击转写按钮或在右键菜单中选择「开始转写 / 语音转写」。完成后可在「智能解析」中查看完整原文，并按需另存为 Markdown 文本。

如何生成 AI 总结？

AI 总结需要先完成该视频或音频的语音转写。接着在「设置 → 大模型 → 语言模型」中配置并测试可用的 LLM，可选择 OpenAI、DeepSeek、通义千问、Ollama 本地模型或其他兼容服务。回到「文件」页，右键对应文件选择「生成 AI 总结」，也可以先打开「智能解析」再点击生成。总结完成后会保存在智能解析结果中，并可导出为 Markdown；使用云端 LLM 时，转写文本会发送给所选服务商处理。

如何制作视频内容的思维导图？

思维导图同样需要已有转写文本和可用的语言模型配置。完成转写并在「设置 → 大模型 → 语言模型」中保存、测试 LLM 后，进入「文件」页，右键对应文件选择「生成思维导图」，或在「智能解析」窗口中点击生成。SaveXTube 会把转写内容整理为层级结构，生成后可以直接预览并保存为 XMind 文件；在支持的版本中还可缩放查看或导出 JPG 图片。

如何配置 MCP，让 AI Agent 操作 SaveXTube？

打开 SaveXTube 的「设置 → 远程控制」，开启 MCP 服务；HTTP API 会同时自动开启。点击「复制 Agent 配置」，将复制的 JSON 粘贴到支持远程 HTTP MCP 的 AI Agent 配置中，然后重启或刷新 Agent。配置已包含 MCP 端点和 Bearer API Key，连接成功后即可让 Agent 提交下载链接、查询进度和读取最近任务。默认端点仅供本机访问；如需从另一台设备连接，请只在可信局域网或 Tailscale 等安全网络中开启局域网访问，切勿公开端口或泄露 API Key。

远程下载

手机、微信、Telegram 把链接交给 SaveXTube，Desktop 与 Server 都支持。

如何通过微信下载？

在 SaveXTube 中打开微信机器人，用手机微信扫描二维码并确认登录。绑定成功后，把支持的链接发送到微信即可；需要确保电脑上的 SaveXTube 正在运行。

微信回传文件有什么限制？

单个回传文件不要超过 1GB。视频和文件均限制为每 30 秒最多回传一次，请勿在 30 秒内连续回传多个内容。大文件或批量文件建议分批处理；如果回传失败，请稍后重试，或改用本地下载。

如何使用 iPhone 或 iPad 快捷指令下载？

先在 SaveXTube 的「设置 → 远程控制」中开启 HTTP API；手机连接时还需开启「允许局域网访问」，并记下电脑的访问地址、端口和 API Key。随后安装 SaveXTube 快捷指令，按提示填入这些信息。使用时可在手机浏览器或其他 App 的分享菜单中选择该快捷指令，也可复制视频链接后直接运行；电脑上的 SaveXTube 必须保持运行。手机与电脑应处于同一可信网络，外出使用建议通过 Tailscale 等安全网络连接，不要将 HTTP API 端口直接暴露到公网。

Telegram 远程下载支持哪些操作？

配置 Bot Token 和允许使用的 Telegram 用户后，可以发送单个或批量链接、查询运行状态、查看实时下载进度，并按设置将完成的文件回传 Telegram。

Cookies 与登录态

需要登录才能看到的内容，靠 Cookies 拿到完整画质。

如何获取并填写平台 Cookies？

推荐安装 Chrome / Edge 扩展 Get cookies.txt LOCALLY。打开需要下载内容的平台并完成登录，点击浏览器工具栏中的扩展图标，确认 Export Format 为 Netscape，再点击 Copy。随后在 SaveXTube 中打开「设置 → Cookies」，选择对应平台，将复制的内容粘贴到 Cookies 编辑框并保存。Cookies 可代表你的登录状态，请像密码一样妥善保管，切勿分享给他人。

为什么配置 Cookies 一段时间后又无法下载？

Cookies 是各平台用于识别登录状态的临时凭证，都有自己的有效期，也可能因退出登录、修改密码或平台安全策略而提前失效，SaveXTube 无法延长其有效期。如果之前可以下载、后来提示登录或解析失败，请先在浏览器中重新登录对应平台（微信视频号需重新登录腾讯元宝），再重新导出最新的 Netscape 格式 Cookies，覆盖 SaveXTube 中该平台的旧 Cookies 并保存后重试。