Super Productivity 全平台安装与下载指南：GitHub 发布版、软件仓库安装及常见问题排查
Super Productivity 全平台安装与下载指南GitHub 发布版、软件仓库安装及常见问题排查【免费下载链接】super-productivitySuper Productivity is an advanced todo list app with integrated Timeboxing and time tracking capabilities. It also comes with integrations for Jira, GitLab, GitHub and Open Project.项目地址: https://gitcode.com/GitHub_Trending/su/super-productivity导读本文以官方 Wiki 的「Downloads and Install」章节为核心系统梳理 Super Productivity 在 Windows、macOS、Linux 与 Android 全平台的安装路径既包括从 GitHub Releases 直接下载安装包也包括 Flathub、Snapcraft、Arch 官方仓库、F-Droid、Google Play、Microsoft Store、Homebrew、WinGet、Chocolatey、Scoop 等软件仓库安装方式并逐一解读 Snap、Flatpak、Wayland 下的已知问题与官方解决方案。读完本文你将能按平台选择最合适的安装方式并在遇到数据目录、GPU 启动失败、时区错位等典型问题时依据仓库源码定位并解决。一、直接从 GitHub Releases 下载Super Productivity 的每个正式版本都会发布到 GitHub Releases可直接下载对应平台与 CPU 架构的安装包无需任何软件仓库或包管理器。平台x64arm64x86Windows安装器Super-Productivity-Setup.exe便携版superProductivity.exe安装器arm64便携版arm64—Linux / AndroidsuperProductivity-x86_64.AppImagesuperProductivity-x86_64.rpmsuperProductivity-amd64.debAPKapp-play-release.apk—macOSDMGsuperProductivity-x64.dmgDMGsuperProductivity-arm64.dmg—注上表沿用了官方 Wiki 的发布产物命名。以仓库中的 electron-builder.yaml 为准Linux 产物实际包含 AppImage、deb、snap、rpm 四种格式macOS 除分架构 DMG 外还提供同时包含 x86_64 与 arm64 的 universal DMG见下文「Universal macOS DMG」小节。从源码的构建配置可以印证发布产物的形成方式应用名与产物命名规则定义在 electron-builder.yaml 的appId: superProductivity、productName: Super Productivity与artifactName: ${name}-${arch}.${ext}Windows 的 NSIS 安装器与 portable 便携版由win.target配置生成且刻意去掉了架构后缀以复用同一份安装包详见配置中关于签署配额与IsNativeARM64运行时选择的注释Linux 的linux.target同时配置了AppImage / deb / snap / rpm.deb与.rpm供 Debian/Ubuntu 与 Fedora 系使用macOS 的mac.target配置了arm64 / x64 / universal三种 DMG。为什么优先选 arm64 / x64 而不是 x86官方表格中 x86 列全部为「—」表示Super Productivity 已不再提供 32 位 x86 构建。原因可以从 electron-builder.yaml 看出Windows 目标仅配置arm64与x64Linux/macOS 同理。现代 Electron 应用与 Chromium 渲染内核均以 64 位为主力老旧的 32 位系统已不在支持范围内。二、通过软件仓库安装推荐对于桌面 Linux、macOS 与 Windows官方维护了多条软件仓库渠道便于与系统更新机制集成。下表汇总了各渠道与建议安装命令。[!CAUTION] 下表所列命令与超链接仅为便利而提供。切勿运行你不熟悉的命令或打开你不熟悉的链接请优先选择你信任的渠道如发行版官方仓库、应用商店。仓库 / 安装链接建议安装命令Flathubflatpak install flathub com.super_productivity.SuperProductivitySnapcraftsnap install superproductivityArch Linux官方 extra 仓库pacman -S super-productivityF-Droid无F-Droid 客户端内安装Google Play无商店内安装Homebrew CaskmacOSbrew install --cask superproductivityApp StoremacOS / iOS无商店内安装Microsoft StoreWindows无商店内安装WinGetWindowswinget install -e --id JohannesMillan.superProductivityChocolateyWindowschoco install super-productivity --preScoopWindowsscoop bucket add extras; scoop install extras/super-productivity各渠道要点解读Flathub / SnapLinux 桌面发行版覆盖最广的两个渠道均以沙箱方式运行数据隔离策略不同详见下文「数据持久化」小节Arch Linuxextra/super-productivity已进入官方仓库由 Arch 社区从源码构建维护取代了旧的 AUR 包superproductivity-binF-Droid / Google PlayAndroid 端两个官方分发渠道APK 同样可在 GitHub Releases 下载app-play-release.apkWinGet / Chocolatey / ScoopWindows 三种命令行安装方式其中 Chocolatey 目前因构建问题需要加--pre使用预发布版本见「Windows」小节Microsoft Store因证书签发问题官方 Wiki 明确推荐 Windows 用户优先使用 Microsoft Store。从源码可进一步确认运行时分发渠道的检测逻辑electron/shared-with-frontend/get-dist-channel.ts 通过环境变量区分win-nsis、win-portable、win-store、mac-dmg、mac-store、linux-appimage、linux-snap、linux-flatpak与linux-native九种渠道——例如 Snap 包内会设置$SNAPFlatpak 包内会设置$FLATPAK_IDAppImage 会设置$APPIMAGE。三、Linux 安装后的已知问题与解决3.1 Snap本地文件同步需要手动连接home接口Snap 采用 strict 严格沙箱默认无法读写home目录之外路径以及部分本地路径。若要使用本地文件同步Local File Sync需要手动连接home接口snap connect superproductivity:home仓库中的安装钩子 snap/hooks/install 会在安装时检测并提示连接home、system-observe、login-session-observe等接口其中login-session-observe与system-observe服务于空闲检测idle detectionhome服务于本地文件同步。同时 electron-builder.yaml 的snap.plugs还显式加入了removable-media允许同步到外接磁盘/USB并声明了confinement: strict、base: core22、grade: stable。3.2 Snap卸载时的数据持久化警告卸载 Snap 包时所有用户数据任务、项目、设置可能被一并删除。这些数据存放在~/snap/superproductivity/common/目录下。官方建议卸载前务必先导出数据设置 → 同步与导出 → 导出数据若希望数据位于标准的~/.config/目录可改用 AppImage 或.deb包若希望卸载时保留数据可改用 Flatpak数据存放在~/.var/app/卸载时默认保留除非显式传入--delete-data。从源码看Snap 数据目录的差异源于 electron/start-app.ts 中的专门处理当检测到process.env.SNAP与SNAP_USER_COMMON时应用会把 userData 目录重定向到$SNAP_USER_COMMON/.config/superProductivity目的是避免数据被 Snap 更新过程访问源码注释set userData dir to common data to avoid the data being accessed by the update process。这与常规 Linux 安装的~/.config/superProductivity/路径不同卸载后该目录是否保留由 Snap 决定因此才有上述警告。详细数据目录说明见 3.06-User-Data。3.3 Flatpak沙箱外的同步/备份目录需要授权Flatpak 是官方文档中完全受支持的安装方式与其它渠道地位等同从 Flathub 安装即可flatpak install flathub com.super_productivity.SuperProductivity但 Flatpak 沙箱有两个需要特别注意的点沙箱外目录的同步/备份权限若要把同步目标或备份目录放在沙箱外部必须授予文件系统访问权限可通过 Flatseal 或flatpak override完成。未授权时应用会报告权限错误。沙箱内部路径~/.var/app/com.super_productivity.SuperProductivity/无需额外授权。数据与其它安装格式不互通数据保存在沙箱内而非~/.config/因此另一份不同格式的安装如 AppImage、.deb看不到这份数据。需要跨安装格式迁移时请走「导出 → 导入」流程而不是并排安装两份。更新无需sudoflatpak update com.super_productivity.SuperProductivity3.4 Flatpak应用内时钟偏离 UTC 偏移时区问题若 Flatpak 沙箱未能检测到宿主机时区应用会以 UTC 运行表现为日程视图Schedule的「当前时间」指示器位置错误、时间整体偏移更关键的是——应用依据本地时钟推导「今天」时区偏移会连带影响日切换day rollover导致临近午夜的定时任务与提醒落到错误的一天。解决办法是显式覆盖TZ环境变量flatpak override --user --envTZEurope/Helsinki com.super_productivity.SuperProductivity将Europe/Helsinki替换为你自己的时区。NixOS 用户的根因在宿主机侧Flatpak 通过读取/etc/localtime符号链接的目标来获取时区而 NixOS 将其指向/etc/zoneinfo/…而非/usr/share/zoneinfo/…且不存在可供 Flatpak 回退的/etc/timezone。在configuration.nix中追加以下配置可一次性修复所有 Flatpak 应用的时区问题environment.etc.timezone.text config.time.timeZone;3.5 AppImageUbuntu 下的启动问题如果在 Ubuntu 上使用 AppImage 遇到问题官方指向了对应的 issue 评论区issue #3193获取说明。AppImage 为免安装的单文件分发数据存放于标准~/.config/目录是希望在卸载时保留数据的用户的一个不错选择。3.6 Arch Linux从 AUR 旧包切换到官方包Super Productivity 现已在 Arch 官方仓库中即extra/super-productivity由 Arch 维护者从源码构建pacman -S super-productivity旧 AUR 包superproductivity-bin重新打包的 .deb已不再由本项目维护。若你之前安装过它切换命令为pacman -S super-productivity # 会提示移除与之冲突的 superproductivity-bin切换过程中~/.config/superProductivity/中的数据会被保留。四、Wayland 会话下的渲染问题与 GPU 排障这是 Linux 桌面端最值得深入的一节。Snap 构建在 Wayland 会话下会自动使用 Electron 的 X11 渲染后端以避免已知的 Mesa/EGL 启动失败。对于其它 Linux 发行包如果窗口空白或 GPU 进程反复启动失败可以尝试# 切换 Chromium 渲染后端为 X11 superproductivity --ozone-platformx11注意该参数只改变 Chromium 的渲染后端不会启用任何额外的空闲检测功能并可能放弃 Wayland 原生行为如分数缩放、原生输入法支持。如果窗口仍然不出现可彻底禁用 GPU 加速SP_DISABLE_GPU1 superproductivity环境变量的优先级关系是SP_ENABLE_GPU1强制重新开启 GPU 加速且优先于SP_DISABLE_GPU。4.1 自动崩溃恢复.gpu-launch-incomplete标记在 Snap 和 Flatpak 上应用还会自行执行 GPU 崩溃恢复当某次启动未能完成启动流程时下一次启动会自动在无 GPU 加速状态下运行并记录原因。若需手动清除该状态请删除用户数据目录下的.gpu-launch-incomplete文件用户数据目录见 3.06-User-Data。这一机制的源码实现位于 electron/gpu-startup-guard.ts其原理值得展开说明启动时若处于 Snap/Flatpak 沙箱$SNAP或$FLATPAK_ID存在主进程会在 userData 目录写入内容为{ ts, electronVersion }的标记文件.gpu-launch-incomplete当应用收到IPC.APP_READYAngular 前端完成启动信号时调用markGpuStartupSuccess()删除该标记因此残留的标记文件意味着上一次启动没有完成引导——在沙箱场景下极可能是 GPU 进程初始化失败如 Snap core22 运行时与 Mesa/libgbm 的 ABI 漂移、沙箱内缺少 DRI 节点判定「上次崩溃」有两个保护条件标记时间在 5 分钟STALE_THRESHOLD_MS内且记录的 Electron 版本与当前版本一致避免挂起/SIGKILL 或升级残留导致的误判判定为崩溃后electron/start-app.ts 会追加--disable-gpu与--disable-software-rasterizer两个开关并叠加--ozone-platformx11必须位于所有app.setPath(userData, ...)调用之后因为标记文件就存放在 userData 目录。4.2 Snap 的 argv 级 X11 注入wrapper 机制在 Snap Wayland 场景下仅靠主进程内app.commandLine.appendSwitch(ozone-platform,x11)并不总能生效。仓库通过打包钩子 tools/afterPack.js 实现了argv 级注入打包时把真正的 Electron 二进制改名为superproductivity-bin在原位置放一个 shell 包装脚本build/linux/snap-wrapper.sh在 Electron 启动之前把--ozone-platformx11塞进 argv。这与 Signal Desktop、Mattermost Desktop 的 Snap 采用同一机制根因分析记录在 docs/research/snap-wayland-gpu-fix-research.md。该机制有四个关键性质argv 级生效标志位在 Chromium 解析命令行之前就已存在绕开了appendSwitch在 C 主进程PreEarlyInitialization之后写入、无人再读的结构性问题仅作用于自家 Snap Wayland包装脚本以$SNAP_NAME superproductivity为门槛从其它 snap 的xdg-open启动的 .deb/.rpm 安装$SNAP会泄漏到子进程环境不会受影响X11 会话与非 Snap 目标则直接透传用户覆盖优先若 argv 已带--ozone-platform...则不再注入兼容app.relaunch()重启时execPath指向包装脚本而非改名的 ELF注入不会丢失。4.3 哪些控制台报错可以忽略以下报错本身并不代表失败Failed to get system egl display MESA-LOADER: failed to open … Exiting GPU process due to errors during initializationChromium 会回退到软件渲染应用依然正常运行。只有在窗口确实没有出现时这些日志才值得报告。五、macOSUniversal DMG 与安装提示除分架构的superProductivity-x64.dmg与superProductivity-arm64.dmg外官方还提供了同时包含 x86_64 与 arm64 两种架构文件的 Universal DMGsuperProductivity-universal.dmg可在任意 Apple Silicon 或 Intel Mac 上直接安装。macOS 用户还可以通过 Homebrew Caskbrew install --cask superproductivity或 App Store 安装。macOS 的构建配置硬运行时、公证notarize: true、darkModeSupport 等见 electron-builder.yaml 的mac段。六、Windows推荐 Microsoft Store官方文档明确指出由于证书签发问题Windows 端推荐使用 Microsoft Storeapps.microsoft.com搜索 Super Productivity 即可。这可以省去处理 SmartScreen 拦截、证书信任等环节。若偏好命令行安装可按需选择# WinGet推荐与系统更新集成 winget install -e --id JohannesMillan.superProductivity # Chocolatey注意目前官方构建存在问题必须使用 --pre 预发布 choco install super-productivity --pre # Scoopextras bucket scoop bucket add extras scoop install extras/super-productivity值得注意的是Windows Store 构建版的数据目录可能与安装版不同若 Windows 对该包做了虚拟化其AppData写入会被重定向到Local\Packages\...\LocalCache\Roaming否则写入普通的Roaming路径。设置界面会显示实际存在的那个路径请以应用内显示为准详见 3.06-User-Data。七、数据目录速查与备份提醒无论通过哪种渠道安装理解数据存放位置对「安装 → 迁移 → 卸载」都至关重要。桌面端默认位置如下平台默认数据目录macOS~/Library/Application Support/superProductivity/WindowsC:\Users\用户名\AppData\Roaming\superProductivity\即%APPDATA%\superProductivityLinux~/.config/superProductivity/SnapLinux$SNAP_USER_COMMON/.config/superProductivityFlatpakLinux~/.var/app/com.super_productivity.SuperProductivity/config/superProductivity/如果希望使用自定义数据目录可用启动参数superproductivity --user-data-dir/path/to/my/data该参数的解析位于 electron/start-app.ts会剥离尾部斜杠并通过app.setPath(userData, customUserDir)生效。自动备份文件存放于{userData}/backups/采用YYYY-MM-DD_HHmmss.json命名。更完整的目录结构styles.css主题文件、local-rest-api-token、IndexedDB 数据库清单等见 3.06-User-Data。八、安装完成后的下一步首次使用参考 1.01-First-Steps 快速上手任务、计时与收尾流程配置数据同步参考 1.02-Configure-Data-Synchronization 与 2.08-Choose-Sync-Backend 选择 WebDAV、Dropbox、SuperSync 等后端从备份恢复参考 2.02-Restore-Data-From-Backup自行打包若需要定制构建可用npm run dist前提是已按 2.11-Run-the-Development-Server 搭好开发环境构建与打包细节见 2.12-Package-the-AppAndroid 端构建见 2.14-Build-for-Android。小结安装方式速选表使用场景推荐渠道想跟随官方最新版、离线分发GitHub Releaseselectron-builder.yaml 对应产物Ubuntu/Fedora 等主流桌面 LinuxFlatpak 或 Snap二选一注意数据目录差异Arch/Manjaropacman -S super-productivity官方 extra 仓库希望卸载后保留数据AppImage / .deb~/.config或 Flatpak~/.var/app默认保留Android 手机/平板F-Droid、Google Play 或 GitHub Releases APKmacOSDMG含 Universal 版、Homebrew Cask 或 App StoreWindowsMicrosoft Store首选、WinGet、Scoop 或 NSIS 安装器Wayland 下窗口空白--ozone-platformx11仍无效则SP_DISABLE_GPU1【免费下载链接】super-productivitySuper Productivity is an advanced todo list app with integrated Timeboxing and time tracking capabilities. It also comes with integrations for Jira, GitLab, GitHub and Open Project.项目地址: https://gitcode.com/GitHub_Trending/su/super-productivity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考