Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion packages/docs/ci.md
Original file line number Diff line number Diff line change
Expand Up @@ -173,7 +173,7 @@ Linux 组包 cache 另外覆盖独立 probe workspace 的 `.artifacts/delivery-p

CI 不使用真实 AI Provider 或模型密钥。各模式都使用受控 SDK 和 App Server 夹具,`--phase5` 不启动 App Server。模拟协议通过不能证明真实模型理解需求或正确选择工具。

产品 `v<version>` 与官网 `www-v<version>` 分别进入发布路径,必须匹配声明版本,并通过同一共享来源门验证 main 源码或受信机械 Hourly 提交。产品并行构建 Web、四个原生目标、Android 和 iOS,各平台再按自身输入组包并构建桌面 App。每组校验后立即向同一个公开 Release 追加附件,完整审计完成后才追加全局 `release.json`。`publish=false` 手动入口只验证并生成制品。完整 Release 发布后,对应发布工作流按 Tag 自动派发产品或官网部署,并等待部署工作流终态;独立部署命令仍可显式选择已发布的 Stable、RC 或 Hourly Tag,手动派发仍需继续核对运行结果。详见 [构建与发布](releasing.md)。
Core、App、CLI、Desktop、Mobile 与官网分别进入各自的 `<app>-v<version>` 发布路径,必须匹配声明版本,并通过同一共享来源门验证 main 源码或受信机械 Hourly 提交。各应用独立组包与发布,不向同一个公开 Release 追加附件,也不再使用全局 `v<version>` 或全局 `release.json`。`publish=false` 手动入口只验证并生成制品。应用完整发布后,对应工作流按 Tag 自动派发该应用的服务部署(Core/App/WWW),并等待部署终态;独立部署命令仍可显式选择已发布的 Stable、RC 或 Hourly Tag。详见 [构建与发布](releasing.md)。

## 本地按改动补充验收

Expand Down
4 changes: 2 additions & 2 deletions packages/docs/e2e.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<run-id>/`;可用 `--protected-run-dir` 指定另一个全新任务目录。只上传 launcher 输出或 `GITHUB_OUTPUT` 的 `public-directory` 所指安全目录,实际路径为本轮 run 的 `public-export-<opaque>/`。其中包括逐项认证且当前摘要匹配的 receipts/metadata、原链公开观察、制品来源、资源状态和最终摘要。导出的 `progress.json` 只保留受控状态与合格清单,完整原生终态结果由摘要认证的 `native-result.json` 保留。
输出位于 `.artifacts/vdp/protected-runs/<run-id>/`;可用 `--protected-run-dir` 指定另一个全新任务目录。公开导出目录是本轮 run 的 `public-export-<opaque>/`。其中包括逐项认证且当前摘要匹配的 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 配置,不单独证明具体耗时。

Expand Down
2 changes: 1 addition & 1 deletion packages/docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -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<version>`、其他应用 Tag 或缺少完整清单的 Release。从旧统一产品 Tag 或旧安装布局切换时,先确认旧任务与更新已结束,关闭旧自动更新并停止旧服务,再安装到新的安装目录与命令目录,由新入口注册服务。保留原数据目录;Tag 调整不改变 data epoch。受管安装通过 `update apply` 升级,不能绕过正在运行节点的维护检查。更新和服务管理需要完整包。

从 Nightly 切换到 Hourly 不会自动完成:按 semver 规则 `hourly` 低于 `nightly`,更新器和桌面 App 会把新版本当作降级拒绝,新版本也不认识旧的 `nightly` 更新策略。停止旧服务后,删除数据目录中的 `update.json`,再用 `--channel hourly` 安装到新的安装目录与命令目录。数据目录保留,data epoch 不变。

Expand Down
2 changes: 1 addition & 1 deletion packages/docs/ios.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 不能替代设备归档。
Expand Down
12 changes: 0 additions & 12 deletions scripts/check-android-manifest-tool.py

This file was deleted.

12 changes: 0 additions & 12 deletions scripts/release.py
Original file line number Diff line number Diff line change
Expand Up @@ -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')
Expand Down