Skip to content

FAQ

Jump to bottom
SpaceSquare640 edited this page Jul 10, 2026 · 1 revision

FAQ

Language / 語言 / 语言: English · 繁體中文 · 简体中文

English

Known issues

  • AI Assistant errors at runtime (v4.0.0). The other three tabs (Video Download, Music Download, Format Conversion, Run Log) are fully tested and working in the packaged installer. The AI Assistant panel currently throws an error when invoked from the packaged build. Since it's an optional, low-usage feature, the fix is scheduled for v4.1 rather than blocking the v4.0.0 release. Track progress on Roadmap.
  • Linux/macOS installers aren't built yet. Only Windows installers (NSIS .exe, MSI) are currently published. The app is cross-platform capable (Tauri + Python), but building/testing on those OSes hasn't happened yet.

Licensing

  • This project's own code (Rust shell, Svelte frontend, Python engine, i18n, etc.) is MIT licensed — see LICENSE.
  • Bundled ffmpeg is GPLv3 (built with --enable-gpl --enable-libx264 --enable-libx265, among other GPL-licensed components). The app invokes it as a separate subprocess — it isn't statically or dynamically linked into the app's own binary — so GPLv3 doesn't propagate to this project's own code. It does mean the ffmpeg binary itself carries GPLv3 obligations (full license text + a source-availability notice), which are included in THIRD-PARTY-NOTICES.md.
  • yt-dlp is used as a library dependency (Unlicense/public-domain-style license) — no copyleft implications.

Why does the AI Assistant need my own API key?

The AI Assistant is powered by OpenRouter, which routes requests to several different models. Rather than the app operator paying for and rate-limiting everyone's usage, you bring your own key — it's stored locally in the app and only ever sent to OpenRouter.

Is the AI Assistant safe to use? Can it delete my files?

The AI Assistant follows a strict plan → check → confirm → execute pipeline: a planner model drafts a plan, an executor model turns it into concrete actions, a deterministic (non-AI) safety guard checks those actions against an allowlist, and a checker model reviews the result — but nothing touches your filesystem until you explicitly click Confirm. You always see the plan before anything runs.

Where do I report a bug?

Open a GitHub Issue on this repo. Include your OS, the app version, and (if relevant) the Run Log tab's output.

Disclaimer

This tool is intended for downloading content you have the right to download (e.g. your own uploads, public-domain material, or content whose platform/creator permits it). Respect the terms of service of any site you use this with and applicable copyright law in your jurisdiction.

繁體中文

已知問題

  • AI 助手運行時會出錯（v4.0.0）。 其餘三個分頁（影片下載、音樂下載、格式轉換）及運行日誌，在封裝好的安裝檔中皆已完整測試並正常運作。AI 助手面板目前從封裝版執行時會拋出錯誤。由於這是選用、使用頻率較低的功能，修復排入 v4.1，不影響 v4.0.0 的發布。進度見 Roadmap。
  • 尚未建置 Linux/macOS 安裝檔。 目前只發布 Windows 安裝檔（NSIS .exe、MSI）。App 本身具跨平台能力（Tauri + Python），但尚未在這些系統上建置/測試。

授權說明

  • 本專案自身程式碼（Rust 外殼、Svelte 前端、Python 引擎、多語系等）採 MIT 授權——見 LICENSE。
  • 內建的 ffmpeg 為 GPLv3（以 --enable-gpl --enable-libx264 --enable-libx265 等 GPL 授權元件建置）。App 是以獨立子行程方式呼叫它——並未靜態或動態連結進 App 自身的執行檔——因此 GPLv3 不會擴散到本專案自身的程式碼。但這確實表示 ffmpeg 執行檔本身 帶有 GPLv3 義務（完整授權文字＋原始碼可取得性聲明），已收錄於 THIRD-PARTY-NOTICES.md。
  • yt-dlp 作為函式庫依賴使用（Unlicense/近似公有領域授權）——沒有 Copyleft 相關影響。

為什麼 AI 助手需要我自己的 API Key？

AI 助手由 OpenRouter 驅動，會將請求路由到多個不同模型。與其由 App 開發者統一付費並限制所有人的用量，不如由你自行提供 Key——僅存於本機 App 內，且只會傳送給 OpenRouter。

AI 助手安全嗎？會刪除我的檔案嗎？

AI 助手遵循嚴格的 規劃 → 檢查 → 確認 → 執行 流程：規劃模型起草計畫、執行模型轉成具體動作、一個確定性（非 AI）安全守門機制依白名單檢查這些動作、檢查模型審查結果——但在你明確按下「確認」之前，不會動到你的檔案系統。任何動作執行前你都會先看到完整計畫。

我要去哪裡回報問題？

到本 repo 開一個 GitHub Issue。請附上你的作業系統、App 版本，以及（如相關）運行日誌分頁的輸出內容。

免責聲明

本工具僅供下載你有權下載的內容使用（例如自己上傳的內容、公有領域素材，或平台/創作者允許下載的內容）。請遵守你所使用網站的服務條款，以及你所在地區適用的著作權法規。

简体中文

已知问题

  • AI 助手运行时会出错（v4.0.0）。 其余三个标签页（视频下载、音乐下载、格式转换）及运行日志，在打包好的安装包中均已完整测试并正常运作。AI 助手面板目前从打包版运行时会抛出错误。由于这是可选、使用频率较低的功能，修复排入 v4.1，不影响 v4.0.0 的发布。进度见 Roadmap。
  • 尚未构建 Linux/macOS 安装包。 目前只发布 Windows 安装包（NSIS .exe、MSI）。App 本身具备跨平台能力（Tauri + Python），但尚未在这些系统上构建/测试。

许可证说明

  • 本项目自身代码（Rust 外壳、Svelte 前端、Python 引擎、多语言等）采用 MIT 许可证——见 LICENSE。
  • 内置的 ffmpeg 为 GPLv3（以 --enable-gpl --enable-libx264 --enable-libx265 等 GPL 许可组件构建）。App 以独立子进程方式调用它——并未静态或动态链接进 App 自身的可执行文件——因此 GPLv3 不会扩散到本项目自身代码。但这确实意味着 ffmpeg 可执行文件本身 带有 GPLv3 义务（完整许可证文本＋源代码可获得性声明），已收录于 THIRD-PARTY-NOTICES.md。
  • yt-dlp 作为库依赖使用（Unlicense/近似公有领域许可证）——没有 Copyleft 相关影响。

为什么 AI 助手需要我自己的 API Key？

AI 助手由 OpenRouter 驱动，会将请求路由到多个不同模型。与其由 App 开发者统一付费并限制所有人的用量，不如由你自行提供 Key——仅保存于本机 App 内，且只会发送给 OpenRouter。

AI 助手安全吗？会删除我的文件吗？

AI 助手遵循严格的 规划 → 检查 → 确认 → 执行 流程：规划模型起草计划、执行模型转成具体动作、一个确定性（非 AI）安全守门机制依白名单检查这些动作、检查模型审查结果——但在你明确点击「确认」之前，不会动到你的文件系统。任何动作执行前你都会先看到完整计划。

我要去哪里反馈问题？

到本 repo 开一个 GitHub Issue。请附上你的操作系统、App 版本，以及（如相关）运行日志标签页的输出内容。

免责声明

本工具仅供下载你有权下载的内容使用（例如自己上传的内容、公有领域素材，或平台/创作者允许下载的内容）。请遵守你所使用网站的服务条款，以及你所在地区适用的版权法规。

Clone this wiki locally