Asdmir786/HalalDL

# HalalDL 基于 `yt-dlp` 的 Windows 本地优先媒体下载工具。 [官方网站](https://halaldl.vercel.app) • [下载最新版本](https://github.com/Asdmir786/HalalDL/releases/latest) • [报告 bug](https://github.com/Asdmir786/HalalDL/issues/new/choose) • [获取支持](./SUPPORT.md) • [阅读文档](./docs) ## 从这里开始 HalalDL 是一款基于 `yt-dlp` 的 Windows 本地优先媒体下载工具，具备预设、可见日志以及可选的工具管理功能。 - **适合大多数用户：** 下载最新版本并选择 `HalalDL-Full-...-setup.exe` - **适合高级用户：** 如果你想自行管理 `yt-dlp`、`ffmpeg` 和可选工具，请选择 `HalalDL-Lite-...-setup.exe` - **适合免安装使用：** 如果希望将应用、设置、存档、缩略图和托管工具集中保存在同一个文件夹中，请选择 `HalalDL-Portable-...zip` - **WinGet：** `winget install --id Asdmir786.HalalDL`（Lite/Portable 的包 ID 正在审核中） - **Scoop / Chocolatey：** 提交正在审核中 —— 一旦批准，安装命令将发布在这里 - **当前支持平台：** Windows 10 和 Windows 11，x64 - **请负责任地使用：** 仅下载你有权访问和保存的内容；遵守平台规则、版权法和当地法律 包管理器的更新可能会落后于 GitHub Releases，因此最新的 GitHub 发布版本依然是获取新版本的最快途径。 ## 为什么人们选择尝试 HalalDL - **本地优先：** 无需账号，无追踪，不依赖云端 - **新手友好：** 粘贴 URL，选择预设，即可开始 - **快速剪贴板流程：** 托盘快速下载和自动粘贴让重复下载更加流畅 - **透明可见：** 原始日志保持可见，而不是隐藏在模糊的进度提示背后 - **灵活多变：** Full、Lite 和 Portable 构建版本让你在便捷性、可控性和免安装之间自由选择 ## 为什么开发这个项目 HalalDL 之所以存在，是因为许多 Windows 用户希望利用 `yt-dlp` 的强大功能，而不想面对终端窗口或四处寻找零散的设置步骤。 该项目致力于保留 CLI 生态系统的核心优势，同时让日常工作流更加清晰： - 合理的预设 - 可见的日志 - 一目了然的安装选项 - 无需账号系统或遥测层 ## 截图 粘贴 URL。选择预设。查看进度和日志。从历史记录中重新打开已完成的文件。       暗黑模式、安装信任、性能以及更多截图位于 [`docs/assets/screenshots/`](./docs/assets/screenshots/)。 ## 下载流程 1. 粘贴视频或播放列表 URL。 2. 选择预设或保持默认。 3. 选择加入队列或立即开始。 4. 实时查看进度和原始日志。 5. 在历史记录中查找已完成的文件和过往活动。 ## 我应该下载哪个版本？ 对于大多数人来说，建议从 **Full setup EXE** 开始。 | 构建版本 | 适合人群 | 包含工具 | 备注 | | --- | --- | --- | --- | | **Full setup EXE** | 大多数用户 | 是的，由应用托管 | 推荐的首选安装方式 | | **Full MSI** | 包管理/手动部署 | 是的，由应用托管 | 适用于偏好 MSI 包的情况 | | **Lite setup EXE** | 高级用户 | 否 | 使用你自己的 `yt-dlp`、`ffmpeg`、`aria2` 和可选的 Deno runtime | | **Lite MSI** | 高级用户部署 | 否 | 同样的 Lite 行为，采用 MSI 包 | | **Portable ZIP** | 锁定或免安装的 Windows 环境 | 是的，位于 `portable-data/bin` 内 | 将应用及其数据保留在同一个文件夹中 | ## 安装信任与 SmartScreen HalalDL 的发布版本目前**未进行代码签名**，因此 Windows SmartScreen 可能会在首次运行时发出警告。 - 仅从官方的 [GitHub Releases](https://github.com/Asdmir786/HalalDL/releases/latest) 页面下载 - 根据每个版本附带的 `SHA256SUMS.txt` 文件验证安装程序 - 如果出现 SmartScreen 提示，请点击 `更多信息`，并只有在校验和与发布页面匹配时才确认发布者/来源 ### 在 Windows 上验证 SHA256 在你下载安装程序的文件夹中打开 PowerShell 并运行： ``` Get-FileHash .\HalalDL-Full-v0.5.1-win10+11-x64-setup.exe -Algorithm SHA256 ``` 将 `Hash` 值与同一 GitHub Release 中 `SHA256SUMS.txt` 里的对应行进行比较。如果文件名不同，请将命令中的文件名替换为你下载的文件名。 该仓库是完全公开的，因此你可以在安装前检查源代码、工作流和发布过程。请参阅[代码签名策略](./CODE_SIGNING_POLICY.md)了解当前的签名计划和验证指南。 ## 功能 - 从支持的平台下载高质量视频和音频 - 内置针对常见格式、设备和字幕工作流的预设 - 通过剪贴板感知预设启动，实现托盘快速下载 - 应用内版本检查，提供经过验证的更新下载 - 提供更好的 Instagram 支持，包括轮播图和纯图片处理 - 通过原始的 `yt-dlp` 输出实现完全透明 - 针对 `yt-dlp`、`ffmpeg`、`aria2` 以及可选 runtime 的工具管理 - 以媒体为核心的下载历史记录组织方式 - 提供适应不同需求层次的 Lite 和 Full 打包版本 ## 常见问题解答 ### HalalDL 是云服务吗？ 不是。HalalDL 是一款本地桌面应用。 ### 我应该选择哪个版本？ 如果你想要最简单的设置，请选择 **Full setup EXE**。如果你更喜欢自行管理工具，请选择 **Lite**。如果你想要一个自带应用数据和托管工具的免安装文件夹，请选择 **Portable ZIP**。 ### HalalDL 支持 macOS 或 Linux 吗？ 在当前的发布计划中不支持。该项目目前以 Windows 为优先。 ### 这个应用有代码签名吗？ 还没有。这就是为什么 README 和发布流程中包含了 SmartScreen 和校验和指南。 ## 当前范围 - Windows 优先的桌面应用 - Tauri v2 + React + TypeScript 前端 - 本地 JSON 存储，无登录系统，无遥测 ## 开发 ### 技术栈 - [Tauri](https://tauri.app/) - [React](https://react.dev/) - [TypeScript](https://www.typescriptlang.org/) - [Vite](https://vitejs.dev/) - [Tailwind CSS](https://tailwindcss.com/) - [shadcn/ui](https://ui.shadcn.com/) ### 命令 ``` pnpm install pnpm dev pnpm lint pnpm typecheck pnpm check pnpm build:lite pnpm build:full ``` ## 许可证 [MIT](./LICENSE) ## 关于 基于 yt-dlp 的 Windows 本地优先媒体下载工具，具备预设、可见日志以及可选的工具管理功能。

标签：ffmpeg, yt-dlp, 媒体下载器, 桌面应用, 自动化攻击