SheepGet v1.0.12

🚀 SheepGet v1.0.12 发布说明

现代轻量、极速高性能桌面下载管理器与流媒体嗅探工具。

---

💡 本次版本核心特性与关键更新

SheepGet v1.0.12 带来 全局下载速率限制、独立进度窗口卡片内任务删除与确认、未知大小 HLS 任务完成体积真实回填、内置分类接管扩充，并修复了展开下拉浮层时标题栏拖拽区域阻断外部点击收起的问题，进一步完善了全平台发布工作流的校验和聚合机制：

1. ⚡ 全局下载速率限制（Speed Limit）

• 灵活速率上限：在「设置 → 下载设置」中新增「下载速率限制」配置项，支持为全局下载带宽设置上限（单位 KB/s），设为 0 或留空即为不限制；
• 统一流量整形：后端采用基于令牌桶（Token Bucket）的速率限制器，统一管控所有正在运行的 HTTP 分块并发下载与 HLS 流媒体切片下载；
• 动态热重载：修改速率限制后即时应用到当前所有传输通道与活跃分片，无需暂停任务或重启客户端；
• 精致输入交互：输入框支持键盘回车及失焦自动保存，限制设置成功或取消均提供明确的状态 Toast 反馈。

2. 🗑️ 独立进度窗口卡片内任务删除（In-card Overlay）

• 快捷删除入口：共享下载进度窗口为每个下载项新增删除按钮，方便用户直接在小窗口中清理不需要的任务；
• 卡片内精准覆盖：重构删除确认交互，废弃原有的全局模态弹窗与 260px 最小窗口高度强行占位 hack，改用轻量紧凑的卡片内浮层（ProgressTaskDeleteOverlay），精准覆盖当前卡片，绝不遮挡其他正在下载的任务条目；
• 状态感知与安全确认：针对下载中任务与已完成/失败任务展示不同的提示文案，支持勾选“同时从磁盘删除已下载文件”；
• 轻量撤销：支持通过键盘 Escape 键或点击卡片外部区域快速收起取消，降低误触成本。

3. 📦 未知大小任务完成时真实体积回填

• 消除永久未知状态：部分 HLS 任务因分片数量过多（>200）或源站不支持 HEAD 探测，在下载期间总大小标记为未知（-1）；此前转封装完成落盘后未回填大小，导致进度窗口与主界面永久显示“未知大小”；
• 成品真实字节回填：任务转封装完成时若总大小仍未知，自动读取落盘成品文件的真实字节数并更新任务元数据；进度窗口完成卡片增加真实字节数兜底，确保准确展示最终文件大小。

4. 🗂️ 默认内置“文件”分类接管扩展名扩充 .bin

• 内置“文件”分类默认接管后缀列表新增 .bin，与 .doc、.pdf、.epub 等常见文件统一归集；
• 固件、数据包等常见 .bin 下载请求将自动匹配并归入指定的“文件”存储目录。

5. 🪟 浮层激活时标题栏拖拽区域降级优化

• 浮层锁机制：引入全局浮层锁管理（acquireOverlayLock），当下拉菜单（Select）等浮层展开时，临时移除顶部非客户区标题栏的 caption 与可拖拽（--wails-draggable:drag）属性；
• 修复收起失灵：将标题栏临时降级为标准客户区网页元素，彻底解决浮层展开状态下点击顶部标题栏空白区域无法触发外部点击（Outside Click）导致下拉框不能收起的问题。

6. 🚀 CI/CD 全平台发布产物 SHA-256 聚合校验

• 优化自动化发布流程：所有跨平台构建 job 完成各自的安装包打包与上传后，由独立的 checksums 聚合任务统一下载全平台构建产物并生成最终的 SHA256SUMS.txt；
• 避免平台间并发写入导致校验清单被覆盖，确保 Windows、macOS 和 Linux 全部产物的散列校验完整准确。

---

📦 全平台分发包下载指引

操作系统 / 架构	分发包文件格式	产物推荐文件名	适用场景与说明
Windows x64	.exe (NSIS)	SheepGet_1.0.12_x64-setup.exe	推荐。主流 64 位 Windows 用户安装包，带桌面/开始菜单快捷方式与卸载程序
	.zip (Portable)	SheepGet_1.0.12_windows-x64-portable.zip	推荐。绿色免安装便携包，解压即用，支持内置自动热更新
	.msi	SheepGet_1.0.12_x64_en-US.msi	Windows 企业级批量静默部署安装包
Windows ARM64	.exe (NSIS)	SheepGet_1.0.12_arm64-setup.exe	适配 Snapdragon X Elite / Surface Pro 等 Windows on ARM 设备
	.zip (Portable)	SheepGet_1.0.12_windows-arm64-portable.zip	Windows on ARM 绿色免安装便携包
macOS (Apple Silicon)	.dmg	SheepGet_1.0.12_aarch64.dmg	针对 M1/M2/M3/M4 系列 Mac，原生 ARM64 极致性能与低能耗
macOS (Intel)	.dmg	SheepGet_1.0.12_x64.dmg	针对老款采用 Intel 芯片的 Mac 电脑
macOS (Universal)	.dmg	SheepGet_1.0.12_universal.dmg	双架构通用安装包，免去区分架构的识别成本
Linux x86_64	.AppImage	SheepGet_1.0.12_amd64.AppImage	推荐。全 Linux 发行版通用单文件可执行包，无需安装依赖
	.deb	SheepGet_1.0.12_amd64.deb	Ubuntu / Debian / Deepin 等基于 dpkg 的发行版安装包
	.tar.gz (Portable)	SheepGet_1.0.12_linux-x64.tar.gz	Linux 独立免安装绿色归档包

