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.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
build(release): generate signed multi-language update lists
baiyuzedeb6e1b33ded
diff --git a/tools/release/manifest.py b/tools/release/manifest.pynew file mode 100644index 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.pynew file mode 100644index 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": [],+ },+]