Autumn-27
44156a0a4c
系统配置页新增「版本与更新」卡片，顶栏版本号旁在有新版时亮出提示胶囊。 更新链路：下载发布包 → 比对 SHA256SUMS → -h 冒烟测试 → 暂存 artex.new → 以退出码 75 退出 → 守护脚本重新拉起并完成换装，页面轮询 /api/health 等版本号变化后自动刷新。 新增 start.sh / start.bat 作为正式启动入口，只按退出码决定是否重新拉起 （0 停止 / 75 应用新版 / 其余崩溃退避）。校验、冒烟、换装、回滚全部收在 selfupdate 包里而不写进脚本：这些逻辑在 sh 和 bat 上要写两套，而它们恰恰 最不能出错——换上跑不起来的二进制后守护进程会反复拉起它，只能上机器手工救。 Docker 的 ENTRYPOINT 一并改为该脚本，并由它转发 SIGTERM，否则 docker stop 只发给 PID 1，artex 做不了优雅关闭会被 SIGKILL 硬杀。 失败保护两道闸门互补：无法 exec 由换装前的冒烟挡住，能执行但初始化崩溃 由启动计数兜住（连续 3 次失败自动回滚 artex.old，坏的留作 artex.failed）。 GitHub 查询结果后端缓存 30 分钟（失败 2 分钟）。未认证 API 是每 IP 每小时 60 次，且这 60 次是服务器 IP 上所有用户共用的，顶栏每次整页加载都查一次， 不缓存会很快耗光配额导致真想更新时反而查不动。手动「检查更新」带 force=1 绕过缓存。 安全：只认 GitHub 域名且强制 HTTPS（逐跳校验重定向），发布源写死不可配置； 升级文件挂在可执行文件所在目录而非 CWD（服务化运行时 CWD 可能是 /）； 开发构建版本号不可比较，禁用一键更新。 走完整 zip 而非裸二进制，因为现有 Release 的 SHA256SUMS 只覆盖 zip， 这样无需改 CI，也兼容已发布的历史版本。 已知限制：Docker 下只换程序不换镜像（工具链不同步、重建容器会退回镜像 版本）；不同步发布包里的 skills/；更新即重启会中断运行中的任务。
59 lines
2.1 KiB
TypeScript
59 lines
2.1 KiB
TypeScript
"use client";
|
|
|
|
import * as React from "react";
|
|
|
|
import Link from "next/link";
|
|
|
|
import { ArrowUpCircleIcon } from "lucide-react";
|
|
|
|
import { api } from "@/lib/api";
|
|
|
|
/**
|
|
* 顶栏的"有新版本"提示：整页加载时查一次，有更新就在版本号旁边亮出来，
|
|
* 点击直达系统配置页的「版本与更新」卡片。
|
|
*
|
|
* 后端对 GitHub 的查询结果有 30 分钟缓存，所以这里每次挂载都查一次是安全的
|
|
* ——未认证的 GitHub API 只有 60 次/小时/IP，没有那层缓存的话，多开几个标签页
|
|
* 就会把配额耗光，之后真想更新反而查不动。
|
|
*
|
|
* 查询失败一律静默：顶栏不是报错的地方，用户进设置页点「检查更新」会看到原因。
|
|
*/
|
|
export function UpdateBadge() {
|
|
const [latest, setLatest] = React.useState("");
|
|
|
|
React.useEffect(() => {
|
|
let alive = true;
|
|
api
|
|
.checkUpdate()
|
|
.then((r) => {
|
|
// has_update 已经包含了"版本号可比较"的判断，开发构建不会亮这个提示。
|
|
if (alive && r.has_update && r.latest) setLatest(r.latest.replace(/^v(?=\d)/, ""));
|
|
})
|
|
.catch(() => {
|
|
// 静默：没网 / GitHub 限流都不该在顶栏弹错误。
|
|
});
|
|
return () => {
|
|
alive = false;
|
|
};
|
|
}, []);
|
|
|
|
if (!latest) return null;
|
|
|
|
return (
|
|
<Link
|
|
href="/system/settings"
|
|
title={`发现新版本 ${latest}，点击前往更新`}
|
|
className="inline-flex items-center gap-1.5 rounded-full bg-primary px-2.5 py-1 font-medium text-primary-foreground text-xs transition-opacity hover:opacity-90"
|
|
>
|
|
{/* 呼吸点：顶栏元素很多，纯文字容易被忽略，动效让它一眼可见。 */}
|
|
<span className="relative flex size-1.5">
|
|
<span className="absolute inline-flex size-full animate-ping rounded-full bg-primary-foreground opacity-75" />
|
|
<span className="relative inline-flex size-1.5 rounded-full bg-primary-foreground" />
|
|
</span>
|
|
<ArrowUpCircleIcon className="size-3.5" />
|
|
<span className="hidden sm:inline">新版本 {latest}</span>
|
|
<span className="sm:hidden">新版本</span>
|
|
</Link>
|
|
);
|
|
}
|