注：每个分发包的 SHA-256 校验和均记录在同目录的 SHA256SUMS.txt 文件中；该文件在全部平台打包完成后统一生成，覆盖本次发布的全部产物。

---

🍏 macOS 首次安装提示“已损坏，无法打开”或“未知开发者”解决方案

将 SheepGet.app 拖入 应用程序 (Applications) 文件夹后，打开 macOS 终端 (Terminal) 执行：

sudo xattr -rd com.apple.quarantine /Applications/SheepGet.app

输入 Mac 锁屏密码后即可正常双击启动。

---

🧩 配套浏览器扩展（Chrome & Edge v1.0.7）

当前版本桌面端与浏览器扩展 v1.0.7 保持完全兼容与协议协同，无需升级扩展版本。新用户可下载 SheepGet_1.0.7_extension-chrome-mv3.zip 并通过浏览器“开发者模式”加载，或在客户端「设置」→「关于与更新」中获取指引。

SheepGet v1.0.11

🚀 SheepGet v1.0.11 发布说明

现代轻量、极速高性能桌面下载管理器与流媒体嗅探工具。

---

💡 本次版本核心特性与关键更新

SheepGet v1.0.11 带来 zip 聚合下载、进度窗口完成聚焦与单次静默下载、分类落点收敛，并集中处理了下载引擎与前端列表的热路径性能、扩展 Cookie 权限与交接回退：

1. 📦 zip 聚合下载（面向脚本与 AI Agent）

• 一个批次只对应一个任务：同一应用、模型、场景或数据集的多个零散文件通过 zipId 登记为一个批次，成员文件不建独立任务、不产生独立进度条目，任务列表与进度窗口只展示所属批次；
• 先登记、后下载：收集阶段只探测大小、真实文件名、最终 URL 与续传信息，不占用下载名额；闭合（zipFinal）后才进入队列统一传输并打包成一个 zip；
• 安全阀「立即打包」：Agent 忘记闭合时可在界面直接收尾，批次不会永远停在收集阶段；
• 连接预算沿用单任务设置：批次内最多 4 个成员并行，单任务分块连接数在在飞成员之间均分，小文件自然收敛为单连接，不因批次放大连接数；
• 暂存 + 原子打包，失败可分离重试：成员先落到任务暂存目录，打包写入 <目标>.sheepget 成功后原子改名；传输失败只补失败或缺失成员，打包失败走「仅重试处理」直接复用暂存分片；
• 成员路径冲突直接 409：zip 内路径保持原名，不自动改名，避免破坏模型加载与使用方约定；
• 重启语义：collecting 阶段重启后保持收集，可继续登记或补发闭合；已进入下载/处理的任务重启后落到暂停，由用户手动继续。

2. 🪟 完成后聚焦与单次静默下载

• 新增全局设置「完成后聚焦进度窗口」：关闭后任务完成既不呼出进度窗口，也不把用户正在看的窗口抢到前台，即一次完全静默的下载；完成信息是否保留仍由「保留完成信息」独立决定；
• 开放接口按次覆盖：POST /api/v1/tasks 新增 showProgressWindow、keepCompletedInfo、focusProgressWindowOnComplete，省略任一项即跟随配置中心；覆盖随任务持久化，暂停、重启、重试后仍然生效。

3. 🗂️ 分类落点与接管规则收敛

• 分类保存目录由后端唯一解析：文件信息窗口切换分类时不再自行拼接目录，内置分类的相对子目录（如 Videos）不会被当作绝对路径提交，「保留原路径」判定与显示一致；
• 重置接管类型只影响当前分类：只恢复该内置分类的预置后缀列表，保存子目录、其他内置分类与自定义分类全部保持用户配置；
• 默认内置接管分组剔除浏览器可预览格式：浏览器内联预览的格式不再被桌面端接管；
• 修复文件信息窗口冷启动竞态：消除探测响应覆盖旧快照与重复打开时的状态错乱。

4. ⚡ 热路径性能

• HLS 分片进度改为增量上报：每个分片完成只做一次 O(1) 追加，不再复制整份进度位图；位图只在 60ms 节流快照时复制一次；
• 下载引擎：分片写入与进度发布移出分块锁；进度落盘按时间与字节双重节流；任务库保存不再持锁做磁盘写，启动历史迁移合并为一次写入；
• 队列：提前下载取消不再跨越队列锁（此前最长阻塞 5 秒）；
• 前端：任务列表排序键只解析一次，排序键未变的进度更新只替换该项而不重排整表；任务项 memo 化，窗口高度 IPC 每 60ms 合并一次并保证最后一个高度送达；
• 扩展：悬浮条 DOM 观察改 200ms 节流并忽略自身插入/移除引发的变更；SPA 页面上下文按 URL+标题去重，并在路由、标题与正文变化后重新上报。

5. 🐞 关键修复

