feat: 设置页新增「系统与更新」，按 GitHub 版本号检查更新
- 顶层 package.json 作为应用版本唯一来源（happy-export v1.0.0） - backend/lib/updater.js：查 GitHub Release（优先）或 tag，与本机版本做 semver 比对 - backend/routes/system.js：GET /api/system/info、GET /api/system/check-update（30s 缓存） - /api/health 版本号改为读真实版本 - 设置页新增第 4 个分类：当前版本 / 更新源仓库 / 检查更新（含更新说明折叠） - 新增 RefreshIcon
This commit is contained in:
Drsakura
@@ -0,0 +1,216 @@
|
||||
/**
|
||||
* happy 出口通 —— 系统版本检查
|
||||
*
|
||||
* 与 sku-manager 的 updater 不同，这里**只做检查，不做自动替换**：
|
||||
* happy 是整体应用（前端 dist + 后端服务 + 数据库），更新应当走
|
||||
* `git pull` + 重新构建 + 重启服务，而不是像 sku-manager 那样下载 zip
|
||||
* 换版本目录。所以本模块只负责回答一个问题：
|
||||
* 远端仓库的版本号 vs 本机版本号，谁新？
|
||||
*
|
||||
* 版本来源，按优先级：
|
||||
* 1. GitHub Releases 的 latest.tag_name —— 推荐用法（打 tag 并发 Release）
|
||||
* 2. 回退到 Tags 列表里最大的版本号 —— 只打了 tag 没发 Release 也能识别
|
||||
*
|
||||
* 默认仓库 Drsakura/happy-export，可用 HAPPY_UPDATE_REPO 覆盖（接私有仓库需另配 token）。
|
||||
*/
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
const APP_ROOT = path.join(__dirname, '..', '..');
|
||||
const DEFAULT_REPO = 'Drsakura/happy-export';
|
||||
const API_BASE = 'https://api.github.com';
|
||||
const TIMEOUT_MS = 8000;
|
||||
const USER_AGENT = 'happy-export-updater';
|
||||
|
||||
/* ---------------------------- 版本号处理 ---------------------------- */
|
||||
|
||||
/**
|
||||
* 把 "v1.2.3" / "1.2.3" / "1.2.3-beta.1" 解析成可比较的结构。
|
||||
* 不是合法 semver 就返回 null（宁可不报更新，也不误报）。
|
||||
*/
|
||||
function parseVersion(input) {
|
||||
const m = String(input == null ? '' : input)
|
||||
.trim()
|
||||
.replace(/^v/i, '')
|
||||
.match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/);
|
||||
if (!m) return null;
|
||||
return { nums: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] || '' };
|
||||
}
|
||||
|
||||
/** 清洗 tag：去掉 v 前缀与空白，返回标准化版本字符串或 null。 */
|
||||
function normalizeTag(tag) {
|
||||
const p = parseVersion(tag);
|
||||
return p ? p.nums.join('.') + (p.pre ? '-' + p.pre : '') : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* a > b → 1；a < b → -1；相等或无法解析 → 0。
|
||||
* 无法解析时返回 0 是刻意的：宁可说「已是最新」，也不要因为格式怪就误报更新。
|
||||
*/
|
||||
function compareVersions(a, b) {
|
||||
const va = parseVersion(a);
|
||||
const vb = parseVersion(b);
|
||||
if (!va || !vb) return 0;
|
||||
|
||||
for (let i = 0; i < 3; i += 1) {
|
||||
if (va.nums[i] !== vb.nums[i]) return va.nums[i] > vb.nums[i] ? 1 : -1;
|
||||
}
|
||||
if (va.pre === vb.pre) return 0;
|
||||
// 预发布版低于同号正式版：1.0.0-beta < 1.0.0
|
||||
if (!va.pre) return 1;
|
||||
if (!vb.pre) return -1;
|
||||
return va.pre > vb.pre ? 1 : -1;
|
||||
}
|
||||
|
||||
/** 当前应用版本。取自顶层 package.json —— 与应用清单同一个来源，避免两处版本号打架。 */
|
||||
function currentVersion() {
|
||||
const candidates = [
|
||||
path.join(APP_ROOT, 'package.json'),
|
||||
path.join(__dirname, '..', 'package.json')
|
||||
];
|
||||
for (const file of candidates) {
|
||||
try {
|
||||
const version = JSON.parse(fs.readFileSync(file, 'utf8')).version;
|
||||
if (version) return version;
|
||||
} catch {
|
||||
/* 读不到就试下一个候选 */
|
||||
}
|
||||
}
|
||||
return '0.0.0';
|
||||
}
|
||||
|
||||
/** 允许用户填 "owner/repo"、完整 URL、或带 .git 的地址；非法则返回 null。 */
|
||||
function normalizeRepo(repo) {
|
||||
const slug = String(repo == null ? '' : repo)
|
||||
.trim()
|
||||
.replace(/^https?:\/\/github\.com\//i, '')
|
||||
.replace(/\.git$/i, '')
|
||||
.replace(/\/+$/, '');
|
||||
return /^[^/\s]+\/[^/\s]+$/.test(slug) ? slug : null;
|
||||
}
|
||||
|
||||
/* ---------------------------- 网络请求 ---------------------------- */
|
||||
|
||||
function githubError(status) {
|
||||
if (status === 404) return '找不到仓库或版本，请检查更新地址是否正确（私有仓库需要额外配置访问令牌）';
|
||||
if (status === 401) return '访问令牌无效或已过期';
|
||||
if (status === 403) return 'GitHub 接口被限流（403），稍后再试';
|
||||
if (status >= 500) return `GitHub 服务异常（${status}），稍后再试`;
|
||||
return `GitHub 返回 ${status}`;
|
||||
}
|
||||
|
||||
/** 带超时的 GET。返回 { data } | { missing:true }（404）| { error }。 */
|
||||
async function getJson(url) {
|
||||
const controller = new AbortController();
|
||||
const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
|
||||
try {
|
||||
const resp = await fetch(url, {
|
||||
headers: { 'User-Agent': USER_AGENT, Accept: 'application/vnd.github+json' },
|
||||
signal: controller.signal
|
||||
});
|
||||
if (resp.ok) return { data: await resp.json() };
|
||||
if (resp.status === 404) return { missing: true };
|
||||
return { error: githubError(resp.status) };
|
||||
} catch (e) {
|
||||
const why = e.name === 'AbortError' ? '请求超时' : e.message;
|
||||
return { error: `连不上 GitHub（${why}），请检查网络后重试` };
|
||||
} finally {
|
||||
clearTimeout(timer);
|
||||
}
|
||||
}
|
||||
|
||||
/* ---------------------------- 主流程 ---------------------------- */
|
||||
|
||||
/**
|
||||
* 检查是否有新版本。
|
||||
* 从不抛异常 —— 所有失败都以 { ok:false, error } 形式返回，方便前端直接展示。
|
||||
*/
|
||||
async function checkUpdate(repoInput) {
|
||||
const repo = normalizeRepo(repoInput) || DEFAULT_REPO;
|
||||
const current = currentVersion();
|
||||
const base = { repo, current, checkedAt: new Date().toISOString() };
|
||||
|
||||
// 1) 优先看 Releases
|
||||
const release = await getJson(`${API_BASE}/repos/${repo}/releases/latest`);
|
||||
if (release.error) return { ...base, ok: false, error: release.error };
|
||||
|
||||
if (release.data) {
|
||||
const tag = String(release.data.tag_name || '');
|
||||
const latest = normalizeTag(tag);
|
||||
if (!latest) {
|
||||
return { ...base, ok: false, error: `最新 Release 的标签不是版本号：${tag || '(空)'}` };
|
||||
}
|
||||
return {
|
||||
...base,
|
||||
ok: true,
|
||||
source: 'release',
|
||||
latest,
|
||||
tag,
|
||||
hasUpdate: compareVersions(latest, current) > 0,
|
||||
title: String(release.data.name || '').trim(),
|
||||
notes: String(release.data.body || '').slice(0, 2000),
|
||||
publishedAt: release.data.published_at || null,
|
||||
url: release.data.html_url || null
|
||||
};
|
||||
}
|
||||
|
||||
// 2) 没有 Release，回退看 Tags（只打 tag 也能识别更新）
|
||||
const tags = await getJson(`${API_BASE}/repos/${repo}/tags?per_page=100`);
|
||||
if (tags.error) return { ...base, ok: false, error: tags.error };
|
||||
if (tags.missing) return { ...base, ok: false, error: githubError(404) };
|
||||
|
||||
const list = Array.isArray(tags.data) ? tags.data : [];
|
||||
const versions = list
|
||||
.map((t) => normalizeTag(t && t.name))
|
||||
.filter(Boolean)
|
||||
.sort(compareVersions)
|
||||
.reverse();
|
||||
|
||||
if (!versions.length) {
|
||||
return {
|
||||
...base,
|
||||
ok: true,
|
||||
source: 'none',
|
||||
latest: current,
|
||||
hasUpdate: false,
|
||||
note: '远端仓库还没有版本标签（tag）。在 GitHub 上发布 v1.0.1 这类 Release 或 tag 后，这里就能检查到更新。'
|
||||
};
|
||||
}
|
||||
|
||||
const latest = versions[0];
|
||||
return {
|
||||
...base,
|
||||
ok: true,
|
||||
source: 'tag',
|
||||
latest,
|
||||
tag: latest,
|
||||
hasUpdate: compareVersions(latest, current) > 0,
|
||||
title: '',
|
||||
notes: '',
|
||||
publishedAt: null,
|
||||
url: `https://github.com/${repo}/releases/tag/${latest}`
|
||||
};
|
||||
}
|
||||
|
||||
/** 本机运行环境摘要，给设置页「系统与更新」展示用。 */
|
||||
function systemInfo() {
|
||||
return {
|
||||
name: 'happy 出口通',
|
||||
version: currentVersion(),
|
||||
repo: process.env.HAPPY_UPDATE_REPO || DEFAULT_REPO,
|
||||
node: process.version,
|
||||
platform: process.platform === 'win32' ? 'Windows' : process.platform,
|
||||
arch: process.arch,
|
||||
uptimeSeconds: Math.round(process.uptime()),
|
||||
startedAt: new Date(Date.now() - process.uptime() * 1000).toISOString()
|
||||
};
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
checkUpdate,
|
||||
currentVersion,
|
||||
systemInfo,
|
||||
compareVersions,
|
||||
normalizeRepo,
|
||||
DEFAULT_REPO
|
||||
};
|
||||
Reference in New Issue
Block a user