better-douyin 基于 Rust 和 Tauri 构建的轻量级、跨平台抖音桌面客户端 | 极客的赛博空间

这份详细的部署教程将指引您安装和运行 better-douyin——一个基于 Rust 和 Tauri 构建的轻量级、跨平台抖音桌面客户端。

核心定位与重要声明

项目性质：better-douyin 是一个旨在提供更清爽桌面体验的第三方工具，并非官方应用。它通过模拟用户操作来提供功能。
源码与完整版：您当前看到的 GitHub 仓库是 “Open Shell” (开源壳)，主要用于展示 UI 和前端架构，不包含与抖音平台真实交互的、可能涉及逆向工程的“连接器”代码。普通用户应直接从 Releases 页面下载完整的、已编译好的安装包使用，无需从源码构建。
风险与责任：使用此工具可能导致账号风控、限流甚至封禁。作者不提供规避平台限制的支持。使用者须自行承担所有风险，并确保使用行为符合抖音平台规则和所在地法律法规。此工具仅限个人在非商业场景下学习、研究使用，禁止任何商业用途。

这是最推荐的安装方式，适合所有普通用户。

获取安装包：访问项目的 Releases 页面，下载适用于您操作系统的最新版本安装包（如 .exe、.dmg 或 .AppImage）。
校验文件 (可选但推荐)：下载页面通常会提供 checksums.sha256 或 checksums.json 文件。您可以使用工具（如 shasum -a 256 <文件名>）核对下载文件的哈希值，确保文件完整且未被篡改。
安装与启动：运行下载的安装程序，按照指引完成安装。首次启动时，应用可能会请求必要的系统权限（如网络访问）。启动后，您需要登录您的抖音账号。

如果您是开发者，希望基于开源壳进行 UI 改进或二次开发，可以按以下步骤操作。请注意，此方式只能看到演示数据 (Mock Data)，无法进行真实登录和下载。

克隆仓库：

1 2	git clone https://github.com/anYuJia/better-douyin.git cd better-douyin

安装前端依赖：
1
npm --prefix frontend install
启动演示模式：有以下两种方式运行 Demo：
- 方式一 (开发模式，带热重载)：在项目根目录执行 npm run dev，这会启动前端开发服务器并打开应用窗口。
- 方式二 (预览构建产物)：先执行 npm run build 构建前端，然后执行 npm run server 启动一个本地 mock 后端服务器，用于预览 dist/ 目录下的静态构建文件。
一条命令运行完整Demo：执行 npm run demo，该命令会自动构建前端并启动 mock 后端服务。

完整版应用的功能围绕抖音内容的浏览、下载和管理展开。

内容浏览与搜索：支持搜索用户、解析分享链接、浏览推荐流、用户作品列表等。
内容下载与管理：支持单个或批量下载视频、图集。您可以配置下载目录、文件命名规则、并发数等。下载任务有进度显示和队列管理。
本地媒体库：“我的下载”功能提供了文件视图和作品视图，方便您搜索、筛选、播放和管理本地已下载的内容。
交互与自动化：
- 沉浸式播放器：提供完整的播放控制、清晰度切换、点赞收藏等。
- 通知与私信：可以查看互动通知和好友私信。
- AI 辅助 (需配置)：支持连接 OpenAI 兼容的 API，用于生成评论建议或私信回复。
- 自动监控 (需谨慎开启)：可以设置对推荐流、私信、通知、特定创作者更新等的自动监控，并执行自动点赞、评论（生成草稿）等动作。开启自动化功能会显著增加账号风险。
MCP 服务：完整版应用会开启一个本地的 HTTP MCP 服务，允许授权的 AI 工具（如 Claude Code）在您批准的情况下读取内容和控制下载任务。

账号安全：应用会保存您的登录凭证（Cookie）在本机，请确保您的计算机环境安全。
遵守规则：请勿使用此工具进行高频请求、批量采集或任何违反抖音用户协议的行为。作者明确表示不提供规避风控的支持。
非商业许可：本项目采用 Better Douyin Non-Commercial License，仅允许个人非商业使用。严禁任何形式的商业分发、集成或盈利行为。

总结：如果您想使用工具，请直接下载 Releases 中的安装包。如果您是开发者想改进界面，可以运行开源源码，但只能使用模拟数据。在使用任何自动化功能前，请三思而后行。