• 扩展声明 cookies 权限：此前 chrome.cookies 未绑定、异常被空 catch 吞掉，需要登录或防盗链的直链、HLS 清单与媒体请求拿不到 Cookie；现已随交接正确转发，门禁在构建产物 manifest 上校验该权限；
• 直接点击交接失败后回退下载不再被取消：桌面端未连接时内容脚本改为走浏览器原生下载通道并清理防重表，回退的下载不会被扩展二次拦截；
• 媒体处理阶段可暂停/删除：处理中暂停会真正中断运行；删除的任务不会被处理结果写回，也不再出现界面回弹；
• Select 清空控件移出触发器：消除按钮内嵌可聚焦元素的无效 HTML/ARIA 结构，清空操作不打开菜单；
• 设置变更统一走一条应用路径：代理、提前下载、分类目录等修改不再各自散落，行为与优先级一致；
• 限流分片重试不再占着并发名额：源站按并发连接返回 429 时，退避期间让出名额，重试按收缩后的上限排队，避免限流分片耗光重试次数而让整个 HLS 任务失败。

6. 🔄 常驻运行期间每 24 小时检查更新

• 不再只在启动时检查一次：关闭主窗口后软件驻留托盘，用户往往数天不重启；现在启动后照旧检查一次，此后每 24 小时在后台静默再检查一次，新版本不会再因为长期不重启而一直发现不了；
• 发现新版本仍只提示一次：界面沿用原有「单次运行只弹一次提示」的约定，周期检查只刷新已发现的版本信息，不重复打扰；
• 开关语义同步：「设置 → 通用」里的开关改为「自动检查更新」，关闭后启动检查与周期检查都不再发起网络请求；运行中关闭后，下一次周期检查直接跳过。

7. 🛠 工程与门禁

• CI 三平台统一安装 ffmpeg 并设置任务超时；扩展发布流程先跑协议镜像校验、类型检查与测试，失败不再产出可下载的包；
• 门禁新增 extensionBuild 阶段的 manifest 权限校验，version 阶段强制扩展版本防漂移与发布说明存在。

---

📦 全平台分发包下载指引

操作系统 / 架构	分发包文件格式	产物推荐文件名	适用场景与说明
Windows x64	.exe (NSIS)	SheepGet_1.0.11_x64-setup.exe	推荐。主流 64 位 Windows 用户安装包，带桌面/开始菜单快捷方式与卸载程序
	.zip (Portable)	SheepGet_1.0.11_windows-x64-portable.zip	推荐。绿色免安装便携包，解压即用，支持内置自动热更新
	.msi	SheepGet_1.0.11_x64_en-US.msi	Windows 企业级批量静默部署安装包
Windows ARM64	.exe (NSIS)	SheepGet_1.0.11_arm64-setup.exe	适配 Snapdragon X Elite / Surface Pro 等 Windows on ARM 设备
	.zip (Portable)	SheepGet_1.0.11_windows-arm64-portable.zip	Windows on ARM 绿色免安装便携包
macOS (Apple Silicon)	.dmg	SheepGet_1.0.11_aarch64.dmg	针对 M1/M2/M3/M4 系列 Mac，原生 ARM64 极致性能与低能耗
macOS (Intel)	.dmg	SheepGet_1.0.11_x64.dmg	针对老款采用 Intel 芯片的 Mac 电脑
macOS (Universal)	.dmg	SheepGet_1.0.11_universal.dmg	双架构通用安装包，免去区分架构的识别成本
Linux x86_64	.AppImage	SheepGet_1.0.11_amd64.AppImage	推荐。全 Linux 发行版通用单文件可执行包，无需安装依赖
	.deb	SheepGet_1.0.11_amd64.deb	Ubuntu / Debian / Deepin 等基于 dpkg 的发行版安装包
	.tar.gz (Portable)	SheepGet_1.0.11_linux-x64.tar.gz	Linux 独立免安装绿色归档包

注：每个分发包的 SHA-256 校验和均记录在同目录的 SHA256SUMS.txt 文件中；该文件在全部平台打包完成后统一生成，覆盖本次发布的全部产物。

---

🍏 macOS 首次安装提示“已损坏，无法打开”或“未知开发者”解决方案

将 SheepGet.app 拖入 应用程序 (Applications) 文件夹后，打开 macOS 终端 (Terminal) 执行：

sudo xattr -rd com.apple.quarantine /Applications/SheepGet.app

输入 Mac 锁屏密码后即可正常双击启动。

---

🧩 配套浏览器扩展（Chrome & Edge v1.0.7）

当前版本桌面端与浏览器扩展 v1.0.7 深度协同适配。该版本修复了 cookies 权限缺失导致交接 Cookie 恒为空的问题，修复了桌面端离线时直接点击交接的回退下载被取消的问题，并降低了悬浮条 DOM 观察与 SPA 页面上下文上报的开销。已安装扩展的用户可通过扩展管理页面更新，新用户可下载 SheepGet_1.0.7_extension-chrome-mv3.zip 并通过浏览器“开发者模式”加载，或在客户端「设置」→「关于与更新」中获取指引。

SheepGet Extension ext-v1.0.7

Browser extension release v1.0.7

SheepGet v1.0.10

🚀 SheepGet v1.0.10 发布说明

现代轻量、极速高性能桌面下载管理器与流媒体嗅探工具。

---

💡 本次版本核心特性与关键更新

