diff --git a/packages/docs/ci.md b/packages/docs/ci.md index 2d15f4c5..e941f82d 100644 --- a/packages/docs/ci.md +++ b/packages/docs/ci.md @@ -173,7 +173,7 @@ Linux 组包 cache 另外覆盖独立 probe workspace 的 `.artifacts/delivery-p CI 不使用真实 AI Provider 或模型密钥。各模式都使用受控 SDK 和 App Server 夹具,`--phase5` 不启动 App Server。模拟协议通过不能证明真实模型理解需求或正确选择工具。 -产品 `v` 与官网 `www-v` 分别进入发布路径,必须匹配声明版本,并通过同一共享来源门验证 main 源码或受信机械 Hourly 提交。产品并行构建 Web、四个原生目标、Android 和 iOS,各平台再按自身输入组包并构建桌面 App。每组校验后立即向同一个公开 Release 追加附件,完整审计完成后才追加全局 `release.json`。`publish=false` 手动入口只验证并生成制品。完整 Release 发布后,对应发布工作流按 Tag 自动派发产品或官网部署,并等待部署工作流终态;独立部署命令仍可显式选择已发布的 Stable、RC 或 Hourly Tag,手动派发仍需继续核对运行结果。详见 [构建与发布](releasing.md)。 +Core、App、CLI、Desktop、Mobile 与官网分别进入各自的 `-v` 发布路径,必须匹配声明版本,并通过同一共享来源门验证 main 源码或受信机械 Hourly 提交。各应用独立组包与发布,不向同一个公开 Release 追加附件,也不再使用全局 `v` 或全局 `release.json`。`publish=false` 手动入口只验证并生成制品。应用完整发布后,对应工作流按 Tag 自动派发该应用的服务部署(Core/App/WWW),并等待部署终态;独立部署命令仍可显式选择已发布的 Stable、RC 或 Hourly Tag。详见 [构建与发布](releasing.md)。 ## 本地按改动补充验收 diff --git a/packages/docs/e2e.md b/packages/docs/e2e.md index b89f2f51..440c5730 100644 --- a/packages/docs/e2e.md +++ b/packages/docs/e2e.md @@ -111,11 +111,11 @@ canonical 入口监督 native 与 tracked restart observer 两个同级子进程 `prepare`、`confirm_batch`、`accept_batch` 只有在结构化响应明确返回提交前的固定错误 `another delivery operation is in progress` 时,才沿既有 120 秒阶段上限等待重试,原 UUID 和参数不变。超时、网络异常、未知结果及其他拒绝直接失败,不自动重发。 -GitHub Actions `delivery-live` 使用 `ubuntu-24.04` 原生 x86 runner,核对宿主 Linux/x86_64,消费同 run 同 SHA 的 Linux/crypto/web 制品。job 的物理上限仍为 360 分钟,这是独立的外部限制,可能先于原生阶段完成而终止 job,不代表具体 prove 耗尽或完整实验通过。不能凭容器目标架构证明没有 emulation,也不能把已停止 CI 的链称为可恢复。健康的同一运行只能在原容器、原链与原业务期限内继续等待;停止后若重新验收,必须创建完整新链、钱包、预算、订单和五份新 proof,保留旧 FAIL,不通过新 UUID 或期限掩盖原失败。 +付费交付真实证明实验已从 Actions 移除,不再提供 `delivery-live` job。宿主命令 `scripts/run-delivery-live.py` 仍可在本机执行;它核对宿主 Linux/x86_64,消费当前 HEAD 的 Linux/crypto/web 制品。不能凭容器目标架构证明没有 emulation,也不能把已停止的链称为可恢复。健康的同一运行只能在原容器、原链与原业务期限内继续等待;停止后若重新验收,必须创建完整新链、钱包、预算、订单和五份新 proof,保留旧 FAIL,不通过新 UUID 或期限掩盖原失败。 容器核对 package checksum、`BUILD-INFO.json`、当前 JS/WASM 和 build-input receipts,先以真实 Web 资源进程检查实测 package 的 libc。仅当日志实际证明 GLIBC 不兼容时,按当前 clean HEAD 和现有 release flags 重建 CLI/Core,并再次检查真实资源进程。package 的检查状态、实际使用的 binary 来源及摘要分别写入 `artifact-provenance.json`,不能用 bare binary hash 自证源码来源。随后调用固定 guest 安装器和官方 `build.sh`,核对 image/profile/ELF,生成配置,再由 native 子进程经既有 `--protected-config` 调用 verify-node 的 `delivery_protected_acceptance` helper。Web 资源进程检查不代表渲染验收。 -输出位于 `.artifacts/vdp/protected-runs//`;可用 `--protected-run-dir` 指定另一个全新任务目录。只上传 launcher 输出或 `GITHUB_OUTPUT` 的 `public-directory` 所指安全目录,实际路径为本轮 run 的 `public-export-/`。其中包括逐项认证且当前摘要匹配的 receipts/metadata、原链公开观察、制品来源、资源状态和最终摘要。导出的 `progress.json` 只保留受控状态与合格清单,完整原生终态结果由摘要认证的 `native-result.json` 保留。 +输出位于 `.artifacts/vdp/protected-runs//`;可用 `--protected-run-dir` 指定另一个全新任务目录。公开导出目录是本轮 run 的 `public-export-/`。其中包括逐项认证且当前摘要匹配的 receipts/metadata、原链公开观察、制品来源、资源状态和最终摘要。导出的 `progress.json` 只保留受控状态与合格清单,完整原生终态结果由摘要认证的 `native-result.json` 保留。 observer 只导出固定字段投影 `restart-observer-summary.json`,包含受控状态、计数、条件布尔、相对 run/配置内容绑定与 script/prover/native-result 摘要,以及 supervisor 实际 wait 得到的两个退出码。原 native 全通过、observer 完整窗口全通过、两者真实 exit0 才能整体 PASS。result 自称 PASS、observer 尚未退出、缺窗或 INCONCLUSIVE 均不够。账户原始快照、RPC payload、私有 observer result/诊断不能导出。原生 get 的 proof deadline 诊断保持中性,同一句 Core 错误也可能来自 info30秒或 verify120秒;`node_proof_timeout_seconds=7200` 是 prove 配置,不单独证明具体耗时。 diff --git a/packages/docs/install.md b/packages/docs/install.md index 6807bd0b..649cd77f 100644 --- a/packages/docs/install.md +++ b/packages/docs/install.md @@ -102,7 +102,7 @@ bash install.sh --channel hourly --install-root "$VIBEFACE_INSTALL_ROOT" --bin-d 它不创建节点数据、不创建个人网络、不启动后台服务、不安装 Provider,也不开启自动更新。安装后把明确指定的 `--bin-dir` 加入 PATH,或直接使用该目录下的 CLI。SHA256 与包同由 GitHub 提供,不能替代独立发布签名。 -已有 `current` 或同名 bin 文件时,安装器保留原文件并拒绝安装。 旧版 CLI 只识别 `cli-v`,首次切换统一产品 Tag 需要手动安装新版完整包。先确认旧任务与更新已结束,关闭旧自动更新并停止旧服务,再安装到新的安装目录与命令目录,由新入口注册服务。保留原数据目录;这次 Tag 调整不改变数据 epoch。新版本之后的更新器只跟踪 `v`,不会回退旧应用前缀。受管安装通过 `update apply` 升级,不能绕过正在运行节点的维护检查。更新和服务管理需要完整包。 +已有 `current` 或同名 bin 文件时,安装器保留原文件并拒绝安装。安装器和更新器只跟踪 `cli-v` 发布线,不消费全局 `v`、其他应用 Tag 或缺少完整清单的 Release。从旧统一产品 Tag 或旧安装布局切换时,先确认旧任务与更新已结束,关闭旧自动更新并停止旧服务,再安装到新的安装目录与命令目录,由新入口注册服务。保留原数据目录;Tag 调整不改变 data epoch。受管安装通过 `update apply` 升级,不能绕过正在运行节点的维护检查。更新和服务管理需要完整包。 从 Nightly 切换到 Hourly 不会自动完成:按 semver 规则 `hourly` 低于 `nightly`,更新器和桌面 App 会把新版本当作降级拒绝,新版本也不认识旧的 `nightly` 更新策略。停止旧服务后,删除数据目录中的 `update.json`,再用 `--channel hourly` 安装到新的安装目录与命令目录。数据目录保留,data epoch 不变。 diff --git a/packages/docs/ios.md b/packages/docs/ios.md index 9bc28bcd..a9d5b2e3 100644 --- a/packages/docs/ios.md +++ b/packages/docs/ios.md @@ -8,7 +8,7 @@ description: 构建 Vibeface iOS 设备归档和签名 IPA,先通过 TestFligh iOS 先通过 TestFlight 内测,验证后再上 App Store。当前工作流只构建和校验, 不上传 App Store Connect,也不提交商店审核。 -`release-ios.yml` 是可复用工作流,只由产品 `release.yml` 调用。 +`release-ios.yml` 是可复用工作流,只由 `release-mobile.yml` 调用。 它从同一份 React Native App 与 Rust secure-native XCFramework 构建 `arm64` iPhoneOS 设备归档,核对真正的设备架构、源码提交、bundle ID、 发行版本、App 版本和构建号。模拟器 App 不能替代设备归档。 diff --git a/scripts/check-android-manifest-tool.py b/scripts/check-android-manifest-tool.py deleted file mode 100644 index fd32c329..00000000 --- a/scripts/check-android-manifest-tool.py +++ /dev/null @@ -1,12 +0,0 @@ -#!/usr/bin/env python3 -"""Require an existing Android manifest reader; never install an SDK implicitly.""" -import os -from pathlib import Path -import shutil -import subprocess - -candidates = sorted((Path(os.environ.get('ANDROID_HOME', '/nonexistent')) / 'build-tools').glob('*/aapt')) -tool = shutil.which('aapt') or (str(candidates[-1]) if candidates else None) -if not tool or not os.access(tool, os.X_OK): - raise SystemExit('An existing Android SDK build-tools aapt is required to validate product APKs') -subprocess.run([tool, 'version'], check=True) diff --git a/scripts/release.py b/scripts/release.py index 069b46e1..2663647b 100644 --- a/scripts/release.py +++ b/scripts/release.py @@ -138,18 +138,6 @@ def validate_source(source, app, root=None): return hourly.source_context(source, app, root=root or ROOT) -def source_workflows(source): - require(re.fullmatch(COMMIT, source), 'invalid workflow source') - return set(run('git', 'ls-tree', '-r', '--name-only', source, '--', '.github/workflows').splitlines()) - - -def release_workflow(source, app): - require(app in APPS, 'unknown release application') - name = '.github/workflows/' + WORKFLOWS[app] - require(name in source_workflows(source), 'release source lacks its application workflow') - return name, {} - - def require_ci(context): source = context['ci_source_commit'] require(isinstance(source, str) and re.fullmatch(COMMIT, source), 'invalid CI source commit')