一个启动器如何撑起一个工具矩阵:craft-launcher 的产品逻辑拆解

原创2026-10-12 19:11:291,687 阅读
文章标签:桌面应用跨平台WebAssembly

一个启动器如何撑起一个工具矩阵:craft-launcher 的产品逻辑拆解

"装十个软件,就要逛十个发布页、做十次平台选择、再手动盯着十个版本号有没有更新"——这是每个多应用生态都要面对的经典困境。当一套工具矩阵里的应用从个位数增长到两位数,入口体验就会成为用户留存与分发效率的双重瓶颈。ArtCraft 团队给出的答案是 craft-launcher:一个用纯 Rust 编写的原生启动器,统一安装、更新并启动 Craft App Suite 的全部 12 款创意工具,同时把同样的目录逻辑编译成 WebAssembly 投放到浏览器。本文不讨论它"有多好用",而是从源码出发,拆解这款启动器如何在"入口 → 分发 → 安装 → 常驻 → 自更新"五层结构上,把一个多应用生态组织成一个可运营的有机整体。

入口问题:当"应用太多"成为产品负担

Craft App Suite 是一个不断扩张的工具家族:PhotoCraft(图像编辑)、VectorCraft(矢量插画)、FilmCraft(视频剪辑)、LightCraft(照片管理与 raw 处理)、PdfCraft(PDF 阅读与保护)、EffectCraft(动效合成)、DesignCraft(排版出版)、WordCraft(文档)、DeckCraft(演示)、GridCraft(表格)、CADCraft(CAD)、SoundCraft(音频),每一款都由 ArtCraft 团队从零用 Rust 重写、独立发布、独立迭代。它们各自开仓库、各自发 release、各自维护多平台构建产物——"独立"意味着自由,但也意味着用户要为每个应用重复执行同一种低价值动作:找对平台、下载、校验、安装、记版本。

启动器首先是一层统一的目录层。在 catalog.rs 中,整个工具矩阵被建模为一个常量数组 SUITE: [CraftApp; 12],每条记录声明了机器名、显示名、tagline、灵感来源(如 "Adobe Photoshop")、所属世代(Classic 七个 / New 五个)、品牌色、GitHub 仓库地址,甚至兼容旧名(PdfCraft 曾以 PrintCraft 发布,former_ids 记录了这段历史):

pub const SUITE: [CraftApp; 12] = [
    app("photocraft", "PhotoCraft", "Image editing", "Adobe Photoshop", AppGroup::Classic, …, "storytold/photocraft"),
    app("vectorcraft", "VectorCraft", "Vector illustration", "Adobe Illustrator", AppGroup::Classic, …, "storytold/vectorcraft"),
    // …
];

值得注意的工程决策是:目录是数据,不是硬编码的分支逻辑。注释明确写着 "The list is data so a later version can fetch it from an API"。也就是说,启动器当前内置一份静态目录,但数据结构的形态从一开始就为远程下发预留了空间——工具矩阵的增删(比如未来加入第 13 个应用)不需要改代码,只需要改数据源。

入口的另一个核心价值是状态机。界面上一张卡片显示什么,取决于 status.rs 里一个纯净的纯函数 status(installed, latest):它把"本机装了什么"(安装来源、版本、路径)与"远端发布了什么"(最新版本、是否有本平台资产)两个输入折叠成七种可显示状态——Available、UpToDate、UpdateAvailable、Unavailable、NoRelease 等。这正是"统一管理"的抽象收益:无论应用来自哪个渠道、处于什么生命周期,UI 只需要面对一张有限状态表。

ArtCraft Launcher 的网格视图:每个 Craft App 一张卡片,展示图标、安装状态、版本、发布日期与安装/打开按钮,并按 Classic 与新应用分组

分发层:把"选对安装包"这种脏活接过去

如果入口只是把 12 个 GitHub 发布页链接排成一排,那它几乎没有存在价值。启动器的真正重活在于为每个用户选对安装包。GitHub release 上每个应用都挂着一长串产物:.msi、-portable.zip、.dmg、.AppImage、.deb、.rpm、.flatpak、.tar.gz,还要乘以 x64/x86/arm64/riscv64 四种架构。人眼挑选极易出错,而 platform.rs 把这件事做成了确定性算法。