SheepGet v1.0.10 是一次聚焦**“更新全链路网络弹性容错与多代理智能自愈”**的关键修复版本，彻底解决了 GitHub API 频控限额导致更新检查 403 的痛点，并打通了多层代理与系统代理探针兜底：

1. 🛡️ 彻底根除 GitHub API 403 限额阻断（零配额 HTML 探测自愈体系）

• 智能区分网络连通与 API 频控：
  • 遇到 HTTP 403（Rate Limit Exceeded）时，精准识别为“网络畅通但出口 IP 耗尽免费调用额度”，不再草率中断或报错；
  • 自动在当前可用链路上无感切换至 HTML 网页探测机制，通过网页端重定向与 expanded_assets 接口解析最新版本与全架构安装包；
  • 完全不消耗 GitHub REST API 每小时 60 次的 IP 配额，彻底免疫公共代理/VPN 节点 IP 配额耗尽引发的检查失败。

2. 🌐 多代理候选链顺序轮询与全链路兜底 (Multi-Proxy Fallback)

• 自定义多代理逐级熔断：配置多自定义代理时，更新检查与安装包下载依次按顺序尝试节点，遇网络超时或故障自动秒级顺延；
• 系统代理探针自适应：
  • 在“无代理”或“系统代理”模式下，深度兼容 Windows 注册表配置与系统环境变量；
  • 即使系统代理开关为 Off，只要历史配置过代理服务器地址，即自动提取并作为高优尝试节点，最大化克服网络阻隔；
  • 代理全链路失败后，自动平滑回退至直连（Direct）探测。

3. ⚡ 下载器链路继承与断连自愈

• 检查与下载链路深度对齐：更新检查成功后，Downloader 自动继承验证成功的有效代理链路优先下载；
• 传输中途故障顺延：安装包下载过程中若遭遇代理节点连接异常，自动顺延候选链中的剩余节点继续传输，保障更新包顺利落盘。

---

📦 全平台分发包下载指引

操作系统 / 架构	分发包文件格式	产物推荐文件名	适用场景与说明
Windows x64	.exe (NSIS)	SheepGet_1.0.10_x64-setup.exe	推荐。主流 64 位 Windows 用户安装包，带桌面/开始菜单快捷方式与卸载程序
	.zip (Portable)	SheepGet_1.0.10_windows-x64-portable.zip	推荐。绿色免安装便携包，解压即用，支持内置自动热更新
	.msi	SheepGet_1.0.10_x64_en-US.msi	Windows 企业级批量静默部署安装包
Windows ARM64	.exe (NSIS)	SheepGet_1.0.10_arm64-setup.exe	适配 Snapdragon X Elite / Surface Pro 等 Windows on ARM 设备
	.zip (Portable)	SheepGet_1.0.10_windows-arm64-portable.zip	Windows on ARM 绿色免安装便携包
macOS (Apple Silicon)	.dmg	SheepGet_1.0.10_aarch64.dmg	针对 M1/M2/M3/M4 系列 Mac，原生 ARM64 极致性能与低能耗
macOS (Intel)	.dmg	SheepGet_1.0.10_x64.dmg	针对老款采用 Intel 芯片的 Mac 电脑
macOS (Universal)	.dmg	SheepGet_1.0.10_universal.dmg	双架构通用安装包，免去区分架构的识别成本
Linux x86_64	.AppImage	SheepGet_1.0.10_amd64.AppImage	推荐。全 Linux 发行版通用单文件可执行包，无需安装依赖
	.deb	SheepGet_1.0.10_amd64.deb	Ubuntu / Debian / Deepin 等基于 dpkg 的发行版安装包
	.tar.gz (Portable)	SheepGet_1.0.10_linux-x64.tar.gz	Linux 独立免安装绿色归档包

注：每个分发包的 SHA-256 校验和均记录在同目录的 SHA256SUMS.txt 文件中。

---

🍏 macOS 首次安装提示“已损坏，无法打开”或“未知开发者”解决方案

将 SheepGet.app 拖入 应用程序 (Applications) 文件夹后，打开 macOS 终端 (Terminal) 执行：

sudo xattr -rd com.apple.quarantine /Applications/SheepGet.app

输入 Mac 锁屏密码后即可正常双击启动。

---

🧩 配套浏览器扩展（Chrome & Edge v1.0.6）

当前版本桌面端与浏览器扩展 v1.0.6 深度协同适配。已安装扩展的用户可通过扩展管理页面更新，新用户可下载 SheepGet_1.0.6_extension-chrome-mv3.zip 并通过浏览器“开发者模式”加载，或在客户端「设置」→「关于与更新」中获取指引。

SheepGet v1.0.9

🚀 SheepGet v1.0.9 发布说明

现代轻量、极速高性能桌面下载管理器与流媒体嗅探工具。

---

💡 本次版本核心特性与关键更新

SheepGet v1.0.9 带来了系统级沉浸式毛玻璃视效重构、现代精致桌面 UI 收敛、应用启动智能更新检测以及配套浏览器扩展通用接管协议：

1. 🪟 原生沉浸式毛玻璃视效与系统级背景模糊穿透

• 跨平台系统级半透明：
  • Windows：启用原生半透明通道并引入 Acrylic / Mica 背景材质渲染，精简自定义标题栏 Shell Chrome，消除视觉割裂；
  • macOS：统一启用原生 NSVisualEffectView 毛玻璃穿透通道，窗口背景根据系统壁纸动态漫反射。
