feat(m190): 产物署名(PE VERSIONINFO)+ 清单 Ed25519 多签名与更新前验签

两件事:让「这是谁发的」在产物与清单上都留下可验证的痕迹。

① PE 版本资源(两个 bin):`packaging/pe_version.rs` 是唯一口径(CompanyName
   「Unlucky Launcher Project」/ ProductName、FileDescription「Unlucky Launcher」/
   LegalCopyright「© 2026 … · Apache-2.0」/ 四段式版本号与 Cargo.toml 同源),被
   `crates/{cli,app-iced}/build.rs` 各 include 一次;非 windows 目标整段不执行。
   判据是读产物字节的 `packaging/check_pe_version.py`(CI 的 Windows 槽位)。

② 清单签名:`manifest.json` 旁边多一份 `manifest.json.sig`(分离签名,签的是清单**原始
   字节**),信封是 `{format, signatures:[{alg,key_id,sig,manifest_sha256}]}` —— 多签名数组,
   任意一条命中钉住的钥即放行(换钥窗口)。信任锚是 `crates/core/src/update/trust.rs`
   里的编译期公钥表(正式表为空 = fail-closed,测试钥只在 cfg(test)/update-test-source 里)。
   管线顺序改成「先验签、再解析」:`UpdateSource` 只交原文 + `.sig`,`verified_manifest`
   是唯一收口点,`Job::apply` 因此在取包**之前**就拒。新增五类错误分类
   (signature_missing / malformed / unknown_key / keyring_empty / invalid ),全部不可重试,
   CLI 的 hint 单独说人话。

③ Ed25519 验签自带实现(`update/ed25519/*`,零新依赖):scope 不含 core 的 Cargo.toml,
   用 RFC 8032 §7.1 向量 + 可锻/小阶/非规范编码的拒绝用例钉住;签名侧是
   `packaging/sign_manifest.py`(纯 Python 参考实现,零 pip 依赖,`--self-test` 同向量)。

④ 守门:`release-publish.yml` 加签名步(`set +x`,只回显公钥;没 Secret / 钥没钉 / 签不上
   一律红 ⇒ 不出 Release);`release-build.yml` 加 PE 资源读回;`release-guard.yml` 跑两个
   脚本的 `--self-test`。密钥纪律与轮换(旧钥签新钥)写在 `packaging/docs/signing.md`。

Cargo.lock:新增 winresource(build-dependency)与 toml 系;toml_datetime 1.1.2→1.1.3 是
toml 1.2.1 的硬要求(`cargo update --precise 1.1.2` 已实测被拒)。
This commit is contained in:
AskaEth committed 2026-11-09 01:59:05 +08:00
1 parent 44a0c87a11
commit b7d9b99e12
34 files changed
+2885 -104

No files matched your search

+36
View File
@@ -33,6 +33,21 @@ pub enum UpdateErrorKind {
DigestMismatch,
/// 长度不符:典型成因是下载被截断,也可能清单写错。
SizeMismatch,
/// 清单没有配套签名文件(`<清单名>.sig` 不在源里)。
///
/// 与 [`Self::SignatureInvalid`] 分开:这条是**发布侧漏了签名**,不是清单被改;
/// 处置也不同(等发布侧补,或回滚发布),所以必须是两个分类。
SignatureMissing,
/// 签名文件本身坏了:不是 JSON、字段名拼错、`format` 不认识、`signatures` 是空的。
SignatureMalformed,
/// 本构建没有钉任何清单签名公钥(正式信任表为空)。
///
/// 这是「构建形态」的问题,不是清单的问题:空表一律拒装,绝不「没钥就放行」。
KeyringEmpty,
/// 清单的签名者不在钉住的信任表里(`key_id` 一个都没命中)。
SignatureUnknownKey,
/// 签名对不上清单字节(清单被改过,或签名是给另一份清单的)。
SignatureInvalid,
}
impl UpdateErrorKind {
@@ -49,6 +64,11 @@ impl UpdateErrorKind {
Self::Io => "io",
Self::DigestMismatch => "digest_mismatch",
Self::SizeMismatch => "size_mismatch",
Self::SignatureMissing => "signature_missing",
Self::SignatureMalformed => "signature_malformed",
Self::KeyringEmpty => "keyring_empty",
Self::SignatureUnknownKey => "signature_unknown_key",
Self::SignatureInvalid => "signature_invalid",
}
}
@@ -56,6 +76,9 @@ impl UpdateErrorKind {
///
/// 清单本身不合法、协议不支持、渠道不符这几类换多少源都一样,所以只有字节层
/// (摘要/长度)、网络(可能是瞬时抖动)与 IO(可能是瞬时占用)算可重试。
///
/// 签名五兄弟**一律不可重试**:签名不对不是抖动,重试一千次还是不对。把它们标成可重试
/// 会让壳层反复弹「网络问题,稍后重试」,掩盖真正的原因(发布侧漏签 / 钥没钉 / 清单被改)。
#[must_use]
pub const fn is_retryable(self) -> bool {
matches!(
@@ -63,6 +86,19 @@ impl UpdateErrorKind {
Self::DigestMismatch | Self::SizeMismatch | Self::Network | Self::Io
)
}
/// 是否属于「清单签名」这一组(壳层据此换文案:这不是网络问题,别让用户重试)。
#[must_use]
pub const fn is_signature(self) -> bool {
matches!(
self,
Self::SignatureMissing
| Self::SignatureMalformed
| Self::KeyringEmpty
| Self::SignatureUnknownKey
| Self::SignatureInvalid
)
}
}
/// 自更新错误。