核心是两个纯函数:parse_asset_name 解析文件名(<stem>-<version>-<os>-<arch><a href="https://link.gitcode.com/i/1c70b465c25b00057a16da0b48af52ad" target="_blank">-portable].<ext>),pick_asset 按"包格式优先级 × 平台 token 优先级"双重排序选出最佳资产。最有意思的是模拟运行的回退策略:Windows on ARM 没有原生 MSI 时,会依次尝试 windows-arm64 → windows-x64 → windows-x86;macOS 优先 universal 构建;Linux 则按发行版家族([distro.rs 读取 /etc/os-release 的 ID 与 ID_LIKE)决定用 apt 装 .deb 还是用 dnf/zypper 装 .rpm:

fn tokens(self) -> &'static [&'static str] {
    match (self.os, self.arch) {
        (Os::Windows, Arch::Arm64) => &["windows-arm64", "windows-x64", "windows-x86"],
        (Os::MacOs, _) => &["macos-universal", "macos-aarch64", "macos-arm64", "macos-x86_64"],
        // …
    }
}

分发不只是"选对文件",更是信任校验。启动器把网络上的任何内容都当作敌对输入:release.rs 会过滤掉所有不指向 github.com/<repo>/releases/download/ 前缀的资产 URL,拒绝路径穿越(..)、控制字符和非法文件名;install.rs 中每一次下载都要先拿到该 release 的 SHA-256 校验和——优先用 GitHub 提供的 digest,否则抓取发布页随附的 SHA256SUMS.txt 逐行比对,校验通过后才进入安装阶段,断点续传的临时文件也会在下一轮被重新校验。这套"下载即验证"的管线,是启动器敢替用户执行安装的前提。

安装哲学:借力而非替代系统包管理器

启动器的产品定位在这里出现关键分叉:它选择不做一个"自成一派"的安装器,而是让每个应用以系统原生的方式落地。README 中列出了明确的安装位置约定——macOS 拷贝签名公证过的 .app 到 /Applications,Windows 走 Windows Installer(msiexec)进 Program Files,Linux 优先发行版原生 .deb/.rpm 并借助 polkit 弹出系统密码框,FreeBSD 则落树到 /usr/local。

这带来两个重要后果。第一,启动器安装的应用与用户手动安装的应用完全等价,系统软件中心、开始菜单、Spotlight 都能识别它们。第二,检测逻辑 detect.rs 必须逆向覆盖所有来源——不仅读启动器自己的 manifest 记录,还要扫描 macOS 的 Info.plist、Windows 注册表 Uninstall 项(含 32/64 位两视图)、Linux 的 dpkg/rpm/pacman/Flatpak 包列表、~/Applications 与 ~/AppImages 等常见目录里的 AppImage,甚至对 PATH 上的裸二进制做 --version 探测。InstallSource 枚举(Launcher/MacApp/Msi/Deb/Rpm/Pacman/Flatpak/AppImage/Binary)把"这个副本是谁装的"记录得明明白白,并据此决定谁能替换它:launcher_can_update() 只对 Launcher、MacApp、Msi、AppImage 返回 true,系统包管理器拥有的副本交由包管理器更新,AUR 安装的还会提示用户用 yay -S 自行升级。

另一个细节体现了对真实系统的敬畏:queue.rs 实现了一个全局安装器串行队列。apt、dnf、Windows Installer 都持有系统级锁,并发安装必然失败,所以启动器让等待中的任务排队,并让等待同一命令的任务合并成一次调用——一次密码提示同时处理多个 .deb,避免用户被反复弹窗。这类"与操作系统共存"的设计,正是工作台式启动器区别于传统安装向导的地方。

表格视图下同一个目录:列出每个应用灵感来源、安装状态、已装版本、最新版本与发布日期,支持排序

常驻与自更新:让工具矩阵"自己长大"

启动器把日常状态管理做成了后台任务而不是一次性动作。桌面版可以常驻系统托盘/菜单栏(tray.rs 的配套模块):窗口可关闭到托盘继续静默检查更新,托盘 tooltip 会显示"n updates available",通知系统在发现新版本时弹窗提醒,甚至支持开机自启与 macOS 的"跟随当前桌面"行为。

