mesalogo
dc8f86ff3e
Version checks and downloads previously depended on GitHub Release. About & Updates now offers GitHub or a validated mirror source, keeps the selector beneath the startup-check switch, and disables it when startup checks are off. The website resolves platform downloads from a bounded OSS release index with a GitHub fallback. Tagged releases publish and verify immutable OSS assets through OIDC before switching the latest-version index; deployment requires the configured Alibaba Cloud environment variables and role. Release note: “关于与更新”新增 GitHub 与镜像节点选择，启动检查、手动检查和下载页使用同一可信来源；官网下载也可按系统、架构和安装包类型直接选择。
66 lines
2.7 KiB
Markdown
66 lines
2.7 KiB
Markdown
# GoodBuddy 静态官网
|
||
|
||
`sites` 是无需构建步骤或额外依赖的静态官网源码，可直接托管整个目录。
|
||
|
||
正式站点地址：<https://mesalogo.github.io/goodbuddy/>
|
||
|
||
首页将 GoodBuddy 定位为“桌面助手｜AI 编程工具台”，优先展示三大桌面
|
||
系统与双架构下载入口、统一 Agent Runtime，以及知识库、魔法笔记、
|
||
智能心跳、桌面上下文和远程消息通道等桌面助手能力。下载区位于主要
|
||
功能说明之前，并明确列出统信 UOS、银河麒麟、海光、兆芯、鲲鹏和飞腾
|
||
对应的 Linux x64 / arm64 包。页面不重复设置底部下载推广区。
|
||
首屏产品界面默认正面展示，在精确指针设备上使用克制的 3D 倾斜、
|
||
柔和跟随光效和同步浮动标签；触屏设备保持静态布局，系统启用“减少动态
|
||
效果”时不运行该交互。
|
||
|
||
## 部署
|
||
|
||
`.github/workflows/pages.yml` 会在 `main` 分支中的官网文件发生变化后，
|
||
校验并部署整个 `sites` 目录。工作流也支持在 GitHub Actions 中手动运行。
|
||
|
||
首次部署前，需要在 GitHub 仓库的 **Settings > Pages** 中将 **Source**
|
||
设为 **GitHub Actions**。站点使用项目 Pages 地址，不需要 `CNAME` 文件
|
||
或自定义域名 DNS 配置。
|
||
|
||
## 本地预览
|
||
|
||
在仓库根目录运行：
|
||
|
||
```powershell
|
||
python -m http.server 4173 --bind 127.0.0.1 --directory sites
|
||
```
|
||
|
||
然后访问 <http://localhost:4173/>。也可以直接用浏览器打开 `sites/index.html`。
|
||
|
||
## 校验
|
||
|
||
```powershell
|
||
node sites/scripts/validate.mjs
|
||
node --check sites/app.js
|
||
```
|
||
|
||
校验脚本会检查必需文件、页内链接、本地资源、关键产品文案、主题与响应式
|
||
规则，以及下载选择器是否从受信任的正式发布索引加载并保留 GitHub
|
||
Release 回退入口。
|
||
|
||
## 下载入口
|
||
|
||
官网正文不写死版本号，页面启动后读取最新正式发布索引。
|
||
Windows、macOS 和 Linux 下载卡片分别提供处理器架构与安装包类型选择器，
|
||
选择后直接下载经过发布校验的不可变版本对象。发布索引请求失败、
|
||
格式无效或返回非受信任的官方下载地址时，按钮继续指向 GitHub 最新正式
|
||
Release：
|
||
|
||
```text
|
||
https://github.com/mesalogo/goodbuddy/releases/latest
|
||
```
|
||
|
||
## 文件
|
||
|
||
- `index.html`：页面结构与简体中文内容
|
||
- `styles.css`：语义令牌、浅深主题、焦点与响应式布局
|
||
- `app.js`：主题、移动导航和当前章节
|
||
- `assets/goodbuddy-light.png`、`assets/goodbuddy-dark.png`：由 `npm run icons` 与桌面应用同步生成的官方品牌图标
|
||
- `assets/linux-plain.svg`：Devicon v2.17.0 提供的黑白 Linux 图标，许可见 `assets/devicon-LICENSE`
|
||
- `scripts/validate.mjs`：无依赖静态检查
|