Skip to content

FAQ

Jump to bottom
SpaceSquare640 edited this page Jul 23, 2026 · 5 revisions

FAQ

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

English

Known issues

  • Desktop app freezing / "Not Responding" — fixed in v4.1.1. Long-running downloads, conversions, batch queues, or AI planning could block the window's main thread and trigger the OS's "Not Responding" state. Fixed by moving that work to a background thread; if you're still on v4.1.0 or older, update.
  • Language dropdown showing raw codes — fixed in v4.2.1. In v4.2.0 the language dropdown could show en/zh_tw/zh_cn instead of the language names if a background lookup hiccupped (#4). Fixed by reading the names from a static, build-time source instead.
  • AI Assistant runtime error — fixed in v4.1. In the v4.0.0 build the AI Assistant panel errored when invoked, because two of its OpenRouter model slugs had been delisted upstream. v4.1 swaps them for current free models and the AI Assistant works again. (The other tabs — Video/Music Download, Format Conversion, Run Log — were always fine.)
  • Installers aren't code-signed. All three platforms are built and published via CI — Windows (.exe/.msi), macOS (.dmg, Apple Silicon), Linux (.deb/.rpm/.AppImage) — see the latest release. They're unsigned, so Windows SmartScreen or macOS Gatekeeper may warn on first launch (Windows: "More info → Run anyway"; macOS: right-click → Open).

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.

Why is the README only in English now?

Starting with the release after v4.2.2, the main repo's documentation (README.md, CHANGELOG.md, GitHub Release notes) moved to English-only. This wiki keeps full English / 繁體中文 / 简体中文 documentation, and the app's own UI is unaffected — it stays switchable between all three languages at any time.

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.

繁體中文

已知問題

  • 桌面版容易凍結／顯示「沒有回應」——已在 v4.1.1 修復。 長時間的下載、轉換、批次佇列或 AI 規劃可能卡住視窗的主執行緒，觸發作業系統的「沒有回應」狀態。已改到背景執行緒處理；若你還在用 v4.1.0 或更早版本，請更新。
  • 語言下拉選單顯示原始代碼——已在 v4.2.1 修復。 v4.2.0 版本中，若背景查詢出狀況，語言下拉選單可能顯示 en／zh_tw／zh_cn 而非語言名稱（#4）。已改成直接讀取建置時期就固定好的名稱來源，修復此問題。
  • AI 助手運行時錯誤——已在 v4.1 修復。 v4.0.0 版本中 AI 助手面板一執行就會出錯，原因是它的兩個 OpenRouter 模型 slug 被上游下架。v4.1 已換成現行免費模型，AI 助手恢復正常。（其餘分頁——影片/音樂下載、格式轉換、運行日誌——一直都正常。）
  • 安裝檔未經程式碼簽章。 三平台皆由 CI 建置並發布——Windows（.exe/.msi）、macOS（.dmg，Apple Silicon）、Linux（.deb/.rpm/.AppImage），見 最新 Release。因未簽章，首次啟動時 Windows SmartScreen 或 macOS Gatekeeper 可能跳警告（Windows：「其他資訊 → 仍要執行」；macOS：右鍵 → 打開）。

授權說明

  • 本專案自身程式碼（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 版本，以及（如相關）運行日誌分頁的輸出內容。

為什麼 README 現在只有英文？

從 v4.2.2 之後的下一個版本開始，主 repo 的文件（README.md、CHANGELOG.md、GitHub Release 說明）改為僅提供英文。這個 wiki 仍維持完整的英文／繁體中文／简体中文文件，App 本身的介面也不受影響，隨時可以在三語之間切換。

免責聲明

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

简体中文

已知问题

  • 桌面版容易冻结／显示「未响应」——已在 v4.1.1 修复。 长时间的下载、转换、批次队列或 AI 规划可能卡住窗口的主线程，触发操作系统的「未响应」状态。已改到后台线程处理；若你还在用 v4.1.0 或更早版本，请更新。
  • 语言下拉菜单显示原始代码——已在 v4.2.1 修复。 v4.2.0 版本中，若后台查询出状况，语言下拉菜单可能显示 en／zh_tw／zh_cn 而非语言名称（#4）。已改成直接读取构建时就固定好的名称来源，修复此问题。
  • AI 助手运行时错误——已在 v4.1 修复。 v4.0.0 版本中 AI 助手面板一运行就会出错，原因是它的两个 OpenRouter 模型 slug 被上游下架。v4.1 已换成现行免费模型，AI 助手恢复正常。（其余标签页——视频/音乐下载、格式转换、运行日志——一直都正常。）
  • 安装包未经代码签名。 三平台均由 CI 构建并发布——Windows（.exe/.msi）、macOS（.dmg，Apple Silicon）、Linux（.deb/.rpm/.AppImage），见 最新 Release。因未签名，首次启动时 Windows SmartScreen 或 macOS Gatekeeper 可能弹警告（Windows：「更多信息 → 仍要运行」；macOS：右键 → 打开）。

许可证说明

  • 本项目自身代码（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 版本，以及（如相关）运行日志标签页的输出内容。

为什么 README 现在只有英文？

从 v4.2.2 之后的下一个版本开始，主 repo 的文档（README.md、CHANGELOG.md、GitHub Release 说明）改为仅提供英文。这个 wiki 仍维持完整的英文／繁體中文／简体中文文档，App 本身的界面也不受影响，随时可以在三语之间切换。

免责声明

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

Clone this wiki locally