Files
xiaoyin-markdown/tools/release/publish.py
T
Jidekin 44335d02f2 feat(update): 在线升级 —— 界面一键检查版本、自动覆盖安装并重启
老板要求:软件里点「在线升级」校验版本号,直接在线覆盖安装、重启;
升级服务放在 https://md.wangjinding.com。

一、服务端(md.wangjinding.com)
  · 升级清单 GET /update/latest.json(nginx 单独 location,强制 no-store,带 CORS)
      { version, notes, pub_date, platforms.windows-x86_64: { signature, url, size, sha256 } }
  · 安装包走现有 /download/;另加稳定别名 latest-setup.exe / latest-portable.exe
    —— 官网页固定链到别名,以后发版不用改 HTML
  · tools/release/publish.py:一条命令完成「拷安装包 → 写清单 → 更新别名 → 打校验值」
  · 官网页的版本号改成从 latest.json 拉(data-ver),发版后自动跟随

二、客户端(Tauri updater 官方插件,不是自己下 exe 硬跑)
  · 新增 tauri-plugin-updater + tauri-plugin-process
  · 命令 check_update() → { available, current, version, notes, date }
         install_update() → 下载 + 校验签名 + 静默覆盖安装 + restart
  · 签名用 minisign:私钥 /root/.tauri/xiaoyin-md-updater.key(600,**不在仓库里**),
    公钥写进 tauri.conf.json;安装包被篡改会被客户端直接拒装
  · 工具条新增升级按钮(仅 Tauri 版显示);点击 → 查版本 → 有新版弹窗(带更新说明)
    → 「立即升级」显示下载进度条 → 装完自动重启
  · 版本号 2.6.1 → 2.6.2

三、已验证
  · 构建出 XiaoyinMarkdown_2.6.2_x64-setup.exe(2.21 MB)+ .sig(448B)
  · 用 cryptography 按 minisign 规则**真验了一遍签名**:Ed25519 + BLAKE2b 预哈希 → 通过
  · /update/latest.json 200 / application/json / no-store;sha256 与清单一致
  · latest-setup.exe / latest-portable.exe 均 200

注意:2.6.1 是**没有升级器**的版本,老用户要手动装一次 2.6.2;
    从 2.6.2 起才能在软件里一键升级。
2026-11-20 10:22:26 +08:00

129 lines
4.4 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env python3
"""把小银 Markdown 的构建产物发布到官网,并生成升级清单。
用法:
python3 tools/release/publish.py --notes "更新说明……" # 用当前 tauri.conf.json 的版本
python3 tools/release/publish.py --notes "……" --dry-run
做的事:
1. 从 src-tauri/.../bundle/nsis/ 找安装包和 .sig 签名
2. 拷安装包到站点 download/(顺便拷一份免安装 exe)
3. 写 site/update/latest.json —— 客户端 updater 就拉这个
4. 打印最终 URL 与校验值
客户端地址:https://md.wangjinding.com/update/latest.json
"""
from __future__ import annotations
import argparse
import hashlib
import json
import shutil
import subprocess
import sys
from datetime import datetime, timezone
from pathlib import Path
ROOT = Path(__file__).resolve().parents[2]
TARGET = ROOT / "src-tauri" / "target" / "x86_64-pc-windows-gnu" / "release"
NSIS_DIR = TARGET / "bundle" / "nsis"
SITE = ROOT / "site"
SITE_DOWNLOAD = Path("/opt/1panel/www/sites/md.wangjinding.com/index/download")
SITE_UPDATE = Path("/opt/1panel/www/sites/md.wangjinding.com/index/update")
BASE_URL = "https://md.wangjinding.com"
def conf_version() -> str:
d = json.loads((ROOT / "src-tauri" / "tauri.conf.json").read_text(encoding="utf-8"))
return d["version"]
def sha256(path: Path) -> str:
h = hashlib.sha256()
with path.open("rb") as f:
for chunk in iter(lambda: f.read(1 << 20), b""):
h.update(chunk)
return h.hexdigest()
def main() -> int:
ap = argparse.ArgumentParser()
ap.add_argument("--notes", default="", help="更新说明(会显示在客户的升级弹窗里)")
ap.add_argument("--dry-run", action="store_true")
args = ap.parse_args()
version = conf_version()
setup = NSIS_DIR / f"XiaoyinMarkdown_{version}_x64-setup.exe"
sig_file = Path(str(setup) + ".sig")
if not setup.exists():
print(f"❌ 找不到安装包:{setup}", file=sys.stderr)
return 1
if not sig_file.exists():
print(f"❌ 找不到签名:{sig_file}\n 构建时是否漏了 TAURI_SIGNING_PRIVATE_KEY?", file=sys.stderr)
return 1
signature = sig_file.read_text(encoding="utf-8").strip()
size = setup.stat().st_size
digest = sha256(setup)
url = f"{BASE_URL}/download/{setup.name}"
manifest = {
"version": version,
"notes": args.notes or f"小银 Markdown v{version}",
"pub_date": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
"platforms": {
"windows-x86_64": {
"signature": signature,
"url": url,
"size": size,
"sha256": digest,
}
},
}
print(f" 版本 : {version}")
print(f" 安装包 : {setup.name} {size/1048576:.2f} MB")
print(f" sha256 : {digest[:32]}…")
print(f" 签名 : {signature[:40]}…")
print(f" 下载地址 : {url}")
if args.dry_run:
print(" [dry-run] 不写入任何文件")
return 0
SITE_UPDATE.mkdir(parents=True, exist_ok=True)
SITE_DOWNLOAD.mkdir(parents=True, exist_ok=True)
# ① 安装包(客户下载 + updater 拉取的是同一个)
shutil.copy2(setup, SITE_DOWNLOAD / setup.name)
(SITE_DOWNLOAD / setup.name).chmod(0o644)
# ② 免安装版
portable = TARGET / "xiaoyin-markdown.exe"
if portable.exists():
shutil.copy2(portable, SITE_DOWNLOAD / "XiaoyinMarkdown-portable.exe")
(SITE_DOWNLOAD / "XiaoyinMarkdown-portable.exe").chmod(0o644)
# ③ 升级清单(站点 + 仓库各存一份,方便回滚)
body = json.dumps(manifest, ensure_ascii=False, indent=2) + "\n"
(SITE_UPDATE / "latest.json").write_text(body, encoding="utf-8")
(SITE / "update").mkdir(parents=True, exist_ok=True)
(SITE / "update" / "latest.json").write_text(body, encoding="utf-8")
# ④ 稳定别名:官网页固定链到 latest-setup.exe,发版不用改 HTML
for alias, real in (("latest-setup.exe", setup.name), ("latest-portable.exe", "XiaoyinMarkdown-portable.exe")):
link = SITE_DOWNLOAD / alias
if link.is_symlink() or link.exists():
link.unlink()
link.symlink_to(real)
print(f"\n ✅ 已发布:{BASE_URL}/update/latest.json")
print(f" ✅ 稳定别名:{BASE_URL}/download/latest-setup.exe")
print(f" ✅ 安装包:{url}")
return 0
if __name__ == "__main__":
raise SystemExit(main())