把喜欢的一切，
留下来

不需要。Lumio 是纯本地工具，无需注册、无需登录。下载 Instagram 内容需要导入你的 IG cookie（Netscape 格式），下载 X 图片和批量枚举需要导入 auth_token + ct0 cookie，其他 6 大平台（YouTube / B站 / 抖音 / 快手 / 微博 / 小红书）开箱即用，无需任何凭证。

是的。所有平台默认下载 API 返回档位内的最高画质：

• YouTube：4K / 8K + 自动合并音频（用户手动选择格式）
• Instagram：视频取 width 最大档位，图片取 image_versions2.candidates 最大档位
• X (Twitter)：图片请求原图（?format=jpg&name=orig），视频取最高 bitrate
• B站：DASH fnval=16 + qn=127 + fourk=1 请求最高档
• 抖音：aweme detail API 遍历 bit_rate[] 取最高档（已知限制：60 帧 H.265 超高清原画需 app API）
• 微博 / 小红书 / 快手：取 API 返回的最高分辨率

所有下载均无平台水印。

Lumio 在设计上避免触发风控：

• Instagram：右键 IG 页面时浏览器扩展一次性注入提取 DOM 直链，不调 IG API，不触发自动化检测
• X：用 GraphQL API + 你的 cookie，频率克制，不批量爬取
• 抖音：自动获取 ttwid 访客标识，无需用户 cookie 或 a_bogus 签名
• 批量下载：内建指数退避重试（5s → 15s → 30s），控制节奏

但仍建议合理使用，避免短时间内下载几百条内容。

V4.4.0 已完成跨平台 CI/CD 构建（GitHub Actions 三平台矩阵），提供：

• Windows：NSIS 安装包（路径选择 + 卸载清理）
• macOS：DMG（分 x64 / arm64 架构）
• Linux：AppImage / .deb / .rpm

安装包即将发布，敬请期待。

所有数据完全本地存储，不上传任何服务器：

• 素材库：~/.lumio/library.db（SQLite，含元数据 + content_hash）
• 下载历史：~/.lumio/history.json
• 配置：~/.lumio/config.json
• 下载队列：~/.lumio/queue.json（原子写入防崩溃截断）
• 媒体文件：用户指定目录，自动入库

Lumio 不收集任何用户数据，不发送任何遥测。删除 ~/.lumio/ 即可完全清除。

Chrome / Edge 浏览器扩展（Manifest V3）使用流程：

1. 在社交媒体详情页打开 Lumio 插件
2. 插件自动解析提取当前页媒体元数据
3. 点击发送，一键发送到 Inbox 收件箱

安全方面：

• 扩展仅读取页面 DOM 元数据，不读取你的私信或聊天
• 数据通过本地 API（127.0.0.1:38900）发送到桌面端，不经过任何外部服务器
• IG 一次性注入提取直链，不常驻 content script，不调 IG API
• 开源代码，可自行审计

Lumio 是 MIT 协议开源，完全免费，无任何付费功能。源码托管在 GitHub，欢迎 Star / Issue / PR。

分平台说明：

• 国内平台（微博 / 小红书 / 抖音 / B站 / 快手）—— 无需代理，直接使用。
• 国外平台（YouTube / Instagram / X）—— 中国大陆网络环境下需要自备代理工具。

Lumio 启动时会自动检测外网连通性（尝试连接 youtube.com:443），失败会推送通知提醒。

代理配置：Lumio 会自动读取系统代理（HTTP_PROXY / HTTPS_PROXY 环境变量），无需额外设置。直链下载用 requests.Session(trust_env=True) 尊重系统代理。

Apify 模式：Instagram 下载也可走 Apify 代理（详见下一条），但 Apify API 服务器和 CDN 都在境外，仍需代理。

Apify 是第三方爬虫代理平台，Lumio 通过它提取 Instagram 数据，替代直接调用 IG 移动 API，避免账号风控。Token 是免费的，个人使用足够。

获取步骤：

1. 注册 Apify 账号：console.apify.io/sign-up（注意是 .io 不是 .com）
2. 登录后进入 Console → 右上角 Settings → Integrations 页面
3. 复制 Your API token（格式 apify_api_xxxxxxxxxxxx）
4. 在 Lumio Settings 页面「Cookie/API 凭证管理」区粘贴 Token
5. Actor ID 默认填 shu8hvrXbJbY3Eb9W（Instagram Scraper 官方 Actor）
6. 点「验证连接」即可启用

免费额度：Apify 每月提供 $5 免费额度，个人使用足够。用量在 console.apify.io 首页查看。

注意：Apify API 服务器（api.apify.com）和媒体 CDN 都在境外，国内网络需挂代理才能解析和下载成功。

官网域名：主站 apify.com，控制台 console.apify.io，文档 docs.apify.com。

Lumio 内置预览支持图片缩放、多图切换、视频/音频播放（QMediaPlayer），点击缩略图即可打开，无需切窗口。

但下载的 HEVC/H.265、4K HDR、特殊编码格式，建议安装专用播放器获得最佳体验：

• PotPlayer（推荐，Windows）—— potplayer.tv，解码器全，支持硬解
• VLC（跨平台）—— videolan.org，Windows / macOS / Linux 通吃
• mpv（极客向）—— mpv.io，轻量、命令行友好、画质调校强

在 Lumio 中使用外部播放器：Library 素材库中双击素材，会用系统默认播放器打开。可在系统设置中把视频默认程序改为 PotPlayer / VLC / mpv。