• macOS 紧凑红绿灯与布局收敛：
  • 深度定制 macOS 原生红绿灯按钮，采用超小紧凑尺寸并锁定窗口生命周期控制；
  • 侧边栏顶部内边距收敛至 40px，窗口标题与系统控制区黄金比例对齐。

2. 🎨 现代高信息密度 UI 视觉收敛与主题双向联动

• 系统主题实时双向同步：
  • 用户手动偏好具有最高优先级；
  • “跟随系统”模式下，实时响应操作系统 Theme 动态切换（暗黑 / 明亮模式），无需重启或手动刷新。
• 界面细节与交互调优：
  • 侧边栏视觉精简：侧边栏选中态高亮与 hover 反馈规范化，分类与状态条目计数移除胶囊底色，信息展示更克制；
  • 标题栏按钮 Ghosty 风格：右侧功能按钮转为统一轻量 ghosty 质感，保持视觉重心集中于下载列表；
  • 空状态重绘：任务列表空状态移除沉重卡片底衬，图标比例调整至 1.5 倍（size-12），留白更优雅；
  • 拖拽体验优化：全局禁用图片非预期拖拽，精细化微调 Header 区域可拖拽判定边界。

3. 🔔 应用启动智能更新检测

• 自动无感探活：启动时后台异步检测 GitHub 最新版本信息，非侵入式不阻塞核心界面加载；
• 顶部通知提醒：发现新版本时在 Header 区域提供优雅的状态提醒，一键跳转查看版本更新日志与安装包下载。

4. 🧩 配套浏览器扩展同步升级 (v1.0.6)

• 通用接管协议 (Universal Handover Protocol)：浏览器扩展与客户端环回通信协议标准化，支持丰富请求上下文与媒体元数据传递；
• 自适应降级回退 (Auto-Adaptive Fallback)：当桌面端未启动或退出时，浏览器扩展智能平滑回退至浏览器内置下载或优雅提示，杜绝用户下载丢失。

---

📦 全平台分发包下载指引

操作系统 / 架构	分发包文件格式	产物推荐文件名	适用场景与说明
Windows x64	.exe (NSIS)	SheepGet_1.0.9_x64-setup.exe	推荐。主流 64 位 Windows 用户安装包，带桌面/开始菜单快捷方式与卸载程序
	.zip (Portable)	SheepGet_1.0.9_windows-x64-portable.zip	推荐。绿色免安装便携包，解压即用，支持内置自动热更新
	.msi	SheepGet_1.0.9_x64_en-US.msi	Windows 企业级批量静默部署安装包
Windows ARM64	.exe (NSIS)	SheepGet_1.0.9_arm64-setup.exe	适配 Snapdragon X Elite / Surface Pro 等 Windows on ARM 设备
	.zip (Portable)	SheepGet_1.0.9_windows-arm64-portable.zip	Windows on ARM 绿色免安装便携包
macOS (Apple Silicon)	.dmg	SheepGet_1.0.9_aarch64.dmg	针对 M1/M2/M3/M4 系列 Mac，原生 ARM64 极致性能与低能耗
macOS (Intel)	.dmg	SheepGet_1.0.9_x64.dmg	针对老款采用 Intel 芯片的 Mac 电脑
macOS (Universal)	.dmg	SheepGet_1.0.9_universal.dmg	双架构通用安装包，免去区分架构的识别成本
Linux x86_64	.AppImage	SheepGet_1.0.9_amd64.AppImage	推荐。全 Linux 发行版通用单文件可执行包，无需安装依赖
	.deb	SheepGet_1.0.9_amd64.deb	Ubuntu / Debian / Deepin 等基于 dpkg 的发行版安装包
	.tar.gz (Portable)	SheepGet_1.0.9_linux-x64.tar.gz	Linux 独立免安装绿色归档包

注：每个分发包的 SHA-256 校验和均记录在同目录的 SHA256SUMS.txt 文件中。

---

🍏 macOS 首次安装提示“已损坏，无法打开”或“未知开发者”解决方案

将 SheepGet.app 拖入 应用程序 (Applications) 文件夹后，打开 macOS 终端 (Terminal) 执行：

sudo xattr -rd com.apple.quarantine /Applications/SheepGet.app

输入 Mac 锁屏密码后即可正常双击启动。

---

🧩 配套浏览器扩展（Chrome & Edge v1.0.6）

当前版本桌面端与浏览器扩展 v1.0.6 深度协同适配。已安装扩展的用户可通过扩展管理页面更新，新用户可下载 SheepGet_1.0.6_extension-chrome-mv3.zip 并通过浏览器“开发者模式”加载，或在客户端「设置」→「关于与更新」中获取指引。

SheepGet Extension ext-v1.0.6

Browser extension release v1.0.6

SheepGet v1.0.8

🚀 SheepGet v1.0.8 发布说明

现代轻量、极速高性能桌面下载管理器与流媒体嗅探工具。

---

💡 本次版本核心特性与关键更新

SheepGet v1.0.8 是一次聚焦**“极致下载韧性与全链路网络容错”的重要升级，带来了多代理顺序兜底链**、下载弹性三级容错体系 (P0/P1/P2)、静默接管下载模式以及配套浏览器扩展热重载注入恢复：