更新检查在架构上做了双通道容灾。默认先请求 ArtCraft 官方 release feed(feed.rs,由 storyteller-web 统一轮询 GitHub,规避未认证 API 每小时 60 次的配额),feed 里每个条目都有 fetched_at 时间戳,超过 24 小时视为过期回退 GitHub;feed 不可达、未收录、字段类型错误时同样降级。source.rs 层的设计文档点明了层级:Feed → GitHub API → GitHub release 页面 → 本地缓存,层层兜底,且每次降级都在 UI 页脚如实标注数据来源。

最体现"启动器也是矩阵一员"的设计是自更新。self_update.rs 把启动器自身描述成一个 CraftApp(LAUNCHER 常量在 catalog.rs 中复用同一套资产命名规范 artcraft-launcher-<ver>-…),于是启动器更新自己与更新任何应用共用同一套下载、校验、安装管线。替换策略严格跟随安装形态:macOS 从新 DMG 覆盖旧 .app、Windows 用新 MSI 重装回原目录、AppImage 则先复制一份再 rename 覆盖(运行中的副本继续工作)。旧进程退出后,由一个小助手进程等待并启动新版本;just_updated_to 还会写一个 24 小时的豁免标记,防止"更新完又被提示更新"的循环。

同一套 Rust,桌面与 Web 两副面孔

这套启动器最有意思的产品实验在于它的 Web 形态。web.rs 把同一个 egui UI、同一份目录与版本解析逻辑编译成 WASM 放进浏览器:页面直接调用 GitHub REST API(跨域允许)读取各应用最新 release,并通过 UA 探测访客的 OS 与 CPU,给出"针对这台机器"的下载按钮。它无法安装应用,于是 Capabilities { manage_apps: false, self_update: false } 让 UI 自动切换到"仅下载"模式——能力声明驱动界面形态,桌面版和 Web 版共享同一套 UI 代码,只是后端能力不同。

分发方式也颇为克制:packaging/web/README.md 说明整个产物是一个纯静态目录,index.html + 带内容哈希的 .js/.wasm,可以部署到任何静态托管、任意路径前缀甚至 iframe 嵌入,还限定了 wasm 不得超过 24 MiB 以适配 Cloudflare Pages 的 25 MiB 单文件上限。这份"零后端"的克制,让 Web 版可以作为纯粹的分发目录页独立存在于工具矩阵之外。

对比:它是"应用商店",还是"工作台"?

把上述机制放在一起,能回答文章标题的问题:craft-launcher 的产品形态更接近工作台(workbench)而非应用商店(app store)。

应用商店的核心是交易撮合:它需要账号体系、支付闭环、应用审核、评分评论、装机量分成,用户在其中消费的是"发现与购买"的体验。craft-launcher 刻意缺席了这一切——没有账号、没有结算、没有评分,代码中连支付、订阅之类的概念都不存在。

工作台的核心是工具链协调:它服务的是"我认定了这套工具"的深度用户,价值不在于发现,而在于把多应用环境的隐性成本降到最低——选包、校验、安装、更新、启动、自更新的全套生命周期管理。启动器把每个应用"像系统原生应用一样"安置好,然后退居托盘,用通知驱动用户而非用商店页面留住用户。Web 版则承担工作台的"展示面"角色:不装软件也能浏览整个工具矩阵与版本状态,扫码式的轻触入口把不常驻的用户也纳入目录覆盖。

这种选择与工具矩阵的性质高度自洽:Craft App Suite 是同一团队、同一语言、同一风格体系的封闭家族,应用之间天然共享发布规范(统一资产命名、统一 SHA256SUMS.txt、统一 bundle id 前缀 ai.storyteller.),启动器与应用的协同成本极低;而应用商店解决的是异构第三方应用的撮合问题,两者面对的组织复杂度完全不同。craft-launcher 的"窄而深",正是对工具矩阵这类场景的诚实回应。

结语:入口即基础设施

回到最初的问题——一个启动器如何撑起一个工具矩阵?答案藏在它的架构分层里:以数据目录(catalog)定义矩阵,以确定性算法(platform/release)消解分发复杂度,以原生安装哲学换取系统兼容性,以双通道 feed 与常驻托盘实现持续服务,再以自更新让基础设施本身保持新鲜。它不试图成为生态的中心,而是让自己成为最薄、最可靠的承重层——矩阵越扩张,这类入口的价值越是被放大。对于任何正在构建多应用生态的团队,craft-launcher 提供的不仅是一套可运行的代码,更是一份值得对照的产品设计清单。

登录后查看全文
craft-launcher