Skip to content

PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.

build(release): generate signed multi-language update lists

baiyuzedeb6e1b33ded
diff --git a/tools/release/manifest.py b/tools/release/manifest.py
new file mode 100644
index 0000000..a81c4ca
--- /dev/null
+++ b/tools/release/manifest.py
@@ -0,0 +1,166 @@
+"""生成并签名更新清单 updates/latest.json 与 updates/latest.json.sig。
+
+ python3 tools/release/manifest.py 2.3.0
+
+在 GitHub Release 与 Gitee 发行版的附件都传好之后运行,再单独提交推送:清单一出现,
+已安装的 App 就会提示更新,这时安装包必须已经能下载。
+
+检查五种语言的更新日志都齐全、release/ 里正好是发布的 14 个文件且与 SHA256SUMS 一致、
+版本号与 tools/site/build.py 一致。签名用 client-core/cmd/updatesign,私钥在 macOS 钥匙串里。
+
+端到端测试时把安装包放在本地的测试服务器上,清单写到别处,不碰 updates/:
+
+ python3 tools/release/manifest.py 2.3.1 --release-dir /tmp/next --test-notes \\
+ --mirror test=http://10.211.55.2:8765/pkg/ --out /tmp/next-site/updates
+
+设计见 design/auto-update.md。
+"""
+
+import argparse
+import hashlib
+import json
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+sys.path.insert(0, str(Path(__file__).parent))
+from notes import MAX_RELEASES, RELEASES # noqa: E402
+
+# 清单里安装包的键 → 文件名。键与客户端 internal/update 里 Target.Asset 一致
+ASSETS = {
+ "mac-arm64": "PasteFerry-mac-apple-silicon.dmg",
+ "mac-x64": "PasteFerry-mac-intel.dmg",
+ "mac-universal": "PasteFerry.dmg",
+ "windows-setup": "PasteFerry-Setup.exe",
+ "windows-portable": "PasteFerry-windows-x64.zip",
+ "linux-amd64-deb": "PasteFerry-linux-amd64.deb",
+ "linux-arm64-deb": "PasteFerry-linux-arm64.deb",
+ "linux-amd64-tar": "PasteFerry-linux-amd64.tar.gz",
+ "linux-arm64-tar": "PasteFerry-linux-arm64.tar.gz",
+}
+# 与 Release 一起发布的全部 14 个文件:客户端用不到服务器包,但它们在 SHA256SUMS 里
+RELEASE_FILES = 14
+
+# notes.py 每一条的语言顺序 → 清单里的语言代码
+LANGS = ["en", "zh-Hans", "ja", "zh-Hant-TW", "zh-Hant-HK"]
+
+TEST_NOTES = ("Test build for checking automatic updates.", "用于验证自动更新的测试版本。",
+ "自動アップデート検証用のテストビルドです。", "用於驗證自動更新的測試版本。", "用於驗證自動更新的測試版本。")
+
+
+def die(msg: str) -> None:
+ print("✗", msg, file=sys.stderr)
+ sys.exit(1)
+
+
+def localized(items: list[tuple]) -> dict[str, list[str]]:
+ out = {lang: [] for lang in LANGS}
+ for item in items:
+ if len(item) != len(LANGS) or any(not s.strip() for s in item):
+ die(f"更新日志缺少某种语言:{item[0][:60]!r}")
+ for lang, text in zip(LANGS, item):
+ out[lang].append(text)
+ return out
+
+
+def release_entry(r: dict) -> dict:
+ changes, fixes = localized(r["changes"]), localized(r["fixes"])
+ if not r["changes"] and not r["fixes"]:
+ die(f"{r['version']} 没有更新日志")
+ notes = {}
+ for lang in LANGS:
+ n = {}
+ if changes[lang]:
+ n["changes"] = changes[lang]
+ if fixes[lang]:
+ n["fixes"] = fixes[lang]
+ notes[lang] = n
+ return {"version": r["version"], "date": r["date"], "notes": notes}
+
+
+def version_key(v: str) -> tuple:
+ core, _, pre = v.partition("-")
+ return tuple(int(x) for x in core.split(".")) + ((1, "") if not pre else (0, pre))
+
+
+def main() -> None:
+ ap = argparse.ArgumentParser()
+ ap.add_argument("version")
+ ap.add_argument("--release-dir", default=str(ROOT / "release"))
+ ap.add_argument("--out", default=str(ROOT / "updates"))
+ ap.add_argument("--mirror", action="append", default=[], help="source=base,可重复;默认是 Gitee 与 GitHub")
+ ap.add_argument("--test-notes", action="store_true", help="用一条测试说明代替 notes.py(端到端测试)")
+ args = ap.parse_args()
+ version = args.version
+ if not re.fullmatch(r"\d+\.\d+\.\d+(-[0-9A-Za-z.]+)?", version):
+ die(f"版本号 {version} 不是 X.Y.Z")
+
+ test = args.test_notes or args.mirror
+ if not test:
+ site = (ROOT / "tools/site/build.py").read_text(encoding="utf-8")
+ m = re.search(r'^VERSION = "([^"]+)"', site, re.M)
+ if not m or m.group(1) != version:
+ die(f"tools/site/build.py 的 VERSION 是 {m and m.group(1)},不是 {version}")
+
+ # 安装包:与 SHA256SUMS 逐个核对
+ rel = Path(args.release_dir)
+ files = sorted(p.name for p in rel.iterdir() if p.is_file())
+ if len(files) != RELEASE_FILES:
+ die(f"{rel} 里应当正好有 {RELEASE_FILES} 个文件,现在是 {len(files)} 个")
+ sums = {}
+ for line in (rel / "SHA256SUMS").read_text().splitlines():
+ digest, _, name = line.partition(" ")
+ sums[name.strip()] = digest.strip()
+ assets = {}
+ for key, name in ASSETS.items():
+ path = rel / name
+ if not path.is_file():
+ die(f"缺少 {name}")
+ digest = hashlib.sha256(path.read_bytes()).hexdigest()
+ if sums.get(name) != digest:
+ die(f"{name} 与 SHA256SUMS 不一致")
+ assets[key] = {"name": name, "size": path.stat().st_size, "sha256": digest}
+
+ # 更新日志:最新版本必须有,最多保留 MAX_RELEASES 个
+ if args.test_notes:
+ entries = [release_entry({"version": version, "date": "", "changes": [TEST_NOTES], "fixes": []})]
+ else:
+ entries = [release_entry(r) for r in RELEASES if version_key(r["version"]) <= version_key(version)]
+ if not entries or entries[0]["version"] != version:
+ die(f"tools/release/notes.py 里没有 {version} 的更新日志(要写在最前面)")
+ entries = entries[:MAX_RELEASES]
+
+ if args.mirror:
+ mirrors = []
+ for m in args.mirror:
+ source, _, base = m.partition("=")
+ if not source or not base.endswith("/"):
+ die(f"--mirror 应当是 source=base/,现在是 {m}")
+ mirrors.append({"source": source, "base": base})
+ else:
+ mirrors = [
+ {"source": "gitee", "base": f"https://gitee.com/baiyuze/pasteferry/releases/download/v{version}/"},
+ {"source": "github", "base": f"https://github.com/baiyuze/pasteferry/releases/download/v{version}/"},
+ ]
+
+ manifest = {"schema": 1, "latest": version, "date": entries[0]["date"], "mirrors": mirrors,
+ "assets": assets, "releases": entries}
+ out = Path(args.out)
+ out.mkdir(parents=True, exist_ok=True)
+ path = out / "latest.json"
+ path.write_text(json.dumps(manifest, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+
+ # 签名,并用 App 内置的公钥回验
+ core = ROOT / "client-core"
+ for flag in ("-sign", "-verify"):
+ r = subprocess.run(["go", "run", "./cmd/updatesign", flag, str(path.resolve())], cwd=core,
+ capture_output=True, text=True)
+ if r.returncode != 0:
+ die(f"updatesign {flag} 失败:{r.stderr.strip() or r.stdout.strip()}")
+ print(f"✓ {path}({len(entries)} 个版本的更新日志,{len(assets)} 个安装包)与 latest.json.sig")
+
+
+if __name__ == "__main__":
+ main()
diff --git a/tools/release/notes.py b/tools/release/notes.py
new file mode 100644
index 0000000..5c11539
--- /dev/null
+++ b/tools/release/notes.py
@@ -0,0 +1,46 @@
+"""各版本更新日志的唯一来源,写进更新清单 updates/latest.json,App 在「检查更新」里按界面语言显示。
+
+每一条是 (英文, 简体中文, 日文, 繁体中文(台湾), 繁体中文(香港)),五种语言写在一起,改一条时不会漏掉别的。
+台湾与香港的用词按当地写法:台湾写網路、中繼、軟體,香港写網絡、中轉、軟件。
+英文与 CHANGELOG.md、GitHub Release 正文的 Changes / Fixes 一致。
+
+从新到旧排列;清单里只放最近 10 个版本(MAX_RELEASES)。2.3.0 是第一个能自动更新的版本,
+更早的版本没有更新功能,不需要写在这里。
+"""
+
+MAX_RELEASES = 10
+
+RELEASES = [
+ {
+ "version": "2.3.0",
+ "date": "2026-10-20",
+ "changes": [
+ ("Check for updates in Settings → About. After you confirm, PasteFerry downloads, verifies and installs the new version and reopens by itself; your devices, history and settings stay.",
+ "在「设置 → 关于」里检查更新。确认后,隔空贴会自动下载、校验并安装新版本,然后自己重新打开;配对、记录和设置都保留。",
+ "「設定 → このアプリについて」でアップデートを確認できます。確認すると PasteFerry が新しいバージョンをダウンロード・検証・インストールし、自動的に開き直します。ペアリング、履歴、設定はそのままです。",
+ "在「設定 → 關於」裡檢查更新。確認後,隔空貼會自動下載、驗證並安裝新版本,然後自己重新開啟;配對、記錄和設定都保留。",
+ "在「設定 → 關於」裏檢查更新。確認後,隔空貼會自動下載、校驗並安裝新版本,然後自己重新開啟;配對、記錄和設定都保留。"),
+ ("Release notes appear in your interface language. If you are several versions behind, each version is listed.",
+ "更新日志按界面语言显示;落后好几个版本时,每一版的变化都会列出来。",
+ "更新内容は表示言語で表示されます。複数のバージョンが空いている場合は、バージョンごとに表示します。",
+ "更新日誌依介面語言顯示;落後好幾個版本時,每一版的變化都會列出來。",
+ "更新日誌按介面語言顯示;落後好幾個版本時,每個版本的變化都會列出來。"),
+ ("A daily check shows a quiet hint in the sidebar when a new version is out. You can skip a version or turn automatic checks off; the check only reads the update list on GitHub and Gitee and sends nothing that identifies you.",
+ "每天自动检查一次,有新版本时在侧边栏底部提示,不弹窗打扰。可以跳过某个版本,也可以关掉自动检查;检查只读取 GitHub 和 Gitee 上的更新清单,不发送任何能识别你的信息。",
+ "1 日 1 回自動で確認し、新しいバージョンがあるとサイドバーに控えめに表示します。特定のバージョンをスキップしたり、自動確認をオフにしたりできます。確認は GitHub と Gitee のアップデート一覧を読むだけで、あなたを識別できる情報は送信しません。",
+ "每天自動檢查一次,有新版本時在側邊欄底部提示,不跳出視窗打擾。可以略過某個版本,也可以關閉自動檢查;檢查只讀取 GitHub 和 Gitee 上的更新清單,不傳送任何能識別你的資訊。",
+ "每天自動檢查一次,有新版本時在側邊欄底部提示,不彈出視窗打擾。可以略過某個版本,也可以關閉自動檢查;檢查只讀取 GitHub 和 Gitee 上的更新清單,不傳送任何能識別你的資料。"),
+ ("Updates are signed: the app only installs a package whose checksum appears in an update list signed by the PasteFerry release key.",
+ "更新经过签名:只有出现在隔空贴发布密钥签过名的更新清单里、校验值也对得上的安装包才会被安装。",
+ "アップデートは署名されています。PasteFerry のリリース鍵で署名された一覧にあり、チェックサムも一致するパッケージだけをインストールします。",
+ "更新經過簽章:只有出現在隔空貼發布金鑰簽過章的更新清單裡、校驗值也對得上的安裝檔才會被安裝。",
+ "更新經過簽署:只有出現在隔空貼發佈密鑰簽署過的更新清單裏、校驗值也對得上的安裝檔才會被安裝。"),
+ ("In mainland China, installers are also mirrored on Gitee, linked from the Chinese download pages; updates download from whichever of GitHub and Gitee answers first.",
+ "在中国大陆,安装包同时放在 Gitee 镜像上,中文下载页有链接;自动更新会从 GitHub 和 Gitee 中先响应的那个下载。",
+ "中国本土向けに、インストーラーを Gitee にもミラーしています(中国語のダウンロードページにリンクがあります)。アップデートは GitHub と Gitee のうち先に応答した方からダウンロードします。",
+ "在中國大陸,安裝檔同時放在 Gitee 鏡像上,中文下載頁有連結;自動更新會從 GitHub 和 Gitee 中先回應的那個下載。",
+ "在內地,安裝檔同時放在 Gitee 鏡像上,中文下載頁有連結;自動更新會從 GitHub 和 Gitee 中先回應的那個下載。"),
+ ],
+ "fixes": [],
+ },
+]