1. 🌐 多代理顺序兜底链 (Multi-Proxy Fallback) 与并发上限自适应

• 优先级代理链与智能熔断：支持在设置面板配置有序的多代理列表。下载过程中若当前代理发生连接超时、握手失败或网络中断，系统秒级自动熔断并顺延切换至备用代理，保障海外或受限资源下载不中断；
• 直连与代理双向兜底：代理全链路失效或发生系统级网络抖动时，支持自动回退直连探测；同时引入全局退避降级与过期鉴权 Token 自动刷新；
• 自适应并发上限调节：根据当前代理链路的吞吐量与连接建立延迟，动态调节分块连接并发上限，避免代理节点连接数爆满引发频控限流。

2. 🛡️ 核心引擎下载弹性全链路升级 (P0 / P1 / P2 韧性体系)

• P0 级精准熔断与单流回退：
  • 智能拦截 401、403、404、410、451 等确定性不可重试 HTTP 状态码，杜绝盲目重试浪费系统资源；
  • 针对目标服务器返回伪 Range 或分块损坏的情况，自动平滑回退至单流稳定下载。
• P1 级协议降级、流控与磁盘预检：
  • 协议智能降级：HTTP/2 遭遇流重置 (RST_STREAM) 或连接协商异常时，无缝降级至 HTTP/1.1 继续传输；
  • HLS 自适应流控：对高频分片拉取实施动态频控调度，防范源站反爬与并发封禁；
  • 落盘前磁盘预检：创建大文件任务前自动探测目标盘符剩余空间，提前预警，彻底杜绝写满磁盘导致的崩溃。
• P2 级 HTML 软错误拦截与 HLS 假死自愈：
  • 深度内容探测：自动识别下载链接重定向至登录页、验证码或运营商拦截页等“HTTP 200 假正常”的 HTML 软错误；
  • HLS 保活与故障自愈：实时监测分片长连接吞吐停滞与假死，超时自动重建传输通道与自愈重连。

3. 🔕 下载体验升级：支持静默接管下载

• 跳过文件信息确认弹窗：在「常规设置」中新增“接管下载时跳过确认弹窗”开关。开启后，浏览器扩展捕获的所有下载任务将根据分类规则与默认目录直接静默入队下载，彻底释放高频下载操作负担。

4. ⚡ 默认参数调优与中文路径便携更新修复

• 默认并发能力提升：默认全局最大并发任务数与默认分块连接数提升至 32，满足现代百兆/千兆宽带的极速下载需求；
• 中文路径更新兼容：修复 Windows 便携版在路径包含中文字符时，自动更新批处理脚本执行失败的问题。

5. 🧩 浏览器扩展配套升级 (v1.0.5)

• 热重载自动注入恢复：扩展安装或重新加载后，自动向已打开的浏览器标签页重新注入 content script 与媒体监听器，无需手动刷新网页即可立即接管；
• 媒体条 DOM 状态复原：重载后自动清理孤立残留节点并恢复视频播放器右上角的小巧悬浮条。

---

📦 全平台分发包下载指引

操作系统 / 架构	分发包文件格式	产物推荐文件名	适用场景与说明
Windows x64	.exe (NSIS)	SheepGet_1.0.8_x64-setup.exe	推荐。主流 64 位 Windows 用户安装包，带桌面/开始菜单快捷方式与卸载程序
	.zip (Portable)	SheepGet_1.0.8_windows-x64-portable.zip	推荐。绿色免安装便携包，解压即用，支持内置自动热更新
	.msi	SheepGet_1.0.8_x64_en-US.msi	Windows 企业级批量静默部署安装包
Windows ARM64	.exe (NSIS)	SheepGet_1.0.8_arm64-setup.exe	适配 Snapdragon X Elite / Surface Pro 等 Windows on ARM 设备
	.zip (Portable)	SheepGet_1.0.8_windows-arm64-portable.zip	Windows on ARM 绿色免安装便携包
macOS (Apple Silicon)	.dmg	SheepGet_1.0.8_aarch64.dmg	针对 M1/M2/M3/M4 系列 Mac，原生 ARM64 极致性能与低能耗
macOS (Intel)	.dmg	SheepGet_1.0.8_x64.dmg	针对老款采用 Intel 芯片的 Mac 电脑
macOS (Universal)	.dmg	SheepGet_1.0.8_universal.dmg	双架构通用安装包，免去区分架构的识别成本
Linux x86_64	.AppImage	SheepGet_1.0.8_amd64.AppImage	推荐。全 Linux 发行版通用单文件可执行包，无需安装依赖
	.deb	SheepGet_1.0.8_amd64.deb	Ubuntu / Debian / Deepin 等基于 dpkg 的发行版安装包
	.tar.gz (Portable)	SheepGet_1.0.8_linux-x64.tar.gz	Linux 独立免安装绿色归档包

注：每个分发包的 SHA-256 校验和均记录在同目录的 SHA256SUMS.txt 文件中。

---

🍏 macOS 首次安装提示“已损坏，无法打开”或“未知开发者”解决方案

将 SheepGet.app 拖入 应用程序 (Applications) 文件夹后，打开 macOS 终端 (Terminal) 执行：

sudo xattr -rd com.apple.quarantine /Applications/SheepGet.app

输入 Mac 锁屏密码后即可正常双击启动。

