knowledge-grab 是一个基于 Tauri 和 Vue 3 构建的桌面应用程序，方便用户从 国家中小学智慧教育平台 (basic.smartedu.cn) 下载各类教育资源。
👏 欢迎 Starred & Use this template
https://github.com/alterem/tauri-vue-template/tree/naiveui
https://github.com/alterem/tauri-vue-template
https://github.com/alterem/tauri-react-template
- 框架: Vue 3 (使用 Composition API)
- 构建工具: Vite
- 桌面应用框架: Tauri
- 包管理器: pnpm
- 支持从国家中小学智慧教育平台下载电子课本与课程视频/课件（视频为加密流，自动解密，配置 ffmpeg 后合成 MP4）。
- 全局下载管理：点击下载即加入下载池统一调度，切换页面不影响下载；支持暂停/继续、失败重试、删除任务与清空记录。
- 断点续传：课件按字节续传、视频按已下载切片续传；应用重启后未完成任务标记为「已中断」，可一键继续。
- 支持批量下载与按分类保存。
- 应用内自动更新：启动时静默检查新版本，一键下载安装；GitHub 访问受限时可在设置中配置更新源镜像。
- Node.js (推荐 LTS 版本)
- Rust (Tauri 框架需要)
- 构建 Tauri 应用所需的其他依赖项 (详见 Tauri 官方文档 - Prerequisites)
- 克隆仓库到本地：
git clone https://github.com/alterem/knowledge-grab cd knowledge-grab - 安装项目依赖：
pnpm install
- 启动 Tauri 开发模式。这会同时启动前端开发服务器和 Rust 后端：
应用程序窗口会打开，前端代码修改会实时反映。
pnpm tauri dev
- 确保你已经安装了所有依赖 (见上一步)。
- 运行 Tauri 构建命令：
这个命令会构建前端项目并将 Rust 后端编译成可执行文件，生成对应操作系统的安装包或可执行文件。构建好的文件通常在
pnpm tauri build
src-tauri/target/release/bundle/目录下。
Q: 在 macOS 上下载的应用无法直接打开，提示“无法验证开发者”或类似错误怎么办？
A: 这是 macOS 的 Gatekeeper 安全机制导致的。应用未经过 Apple 的开发者认证，首次打开可能会被阻止。可以在终端执行以下命令来允许应用运行：
xattr -rd com.apple.quarantine /Applications/KnowledgeGrab.app请根据实际安装路径修改 /Applications/KnowledgeGrab.app。执行此命令后，应该就能正常打开应用了。
Q: 下载时出现 403 / 401 错误，或提示需要 Access Token 怎么办？
A: 平台已改版，电子课本资源迁移到了需要登录鉴权的服务器，下载教材必须提供有效的 Access Token（登录凭据）。请进入应用「设置」页：
- 点击「登录平台自动获取」，在弹出的官方登录窗口完成登录，应用会自动抓取并保存令牌；
- 或点击「查看手动获取步骤」，按提示在浏览器控制台运行脚本，复制令牌后手动填入。
令牌仅保存在本机，约一周过期，失效后按同样方式重新获取即可。下载中途令牌失效时，剩余任务会自动暂停，更新令牌后在「下载管理」中继续即可（已下载的部分不会浪费，续传接着下）。
Q: 应用内检查更新失败或下载更新很慢怎么办？
A: 更新包托管在 GitHub Releases，部分网络环境访问受限。可以在「设置 → 关于与更新 → 自定义更新源」填入镜像加速地址（latest.json 的完整 URL），例如：
https://gh-proxy.com/https://github.com/alterem/knowledge-grab/releases/latest/download/latest.json
也可以直接前往 Releases 页面 手动下载安装包。
欢迎提交 Issue 或 Pull Request。
本项目采用 MIT 许可协议。
