企业官网建设流程全解析

如何按平台下载 Buzz 桌面端预构建包（dmg/AppImage/deb/exe）并处理 Windows 未签名首启提示

【免费下载链接】buzzA hive mind communication platform项目地址: https://gitcode.com/GitHub_Trending/buzz14/buzz

如果你不想从源码构建 Buzz（Tauri + React 的自托管协作工作区，人与 AI agent 在同一 relay 上协作），而是想直接安装桌面客户端，那么任务就是：在项目的 latest release 里按自己的操作系统和 CPU 架构挑对安装包，完成安装与首次启动，并在 Windows 上处理因构建未签名而触发的 SmartScreen 提示。Buzz 的 OSS 桌面端提供四种预构建产物：macOS 的.dmg、Linux 的.AppImage与.deb、Windows 的.exeNSIS 安装器。

下载前：确认自己的系统与架构

选包之前先确认两件事：操作系统和 CPU 架构。

• macOS：打开 Apple 菜单 > About This Mac。显示 “Chip: Apple …” 说明是 Apple Silicon，显示 “Processor: Intel …” 说明是 Intel。
• Windows：Buzz 只发布 x64 的 Windows 包。
• Linux：Buzz 只发布 x86_64 的包。

架构判断错会导致下载错误的产物，例如 Intel Mac 下载了_aarch64.dmg。

从 latest release 选取安装包

下载入口是项目仓库的latest release（README.md 的 “I just want to try the app” 一节）。打开该 release 后，按以下文件名模式匹配你的平台：

<version>是占位符，替换成该 release 实际的版本号即可，例如 Windows 安装器会形如Buzz_0.4.9_x64-setup_alpha-unsigned.exe。

两点判断依据来自 RELEASING.md 的 Platform Support 一节：

• 两个 macOS DMG（Apple Silicon 的darwin-aarch64与 Intel 的darwin-x86_64）都经过代码签名和公证，并挂在同一个desktop-v<version>release 下；Intel 用户下载_x64.dmg。
• 用户可见的安装器发布在desktop-v<version>这个版本化 release 中；buzz-desktop-latest是自动更新用的滚动 release，其latest.json只通过手动 promotion 工作流变更。下载安装包时认准版本化 release 里的资产即可。

按平台安装与首次启动

macOS

签名且已公证的 DMG：打开后按常规方式安装。README 未描述额外限制。

Linux（AppImage 或 .deb）

两个产物二选一。选 AppImage 时注意 RELEASING.md 明确给出的运行前提：

• 需要GLib >= 2.72（Ubuntu 22.04 或更新版本）；
• AppImage 依赖宿主系统的 Wayland/GStreamer/图形栈，而不是自带。

之所以这样设计：发布流程会用 desktop/scripts/fix-appimage.sh 后处理 AppImage，剥离 linuxdeploy 过度打包的基础库（这些库在 Mesa 25+ / GLib 2.88 的发行版上会崩溃）并重新签名。如果你的发行版 GLib 低于 2.72，官方文档没有给出替代方案。

Windows：未签名首启提示

Windows 包是有意未做代码签名的 NSIS 安装器——文件名中的_alpha-unsigned就表示这一点，RELEASING.md 也将它描述为 “unsigned Windows x64 NSIS installer”。因此首次启动时，SmartScreen 可能显示 “Windows protected your PC”。

处理方式是 README.md 给出的原流程：

1. 如果弹出该提示且界面提供入口，点击More info；
2. 再点击Run anyway。

这不是故障；只要接受这个未签名状态即可。文档没有提到其他处理方式。

启动后：把应用指向一个 relay

首次启动后，应用默认连接ws://localhost:3000。三种情况对应 README 给出的操作：

• 要连接自己运行、或他人分享给你的 relay：启动前设置环境变量BUZZ_RELAY_URL，或从应用内切换 relay；
• 本地还没有 relay：README 指向 “Build & run from source” 一节，走just setup && just build的本地开发栈（需要 Docker 与 Hermit，或 Rust 1.88+、Node 24+、pnpm 10+、just），让 relay 跑在ws://localhost:3000上，桌面应用随后即可连上。

判断是否连上：本地开发栈按 README 的描述，relay 起在ws://localhost:3000时桌面应用会直接弹出并进入工作区。

可选分支：下载当前 main 的 Apple Silicon 测试构建

如果你要测试的是main分支当前状态而不是已发布版本，RELEASING.md 提供了Signed macOS Canary手动工作流（仅接受main分支，仅 Apple Silicon 产物）：

gh workflow run signed-macos-canary.yml --repo block/buzz --ref main

工作流会派生一个-test.<run-number>版本号，对 DMG 签名、公证并用 Gatekeeper 校验，然后作为短时 Actions 资产上传。构建完成后从已完成的 run 下载资产，<run-id>换成该 workflow run 的 ID，<artifact-name>换成 run 资产列表里的名称：

gh run download <run-id> --repo block/buzz --name <artifact-name>

两个限制必须留意：资产保留期为7 天；因为这是公开仓库，只要资产还存在，任何登录的 GitHub 用户都能下载——它是“未公开”，不是私有。该工作流没有 release 权限、不创建或移动 tag，也不能用于分发用途的构建；可分发的构建仍走上面的版本化 release。

边界与不支持项

• Linux ARM64 没有预构建包：README 的平台表只覆盖 x86_64，Linux 产物只有_amd64.AppImage与_amd64.deb。
• Windows 没有签名版本：未签名是当前发布方式的固定属性，SmartScreen 提示按上节的 More info / Run anyway 处理。
• Block 内部用户不适用本文路径：内部构建从squareup/buzz-releases仓库下载，预配置了内部 relay 与 agent provider，与 OSS release 路径相互独立。
• AppImage 的低版本发行版：GLib < 2.72 的系统没有文档给出的替代方案；.deb包没有单独的平台限制说明。

下载完成后，验证落在两点：文件名与你的平台架构匹配（对照上表），以及应用启动后能按BUZZ_RELAY_URL或默认地址连上目标 relay。若 release 页面上找不到对应架构的文件，说明该 release 的平台构建任务可能未完成——RELEASING.md 对自动更新场景的排查建议是检查 workflow run，同样的思路适用于版本化 release 的资产缺失。

【免费下载链接】buzzA hive mind communication platform项目地址: https://gitcode.com/GitHub_Trending/buzz14/buzz