---

🧩 配套浏览器扩展（Chrome & Edge v1.0.5）

当前版本桌面端与浏览器扩展 v1.0.5 深度协同适配。已安装扩展的用户可通过扩展管理页面更新，新用户可下载 SheepGet_1.0.5_extension-chrome-mv3.zip 并通过浏览器“开发者模式”加载，或在客户端「设置」→「关于与更新」中获取指引。

SheepGet Extension ext-v1.0.5

Browser extension release v1.0.5

SheepGet v1.0.7

🚀 SheepGet v1.0.7 发布说明

现代轻量、极速高性能桌面下载管理器与流媒体嗅探工具。

---

💡 本次版本核心特性与关键更新

SheepGet v1.0.7 带来了快速并发爬坡机制、单连接分块故障隔离与容错、Windows 系统代理无感适配以及智能探测平滑回退：

1. ⚡ 传输引擎：快速并发爬坡 (Fast Ramp-Up) 与自适应连接调度

• 极速并发爬坡：在探测到目标服务器支持分块 Range 请求且网络响应优异时，下载引擎启用加速爬坡逻辑，大幅缩短达到最大并发数所需时间，秒级拉满可用带宽；
• 自适应平滑控速：在高速大宽带与各类 CDN 环境下敏捷响应，既保障高速拉取，又与现有的 429/503 频控降级保护机制协同运作，稳健不掉速。

2. 🛡️ 鲁棒性升级：单分块连接故障隔离 (Single-thread Fault Isolation)

• 细粒度故障隔离：当某个并发连接遭遇偶发网络超时、抖动或远端异常中断时，系统仅对故障分块实施独立重调度与退避重试，绝不波及其他进行中的正常并发数据流；
• 恶劣网络容错增强：显著提升在高延迟、弱网或易丢包网络环境下的下载成功率与连续性，避免整任务重置或性能塌陷。

3. 🌐 探测平滑回退与 Windows 系统代理自动适配

• 智能探测降级回退：针对部分源站禁止或未正确实现 HTTP HEAD 请求的问题，自动平滑回退至 GET 范围探测，确保准确识别内容大小并开启多线程加速；
• Windows 系统代理无感知适配：新增对 Windows 系统 Internet 代理设置（含系统代理服务器、端口及绕过列表）的原生读取与同步，各类本地代理或加速工具环境开箱即用；
• 单流与未知大小场景优化：强化不支持分块下载与流式响应场景下的流式落盘与大小自适应解析。

4. 🎨 界面与体验打磨

• 前端状态与进度呈现优化：调优并发重试、单流流式下载等特殊状态下的进度条动效与展示连贯性，视觉反馈更精确细腻。

---

📦 全平台分发包下载指引

操作系统 / 架构	分发包文件格式	产物推荐文件名	适用场景与说明
Windows x64	.exe (NSIS)	SheepGet_1.0.7_x64-setup.exe	推荐。主流 64 位 Windows 用户安装包，带桌面/开始菜单快捷方式与卸载程序
	.zip (Portable)	SheepGet_1.0.7_windows-x64-portable.zip	推荐。绿色免安装便携包，解压即用，支持内置自动热更新
	.msi	SheepGet_1.0.7_x64_en-US.msi	Windows 企业级批量静默部署安装包
Windows ARM64	.exe (NSIS)	SheepGet_1.0.7_arm64-setup.exe	适配 Snapdragon X Elite / Surface Pro 等 Windows on ARM 设备
	.zip (Portable)	SheepGet_1.0.7_windows-arm64-portable.zip	Windows on ARM 绿色免安装便携包
macOS (Apple Silicon)	.dmg	SheepGet_1.0.7_aarch64.dmg	针对 M1/M2/M3/M4 系列 Mac，原生 ARM64 极致性能与低能耗
macOS (Intel)	.dmg	SheepGet_1.0.7_x64.dmg	针对老款采用 Intel 芯片的 Mac 电脑
macOS (Universal)	.dmg	SheepGet_1.0.7_universal.dmg	双架构通用安装包，免去区分架构的识别成本
Linux x86_64	.AppImage	SheepGet_1.0.7_amd64.AppImage	推荐。全 Linux 发行版通用单文件可执行包，无需安装依赖
	.deb	SheepGet_1.0.7_amd64.deb	Ubuntu / Debian / Deepin 等基于 dpkg 的发行版安装包
	.tar.gz (Portable)	SheepGet_1.0.7_linux-x64.tar.gz	Linux 独立免安装绿色归档包

注：每个分发包的 SHA-256 校验和均记录在同目录的 SHA256SUMS.txt 文件中。

---

🍏 macOS 首次安装提示“已损坏，无法打开”或“未知开发者”解决方案

将 SheepGet.app 拖入 应用程序 (Applications) 文件夹后，打开 macOS 终端 (Terminal) 执行：

sudo xattr -rd com.apple.quarantine /Applications/SheepGet.app

输入 Mac 锁屏密码后即可正常双击启动。

---

🧩 配套浏览器扩展（Chrome & Edge v1.0.4）

当前版本桌面端与浏览器扩展 v1.0.4 保持完全兼容。已安装扩展的用户无需单独升级，新用户可下载 SheepGet_1.0.4_extension-chrome-mv3.zip 并通过浏览器“开发者模式”加载，或在客户端「设置」→「关于与更新」中获取指引。

SheepGet v1.0.6

🚀 SheepGet v1.0.6 发布说明

现代轻量、极速高性能桌面下载管理器与流媒体嗅探工具。

---

💡 本次版本核心特性与关键更新

SheepGet v1.0.6 带来了传输引擎自适应调度、自动化直连 API 与 Agent Skill 生态集成、UI 净耗时与剩余时间 (ETA) 精准展示以及核心持久化性能升级：

1. ⚡ 传输引擎：自适应并发探测与 429/503 智能降级

• 自适应动态并发探测：下载引擎根据当前网络吞吐与服务器响应动态探测最佳分块并发数，在最大化利用可用带宽的同时避免过载；
• 429 Too Many Requests / 503 限速智能回退：当目标服务器返回 429 或 503 频控限速状态码时，引擎自动进入指数退避与分流熔断模式，动态缩减分块并发并渐进式恢复，彻底避免因高并发分块被源站封禁。

2. 🤖 直连下载 API、OpenAPI 规范与内置 Agent Skill 支持

• RESTful 直连下载 API：新增 POST /api/v1/tasks 端点，支持无缝接收外部工具与脚本的自动化下载指令；
• 双轨鉴权保障：在现有的动态会话令牌（Session Token）基础上，新增静态 API Key 认证支持，满足长期脚本与工具集成的安全调用需求；
• OpenAPI 3.1 规范暴露：端点挂载 GET /api/v1/openapi.json，方便各类 API 工具直接生成客户端调用代码；
• 内置 Agent Skill：深度集成 AI Agent Skill 工具包，支持动态密钥同步与一键目录定位，开发者与 AI 助手可直接操作桌面端下载引擎。

3. ⏱️ 交互体验：净下载耗时与剩余时间 (ETA) 精确展示

• 真实有效下载耗时统计：主任务列表与独立共享进度窗口均引入净下载耗时统计，暂停、排队等待期间不计入有效耗时，还原真实传输时间；
• 高平滑动态 ETA 预估：基于滑动窗口瞬时速率精确估算剩余下载时间，大文件与变速网络环境下剩余时间显示更加平滑稳健。

4. 🚀 存储优化与 HLS 变体防重策略纠偏

• 持久化性能提升：任务元数据存储 tasks.json 采用紧凑 JSON 格式持久化，大幅减少磁盘 I/O 读写与序列化开销；
• HLS 多画质变体精准去重：优化流媒体任务防重检测逻辑，按变体规格（分辨率与清晰度）精准区分，避免不同画质的同一视频链接被误判为重复任务而被阻断。

---

📦 全平台分发包下载指引

操作系统 / 架构	分发包文件格式	产物推荐文件名	适用场景与说明
Windows x64	.exe (NSIS)	SheepGet_1.0.6_x64-setup.exe	推荐。主流 64 位 Windows 用户安装包，带桌面/开始菜单快捷方式与卸载程序
	.zip (Portable)	SheepGet_1.0.6_windows-x64-portable.zip	推荐。绿色免安装便携包，解压即用，支持内置自动热更新
	.msi	SheepGet_1.0.6_x64_en-US.msi	Windows 企业级批量静默部署安装包
Windows ARM64	.exe (NSIS)	SheepGet_1.0.6_arm64-setup.exe	适配 Snapdragon X Elite / Surface Pro 等 Windows on ARM 设备
	.zip (Portable)	SheepGet_1.0.6_windows-arm64-portable.zip	Windows on ARM 绿色免安装便携包
macOS (Apple Silicon)	.dmg	SheepGet_1.0.6_aarch64.dmg	针对 M1/M2/M3/M4 系列 Mac，原生 ARM64 极致性能与低能耗
macOS (Intel)	.dmg	SheepGet_1.0.6_x64.dmg	针对老款采用 Intel 芯片的 Mac 电脑
macOS (Universal)	.dmg	SheepGet_1.0.6_universal.dmg	双架构通用安装包，免去区分架构的识别成本
Linux x86_64	.AppImage	SheepGet_1.0.6_amd64.AppImage	推荐。全 Linux 发行版通用单文件可执行包，无需安装依赖
	.deb	SheepGet_1.0.6_amd64.deb	Ubuntu / Debian / Deepin 等基于 dpkg 的发行版安装包
	.tar.gz (Portable)	SheepGet_1.0.6_linux-x64.tar.gz	Linux 独立免安装绿色归档包

注：每个分发包的 SHA-256 校验和均记录在同目录的 SHA256SUMS.txt 文件中。

---

🍏 macOS 首次安装提示“已损坏，无法打开”或“未知开发者”解决方案

将 SheepGet.app 拖入 应用程序 (Applications) 文件夹后，打开 macOS 终端 (Terminal) 执行：

sudo xattr -rd com.apple.quarantine /Applications/SheepGet.app

输入 Mac 锁屏密码后即可正常双击启动。

---

🧩 配套浏览器扩展同步发布（Chrome & Edge v1.0.4）

本次版本同步发布配套浏览器扩展 v1.0.4（包含最新 API 路由与事件镜像更新）。用户可直接下载 SheepGet_1.0.4_extension-chrome-mv3.zip 并通过浏览器“开发者模式”加载更新，或在客户端「设置」→「关于与更新」中获取指引。